Apigee ハイブリッドのアップグレード

新しいバージョンへのアップグレード

Apigee ハイブリッドを新しいバージョンにアップグレードするには、次の手順に従います。

新しいバージョンの `apigeectl` をダウンロードしてインストールする

apigeectl は Kubernetes クラスタに Apigee ハイブリッドをインストールして管理するためのコマンドラインインターフェース（CLI）です。

アップグレードするバージョンの apigeectl をダウンロードします。

ご使用のオペレーティングシステムに対応したリリースパッケージをダウンロードします。

Mac 64 ビット:

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

Linux 64 ビット

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

Mac 32 ビット:

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

Linux 32 ビット

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

Apigee ハイブリッドの初回インストール時に作成されたインストールのベースディレクトリを特定します。ベースディレクトリは、$APIGEEGTL_HOME ディレクトリがあるディレクトリです。次の例では、ベースディレクトリは /Users/myhome/hybrid になります。
```
echo $APIGEECTL_HOME
/Users/myhome/hybrid/apigeectl
```
ダウンロードした gzip ファイルの内容を Apigee ハイブリッドのベースディレクトリに展開します。
```
tar xvzf filename.tar.gz -C path-to-base-directory
```
cd でベースディレクトリに移動します。
デフォルトでは、tar の内容が展開されるディレクトリの名前には、バージョンとプラットフォームが含まれます。例: ./apigeectl_1.2.0-f7b96a8_linux_64。
現在の apigeectl ディレクトリ名を変更します。たとえば、現在のバージョンが 1.1.1 の場合は、apigeectl ディレクトリの名前を apigeectl_1.1.1 に変更します。
新しく展開したインストールディレクトリの名前を apigeectl に変更します。これで、環境 $APIGEECTL_HOME でこのディレクトリが参照されるようになりました。
ハイブリッドのランタイム名前空間の完了済みジョブをクリーンアップします。ここで、名前空間を指定した場合、namespace はオーバーライドファイルで指定した名前空間になります。指定しない場合、デフォルトの名前空間は apigee です。
```
kubectl delete job -n namespace \
  $(kubectl get job -n namespace -o=jsonpath='{.items[?(@.status.succeeded==1)].metadata.name}')
```

apigee-system 名前空間の完了したジョブをクリーンアップします。

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

istio-system 名前空間の完了したジョブをクリーンアップします。

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

cd で ./hybrid-files ディレクトリに移動します。
新しいバージョンの apigeectl を初期化します。
```
$APIGEECTL_HOME/apigeectl init -f my-overrides.yaml
```
次のコマンドを実行して、初期化が完了したことを確認します。
```
$APIGEECTL_HOME/apigeectl check-ready -f my-overrides.yaml
```
check-ready が正常に終了したら、apigeectl apply を実行します。
```
$APIGEECTL_HOME/apigeectl apply -f my-overrides.yaml
```
check-ready を再実行して、アップグレードが完了したことを確認します。

アップグレードのロールバック

以前のアップグレードをロールバックする手順は次のとおりです。

完了済みジョブをクリーンアップします。

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

ロールバックするインストールのルートディレクトリで apigeectl init を実行し、続いて apigeectl apply を実行します。
```
  $APIGEECTL_HOME/apigeectl init -f my-overrides.yaml
  $APIGEECTL_HOME/apigeectl apply -f my-overrides.yaml
```