Ansible-Playbook erstellen

Um Ihr Ansible Playbook für die Verwendung mit Schematics zu erstellen, befolgen Sie diese Voraussetzungen und die allgemeinen Schritte.

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

Bereiten Sie Ihr Ressourceninventar vor, auf dem Sie Ihr Ansible Playbook ausführen wollen. Sie können auch die integrierten Terraform-Funktionen von Schematics verwenden, um Zielhosts bereitzustellen. Weitere Informationen finden Sie unter Infrastrukturbereitstellung mit Schematics-Arbeitsbereichen.
Entwickeln Sie Ihr Ansible playbook. Nutzen Sie eines der IBM bereitgestellten Playbooks oder erkunden Sie bestehende Rollen und Sammlungen in Ansible Galaxy. Verweisen Sie auf diese Rollen und Sammlungen](/docs/schematics?topic=schematics-create-playbook#schematics-collections) in Ihrem Spielbuch nach Bedarf.
Richten Sie ein GitHub oder GitLab Repository ein, und organisieren Sie Ihr Ansible Playbook, Ihre Module, Rollen und Sammlungen entsprechend der erforderlichen Verzeichnisstruktur. Eine Beispielstruktur finden Sie in diesem Beispielspielbuch.
Laden Sie Ihr Ansible-Playbook und die entsprechenden Module, Rollen und Sammlungen in Ihr GitHub-Repository hoch.
Erstellen Sie eine Schematics Aktion unter Verwendung des hochgeladenen Playbooks.

Stellen Sie sicher, dass Ihr Playbook die notwendige Struktur einhält und alle erforderlichen Rollen und Sammlungen für eine nahtlose Ausführung in Schematics referenziert. Weitere Informationen finden Sie in der Dokumentation Ansible oder bei der Erstellung von Playbooks.

Ansible-Sammlungen in Ihrem Playbook referenzieren

Ansible sammlungen sind Gruppen von wiederverwendbaren Ansible Ressourcen, wie z. B. Playbooks, Module und Rollen, die Sie in Ihrem Playbook installieren und verwenden können. Die Sammlungen sind im Ansible Galaxy Repository verfügbar.

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

Führen Sie die folgenden Schritte aus, um Sammlungen in Ihrem Schematics playbook zu verwenden

Durchsuchen Sie Ansible Galaxy, um die Sammlung zu finden, die Sie in Ihrem Spielbuch verwenden möchten.
Erstellen Sie eine requirements.yml Datei, um die Sammlungen anzugeben, die Sie von Ansible Galaxy installieren möchten. Die Dateistruktur sollte der Dokumentation von Ansible entsprechen. Hier ist ein Beispiel, das die Sammlung community.kubernetes verwendet.
```
collections:
  - name: community.kubernetes
    version: 0.9.0
```
Fügen Sie einen Ordner collections zu Ihrem GitHub Repository hinzu, relativ zu Ihrem Playbook, und platzieren Sie die Datei requirements.yml in diesem Ordner.
```
├── collections
        └── requirements.yml
├── playbook.yaml
├── README.md
```
Referenzieren Sie eine Ressource aus Ihrer Sammlung in Ihrem Playbook. Weitere Informationen finden Sie in der Dokumentation Ansible. Stellen Sie sicher, dass die Ordnerstruktur Ihres Playbooks den Anforderungen entspricht und die Sammlungen für eine nahtlose Ausführung in Schematics korrekt referenziert werden.

Vorbereitung Ihres Ansible Playbook für Schematics

Bevor Sie Ihr Ansible playbook in Schematics ausführen, sollten Sie die folgenden Punkte beachten:

Speichern Sie Ihr Ansible Playbook in einem GitHub oder GitLab Repository.
Beachten Sie die Einschränkungen bei der Angabe von Zielhosts für Ihr Ansible Ressourceninventar. Weitere Informationen finden Sie in den Leitlinien zur Erstellung von Ressourceninventaren für Schematics Aktionen.
Stellen Sie sicher, dass Ihre Playbooks mit einer Ansible Version kompatibel sind, die in Schematics unterstützt wird. Um die unterstützten Versionen zu prüfen, führen Sie den ibmcloud schematics version befehl aus.
Optional können Sie Ansible-Playbook-Funktionen in Schematics mithilfe eines der IBM bereitgestellten Ansible-Playbooks erkunden.

Nächste Schritte

Nachdem Sie die Voraussetzungen und Vorbereitungsschritte für Ihr Ansible Playbook verstanden haben, besteht der nächste Schritt darin, eine Schematics Aktion zu erstellen. Dieser Prozess umfasst die Angabe Ihres Ansible Playbooks, die Konfiguration des Ressourceninventars und die Einrichtung aller erforderlichen Anmeldeinformationen oder Variablen. Folgen Sie der Anleitung zum Erstellen einer Schematics Aktion, um fortzufahren.