Automatisierungen erstellen

Der STACKIT Automation Service befindet sich derzeit in der Public Preview (Beta)-Phase.

In dieser Anleitung wird erläutert, wie Sie mithilfe der STACKIT Automation Service API oder des STACKIT-Portals eine Automatisierung erstellen. Automatisierungen werden anhand vordefinierter Vorlagen erstellt und können mit spezifischen Parametern konfiguriert werden.

Voraussetzungen

• Swagger-API-Definition für die STACKIT Automation Service API.
• Der Automation Service wurde aktiviert
• Verfügbare Automatisierungsvorlagen

Eine Automatisierung erstellen

API

Um eine neue Automatisierung über die API zu erstellen, müssen Sie die folgenden Informationen angeben:

• projectId
• regionId
• Automatisierungskonfiguration einschließlich Vorlagen-ID und Parametern

Verwenden Sie die folgende POST-Anfrage, um eine Automatisierung zu erstellen:

POST https://automation-service.api.stackit.cloud/v1beta/projects/{projectId}/regions/{region}/services/volumes/automations

Beispiel für den Anfragetext

{
  "description": "Erstellt tägliche Wiederherstellungspunkte für alle Volumes mit dem angegebenen Label",
  "input": {
    "inheritVolumeLabels": true,
    "kind": "VolumeRecoveryPointManagement",
    "recoveryPointLabels": {
      "exampleLabelKey1": "exampleLabelValue1",
      "exampleLabelKey2": "exampleLabelValue2"
    },
    "snapshotRetentionPolicy": {
      "kind": "count",
      "value": 2
    },
    "volumeLabelSelector": "myLabelkey1=myLabelValue,myLabelKey2=myOtherLabelValue"
  },
  "name": "Meine tägliche Automatisierung zur Erstellung von Wiederherstellungspunkten für Volumes",
  "templateId": "62c5178a-87fb-437f-88c8-c6f26b3ee4f6",
  "triggers": {
    "schedule": {
      "rrule": "DTSTART;TZID=Europe/Sofia:20200803T023000\nRRULE:FREQ=DAILY;INTERVAL=1"
    }
  }
}

1. Wählen Sie eine Automatisierungsvorlage aus: Nutzen Sie die Anleitung Automatisierungsvorlagen abrufen, um verfügbare Vorlagen abzurufen.

2. Bereiten Sie Ihre Anfrage vor: Geben Sie die erforderlichen Parameter entsprechend der von Ihnen ausgewählten Vorlage ein.

3. Senden Sie die POST-Anfrage: Führen Sie den API-Aufruf mit Ihrer Automatisierungskonfiguration aus.

4. Speichern Sie die Automatisierungs-ID: Die Antwort enthält eine automationId, die Sie für zukünftige Vorgänge benötigen.

API-Referenz: CreateAutomation.

STACKIT-Portal

Um eine Automatisierung über das STACKIT-Portal zu erstellen, führen Sie die folgenden Schritte aus:

1. Navigieren Sie in der Projektübersicht zu Storage —> Disk Volumes —> Automatisierungen.

2. Klicken Sie auf Automatisierung erstellen und wechseln Sie zu Allgemeine Informationen.

3. Geben Sie einen Namen für Ihre Automatisierung ein und wählen Sie eine Automatisierungsvorlage (z. B. “Volume Recovery Point Management”) aus der Dropdown-Liste aus.

4. Legen Sie unter Zugehörige Volumes anhand Ihrer Filtereinstellungen fest, für welche aktuellen und zukünftigen Volumes in diesem Projekt die Automatisierung gelten soll:

   • Alle: Bezieht automatisch alle Volumes in Ihrem Projekt ein.
   • Ausgewählt: Ermöglicht es Ihnen, die Zielvolumes anhand bestimmter Labels einzugrenzen, die ein- oder ausgeschlossen werden sollen.
   • Erweitert: Bietet ein benutzerdefiniertes Texteingabefeld für erweiterte Ausdrücke zur Labelauswahl.
   • Tipp: Klicken Sie auf die Schaltfläche Zugehörige Volumes anzeigen, um eine Vorschau anzuzeigen und zu überprüfen, ob Ihre Filter korrekt sind und die erwarteten Volumes von der Automatisierung korrekt angesprochen werden.

5. Legen Sie unter Zeitplan den Ausführungsmodus für Ihre Automatisierung fest:

   • Manuell: Lösen Sie die Automatisierung bei Bedarf selbst aus.
   • Geplant: Legen Sie ein bestimmtes Startdatum, eine Startzeit und eine Wiederholungshäufigkeit (z. B. stündlich, täglich, wöchentlich) für die automatische Ausführung fest.

6. Wechseln Sie zum Abschnitt Wiederherstellungspunkte, um Bezeichnungen und Aufbewahrungsrichtlinien für die Ausgabevolumen zu konfigurieren:

   • Aktivieren Sie unter Bezeichnungen für Wiederherstellungspunkte die Option Bezeichnungen von Volumes kopieren, um vorhandene Bezeichnungen automatisch von den Quellvolumes auf die Wiederherstellungspunkte zu übertragen, oder klicken Sie auf Bezeichnung hinzufügen, um benutzerdefinierte Schlüssel-Wert-Paare manuell zuzuweisen.
   • Konfigurieren Sie unter Snapshots Ihre Aufbewahrungsoptionen. Aktivieren Sie den Schalter Snapshot-Aufbewahrungsrichtlinie, um den ältesten Snapshot automatisch zu löschen und so Ihr definiertes Limit einzuhalten, und geben Sie Ihren gewünschten Schwellenwert in das Feld Snapshots pro Volume ein.

7. Überprüfen Sie Ihre Konfiguration im rechten Übersichtsbereich und klicken Sie auf Kostenpflichtig bestellen, um den Vorgang abzuschließen.

Nach der Erstellung können Sie die Automatisierung manuell ausführen oder sie wird gemäß ihrem Zeitplan ausgeführt. Informationen zur manuellen Ausführung finden Sie unter Automatisierungen ausführen.