Follow this example repo for a typical workflow of gitkube.

Gitkube has three components:

1. Remote: Custom resource defined by a K8s CRD
2. gitkube-controller: Controller that manages Remote objects and propogates changes to gitkubed
3. gitkubed: Git host that builds docker image from repo and rolls out deployment

• Local dev: User creates a base git repo for the application with Dockerfile and K8s deployment
• Setting Remote: User defines a spec for Remote containing the rules for git push
• Deploying application: Once a Remote is setup, application can be deployed to K8s using git push <remote> master

User should have a git repo with source code and a Dockerfile. User should also create a base K8s deployment for the application.

A Remote resource consists of 3 parts:

1. authorizedKeys: List of ssh-keys for authorizing git push.
2. registry: Details of docker registry where images are pushed post-build.
3. deployments: Spec for building docker image and updating corresponding K8s deployment.

Here is a typical spec for a Remote:

apiVersion: gitkube.sh/v1alpha1
kind: Remote
metadata:
  name: sampleremote
  namespace: default
spec:

# Insert ssh-keys for allowing users to git push
  authorizedKeys:
  - "ssh-rsa your-ssh-public-key"

# Provide registry details: https://github.com/hasura/gitkube/blob/master/docs/registry.md
  registry:
    url: "docker.io/user"
    credentials:
      secretRef: regsecret                # Name of docker-registry secret

# Define deployment rules
  deployments:
  - name: www                             # Name of K8s deployment which is updated on git push
    containers: 
    - name: www                           # Name of container in the deployment which is built during git push
      path: example/www                   # Docker build context path in the git repo
      dockerfile: example/www/Dockerfile  # Location of Dockerfile for the source code

Once a Remote is created, it gets a git remote url which you can find in its status spec

$ kubectl get remote sampleremote -o yaml
...
status:
  remoteUrl: ssh://default-sampleremote@35.225.226.96/~/git/default-sampleremote
  remoteUrlDesc: ""

Add the generated remoteUrl in git

$ git remote add sampleremote ssh://default-sampleremote@35.225.226.96/~/git/default-sampleremote

And finally, git push

$ git push sampleremote master

Gitkube is open to evolution. Some of the features to be added in future include:

• Allowing all apps (daemonset, statefulset) to be deployed using git push. Current support is limited to deployments. #19
• Allowing different git hooks to be integrated #20

Gitkube is an open source project licensed under Apache License 2.0

Contributions are welcome.

• Join the Gitkube channel in the Kubernetes Slack group

• 

• Subscribe to the Gitkube mailing list

This project has come out of the work at hasura.io. Current maintainers @Tirumarai, @shahidh_k.

Follow @gitkube to stay updated.

Gitkube logo concept and design by Samudra Gupta.