GitOps is a practice of storing configuration and infrastructure definitions in a git repository. The same way developers store application code on git, GitOps extends that practice to application deployment. There are tools that marry the GitOps methodology with Kubernetes, like ArgoCD, Flux, Jenkins X…
This repo serves as a tutorial on how to integrate Cyclops with GitOps, namely ArgoCD.
Feel free to fork the repo, play around with it, and propose alternative approaches! 🧡
Here are the prerequisites for the rest of the tutorial and how to set them up.
- Kubernetes cluster
- if you don't have a running cluster you can use, you can install and run minikube
- kubectl
- ArgoCD
- Cyclops
- Clone this repository
All applications within Cyclops are defined as CRDs called Modules. Each time a Module is created, the Cyclops controller picks it up, creates other Kubernetes resources from it, and applies them to the cluster. Since Modules are CRDs, you can define them via the YAML manifest. Those manifests allow you to define everything you need for your application in a single place.
Since a Module can be defined through a manifest, it can be stored on a git repo and included in your GitOps workflow! In this repository, you can find the argo-app.yaml file and the /apps folder that holds module definitions.
The picture below shows the hierarchy of resources inside the cluster with the setup.
In the root of the hierarchy, there is the my-team-apps Argo application defined in the argo-app.yaml file in the root of the repo. The application deploy everything from the https://github.com/cyclops-ui/gitops-starter repo (this one) under path apps.
As mentioned, that folder contains three module definitions separated into respective files. When the ArgoCD controller syncs those Modules into the cluster, the Cyclops controller takes over and turns those Modules into other Kubernetes resources like Deployment, Services, StatefulSets, or whatever is defined in the Helm chart referenced by the Module and its values.
To deploy the proposed setup from above, ensure all of the prerequisites are met and you can access your ArgoCD and Cyclops instances.
Open your terminal and cd to this repository. You can create the my-team-apps Argo application with the following command:
kubectl apply -f argo-app.yamlYou can now see your newly created Argo application in your ArgoCD UI:
All of the Modules are also visible in the Cyclops UI:
You can now check all of the resources created from a Module through the Cyclops UI. You are also free to update app configuration through Cyclops.
When updating a Module through Cyclops, you could introduce a diff in ArgoCD. For example, while updating replicas through Cyclops, Argo might report it as in the image below
To avoid this, you can simply remove the field you want to edit through the UI from the Module manifest in git.
If you want to restrict edits of any fields explicitly, you can mark them as immutable in your helm chart schema. An example of a template with immutable fields is used for the other-app you have already deployed.
In the image above is the edit screen of the other-app, and fields for image and version cannot be updated and should be updated through the GitOps workflow.
⚠️ Please note, our roadmap is subject to change.⚠️ If there's something you'd like to see added, feel free to reach out and let us know!
- Option to disable the Add module button
- in case you want to restrict creating a Module to your GitOps workflow
- Option to disable changing the template in the Edit template screen
- in case you want to restrict updating Module templates to your GitOps workflow