apigeectl

apigeectl ist eine Befehlszeile zur Installation und Verwaltung von Apigee Hybrid in einem Kubernetes-Cluster. Informationen zum Herunterladen und Installieren von apigeectl finden Sie unter apigeectl herunterladen und installieren.

apigeectl-Syntax

apigeectl [command] [flags]

Dabei gilt:

  • command: gibt den Vorgang an, den Sie ausführen möchten. Eine vollständige Liste der Befehle finden Sie unter apigeectl-Befehle.

  • flags: gibt Befehlsparameter an. Eine vollständige Liste der Flags finden Sie unter apigeectl-Flags.

apigeectl-Befehle

In der folgenden Tabelle sind die apigeectl-Befehle aufgeführt:

Befehl Beschreibung
apply

Wendet Konfigurationen für Apigee Hybrid-Laufzeitkomponenten auf Ihren Kubernetes-Cluster an. Mit dem Flag -c können Sie eine oder mehrere durch Kommas getrennte Komponenten angeben.

Wenn Sie das Flag -c nicht angeben, wendet der Befehl apply alle Komponenten auf den Cluster an.
check‑ready

Prüft den Status der Hybrid-Komponenten-Pods. Wenn alle Komponenten-Pods bereit sind, wird die Meldung „Alle Container bereit“ ausgegeben. Beachten Sie bei automatisierten Skripts, dass der Befehl mit dem Status 0 beendet wird, wenn alle Container bereit sind. Wenn nur ein einziger Pod nicht bereit ist, wird der Befehl mit dem Status 1 beendet.

Wenn Sie das Flag -c nicht angeben, gilt der Befehl check-ready für alle Komponenten im Cluster.
delete

Löscht Hybridkomponenten aus dem Cluster. Mit dem Flag --all entfernen Sie ALLE Komponenten. Wenn Sie --all weglassen, werden nur die Apigee-spezifischen Komponenten entfernt (die mit apigeectl init installierten Komponenten werden nicht gelöscht). Apigee-spezifische Komponenten sind Komponenten, die mit dem Befehl apply installiert werden.

Wenn Sie das Flag -c nicht angeben, gilt der Befehl delete für alle Komponenten, die im Cluster bereitgestellt werden.
help Gibt die Onlinehilfe in eine Datei aus.
init

Wendet Konfigurationen für erforderliche Komponenten wie Istio und Apigee Deployment auf den Cluster an. Mit dem Flag -c können Sie eine oder mehrere durch Kommas getrennte Komponenten angeben.
version Gibt die Versionsinformationen der Kommandozeile in eine Datei aus.

apigeectl-Flags

In der folgenden Tabelle sind die Flags apigeectl aufgeführt:

Flag Beschreibung
-c, --components

Gibt eine einzelne Komponente an, auf die der Befehl angewendet wird.

Wenn Sie dieses Flag nicht angeben, gilt der Befehl für alle Komponenten (das gesamte Deployment) im Cluster. Mögliche Werte:

  • cassandra
  • logger
  • mart
  • metrics
  • runtime
  • synchronizer
  • udca

Beispiel: -c cassandra

Oder geben Sie mehrere durch Kommas getrennte Werte für mehrere Komponenten an: -c cassandra, runtime
--dry-run Führt den angegebenen Befehl aus, ohne den Cluster zu ändern. Verwenden Sie ‑‑print-yaml, um die gerenderte Objektspezifikation in eine Datei auszugeben.
‑f, ‑‑file‑override‑config Gibt eine YAML-Datei an, die benutzerdefinierte Konfigurationsattribute für die Hybrid-Bereitstellung enthält. Der Standardwert ist ./overrides.yaml. Für die Befehle apply, check-ready, delete und init ist eine overrides-Datei erforderlich.

Sie müssen den vollständigen Pfad mit diesem Flag angeben. Weitere Informationen finden Sie unter Komponenten der Laufzeitebene verwalten.
-h, --help Zeigt Hilfe zu diesem Befehl an.
--print-yaml Gibt die Konfigurationsvorlage in stdout aus. Ein Beispiel für dieses Flag finden Sie unter Konfiguration in eine Datei ausgeben.
-s, --settings

Gibt eine Konfiguration an, auf die der Befehl angewendet wird. Derzeit wird dieses Flag nur für die virtualhosts-Konfiguration unterstützt, die Teil der runtime-Komponente ist. Verwenden Sie dieses Flag, wenn Sie Änderungen am Attribut virtualhosts vornehmen. (Version 1.2.0 hinzugefügt)

Wenn Sie beispielsweise eine Änderung an der virtualhosts-Konfiguration in der overrides-Datei vornehmen, wenden Sie diese mit dem folgenden Befehl auf den Cluster an:

apigeectl apply -f my-overrides.yaml --settings virtualhosts -c runtime

Beispiele

Clusterkonfiguration initialisieren

Wenden Sie die erforderlichen Komponentenkonfigurationen mit init auf Ihren Cluster an. Sie müssen den Befehl init vor apply ausführen. 

apigeectl init -f my_overrides.yaml

Clusterkonfiguration anwenden

Mit dem Befehl apply können Sie Hybrid-Konfigurationen auf Ihren Kubernetes-Cluster anwenden. Wenn Sie apply zum ersten Mal ausführen, werden alle Hybrid-Laufzeitkomponenten in Ihrem Cluster erstellt. Wenn Sie Konfigurationsänderungen vornehmen, führen Sie apply noch einmal aus, um nur die Änderungen zu übernehmen, oder verwenden Sie -c, um nur eine bestimmte Komponente anzuwenden.

Im folgenden Beispiel wird die Konfiguration für Komponenten der Hybrid-Laufzeitebene auf Ihren Cluster angewendet:

apigeectl apply -f my_overrides.yaml

Konfiguration auf eine einzelne Komponente anwenden

Wenn Sie den apply-Befehl auf eine bestimmte Komponente beschränken möchten, verwenden Sie das Flag -c, wie unter apigeectl-Flags beschrieben.

Im folgenden Beispiel wird nur die Konfiguration für die Synchronizer-Komponente angewendet:

apigeectl apply -c synchronizer -f my_overrides.yaml

Im folgenden Beispiel wird nur die Konfiguration für die Cassandra- und Laufzeitkomponenten angewendet:

apigeectl apply -c cassandra,runtime -f my_overrides.yaml

Konfiguration in eine Datei ausgeben

Wenn Sie ein Installationsproblem beheben, empfiehlt es sich, die gesamte Clusterkonfiguration in eine Datei auszugeben, damit Sie die Konfigurationseinstellungen prüfen können. Das Flag --print-yaml gibt die Hybridkonfiguration an stdout aus. Mit dem Flag --dry-run wird der Befehl ausgeführt, ohne Änderungen am Cluster vorzunehmen.

apigeectl apply -f my_overrides.yaml --dry-run --print-yaml > apigee-hybrid.yaml

Pod-Status prüfen

Im folgenden Beispiel wird der Status der in dem Cluster bereitgestellten Pods geprüft:

apigeectl check-ready
All containers ready in namespace 'my-namespace'

Hybrid aus dem Cluster löschen

Im folgenden Beispiel werden nur die Hybrid-Laufzeitkomponenten in Ihrem Kubernetes-Cluster gelöscht. Um alles zu löschen, verwenden Sie das Flag --all.

apigeectl delete -f my_overrides.yaml