User Guide¶

Welcome to the Git Change Operator User Guide! This comprehensive guide will help you understand, install, configure, and use the Git Change Operator effectively.

Getting Started¶

If you're new to the Git Change Operator, start here:

1. Installation - Install the operator in your Kubernetes cluster
2. Quick Start - Create your first GitCommit resource
3. Configuration - Configure authentication and operator settings
4. Kind Full Demo - Complete end-to-end demo using Kind cluster

Core Concepts¶

Resource Types¶

The operator provides two main resource types:

• GitCommit Resources - Direct commits to Git repositories
• PullRequest Resources - Create GitHub pull requests

Advanced Features¶

• Resource References - Reference existing Kubernetes resources
• Authentication - Set up secure Git authentication

Common Workflows¶

Basic File Commit¶

apiVersion: gco.galos.one/v1
kind: GitCommit
metadata:
  name: basic-commit
spec:
  repository: https://github.com/user/repo.git
  branch: main
  commitMessage: "Add configuration file"
  authSecretRef: git-token
  files:
    - path: config/app.yaml
      content: |
        apiVersion: v1
        kind: ConfigMap
        metadata:
          name: app-config

Resource Reference¶

apiVersion: gco.galos.one/v1
kind: GitCommit
metadata:
  name: export-configmap
spec:
  repository: https://github.com/user/repo.git
  branch: main
  commitMessage: "Export ConfigMap data"
  authSecretRef: git-token
  resourceRefs:
    - name: app-config
      kind: ConfigMap
      strategy:
        type: fields
        outputPath: configs/