wcm_io_devops.aem_service

Diese Rolle steuert einen Adobe Experience Manager (AEM) 6.x Dienst auf Linux-Servern und wartet, bis der Start- und Shutdown-Prozess abgeschlossen ist. Sie bietet auch einen Handler, um die Instanz nur bei Bedarf aus anderen Rollen/Playbooks neu zu starten.

Diese Rolle wurde als Teil der wcm.io DevOps Ansible Automation für AEM entwickelt, um Ansible mit CONGA zu integrieren, kann aber unabhängig davon verwendet werden.

Anforderungen

Diese Rolle benötigt Ansible 2.7 oder höher und funktioniert mit AEM 6.1 oder höher. Die Rolle benötigt einen AEM-Dienst, der mit dem Ansible service Modul auf der Zielmaschine gesteuert werden kann.

Rollenvariablen

Verfügbare Variablen sind unten aufgelistet, zusammen mit ihren Standardwerten:

aem_service_name: 

Name des AEM-Dienstes auf der Zielmaschine.

aem_service_port:

Um den Abschluss des Start- und Shutdown-Prozesses zu überprüfen, muss die Rolle den Port kennen, auf dem die AEM-Instanz hört.

Zusätzlich sind die folgenden optionalen Variablen verfügbar:

aem_service_state: started

Der gewünschte Zustand des Dienstes nach Abschluss dieser Rolle: started, stopped oder restarted. started und stopped sind idempotent und ändern den Zustand nur, wenn es notwendig ist, während restarted den Dienst immer neu startet.

aem_service_timeout: 1200

Die Zeit, die gewartet werden soll, bis der Start- oder Shutdown-Prozess abgeschlossen ist (in Sekunden).

aem_service_restricted_mode: false

Aktiviert/deaktiviert den eingeschränkten Modus zur Arbeit mit angepassten Befehlen wie sudo.

# aem_service_start_command: 

Überschreibt den Standard-Befehl (dienstmanagerbezogen) zum Starten.

# aem_service_stop_command: 

Überschreibt den Standard-Befehl (dienstmanagerbezogen) zum Stoppen.

# aem_service_status_command: 

Überschreibt den Standard-Befehl (dienstmanagerbezogen) zum Überprüfen des Status.

# aem_service_status_stopped_status_codes:

Überschreibt die Standardwerte (dienstmanagerbezogen) für die Statuscodes bei gestopptem Dienst.

# aem_service_status_started_status_codes:

Überschreibt die Standardwerte (dienstmanagerbezogen) für die Statuscodes bei gestartetem Dienst.

aem_service_status_valid_status_codes: "{{ _aem_service_status_stopped_status_codes | union(_aem_service_status_started_status_codes) | unique }}"

Liste aller gültigen AEM-Statuscodes.

Abhängigkeiten

Diese Rolle hat keine harten Abhängigkeiten, interagiert jedoch stark mit der Rolle wcm_io_devops.aem_cms.

Beispiel-Playbook

Stoppt die aem-author Instanz und wartet, bis der Shutdown abgeschlossen ist:

- hosts: aem-author
  roles:
    - { role: wcm_io_devops.aem_service,
        aem_service_state: stopped,
        aem_service_name: aem-author,
        aem_service_port: 4502 }

Lizenz

Apache 2.0