Skip to content

Updating#

  1. Download newest charts using helm

    helm repo update

  2. Check with helm diff for changes https://github.com/databus23/helm-diff.

    helm diff upgrade --install --create-namespace --namespace lagoon-core \
    -f values.yaml lagoon-core lagoon/lagoon-core

  3. Backup the Lagoon databases prior to any helm actions . We suggest to also scale the API to a single pod, to aid the db migration scripts running in the initContainers.

  4. Run the upgrade using helm

    helm upgrade --install --create-namespace --namespace lagoon-core \
    -f values.yaml lagoon-core lagoon/lagoon-core

  5. (Note that as of Lagoon v2.11.0, this step is no longer required.) If upgrading Lagoon Core, ensure you run the rerun_initdb.sh script to perform post upgrade migrations.

    kubectl --namespace lagoon-core exec -it lagoon-core-api-db-0 -- \
    sh -c /rerun_initdb.sh

  6. Re-scale the API pods back to their original level

  7. If upgrading Lagoon Core, and you have enabled groups/user syncing for OpenSearch, you may additionally need to run the sync:opendistro-security script to update the groups in OpenSearch. This command can also be prefixed with a GROUP_REGEX=<group-to-sync to sync a single group at a time, as syncing the entire group structure may take a long time.

    kubectl --namespace lagoon-core exec -it deploy/lagoon-core-api -- \
    sh -c yarn sync:opendistro-security
    Check https://github.com/uselagoon/lagoon/releases for additional upgrades.

Database Backups#

You may want to backup the databases before upgrading Lagoon Core, the following will create backups you can use to restore from if required. You can delete them afterwards.

API DB#

kubectl --namespace lagoon-core exec -it lagoon-core-api-db-0 -- \
    sh -c 'mysqldump --max-allowed-packet=500M --events \
    --routines --quick --add-locks --no-autocommit \
    --single-transaction infrastructure | gzip -9 > \
    /var/lib/mysql/backup/$(date +%Y-%m-%d_%H%M%S).infrastructure.sql.gz'

Keycloak DB#

kubectl --namespace lagoon-core exec -it lagoon-core-keycloak-db-0 -- \
    sh -c 'mysqldump --max-allowed-packet=500M --events \
    --routines --quick --add-locks --no-autocommit \
    --single-transaction keycloak | gzip -9 > \
    /var/lib/mysql/backup/$(date +%Y-%m-%d_%H%M%S).keycloak.sql.gz'