buluma.ca

Descripción general Versiones Perspectivas

Rol de Ansible ca

Instala y configura una autoridad de certificación en tu sistema.

GitHub	Versión	Issues	Pull Requests	Descargas

Ejemplo de Playbook

Este ejemplo se toma de molecule/default/converge.yml y se prueba en cada push, pull request y lanzamiento.

---
- name: Converger
  hosts: all
  become: true
  gather_facts: true

  roles:
    - role: buluma.ca

La máquina necesita ser preparada. En CI esto se hace usando molecule/default/prepare.yml:

---
- name: Preparar
  hosts: all
  become: true
  gather_facts: false

  roles:
    - role: buluma.bootstrap
    - role: buluma.buildtools
    - role: buluma.epel
    - role: buluma.python_pip
    - role: buluma.openssl
      openssl_items:
        - name: apache-httpd
          common_name: "{{ ansible_fqdn }}"
    - role: buluma.httpd

También puedes consultar una explicación completa y un ejemplo sobre cómo utilizar estos roles.

Variables del Rol

Los valores por defecto para las variables se establecen en defaults/main.yml:

---
# archivo de valores por defecto para ca

# establece ca_init: 'yes' para crear CA
ca_init: true

# ca_own_root: 'yes' si deseas tener tu propia CA raíz.
# si no, establece ca_certificate_path manualmente
ca_own_root: true

# Una frase de contraseña para la clave CA.
ca_passphrase: SuP3rS3cr3T

# El nombre común para la CA.
ca_common_name: example.com

# Otros detalles para la CA.
ca_country_name: KE
ca_email_address: [email protected]
ca_organization_name: Muy poco
ca_organizational_unit_name: Aún menos
ca_state_or_province_name: Nairobi
ca_locality_name: Nairobi

# Hay dos formatos para solicitar una clave y un certificado:
# 1. Con detalles: (Incluye `name:`)
# ca_requests:
#   - name: certificate1.example.com
#     passphrase: S3creT
#
# 2. Sin detalles: (No incluye `name:`)
# ca_requests:
#   - "{{ ansible_fqdn }}"

# También puedes mezclar estos formatos:
# ca_requests:
#   - name: certificate1.example.com
#     passphrase: S3creT
#   - "{{ ansible_fqdn }}"

# Dónde publicar los certificados, normalmente en la ubicación de un servidor web.
# Si no se especifica, los certificados no se publicarán.
# {{ httpd_data_directory }} se hereda del rol buluma.httpd.
ca_publication_location: "{{ httpd_data_directory | default('/tmp') }}/pub"

# ¿Dónde se deben almacenar los certificados? Por defecto se utilizan las ubicaciones
# preferidas de la distribución (ver `vars/main.yml`, bajo `_ca_openssl_path`.
# Si necesitas un certificado CA en otro lugar, simplemente usa algo como esto:
# ca_openssl_path: /mi/ruta/preferida
ca_openssl_path: "{{ _ca_openssl_path[ansible_os_family] | default(_ca_openssl_path['default']) }}"