IBM Cloud Docs
Ansible-Playbook erstellen

Ansible-Playbook erstellen

Befolgen Sie die folgenden Voraussetzungen und allgemeinen Schritte, um Ihr Ansible-Playbook zu erstellen. Ausführliche Informationen zur Strukturierung Ihres Playbooks finden Sie in der Dokumentation zuAnsible oder in der Playbook-Erstellung.

Möchten Sie als Einstieg vorhandene Ansible-Playbooks verwenden? Probieren Sie eines der IBM Ansible aus oder durchsuchen Sie vorhandene Ansible und -Rollen in Ansible

  1. Erstellen Sie den Ressourcenbestand, in dem Sie Ihr Ansible-Playbook ausführen möchten. Sie können auch die integrierten Terraform-Funktionen in Schematics verwenden, um Ihre Zielhosts bereitzustellen. Weitere Informationen finden Sie unter Infrastrukturbereitstellung mit Schematics-Arbeitsbereichen.

  2. Erstellen Sie Ihr Ansible-Playbook. Verwenden Sie eines der IBM Playbooks, um loszulegen, oder durchsuchen Sie Ansible, um vorhandene Rollen und Sammlungen zu finden. Diese Rollen und Sammlungen können Sie dann in Ihrem Playbook referenzieren.

  3. Erstellen Sie ein Repository in GitHub oder GitLab und erstellen Sie das Verzeichnis und die Dateistruktur für das Ansible-Playbook. Je nachdem, ob Sie Ansible-Rollen und -Datensammlungen verwenden, kann diese Verzeichnisstruktur variieren. Eine Beispielstruktur finden Sie in diesem Beispielplaybook.

  4. Laden Sie Ihr Ansible-Playbook und die entsprechenden Module, Rollen und Sammlungen in Ihr GitHub-Repository hoch.

  5. Erstellen Sie Schematics-Aktionen.

Ansible-Sammlungen in Ihrem Playbook referenzieren

In Ansible-Sammlungen werden verschiedene wiederverwendbare Ansible-Ressourcen gruppiert, wie z. B. Playbooks, Module und Rollen, sodass Sie sie installieren und in Ihrem Playbook verwenden können. Die Sammlungen werden im Ansible gespeichert.

Ähnlich wie für Ansible-Rollen ist für Sammlungen eine bestimmte Ordnerstruktur in Ihrem GitHub-Repository erforderlich.

  1. Durchsuchen Sie Ansible, um die Sammlung zu finden, die Sie in Ihrem Playbook verwenden möchten.

  2. Erstellen Sie eine Datei requirements.yml, in der Sie die Sammlungen angeben, die Sie aus Ansible Galaxy installieren möchten. Weitere Informationen zur Strukturierung dieser Datei finden Sie in Ansible. Im folgenden Beispiel wird die Sammlung community.kubernetes verwendet.

    collections:
      - name: community.kubernetes
        version: 0.9.0
    
  3. Fügen Sie Ihrem GitHub-Repository einen Ordner collections hinzu, der relativ zum Playbook ist, und speichern Sie die Datei requirements.yml wie in diesem Beispiel gezeigt in diesem Ordner.

    ├── collections
            └── requirements.yml
    ├── playbook.yaml
    ├── README.md
    
  4. Referenzieren Sie eine Ressource aus Ihrer Sammlung in Ihrem Playbook. Weitere Informationen finden Sie in Ansible

Ansible-Playbook zur Ausführung in Schematics vorbereiten

Um das Ansible-Playbook für Schematics vorzubereiten, berücksichtigen Sie die folgenden Hinweise.

  • Ihr Ansible-Playbook muss in einem GitHub- oder GitLab-Repository gespeichert werden.
  • Sie sind in der Art und Weise begrenzt, wie Sie die Zielhosts für Ihr Ansible-Ressourcenbestand angeben können. Weitere Informationen finden Sie unter Ressourcenbestände für Schematics-Aktionen erstellen.
  • Alle Playbooks müssen mit einer Ansible-Version kompatibel sein, die in Schematics unterstützt wird. Führen Sie den Befehl ibmcloud schematics version aus, um unterstützte Versionen zu suchen.
  • Um Ansible-Playbook-Funktionen in Schematics kennenzulernen, können Sie wahlweise Sie können versuchen, eines der von IBMbereitgestellten Ansible-Playbookszu verwenden.