BlueCat Gateway is delivered as a container image published in a public BlueCat cloud registry on Quay.io. You do not need a Quay.io account to pull the BlueCat Gateway image. Use Docker commands in the Linux CLI to pull the image, then to run, stop, start, or remove containers. For a list of commonly used Docker commands, refer to Docker commands.
You can also obtain the image as a tar file from BlueCat Customer Care. For more information, refer to Installing BlueCat Gateway from Customer Care on page 9.
If your Linux host machine is behind a firewall, you must first pull the BlueCat Gateway image on a separate Linux machine with Internet connectivity, and then copy the image to the host machine. For complete details about refer to article 10393 on BlueCat Customer Care.Before you Start
- Define a workspace:
- A workspace is the logical location for you to place your workflows and associated data, including configurations, libraries, requirements, permissions, and customizations; a workspace can be a Docker volume (recommended) or a volume on your local machine. For more information, refer to the Workspace section in the BlueCat Gateway Administration Guide.
- Define a logs directory:
- A logs directory can be a Docker volume (recommended) or a volume on your local machine
chmod -R o=rwx <mapped volume>
- You can name the workspace and logs directory to anything.
- BlueCat Gateway saves configuration and workflow data to the workspace, and all execution and session logs to the mapped logs directory. If you do not map a workspace or a logs directory, all the configuration and logging data is written to the container by default.
- <bluecat_gateway> is used throughout the BlueCat Gateway documentation to refer to this workspace.
To obtain the BlueCat Gateway image from the public repository:
docker run -d -p 80:8000 -p 443:44300 -v <path_to_workspace>:/ bluecat_gateway/ -v <path_to_mapped_log_directory>:/logs/ -e BAM_IP=<your bam ip> --name bluecat_gateway quay.io/bluecat/gateway:20.1.1
docker run -d -p 80:8000 -p 443:44300 -v <path_to_workspace>:/ bluecat_gateway/ -v <path_to_mapped_log_directory>:/logs/ --name bluecat_gateway quay.io/bluecat/gateway:20.1.1
For more information on Docker commands, refer to Docker commands.