Adding Built-in Workflows to the BlueCat Gateway Container - Platform - BlueCat Gateway - 22.4.1

Improve deployments to Production environments by first building an image in a Test environment that contains custom workflow/application data, permissions, configurations, and customizations, then deploy the complete container to Production. This "black box" container will provide consistent deployments and improved resiliency and redundancy. Gateway customers write their custom workflows, who want a better way to deploy to production, reduce manual changes, and maintain container resiliency. To add built-in workflows to a container, you must copy the workflows and the associated files to the /builtin folder via the copy command in Dockerfile.

1. Create a local directory for the files that you want to include in /builtin inside the container.
2. For each workflow you want to add, create a subfolder within this folder. For example, to add a workflow for adding an alias record under a folder named "Alias Record", you could create an add_alias_record folder as follows:
   
   Note:

   The structure of the builtin/ workspace should match the custom workspace /bluecat_gateway. For example:

   • /builtin/workflows
   • /builtin/config.py
   • /builtin/permissions.json
   • /builtin/customizations/.mailsecret

   If adding an SSO configuration to /builtin, you must add both the settings.json and advanced_settings.json files.

3. Add all desired workflows to the subfolders. Write the following script in a Dockerfile:

   FROM quay.io/bluecat/gateway:21.8.1
   USER root
                                   
   # you can add any other 3rd party libraries here e.g
   # RUN pip3 install openpyxl==3.0.5
                                   
   COPY ./workflows/ /builtin/workflows/
   COPY ./config.py /builtin/
   COPY ./permissions.json /builtin/
   
   # Ensure the content is available if the container is run with a custom User ID.
   RUN \
       chgrp -R 0 /builtin                                                     && \
       chmod -R g=u /builtin
   
   USER flask

   Note: This file must be named Dockerfile. For more information on Dockerfiles, refer to the official Docker documentation (docs.docker.com).
   Note: All folders and files added to the /builtin or /bluecat_portal folders should have rwx permissions.

   Attention: If you add the configuration and permissions files to both the /builtin and the bluecat_portal folders, the settings in the bluecat_portal folder are used.
4. Navigate to the directory that you created in step 1 and run the following docker build command to create an image using the Dockerfile:

   docker build . -t <custom_project:some_version>

   An image called custom_project:some version is created.
5. Instantiate the container by running the docker run command using custom_project:some version

   docker run -d \
   -p 80:8000 \
   -p 443:44300 \
   -v <path_to_mapped_data_directory>:/bluecat_gateway/ \
   -v <path_to_mapped_log_directory>:/logs/ \
   -e BAM_IP=<your bam ip or url> \
   --name bluecat_gateway custom_project:some_version

6. Log in to BlueCat Gateway.
7. Optional: (Perform this step only if you don't have built-in configurations and permissions). Set permissions accordingly to each workflow. Once you set permissions to each workflow, all workflows are listed in the left navigation bar.