Apigee Hybrid aktualisieren

Upgrade auf eine neue Version ausführen

So führen Sie ein Upgrade von Apigee Hybrid auf eine neue Version aus:

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

Laden Sie die Version von apigeectl herunter, für die Sie ein Upgrade durchführen möchten:

Laden Sie das Release-Paket für Ihr Betriebssystem herunter:

Mac 64-Bit:

curl -LO \
    https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/version_number/apigeectl_mac_64.tar.gz

Linux 64-Bit

curl -LO \
    https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/version_number/apigeectl_linux_64.tar.gz

Mac 32-Bit:

curl -LO \
    https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/version_number/apigeectl_mac_32.tar.gz

Linux 32-Bit

curl -LO \
    https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/version_number/apigeectl_linux_32.tar.gz

Ermitteln Sie das Basisinstallationsverzeichnis, das bei der ursprünglichen Installation von Apigee Hybrid erstellt wurde. Das Basisverzeichnis ist das Verzeichnis, in dem sich das Verzeichnis $APIGEEGTL_HOME befindet. Im folgenden Beispiel ist das Basisverzeichnis /Users/myhome/hybrid:
```
echo $APIGEECTL_HOME
/Users/myhome/hybrid/apigeectl
```
Extrahieren Sie die heruntergeladenen gzip-Dateiinhalte in das Apigee Hybrid-Basisverzeichnis:
```
tar xvzf filename.tar.gz -C path-to-base-directory
```
cd zum Basisverzeichnis.
Die TAR-Inhalte werden standardmäßig in ein Verzeichnis mit der Version und der Plattform in ihrem Namen erweitert. Beispiel: ./apigeectl_1.2.0-f7b96a8_linux_64.
Benennen Sie das aktuelle apigeectl-Verzeichnis um. Wenn die aktuelle Version beispielsweise 1.1.1 ist, benennen Sie das Verzeichnis apigeectl in apigeectl_1.1.1 um.
Benennen Sie das neu extrahierte Installationsverzeichnis in apigeectl um. Hier verweist die Umgebung $APIGEECTL_HOME auf diese Umgebung.
Bereinigen Sie abgeschlossene Jobs für den Namespace der Hybridlaufzeit. Dabei ist namespace der Namespace, der in der Überschreibungsdatei angegeben ist, wenn Sie einen Namespace angegeben haben. Wenn nicht, ist der Standard-Namespace apigee:
```
kubectl delete job -n namespace \
  $(kubectl get job -n namespace -o=jsonpath='{.items[?(@.status.succeeded==1)].metadata.name}')
```

Bereinigen Sie abgeschlossene Jobs für den Namespace apigee-system:

kubectl delete job -n apigee-system \
  $(kubectl get job -n apigee-system -o=jsonpath='{.items[?(@.status.succeeded==1)].metadata.name}')

Bereinigen Sie abgeschlossene Jobs für den Namespace istio-system:

kubectl delete job -n istio-system \
  $(kubectl get job -n istio-system -o=jsonpath='{.items[?(@.status.succeeded==1)].metadata.name}')

Initialisieren Sie apigeectl für die neue Version:

$APIGEECTL_HOME/apigeectl init -f my-overrides.yaml

Prüfen Sie, ob die Initialisierung abgeschlossen ist:

$APIGEECTL_HOME/apigeectl check-ready -f my-overrides.yaml

Bei check-ready-Ausführung führen Sie apigeectl apply aus:
```
$APIGEECTL_HOME/apigeectl apply -f my-overrides.yaml
```
Führen Sie check-ready noch einmal aus, um zu ermitteln, wann das Upgrade abgeschlossen ist.

So führen Sie ein Rollback für ein vorheriges Upgrade durch:

Abgeschlossene Jobs bereinigen:

kubectl delete job -n namespace $(kubectl get job -n namespace -o=jsonpath='{.items[?(@.status.succeeded==1)].metadata.name}')

Führen Sie im Stammverzeichnis der Installation, zu der Sie ein Rollback durchführen möchten, apigeectl init und dann apigeectl apply aus.
```
  $APIGEECTL_HOME/apigeectl init -f my-overrides.yaml
  $APIGEECTL_HOME/apigeectl apply -f my-overrides.yaml
```