Welcome to Koncrete! This doc describes the process of creating Workspaces and Applications in Koncrete.

Workspace and Application Structure in Koncrete

The first step to getting started with Koncrete is creating a Workspace. A Koncrete Workspace contains applications that are connected to Git repositories and Kubernetes clusters. Workspaces are also used to set global settings, modify team permissions, and organize projects.

Applications are designed to sync a Kubernetes cluster to the configuration files specified within a Git Repository. Workspaces can hold multiple applications, spanning any number of Git repositories and Kubernetes clusters.

The following diagram illustrates the relationship between Workspaces, Applications, Kubernetes clusters, and Git repositories.

https://s3-us-west-2.amazonaws.com/secure.notion-static.com/d36c9b8c-7dda-4545-9c2c-f730108bfa71/Workspace_Structure.svg

Create a Workspace

On a fresh Koncrete environment, click the NEW WORKSPACE button.

Follow the prompts to give the workspace a name and URL. This will also assign the ArgoCD URL.

https://s3-us-west-2.amazonaws.com/secure.notion-static.com/e00de8f8-809e-425e-9a59-56f66979c516/Untitled.png

Click CREATE WORKSPACE to create the Workspace. The Status will show a pending symbol with the text "Installing". This can take a few minutes, so check out some of the documentation on Getting Started in the mean time.

The Status will change to "Ready" when the installation is finished. The new Workspace is now available!

Connecting To ArgoCD

Once the Workspace is created, an associated ArgoCD server will also be available. Click the newly created Workspace name, and it will prompt you to install ArgoCD's CLI if not already installed.

https://s3-us-west-2.amazonaws.com/secure.notion-static.com/152c58aa-bc3c-40f2-995b-6ce450b358b8/Untitled.png

Follow the steps here to install the CLI, login to ArgoCD, and and add a cluster. Then click CHECK AND CONTINUE.

ArgoCD is now configured! Koncrete should display the Overview dashboard.

https://s3-us-west-2.amazonaws.com/secure.notion-static.com/9de89cd3-1bb2-4799-a926-e1fcfc336ff8/Untitled.png

Creating an Application