Overview of Universal Connector architecture


(BMC.DB2.SPE2404) 

The BMC AMI SQL Assurance Universal Connector (UC) application is a containerized application that is designed for easy integration with continuous integration (CI) applications. CI applications support the running of the pipeline or workflow in a container environment by any agent or runner, including a self-hosted agent or runner. The UC application image name is defined in the CI pipeline or workflow configuration file. A self-hosted agent or runner is installed and configured for the CI application in a VM that has access to the CI application server and z/OSMF server.

Related topics

Integrating Universal Connector with Azure DevOps

To integrate Universal Connector with Azure DevOps, use the UC application image in the Azure DevOps pipeline configuration. The pipeline creates the container and runs UC application steps inside the container. The following figure depicts the process for integrating UC with the Azure DevOps application:

SA UC Azure DevOps.drawio.png

This process involves the following steps:

  1. You run the Azure DevOps pipeline by committing any change in the Git repository file, or other Azure DevOps supported repository file, via a trigger or manual run. 
  2. The pipeline service gets the self-hosted agent and pipeline information from the pipeline configuration file in the Git repository.
  3. The pipeline service assigns the self-hosted agent to run the pipeline.
  4. The self-hosted agent connects to the Container Registry server that hosts the image.
  5. The self-hosted agent pulls the Container image from the Container Registry.
  6. The self-hosted agent creates the Container from the pulled image.
  7. The self-hosted agent checks out (downloads) all files from the Git repository to the Container workspace.
  8. The self-hosted agent runs the UC application steps defined in the pipeline configuration. The UC application communicates with the z/OSMF server and performs the required operation. 

Integrating Universal Connector with GitHub Actions

To integrate Universal Connector with GitHub Actions, use the UC application image in GitHub Actions workflow configuration. The workflow creates the container and runs UC application steps inside the container. The following figure depicts the process for integrating UC with the GitHub Actions application:

SA UC GHA.jpg

This process involves the following steps:

  1. You run the GitHub Actions workflow by committing any change in the GitHub repository file, via a trigger or manual run. 
  2. The workflow service gets the self-hosted runner and workflow information from the workflow configuration file in the Git repository.
  3. The workflow service assigns the self-hosted runner to run the workflow.
  4. The self-hosted runner connects to the Container Registry server that hosts the image.
  5. The self-hosted runner pulls the Container image from the Container Registry.
  6. The self-hosted runner creates the Container from the pulled image.
  7. The self-hosted runner checks out (downloads) all files from the Git repository to the Container workspace.
  8. The self-hosted runner runs the UC application steps defined in the workflow configuration. The UC application communicates with the z/OSMF server and performs the required operation.

Integrating Universal Connector with GitLab CI/CD

(BMC.DB2.SPE2501)

To integrate Universal Connector with GitLab CI/CD, use the UC application image in the GitLab CI/CD pipeline configuration. The pipeline creates the container and runs UC application steps inside the container. The following figure depicts the process for integrating UC with the GitLab CI/CD application:

UC GHA New.drawio.png

This process involves the following steps:

  1. You run the GitLab CI/CD pipeline by committing any change in the Git repository file, via a trigger or manual run.
  2. The pipeline service gets the self-managed runner and pipeline information from the pipeline configuration file in the Git repository.
  3. The pipeline service assigns the self-managed runner to run the pipeline.
  4. The self-managed runner connects to the Container Registry server that hosts the image.
  5. The self-managed runner pulls the Container image from the Container Registry.
  6. The self-managed runner creates the Container from the pulled image.
  7. The self-managed runner checks out (downloads) all files from the Git repository to the Container workspace.
  8. The self-managed runner runs the UC application steps defined in the pipeline configuration. The UC application communicates with the z/OSMF server and performs the required operation. 

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

BMC AMI SQL Assurance for Db2 13.1