In diesem Schritt wird beschrieben, wie Sie apigeectl herunterladen und installieren, Installationsverzeichnisse einrichten sowie Google Cloud-Dienstkonten und TLS-Anmeldedaten erstellen, die für das Ausführen von Apigee Hybrid erforderlich sind.
apigeectl
herunterladen und installieren
apigeectl
ist die Befehlszeile zur Installation und Verwaltung von Apigee Hybrid in einem Kubernetes-Cluster.
In den folgenden Schritten wird beschrieben, wie Sie auf apigeectl
zugreifen:
- Speichern Sie die aktuelle Versionsnummer mit dem folgenden Befehl in einer Variablen:
export VERSION=$(curl -s \ https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/current-version.txt?ignoreCache=1)
-
Prüfen Sie mit dem folgenden Befehl, ob die Variable mit einer Versionsnummer ausgefüllt wurde. Wenn Sie eine andere Version verwenden möchten, können Sie diese stattdessen in einer Umgebungsvariablen speichern.
echo $VERSION
1.4.0
-
Laden Sie das Releasepaket für Ihr Betriebssystem mit dem folgendem Befehl herunter:
Mac 64-Bit:
curl -LO \ https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/$VERSION/apigeectl_mac_64.tar.gz
Linux 64-Bit:
curl -LO \ https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/$VERSION/apigeectl_linux_64.tar.gz
Mac 32-Bit:
curl -LO \ https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/$VERSION/apigeectl_mac_32.tar.gz
Linux 32-Bit:
curl -LO \ https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/$VERSION/apigeectl_linux_32.tar.gz
- Erstellen Sie ein Verzeichnis auf Ihrem System, das als Basisverzeichnis für die Installation von Apigee Hybrid verwendet wird.
-
Extrahieren Sie den Inhalt der heruntergeladenen GZIP-Datei mit dem folgenden Befehl in das Verzeichnis, das Sie gerade erstellt haben:
tar xvzf filename.tar.gz -C path-to-base-directory
- Ändern Sie das Verzeichnis mit dem Befehl
cd
in das Basisverzeichnis. -
Die TAR-Inhalte werden standardmäßig in einem Verzeichnis gezeigt, dessen Name die Version und Plattform enthält. Beispiel:
./apigeectl_1.4.0-d591b23_linux_64
. Benennen Sie dieses Verzeichnis mit dem folgenden Befehl inapigeectl
um:mv apigeectl_1.4.0-d591b23_linux_64 apigeectl
- Wechseln Sie mit dem folgenden Befehl in das Verzeichnis:
cd ./apigeectl
Dieses Verzeichnis ist das Basisverzeichnis
apigeectl
. Hier befindet sich der ausführbare Befehlapigeectl
. - Erstellen Sie mit dem folgenden Befehl eine Umgebungsvariable, die diesen Pfad des Basisverzeichnisses enthält:
export APIGEECTL_HOME=$PWD
- Prüfen Sie mit dem folgenden Befehl, ob die Variable den richtigen Pfad enthält:
echo $APIGEECTL_HOME
Projektverzeichnisstruktur einrichten
Die folgende Verzeichnisstruktur ist ein Vorschlag. Hier wird die Apigee Hybrid-Releasesoftware von Konfigurationsdateien getrennt, die Sie erstellen müssen. Mit der Variable $APIGEECTL_HOME
und symbolischen Links, die Sie erstellen, können Sie bei Bedarf jederzeit zu einer neuen Softwareversion wechseln. Siehe auch Apigee Hybrid aktualisieren.
- Prüfen Sie mit dem folgenden Befehl, ob Sie das Basisverzeichnis (Verzeichnis, in dem sich das Verzeichnis
apigeectl
befindet) geöffnet haben:cd $APIGEECTL_HOME/..
-
Erstellen Sie mit dem folgenden Befehl einen neuen Ordner mit dem Namen
hybrid-files
. Sie können dem Verzeichnis einen beliebigen Namen geben. In der Anleitung wird jedoch der Namehybrid-files
einheitlich verwendet. Später speichern Sie Konfigurationsdateien, Dienstkontoschlüssel und TLS-Zertifikate in diesem Ordner. Außerdem können Sie in diesem Ordner Ihre Konfigurationsdateien von der Softwareinstallationapigeectl
getrennt halten:mkdir hybrid-files
- Die aktuelle Verzeichnisstruktur sieht jetzt so aus:
pwd && ls
/hybrid-base-directory apigeectl hybrid-files - Wechseln Sie mit folgendem Befehl in das Verzeichnis
hybrid-files
:cd hybrid-files
- Erstellen Sie die folgenden Unterverzeichnisse im Verzeichnis
hybrid-files
, um Dateien zu organisieren, die Sie später erstellen:mkdir overrides
mkdir service-accounts
mkdir certs
-
Erstellen Sie im Verzeichnis
hybrid-files
die folgenden symbolischen Links zu$APIGEECTL_HOME
. Mit diesen Links können Sie den Befehlapigeectl
innerhalb des Verzeichnisseshybrid-files
ausführen. Nachfolgend sehen Sie ein Beispiel dafür:ln -s
$APIGEECTL_HOME
/tools toolsln -s
$APIGEECTL_HOME
/config configln -s
$APIGEECTL_HOME
/templates templatesln -s
$APIGEECTL_HOME
/plugins plugins - Prüfen Sie, ob die Symlinks ordnungsgemäß erstellt wurden. Führen Sie dazu den folgenden Befehl aus und achten Sie darauf, dass die Linkpfade auf die richtigen Speicherorte verweisen:
ls -l | grep ^l
Sie haben nun eine Basis, in der Sie Apigee Hybrid in Ihrem Kubernetes-Cluster konfigurieren, bereitstellen und verwalten können. Als Nächstes erstellen Sie die Google Cloud-Dienstkonten und -Anmeldedaten, die zur Konfiguration von Hybrid-Laufzeitkomponenten erforderlich sind.
1 2 3 4 (WEITER) Schritt 5: Dienstkonten einrichten 6 7