PSP からポッド・セキュリティー・アドミッションへのマイグレーション
バージョン 1.25 以降を実行するクラスターでは 、Pod Security Admission が Pod Security Policies (PSPs) に置き換わります。 PSPの設定によっては、クラスタをバージョン から 1.24 へアップグレード 1.25 する前に、特定の操作が必要になる場合があります。
バージョン 1.24 から 1.25にアップグレードするには、クラスターが特定の PSP 構成要件を満たしている必要があります。 クラスターがこれらの要件を満たしていない場合、アップグレードはブロックされます。 カスタム PSP を確認して削除するには、以下の手順を実行します。
- クラスター内の PSP をカスタマイズまたは変更していない場合、クラスターをアップグレードする可能性があります。 ただし、クラスターをアップグレードする前に、要件を検討して、PSP 構成を変更する必要がないことを確認することをお勧めします。
- クラスター内の PSP をカスタマイズまたは変更した場合(独自の PSP の作成、PSP を作成するアプリケーションのインストール、特定の PSP の使用を制限するためのクラスター役割バインディングの変更など)、クラスターをアップグレードするための要件を満たすようにセットアップを変更する 必要があります。
開始する前に、ドキュメント Kubernetes 内の 「Pod Security Admissionが適切かどうかを判断する」 セクションに記載されている情報を確認し、PSPとPod Security Admissionの違いについて理解を深めてください。
アップグレード要件
クラスターのセットアップが以下の要件を満たしている場合は、クラスターをアップグレードできます。 これらの要件により、バージョン 1.25を実行するクラスターで提供されるデフォルトのポッド・セキュリティー・アドミッション構成の下でポッドが正しく実行されるようになります。 これらの要件が満たされていない場合、追加のマイグレーション・ステップを実行しない限り、クラスターをアップグレードすることはできません。
- すべてのポッドは
ibm-privileged-pspPSP の下で実行されます。 privileged-psp-userクラスター役割バインディングは、デフォルト構成を使用します。restricted-psp-userクラスター役割バインディングは、デフォルト構成を使用します。- IBM Cloud によって提供される以下の PSP のみが存在し、追加の PSP は構成されません。
ibm-privileged-pspibm-anyuid-pspibm-anyuid-hostpath-pspibm-anyuid-hostaccess-pspibm-restricted-psp
クラスターがこれらの要件を満たしている場合、ポッドは特権ポッドを許可する PSP を使用します。 ただし、これらの要件を満たしても、すべてのポッドが特権を持つことを意味するわけではありません。
独自の PSP を作成した場合、PSP を作成するインストール済みアプリケーションを作成した場合、または ibm-privileged-psp の使用を制限するためにクラスター役割バインディングを変更した場合は、クラスターをアップグレードする前に、リストされている要件を満たすようにセットアップを変更する必要があります。 サード・パーティーのセキュリティー・ポリシー・アドミッション・コントローラーを使用する場合でも、PSP 構成内ですべてのコントローラーが正しく機能する限り、クラスターはこれらの要件を満たすことができます。
クラスター PSP 構成が要件を満たしていることを確認するには、以下のステップを実行します。 すべての要件が満たされている場合は、クラスターをバージョン 1.25にアップグレードできます。
ステップ 1: すべてのポッドが ibm-privileged-psp PSP の下で実行されていることを確認する
以下のステップを実行して、すべてのポッドが ibm-privileged-psp PSP の下で実行されるようにします。
ポッド・セキュリティー・アドミッションと PodSecurityPolicies の違いの 1 つとして、ポッド・セキュリティー・アドミッションは検証中ですが、 PodSecurityPolicies はミュータブルにすることができます。 これにより、アップグレードする前にポッドが ibm-privileged-psp(ミュータブル PSP ではない) を使用することが重要になります。 ポッド・セキュリティー・アドミッションと
ibm-privileged-psp は両方とも検証中であるため、ポッドはどちらでも同じように動作します。
例えば、ポッドが現在 ibm-restricted-psp の下で実行されている場合、PSP 内の MustRunAs 範囲に基づいて、ポッドの securityContext セクションで fsGroup および supplementalGroups を 1 に設定できます。 ibm-restricted-psp はポッド securityContext を変更することができる。 このような変更は、実行中のポッドの securityContext と、ポッドを作成するデプロイメント・リソースまたは類似リソースのポッド・テンプレート内の securityContext との差として表示されます。 ibm-privileged-psp はミュータブルではないため、その下で実行されているポッドは異なるグループで実行され、既存の
PVC に保管されているデータにアクセスできない可能性があります。
-
すべてのポッドの詳細を取得し、それらの PSP を確認します。
kubectl get pods -A -o jsonpath="{.items[*].metadata.annotations.kubernetes\.io\/psp}" | tr " " "\n" | sort -u -
ibm-privileged-psp以外の PSP のコマンド出力を確認します。 ポッドが別の PSP を使用している場合は、クラスターをアップグレードする前に、ibm-privileged-pspを使用するようにアプリケーションを更新する必要があります。 他の PSP がリストされていない場合は、アップグレードを続行できます。
出力に PSP ibm-privileged-psp 以外の PSP がリストされている場合、 へのアップグレードは 1.25 推奨されません。
ステップ 2: privileged-psp-user クラスター役割バインディングがデフォルト構成を使用していることを確認する
以下のステップを実行して、 privileged-psp-user クラスター役割バインディングがデフォルト構成を使用していることを確認します。 これにより、すべてのサービス・アカウントおよびユーザーに、 privileged-psp-user クラスター役割バインディングを介して ibm-restricted-psp を使用する権限が付与されます。
クラスターロールバインディングが、以下の例に示されているとおりに正確に subjects デフォルトの role および を持たない場合、 へのアップ 1.25 グレードは失敗します。
-
privileged-psp-userクラスター役割バインディングの詳細を取得します。kubectl get clusterrolebinding privileged-psp-user -o yaml -
出力の
roleおよびsubjectsを確認します。 出力が以下の例と異なる場合は、 1.25にアップグレードしないでください。privileged-psp-userクラスター役割バインディングが以下の例と一致する場合は、アップグレードを続行できます。apiVersion: rbac.authorization.k8s.io/v1 kind: ClusterRoleBinding metadata: creationTimestamp: "2022-10-06T20:12:36Z" name: privileged-psp-user resourceVersion: "151862" uid: 15014736-94d2-4cba-a3a8-92dd36de453b roleRef: apiGroup: rbac.authorization.k8s.io kind: ClusterRole name: ibm-privileged-psp-user subjects: - apiGroup: rbac.authorization.k8s.io kind: Group name: system:masters - apiGroup: rbac.authorization.k8s.io kind: Group name: system:nodes - apiGroup: rbac.authorization.k8s.io kind: Group name: system:serviceaccounts - apiGroup: rbac.authorization.k8s.io kind: Group name: system:authenticated
ステップ 3: restricted-psp-user クラスター役割バインディングがデフォルト構成を使用していることを確認する
以下のステップを実行して、 restricted-psp-user クラスター役割バインディングがデフォルト構成を使用していることを確認します。 これにより、すべてのサービス・アカウントおよびユーザーに、 restricted-psp-user クラスター役割バインディングを介して ibm-restricted-psp を使用する権限が付与されます。
クラスターロールのバインディングに、以下の例に示すようにデフォルト subjects の role および が含まれていない場合、 へのアップ 1.25 グレードは失敗します。
-
restricted-psp-userクラスター役割バインディングの詳細を取得します。kubectl get clusterrolebinding restricted-psp-user -o yaml -
コマンドの出力を確認します。 以下の例に示すように、クラスター役割バインディングに
roleおよびsubjectsのデフォルト設定が含まれていない場合は、クラスターをバージョン 1.25 にアップグレードしないでください。apiVersion: rbac.authorization.k8s.io/v1 kind: ClusterRoleBinding metadata: creationTimestamp: "2022-10-06T20:13:10Z" name: restricted-psp-user resourceVersion: "151890" uid: 4edb362f-9933-48d7-95e2-f41cd9f4dead roleRef: apiGroup: rbac.authorization.k8s.io kind: ClusterRole name: ibm-restricted-psp-user subjects: - apiGroup: rbac.authorization.k8s.io kind: Group name: system:masters - apiGroup: rbac.authorization.k8s.io kind: Group name: system:nodes - apiGroup: rbac.authorization.k8s.io kind: Group name: system:serviceaccounts - apiGroup: rbac.authorization.k8s.io kind: Group name: system:authenticated
ステップ 4:IBM 以外の PSP の確認
以下のステップを実行して、クラスターがIBM 以外の PSP を使用しているかどうかを確認します。
バージョンへのアップグレードは、コマンド出力が 1.25 以下の例に追加のPSPを含んでいる場合に失敗します。 サード・パーティー・アプリケーションからの追加 PSP があり、それらのアプリケーションに使用する適切なアップグレード戦略を決定するために、アプリケーションの更新またはアプリケーション・ベンダーとの連携が必要になる場合があります。
-
ポッド・セキュリティー・ポリシーをリストします。
kubectl get podsecuritypolicies -o name -
コマンドの出力を確認します。
Warning: policy/v1beta1 PodSecurityPolicy is deprecated in v1.21+, unavailable in v1.25+ podsecuritypolicy.policy/ibm-anyuid-hostaccess-psp podsecuritypolicy.policy/ibm-anyuid-hostpath-psp podsecuritypolicy.policy/ibm-anyuid-psp podsecuritypolicy.policy/ibm-privileged-psp podsecuritypolicy.policy/ibm-restricted-psp -
IBM PSP を使用するようにアプリを更新します。
マイグレーション手順
クラスター・ポッドのセキュリティー構成が マイグレーションの前提条件 を満たしていないと判断した場合は、以下のマイグレーション・ステップに従ってクラスターをアップグレードする必要があります。
以下のPodセキュリティ移行手順のいくつかには、ドキュメント Kubernetes 内のセクションへのリンクが含まれています。 外部 Kubernetes ドキュメントに記載されている手順のすべてがクラスタ IBM Cloud Kubernetes Service に適用されるわけではないことに注意してください このページから直接リンクされているステップのみに従ってください。 外部 Kubernetes 移行ガイドのすべてに従わないでください。クラスタ IBM Cloud Kubernetes Service には不適切な操作が含まれているためです。 以下のステップを注意深く読み、クラスターに対して正しいマイグレーション・アクションを実行するようにしてください。
ステップ 1: 1.24 クラスターでポッド・セキュリティー・アドミッションを有効にする
1.24 クラスターでポッド・セキュリティー・アドミッションを有効にします。 このコマンドは、新しいポッド・セキュリティー・アドミッション構成を使用するようにクラスター・マスターを更新します。 クラスタマスターの更新には数分かかる場合があります。
ibmcloud ks cluster master pod-security set --cluster <CLUSTER>
ステップ 2: 名前空間のアクセス権を確認する
外部 Kubernetes の資料で名前空間の許可を確認してください。 Kubernetes の権限が IAM サービス・ロールによって管理されている場合、ネームスペースの作成または編集とポッド・セキュリティ・ラベルの設定には Manager サービス・ロールが必要です。
ステップ 3: PSP の簡素化と標準化
外部 Kubernetes 資料の手順に従って、ポッド・セキュリティー構成をクリーンアップします。 PSP ibm-privileged-psp、 ibm-anyuid-psp、 ibm-anyuid-hostpath-psp、 ibm-anyuid-hostaccess-psp 、および ibm-restricted-psp のいずれも変更または削除
しないでください。
ステップ 4: クラスター内の名前空間を更新する
外部 Kubernetes 資料の手順に従って、クラスター内の名前空間を更新します。 これらのステップは、 IBM Cloudによって管理されていないクラスター内のすべての名前空間で実行する必要があります。 このセクションに含まれている例外に注意してください。
以下の名前空間で管理されているPodセキュリティラベルを削除 IBM Cloud または変更しないでください: kube-system, ibm-system, ibm-operators.
ステップ 3.d. このステップでリンクされている外部ドキュメントのバイパ PodSecurity スポリシーに従い、提案されている特権PSPを作成しないでください。 この追加のPSPを作成した場合、 アップグレード 要件に記載されている通り、 1.25 バージョン にアップグレードする前に削除する必要があります。 代わりに、コマンド kubectl create -n $NAMESPACE rolebinding disable-psp --clusterrole ibm-privileged-psp-user --group system:serviceaccounts:$NAMESPACE を使用して、 ibm-privileged-psp-user クラスター役割に対する RoleBinding を作成します。
ステップ 5: 名前空間作成プロセスの確認
外部 Kubernetes 資料の情報を参照して、クラスター内に作成された新しい名前空間にポッド・セキュリティー・プロファイルが適用されていることを確認します。
ステップ 6: オプション。 クラスター内の PSP 機能を無効にします。
- クラスター内の
PodSecurityPolicyアドミッション・コントローラーを無効にします。 このコマンドは、新しい構成を使用するようにクラスター・マスターを更新します。ibmcloud ks cluster master pod-security policy disable --cluster <cluster> - クラスター・マスターの更新が完了するまで数分待ちます。
- PSP と、関連する
Roles、ClusterRoles、RoleBindings、およびClusterRoleBindingsを削除します。 削除するコンポーネントによって、他の場所で必要になる可能性がある他の関連のない権限が付与されないようにしてください。 PSPibm-privileged-psp、ibm-anyuid-psp、ibm-anyuid-hostpath-psp、ibm-anyuid-hostaccess-psp、およびibm-restricted-pspは削除 しないでください。ClusterRolesおよびClusterRoleBindings(privileged-psp-userおよびrestricted-psp-user) を削除 しないでください。
クラスタ 1.24 でPSPを再度有効にする必要がある場合は、. を実行してください ibmcloud ks cluster master pod-security policy enable --cluster <cluster>。 このコマンドは、PSP 構成を使用するようにクラスター・マスターを更新します。
ステップ 7: オプション。 クラスターのアップグレード
クラスターを少なくともバージョン にアップグレード 1.25 して、Pod セキュリティアドミッションを使用してください。 または、アップグレードの準備が整うまで、Pod Security Admissionを有効にした状態でクラ 1.24 スターをバージョンに維持してください。
参照
ポッド・セキュリティー・ポリシーからポッド・セキュリティー・アドミッションにマイグレーションする前に、以下の情報を確認してください。 一部のアクションは IBM Cloud Kubernetes Service クラスターには適切でないため、現状のままマイグレーション・ガイドに 従わないでください。