新しいバージョンへのアップグレード
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