Perform the following upgrade process for containers running on BDDS appliances that are in a Production environment and behind a firewall.
Before you begin, make sure you have completed the following:
- New or updated custom image has been built on BlueCat Gateway v20.12.1 or greater and leverages the Built-in workspace. For more information on the Built-In workspace and using Dockerfile to generate custom images, refer to Adding Built-in Workflows to the BlueCat Gateway Container.
- Custom image has been packaged into a tar file:
docker save –o /path/to/file.tar <repository|imagename>
To upgrade a custom container in a production environment:
Stop the container from the BDDS Diagnostics page.
Attention: Do not disable Gateway Service.
From the CLI of your Linux Console, copy the tar file to the BDDS:
scp /path/to/file/<customimage>.tar root@<bdds-ip-address>:.
- At the prompt, enter your BDDS root password.
Connect to the BDDS and unpack the image.
ssh root@<bdds-ip-address> docker load -i /root/<customimage>.tar
- Return to BAM. From the Gateway Service page, deselect the Enable Gateway Service checkbox. The Remove Image checkbox appears.
- Select the Remove Image checkbox.
- Click Update. Gateway Service removes the old image from the BDDS appliance and stops. Once done, BAM returns you to the BDDS Service Type dropdown menu page.
From the Gateway Service page, set the following parameters:
- Enable Gateway Service—select this check box to start BlueCat Gateway Service.
- Ports—enter a list of ports to configure for BlueCat Gateway.
- Environment Variables—enter a list of environment variables to pull to a container during startup.
Under Repositories, set the following parameters:
- Repository—enter the repository address of the new image, in the format quay.io/bluecat/<repository>.
- Tag—enter the new version tag.
- Click Update.