<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
</head>
<body>
<div class="moz-text-flowed" style="font-family: -moz-fixed;
font-size: 14px;" lang="x-unicode">All,
<br>
<br>
Excuse the cross-list post from the newdevs mailing list.<br>
<br>
I wanted to let everyone know that we've been working on a new
Docker container. One specifically setup to edit Evergreen and
have on-the-fly results on the Evergreen server.
<br>
<br>
This container has been tested on Windows and Linux and
theoretically will work on OSX. Use your favorite OS.
<br>
<br>
To use it:<br>
<br>
1. Install docker on your workstation. On Windows, that's "Docker
Desktop" (<a class="moz-txt-link-freetext"
href="https://www.docker.com/products/docker-desktop/">https://www.docker.com/products/docker-desktop/</a>)
<br>
2. Make sure you have the Evergreen git repository cloned on your
hard drive somewhere. Make sure you're on a recent branch. Older
branches (3.9 and below) may not work, as this container is
running Ubuntu Jammy.
<br>
3. Once Docker is installed and running, issue this command
(update the folder paths to match your environment)
<br>
<br>
Linux example command:<br>
<br>
docker run -it -p 80:80 -p 443:443 -p 210:210 -p 6001:6001 -p
32:22 -p 5433:5432 -v
/home/user/Evergreen:/home/opensrf/repos/Evergreen -h
test.evergreen.com mobiusoffice/evergreen-ils:dev
<br>
<br>
Or on Windows (from powershell):
<br>
<br>
docker run -it -p 80:80 -p 443:443 -p 210:210 -p 6001:6001 -p
32:22 -p 5433:5432 -v
//c/users/blake/Documents/GitHub/Evergreen:/home/opensrf/repos/Evergreen
-h test.evergreen.com mobiusoffice/evergreen-ils:dev
<br>
<br>
<br>
This container is decidedly slower to boot than the "generic"
container. It's slower because it reinstalls Evergreen with your
locally provided Evergreen folder. Depending on your hardware, it
could take 15 minutes to bring the server online.
<br>
<br>
When you see this:
<br>
<br>
PLAY RECAP
*****************************************************************************************************<br>
<br>
It's finished. There is a small delay after that in order to get
the Angular files generated (anything */eg2/* won't work for
another minute or so).
<br>
<br>
Be sure and keep it running by pressing CTRL+pq (CTRL+c will kill
the container)
<br>
<br>
You should be able to open a browser and browse to 127.0.0.1.
You'll need to click through any browser warning about SSL
certificates.
<br>
<br>
Default login: admin/demo123 (URL: <a
class="moz-txt-link-freetext" href="https://localhost/eg/staff">https://localhost/eg/staff</a>)
<br>
<br>
Edits to the template toolkit files
Open-ILS/src/templates(-bootstrap) are live
<br>
<br>
Edits to the AngularJS folder Open-ILS/web/js/ui/default/staff are
live
<br>
<br>
Edits to the Angular folder Open-ILS/web/eg2 are NOT LIVE
<br>
The folder needs to be compiled when files are edited. The
container is waiting for you to let it know when it should do
that. In order to let it know, you need to create a regular file
in the root of your Evergreen folder called "eg_rebuild_angular"
<br>
<br>
The build output will be provided back to you by way of a file
called "eg_rebuild_angular_screenoutput"
<br>
<br>
Perl edits are not live. Changes to Perl will require Evergreen
services to restart. Similar to the Angular compile trigger, you
can trigger the container to restart the Evergreen services by
placing a regular file in the root of your Evergreen folder called
"eg_restart_go". The container will react on the next minute. It's
a cron job that runs on the minute every minute.<br>
<br>
<br>
Terran was kind enough to convert this message into a wiki page:<br>
<br>
<a moz-do-not-send="true"
href="https://wiki.evergreen-ils.org/doku.php?id=newdevs:testserver"
class="moz-txt-link-freetext">https://wiki.evergreen-ils.org/doku.php?id=newdevs:testserver</a><br>
<br>
Here is the Docker hub link where we warehouse our images:<br>
<br>
<a moz-do-not-send="true"
href="https://hub.docker.com/r/mobiusoffice/evergreen-ils"
class="moz-txt-link-freetext">https://hub.docker.com/r/mobiusoffice/evergreen-ils</a><br>
<br>
Here is the git repository that was developed to create the
image(s)<br>
<br>
<a moz-do-not-send="true"
href="https://github.com/mcoia/eg-docker"
class="moz-txt-link-freetext">https://github.com/mcoia/eg-docker</a><br>
<br>
<br>
Any and all feedback is welcome!
<br>
<br>
<br>
<div class="moz-txt-sig"><span class="moz-txt-tag">-- <br>
</span>-Blake-
<br>
Conducting Magic
<br>
Will consume any data format
<br>
MOBIUS
<br>
<br>
</div>
</div>
<br>
</body>
</html>