pescobar.dehydrated

ansible-role-dehydrated

安装 dehydrated letsencrypt/acme 客户端

角色变量

dehydrated_config_dir: "/etc/dehydrated"

dehydrated_wellknown_dir: "/var/www/dehydrated/"

dehydrated_certs_dir: "{{ dehydrated_config_dir }}/certs"

dehydrated_version: "master"

dehydrated_install_dir: "/usr/local/bin"

dehydrated_contact_email: "[email protected]"

dehydrated_domains:
  - "{{ ansible_fqdn }}"

dehydrated_hook_script_path: "{{ dehydrated_config_dir }}/hook.sh"

# 这是在部署新证书时执行的命令
# 此命令在 dehydrated 钩子脚本的 deploy_cert() 函数中定义
dehydrated_hook_deploy_cert_cmd: |
  systemctl reload httpd

示例剧本（使用 geerlingguy.apache）

- name: 配置带 SSL 的网络服务器
  hosts: webserver
  gather_facts: True
  remote_user: root

  vars:

    dehydrated_contact_email: "[email protected]"

    vhost_public_domain: mycoolweb.com

    apache_global_vhost_settings: |
      DirectoryIndex index.php index.html
      Alias /.well-known/acme-challenge/ {{ dehydrated_wellknown_dir }}
      <Directory {{ dehydrated_wellknown_dir }}>
          Require all granted
      </Directory>

    apache_vhosts:
      - servername: "{{ vhost_public_domain }}"
        serveralias: "www.{{ vhost_public_domain }}"
        serveradmin: "{{ dehydrated_contact_email }}"
        documentroot: "/var/www/{{ vhost_public_domain }}"
        extra_parameters: |

          # 将所有流量重定向到 https，除了 letsencrypt 的请求
          RewriteEngine On
          RewriteCond %{HTTPS} off
          RewriteCond %{REQUEST_URI} !^/.well-known/
          RewriteRule ^(.*)$ https://%{HTTP_HOST}%{REQUEST_URI} [R,L]

    apache_vhosts_ssl:
      - servername: "{{ vhost_public_domain }}"
        serveralias: "www.{{ vhost_public_domain }}"
        serveradmin: "{{ dehydrated_contact_email }}"
        documentroot: "/var/www/{{ vhost_public_domain }}"
        certificate_file: "{{ dehydrated_certs_dir }}/{{ vhost_public_domain }}/cert.pem"
        certificate_key_file: "{{ dehydrated_certs_dir }}/{{ vhost_public_domain }}/privkey.pem"
        certificate_chain_file: "{{ dehydrated_certs_dir }}/{{ vhost_public_domain }}/fullchain.pem"

    # 此变量由角色 "geerlingguy.apache" 所需，只有在 ssl 证书存在时才配置 ssl vhosts。
    apache_ignore_missing_ssl_certificate: false

  tasks:

    - name: 安装并配置 apache 网络服务器（暂不启用 ssl）
      import_role:
        name: geerlingguy.apache

    - name: 安装 dehydrated letsencrypt/acme 客户端
      import_role:
        name: ansible-role-dehydrated

    # 执行处理程序，以便 apache 启用 .well-known 文件夹，并且
    # dehydrated 请求 ssl 证书
    - meta: flush_handlers

    - name: 再次安装并配置 apache 网络服务器（配置 ssl vhosts）
      import_role:
        name: geerlingguy.apache