GitOps Action

GitOps action allows you to make commits and push to a remote repository.

update-pod-namespace.yaml

apiVersion: mission-control.flanksource.com/v1
kind: Playbook
metadata:
  name: update-pod-namespace
spec:
  parameters:
    - name: namespace
      label: The new namespace
  configs:
    - type: Kubernetes::Pod
  actions:
    - name: Modify namespace
      gitops:
        repo:
          url: https://github.com/example/repo
          connection: connection://github/example
          base: master
          branch: playbooks-branch-{{.params.namespace}}
        commit:
          email: john@doe.com
          author: John Doe
          message: |
            Modifying namespace from {{.config.namespace}} to {{.params.namespace}}
        pr:
          title: 'chore: Update namespace to {{.params.namespace}}'
          tags:
            - low
        patches:
          - path: navidrome.yaml
            yq: '.metadata.namespace = "{{.params.namespace}}"'
        files:
          - path: { { .config.namespace } }
            content: $delete
          - path: '{{.params.namespace}}/namespace.yaml'
            content: |
              apiVersion: v1
              kind: Namespace
              metadata:
                name:  {{.params.namespace}}

info

On Github, GitLab and Azure Devops, it's possible to create Pull Requests as well.

Field	Description	Scheme	Required	Templatable
repo	Repository details	RepositoryDetail	true	true
commit	Commit details	Commit	true	true
pr	Pull Request details (Valid only for GitHub & Azure Devops)	PullRequest		true
patches	List of patches to apply	[]Patch		true
files	List of files to create	[]File		true

note

At least a patch or files config is required.

Repository Detail

Field	Description	Scheme	Required	Templatable
connection	Connection name to use the credentials for the git repo	string
url	URL of the git repository	string
base	Branch to clone. (Defaults to "main")	string		true
branch	The new branch to create. (Defaults to base branch specified above)	string		true
type	Specify the service the repository is hosted on (eg: github, gitlab, etc)	string

note

Either the connection or the url is required.

For private GitLab repositories, please sepcify the type as "gitlab"

Commit Detail

Field	Description	Scheme	Required	Templatable
author	Author name	string	true	true
email	Author email	string	true
message	Commit message	string	true

Pull Request

Field	Description	Scheme	Required	Templatable
title	Title of the Pull request	string	true	true
tags	Tags to add to the PR	[]string		true

Patch

Patches modify existing files on the git repo. You can either use yq to modify yaml files or jq to modify json files.

Field	Description	Scheme	Required	Templatable
path	Path to patch	string	true	true
yq	yq query	string	false	true
jq	jq query	string	false	true

File

Files create or delete existing files on the git repo.

Field	Description	Scheme	Required	Templatable
path	Path to file	string	true	true
content	Content of the file. Use the $delete keyword to delete an existing file	string	true	true

Templating

The template receives a environment variable that contain details about the corresponding config, check or component and the parameter(if applicable).

Field	Description	Schema
config	Config passed to the playbook	ConfigItem
component	Component passed to the playbook	Component
check	Canary Check passed to the playbook	Check
params	User provided parameters to the playbook	map[string]string