ACK と ECS での MSE ガバナンスエージェントバージョンのピン留め - MSE

Microservices Engine (MSE) は、デフォルトで最新の安定版エージェントバージョンを使用します。環境間の一貫性を維持したり、テスト済みのリリースに固定したり、アップグレードのタイミングを制御したりするために、エージェントを特定のバージョンに固定できます。

方法は、デプロイメント環境によって異なります。

環境	方法	概要
Container Service for Kubernetes (ACK)	Pod ラベル	デプロイメント YAML に `aliyun.com/agent-version` を追加
Elastic Compute Service (ECS)	手動ダウンロード	特定のエージェントパッケージをダウンロードし、手動で設定

現在のエージェントバージョンの確認

MSE コンソールにログインし、上部のナビゲーションバーでリージョンを選択します。
左側のナビゲーションウィンドウで、[マイクロサービスガバナンス] > [アプリケーションガバナンス] を選択します。
[アプリケーションリスト] ページで、対象アプリケーションのリソースカードをクリックします。
左側のナビゲーションウィンドウで、Node details をクリックします。
All Nodes セクションで、対象のノードをクリックします。Basic Information タブの Probe Version 列でバージョンを確認します。

Agent version displayed in the Probe Version column

ACK (ack-onepilot) でのエージェントバージョンの指定

この方法は、アプリケーションが ack-onepilot コンポーネントを使用して ACK 上で実行されている場合に使用します。

前提条件

ack-onepilot コンポーネントのバージョンが 3.0.16 以降であること。インストールされているバージョンが 3.0.16 以前の場合は、「マイクロサービスガバナンスコンポーネントのインストールと更新」に従ってアップグレードしてください。

エージェントバージョンの固定

デプロイメント YAML の Pod spec に aliyun.com/agent-version ラベルを追加します。次の例では、エージェントをバージョン 4.2.5 に固定しています。

spec:
  template:
    metadata:
      labels:
        aliyun.com/agent-version: "4.2.5"
        mseNamespace: "default"                # MSE マイクロサービスの名前空間
        msePilotCreateAppName: "<yourAppName>"  # ご利用のアプリケーション名に置き換えてください

次の表にラベルの説明を示します。

ラベル	説明	必須
`aliyun.com/agent-version`	使用するエージェントのバージョン (例： `4.2.5`)。省略した場合、MSE は最新の安定版を使用します。	いいえ
`mseNamespace`	アプリケーションが属する MSE マイクロサービスの名前空間	はい
`msePilotCreateAppName`	MSE に登録されているアプリケーション名	はい

説明

バージョンを指定する前に、以下のいずれかのエンドポイントからエージェントパッケージをダウンロードして、そのバージョンが存在することを確認してください。

パブリックエンドポイント： http://arms-apm-${regionId}.oss-${regionId}.aliyuncs.com/${agentVersion}/ArmsAgent.zip
内部エンドポイント： http://arms-apm-${regionId}.oss-${regionId}-internal.aliyuncs.com/${agentVersion}/ArmsAgent.zip

利用可能なバージョンの一覧については、「Java エージェントのバージョン」をご参照ください。

デフォルトの動作 (最新の安定版) に戻すには、aliyun.com/agent-version ラベルを削除してアプリケーションを再起動します。

結果の確認

更新されたデプロイメントを適用してアプリケーションを再起動した後、上記の「現在のエージェントバージョンの確認」セクションで説明したように、Node details ページでエージェントのバージョンを確認します。

Confirming the agent version after restart

ECS でのエージェントバージョンの指定

アプリケーションが ECS インスタンス上で実行されている場合は、対象バージョンのエージェントパッケージをダウンロードし、手動でマイクロサービスガバナンスを有効にします。完全な設定手順については、「ECS インスタンス上のマイクロサービスアプリケーションでマイクロサービスガバナンスを有効にする」をご参照ください。

エージェントパッケージのダウンロード

以下のいずれかのエンドポイントからエージェントパッケージをダウンロードします。

パブリックエンドポイント： http://arms-apm-${regionId}.oss-${regionId}.aliyuncs.com/${agentVersion}/ArmsAgent.zip
内部エンドポイント： http://arms-apm-${regionId}.oss-${regionId}-internal.aliyuncs.com/${agentVersion}/ArmsAgent.zip

プレースホルダーを実際の値に置き換えてください。

プレースホルダー	説明	例
`${regionId}`	アプリケーションがデプロイされているリージョン ID	`cn-hangzhou`、`ap-southeast-1`
`${agentVersion}`	対象のエージェントバージョン	`4.2.5`

説明

Virtual Private Cloud (VPC) 環境では内部エンドポイントを、VPC 以外の環境ではパブリックエンドポイントを使用してください。サポートされているリージョンについては、「サポートされているリージョン」をご参照ください。利用可能なエージェントバージョンについては、「Java エージェントのバージョン」をご参照ください。

説明

中国東部 1 Finance リージョンのアプリケーション用のエージェントパッケージをダウンロードするには、してください。