ArgoCD¶
When you are granted a namespace, you will also receive access to the TU Wien GitLab and receive two repositories. These repositories are used to configure ArgoCD.
Managing namespace permissions¶
The repository located under https://gitlab.tuwien.ac.at/aris-gitops-namespaces is intended to manage the namespace itself. If you need to grant additional people access to your namespace, you can do it in this repository by filing a Merge Request and letting us know.
The appropriate files are located in the base folder.
Deploying your application with Kustomize¶
Kustomize is a simple tool to get your YAML manifests deployed on Kubernetes. ArgoCD supports
it out of the box. To use Kustomize, had on over to your repository in https://gitlab.tuwien.ac.at/aris-gitops-apps.
Here you will find two files: applicaiton-kustomize.yml and application-helm.yml. Since you will be using
Kustomize, delete the Helm one and edit the Kustomize YAML to match the correct path in the repository.
Once you have edited the YAML, you can apply it to the cluster:
oc apply -f application-kustomize.yml
You should now see your application in ArgoCD.
Next, you can add your manifest files to the kustomize/base folder and list them in your kustomization.yaml file:
---
apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
namespace: your-namespace
resources: # List your files here:
- deployment.yaml
- service.yaml
- ...
Once you commit and push, you can hit "Refresh" and then "Sync" to apply your changes to the cluster.
Deploying your application with Helm¶
If you only want to deploy a ready-made Helm chart, you can use Kustomize like above and add the following section
to your kustomization.yaml:
helmCharts:
- name: k8s
repo: ...
valuesInline:
...
Alternatively, you can directly deploy Helm charts. In this case, delete the application-kustomize.yml and update
the application-helm.yml, then apply like before. Your Helm chart should go in the helm directory, which will be
applied by ArgoCD when pushed.