オペレータのアップグレード
Contrastエージェントオペレータは、セマンティックバージョニングに従います。
メジャーバージョンには、オペレーターAPIへの重大な変更が含まれる場合があります。メジャーバージョンのアップグレードでは、マニフェストが変更されていたり、既存のCRDの更新が必要な場合があるため注意が必要です。マイナーバージョンには新機能が含まれていますが、完全な後方互換性があり既存のクラスタに適用しても安全です。新しい機能を使用するために、オプションのマニフェストの変更が必要な場合があります。パッチにはセキュリティおよびバグフィックスが含まれており、完全な後方互換性があるため既存のクラスタに安全に適用することができます。マニフェストの変更は必要ありません。
Contrastでは、以下の形式でイメージタグを公開しています。
:2 :2.1 :2.1.10 :latest
ここで、:2は2.X.Xセマンティックバージョンブランチの最新リリースを表します。アップグレードを簡素化するために、リスク許容度に基づいて接頭辞のバージョンを使用することもできます(imagePullPolicyがAlwaysに設定されていることを確認してください)。
注記
Contrastエージェントオペレータは、複数のレプリカとリーダーリースを使用する可用性の高い構成をサポートしていますが、すべてのオペレータインスタンスが同じバージョンを長期間実行しているデプロイメントのみをサポートします。imagePullPolicyオプションを使用して、複数のインスタンスを同じバージョンに維持しないでください。自動アップグレードが必要な場合は、Keelなどのオペレータを使用して安全にアップグレードすることをお勧めします。
マイナーおよびパッチアップグレード
新しいバージョンへのアップグレードは、新しいクラスタにインストールするのと同じ手順で行います。クラスタ管理者としてkubectl(Kubernetes)またはoc(OpenShift)を使用して以下を実行し、オペレータマニフェストを適用します。
kubectl apply -f https://github.com/Contrast-Security-OSS/agent-operator/releases/latest/download/install-prod.yaml
oc apply -f https://github.com/Contrast-Security-OSS/agent-operator/releases/latest/download/install-prod.yaml
メジャーアップグレード
メジャーアップグレードには、マニフェストの追加変更が含まれる場合があります。contrast-agent-operatorネームスペースのみを削除すれば、インストールされたCRD(さらにクラスタ構成も)は維持されます。
kubectl delete namespace contrast-agent-operator kubectl apply -f https://github.com/Contrast-Security-OSS/agent-operator/releases/latest/download/install-prod.yaml
oc delete project contrast-agent-operator oc apply -f https://github.com/Contrast-Security-OSS/agent-operator/releases/latest/download/install-prod.yaml
ここでの一般的な手順はほとんどのメジャーアップグレードで有効ですが、メジャーアップグレードを確実に行うためにはリリースノートに記載される移行手順がある場合には、その手順に従ってください。