<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"></head><body style="overflow-wrap: break-word; -webkit-nbsp-mode: space; line-break: after-white-space;">Comments inline below<br id="lineBreakAtBeginningOfMessage"><div><br><blockquote type="cite"><div>On 31 Oct 2024, at 22:00, Stephen Finucane <stephen@that.guru> wrote:</div><br class="Apple-interchange-newline"><div><meta charset="UTF-8"><span style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none; float: none; display: inline !important;">On Tue, 2024-10-29 at 19:09 +0000, Herakliusz Lipiec wrote:</span><br style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none;"><blockquote type="cite" style="font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none;">Add notes on deplotment of Docker image for patchwork testing<br>usnng docker-compose on MacOs. Also adding a note on using<br>TAG variable to alter dockerfile image tag.<br><br>Signed-off-by: Herakliusz Lipiec <hero24@icloud.com><br>---<br>docs/development/installation.rst | 28 ++++++++++++++++++++++++++++<br>1 file changed, 28 insertions(+)<br><br>diff --git a/docs/development/installation.rst b/docs/development/installation.rst<br>index c33f768..04914f7 100644<br>--- a/docs/development/installation.rst<br>+++ b/docs/development/installation.rst<br>@@ -150,6 +150,34 @@ For more information on Docker itself, please refer to the `docker`_ and<br>.. _docker-compose: https://docs.docker.com/compose/install/<br>.. _post-install: https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user<br><br>+.. note::<br>+ If you are trying to run patchwork on Mac you need to edit the Dockerfile located in ``tools/docker``.<br>+ It has been observed that lines that create and switch user to ``patchwork`` cause problems on MacOS,<br>+ the solution that has been found to be working is to remove/comment these lines out.<br>+<br>+ If you encounter issues with accesing patchwork files in docker container after removal of above<br>+ lines, the mounted volume directory can be altered using:<br>+<br>+ .. code-block:: shell<br>+<br>+ $ PATCHWORK_DIR=/Users/<username>/path/to/patchwork docker-compose build<br></blockquote><br style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none;"><span style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none; float: none; display: inline !important;">Could you give a little more context on this? What kind of issues are you</span><br style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none;"><span style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none; float: none; display: inline !important;">seeing? Feel free to open an issue on GitHub and upload screenshots if that</span><br style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none;"><span style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none; float: none; display: inline !important;">would help. This is pretty broad guidance and I'd like to confirm it's not a</span><br style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none;"><span style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none; float: none; display: inline !important;">single environment issue before we add this to the docs.</span><br style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none;"></div></blockquote>To put a little bit of context onto this, I am running this on macOS, and my knowledge</div><div>Of docker is that it reuses parts of underlying os if it can, this in turn causes errors at</div><div>Useradd commands used in dockerfile, because useradd doesnt exist on Mac.</div><div>I need to comment out those (which could potentially cause path issues see patch 1/2 for explanation).</div><div>Regardless, when I try running the dockerfile I get full set of errors related to paths,</div><div>The first one I get is that directory is not mounted, then I get errors about rebuilding the</div><div>Docker image because requirement file has changed/does not exists.</div><div>The previous patch resolves it neatly (I think), but because it adds the option to change the paths,</div><div>I think it would be nice to have it documented since it’s added.</div><div><br></div><div>It actually took me a while to figure it out so I hope having this mentioned is going to save</div><div>Some time for anyone else trying to run this on Mac. I have tested this on my system multiple times,</div><div>And it hasn’t failed me yet.</div><div><blockquote type="cite"><div><br style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none;"><blockquote type="cite" style="font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none;">+<br>+.. note::<br>+ If you see an error like the below::<br>+<br>+ => ERROR [web internal] load metadata for<span class="Apple-converted-space"> </span><a href="http://ghcr.io/getpatchwork/pyenv:latest">ghcr.io/getpatchwork/pyenv:latest</a><br>+ 0.9s<br>+ ------<br>+ > [web internal] load metadata for<span class="Apple-converted-space"> </span><a href="http://ghcr.io/getpatchwork/pyenv:latest:">ghcr.io/getpatchwork/pyenv:latest:</a><br></blockquote><br style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none;"><span style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none; float: none; display: inline !important;">I'm not able to reproduce this locally (albeit on a Fedora host). Is this still</span><br style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none;"><span style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none; float: none; display: inline !important;">the case? I did some work earlier today on the images, so I know for a fact that</span><br style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none;"><span style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none; float: none; display: inline !important;">the 'latest' tag definitely exists and is up-to-date.</span></div></blockquote><div>I have just tested it now and latest tag still gives me an error, while stable-3.1 works fine,</div><div>It could be some kind of configuration/macOS issue but I dont really feel like debugging this,</div><div>If changing it to stable-3.1 works fine. I know it’s not a fix just a dirty old hack, but it works,</div><div>And who knows how long would it take to actually debug this, I did a quick google on this and</div><div>Couldn’t find anything meaningful, and it is an enhancement and a fix at once after all.</div><div><br></div><div>Cheers</div><div>Hero</div><blockquote type="cite"><div><br style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none;"><span style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none; float: none; display: inline !important;">Cheers,</span><br style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none;"><span style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none; float: none; display: inline !important;">Stephen</span><br style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none;"><br style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none;"><blockquote type="cite" style="font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none;">+<br>+ It is possible to change the tag used by passing TAG variable when running docker-compose like:<br>+<br>+ .. code-block:: shell<br>+<br>+ TAG=<tag-to-use> docker-compose build<br>+<br>+ Tags that currently are available for use be found here:<br>+ <a href="https://github.com/getpatchwork/pyenv/pkgs/container/pyenv">https://github.com/getpatchwork/pyenv/pkgs/container/pyenv</a><br><br>Manual Installation<br>-------------------</blockquote></div></blockquote></div><br></body></html>