2022-01-03 20:22:42 +00:00
# A bridge between Matrix and multiple project management services, such as GitHub, GitLab and JIRA.
# https://github.com/Half-Shot/matrix-hookshot
matrix_hookshot_enabled : true
matrix_hookshot_version : 1.0 .0
matrix_hookshot_docker_image : "{{ matrix_container_global_registry_prefix }}halfshot/hookshot:{{ matrix_hookshot_version }}"
matrix_hookshot_docker_image_force_pull : "{{ matrix_hookshot_docker_image.endswith(':latest') }}"
matrix_hookshot_base_path : "{{ matrix_base_data_path }}/hookshot"
matrix_hookshot_homeserver_address : "{{ matrix_homeserver_container_url }}"
2022-01-08 15:51:52 +00:00
matrix_hookshot_container_url : 'matrix-hookshot'
2022-01-03 20:22:42 +00:00
matrix_hookshot_public_endpoint : /hookshot
2022-01-06 17:55:36 +00:00
# there is no need to edit ports. use matrix_hookshot_container_http_host_bind_ports below to expose ports instead.
matrix_hookshot_appservice_port : 9993
matrix_hookshot_appservice_endpoint : "{{ matrix_hookshot_public_endpoint }}/_matrix/app"
2022-01-03 20:22:42 +00:00
# metrics work only in conjunction with matrix_synapse_metrics_enabled etc
matrix_hookshot_metrics_enabled : true
2022-01-06 17:55:36 +00:00
# there is no need to edit ports. use matrix_hookshot_container_http_host_bind_ports below to expose ports instead.
2022-01-03 20:22:42 +00:00
matrix_hookshot_metrics_port : 9001
2022-01-06 17:55:36 +00:00
matrix_hookshot_metrics_endpoint : "{{ matrix_hookshot_public_endpoint }}/metrics"
2022-01-03 20:22:42 +00:00
2022-01-06 17:55:36 +00:00
# there is no need to edit ports. use matrix_hookshot_container_http_host_bind_ports below to expose ports instead.
2022-01-03 20:22:42 +00:00
matrix_hookshot_webhook_port : 9000
2022-01-06 17:55:36 +00:00
matrix_hookshot_webhook_endpoint : "{{ matrix_hookshot_public_endpoint }}/webhooks"
2022-01-03 20:22:42 +00:00
# you need to create a GitHub app to enable this
# https://half-shot.github.io/matrix-hookshot/setup/github.html
2022-01-06 17:55:36 +00:00
matrix_hookshot_github_enabled : false
matrix_hookshot_github_appid : ''
2022-01-03 20:22:42 +00:00
matrix_hookshot_github_private_key : ''
matrix_hookshot_github_secret : '' # "Webhook secret" on the GitHub App page
2022-01-06 17:55:36 +00:00
matrix_hookshot_github_oauth_enabled : false
2022-01-03 20:22:42 +00:00
matrix_hookshot_github_oauth_id : '' # "Client ID" on the GitHub App page
matrix_hookshot_github_oauth_secret : '' # "Client Secret" on the GitHub App page
2022-01-06 17:55:36 +00:00
matrix_hookshot_github_oauth_endpoint : "{{ matrix_hookshot_webhook_endpoint }}/oauth"
2022-01-03 20:22:42 +00:00
matrix_hookshot_github_oauth_uri : "{{ matrix_server_fqn_matrix }}{{ matrix_hookshot_github_oauth_endpoint }}"
2022-01-06 17:55:36 +00:00
matrix_hookshot_github_ignore_hooks : "{}"
2022-01-03 20:22:42 +00:00
matrix_hookshot_github_command_prefix : '!gh'
matrix_hookshot_github_show_issue_room_link : false
2022-01-06 17:55:36 +00:00
matrix_hookshot_github_pr_diff : "{enabled: false, maxLines: 5}"
2022-01-03 20:22:42 +00:00
matrix_hookshot_github_including_labels : ''
matrix_hookshot_github_excluding_labels : ''
matrix_hookshot_gitlab_enabled : true
matrix_hookshot_gitlab_instances :
gitlab.com :
url : https://gitlab.com
matrix_hookshot_gitlab_secret : ''
2022-01-06 17:55:36 +00:00
matrix_hookshot_jira_enabled : false
2022-01-03 20:22:42 +00:00
matrix_hookshot_jira_secret : ''
matrix_hookshot_jira_oauth_id : ''
matrix_hookshot_jira_oauth_secret : ''
2022-01-06 17:55:36 +00:00
matrix_hookshot_jira_oauth_endpoint : "{{ matrix_hookshot_webhook_endpoint }}/jira/oauth"
2022-01-03 20:22:42 +00:00
matrix_hookshot_jira_oauth_uri : "{{ matrix_server_fqn_matrix }}{{ matrix_hookshot_jira_oauth_endpoint }}"
matrix_hookshot_generic_enabled : true
2022-01-06 17:55:36 +00:00
matrix_hookshot_generic_endpoint : "{{ matrix_hookshot_webhook_endpoint }}"
matrix_hookshot_generic_urlprefix : "{{ matrix_server_fqn_matrix }}{{ matrix_hookshot_generic_endpoint }}"
2022-01-03 20:22:42 +00:00
matrix_hookshot_generic_allow_js_transformation_functions : false
matrix_hookshot_generic_user_id_prefix : 'webhooks_'
2022-01-06 17:55:36 +00:00
matrix_hookshot_figma_enabled : false
matrix_hookshot_figma_endpoint : "{{ matrix_hookshot_webhook_endpoint }}/figma/webhook"
matrix_hookshot_figma_publicUrl : "{{ matrix_server_fqn_matrix }}{{ matrix_hookshot_figma_endpoint }}"
# to bridge figma webhooks, you need to configure one of multiple instances like this:
# matrix_hookshot_figma_instances:
# your-instance:
# teamId: your-team-id
# accessToken: your-personal-access-token
# passcode: your-webhook-passcode
matrix_hookshot_provisioning_enabled : true
# there is no need to edit ports. use matrix_hookshot_container_http_host_bind_ports below to expose ports instead.
matrix_hookshot_provisioning_port : 9002
2022-01-03 20:22:42 +00:00
matrix_hookshot_provisioning_secret : ''
2022-01-06 17:55:36 +00:00
matrix_hookshot_provisioning_endpoint : "{{ matrix_hookshot_public_endpoint }}/v1"
matrix_hookshot_bot_displayname : Hookshot Bot
matrix_hookshot_bot_avatar : 'mxc://half-shot.uk/2876e89ccade4cb615e210c458e2a7a6883fe17d'
2022-01-03 20:22:42 +00:00
# A list of extra arguments to pass to the container
matrix_hookshot_container_extra_arguments : [ ]
# List of systemd services that service depends on.
matrix_hookshot_systemd_required_services_list : [ 'docker.service' ]
# List of systemd services that service wants
matrix_hookshot_systemd_wanted_services_list : [ ]
2022-01-06 17:55:36 +00:00
# List of ports to bind to the host to expose them directly.
# Ports will automatically be bound to localhost if matrix_nginx_proxy_enabled is false.
# Setting this variable will override that behaviour in either case.
# Supply docker port bind arguments in a list like this:
#
# matrix_hookshot_container_http_host_bind_ports:
# - "127.0.0.1:9999:{{ matrix_hookshot_metrics_port }}"
#
# Above example will bind the metrics port in the container to port 9999 on localhost.
matrix_hookshot_container_http_host_bind_ports : [ ]
2022-01-03 20:22:42 +00:00
matrix_hookshot_appservice_token : ''
matrix_hookshot_homeserver_token : ''
# Default configuration template which covers the generic use case.
# You can customize it by controlling the various variables inside it.
#
# For a more advanced customization, you can extend the default (see `matrixhookshot_configuration_extension_yaml`)
# or completely replace this variable with your own template.
matrix_hookshot_configuration_yaml : "{{ lookup('template', 'templates/config.yml.j2') }}"
matrix_hookshot_configuration_extension_yaml : |
# Your custom YAML configuration goes here.
# This configuration extends the default starting configuration (`matrix_hookshot_configuration_yaml`).
#
# You can override individual variables from the default configuration, or introduce new ones.
#
# If you need something more special, you can take full control by
# completely redefining `matrix_hookshot_configuration_yaml`.
matrix_hookshot_configuration_extension : "{{ matrix_hookshot_configuration_extension_yaml|from_yaml if matrix_hookshot_configuration_extension_yaml|from_yaml is mapping else {} }}"
# Holds the final configuration (a combination of the default and its extension).
# You most likely don't need to touch this variable. Instead, see `matrix_hookshot_configuration_yaml`.
matrix_hookshot_configuration : "{{ matrix_hookshot_configuration_yaml|from_yaml|combine(matrix_hookshot_configuration_extension, recursive=True) }}"
# Default registration template which covers the generic use case.
# You can customize it by controlling the various variables inside it.
#
# For a more advanced customization, you can extend the default (see `matrixhookshot_registration_extension_yaml`)
# or completely replace this variable with your own template.
matrix_hookshot_registration_yaml : "{{ lookup('template', 'templates/registration.yml.j2') }}"
matrix_hookshot_registration_extension_yaml : |
# Your custom YAML registration goes here.
# This registration extends the default starting registration (`matrix_hookshot_registration_yaml`).
#
# You can override individual variables from the default registration, or introduce new ones.
#
# If you need something more special, you can take full control by
# completely redefining `matrix_hookshot_registration_yaml`.
matrix_hookshot_registration_extension : "{{ matrix_hookshot_registration_extension_yaml|from_yaml if matrix_hookshot_registration_extension_yaml|from_yaml is mapping else {} }}"
# Holds the final registration (a combination of the default and its extension).
# You most likely don't need to touch this variable. Instead, see `matrix_hookshot_registration_yaml`.
matrix_hookshot_registration : "{{ matrix_hookshot_registration_yaml|from_yaml|combine(matrix_hookshot_registration_extension, recursive=True) }}"