Ansible role for GitHub webhook handler https://docs.github.com/en/webhooks/about-webhooks
Go to file
Jakub Sokołowski 1107b1ac45
service: add missing host flag, fix var name
Signed-off-by: Jakub Sokołowski <jakub@status.im>
2024-08-29 14:10:29 +02:00
defaults service: add missing host flag, fix var name 2024-08-29 14:10:29 +02:00
files user: add SSH config that acceps github.com key 2024-08-09 09:01:33 +02:00
meta meta: use full names of Ansible roles 2024-03-11 15:50:42 +01:00
tasks consul: allow overwriting tags and metadata 2024-08-29 13:45:12 +02:00
templates service: add missing host flag, fix var name 2024-08-29 14:10:29 +02:00
README.md readme: update config examples and explain options 2023-09-27 10:10:44 +02:00

README.md

Description

This is a helper role that deploy a python server for github webhook

Configuration

Required configuration:

github_webhook_dest_path: '/opt/repo'
github_webhook_secret: 'super-secret-webhook-secret'
github_webhook_repo_url: 'https://github.com/example-org/example-repo'
github_webhook_repo_branch: 'master'

Additionally these options can be useful:

github_webhook_ssh_key: '-----BEGIN OPENSSH PRIVATE KEY-----\n...'
github_webhook_service_user: 'repouser'
github_webhook_user_additional_groups: ['docker']
github_webhook_service_user_uid: 1500

Explanations:

  • github_webhook_dest_path - Absolute path for repository location.
  • github_webhook_secret - Used to configure the webhook in GitHub repository.
  • github_webhook_ssh_key - Optional private SSH key to checkout private repositories.
  • github_webhook_service_user - Define user to own the repo and run the service.
  • github_wehbook_service_user_groups - Modify list of groups of service user.
  • github_webhook_service_user_uid - Change UID of service user to match repo user.