refactor(alertmanager): add state=absent support

roles/alertmanager/defaults/main/container.yml

@@ -1,11 +1,4 @@
 ---
-alertmanager_user: alertmanager
-alertmanager_version: 0.27.0
-alertmanager_base_path: /opt/alertmanager
-alertmanager_config_path: "{{ alertmanager_base_path }}/config"
-alertmanager_config_file: "{{ alertmanager_config_path }}/alertmanager.yml"
-alertmanager_data_path: "{{ alertmanager_base_path }}/data"
-
 alertmanager_container_name: alertmanager
 alertmanager_container_image_name: alertmanager
 alertmanager_container_image_namespace: prometheus/
@@ -32,8 +25,5 @@ alertmanager_container_volumes: >-
   {{ alertmanager_container_default_volumes
      + alertmanager_container_extra_volumes | default([]) }}
 alertmanager_container_restart_policy: "unless-stopped"
-
-alertmanager_config:
-  global: {}
-  route: {}
-  receivers: []
+alertmanager_container_state: >-2
+  {{ (alertmanager_state == 'present') | ternary('started', 'absent') }}

roles/alertmanager/defaults/main/main.yml

@@ -0,0 +1,14 @@
+---
+alertmanager_user: alertmanager
+alertmanager_version: 0.27.0
+alertmanager_state: present
+alertmanager_base_path: /opt/alertmanager
+alertmanager_config_path: "{{ alertmanager_base_path }}/config"
+alertmanager_config_file: "{{ alertmanager_config_path }}/alertmanager.yml"
+alertmanager_data_path: "{{ alertmanager_base_path }}/data"
+
+
+alertmanager_config:
+  global: {}
+  route: {}
+  receivers: []

roles/alertmanager/meta/main.yml

@@ -0,0 +1,10 @@
+---
+allow_duplicates: true
+dependencies: []
+galaxy_info:
+  role_name: alertmanager
+  description: Deploy and configure prometheus alertmanager
+  galaxy_tags:
+    - prometheus
+    - alertmanager
+    - observability

roles/alertmanager/tasks/main.yml

@@ -1,16 +1,22 @@
 ---
+- name: Ensure state is valid
+  ansible.builtin.fail:
+    msg: >-2
+      Invalid state '{{ alertmanager_state }}'! Valid
+      states are {{ alertmanager_states | join(', ') }}.
+  when: alertmanager_state not in alertmanager_states
 
-- name: Ensure alertmanager user '{{ alertmanager_user }}' exists
+- name: Ensure alertmanager user '{{ alertmanager_user }}' is {{ alertmanager_state }}
   ansible.builtin.user:
     name: "{{ alertmanager_user }}"
-    state: present
+    state: {{ alertmanager_state }}
     system: true
   register: alertmanager_user_info
 
-- name: Ensure mounts are created
+- name: Ensure mounts are {{ alertmanager_state }}
   ansible.builtin.file:
     dest: "{{ item.path }}"
-    state: directory
+    state: "{{ (alertmanager_state == 'present') | ternary('directory', 'absent') }}"
     owner: "{{ item.owner | default(alertmanager_user_info.uid | default(alertmanager_user)) }}"
     group: "{{ item.owner | default(alertmanager_user_info.group | default(alertmanager_user)) }}"
     mode: "{{ item.mode | default('0755') }}"
@@ -26,17 +32,18 @@
     owner: "{{ alertmanager_user_info.uid | default(alertmanager_user) }}"
     owner: "{{ alertmanager_user_info.uid | default(alertmanager_user) }}"
     mode: "0640"
+  when: alertmanager_state == 'present'
   notify:
     - restart-alertmanager
 
-- name: Ensure container image is present on host
+- name: Ensure container image is {{ alertmanager_state }} on host
   community.docker.docker_image:
     name: "{{ alertmanager_container_image_reference }}"
-    state: present
+    state: "{{ alertmanager_state }}"
     source: pull
     force_source: "{{ alertmanager_container_image_force_pull | bool }}"
 
-- name: Ensure container '{{ alertmanager_container_name }}' is running
+- name: Ensure container '{{ alertmanager_container_name }}' is {{ alertmanager_container_state }}
   community.docker.docker_container:
     name: "{{ alertmanager_container_name }}"
     image: "{{ alertmanager_container_image_reference }}"
@@ -48,4 +55,4 @@
     purge_networks: "{{ alertmanager_container_purge_networks | default(omit) }}"
     etc_hosts: "{{ alertmanager_container_etc_hosts | default(omit) }}"
     restart_policy: "{{ alertmanager_container_restart_policy }}"
-    state: started
+    state: "{{ alertmanager_container_state }}"

roles/alertmanager/vars/main.yml

@@ -0,0 +1,4 @@
+---
+alertmanager_states:
+  - present
+  - absent