ARMS エージェントのバージョンを指定する - Application Real-Time Monitoring Service

ack-onepilot コンポーネントは、Kubernetes クラスターにおける Application Real-Time Monitoring Service (ARMS) エージェントの自動更新を管理します。自動更新ではなく特定のエージェントバージョンを維持するには、このガイドを使用してエージェントバージョンをロックします。テスト環境で検証が成功したら、すべてのアプリケーションで段階的にエージェントバージョンを更新します。

ソリューション 1 (推奨): エージェントバージョンを手動で指定する

必要なack-onepilotバージョン

ack-onepilot は V3.0.17 以降である必要があります。

Container Service for Kubernetes (ACK) クラスタの ack-onepilot バージョンを表示するには、ACK コンソールに移動し、[アドオン] をクリックし、ack-onepilot を見つけて、そのバージョンを確認します。バージョンが要件を満たしていない場合は、[アップグレード] をクリックして更新します。

アプリケーション YAML ファイルのラベルフィールドを変更することにより、エージェントバージョンを指定します。この操作により、ARMS エージェントの自動更新がオーバーライドされ、指定されたバージョンのエージェントが使用されるようになります。

ARMSコンソールにログオンします。左側のナビゲーションペインで、アプリケーション監視 > エージェント管理 > エージェントリリースノートを選択して、利用可能なオンラインエージェントバージョンを表示します。最新バージョンを選択することをお勧めします。
エージェントオンラインステータスタブで、アプリケーションの現在のエージェントバージョンを確認し、必要に応じてロールバックします。
アプリケーションのエージェントバージョンを指定します。
説明
方法1と方法2、または方法1と方法3の両方を使用する場合、方法2または方法3で指定されたバージョンは、方法1で指定されたバージョンよりも優先されます。
- 方法 1：アプリケーション YAML ファイルを変更します。aliyun.com/agent-version: Agent バージョンを labels更新フィールドに追加し、をクリックします。アプリケーションは変更を適用するために自動的に再起動します。
  この変更は、現在のアプリケーションにのみ有効です。他のアプリケーションの場合は、それに応じて YAML ファイルを変更します。
  ack-onepilot コンポーネントが V3.3.0 以降の場合は、aliyun.com/agent-version の下に次のラベルを追加することにより、プログレッシブアップデートモードでエージェントバージョンを制御できます。
```
aliyun.com/enable-progressive-update: 'true'
```
  説明
  プログレッシブアップデートモードで ACK クラスターにワークロード (Deployment または StateSet) を再デプロイすると、1 ～ 2 つのインスタンスのエージェントのみが aliyun.com/agent-version で指定されたバージョンに更新されます。他のインスタンスにインストールされているエージェントのバージョンは変更されません。
  アプリケーションワークロードに含まれるレプリカが 3 つ未満の場合、プログレッシブアップデートは有効になりません。エージェントバージョンを指定しても、すべてのレプリカが指定されたバージョンに更新されるわけではありません。この場合、ワークロードのプログレッシブアップデートを有効にしないことをお勧めします。
- 方法 2: Enterprise Distributed Application Service (EDAS) コンソールで Kubernetes クラスターにアプリケーションをデプロイする場合、[詳細設定] タブの [監視およびガバナンス構成] セクションでエージェントバージョンを指定します。
  説明
  利用可能なエージェントバージョンを調整するには、EDASテクニカルサポートにお問い合わせください。
- 方法 3: EDAS API の InsertK8sApplication または DeployK8sApplication 操作を呼び出すことによって、Kubernetes クラスターでアプリケーションが作成またはデプロイされる場合、CustomAgentVersion パラメーターを使用してアプリケーションのエージェントバージョンを指定できます。
他のアプリケーションのエージェントを更新する前に、テスト環境で指定されたエージェントバージョンを確認します。
新しいエージェントバージョンで問題が発生した場合は、手順3の操作を実行して、エージェントバージョンをロールバックできます。

ソリューション 2: テクニカルサポートに連絡してエージェントバージョンを指定する

3.0.17 より前の ack-onepilot バージョン、または手動による YAML 変更が必要な環境の場合は、バージョンロックを使用して、非推奨またはサポートされていないバージョンのエージェントを最新バージョンに移行します。

テスト環境で更新を確認するアプリケーションを選択します。 ARMS テクニカルサポートに連絡して、アプリケーションのロックされたエージェントバージョンを最新バージョンに更新します。更新が完了したら、アプリケーションを再起動して更新を確認します。
新しいバージョンがテスト環境で検証されたら、ARMS テクニカルサポートに連絡して、更新が必要なクラスターのバッチでロックされたエージェントを更新します。新しいオンラインバージョンが有効になったら、アプリケーションをバッチで再起動します。