# Usage with GitHub

GitHub and Checkson are a very good combination. You can host the source code for your check on GitHub (private repositories are supported). You can use GitHub actions to build the Docker image for your check and use the GitHub Container Registry for storing it. You can also use GitHub actions to manage the definition of the Checkson check in a GitOps / Infrastructure-as-Code manner. This definition includes any secrets that your check requires. This means that everything about the check - both the logic that is executed and the meta data - is stored in a single GitHub repository. When you want to modify the logic or the meta-data, all you need to do is to update the repository.

The check is executed on Checkson's cloud infrastructure. The Docker image is pulled and a container is created.

# Anatomoy of a check repo on GitHub

• .github/workflows/docker-publish.yml
• .github/workflows/checkson.yml
• Dockerfile
• Check logic: Python, Typescript, Bash, Java, C#, ...