Red Hat Summit1.8.15. ClusterClaims
ClusterClaim は、マネージドクラスター上のカスタムリソース定義 (CRD) です。ClusterClaim は、マネージドクラスターが要求する情報の一部を表します。ClusterClaim を使用して、ターゲットクラスター上のリソースの Placement を決定できます。
次の例は、YAML ファイルで指定された ClusterClaim を示しています。
apiVersion: cluster.open-cluster-management.io/v1alpha1
kind: ClusterClaim
metadata:
name: id.openshift.io
spec:
value: 95f91f25-d7a2-4fc3-9237-2ef633d8451c
次の表は、multicluster engine Operator が管理するクラスターの定義済み ClusterClaim のリストを示しています。
| 要求名 | 予約 | 変更可能 | 説明 |
|---|---|---|---|
|
| true | false | アップストリームの提案で定義された ClusterID |
|
| true | true | Kubernetes バージョン |
|
| true | false | マネージドクラスターが実行されているプラットフォーム (AWS、GCE、Equinix Metal など) |
|
| true | false | 製品名 (OpenShift、Anthos、EKS、GKE など) |
|
| false | false | OpenShift Container Platform クラスターでのみ利用できる OpenShift Container Platform 外部 ID |
|
| false | true | OpenShift Container Platform クラスターでのみ利用できる管理コンソールの URL |
|
| false | true | OpenShift Container Platform クラスターでのみ利用できる OpenShift Container Platform バージョン |
マネージドクラスターで以前の要求が削除されるか、更新されると、自動的に復元またはロールバックされます。
マネージドクラスターがハブクラスターに参加すると、マネージドクラスター上に作成された次の 2 種類の ClusterClaim リソースが、ハブクラスター上の ManagedCluster リソースのステータスと同期されます。open-cluster-management.io/spoke-only ラベルを持つ ClusterClaim リソースは同期されません。
- multicluster engine Operator が管理する
ClusterClaimリソース -
接尾辞が
id.k8s.io、またはopen-cluster-management.ioまたはopenshift.ioのラベルが含まれます。これらのClusterClaimリソースは、ハブクラスターのManagedClusterステータスに同期されます。 - 管理する
ClusterClaimリソース -
open-cluster-management.ioまたはopenshift.ioの接尾辞なし。デフォルトでは、最大 20 個のClusterClaimリソースがハブクラスターのManagedClusterステータスに同期されます。管理する同期対象のClusterClaimリソースの数を変更するには、KlusterletConfigAPI を設定します。以下の手順を実行します。
ClusterClaim リソースを管理している場合は、同期される ClusterClaim リソースの数を変更するように KlusterletConfig API を設定します。以下の手順を実行します。
KlusterletConfigを作成し、clusterClaimConfiguration.maxCustomClusterClaimsを任意の値に設定します。最大値は100です。以下の例を参照してください。kind: KlusterletConfig apiVersion: config.open-cluster-management.io/v1alpha1 metadata: name: klusterlet-cluster-claim-config spec: clusterClaimConfiguration: maxCustomClusterClaims: 30ManagedClusterリソース内のKlusterletConfigを参照するためのアノテーションを追加します。以下のコマンドを実行します。oc annotate managedcluster <cluster-name> agent.open-cluster-management.io/klusterlet-config="klusterlet-cluster-claim-config"アノテーションを追加すると、
ManagedClusterリソースは次の例のようになります。apiVersion: cluster.open-cluster-management.io/v1 kind: ManagedCluster metadata: annotations: agent.open-cluster-management.io/klusterlet-config: klusterlet-cluster-claim-config name: cluster1 spec: hubAcceptsClient: true leaseDurationSeconds: 60
1.8.15.1. カスタム ClusterClaims の作成
カスタム名を持つ ClusterClaim リソースをマネージドクラスターに作成すると、リソースを識別しやすくなります。カスタムの ClusterClaim リソースは、ハブクラスター上の ManagedCluster リソースのステータスと同期されます。以下のコンテンツでは、カスタマイズされた ClusterClaim リソースの定義例を示しています。
apiVersion: cluster.open-cluster-management.io/v1alpha1
kind: ClusterClaim
metadata:
name: <custom_claim_name>
spec:
value: <custom_claim_value>
spec.value フィールドの長さは 1024 以下である必要があります。ClusterClaim リソースを作成するには clusterclaims.cluster.open-cluster-management.io リソースの create 権限が必要です。
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}