Git Provider

This is a Krateo Provider that clones git repositories (eventually applying templates).

Summary

• Summary
• Overview
• Examples
• Configuration

Overview

Git Provider clones git repositories and may apply Mustache templates. It then pushes the cloned and modified repository to a different location. The templating values are retrieved in a configmap referenced in the custom resource. It provides automatic reconciliation when changes are retrieved from the original repository.

Git Provider leverages Krateo provider-runtime a production-grade version of the controller-runtime.

Examples

Provider Installation

$ helm repo add krateo https://charts.krateo.io
$ helm repo update krateo
$ helm install git-provider krateo/git-provider

Manifest Application

As a first step, you need to create a kind: Repo Manifest as shown below and a ConfigMap which will contain the templating values.

File Templating

git-provider uses the Mustache library (see custom delimiter reference) to apply templating. Therefore, you need to specify the custom delimiter you want to use in the first line of the file you want to template. You can see an example here.

File Name Templating

If you need to template the filename of a file, you can only use the delimiters {{ }} (e.g., {{ your-prop }}.yaml).

Repo Manifest

apiVersion: git.krateo.io/v1alpha1
kind: Repo
metadata:
  name: test-repo
spec:
  enableUpdate: false
  configMapKeyRef:
    key: values
    name: filename-replace-values
    namespace: default
  fromRepo:
    authMethod: generic
    branch: main
    path: skeleton
    usernameRef:
      key: username
      name: git-username
      namespace: default
    secretRef:
      key: token
      name: git-secret
      namespace: default
    url: https://github.com/your-organization/fromRepo
  toRepo:
    authMethod: generic
    branch: main
    cloneFromBranch: main
    path: /
    secretRef:
      key: token
      name: git-secret
      namespace: default
    usernameRef:
      key: username
      name: git-username
      namespace: default
    url: https://github.com/your-organization/toRepo
  unsupportedCapabilities: true

Configmap Manifest

apiVersion: v1
kind: ConfigMap
metadata:
  name: filename-replace-values
data:
  values: |
    { 
      "organizationName": "krateo",
      "repositoryName": "testfilename",
      "serviceType": "type",
      "servicePort": "8080",
      "testTemplate": "tplKrateo"
    }

Configuration

To view the CR configuration visit this link.