eeacms/industry-frontend repository overview

⁠EPRTR: Volto Frontend

⁠Documentation

A training on how to create your own website using Volto is available as part of the Plone training at https://training.plone.org/5/volto/index.html⁠.

⁠Getting started

1. Clone:

    $ git clone https://github.com/eea/eprtr_frontend.git
    $ cd eprtr_frontend
   

   Copy

2. Install nvm

    $ touch ~/.bash_profile
    $ curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.34.0/install.sh | bash
   
    $ source ~/.bash_profile
    $ nvm version
   

   Copy

3. Install latest NodeJS 12.x:

    $ nvm install 12
    $ nvm use 12
    $ node -v
    v12.16.2
   

   Copy

4. Install yarn

    $ curl -o- -L https://yarnpkg.com/install.sh | bash
    $ yarn -v
   

   Copy

5. Install

    $ yarn
   

   Copy

6. Start and setup backend

     $ docker-compose up -d
   

   Copy
   • Go to http://localhost:8080 Advanced⁠:
   • Add Plone site with add-ons enabled (user: admin, password: admin):
     • kitconcept.volto

7. Start frontend

    $ yarn start
   

   Copy

8. See application at http://localhost:3000⁠

⁠Try it

1. Install Docker⁠

2. Install Docker Compose⁠

3. Start:

    $ git clone https://github.com/eea/eprtr_frontend.git
    $ cd eprtr_frontend
   
    $ docker-compose pull
    $ docker-compose up -d
   

   Copy

   optionally change PORTS via .env:

    $ FRONTEND=9000 BACKEND=9100 docker-compose up -d
   

   Copy

4. Go to http://localhost:8080 Advanced⁠:

   • Add Plone site with add-ons enabled (user: admin, password: admin):
     • kitconcept.volto

5. See application at http://localhost:8000⁠

⁠Production

We use Docker⁠, Rancher⁠ and Jenkins⁠ to deploy this application in production.

⁠Deploy

• Within Rancher > Catalog > EEA deploy Volto - EPRTR⁠

⁠Release

• Create a new release of this code via git tag command or Draft new release⁠ on Github.
  • A new Docker image is built and released automatically on DockerHub⁠ based on this tag.
  • A new entry is automatically added to Volto - EPRTR⁠ EEA Rancher Catalog

⁠Upgrade

• Within your Rancher environment click on the Upgrade available yellow button next to your stack.

• Confirm the upgrade

• Or roll-back if something went wrong and abort the upgrade procedure.