Quick start

The following guide will follow our guidelines and how we would manage our deployments. But it in the end, it is totally up to you how you want to manage your space in the cluster.

The easiest way to get started, is to use a public template provided on github.

• Contact Kithosting by mailing and request a tenant. We will provide you with a <<tenantname>> and access to the deployment agent (Argo).
• Access the template repo here https://github.com/KvalitetsIT/kithosting-tenant-applications
• If you already have a github account you can press “use template” and follow this guide. If you don’t have a github account account just check out the code and push it to your favorite git.
• Git clone the new git repo
• Run sh setup.sh <<tenantname>>. This will customize the git repository to the actual tenant name.
• Commit and push the changes.

You now have a working gitops repo.

• Login into Argo on the test environment: https://argo.t0.hosting.kitkube.dk/ .
• Go to Settings > Repositories. Choose “Connect repo using HTTPS”
• Enter the “Repository URL” and press “Connect”
• Now Argo is able to connect to the git repository. To deploy the configuration code from git, we just need to setup an Argo application. This is done by clicking “NEW APP”. When this is clicked you will be prompted to fill out a form
• Application: should be the same name as you have provided in your values-{{env}}-file.
  • Application Name: Should be the same name as you have provided in your values-{{env}}-file.
  • Project: You should be able to pick something here that matches your tenant.
  • Source: Repository url in the dropdown select the one you added a few steps back
  • Path should be the path to your app of apps, in our case; apps
  • Destination cluster url click on one in the dropdown
  • Namespace should be your tenant-name (if in doubt check out the infrastructure-application)
  • Click “Directory” and select “Helm”
  • Values files should be values.yaml and values-test.yaml (beware that the order is important!)

You now have you first service up and running in a HA container environment.

To get a deeper understanding read the deployment section.