Erstellen einer Aktion über die Konsole

Erstellen Sie eine „ Schematics “-Aktion und geben Sie das Playbook „ Ansible “ an, das Sie für Ihre Cloud-Ressourcen ausführen möchten.

1. Melden Sie sich bei der Konsole IBM Cloud an.

2. Klicken Sie auf das Menüsymbol > Plattformautomatisierung > Schematics > Ansible und navigieren Sie zu Playbook erstellen.

   • Erstellen Sie ein Spielbuch.

     1. Geben Sie einen Spielbuchnamen und eine Beschreibung für Ihre Aktion ein. Der Name kann bis zu 128 Zeichen lang sein und kann alphanumerische Zeichen, Leerzeichen, Gedankenstriche und Unterstreichungszeichen enthalten.
     2. Geben Sie die URL des GitHub- oder GitLab-Repositorys ein, in dem Ihr Ansible-Playbook gespeichert ist. Die URL kann auf die Verzweigung 'master', eine andere Verzweigung oder ein Unterverzeichnis verweisen. Wenn in Ihrem Repository mehrere Playbooks gespeichert sind, müssen Sie das Playbook auswählen, das Sie ausführen möchten. Eine Schematics-Aktion kann immer jeweils nur auf ein Playbook verweisen. Wenn Sie mehrere Playbooks ausführen möchten, müssen Sie für jedes Playbook eine separate Aktion erstellen.

     Wenn Sie kein Spielbuch haben, probieren Sie eines Ihrer Beispielspielbücher aus.

     3. Optional: Geben Sie die Branche (optional) und den Ordner (optional) ein.
     4. Optional: Wenn Sie ein privates GitHub-Repository verwenden möchten, geben Sie Ihr persönliches Zugriffstoken ein. Mit dem persönlichen Zugriffstoken wird das private GitHub-Repository für den Zugriff auf Ihr Ansible-Playbook authentifiziert. Weitere Informationen zum Erstellen eines Zugriffstokens finden Sie unter „ Erstellen eines persönlichen Zugriffstokens für die CLI “.

     Weitere Informationen finden Sie unter den zulässigen und gesperrten Dateierweiterungen für das Klonen aus dem Repository „ Git “. Um die Vorlage sicher zu validieren und zu klonen, können Sie auf „ Open reference picker “ klicken, um Ihre „ Secrets Manager “-Schlüsselreferenz auszuwählen. Weitere Informationen finden Sie unter „ Erstellen einer Secrets Manager-Instanz “.

   • Weitere Informationen

     1. Optional: Geben Sie die Tags ein, die Sie Ihrer Aktion hinzufügen wollen. Tags helfen Ihnen dabei, Ihre Aktion schnell zu finden.
     2. Wählen Sie die Ressourcengruppe aus, in der Sie die Aktion erstellen wollen.
     3. Wählen Sie den Standort aus, an dem Sie die Aktion erstellen möchten. Durch den Standort wird festgelegt, wo Ihre Aktion ausgeführt und die Aktionsdaten gespeichert werden. Sie können eine Geografie auswählen, z. B. Dallas oder Frankfurt. Wenn Sie eine Ländergruppe auswählen, bestimmt Schematics den Standort innerhalb dieser Ländergruppe anhand der Verfügbarkeit. Stellen Sie sicher, dass Sie Aktionsdaten an diesem Standort speichern können, da Sie den Standort nach der Erstellung der Aktion nicht ändern können. Weitere Informationen finden Sie unter Wo werden die Informationen gespeichert? Stellen Sie sicher, dass der Standort Ihrer Aktion unabhängig vom Standort Ihrer Cloud-Ressource ist, auf der Sie Ihr „ Ansible “-Playbook ausführen möchten.

   • Ein Inventar auswählen Sie können die Hostgruppen festlegen, auf denen Sie Ihr „ Ansible “-Playbook ausführen möchten.

     1. Klicken Sie auf Bestand erstellen.

     2. Geben Sie einen Namen für Ihr Inventar ein.

     3. Wählen Sie als Verbindungstyp SSH oder WinRM, je nach den Anforderungen Ihres entfernten Hosts. Die Standardeinstellung ist SSH.

        Der Verbindungstyp unterstützt sowohl SSH als auch WinRM für die Verbindung zu entfernten Hosts. Für SSH stellen Sie sicher, dass der Bastion-Host-Zugang konfiguriert ist. WinRM wird verwendet, um eine Verbindung mit entfernten Windows-Hosts herzustellen. Derzeit unterstützt WinRM ausschließlich Windows-Systeme über die öffentliche Schnittstelle IPs und bietet keine Unterstützung für den Zugriff über einen Bastion-Host.

     4. Überprüfen Sie Ihre location und wählen Sie die Resource group, wo Sie das Inventar erstellen möchten.

     5. Klicken Sie auf Hostgruppe erstellen.

     6. Geben Sie einen Namen für Ihre Hostgruppe ein und wählen Sie den Schematics-Arbeitsbereich aus, der die Zielhosts bereitgestellt hat, die Sie zu Ihrer Hostgruppe hinzufügen möchten.

     7. Optional: Klicken Sie auf Abfrage hinzufügen, um eine weitere Bedingung zu Ihrer Abfrage hinzuzufügen, und begrenzen Sie die Anzahl der Zielhosts, die Ihrer Hostgruppe hinzugefügt werden. Sie können angeben, dass Ihre Hosts anhand des Ressourcennamens oder eines Tags identifiziert werden können. Weitere Informationen finden Sie unter Unterstützte Ressourcenabfragen.

     8. Klicken Sie auf Weitere Bedingung hinzufügen und wiederholen Sie die Schritte 6-8, um weitere Hostgruppen hinzuzufügen.

     9. Optional: Klicken Sie auf die Registerkarte Manuell definieren, um die Hosts und die Gruppe von Hosts zu definieren, auf denen Ihr Playbook arbeitet.

     10. Geben Sie die Hostdetails im .ini-Dateiformat in der Option Datei ein.

     11. Wählen Sie in der Tabellenliste die Hostgruppen aus, die Sie in Ihren Ressourcenbestand aufnehmen möchten.

     12. Klicken Sie auf Inventar erstellen, um eine Inventardatei zu definieren, die die Hosts und Gruppen von Hosts festlegt, auf denen Ihr Playbook arbeitet.

3. Wählen Sie in der Tabelle des Ressourceninventars ein vorhandenes Ressourceninventar aus und klicken Sie auf das Symbol Bearbeiten.

   • Klicken Sie auf Anmeldeinformationen verwalten, um die Anmeldeinformationen für das Inventar zu konfigurieren. Weitere Informationen finden Sie unter Verwalten von Berechtigungsnachweisen.
   • Klicken Sie auf Variablen verwalten, um die Bestandsvariablen zu konfigurieren. Weitere Informationen finden Sie unter Verwalten von Variablen.
   • Klicken Sie auf Löschen, um das Inventar zu entfernen.

4. Klicken Sie auf Erstellen. Ihre Aktion wird mit dem Status „ Normal “ erstellt, und Sie werden zum Abschnitt „Details“ weitergeleitet.

5. Klicken Sie auf Aktion prüfen, um zu überprüfen, ob die Aufgaben, die Sie auszuführen versuchen, und Ihre Ressourcen mit Ihrem Playbook verknüpft sind. Sie können den Abschnitt Aktionsverlauf überwachen, um die Ergebnisse in den Protokollen zu sehen. Mit dieser Prüfung wird sichergestellt, dass die Aufgaben, die Sie auszuführen versuchen, und Ihre Ressourcen ordnungsgemäß mit Ihrem Playbook verknüpft sind.

   Sie können einen aktiven Job Ihrer Schematics-Aktion weder löschen noch stoppen. Um die Aktion zu ändern, warten Sie, bis der Auftrag abgeschlossen ist, passen Sie die Einstellungen an und klicken Sie anschließend erneut auf „ Aktion prüfen “ oder „ Aktion ausführen “.

6. Klicken Sie auf Aktion ausführen, um die Aktion auszuführen. Sie können den Fortschritt einer Aktion überwachen, indem Sie die Protokolle auf der Seite Jobs überprüfen. Alle 30 seconds werden die Jobprotokolle automatisch aktualisiert.

Erstellen einer Aktion mit Hilfe von CLI

1. Richten Sie über Ihre lokale CLI-Schnittstelle das Plug-in Schematics ein.
2. Erstellen Sie eine Aktion, indem Sie den Befehl ibmcloud schematics action create verwenden.
3. Erstellen Sie ein Inventar mit dem Befehl ibmcloud schematics inventory create.
4. Überprüfen Sie die Protokolle, um sicherzustellen, dass die Erstellung erfolgreich war.

Erstellen einer Aktion über die API

1. Rufen Sie Ihr IAM-Zugriffstoken ab und authentifizieren Sie sich mit Schematics.
2. Optional: Erstellen Sie eine Aktion, indem Sie eine POST-Anfrage senden.
3. Erstellen Sie ein Inventar, indem Sie eine POST-Anfrage senden.
4. Überprüfen Sie den Antwortstatus, um zu sehen, ob die Erstellung erfolgreich war.