Agnost GitOps

Agnost GitOps is an open source GitOps platform running on Kubernetes clusters. It provides a complete CD solution for building, deploying, and managing applications in a Kubernetes cluster. In short, you connect your GitHub, GitLab or Bitbucket repository and Agnost takes care of building and deploying your app to your Kubernetes cluster when you push new code.

For how to install, set up and use Agnost please refer to its documentation.

Key Features

Agnost provides the following features:

Integration with GitHub, GitLab or Bitbucket. You can connect your git repo to your container in your Kubernetes cluster and whenever you push new code, Agnost pulls the code, builds the docker image and deploys it.
Building docker images. Under the hood we use Kaniko to build container images from a Dockerfile. Through Agnost Studio you can monitor build status and access to build logs.
Deploy docker images. If you connect your git repo to your container in your cluster, Agnost will automatically handle the build and deployment. Additionally, you can also deploy publicly available Docker images through Agnost Studio.
Flexible networking settings. For your containers, Agnost can automatically generate a subdomain based ingress or you can define your own custom domain to expose your application services to the outside world. Additionally you can also enable/disable TCP proxying so that you can connect your containers through a dedicated port.
TLS certificates and wildcard domains. Not only a standard domain but you can als define wildward subdomins for your containers and Agnost automatically handles the TLS certificate issue and renewal.
One click deployment using build-in templates. Agnost comes with predefined templates for commonly used open-source platforms such as MongoDB, PostgreSQL, MySQL, MariaDB, Redis, Memcached and Minio. With one click you can easily deploy your database, cache or object storage.

Community

We'd love to hear from you! Join our Discord channel.

How does Agnost work?

Under the hood Agnost uses several open source solutions and integrate them seamlessles. Basically, for each new container that you create and associate with your git repository we create a Tekton pipeline and register a webhook to your git repository to listen push events. Whenever you push your code updates to your repository this webhook is triggered and Tekton pipeline starts running.

There are three steps in the Tekton pipeline, which are executed in sequence and described below:

Setup: At this first step we clone your git repository to the Kubernetes cluster where Agnost is running
Build: Using Kaniko, we build the OCI compliant docker image and push the image to the Registy in your Kubernetes cluster.
Deploy: Using the pushed image, we change the image of your container in your Kubernetes cluster.

Please note that all setup, build and deploy operations are performed within your cluster and no data or files are transferred outside of your cluster.

Installing and Setting up Agnost

For how to install, set up and use Agnost please refer to its documentation. Alternatively, you can also have a look to Agnost Helm chart.

In short, you need to have an up and running Kubernetes cluster with at least 4CPUs and 8GB of memory and install the Agnost Helm Chart to this cluster.

Want to Contribute

See CONTRIBUTING.md for an overview of our processes.