User Tools

Site Tools


newdevs:testserver

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision
Previous revision
newdevs:testserver [2020/10/26 09:51] – created tmccannanewdevs:testserver [2024/01/22 13:48] (current) – adding info on Git Bash gmonti
Line 2: Line 2:
 ======Setting Up a Development Environment====== ======Setting Up a Development Environment======
  
-===== Hacking Evergreen Videos ===== +==== Setting up a Development Environment ====
-  * [[https://vimeo.com/230985351|Part 1 - Creating a Virtual Machine]] +
-  * [[https://vimeo.com/231611654|Part 2 - Installing with Docker]] +
-  * [[https://vimeo.com/236490496|Part 3 - Clone Evergreen Git Repository]]+
  
 +Thank you to Blake Henderson and MOBIUS for the development of this Docker container that is specifically set up to edit Evergreen and have on-the-fly results on the Evergreen server. This container has been tested on Windows and Linux and theoretically will work on OSX. 
 +
 +README Page for the Container: https://hub.docker.com/r/mobiusoffice/evergreen-ils 
 +
 +Git Repo that builds the Container: https://github.com/mcoia/eg-docker
 +
 +**Instructions:**
 +
 +  - Install GitHub - https://github.com/
 +  - Install Git Bash and clone the Evergreen git repository - see https://wiki.evergreen-ils.org/doku.php?id=newdevs:git:install
 +  - When installing Git Bash, make sure to choose the option "Checkout as-is, commit as-is" If already installed incorrectly, use this command:<code>git config --global core.autocrlf false</code>and reclone Evergreen repo.
 +  - Install docker on your workstation. On Windows, that's "Docker Desktop" - https://www.docker.com/products/docker-desktop/
 +  - Make sure you're on a recent branch. Older branches (3.9 and below) may not work, as this container is running Ubuntu Jammy.
 +  - Once Docker is installed and running, issue this command from Linux (update the folder paths to match your environment)<code>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</code>Or, on Windows PowerShell:<code>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</code>
 +  - This may take up to 15 minutes to bring the server online depending on your hardware. When you see this, it is finished:<code>PLAY RECAP
 +*****************************************************************************************************</code>There will be another minute or so delay for the Angular files to begin working. 
 +  - Press CTRL+pq to keep it running. (CTRL+c will kill the container.)
 +  - Open a browser and go to 127.0.0.1 and click through any SSL warnings.
 +    * The staff home page will be https://localhost/eg/staff (login with admin / demo123)
 +    * Edits to the template toolkit files Open-ILS/src/templates(-bootstrap) are live.
 +    * Edits to the AngularJS folder Open-ILS/web/js/ui/default/staff are live.
 +    * Edits to the Angular folder Open-ILS/web/eg2 are NOT LIVE because 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". The build output will be provided back to you by way of a file called "eg_rebuild_angular_screenoutput".
 +    * Perl edits are not live (because Perl). Changes to the 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.
 +
 +==== Grow Your Own Evergreen! ====
 +
 +Evergreen Conference Session by Michele Morgan of NOBLE
 +
 +  * [[https://www.youtube.com/watch?v=Xla4BRa8SPc|Grow Your Own Evergreen! Exploring, Hacking, and Testing On Your Very Own Test System]]
newdevs/testserver.1603720297.txt.gz · Last modified: 2022/02/10 13:34 (external edit)

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki

© 2008-2022 GPLS and others. Evergreen is open source software, freely licensed under GNU GPLv2 or later.
The Evergreen Project is a U.S. 501(c)3 non-profit organization.