Amazon Elastic Kubernetes Service の PSA のアップグレード

プライベート合成エージェントのアップグレード

PSA をアップグレードするには、次の手順を実行します。

Docker イメージのプル
（オプション）カスタム Python ライブラリの追加
イメージのタグ付けとレジストリへのプッシュ
Helm チャートの更新
PSA のアップグレード

Docker イメージのプル

DockerHub から sum-chrome-agent、sum-api-monitoring-agent、sum-heimdall の既成の Docker イメージをプルします。既成イメージには依存ライブラリが含まれているため、インターネットにアクセスできない場合でもこれらのイメージを使用できます。

次のコマンドを実行して、エージェントイメージをプルします。

docker pull appdynamics/heimdall-psa

docker pull appdynamics/chrome-agent-psa

docker pull appdynamics/api-monitoring-agent-psa

CODE

カスタム Python ライブラリの追加

この手順は任意です。使用可能な標準ライブラリセットに加えて、スクリプト測定で使用するカスタム Python ライブラリをエージェントに追加できます。ベースイメージとしてロードしたイメージに基づいて新しいイメージをビルドします。

Dockerfile を作成してから、python pip を実行する RUN ディレクティブを作成します。たとえば、algorithms ライブラリをインストールするには、次のように Dockerfile を作成します。
```
# Use the sum-chrome-agent image we just loaded as the base image
FROM sum-chrome-agent:<agent-tag>
   
# Install algorithm for python3 on top of that
RUN python3 -m pip install algorithms==0.1.4
 
# We can add more RUN directives for installing more libraries
# RUN python3 -m pip install ...
```
CODE
任意の数の RUN ディレクティブを作成して、必要なライブラリをインストールできます。
新しいイメージを作成するには、次のコマンドを実行します。
Web Monitoring PSA：
```
docker build -t sum-chrome-agent:<agent-tag> - < Dockerfile
```
CODE
API Monitoring PSA：
```
docker build -f Dockerfile-PSA -t sum-api-monitoring-agent:<agent-tag> .
```
CODE
Kubernetes クラスタノードと同じ OS タイプのホストでイメージをビルドする必要があります。たとえば、イメージを AWS にプッシュする場合は、次のコマンドを実行します。
```
docker buildx build -f Dockerfile-PSA --platform=linux/amd64 -t sum-api-monitoring-agent:<api-tag> .
```
CODE
新しくビルドされたエージェントイメージには、必要なライブラリが含まれています。

イメージのタグ付けとレジストリへのプッシュ

EKS や AKS などのマネージド Kubernetes サービスは、イメージをプッシュできるコンテナレジストリを提供します。その他の設定は必要ありません。EKS または AKS 内の Kubernetes クラスタは、これらのイメージにアクセスできます。

クラスタがアクセスできるように、イメージにタグを付けてレジストリにプッシュする必要があります。Amazon EKS クラスタは、AWS が提供するマネージドレジストリである Elastic Container Registry（ECR）からイメージをプルします。

Vanilla K8S は AWS インフラストラクチャで実行されるため、Kubernetes Operations（kops）が適切なロールを作成してクラスタノードに割り当て、それらは ECR に直接アクセスできます。その他の設定は必要ありません。そのため、プロセスは、EC2 を使用する EKS と Vanilla K8S の両方で同じです。

イメージにタグを付けるには、次のように入力します。

docker tag sum-heimdall:<heimdall-tag> <aws_account_id>.dkr.ecr.<region>.amazonaws.com/sum/sum-heimdall:<heimdall-tag>
docker tag sum-chrome-agent:<agent-tag> <aws_account_id>.dkr.ecr.<region>.amazonaws.com/sum/sum-chrome-agent:<agent-tag>
docker tag sum-api-monitoring-agent:<agent-tag> <aws_account_id>.dkr.ecr.<region>.amazonaws.com/sum/sum-api-monitoring-agent:<agent-tag>

CODE

<aws_account_id> と <region> をアカウント ID とリージョンの値に置き換える必要があります。

リポジトリを作成するには、次のように入力します。

aws ecr create-repository --repository-name sum/sum-heimdall
aws ecr create-repository --repository-name sum/sum-chrome-agent
aws ecr create-repository --repository-name sum/sum-api-monitoring-agent

CODE

イメージをプッシュするには、次のように入力します。

aws ecr get-login-password --region us-west-2 | docker login --username AWS --password-stdin <aws_account_id>.dkr.ecr.<region>.amazonaws.com
docker push <aws_account_id>.dkr.ecr.<region>.amazonaws.com/sum/sum-heimdall:<heimdall-tag>
docker push <aws_account_id>.dkr.ecr.<region>.amazonaws.com/sum/sum-chrome-agent:<agent-tag>
docker push <aws_account_id>.dkr.ecr.<region>.amazonaws.com/sum/sum-api-monitoring-agent:<agent-tag>

CODE

Helm チャートの更新

次の手順に従って、values.yaml ファイル内の設定キーと値のペアを更新します。

PSA のアップグレード

PSA 23.12 以降、Ignite と Heimdall を「measurement」という名前の単一の名前空間に展開する必要があります。

新しい Linux ディストリビューションフォルダに移動して、次のコマンドを実行します。
```
helm install synth ignite-psa.tgz --values values-ignite.yaml --namespace measurement
```
CODE
Ignite ポッドのステータスが runningに変わるまで待ちます。その後、次のコマンドを実行します。
```
helm upgrade heimdall-onprem sum-psa-heimdall.tgz --values values.yaml --namespace measurement
```
CODE
新しい Heimdall と Ignite ポッドのステータスが running に変更されたら、古い Ignite 名前空間をアンインストールします。
```
helm uninstall synth -n ignite
```
CODE