32 changed files with 1207 additions and 230 deletions
--- a/.drone.jsonnet
+++ b/.drone.jsonnet
@ -0,0 +1,161 @@
+local PipelineLinting = {
+  kind: 'pipeline',
+  name: 'linting',
+  platform: {
+    os: 'linux',
+    arch: 'amd64',
+  },
+  steps: [
+    {
+      name: 'ansible-later',
+      image: 'thegeeklab/ansible-later',
+      commands: [
+        'ansible-later',
+      ],
+    },
+    {
+      name: 'python-format',
+      image: 'python:3.11',
+      environment: {
+        PY_COLORS: 1,
+      },
+      commands: [
+        'pip install -qq yapf',
+        '[ -z "$(find . -type f -name *.py)" ] || (yapf -rd ./)',
+      ],
+    },
+    {
+      name: 'python-flake8',
+      image: 'python:3.11',
+      environment: {
+        PY_COLORS: 1,
+      },
+      commands: [
+        'pip install -qq flake8',
+        'flake8',
+      ],
+    },
+  ],
+  trigger: {
+    ref: ['refs/heads/main', 'refs/tags/**', 'refs/pull/**'],
+  },
+};
+
+local PipelineDeployment(scenario='centos7') = {
+  kind: 'pipeline',
+  name: 'testing-' + scenario,
+  platform: {
+    os: 'linux',
+    arch: 'amd64',
+  },
+  concurrency: {
+    limit: 1,
+  },
+  workspace: {
+    base: '/drone/src',
+    path: '${DRONE_REPO_NAME}',
+  },
+  steps: [
+    {
+      name: 'ansible-molecule',
+      image: 'thegeeklab/molecule:4',
+      environment: {
+        HCLOUD_TOKEN: { from_secret: 'hcloud_token' },
+      },
+      commands: [
+        'molecule test -s ' + scenario,
+      ],
+    },
+  ],
+  depends_on: [
+    'linting',
+  ],
+  trigger: {
+    ref: ['refs/heads/main', 'refs/tags/**', 'refs/pull/**'],
+  },
+};
+
+local PipelineDocumentation = {
+  kind: 'pipeline',
+  name: 'documentation',
+  platform: {
+    os: 'linux',
+    arch: 'amd64',
+  },
+  steps: [
+    {
+      name: 'generate',
+      image: 'thegeeklab/ansible-doctor',
+      environment: {
+        ANSIBLE_DOCTOR_LOG_LEVEL: 'INFO',
+        ANSIBLE_DOCTOR_FORCE_OVERWRITE: true,
+        ANSIBLE_DOCTOR_EXCLUDE_FILES: 'molecule/',
+        ANSIBLE_DOCTOR_TEMPLATE: 'hugo-book',
+        ANSIBLE_DOCTOR_ROLE_NAME: '${DRONE_REPO_NAME#*.}',
+        ANSIBLE_DOCTOR_OUTPUT_DIR: '_docs/',
+      },
+    },
+    {
+      name: 'publish',
+      image: 'plugins/gh-pages',
+      settings: {
+        remote_url: 'https://gitea.rknet.org/ansible/${DRONE_REPO_NAME}',
+        netrc_machine: 'gitea.rknet.org',
+        username: { from_secret: 'gitea_username' },
+        password: { from_secret: 'gitea_token' },
+        pages_directory: '_docs/',
+        target_branch: 'docs',
+      },
+      when: {
+        ref: ['refs/heads/main'],
+      },
+    },
+  ],
+  trigger: {
+    ref: ['refs/heads/main', 'refs/tags/**', 'refs/pull/**'],
+  },
+  depends_on: [
+    'testing-centos7',
+    'testing-rocky8',
+  ],
+};
+
+local PipelineNotification = {
+  kind: 'pipeline',
+  name: 'notification',
+  platform: {
+    os: 'linux',
+    arch: 'amd64',
+  },
+  clone: {
+    disable: true,
+  },
+  steps: [
+    {
+      name: 'matrix',
+      image: 'thegeeklab/drone-matrix',
+      settings: {
+        homeserver: { from_secret: 'matrix_homeserver' },
+        roomid: { from_secret: 'matrix_roomid' },
+        template: 'Status: **{{ .Build.Status }}**<br/> Build: [{{ .Repo.Owner }}/{{ .Repo.Name }}]({{ .Build.Link }}){{ if .Build.Branch }} ({{ .Build.Branch }}){{ end }} by {{ .Commit.Author }}<br/> Message: {{ .Commit.Message.Title }}',
+        username: { from_secret: 'matrix_username' },
+        password: { from_secret: 'matrix_password' },
+      },
+    },
+  ],
+  depends_on: [
+    'documentation',
+  ],
+  trigger: {
+    status: ['success', 'failure'],
+    ref: ['refs/heads/main', 'refs/tags/**'],
+  },
+};
+
+[
+  PipelineLinting,
+  PipelineDeployment(scenario='centos7'),
+  PipelineDeployment(scenario='rocky8'),
+  PipelineDocumentation,
+  PipelineNotification,
+]
--- a/.drone.yml
+++ b/.drone.yml
@ -0,0 +1,187 @@
+---
+kind: pipeline
+name: linting
+
+platform:
+  os: linux
+  arch: amd64
+
+steps:
+  - name: ansible-later
+    image: thegeeklab/ansible-later
+    commands:
+      - ansible-later
+
+  - name: python-format
+    image: python:3.11
+    commands:
+      - pip install -qq yapf
+      - "[ -z \"$(find . -type f -name *.py)\" ] || (yapf -rd ./)"
+    environment:
+      PY_COLORS: 1
+
+  - name: python-flake8
+    image: python:3.11
+    commands:
+      - pip install -qq flake8
+      - flake8
+    environment:
+      PY_COLORS: 1
+
+trigger:
+  ref:
+    - refs/heads/main
+    - refs/tags/**
+    - refs/pull/**
+
+---
+kind: pipeline
+name: testing-centos7
+
+platform:
+  os: linux
+  arch: amd64
+
+concurrency:
+  limit: 1
+
+workspace:
+  base: /drone/src
+  path: ${DRONE_REPO_NAME}
+
+steps:
+  - name: ansible-molecule
+    image: thegeeklab/molecule:4
+    commands:
+      - molecule test -s centos7
+    environment:
+      HCLOUD_TOKEN:
+        from_secret: hcloud_token
+
+trigger:
+  ref:
+    - refs/heads/main
+    - refs/tags/**
+    - refs/pull/**
+
+depends_on:
+  - linting
+
+---
+kind: pipeline
+name: testing-rocky8
+
+platform:
+  os: linux
+  arch: amd64
+
+concurrency:
+  limit: 1
+
+workspace:
+  base: /drone/src
+  path: ${DRONE_REPO_NAME}
+
+steps:
+  - name: ansible-molecule
+    image: thegeeklab/molecule:4
+    commands:
+      - molecule test -s rocky8
+    environment:
+      HCLOUD_TOKEN:
+        from_secret: hcloud_token
+
+trigger:
+  ref:
+    - refs/heads/main
+    - refs/tags/**
+    - refs/pull/**
+
+depends_on:
+  - linting
+
+---
+kind: pipeline
+name: documentation
+
+platform:
+  os: linux
+  arch: amd64
+
+steps:
+  - name: generate
+    image: thegeeklab/ansible-doctor
+    environment:
+      ANSIBLE_DOCTOR_EXCLUDE_FILES: molecule/
+      ANSIBLE_DOCTOR_FORCE_OVERWRITE: true
+      ANSIBLE_DOCTOR_LOG_LEVEL: INFO
+      ANSIBLE_DOCTOR_OUTPUT_DIR: _docs/
+      ANSIBLE_DOCTOR_ROLE_NAME: ${DRONE_REPO_NAME#*.}
+      ANSIBLE_DOCTOR_TEMPLATE: hugo-book
+
+  - name: publish
+    image: plugins/gh-pages
+    settings:
+      netrc_machine: gitea.rknet.org
+      pages_directory: _docs/
+      password:
+        from_secret: gitea_token
+      remote_url: https://gitea.rknet.org/ansible/${DRONE_REPO_NAME}
+      target_branch: docs
+      username:
+        from_secret: gitea_username
+    when:
+      ref:
+        - refs/heads/main
+
+trigger:
+  ref:
+    - refs/heads/main
+    - refs/tags/**
+    - refs/pull/**
+
+depends_on:
+  - testing-centos7
+  - testing-rocky8
+
+---
+kind: pipeline
+name: notification
+
+platform:
+  os: linux
+  arch: amd64
+
+clone:
+  disable: true
+
+steps:
+  - name: matrix
+    image: thegeeklab/drone-matrix
+    settings:
+      homeserver:
+        from_secret: matrix_homeserver
+      password:
+        from_secret: matrix_password
+      roomid:
+        from_secret: matrix_roomid
+      template: "Status: **{{ .Build.Status }}**<br/> Build: [{{ .Repo.Owner }}/{{ .Repo.Name }}]({{ .Build.Link }}){{ if .Build.Branch }} ({{ .Build.Branch }}){{ end }} by {{ .Commit.Author }}<br/> Message: {{ .Commit.Message.Title }}"
+      username:
+        from_secret: matrix_username
+
+trigger:
+  ref:
+    - refs/heads/main
+    - refs/tags/**
+  status:
+    - success
+    - failure
+
+depends_on:
+  - documentation
+
+---
+kind: signature
+hmac: 6048ef83a64bc78c4f6c2cb20f3a5fabe27eef22e1195f8288c8376372dd9c0a
+
+...
--- a/.gitignore
+++ b/.gitignore
@ -0,0 +1,13 @@
+# ---> Ansible
+*.retry
+filter/plugins/
+library
+
+# ---> Python
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# ---> Docs
+/_docs
--- a/.later.yml
+++ b/.later.yml
@ -0,0 +1,19 @@
+---
+ansible:
+  custom_modules:
+    - iptables_raw
+    - openssl_pkcs12
+    - proxmox_kvm
+    - ucr
+    - corenetworks_dns
+    - corenetworks_token
+
+rules:
+  exclude_files:
+    - molecule/
+    - "LICENSE*"
+    - "**/*.md"
+    - "**/*.ini"
+
+  exclude_filter:
+    - LINT0009
--- a/21
+++ b/21
@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022 Robert Kaussow <mail@thegeeklab.de>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is furnished
+to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice (including the next
+paragraph) shall be included in all copies or substantial portions of the
+Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS
+OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF
+OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
--- a/README.md
+++ b/README.md
@ -0,0 +1,12 @@
+# xoxys.certbot
+
+[![Build Status](https://img.shields.io/drone/build/ansible/xoxys.certbot?logo=drone&server=https%3A%2F%2Fdrone.rknet.org)](https://drone.rknet.org/ansible/xoxys.certbot)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+Setup [certbot](https://certbot.eff.org/) Let's Encrypt client.
+
+You can find the full documentation at [https://galaxy.geekdocs.de](https://galaxy.geekdocs.de/roles/security/certbot/).
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
--- a/defaults/main.yml
+++ b/defaults/main.yml
@ -0,0 +1,51 @@
+---
+# @var certbot_version:description: Set a fix version of the certbot package to install.
+# @var certbot_version: $ "_unset_"
+
+# @var certbot_packages_extra:description: Extra packages to install with pip (e.g. DNS plugins).
+certbot_packages_extra: []
+
+certbot_virtualenv_command: /usr/bin/python3 -m venv
+certbot_virtualenv: /opt/python3/certbot
+
+certbot_user: root
+
+certbot_work_dir: /var/lib/letsencrypt
+certbot_config_dir: /etc/letsencrypt
+certbot_log_dir: /var/log/letsencrypt
+
+certbot_max_log_backups: 30
+
+certbot_preferred_challenges: dns
+certbot_server: https://acme-v02.api.letsencrypt.org/directory
+certbot_email: mail@example.com
+certbot_rsa_key_size: 4096
+certbot_domain_groups:
+  - name: example
+    domains:
+      - "*.example.com"
+      - example.com
+    init: False
+
+# @var certbot_credentials:description: >
+# Specify key value parairs for your credentials (e.g. plugin credentials).
+# The credentials will be saved to `{{ certbot_config_dir }}/credentials.ini and you
+# could add the path to `certbot_command_arguments` if required.
+# @end
+certbot_credentials: []
+
+# @var certbot_bin:description: Location of the certbot binary. Default is to `~/.local/.bin/certbot`.
+certbot_command_arguments:
+  - "certonly"
+
+# @var certbot_cron_enabled:description: Enable scheduling via cron.
+certbot_cron_enabled: True
+
+# @var certbot_cron_file:description: >
+# Use a file under /etc/cron.d but this will only work if `certbot_user` has write permissions for this location.
+# @end
+# @var certbot_cron_file: $ "_unset_"
+# @var certbot_cron_file:example: certbot-letsencrypt
+
+certbot_cron_minute: "30"
+certbot_cron_hour: "3"
--- a/index.md
+++ b/index.md
@ -1,230 +0,0 @@
---
-title: certbot
-type: docs
---
-
-[![Source Code](https://img.shields.io/badge/gitea-source%20code-blue?logo=gitea&logoColor=white)](https://gitea.rknet.org/ansible/xoxys.certbot) [![Build Status](https://img.shields.io/drone/build/ansible/xoxys.certbot?logo=drone&server=https%3A%2F%2Fdrone.rknet.org)](https://drone.rknet.org/ansible/xoxys.certbot) [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://gitea.rknet.org/ansible/xoxys.certbot/src/branch/main/LICENSE)
-
-Setup [certbot](https://certbot.eff.org/) Let's Encrypt client.
-
-<!--more-->
-
- [Default Variables](#default-variables)
-  - [certbot_bin](#certbot_bin)
-  - [certbot_command_arguments](#certbot_command_arguments)
-  - [certbot_config_dir](#certbot_config_dir)
-  - [certbot_credentials](#certbot_credentials)
-  - [certbot_cron_enabled](#certbot_cron_enabled)
-  - [certbot_cron_file](#certbot_cron_file)
-  - [certbot_cron_hour](#certbot_cron_hour)
-  - [certbot_cron_minute](#certbot_cron_minute)
-  - [certbot_domain_groups](#certbot_domain_groups)
-  - [certbot_email](#certbot_email)
-  - [certbot_log_dir](#certbot_log_dir)
-  - [certbot_max_log_backups](#certbot_max_log_backups)
-  - [certbot_packages_extra](#certbot_packages_extra)
-  - [certbot_preferred_challenges](#certbot_preferred_challenges)
-  - [certbot_rsa_key_size](#certbot_rsa_key_size)
-  - [certbot_server](#certbot_server)
-  - [certbot_user](#certbot_user)
-  - [certbot_version](#certbot_version)
-  - [certbot_virtualenv](#certbot_virtualenv)
-  - [certbot_virtualenv_command](#certbot_virtualenv_command)
-  - [certbot_work_dir](#certbot_work_dir)
- [Dependencies](#dependencies)
-
---
-
-## Default Variables
-
-### certbot_bin
-
-Location of the certbot binary. Default is to `~/.local/.bin/certbot`.
-
-### certbot_command_arguments
-
-#### Default value
-
-```YAML
-certbot_command_arguments:
-  - certonly
-```
-
-### certbot_config_dir
-
-#### Default value
-
-```YAML
-certbot_config_dir: /etc/letsencrypt
-```
-
-### certbot_credentials
-
-Specify key value parairs for your credentials (e.g. plugin credentials). The credentials will be saved to `{{ certbot_config_dir }}/credentials.ini and you could add the path to `certbot_command_arguments` if required.
-
-#### Default value
-
-```YAML
-certbot_credentials: []
-```
-
-### certbot_cron_enabled
-
-Enable scheduling via cron.
-
-#### Default value
-
-```YAML
-certbot_cron_enabled: true
-```
-
-### certbot_cron_file
-
-Use a file under /etc/cron.d but this will only work if `certbot_user` has write permissions for this location.
-
-#### Default value
-
-```YAML
-certbot_cron_file: _unset_
-```
-
-#### Example usage
-
-```YAML
-certbot-letsencrypt
-```
-
-### certbot_cron_hour
-
-#### Default value
-
-```YAML
-certbot_cron_hour: '3'
-```
-
-### certbot_cron_minute
-
-#### Default value
-
-```YAML
-certbot_cron_minute: '30'
-```
-
-### certbot_domain_groups
-
-#### Default value
-
-```YAML
-certbot_domain_groups:
-  - name: example
-    domains:
-      - '*.example.com'
-      - example.com
-    init: false
-```
-
-### certbot_email
-
-#### Default value
-
-```YAML
-certbot_email: mail@example.com
-```
-
-### certbot_log_dir
-
-#### Default value
-
-```YAML
-certbot_log_dir: /var/log/letsencrypt
-```
-
-### certbot_max_log_backups
-
-#### Default value
-
-```YAML
-certbot_max_log_backups: 30
-```
-
-### certbot_packages_extra
-
-Extra packages to install with pip (e.g. DNS plugins).
-
-#### Default value
-
-```YAML
-certbot_packages_extra: []
-```
-
-### certbot_preferred_challenges
-
-#### Default value
-
-```YAML
-certbot_preferred_challenges: dns
-```
-
-### certbot_rsa_key_size
-
-#### Default value
-
-```YAML
-certbot_rsa_key_size: 4096
-```
-
-### certbot_server
-
-#### Default value
-
-```YAML
-certbot_server: https://acme-v02.api.letsencrypt.org/directory
-```
-
-### certbot_user
-
-#### Default value
-
-```YAML
-certbot_user: root
-```
-
-### certbot_version
-
-Set a fix version of the certbot package to install.
-
-#### Default value
-
-```YAML
-certbot_version: _unset_
-```
-
-### certbot_virtualenv
-
-#### Default value
-
-```YAML
-certbot_virtualenv: /opt/python3/certbot
-```
-
-### certbot_virtualenv_command
-
-#### Default value
-
-```YAML
-certbot_virtualenv_command: /usr/bin/python3 -m venv
-```
-
-### certbot_work_dir
-
-#### Default value
-
-```YAML
-certbot_work_dir: /var/lib/letsencrypt
-```
-
-
-
-## Dependencies
-
-None.
--- a/meta/main.yml
+++ b/meta/main.yml
@ -0,0 +1,28 @@
+# Standards: 0.2
+---
+galaxy_info:
+  # @meta author:value: [Robert Kaussow](https://gitea.rknet.org/xoxys)
+  author: Robert Kaussow <mail@thegeeklab.de>
+  namespace: xoxys
+  role_name: certbot
+  # @meta description: >
+  # [![Source Code](https://img.shields.io/badge/gitea-source%20code-blue?logo=gitea&logoColor=white)](https://gitea.rknet.org/ansible/xoxys.certbot)
+  # [![Build Status](https://img.shields.io/drone/build/ansible/xoxys.certbot?logo=drone&server=https%3A%2F%2Fdrone.rknet.org)](https://drone.rknet.org/ansible/xoxys.certbot)
+  # [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://gitea.rknet.org/ansible/xoxys.certbot/src/branch/main/LICENSE)
+  #
+  # Setup [certbot](https://certbot.eff.org/) Let's Encrypt client.
+  # @end
+  description: Setup certbot Let's Encrypt client
+  license: MIT
+  min_ansible_version: 2.10
+  platforms:
+    - name: EL
+      versions:
+        - 7
+  galaxy_tags:
+    - le
+    - letsencrypt
+    - certbot
+dependencies: []
+collections:
+  - community.general
--- a/molecule/centos7/converge.yml
+++ b/molecule/centos7/converge.yml
@ -0,0 +1,10 @@
+---
+- name: Converge
+  hosts: all
+  vars:
+    python3_packages_extra:
+      - centos-release-scl
+
+  roles:
+    - role: xoxys.python3
+    - role: xoxys.certbot
--- a/molecule/centos7/create.yml
+++ b/molecule/centos7/create.yml
@ -0,0 +1,120 @@
+---
+- name: Create
+  hosts: localhost
+  connection: local
+  gather_facts: false
+  no_log: "{{ molecule_no_log }}"
+  vars:
+    ssh_port: 22
+    ssh_user: root
+    ssh_path: "{{ lookup('env', 'MOLECULE_EPHEMERAL_DIRECTORY') }}/ssh_key"
+  tasks:
+    - name: Create SSH key
+      user:
+        name: "{{ lookup('env', 'USER') }}"
+        generate_ssh_key: true
+        ssh_key_file: "{{ ssh_path }}"
+        force: true
+      register: generated_ssh_key
+
+    - name: Register the SSH key name
+      set_fact:
+        ssh_key_name: "molecule-generated-{{ 12345 | random | to_uuid }}"
+
+    - name: Register SSH key for test instance(s)
+      hcloud_ssh_key:
+        name: "{{ ssh_key_name }}"
+        public_key: "{{ generated_ssh_key.ssh_public_key }}"
+        state: present
+
+    - name: Create molecule instance(s)
+      hcloud_server:
+        name: "{{ item.name }}"
+        server_type: "{{ item.server_type }}"
+        ssh_keys:
+          - "{{ ssh_key_name }}"
+        image: "{{ item.image }}"
+        location: "{{ item.location | default(omit) }}"
+        datacenter: "{{ item.datacenter | default(omit) }}"
+        user_data: "{{ item.user_data | default(omit) }}"
+        api_token: "{{ lookup('env', 'HCLOUD_TOKEN') }}"
+        state: present
+      register: server
+      loop: "{{ molecule_yml.platforms }}"
+      async: 7200
+      poll: 0
+
+    - name: Wait for instance(s) creation to complete
+      async_status:
+        jid: "{{ item.ansible_job_id }}"
+      register: hetzner_jobs
+      until: hetzner_jobs.finished
+      retries: 300
+      loop: "{{ server.results }}"
+
+    - name: Create volume(s)
+      hcloud_volume:
+        name: "{{ item.name }}"
+        server: "{{ item.name }}"
+        location: "{{ item.location | default(omit) }}"
+        size: "{{ item.volume_size | default(10) }}"
+        api_token: "{{ lookup('env', 'HCLOUD_TOKEN') }}"
+        state: "present"
+      loop: "{{ molecule_yml.platforms }}"
+      when: item.volume | default(False) | bool
+      register: volumes
+      async: 7200
+      poll: 0
+
+    - name: Wait for volume(s) creation to complete
+      async_status:
+        jid: "{{ item.ansible_job_id }}"
+      register: hetzner_volumes
+      until: hetzner_volumes.finished
+      retries: 300
+      when: volumes.changed
+      loop: "{{ volumes.results }}"
+
+    # Mandatory configuration for Molecule to function.
+
+    - name: Populate instance config dict
+      set_fact:
+        instance_conf_dict:
+          {
+            "instance": "{{ item.hcloud_server.name }}",
+            "ssh_key_name": "{{ ssh_key_name }}",
+            "address": "{{ item.hcloud_server.ipv4_address }}",
+            "user": "{{ ssh_user }}",
+            "port": "{{ ssh_port }}",
+            "identity_file": "{{ ssh_path }}",
+            "volume": "{{ item.item.item.volume | default(False) | bool }}",
+          }
+      loop: "{{ hetzner_jobs.results }}"
+      register: instance_config_dict
+      when: server.changed | bool
+
+    - name: Convert instance config dict to a list
+      set_fact:
+        instance_conf: "{{ instance_config_dict.results | map(attribute='ansible_facts.instance_conf_dict') | list }}"
+      when: server.changed | bool
+
+    - name: Dump instance config
+      copy:
+        content: |
+          # Molecule managed
+
+          {{ instance_conf | to_nice_yaml(indent=2) }}
+        dest: "{{ molecule_instance_config }}"
+      when: server.changed | bool
+
+    - name: Wait for SSH
+      wait_for:
+        port: "{{ ssh_port }}"
+        host: "{{ item.address }}"
+        search_regex: SSH
+        delay: 10
+      loop: "{{ lookup('file', molecule_instance_config) | from_yaml }}"
+
+    - name: Wait for VM to settle down
+      pause:
+        seconds: 30
--- a/molecule/centos7/destroy.yml
+++ b/molecule/centos7/destroy.yml
@ -0,0 +1,78 @@
+---
+- name: Destroy
+  hosts: localhost
+  connection: local
+  gather_facts: false
+  no_log: "{{ molecule_no_log }}"
+  tasks:
+    - name: Check existing instance config file
+      stat:
+        path: "{{ molecule_instance_config }}"
+      register: cfg
+
+    - name: Populate the instance config
+      set_fact:
+        instance_conf: "{{ (lookup('file', molecule_instance_config) | from_yaml) if cfg.stat.exists else [] }}"
+
+    - name: Destroy molecule instance(s)
+      hcloud_server:
+        name: "{{ item.instance }}"
+        api_token: "{{ lookup('env', 'HCLOUD_TOKEN') }}"
+        state: absent
+      register: server
+      loop: "{{ instance_conf }}"
+      async: 7200
+      poll: 0
+
+    - name: Wait for instance(s) deletion to complete
+      async_status:
+        jid: "{{ item.ansible_job_id }}"
+      register: hetzner_jobs
+      until: hetzner_jobs.finished
+      retries: 300
+      loop: "{{ server.results }}"
+
+    - pause:
+        seconds: 5
+
+    - name: Destroy volume(s)
+      hcloud_volume:
+        name: "{{ item.instance }}"
+        server: "{{ item.instance }}"
+        api_token: "{{ lookup('env', 'HCLOUD_TOKEN') }}"
+        state: "absent"
+      register: volumes
+      loop: "{{ instance_conf }}"
+      when: item.volume | default(False) | bool
+      async: 7200
+      poll: 0
+
+    - name: Wait for volume(s) deletion to complete
+      async_status:
+        jid: "{{ item.ansible_job_id }}"
+      register: hetzner_volumes
+      until: hetzner_volumes.finished
+      retries: 300
+      when: volumes.changed
+      loop: "{{ volumes.results }}"
+
+    - name: Remove registered SSH key
+      hcloud_ssh_key:
+        name: "{{ instance_conf[0].ssh_key_name }}"
+        state: absent
+      when: (instance_conf | default([])) | length > 0
+
+    # Mandatory configuration for Molecule to function.
+
+    - name: Populate instance config
+      set_fact:
+        instance_conf: {}
+
+    - name: Dump instance config
+      copy:
+        content: |
+          # Molecule managed
+
+          {{ instance_conf | to_nice_yaml(indent=2) }}
+        dest: "{{ molecule_instance_config }}"
+      when: server.changed | bool
--- a/molecule/centos7/molecule.yml
+++ b/molecule/centos7/molecule.yml
@ -0,0 +1,24 @@
+---
+dependency:
+  name: galaxy
+  options:
+    role-file: molecule/requirements.yml
+    requirements-file: molecule/requirements.yml
+  env:
+    ANSIBLE_GALAXY_DISPLAY_PROGRESS: "false"
+driver:
+  name: delegated
+platforms:
+  - name: centos7-certbot
+    image: centos-7
+    server_type: cx11
+lint: |
+  /usr/local/bin/flake8
+provisioner:
+  name: ansible
+  env:
+    ANSIBLE_FILTER_PLUGINS: ${ANSIBLE_FILTER_PLUGINS:-./plugins/filter}
+    ANSIBLE_LIBRARY: ${ANSIBLE_LIBRARY:-./library}
+  log: False
+verifier:
+  name: testinfra
--- a/molecule/centos7/prepare.yml
+++ b/molecule/centos7/prepare.yml
@ -0,0 +1,15 @@
+---
+- name: Prepare
+  hosts: all
+  gather_facts: false
+  tasks:
+    - name: Bootstrap python for Ansible
+      raw: |
+        command -v python3 python || (
+        (test -e /usr/bin/dnf && sudo dnf install -y python3) ||
+        (test -e /usr/bin/apt && (apt -y update && apt install -y python-minimal)) ||
+        (test -e /usr/bin/yum && sudo yum -y -qq install python3) ||
+        echo "Warning: Python not boostrapped due to unknown platform."
+        )
+      become: true
+      changed_when: false
--- a/molecule/centos7/tests/test_default.py
+++ b/molecule/centos7/tests/test_default.py
@ -0,0 +1,18 @@
+import os
+
+import testinfra.utils.ansible_runner
+
+testinfra_hosts = testinfra.utils.ansible_runner.AnsibleRunner(
+    os.environ["MOLECULE_INVENTORY_FILE"]
+).get_hosts("all")
+
+
+def test_certbot_is_installed(host):
+    pkg = host.pip_package.get_packages(pip_path="/opt/python3/certbot/bin/pip")
+    assert "certbot" in pkg
+
+
+def test_certbot_run(host):
+    cmd = host.run("/usr/local/bin/certbot --help")
+    assert "Certbot can obtain and install HTTPS/TLS/SSL certificates." in cmd.stdout
+    assert cmd.succeeded
--- a/molecule/default
+++ b/molecule/default
@ -0,0 +1 @@
+rocky8
--- a/molecule/pytest.ini
+++ b/molecule/pytest.ini
@ -0,0 +1,3 @@
+[pytest]
+filterwarnings =
+    ignore::DeprecationWarning
--- a/molecule/requirements.yml
+++ b/molecule/requirements.yml
@ -0,0 +1,10 @@
+---
+collections:
+  - name: https://gitea.rknet.org/ansible/xoxys.general/releases/download/v2.1.1/xoxys-general-2.1.1.tar.gz
+  - name: community.general
+
+roles:
+  - src: https://gitea.rknet.org/ansible/xoxys.python3.git
+    name: xoxys.python3
+    scm: git
+    version: main
--- a/molecule/rocky8/converge.yml
+++ b/molecule/rocky8/converge.yml
@ -0,0 +1,6 @@
+---
+- name: Converge
+  hosts: all
+  roles:
+    - role: xoxys.python3
+    - role: xoxys.certbot
--- a/molecule/rocky8/create.yml
+++ b/molecule/rocky8/create.yml
@ -0,0 +1,120 @@
+---
+- name: Create
+  hosts: localhost
+  connection: local
+  gather_facts: false
+  no_log: "{{ molecule_no_log }}"
+  vars:
+    ssh_port: 22
+    ssh_user: root
+    ssh_path: "{{ lookup('env', 'MOLECULE_EPHEMERAL_DIRECTORY') }}/ssh_key"
+  tasks:
+    - name: Create SSH key
+      user:
+        name: "{{ lookup('env', 'USER') }}"
+        generate_ssh_key: true
+        ssh_key_file: "{{ ssh_path }}"
+        force: true
+      register: generated_ssh_key
+
+    - name: Register the SSH key name
+      set_fact:
+        ssh_key_name: "molecule-generated-{{ 12345 | random | to_uuid }}"
+
+    - name: Register SSH key for test instance(s)
+      hcloud_ssh_key:
+        name: "{{ ssh_key_name }}"
+        public_key: "{{ generated_ssh_key.ssh_public_key }}"
+        state: present
+
+    - name: Create molecule instance(s)
+      hcloud_server:
+        name: "{{ item.name }}"
+        server_type: "{{ item.server_type }}"
+        ssh_keys:
+          - "{{ ssh_key_name }}"
+        image: "{{ item.image }}"
+        location: "{{ item.location | default(omit) }}"
+        datacenter: "{{ item.datacenter | default(omit) }}"
+        user_data: "{{ item.user_data | default(omit) }}"
+        api_token: "{{ lookup('env', 'HCLOUD_TOKEN') }}"
+        state: present
+      register: server
+      loop: "{{ molecule_yml.platforms }}"
+      async: 7200
+      poll: 0
+
+    - name: Wait for instance(s) creation to complete
+      async_status:
+        jid: "{{ item.ansible_job_id }}"
+      register: hetzner_jobs
+      until: hetzner_jobs.finished
+      retries: 300
+      loop: "{{ server.results }}"
+
+    - name: Create volume(s)
+      hcloud_volume:
+        name: "{{ item.name }}"
+        server: "{{ item.name }}"
+        location: "{{ item.location | default(omit) }}"
+        size: "{{ item.volume_size | default(10) }}"
+        api_token: "{{ lookup('env', 'HCLOUD_TOKEN') }}"
+        state: "present"
+      loop: "{{ molecule_yml.platforms }}"
+      when: item.volume | default(False) | bool
+      register: volumes
+      async: 7200
+      poll: 0
+
+    - name: Wait for volume(s) creation to complete
+      async_status:
+        jid: "{{ item.ansible_job_id }}"
+      register: hetzner_volumes
+      until: hetzner_volumes.finished
+      retries: 300
+      when: volumes.changed
+      loop: "{{ volumes.results }}"
+
+    # Mandatory configuration for Molecule to function.
+
+    - name: Populate instance config dict
+      set_fact:
+        instance_conf_dict:
+          {
+            "instance": "{{ item.hcloud_server.name }}",
+            "ssh_key_name": "{{ ssh_key_name }}",
+            "address": "{{ item.hcloud_server.ipv4_address }}",
+            "user": "{{ ssh_user }}",
+            "port": "{{ ssh_port }}",
+            "identity_file": "{{ ssh_path }}",
+            "volume": "{{ item.item.item.volume | default(False) | bool }}",
+          }
+      loop: "{{ hetzner_jobs.results }}"
+      register: instance_config_dict
+      when: server.changed | bool
+
+    - name: Convert instance config dict to a list
+      set_fact:
+        instance_conf: "{{ instance_config_dict.results | map(attribute='ansible_facts.instance_conf_dict') | list }}"
+      when: server.changed | bool
+
+    - name: Dump instance config
+      copy:
+        content: |
+          # Molecule managed
+
+          {{ instance_conf | to_nice_yaml(indent=2) }}
+        dest: "{{ molecule_instance_config }}"
+      when: server.changed | bool
+
+    - name: Wait for SSH
+      wait_for:
+        port: "{{ ssh_port }}"
+        host: "{{ item.address }}"
+        search_regex: SSH
+        delay: 10
+      loop: "{{ lookup('file', molecule_instance_config) | from_yaml }}"
+
+    - name: Wait for VM to settle down
+      pause:
+        seconds: 30
--- a/molecule/rocky8/destroy.yml
+++ b/molecule/rocky8/destroy.yml
@ -0,0 +1,78 @@
+---
+- name: Destroy
+  hosts: localhost
+  connection: local
+  gather_facts: false
+  no_log: "{{ molecule_no_log }}"
+  tasks:
+    - name: Check existing instance config file
+      stat:
+        path: "{{ molecule_instance_config }}"
+      register: cfg
+
+    - name: Populate the instance config
+      set_fact:
+        instance_conf: "{{ (lookup('file', molecule_instance_config) | from_yaml) if cfg.stat.exists else [] }}"
+
+    - name: Destroy molecule instance(s)
+      hcloud_server:
+        name: "{{ item.instance }}"
+        api_token: "{{ lookup('env', 'HCLOUD_TOKEN') }}"
+        state: absent
+      register: server
+      loop: "{{ instance_conf }}"
+      async: 7200
+      poll: 0
+
+    - name: Wait for instance(s) deletion to complete
+      async_status:
+        jid: "{{ item.ansible_job_id }}"
+      register: hetzner_jobs
+      until: hetzner_jobs.finished
+      retries: 300
+      loop: "{{ server.results }}"
+
+    - pause:
+        seconds: 5
+
+    - name: Destroy volume(s)
+      hcloud_volume:
+        name: "{{ item.instance }}"
+        server: "{{ item.instance }}"
+        api_token: "{{ lookup('env', 'HCLOUD_TOKEN') }}"
+        state: "absent"
+      register: volumes
+      loop: "{{ instance_conf }}"
+      when: item.volume | default(False) | bool
+      async: 7200
+      poll: 0
+
+    - name: Wait for volume(s) deletion to complete
+      async_status:
+        jid: "{{ item.ansible_job_id }}"
+      register: hetzner_volumes
+      until: hetzner_volumes.finished
+      retries: 300
+      when: volumes.changed
+      loop: "{{ volumes.results }}"
+
+    - name: Remove registered SSH key
+      hcloud_ssh_key:
+        name: "{{ instance_conf[0].ssh_key_name }}"
+        state: absent
+      when: (instance_conf | default([])) | length > 0
+
+    # Mandatory configuration for Molecule to function.
+
+    - name: Populate instance config
+      set_fact:
+        instance_conf: {}
+
+    - name: Dump instance config
+      copy:
+        content: |
+          # Molecule managed
+
+          {{ instance_conf | to_nice_yaml(indent=2) }}
+        dest: "{{ molecule_instance_config }}"
+      when: server.changed | bool
--- a/molecule/rocky8/molecule.yml
+++ b/molecule/rocky8/molecule.yml
@ -0,0 +1,24 @@
+---
+dependency:
+  name: galaxy
+  options:
+    role-file: molecule/requirements.yml
+    requirements-file: molecule/requirements.yml
+  env:
+    ANSIBLE_GALAXY_DISPLAY_PROGRESS: "false"
+driver:
+  name: delegated
+platforms:
+  - name: rocky8-certbot
+    image: rocky-8
+    server_type: cx11
+lint: |
+  /usr/local/bin/flake8
+provisioner:
+  name: ansible
+  env:
+    ANSIBLE_FILTER_PLUGINS: ${ANSIBLE_FILTER_PLUGINS:-./plugins/filter}
+    ANSIBLE_LIBRARY: ${ANSIBLE_LIBRARY:-./library}
+  log: False
+verifier:
+  name: testinfra
--- a/molecule/rocky8/prepare.yml
+++ b/molecule/rocky8/prepare.yml
@ -0,0 +1,15 @@
+---
+- name: Prepare
+  hosts: all
+  gather_facts: false
+  tasks:
+    - name: Bootstrap python for Ansible
+      raw: |
+        command -v python3 python || (
+        (test -e /usr/bin/dnf && sudo dnf install -y python3) ||
+        (test -e /usr/bin/apt && (apt -y update && apt install -y python-minimal)) ||
+        (test -e /usr/bin/yum && sudo yum -y -qq install python3) ||
+        echo "Warning: Python not boostrapped due to unknown platform."
+        )
+      become: true
+      changed_when: false
--- a/molecule/rocky8/tests/test_default.py
+++ b/molecule/rocky8/tests/test_default.py
@ -0,0 +1,18 @@
+import os
+
+import testinfra.utils.ansible_runner
+
+testinfra_hosts = testinfra.utils.ansible_runner.AnsibleRunner(
+    os.environ["MOLECULE_INVENTORY_FILE"]
+).get_hosts("all")
+
+
+def test_certbot_is_installed(host):
+    pkg = host.pip_package.get_packages(pip_path="/opt/python3/certbot/bin/pip")
+    assert "certbot" in pkg
+
+
+def test_certbot_run(host):
+    cmd = host.run("/usr/local/bin/certbot --help")
+    assert "Certbot can obtain and install HTTPS/TLS/SSL certificates." in cmd.stdout
+    assert cmd.succeeded
--- a/setup.cfg
+++ b/setup.cfg
@ -0,0 +1,12 @@
+[flake8]
+ignore = D100, D101, D102, D103, D105, D107, E402, W503
+max-line-length = 99
+inline-quotes = double
+exclude = .git,.tox,__pycache__,build,dist,tests,*.pyc,*.egg-info,.cache,.eggs,env*
+
+[yapf]
+based_on_style = google
+column_limit = 99
+dedent_closing_brackets = true
+coalesce_brackets = true
+split_before_logical_operator = true
--- a/tasks/install.yml
+++ b/tasks/install.yml
@ -0,0 +1,103 @@
+---
+- name: Create certbot user '{{ certbot_user }}'
+  user:
+    name: "{{ certbot_user }}"
+  become: True
+  become_user: root
+  when: not certbot_user == 'root'
+
+- block:
+    - name: Upgrade python dependencies
+      pip:
+        name: "{{ item }}"
+        virtualenv: "{{ certbot_virtualenv }}"
+        virtualenv_command: "{{ certbot_virtualenv_command }}"
+        extra_args: --upgrade
+      loop:
+        - pip
+        - setuptools
+
+    - name: Install dependencies
+      pip:
+        name: "{{ item }}"
+        virtualenv: "{{ certbot_virtualenv }}"
+        virtualenv_command: "{{ certbot_virtualenv_command }}"
+      environment:
+        TMPDIR: /opt/python3/tmp
+      loop: "{{ certbot_packages_extra }}"
+
+    - name: Install certbot
+      pip:
+        name: "{{ item }}"
+        virtualenv: "{{ certbot_virtualenv }}"
+        virtualenv_command: "{{ certbot_virtualenv_command }}"
+      loop: "{{ __certbot_packages }}"
+
+    - name: Adjust file permissions
+      file:
+        name: "{{ certbot_virtualenv }}"
+        recurse: True
+        mode: u+rwX,go+rX,go-w
+        state: directory
+
+    - name: Make certbot binaries executable
+      file:
+        name: "{{ certbot_virtualenv }}/bin/{{ item }}"
+        mode: 0755
+      loop: "{{ __certbot_binaries }}"
+
+    - name: Deploy certbot bin wrappers
+      template:
+        src: usr/local/bin/certbot-wrapper.j2
+        dest: "/usr/local/bin/{{ item }}"
+        owner: root
+        group: root
+        mode: 0755
+      loop: "{{ __certbot_binaries }}"
+  become: True
+  become_user: root
+
+- block:
+    - name: Create certbot environment
+      file:
+        path: "{{ item.name }}"
+        state: directory
+        mode: "{{ item.mode }}"
+      loop: "{{ __certbot_environment }}"
+      loop_control:
+        label: "{{ item.name }}"
+
+    - name: Deploy config file
+      template:
+        src: config/cli.ini.j2
+        dest: "{{ certbot_config_dir }}/cli.ini"
+        mode: 0640
+
+    - name: Deploy credentials file
+      template:
+        src: config/credentials.ini.j2
+        dest: "{{ certbot_config_dir }}/credentials.ini"
+        mode: 0600
+      when: certbot_credentials | default([]) | length > 0
+
+    - name: Schedule certbot run
+      cron:
+        name: "Certbot automatic renewal: {{ item.name }}"
+        minute: "{{ certbot_cron_minute }}"
+        hour: "{{ certbot_cron_hour }}"
+        user: "{{ certbot_cron_user | default(certbot_user) }}"
+        job: >
+          {{ certbot_bin | default(__certbot_bin) }}
+          --config-dir {{ certbot_config_dir }}
+          --work-dir {{ certbot_work_dir }}
+          --logs-dir {{ certbot_log_dir }}/{{ item.name }}
+          --max-log-backups {{ certbot_max_log_backups }}
+          {{ certbot_command_arguments | join(' ') }}
+          -n -d {{ item.domains | join(',') }}
+        cron_file: "{{ certbot_cron_file | default(omit) }}"
+      loop: "{{ certbot_domain_groups }}"
+      loop_control:
+        label: "{{ item.name }}"
+      when: certbot_cron_enabled
+  become: True
+  become_user: "{{ certbot_user }}"
--- a/tasks/main.yml
+++ b/tasks/main.yml
@ -0,0 +1,3 @@
+---
+- include_tasks: install.yml
+- include_tasks: setup.yml
--- a/tasks/setup.yml
+++ b/tasks/setup.yml
@ -0,0 +1,20 @@
+---
+- name: Initial run of certbot
+  command: >
+    {{ certbot_bin | default(__certbot_bin) }}
+    --config-dir {{ certbot_config_dir }}
+    --work-dir {{ certbot_work_dir }}
+    --logs-dir {{ certbot_log_dir }}/{{ item.name }}
+    --max-log-backups {{ certbot_max_log_backups }}
+    --agree-tos
+    {{ certbot_command_arguments | join(' ') }}
+    -n -d {{ item.domains | join(',') }}
+  register: __certbot_init
+  changed_when: __certbot_init.rc == 130
+  ignore_errors: True
+  loop: "{{ certbot_domain_groups }}"
+  loop_control:
+    label: "{{ item.name }}"
+  when: item.init | default(False) | bool
+  become: True
+  become_user: "{{ certbot_user }}"
--- a/templates/config/cli.ini.j2
+++ b/templates/config/cli.ini.j2
@ -0,0 +1,14 @@
+#jinja2: lstrip_blocks: True
+{{ ansible_managed | comment}}
+{% if certbot_preferred_challenges is defined %}
+preferred-challenges = {{ certbot_preferred_challenges }}
+{% endif %}
+{% if certbot_server is defined %}
+server = {{ certbot_server }}
+{% endif %}
+{% if certbot_email is defined %}
+email = {{ certbot_email }}
+{% endif %}
+{% if certbot_rsa_key_size is defined %}
+rsa-key-size = {{ certbot_rsa_key_size }}
+{% endif %}
--- a/templates/config/credentials.ini.j2
+++ b/templates/config/credentials.ini.j2
@ -0,0 +1,3 @@
+{% for line in certbot_credentials %}
+{{ line }}
+{% endfor %}
--- a/templates/usr/local/bin/certbot-wrapper.j2
+++ b/templates/usr/local/bin/certbot-wrapper.j2
@ -0,0 +1,4 @@
+#!/usr/bin/env sh
+set -eo pipefail
+
+exec {{ certbot_virtualenv }}/bin/{{ item }} "$@"
--- a/vars/main.yml
+++ b/vars/main.yml
@ -0,0 +1,16 @@
+---
+__certbot_packages:
+  - "certbot{{ '==' + certbot_version if certbot_version is defined else '' }}"
+
+__certbot_environment:
+  - name: "{{ certbot_work_dir }}"
+    mode: "0755"
+  - name: "{{ certbot_config_dir }}"
+    mode: "0755"
+  - name: "{{ certbot_log_dir }}"
+    mode: "0700"
+
+__certbot_binaries:
+  - certbot
+
+__certbot_bin: "/usr/local/bin/certbot"