Build a CI/CD Pipeline for Integrations (K8s deployment)
There are two kinds of jobs in Jenkins that we need to maintain. One for the Integration project repositories. Another kind is for the Deployment Descriptor repositories.
Integration Project Build Job¶
- We need to maintain one Jenkins job per Integration Project repository.
- The Integration Project has to be a Maven Multi Module project and it has to contain one Kubernetes Exporter module.
- The build phase of the job will build the Integration project and run the unit tests if a Unit test server is configured.
- The release phase of the job generates Docker images using the provided repository, name and project version and pushes the image to the configured Docker registry and creates a release tag in GitHub.
Deployment Descriptor Build Job¶
- We need to maintain one Jenkins job per Environment.
- There will be descriptor files for each project inside a separate folder. These will be generated in Integration Studio when you create a Kubernetes Exporter Module.
- To use a new version / rollback to a previous version, the user should define the version inside the respective descriptor file
integration_k8s.yamland commit to the respective branch.
- This job contains only the build phase. This will apply the relevant yaml files in the relevant environment.
Integration Studio will be used to generate Kubernetes artifacts, while creating the Kubernetes exporter module. There are two kinds of Kubernetes artifacts that you can create in Integration Studio. These will be generated inside a folder with the Project Name.
- Pure Kubernetes artifacts
- K8s-Operator based Kubernetes artifact
Setting up the environment¶
Integration Studio 8.0.0 or higher
Two GitHub repositories
Source repository - To maintain the source of the project
Deployment repository - To maintain the descriptor files of the environment
Jenkins server for Continuous Integration
Docker registry - To store the MI images.
Kubernetes cluster with 3 different namespaces
Separate Micro Integrator instance as Unit Testing Server (Optional)
Sample User guide¶
Clone the samples-apim repository
Create Integration Project for your solution via the Integration Studio
By default, Integration studio adds parent maven details in the submodule POMs. You can customize maven details while creating the solution.
Update Project pom scm details by filling the git location.
<scm> <connection>scm:git:https://github.com/username/repository.git</connection> <developerConnection>scm:git:https://github.com/username/repository.git</developerConnection> <url>https://github.com/username/repository.git</url> </scm>
Commit your changes to the GitHub source repository
- Set up Jenkins server
- Login to the Jenkins server using the credentials given in the Dockerfile of Jenkins instance.
- Navigate to the project build job and trigger a build.
- Create WebHooks in relevant GitHub repositories pointing to the Jenkins server. (Source & Deployment)
- Perform a maven release by giving release and development versions.
- Once the release build is passed, confirm that the Docker image is available in the Docker registry.
- Copy the folder containing the yaml files in Kubernetes exporter project inside a folder specific to each environment.
- Commit the above created folder to the dev branch (environment) of the deployment repository.
- Once you commit the changes, you can observe that the descriptor-dev job starts running and it applies the Yaml files into the Dev namespace in Kubernetes cluster.
- Verify that the new changes are available in the Dev environment.
You can repeat steps 12, 13 and 14 for the Staging and Prod environment.
Please note that according to current scripts, when you change only the config map, the change won’t get reflected in the running pod. To do a proper deployment you may need to use tools like kustomize.
Setting up Jenkins server¶
Docker scripts for setting up a Jenkins environment are provided here. This will spin up a preconfigured Docker image. By default, 4 Jenkins jobs will be created. One project for the Integration project and three more for the environment descriptor repositories (dev, staging, prod).
Both the Integration project, and descriptor repositories will be in GitHub.
Note: You can customize the Docker scripts to create Jenkins jobs for multiple Integration projects.
Navigate to the Docker VM artifacts directory.
Open up the Dockerfile and fill up the project and environment related details.
[Optional] If you want to customize the Jenkins configuration, update the Jenkins_casc_vm.yaml file.
[Optional] : Setting up Synapse Unit testing server
Run the following build command to build the Docker image.
docker build -t <image-name>:<image-tag> .
Run the following command to run the image. You need to configure the .ssh folder to access the dev, staging and production environment and mount the folder to the container.
docker run -d -p 8080:8080 -v /var/run/docker.sock:/var/run/docker.sock -v ~/.kube:/root/.kube <image-name>:<image-tag>
We need to share the host .ssh configurations with the Docker container as in above. The host machine needs to have ssh access to copy the CApps files to the remote instance where the Micro Integrator instances are running.
After installing Jenkins, the jobs can be accessed via http://localhost:8080/
Setting up Synapse Unit testing server¶
If you have written Synapse unit tests for your Integration project, you can run them during the Jenkins build.
To set up the Synapse Unit testing server, please follow the below steps.
Run a separate Micro Integrator Instance in Unit testing mode. To start the server in Unit testing mode please pass this argument
If you want to change the synapse testing port, you can pass the
-DsynapseTestPort=<new Port>to the above command. Default port is 9008
Update Jenkins Dockerfile as below.
SYNAPSE_TEST_FRAMEWORK_CONFIGS= -DtestServerType=remote -DtestServerHost=<IP of testing server> -DtestServerPort=9008