This article demonstrates a typical scenario how to deploy a microservice on OpenShift using the GitOps capabilities of ArgoCD.
The microservice is deployed to three different projects: dev, test and prod. For simplification reasons they belong to the same cluster. For each environment there is an ArgoCD application: dev, test, prod.
In order to synchronize between the ‘to be state’ in the GitOps repo and the ‘is state’ in Kubernetes, ArgoCD is used. For the deployment of my sample microservice I use the repo nheidloff/application-modernization-javaee-quarkus-config.
Sample Tekton Pipeline
The pipeline contains the following Tekton tasks and steps. The code can be found in the scripts-openshift-argocd directory.
First the code is pulled from GitHub. In this case it’s a public repo, but it could also be private since it is accessed on behalf of a specific user via ssh.
In the next steps the Java code is built and static and unit tests are executed. After this the image is built and pushed to OpenShift’s internal registry.
So far nothing has been specific to GitOps. You would basically use the same steps in other pipelines. In the next step though the image is tagged with an unique id. Usually this is the Git commit id to map between a specific image version to a specific code version. Additionally the image is pushed to the three projects (or in one shared project with images).
1 2 3 4 5 6 7 8 9 10 script: | #!/usr/bin/env sh set -e source $(workspaces.app-source.path)/revision.txt echo REVISION: $REVISION echo image: $(params.image) echo Tagging dev image buildah pull --tls-verify=false docker://$(params.image) buildah tag docker://$(params.image) docker://$(params.image):$REVISION buildah push --tls-verify=false docker://$(params.image):$REVISION
Note that I pass in the GitHub commit id (REVISION) via a file in the workspace. I’ve tried to use Tekton input and output parameters, but it didn’t work for my OpenShift Tekton version.
After this the yaml files for the microservice version in the dev environment are updated with the latest image tag.
1 2 3 4 5 6 7 8 9 10 11 12 script: | #!/usr/bin/env sh set -e source $(workspaces.app-source.path)/revision.txt echo REVISION: $REVISION cd $(workspaces.config-source.path) cd service-catalog-quarkus-reactive cd $(params.environment) sed "s/<project-name>/app-mod-argocd-$(params.environment)/g" $(workspaces.app-source.path)/service-catalog-quarkus-reactive/deployment/kubernetes.yaml.template > kubernetes-temp.yaml sed "s/<version>/$REVISION/g" kubernetes-temp.yaml > kubernetes.yaml cp $(workspaces.app-source.path)/service-catalog-quarkus-reactive/deployment/openshift.yaml openshift.yaml
Next the changes need to be pushed to the GitOps repo.
1 2 3 4 5 6 7 8 9 10 script: | #!/usr/bin/env sh set -e eval $(ssh-agent) ssh-add ~/.ssh/id_* git config --global user.email "email@example.com" git config --global user.name "Tekton Pipeline" git add . git commit --allow-empty -m "[Tekton] updating $(params.environment)" git push origin main
In the last step ArgoCD is triggered to synchronize the new ‘to be state’ with the ‘is state’ in OpenShift.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 spec: params: - name: argo-app-name stepTemplate: envFrom: - secretRef: name: argocd-env-secret env: - name: ARGOCD_SERVER value: argocd-cluster-server.openshift-gitops steps: - name: wait-for-argocd-rollout image: argoproj/argocd:v1.7.7 script: | #!/usr/bin/env sh set -e argocd app sync $(inputs.params.argo-app-name) --insecure argocd app wait $(inputs.params.argo-app-name) --sync --health --operation --insecure
If the microservice works in the dev environment, it will be deployed to the test environment and after additional tests have been made it will be deployed to production.
In the ArgoCD Console you can see the status of your applications. The screenshot shows the three ArgoCD applications for the three environments.
Additionally you can navigate to specific applications for details. The next screenshot shows the different Kubernetes and OpenShift resources for the microservice.
To learn more about Tekton, ArgoCD and application modernization, check out my repo.