Schritt 4: apigeectl installieren

In diesem Schritt wird beschrieben, wie Sie apigeectl herunterladen und installieren.

`apigeectl` herunterladen und installieren

apigeectl ist die Befehlszeile zur Installation und Verwaltung von Apigee Hybrid in einem Kubernetes-Cluster.

In den folgenden Schritten wird gezeigt, wie Sie apigeectl herunterladen und installieren:

Linux

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.7.6
```

Laden Sie das Releasepaket für Ihr Betriebssystem mit dem folgendem Befehl herunter:

curl -LO \
    https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/$VERSION/apigeectl_linux_64.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 Basisverzeichnis, 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.7.6-d591b23_linux_64. Benennen Sie dieses Verzeichnis mit dem folgenden Befehl in apigeectl um:
```
mv apigeectl_1.7.6-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 Befehl apigeectl.
Prüfen Sie die Version von apigeectl mit dem Befehl version:
```
./apigeectl version
```
```
Version: 1.7.6
```
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
```

Mac OS

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)

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.7.6
```

Laden Sie das Releasepaket für Ihr Betriebssystem mit dem folgendem Befehl herunter:

curl -LO \
    https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/$VERSION/apigeectl_mac_64.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 Basisverzeichnis, 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.7.6-d591b23_mac_64. Benennen Sie dieses Verzeichnis mit dem folgenden Befehl in apigeectl um:
```
mv apigeectl_1.7.6-d591b23_mac_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 Befehl apigeectl.
Prüfen Sie die Version von apigeectl mit dem Befehl version:
```
./apigeectl version
```
```
Version: 1.7.6
```
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
```

Windows

Speichern Sie die aktuelle Versionsnummer mit dem folgenden Befehl in einer Variablen:

for /f "tokens=*" %a in ('curl -s ^
  https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/current-version.txt') ^
do set VERSION=%a

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.7.6
```

Laden Sie das Releasepaket für Ihr Betriebssystem mit dem folgendem Befehl herunter:

curl -LO ^
  https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/%VERSION%/apigeectl_windows_64.zip

Erstellen Sie ein Verzeichnis auf Ihrem System, das als Basisverzeichnis für die Installation von Apigee Hybrid verwendet wird.
Extrahieren Sie mit dem folgenden Befehl den Inhalt der heruntergeladenen ZIP-Datei in das aktuelle Verzeichnis:
```
tar xvzf filename.zip -C path-to-base-directory
```
Ändern Sie das Verzeichnis mit dem Befehl cd in das Basisverzeichnis.
Die Inhalte der TAR-Datei werden standardmäßig in ein Verzeichnis erweitert, dessen Name die Version und Plattform enthält. Beispiel: .\apigeectl_1.7.6-d591b23_windows_64. Benennen Sie dieses Verzeichnis mit dem folgenden Befehl in apigeectl um:
```
rename apigeectl_1.7.6-d591b23_windows_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 Befehl apigeectl.
Prüfen Sie die Version von apigeectl mit dem Befehl version:
```
./apigeectl version
```
```
Version: 1.7.6
```
Erstellen Sie mit dem folgenden Befehl eine Umgebungsvariable, die diesen Pfad des Basisverzeichnisses enthält:
```
set APIGEECTL_HOME=%CD%
```
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.

Linux

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 Name hybrid-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 Softwareinstallation apigeectl 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 certs
```
Erstellen Sie im Verzeichnis hybrid-files die folgenden symbolischen Links zu $APIGEECTL_HOME. Mit diesen Links können Sie den Befehl apigeectl innerhalb des Verzeichnisses hybrid-files ausführen. Nachfolgend sehen Sie ein Beispiel dafür:
Hinweis: Wenn Sie diesen Prozess bereits durchlaufen haben, sind die folgenden symbolischen Links möglicherweise bereits vorhanden. Prüfen Sie mit dem folgenden Befehl, ob die Links bereits vorhanden sind. Wenn die Verzeichnisse vorhanden sind, überspringen Sie diesen Schritt.
```
ls -l | grep ^l
```
```
ln -s $APIGEECTL_HOME/tools tools
ln -s $APIGEECTL_HOME/config config
ln -s $APIGEECTL_HOME/templates templates
ln -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
```

Mac OS

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 Name hybrid-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 Softwareinstallation apigeectl 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 certs
```
Erstellen Sie im Verzeichnis hybrid-files die folgenden symbolischen Links zu $APIGEECTL_HOME. Mit diesen Links können Sie den Befehl apigeectl innerhalb des Verzeichnisses hybrid-files ausführen. Nachfolgend sehen Sie ein Beispiel dafür:
Hinweis: Wenn Sie diesen Prozess bereits durchlaufen haben, sind die folgenden symbolischen Links möglicherweise bereits vorhanden. Prüfen Sie mit dem folgenden Befehl, ob die Links bereits vorhanden sind. Wenn die Verzeichnisse vorhanden sind, überspringen Sie diesen Schritt.
```
ls -l | grep ^l
```
```
ln -s $APIGEECTL_HOME/tools tools
ln -s $APIGEECTL_HOME/config config
ln -s $APIGEECTL_HOME/templates templates
ln -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
```

Windows

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 Name hybrid-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 Softwareinstallation apigeectl getrennt halten:
```
mkdir hybrid-files
```

Die aktuelle Verzeichnisstruktur sieht jetzt so aus:

dir

 Directory of C:\Users\example\hybrid

08/05/2021  01:38 PM    <DIR>          .
08/05/2021  01:38 PM    <DIR>          ..
08/02/2021  01:11 PM    <DIR>          apigeectl
08/02/2021  11:13 AM         5,803,963 apigeectl_1.7.6rc1-437dccc_windows_64.zip
08/05/2021  01:38 PM    <DIR>          hybrid-files

Wechseln Sie in das Verzeichnis hybrid-files.
Erstellen Sie die folgenden Unterverzeichnisse im Verzeichnis hybrid-files, um Dateien zu organisieren, die Sie später erstellen:
```
mkdir overrides
mkdir certs
```
Erstellen Sie im Verzeichnis hybrid-files die folgenden symbolischen Links zu $APIGEECTL_HOME. Mit diesen Links können Sie den Befehl apigeectl aus dem Verzeichnis hybrid-files ausführen, wie im folgenden Beispiel gezeigt.
Hinweis: Um den Befehl mklink auszuführen, benötigen Sie Administratorberechtigung auf Ihrem Windows-Computer. Führen Sie dazu das Befehlsterminal als Administrator aus oder verwenden Sie den Befehl runas. Beispiel:
```
runas /noprofile /user:mymachine\administrator "mklink /d config %APIGEECTL_HOME%\config"
```
```
mklink /d config %APIGEECTL_HOME%\config\
mklink /d plugins %APIGEECTL_HOME%\plugins\
mklink /d templates %APIGEECTL_HOME%\templates\
mklink /d tools %APIGEECTL_HOME%\tools\
```

Prüfen Sie mit dir, Symlinks ordnungsgemäß erstellt wurden:

dir

 Directory of C:\Users\example\hybrid\hybrid-files

08/05/2021  01:56 PM    <DIR>          .
08/05/2021  01:56 PM    <DIR>          ..
08/05/2021  01:46 PM    <DIR>          certs
08/05/2021  01:55 PM    <SYMLINKD>     config [C:\Users\example\hybrid\apigeectl\config\]
08/05/2021  01:46 PM    <DIR>          overrides
08/05/2021  01:56 PM    <SYMLINKD>     plugins [C:\Users\example\hybrid\apigeectl\plugins\]
08/05/2021  01:56 PM    <SYMLINKD>     templates [C:\Users\example\hybrid\apigeectl\templates\]
08/05/2021  01:56 PM    <SYMLINKD>     tools [C:\Users\example\hybrid\apigeectl\tools\]

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 8 9