The following task describes the steps to deploy a custom BlueCat Gateway image to a Production environment. This task also applies if you need to deploy Gateway, Adaptive Applications, or Plugins with BDDS behind a firewall (even in a Lab environment).
In this scenario, BDDS is behind a firewall and is not routable to either a cloud or local repository. You must first copy the tarred image directly to the Production BDDS appliance, then enable Gateway Service from the BAM UI.
A custom image is BlueCat's recommended best practice for deploying Gateway to a Production environment. A custom image is built on top of the Gateway base image. The deployed container will include all necessary workflow/application data, thereby removing the need to import workflows or change configurations of a running container manually. This simplifies deployments to Production and improves container resiliency. 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 in the BlueCat Gateway Administration Guide.
Before you begin, ensure you have completed the following:
- Ensure Gateway Service is disabled on the production BDDS
- The custom image has been built on BlueCat Gateway v20.12.1 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
- The custom image has been packaged into a tar file:
docker save –o /path/to/file.tar <repository|imagename>
To copy the custom image to BDDS:
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.
Since Gateway Service is disabled, you must start Docker on the BDDS.
systemctl start docker
docker psto verify that Docker is running.
Unpack the image.
docker load -i /root/<customimage>.tar