Skip to main content

Integration guide: Morio and GitHub

GitHub can be used for preseeding the Morio configuration.

warning

Unlike GitLab, GitHub cannot be used for authentication as GitHub does not support OpenID Connect.

Preseeding Morio from GitHub​

When preseeding Morio from GitHub, you have two choices:

We recommend the cloning a GitHub repository approach for most users.

Preseed Morio by cloning a GitHub repository​

tip

This way of preseeding is not specific to GitHub but works for any git hosting provider that supports cloning over HTTPS.

If your repository is accessible without authentication, all you need is the HTTPS clone URL. If not you also need to configure an access token so Morio can authenticate to be able to clone the repository.

git:
  github:
    url: "https://github.com/certeu/morio.git"
preseed:
  base: "git:base.yaml@github"
}
tip

Refer to the Preseeding Guide and the reference documentation on the preseed settings for more details.

Preseed Morio from the GitHub API​

If your repository is very large and you only need one or a few files from it, you can configure Morio to not clone the repository, but instead load specific files from the GitHub API. This does always require authentication with an access token.

preseed:
  base: 
    github:
      url: "https://github.morio.it"
      owner: certeu
      project: morio
      file_path: settings/production.yaml
      token: "{{ GITHUB_TOKEN }}"
secrets:
  GITHUB_TOKEN: "Your token here"
tip

Refer to the Preseeding Guide and the reference documentation on the preseed settings for more details.