mash-playbook/docs/services/semaphore.md
2023-12-06 16:00:48 +01:00

1.8 KiB

Semaphore

Semaphore is a responsive web UI for running Ansible playbooks. Installing it is powered by the mother-of-all-self-hosting/ansible-role-semaphore Ansible role.

Dependencies

This service requires the following other services:

Configuration

To enable this service, add the following configuration to your vars.yml file and re-run the installation process:

########################################################################
#                                                                      #
# semaphore                                                            #
#                                                                      #
########################################################################

semaphore_enabled: true
semaphore_hostname: semaphore.example.com
semaphore_admin_password: STRONG_PASSWORD
semaphore_admin_name: USERNAME
semaphore_admin_email: user@example.org
# Key for encrypting access keys in database.
# It must be generated by using the following command: head -c32 /dev/urandom | base64
semaphore_access_key_encryption: "PJOfV/7Q+ZDUxo2bgW8dgVbGJ6nNIJgEOyB3hcnVVz4="

########################################################################
#                                                                      #
# /semaphore                                                           #
#                                                                      #
########################################################################

Usage

After installing, you can log into you admin account by visiting the URL specified in semaphore_hostname.