Erstellen und Verwalten von Intake Runnern

Voraussetzungen

Bevor Sie mit der Erstellung und Verwaltung Ihrer Intake Runner über die STACKIT CLI beginnen, stellen Sie sicher, dass folgende Voraussetzungen erfüllt sind:

• Sie verfügen über ein STACKIT Kundenkonto: Kundenkonto erstellen
• Sie verfügen über ein STACKIT Benutzerkonto: Benutzerkonto erstellen
• Sie haben ein STACKIT Projekt angelegt: Projekt erstellen
• Sie haben die STACKIT CLI auf Ihrem System installiert: Benutzerhandbuch

Einen Intake Runner erstellen

Der Intake Runner ist die Engine für Ihre Datenaufnahme (Data Ingestion). Sie müssen einen Intake Runner erstellen, bevor Sie einen Intake anlegen können.

Durchsatzkapazität festlegen

Zunächst müssen Sie die maximale Durchsatzkapazität bestimmen, die Ihr Intake Runner über alle seine Intakes hinweg aufrechterhalten soll. Wir bieten Hinweise im Artikel Planen Sie Ihren Intake Runner.

Sie legen die maximale Durchsatzkapazität für Ihren Intake Runner fest, indem Sie zwei Parameter definieren:

• max-message-size-kib: Die maximale Größe einer einzelnen Nachricht in Kibibyte.
• max-message-size-per-hour: Die maximale Anzahl an Nachrichten, die der Runner pro Stunde verarbeiten kann.

STACKIT Portal

1. Öffnen Sie Ihr Projekt im STACKIT Portal.

2. Navigieren Sie zu Data & AI > Intake.

3. Klicken Sie in der Seitenleiste auf Intake Runners.

4. Klicken Sie in der oberen Leiste auf Intake Runner erstellen.

5. Füllen Sie die Felder aus:

   Feld	Beschreibung	Optionen	Standard	Optional
   Name	Ein lesbarer Name für den Intake Runner	String, maximal 32 Zeichen
   Max message size	Die maximale Größe für eine einzelne Nachricht in Kibibyte	Integer, zwischen 1 und 1024. Produkt mit max-messages-per-hour darf 20 GiB/h nicht überschreiten
   Max message rate (per h)	Die maximale Anzahl an Nachrichten, die über alle Intakes pro Stunde verarbeitet werden kann	Integer, mindestens 1. Produkt mit max-message-size-kib darf 20 GiB/h nicht überschreiten
   Beschreibung	Eine textuelle Beschreibung des Zwecks des Runners	String, maximal 1024 Zeichen	""	✓

6. Klicken Sie auf Feed-basiert bestellen.

STACKIT CLI

Flags

Flag	Beschreibung	Optionen	Standard	Optional
display-name	Ein lesbarer Name für den Intake Runner	String, maximal 32 Zeichen
max-message-size-kib	Die maximale Größe für eine einzelne Nachricht in Kibibyte	Integer, zwischen 1 und 1024. Produkt mit max-messages-per-hour darf 20 GiB/h nicht überschreiten
max-messages-per-hour	Die maximale Anzahl an Nachrichten, die über alle Intakes pro Stunde verarbeitet werden kann	Integer, mindestens 1. Produkt mit max-message-size-kib darf 20 GiB/h nicht überschreiten
description	Eine textuelle Beschreibung des Zwecks des Runners	String, maximal 1024 Zeichen	""	✓
labels	Labels im Format key=value. Ermöglicht die Klassifizierung des Zwecks des Intake Runners	Format key=value, durch Kommas getrennt. Beispiel: “key1=value1,key2=value2”	[]	✓

Erstellungsbefehl ausführen

Um Ihren Intake Runner zu erstellen, führen Sie den Befehl unter Angabe der entsprechenden Flags aus:

stackit beta intake runner create --display-name <DISPLAY_NAME> --max-message-size-kib <MAX_MESSAGE_SIZE> --max-messages-per-hour <MAX_MESSAGES> --description <DESCRIPTION> --labels <LABELS>

Nach Ausführung des Befehls müssen Sie mit y bestätigen. Wenn die Instanz erfolgreich erstellt wurde, gibt die CLI die Instanz-ID zurück:

Created Intake Runner for project "...". Runner ID: af1b6d5b-9dc5-4dee-ab48-e944a7a17a2b

Beispiele

Erstellen eines Intake Runners mit minimalen Flags:

stackit beta intake runner create --display-name minimal-runner --max-message-size-kib 5 --max-messages-per-hour 10000

Erstellen eines Intake Runners mit Labels:

stackit beta intake runner create --display-name minimal-runner --max-message-size-kib 5 --max-messages-per-hour 10000 --labels "dept=billing,stage=test"

Alle Intake Runner auflisten

STACKIT Portal

1. Öffnen Sie Ihr Projekt im STACKIT Portal.
2. Navigieren Sie zu Data & AI > Intake.
3. Klicken Sie in der Seitenleiste auf Intake Runners.

Nun sehen Sie die Liste der Intake Runner in Ihrem Projekt.

STACKIT CLI

Um alle Intake Runner in einem Cloud-Projekt aufzulisten, rufen Sie den List-Befehl auf:

stackit beta intake runner list

Dies führt zu einer Ausgabe wie der folgenden:

ID                                     │ NAME
─────────────────────────────────────┼────────────────
ef907939-6fcd-42b0-a635-1b33d3ba7cf3 │ minimal-runner

Einen Intake Runner anzeigen

STACKIT Portal

1. Öffnen Sie Ihr Projekt im STACKIT Portal.
2. Navigieren Sie zu Data & AI > Intake.
3. Klicken Sie in der Seitenleiste auf Intake Runners.
4. Klicken Sie auf den Intake Runner, den Sie anzeigen möchten.

Nun können Sie die Details des ausgewählten Intake Runners einsehen.

STACKIT CLI

Sie können den Status und die Details eines beliebigen Intake Runners mit dem Describe-Befehl überprüfen.

Argument	Beschreibung
INTAKE_RUNNER_ID	Die ID des Intake Runners, den Sie beschreiben möchten

stackit beta intake runner describe <INTAKE_RUNNER_ID>

Dies führt zu einer Ausgabe wie der folgenden:

ID                     │ ef907939-6fcd-42b0-a635-1b33d3ba7cf3
State                  | active
Name                   │ minimal-runner
Description            │
Max Message Size (KiB) │ 5
Max Messages/Hour      │ 10000
Ingestion URI          │ ef907939-6fcd-42b0-a635-1b33d3ba7cf3.intake.eu01.onstackit.cloud:9094
flags                  | dept=billing,stage=test

Beispiele

stackit beta intake runner describe ef907939-6fcd-42b0-a635-1b33d3ba7cf3

Einen Intake Runner aktualisieren

STACKIT Portal

1. Öffnen Sie Ihr Projekt im STACKIT Portal.

2. Navigieren Sie zu Data & AI > Intake.

3. Klicken Sie in der Seitenleiste auf Intake Runners.

4. Klicken Sie auf den Intake Runner, den Sie aktualisieren möchten.

5. Klicken Sie unter Allgemeine Informationen auf Bearbeiten.

6. Aktualisieren Sie die Felder, die Sie ändern möchten:

   Feld	Beschreibung	Optionen
   Name	Ein lesbarer Name für den Intake Runner	String, maximal 32 Zeichen
   Max message size	Die maximale Größe für eine einzelne Nachricht in Kibibyte	Integer, zwischen 1 und 1024. Produkt mit max-messages-per-hour darf 20 GiB/h nicht überschreiten oder verkleinert werden.
   Max message rate (per h)	Die maximale Anzahl an Nachrichten, die über alle Intakes pro Stunde verarbeitet werden kann	Integer, mindestens 1. Produkt mit max-message-size-kib darf 20 GiB/h nicht überschreiten oder verkleinert werden.
   Beschreibung	Eine textuelle Beschreibung des Zwecks des Runners	String, maximal 1024 Zeichen

7. Klicken Sie auf Speichern.

STACKIT CLI

Sie können den Anzeigenamen, die Beschreibung, die Labels aktualisieren oder die Durchsatzkapazität eines bestehenden Intake Runners mit dem Update-Befehl erhöhen.

Argument	Beschreibung
INTAKE_RUNNER_ID	Die ID des Intake Runners, den Sie aktualisieren möchten

Flag	Beschreibung	Optionen
display-name	Ein lesbarer Name für den Intake Runner	String, maximal 32 Zeichen
max-message-size-kib	Die maximale Größe für eine einzelne Nachricht in Kibibyte	Integer, zwischen 1 und 1024. Produkt mit max-messages-per-hour darf 20 GiB/h nicht überschreiten oder verkleinert werden.
max-messages-per-hour	Die maximale Anzahl an Nachrichten, die über alle Intakes pro Stunde verarbeitet werden kann	Integer, mindestens 1. Produkt mit max-message-size-kib darf 20 GiB/h nicht überschreiten oder verkleinert werden.
description	Eine textuelle Beschreibung des Zwecks des Runners	String, maximal 1024 Zeichen
labels	Labels im Format key=value. Ermöglicht die Klassifizierung des Zwecks des Intake Runners	Format key=value, durch Kommas getrennt. Beispiel: “key1=value1,key2=value2”

Update-Befehl ausführen

Um Ihren Intake Runner zu aktualisieren, führen Sie den Befehl unter Angabe der ID des Intake Runners und der entsprechenden Flags aus:

stackit beta intake runner update <INTAKE_RUNNER_ID> --display-name <DISPLAY_NAME> --max-message-size-kib <MAX_MESSAGE_SIZE> --max-messages-per-hour <MAX_MESSAGES> --description <DESCRIPTION> --labels <LABELS>

Sobald der Update-Befehl gesendet wurde, antwortet die CLI mit einem Text wie diesem:

Update request for Intake Runner "af1b6d5b-9dc5-4dee-ab48-e944a7a17a2b" sent successfully.

Beispiele

Ändern der Labels eines Intake Runners:

stackit beta intake runner update af1b6d5b-9dc5-4dee-ab48-e944a7a17a2b --labels "dept=billing,stage=test"

Einen Intake Runner löschen

STACKIT Portal

1. Öffnen Sie Ihr Projekt im STACKIT Portal.
2. Navigieren Sie zu Data & AI > Intake.
3. Klicken Sie in der Seitenleiste auf Intake Runners.
4. Klicken Sie auf die drei Punkte rechts neben dem von Ihnen erstellten Intake Runner.
5. Wählen Sie Löschen.
6. Bestätigen Sie das Löschen durch Eingabe des Namens des Intake Runners.
7. Drücken Sie auf Löschen.

Das Löschen eines Intake Runners ist ein unwiderruflicher Vorgang. Dabei werden auch alle zugehörigen Intakes und Intake-Benutzer gelöscht.

STACKIT CLI

Das Löschen eines Intake Runners ist ein unwiderruflicher Vorgang. Dabei werden auch alle zugehörigen Intakes und Intake-Benutzer gelöscht, wenn Sie das Flag —force verwenden. Wenn Sie force nicht verwenden, wechselt der Status des Runners zu “deleting”. Er bleibt in diesem Status und ist weiterhin funktionsfähig, bis alle zugehörigen Intakes von Ihnen manuell gelöscht wurden.

Argument	Beschreibung
INTAKE_RUNNER_ID	Die ID des Intake Runners, den Sie löschen möchten

Flag	Beschreibung
force	Löscht auch die Intakes und Intake-Benutzer

stackit beta intake runner delete <INTAKE_RUNNER_ID> --force

Sie müssen das Löschen des Intake Runners durch Drücken von y bestätigen. Der Delete-Befehl führt zu einer Ausgabe wie dieser:

Deletion request for Intake Runner "ef907939-6fcd-42b0-a635-1b33d3ba7cf3" sent successfully.