Skip to content

Latest commit

 

History

History
161 lines (105 loc) · 3.71 KB

production.md

File metadata and controls

161 lines (105 loc) · 3.71 KB
Raw

Docker orchestration for EEA main portal (WWW AWS)

Docker orchestration for EEA main portal services

Pre-requirements

  • Dedicated Rancher Environment (recommended)

Register hosts within Rancher via Rancher UI

  • Register dedicated backend hosts with label: backend=yes (Plone)
  • Register dedicated frontend hosts with label: frontend=yes (Apache, Varnish, HAProxy)

Setup infrastructure

Note: See EEA SVN for answers.txt files

  • From Rancher Catalog > Library deploy:
    • Rancher NFS
  • From Rancher Catalog > EEA deploy:
    • EEA WWW - Volumes
    • EEA WWW - Sync
      • Leave empty SSH Public Key (PostgreSQL)
      • Set SSH Public Key (rsync-client) to DISABLED
      • Make sure that this rsync-client can connect to rsync-server on www-prod-replica tenant. (blobs and static-resources sync)

Setup database

Note: See EEA SVN for answers.txt files

  • From Rancher Catalog > EEA deploy:
    • EEA - PostgreSQL (External)

Setup Plone

Note: See EEA SVN for answers.txt files

  • From Rancher Catalog > EEA deploy:
    • EEA - WWW (Plone)

Setup Frontend

Note: See EEA SVN for answers.txt files

  • From Rancher Catalog > EEA deploy:
    • EEA - Frontend
    • EEA - Load Balancer

Release and upgrade www-plone

Release www-plone stack

Note: Nightly released by Jekins

  1. Add new catalog version within eea.rancher.catalog

    • Prepare next release, e.g.: 17.9:

      $ git clone git@github.com:eea/eea.rancher.catalog.git
$ cd eea.rancher.catalog/templates/www-plone

$ cp -r 59 60
$ git add 60
$ git commit -m "Prepare release 17.9"

    • Release new version, e.g:. 17.9:

      $ vim config.yml
version: "17.9"

$ vim 60/rancher-compose.yml
...
version: "17.9"
...
uuid: www-plone-60
...

$ vim 60/docker-compose.yml
...
- image: eeacms/www:17.9
...

$ git add .
$ git commit -m "Release 17.9"
$ git push

Upgrade www-plone stack

  • Upgrade Rancher deployment

    • Click the available upgrade button

    • Confirm the upgrade

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

Release and upgrade www-frontend

Release www-frontend stack

Note: Nightly released by Jekins

  1. Add new catalog version within eea.rancher.catalog

    • Prepare next release, e.g.: 1.1:

      $ git clone git@github.com:eea/eea.rancher.catalog.git
$ cd eea.rancher.catalog/templates/www-frontend

$ cp -r 0 1
$ git add 1
$ git commit -m "Prepare release 1.1"

    • Release new version, e.g:. 1.1:

      $ vim config.yml
version: "1.1"

$ vim 1/rancher-compose.yml
...
version: "1.1"
...
uuid: www-frontend-1
...

$ vim 1/docker-compose.yml
...
- image: eeacms/apache-eea-www:1.1
...

$ git add .
$ git commit -m "Release 1.1"
$ git push

Upgrade www-frontend stack

  • Click the available upgrade button

  • Confirm the upgrade

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

Debug

  1. Start Plone instance in debug mode

     $ rancher exec -it www-plone/debug-instance bash
 $ bin/instance fg

  2. Now, via Rancher UI:

    • Within www-plone/debug-instance stack find exposed port for 8080 and click on it.