Overview
Search
⌃K
Links

Configuring Github

This section discusses how you can configure Github to integrate with Duplo

Prerequisites

Deploy and test the applicatoin

To use GitHub CI/CD, you need to deploy the application with DuploCloud as a Service and test that it works as expected.
GitHub CI/CD is recommended only for upgrades of container images and to run tests that can be written to run before or after.

Obtain and configure an API token

In order to call a DuploCloud API from Github, you will need to obtain an API token.
The basic steps are:
  1. 1.
    (Recommended) Create a "service account" user in DuploCloud that will own the API token.
  2. 2.
    Give the DuploCloud user access the desired tenant. See adding tenants to a user.
  3. 3.
    Create an API token for that user. See creating API Tokens.
  4. 4.
    Add a Github Repository secret that contains the DuploCloud API token.
Note: A 'service account' user in DuploCloud is just a user whose user name is not an email address, such as github-bot or my-api-user. These users are not able to log in.

Adding Tenant access for users

The rest of this documentation will assume that you named the GitHub repository secret DUPLO_TOKEN.