gitbackup

Git Backup Operator

A Kubernetes Operator for scheduled backup of Git repositories.

• Git Backup Operator
  • Overview
  • Getting Started
    • Installation
    • Deploy a Repository resource
    • Uninstallation
  • Developing

Overview

1. You create a Repository resource.
2. The controller creates a CronJob resource from it.
3. The CronJob does the actual work.

apiVersion: gitbackup.ebiiim.com/v1beta1
kind: Repository
metadata:
  name: repo1
spec:
  src: https://github.com/ebiiim/gitbackup
  dst: https://gitlab.com/ebiiim/gitbackup
  schedule: "0 6 * * *"
  gitCredentials:
    name: repo1-secret # specify a Secret resource in the same namespace

Getting Started

Installation

1. Make sure you have cert-manager installed, as it is used to generate webhook certificates.

kubectl apply -f https://github.com/cert-manager/cert-manager/releases/download/v1.10.0/cert-manager.yaml

1. Install the controller with the following command. It creates gitbackup-system namespace and deploys CRDs, controllers and other resources.

kubectl apply -f https://github.com/ebiiim/gitbackup/releases/download/v0.1.0/gitbackup.yaml

Deploy a Repository resource

1. Create a Secret resource that contains .git-credentials.

kubectl create secret generic repo1-secret --from-file=$HOME/.git-credentials

1. Create a Repository resource.

apiVersion: gitbackup.ebiiim.com/v1beta1
kind: Repository
metadata:
  name: repo1
spec:
  src: https://github.com/ebiiim/gitbackup
  dst: https://gitlab.com/ebiiim/gitbackup
  schedule: "0 6 * * *"
  gitCredentials:
    name: repo1-secret

1. Confirm that resources has been created.

$ kubectl get repos
NAME    AGE
repo1   5s

$ kubectl get cronjobs
NAME              SCHEDULE    SUSPEND   ACTIVE   LAST SCHEDULE   AGE
gitbackup-repo1   0 6 * * *   False     0        <none>          5s

Note: You can test the CronJob by manually triggering it.

kubectl create job --from=cronjob/<name> <job-name>

Uninstallation

1. Delete all Repository resources.

kubectl delete --all repos -A

1. Delete the Operator.

kubectl apply -f https://github.com/ebiiim/gitbackup/releases/download/v0.1.0/gitbackup.yaml

Developing

This Operator uses Kubebuilder, so we basically follow the Kubebuilder way. See the Kubebuilder Documentation for details.

Note: You can run it with KIND with the following command.

./hack/dev-kind-reset-cluster.sh
./hack/dev-kind-deploy.sh