Upgrade XL Release active-active cluster setup with docker compose
Steps
Follow these steps to Upgrade XL Release active-active cluster setup:
Make sure to read our docs for upgrade and release notes for each version you want to upgrade to.
Stop the current running instances of the docker containers which have the old version that need to be upgraded. You do not need to stop the load balancer, mq and database containers. See the example below:
# Shutdown deployments
docker-compose -f docker-compose-xlr-ha.yaml stop xl-release-masterUpdate the
docker-compose-xlr-ha.yaml
file as shown
- Update the image with new tag which represent version you want to upgrade to for both master and worker, for example,
xl-release-master:
image: xebialabs/xl-release:9.5.2 - Specify your DB connection details to point to the old DB, for example using environment variables such as
XL_DB_URL
- Include all volumes already being used with old docker images. In case of "conf" volume, make sure also to update any configurations required by the new version "check release notes", before mounting it to new version of the container.
- Update the environment variables to include
FORCE_UPGRADE
see below,environment:
- FORCE_UPGRADE=true
- You can use the provided
run.sh
to bring up the setup or do it manually by following the steps shown below. Update the passwords to represent Passwords used in previous version.
# Set passwords
export XLR_ADMIN_PASS=admin
export POSTGRES_PASS=admin
# upgrade master nodes,
docker-compose -f docker-compose-xlr-ha.yaml up --scale xl-release-master=2 -d
# Print out the status
docker-compose -f docker-compose-xlr-ha.yaml ps
- You can view the logs of individual containers using the
docker logs <container_name> -f
command. - You can access the XL Release UI at http://localhost:8081