gravity-k8s-ci-cd-agent

Gravity CI/CD Agent for ArgoCD

Gravity Agent for k8s is a multi-cloud and multi-region deployment tool. It enables easy replication of applications, low-code CI/CD setup on top of ArgoCD.

Gravity CI/CD Pipelines

Gravity CI/CD Logs

Setup

Github Repository

Add the gravity.yaml file to the root of your repository.
Make the changes as per your app

You can use the following example as a template:

metadata:
  name: nodejs-app
spec:
  branch:
    - name: main
      approval: manual
    - name: development
      approval: automatic
  aws:
    repository:
      - name: nodejs-app-east
        regions:
          - us-east-1
        branch: main
        valueFile:
          source: s3
          bucket: gravity-app-prod-values

If you are using Github to store the values file, you can use the following example to setup the repository:

metadata:
  name: nodejs-app
spec:
  branch:
    - name: main
      approval: manual
    - name: development
      approval: automatic
  aws:
    repository:
      - name: nodejs-app-east
        regions:
          - us-east-1
        branch: main
        valueFile:
          source: git

Update Github Action workflow with name as Deploy and only run CI, tests and any business logic to generate values file (such as secrets, no need to manage docker images)
You can also add pre-deploy scripts to run any commands before the deployment (such as linting, testing, etc.) ```yaml metadata: name: mono-repo-js spec: branch:
- name: main approval: manual
- name: development approval: automatic
- name: feat-.* approval: automatic preDeploy:
- name: run dummy script command: bash ./dummy.sh aws: repository:
  - name: mono-repo-js-east regions:
    - us-east-1 branch: main valueFile: source: git ```

Installing Gravity K8s Agent

helm upgrade --install gravity-cicd-agent https://gravitycloudai.github.io/gravity-k8s-ci-cd-agent -f ./chart/values.yaml -n gravity-cloud --create-namespace

Custom Helm Charts (feature/dev environments)

Logon to Gravity UI and go to Kubernetes -> Pipelines -> Pipeline Charts OR visit Console Here
Click on Create a new Pipeline Chart
Select the pre-defined chart and edit the values file as per your requirement
Once added, the agent will automatically sync the changes and deploy the helm chart to the respective environment when the new branch is created or updated.
Upon the deletion of the branch, the agent will delete the helm chart from the respective environment.

Working

The agent syncs with the repository and checks if there are any new CI actions completed.
It then check the postgress database for the status of the deployment action (if completed previously, pending or failed)
Upon finding the need for a new deployment, it creates a Kubernetes Job for that deployment.
The K8s job will generate the Docker image (along with cache stored in local docker registry), and then iterates through the cloud accounts, regions while tagging and pushin them into the repositories.
It will go and update the Values file in your git or Update the S3 values file along with the ArgoCD manifest file.
In the whole workflow, Slack notifications can be setup as per your requirement.
In the whole workflow, you can sync the deployment process with Gravity UI also.