Loading additional playbooks

Playbook actions are loaded into Robusta using the playbookRepos Helm value.

Robusta has a set of builtin playbooks.

You can load extra playbook actions in two different ways from git repositories, via HTTPS or via SSH. For private repos you will need to use SSH.

1. Loading a public git playbook by HTTPS:

playbookRepos:
  # we're adding the robusta chaos-engineering playbooks here from https://github.com/robusta-dev/robusta-chaos
  my_extra_playbooks:
    url: "https://github.com/robusta-dev/robusta-chaos.git"

2. Loading a public or private git playbook by SSH:

playbookRepos:
  # we're adding the robusta chaos-engineering playbooks here
  my_extra_playbooks:
    url: "git@github.com:robusta-dev/robusta-chaos.git"
    key: |-
      -----BEGIN OPENSSH PRIVATE KEY-----
      ewfrcfsfvC1rZXktdjEAAAAABG5vb.....
      -----END OPENSSH PRIVATE KEY-----

The key should contain a deployment key, with read access. You can also save the SSH key in a Kubernetes Secret, and reference it using an environment variable, like this:

additional_env_vars:
 - name: GITHUB_SSH_KEY
   valueFrom:
     secretKeyRef:
       name: ssh-key
       key: id_rsa

playbookRepos:
  # we're adding the robusta chaos-engineering playbooks here
  my_extra_playbooks:
    url: "git@github.com:robusta-dev/robusta-chaos.git"
    key: "{{env.GITHUB_SSH_KEY}}"

Note

Robusta does not watch for changes on git repositories. Playbooks are loaded from the repository when the server starts or the configuration changes, or by running manual reload: robusta playbooks reload