thedumbtechguy.semaphore

Descripción general Versiones Perspectivas

Rol de Ansible: Semaphore

Un rol de ansible para instalar y configurar Ansible Semaphore

Este rol contiene un script de shell para preparar ansible y semaphore. Maneja la configuración y la instalación de todas las dependencias necesarias.

Requisitos

wget: Necesario para descargar bootstrap.sh.
thedumbtechguy.configure-ansible: Necesario para configurar ansible. Se instalará si no está disponible.
thedumbtechguy.logrotate: Necesario para configurar logrotate. Se instalará si no está disponible.
thedumbtechguy.mariadb: Necesario para configurar mariadb. Se instalará si no está disponible.

Este rol ha sido probado solo en Ubuntu 16.04 y Ubuntu 16.10.

Instalación Inicial

Si este es un nuevo servidor, querrás configurar primero el nombre del host (hostname server.domain.tld).

Copia y ejecuta el siguiente comando

sudo apt-get install -y wget &&
  mkdir /tmp/bootstrap &&
  cd /tmp/bootstrap &&
  wget https://raw.githubusercontent.com/thedumbtechguy/ansible-semaphore-bootstrap/master/bootstrap.sh &&
  sudo sh bootstrap.sh init

Luego puedes personalizar la configuración en vars.json y ejecutar sudo sh bootstrap.sh execute.

Variables

semaphore_version: versión a instalar.
- Predeterminado: 2.3.0
- Opciones:
  - 2.2.0
  - 2.3.0
semaphore_port: puerto a escuchar.
- Predeterminado: 3000
semaphore_db_name: el nombre de la base de datos que se creará para semaphore.
- Predeterminado: semaphore
semaphore_db_auth_user: el nombre del usuario de la base de datos de la aplicación.
- Predeterminado: semaphore
semaphore_db_auth_password: la contraseña del usuario de la base de datos de la aplicación.
- Requerido
semaphore_db_auth_privileges: los privilegios a otorgar al usuario de la base de datos de la aplicación.
- Predeterminado: *.*:ALL
semaphore_config_auth_name: el nombre del usuario de la aplicación semaphore por defecto.
- Predeterminado: Admin
semaphore_config_auth_email: el correo electrónico del usuario de la aplicación semaphore por defecto.
- Predeterminado: root
semaphore_config_auth_username: el usuario del usuario de la aplicación semaphore por defecto.
- Predeterminado: admin
semaphore_config_auth_password: la contraseña del usuario de la aplicación semaphore por defecto.
- Requerido
semaphore_config_data_dir: donde almacenar la configuración de semaphore y los archivos de playbook.
- Predeterminado: /var/lib/semaphore
semaphore_config_log_path: donde almacenar los archivos de registro.
- Predeterminado: /var/log/semaphore
semaphore_config_email_alerts_enable: habilitar alertas por correo electrónico.
- Predeterminado: no
semaphore_config_email_alerts_server: servidor smtp.
- Predeterminado: localhost
semaphore_config_email_alerts_port: puerto smtp.
- Predeterminado: 25
semaphore_config_email_alerts_sender: dirección de correo del remitente de las alertas.
- Predeterminado: semaphore@localhost
semaphore_config_web_root: la raíz web que usarías para acceder a la aplicación. se utiliza para generar URLs en las alertas.
- Predeterminado: http://{{ ansible_fqdn }}:{{ semaphore_port }}/
semaphore_config_telegram_alerts_enable: habilitar alertas de telegram.
- Predeterminado: no
semaphore_config_telegram_alerts_bot_token: obtener de @BotFather.
- Predeterminado: ''
semaphore_config_telegram_alerts_chat_id: tu id de chat de telegram.
- Predeterminado: ''
semaphore_config_ldap_enable: habilitar autenticación ldap.
- Predeterminado: no
semaphore_config_ldap_server: servidor ldap.
- Predeterminado: localhost
semaphore_config_ldap_port: puerto ldap.
- Predeterminado: 389
semaphore_config_ldap_use_tls: usar tls al conectarse al servidor ldap.
- Predeterminado: no
semaphore_config_ldap_bind_dn: bind dn.
- Predeterminado: cn=user,ou=users,dc=example.tld
semaphore_config_ldap_bind_password: .
- Predeterminado: pa55w0rd
semaphore_config_ldap_search_dn: search dn.
- Predeterminado: ou=users,dc=example.tld
semaphore_config_ldap_search_filter: filtro de búsqueda.
- Predeterminado: (uid=%s)
semaphore_config_ldap_mapping_dn_field: mapeo al campo dn.
- Predeterminado: dn
semaphore_config_ldap_mapping_username_field: mapeo al campo de nombre de usuario.
- Predeterminado: uid
semaphore_config_ldap_mapping_fullname_field: mapeo al campo de nombre completo.
- Predeterminado: cn
semaphore_config_ldap_mapping_email_field: mapeo al campo de correo electrónico.
- Predeterminado: mail
semaphore_service_user_name: cuenta que ejecutará el servicio de la aplicación. no ejecutar como root.
- Predeterminado: semaphore
  
  NOTA: si el usuario no existe, se creará una cuenta de servicio.
semaphore_service_user_password: contraseña de la cuenta que ejecutará el servicio.
- Requerido
  
  NOTA: no proporcionar esto permitirá otorgar sudo sin contraseña a la cuenta.
  
  se necesita una contraseña para ejecutar playbooks locales desde semaphore a través de become_password.
  
  La contraseña debe ser un valor encriptado compatible con el módulo de usuario de ansible.
  
  Puedes crear una usando: python -c 'import crypt; print crypt.crypt("Esta es la contraseña", "$1$ThisIsSomeSalt$")'

Inicialización

Estas variables son relevantes solo para el proceso de inicialización y se pueden modificar en el archivo vars.json generado.

semaphore_db_admin_home: directorio para almacenar .my.cnf para mariadb.
- Predeterminado: /root
semaphore_db_admin_user: nombre de usuario del administrador de la base de datos.
- Predeterminado: admin
semaphore_db_admin_password: contraseña del administrador de la base de datos.
- Requerido
semaphore_ansible_cfg_vault_password: contraseña del vault.
- Predeterminado: ''
semaphore_ansible_cfg_vault_password_file: ubicación del archivo de contraseña del vault.
- Predeterminado: /var/lib/semaphore/.vpf
semaphore_ansible_cfg_host_key_checking: habilitar la verificación de claves del host.
- Predeterminado: False
- Opciones:
  - True
  - False
semaphore_ansible_cfg_ansible_managed: cadena administrada por ansible para archivos gestionados. utilizada por algunos roles.
- Predeterminado: NO MODIFICAR a mano. Este archivo está bajo control de Ansible en {host}.

Ejemplo de Uso

- hosts: all
  vars:
    semaphore_config_auth_email: '[email protected]'
    semaphore_config_auth_password: '4dm1nPa55w0rd'
    semaphore_service_user_password: '$1$ThisIsSo$RwIOJHdSWIzAJjbvBdbOZ0'
    semaphore_ansible_cfg_vault_password: 'pa55w0rd'
  roles:
    - thedumbtechguy.semaphore