Automatisierungen erstellen

In dieser Anleitung wird erläutert, wie Sie mithilfe der STACKIT Automation Service API, des STACKIT-Portals, der STACKIT-CLI oder von Terraform eine Automatisierung erstellen. Automatisierungen werden auf der Grundlage 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/v1/projects/{projectId}/regions/{region}/services/volumes/automations

Beispiel für den Anfragetext

{
  "description": "Erstellt tägliche Wiederherstellungspunkte (Snapshots und Backups) für alle Volumes mit dem angegebenen Label",
  "input": {
    "inheritVolumeLabels": true,
    "kind": "VolumeRecoveryPointManagement",
    "recoveryPointLabels": {
      "exampleLabelKey1": "exampleLabelValue1",
      "exampleLabelKey2": "exampleLabelValue2"
    },
    "snapshotRetentionPolicy": {
      "kind": "count",
      "value": 6
    },
    "backupRetentionPolicies": [
      {
        "kind": "daily",
        "retentionPeriod": 14
      }
    ],
    "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, einschießlich snapshotRetentionPolicy und backupRetentionPolicies.

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. 6. Wechseln Sie zum Abschnitt Wiederherstellungspunkte, um Bezeichnungen, die Aufbewahrungsdauer von Snapshots und Optionen für tägliche Backups 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 die Optionen zur Aufbewahrung von Snapshots. Aktivieren Sie den Schalter Richtlinie zur Aufbewahrung von Snapshots, um den ältesten Snapshot automatisch zu löschen und so das von Ihnen festgelegte Limit einzuhalten, und legen Sie Ihren Schwellenwert unter Snapshots pro Volume fest.
   • Konfigurieren Sie unter Backups die Aufbewahrungsoptionen für tägliche Backups. Aktivieren Sie den Schalter Richtlinie zur Aufbewahrung täglicher Backups, um bei Auslösung automatisch ein tägliches Backup im dedizierten, isolierten Speicher auf Basis des neuesten Snapshots zu erstellen. Legen Sie unter Aufbewahrungsdauer (Tage) Ihr gewünschtes Ablauffenster fest (Standardwert: 14 Tage).

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

STACKIT CLI

Um eine Volume-Automatisierung über die STACKIT-Befehlszeilenschnittstelle zu erstellen, verwenden Sie den Befehl stackit beta volume automation create.

stackit beta volume automation create \
  --project-id "ihre-projekt-id" \
  --name "Meine tägliche Automatisierung zur Erstellung von Volume-Wiederherstellungspunkten" \
  --description "Erstellt tägliche Wiederherstellungspunkte (Snapshots und Backups)" \
  --template-id "62c5178a-87fb-437f-88c8-c6f26b3ee4f6" \
  --volume-label-selector "environment=production" \
  --snapshot-retention-count 6 \
  --backup-retention-daily 14

Syntax des CLI-Befehls: Beachten Sie, dass die Flags für die backup und snapshot Aufbewahrung unter stackit beta volume automation create definiert sind. Verwenden Sie --help für diesen Befehl, um alle unterstützten Argumente aufzulisten:

stackit beta volume automation create --help

Terraform

Mit dem STACKIT Terraform Provider (>= v0.117.0) können Sie Automatisierungen erstellen und verwalten.

resource "stackit_volume_automation" "example" {
  project_id  = "ihre-projekt-id"
  name        = "Meine tägliche Automatisierung zur Erstellung von Volume-Wiederherstellungspunkten"
  description = "Erstellt tägliche Wiederherstellungspunkte für bestimmte Volumes"
  template_id = "62c5178a-87fb-437f-88c8-c6f26b3ee4f6"

  volume_label_selector = "environment=production"

  snapshot_retention_policy = {
    kind  = "count"
    value = 6
  }

  backup_retention_policies = [
    {
      kind             = "daily"
      retention_period = 14
    }
  ]

  triggers = {
    schedule = {
      rrule = "DTSTART;TZID=Europe/Sofia:20260924T023000\nRRULE:FREQ=DAILY;INTERVAL=1"
    }
  }
}

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.