huawei-cloud-ucs-cluster-onboarding-manager

Huawei Cloud UCS クラスターオンボーディングマネージャー

概要

このスキルでは、hcloud CLI を使用して、Huawei Cloud UCS（Ubiquitous Cloud Native Service）のクラスターのオンボーディング、ライフサイクル、フリートグループ管理の機能を提供します。

アーキテクチャ：hcloud CLI → UCS Service API → Cluster/ClusterGroup/AccessConfig/KubeConfig リソース

関連スキル：

• huawei-cloud-ucs-policy-governor - UCS のポリシーガバナンス、コンプライアンス、監査管理

機能：

• セルフマネージドクラスターまたは CCE クラスターを UCS に登録し、一元管理する
• UCS の管理対象からクラスターを削除する（登録解除）
• クラスターの詳細を照会し、管理対象クラスターを一覧表示する
• クラスターのプロパティとメタデータを更新する
• クラスターを整理するためのフリートグループを作成、削除、更新、照会する
• フリートグループへのクラスターの追加／削除（参加／離脱）
• クラスターのアクティベーションを再試行する
• クラスターのアクセス情報と kubeconfig 認証情報を取得する
• マルチクラスターアクセス用のフェデレーション kubeconfig をダウンロードする
• UCS のリソースクォータを確認する

一般的なユースケース：

• 「CCE クラスターを UCS に登録する」
• 「UCS が管理するすべてのクラスターを一覧表示する」
• 「UCS の管理対象からクラスターを削除する」
• 「本番クラスター用のフリートグループを作成する」
• 「UCS が管理するクラスターの kubeconfig を取得する」
• 「マルチクラスターアクセス用のフェデレーション kubeconfig をダウンロードする」
• 「UCS のクォータ使用状況を確認する」
• 「クラスターのメタデータを更新する」
• 「クラスターのアクセス情報を照会する」
• 「フリートグループにクラスターを追加する」
• 「フリートグループからクラスターを削除する」
• 「クラスターのアクティベーションを再試行する」

前提条件

1. hcloud CLI の要件（必須）

• hcloud CLI がインストールされていること（バージョン >= 7.2.2）
• hcloud version を実行してインストールを確認する
• 初回使用時：プライバシーに関する声明に同意するため、printf "y\n" | hcloud version を実行する

2. 認証情報の設定

hcloud CLI は環境変数を介した 2 つの認証情報モードをサポートしており、実行時に自動で検出されます。

モード A — 長期 AK/SK（恒久的なアクセス）：

export HUAWEI_CLOUD_AK=<your-ak>
export HUAWEI_CLOUD_SK=<your-sk>
export HUAWEI_CLOUD_REGION=cn-north-4

モード B — 一時 AK/SK + SecurityToken（一時的なアクセスまたは委任アクセスに推奨）：

export HUAWEI_CLOUD_AK=<your-temp-ak>
export HUAWEI_CLOUD_SK=<your-temp-sk>
export HUAWEI_CLOUD_SECURITY_TOKEN=<your-security-token>
export HUAWEI_CLOUD_REGION=cn-north-4

HUAWEI_CLOUD_SECURITY_TOKEN が設定されている場合、hcloud CLI は一時認証情報による認証を自動的に使用します。AK/SK のみが設定されている場合は、長期認証情報による認証を使用します。

• セキュリティルール：
  • 🚫 AK/SK/SecurityToken の値をコード、会話、コマンド内で絶対に公開しないでください
  • 🚫 認証情報の確認に echo $HUAWEI_CLOUD_AK または echo $HUAWEI_CLOUD_SK を絶対に使用しないでください
  • ✅ 環境変数 HUAWEI_CLOUD_AK、HUAWEI_CLOUD_SK、HUAWEI_CLOUD_REGION、HUAWEI_CLOUD_SECURITY_TOKEN を使用してください
  • ✅ クラウド操作にはルートアカウントより IAM ユーザーを優先してください
  • ✅ 機密性の高い操作では MFA を有効にしてください

⚠️ 重要なセキュリティ上の注意事項：

• 認証情報をバージョン管理に絶対にコミットしないでください
• 必要最小限の権限を持つ IAM ユーザーを使用してください
• 機密性の高い操作では MFA を有効にしてください
• AK/SK を定期的にローテーションしてください

3. K8s バージョンの互換性（非常に重要）

⚠️ UCS には、サポートされる Kubernetes バージョンの上限があります。 デフォルト設定で作成した CCE クラスターは、UCS のサポート範囲を超えるバージョンを使用している場合があります。サポート対象外のバージョンを登録すると、エラー UCS.01030012: Register cce cluster error - cce cluster version not support in UCS service が発生し、登録に失敗します（確認済み：CCE はデフォルトで v1.35 を作成しますが、2025-07 時点で UCS がサポートするのは v1.34 までです）。バージョン番号をハードコードせず、必ずサポート対象バージョンを動的に照会してください。UCS のサポート範囲は随時更新されます。

hcloud UCS ListRegisteredClusterVersions --cli-region=cn-north-4

登録前のバージョン確認：

# List unimported CCE clusters to check their versions
hcloud UCS ListManagedClusters --unimported=true --cli-region=cn-north-4

# Or check specific CCE cluster version via CCE API
hcloud CCE ShowCluster --clusterid=<cce-cluster-id> --cli-region=cn-north-4

クラスターの K8s バージョンが UCS のサポート範囲を超えている場合は、次のいずれかを行ってください。

• CCE クラスターの K8s バージョンを UCS のサポート範囲内にダウングレードする、または
• UCS が新しいバージョンをサポートするまで待つ

4. IAM 権限要件

API アクション	権限	目的
ucs:cluster:create	クラスターの登録	UCS にクラスターを登録する
ucs:cluster:delete	クラスターの削除	UCS からクラスターを削除する
ucs:cluster:get	クラスターの取得	クラスターの詳細を表示する
ucs:cluster:list	クラスターの一覧	管理対象のすべてのクラスターを一覧表示する
ucs:cluster:update	クラスターの更新	クラスターのプロパティを変更する
ucs:clusterGroup:create	グループの作成	フリートグループを作成する
ucs:clusterGroup:delete	グループの削除	フリートグループを削除する
ucs:clusterGroup:get	グループの取得	フリートグループの詳細を表示する
ucs:clusterGroup:update	グループの更新	フリートグループの説明を更新する
ucs:clusterAccess:get	アクセス情報の取得	クラスターのアクセス情報を取得する
ucs:quota:get	クォータの取得	UCS リソースのクォータを確認する
ucs:kubeconfig:create	kubeconfig の作成	クラスターの kubeconfig を取得する
ucs:federationKubeconfig:get	フェデレーションの取得	フェデレーションの kubeconfig をダウンロードする

完全なポリシー JSON については、IAM 権限ポリシーを参照してください。

権限エラーへの対応：

1. 権限エラーによってコマンドが失敗した場合は、references/iam-policies.md を読み取ります
2. 必要な権限の一覧とポリシー JSON をユーザーに表示します
3. IAM コンソールでカスタムポリシーを作成し、承認を付与するようユーザーに案内します
4. 実行を一時停止し、権限が付与されたことをユーザーが確認するまで待ちます

主なコマンド

1. クラスターの登録と登録解除

詳細なワークフローについては、タスク：クラスターの登録を参照してください。

RegisterCluster では、Kubernetes API 形式のパラメーター（apiVersion、kind、metadata.、spec.）を使用します。

# Register a CCE cluster to UCS (⚠️ paid service: requires user confirmation)
# **Confirm with user before executing** — UCS cluster onboarding is a paid service, costs will be incurred
hcloud UCS RegisterCluster --apiVersion=v1 --kind=Cluster --metadata.name=prod-backend-cluster --spec.category=self --spec.provider=huaweicloud --spec.type=turbo --spec.manageType=discrete --spec.country=CN --spec.city=110000 --metadata.uid=<cce-cluster-id> --spec.projectID=<project-id> --spec.region=cn-north-4 --cli-region=cn-north-4

# Register a CCE cluster and assign to fleet group at registration
hcloud UCS RegisterCluster --apiVersion=v1 --kind=Cluster --metadata.name=prod-backend-cluster --spec.category=self --spec.provider=huaweicloud --spec.type=turbo --spec.manageType=discrete --spec.country=CN --spec.city=110000 --metadata.uid=<cce-cluster-id> --spec.projectID=<project-id> --spec.region=cn-north-4 --spec.clusterGroupID=<group-id> --cli-region=cn-north-4

# Register a self-managed/attached cluster
hcloud UCS RegisterCluster --apiVersion=v1 --kind=Cluster --metadata.name=datacenter-k8s --spec.category=onpremise --spec.provider=self_managed --spec.type=Kubernetes --spec.manageType=discrete --spec.country=CN --spec.city=110000 --metadata.annotations.kubeconfig=<kubeconfig-yaml-content> --cli-region=cn-north-4

# Retry cluster activation (if registration stuck)
hcloud UCS RetryClusterActivation --clusterid=<ucs-cluster-id> --cli-region=cn-north-4

# Remove a cluster from UCS (⚠️ destructive: requires user confirmation)
# **Confirm with user before executing** — deregistration is irreversible
hcloud UCS DeleteCluster --clusterid=<ucs-cluster-id> --cli-region=cn-north-4

クラスターのカテゴリ（spec.category）：

• self：Huawei Cloud CCE（Cloud Container Engine）の管理対象クラスター
  • UCS は内部ネットワーク経由で CCE API に直接アクセスします。プロキシエージェントは不要です
  • CCE API の CreateKubernetesClusterCert を使用して kubeconfig を取得します（UCS の CreateClusterKubeconfig は使用しません）
  • ShowClusterAccessInfo は UCS.01030011 を返します。このカテゴリではサポートされていません
  • RetryClusterActivation は UCS.01000011 を返します。このカテゴリではサポートされていません
  • 注：CCE クラスターの spec.category は Turbo ですが、UCS の ListManagedClusters は category=self、type=turbo を返します
• onpremise：セルフマネージドまたはサードパーティの Kubernetes クラスター
  • クラスターと UCS の間にトンネルを確立するには、プロキシエージェントのデプロイが必要です
  • ShowClusterAccessInfo を使用してプロキシエージェントの構成を取得し、プロキシエージェントをデプロイします
  • プロキシエージェントの起動後、CreateClusterKubeconfig を使用して kubeconfig を取得します

kubeconfig 取得の判断ツリー（API テストで検証済み）：

Need cluster kubeconfig?
├── category=self (CCE cluster)
│   └── CCE CreateKubernetesClusterCert --cluster_id=<cce-cluster-id> --duration=30
│       (CCE API, NOT UCS CreateClusterKubeconfig which returns internal error)
└── category=onpremise (self-managed cluster)
    ├── Step 1: ShowClusterAccessInfo --clusterid=<ucs-cluster-id>
    │   (obtain proxy-agent configuration — only for onpremise, returns UCS.01030011 for CCE)
    ├── Step 2: Deploy proxy-agent in the cluster
    └── Step 3: CreateClusterKubeconfig --clusterid=<ucs-cluster-id>
        (obtain kubeconfig after tunnel established)

クラスターのプロバイダー（spec.provider）：

• huaweicloud：Huawei Cloud の管理対象 CCE クラスター
• self_managed：セルフマネージドの Kubernetes クラスター

管理タイプ（spec.manageType）：

• grouped：フリートグループ内で管理されるクラスター
• discrete：個別に管理されるクラスター

2. クラスタのクエリとライフサイクル

# Show cluster details
hcloud UCS ShowCluster --clusterid=<ucs-cluster-id> --cli-region=cn-north-4

# List managed clusters (with pagination)
hcloud UCS ShowClusterList --limit=20 --offset=0 --cli-region=cn-north-4

# List managed clusters with filters
hcloud UCS ShowClusterList --category=CCE --enablestatus=Available --clustergroupid=<group-id> --cli-region=cn-north-4

# List all managed clusters (with optional unimported flag)
# ⚠️ Prerequisite: ListManagedClusters requires IAM agency delegation configured at account level.
# If not configured, returns UCS.01010005: get IAM agency's token error.
# See references/common-pitfalls.md Pitfall 20 for IAM agency setup instructions.
hcloud UCS ListManagedClusters --cli-region=cn-north-4
hcloud UCS ListManagedClusters --unimported=true --cli-region=cn-north-4

# Update cluster properties (K8s API-style params) (⚠️ modification: requires user confirmation)
# **Confirm with user before executing**
hcloud UCS UpdateCluster --clusterid=<ucs-cluster-id> --apiVersion=v1 --kind=Cluster --spec.city=310000 --spec.country=CN --cli-region=cn-north-4

# Show cluster access information (only for category=onpremise clusters)
hcloud UCS ShowClusterAccessInfo --clusterid=<ucs-cluster-id> --cli-region=cn-north-4

# Show cluster access information with optional filters (only for category=onpremise clusters)
hcloud UCS ShowClusterAccessInfo --clusterid=<ucs-cluster-id> --region=cn-north-4 --vpcendpoint=<vpc-id> --cli-region=cn-north-4

⚠️ ShowClusterAccessInfo は category=onpremise のクラスタにのみ適用されます。 category=self（CCE）クラスタの場合、UCS.01030011: Cluster category not supported が返されます（確認済み）。CCE クラスタの kubeconfig を取得するには、UCS の CreateClusterKubeconfig ではなく、CCE API の CreateKubernetesClusterCert を使用してください。

ShowClusterList で有効なフィルターパラメータ：

• --category：クラスタカテゴリでフィルターします（self、onpremise）
• --clustergroupid：フリートグループ ID でフィルターします
• --clusterids：特定のクラスタ ID でフィルターします
• --enablestatus：クラスタのステータスでフィルターします（Available、Unavailable）
• --managetype：管理タイプでフィルターします（grouped、discrete）
• --limit：ページネーションの上限
• --offset：ページネーションのオフセット
• --order：並べ替え順序（asc、desc）
• --order_by：並べ替えフィールド

⚠️ ShowClusterList API は --name フィルターをサポートしていません。 名前でクラスタを検索するには、名前フィルターを指定せずに ShowClusterList を呼び出し、レスポンス内の metadata.name をローカルで照合してください。

3. フリートグループの管理

詳細なワークフローについては、Task: Fleet Management を参照してください。

# Create a fleet group
hcloud UCS RegisterClusterGroup --metadata.name=production-fleet --spec.description="All production clusters" --spec.clusterIds.1=<cluster-id-1> --cli-region=cn-north-4

# List all fleet groups
hcloud UCS ListClusterGroup --limit=20 --offset=0 --cli-region=cn-north-4

# Show fleet group details
hcloud UCS ShowClusterGroup --clustergroupid=<group-id> --cli-region=cn-north-4

# Update fleet group description (⚠️ modification: requires user confirmation)
# **Confirm with user before executing**
hcloud UCS UpdateClusterGroup --clustergroupid=<group-id> --description="Updated fleet description" --cli-region=cn-north-4

# Add clusters to fleet group (⚠️ modification: requires user confirmation)
# **Confirm with user before executing**
hcloud UCS UpdateClusterGroupAssociatedClusters --clustergroupid=<group-id> --clusterIds.1=<cluster-id-1> --clusterIds.2=<cluster-id-2> --cli-region=cn-north-4

# Add a single cluster to fleet group (join)
hcloud UCS JoinGroup --clusterid=<ucs-cluster-id> --clusterGroupID=<group-id> --cli-region=cn-north-4

# Remove a cluster from fleet group (leave)
hcloud UCS LeaveGroup --clusterid=<ucs-cluster-id> --cli-region=cn-north-4

# Delete a fleet group (⚠️ destructive: requires user confirmation)
# **Confirm with user before executing** — deletion removes the group but clusters remain registered
hcloud UCS DeleteClusterGroup --clustergroupid=<group-id> --cli-region=cn-north-4

4. Kubeconfig とアクセスの管理

詳細なワークフローについては、Task: Access Management を参照してください。

# Get kubeconfig for a specific cluster (⚠️ only for category=onpremise clusters)
# For category=self (CCE) clusters, use: hcloud CCE CreateKubernetesClusterCert --cluster_id=<cce-id> --duration=30 --cli-region=cn-north-4
hcloud UCS CreateClusterKubeconfig --clusterid=<ucs-cluster-id> --cli-region=cn-north-4

# Create cluster configuration
hcloud UCS CreateClusterConf --clusterid=<ucs-cluster-id> --cli-region=cn-north-4

# Download federation kubeconfig (for multi-cluster access)
hcloud UCS DownloadFederationKubeconfig --clustergroupid=<group-id> --duration=3600 --cli-region=cn-north-4

DownloadFederationKubeconfig の必須パラメータ：

• --clustergroupid：フリートグループ ID（必須のパスパラメータ）
• --duration：トークンの有効期間（秒単位、必須の整数型ボディパラメータ）

5. クォータの管理

# Show UCS resource quotas (domainid is required - account ID)
hcloud UCS ShowQuota --domainid=<account-id> --cli-region=cn-north-4

パラメータの確認

⚠️ 費用に関する注意：UCS クラスタのオンボーディングは有料サービスです。クラスタを UCS に登録すると費用が発生します。RegisterCluster やその他のオンボーディング操作を実行する前に、費用が発生することに同意するかユーザーに確認し、実行前に明示的な同意を得る必要があります。

共通パラメータ

パラメータ	必須／任意	説明	デフォルト
--cli-region	必須	Huawei Cloud のリージョン ID	設定値または HUAWEI_CLOUD_REGION
--clusterid	状況による	UCS クラスタ ID	N/A
--clustergroupid	状況による	フリートグループ ID	N/A

クラスタ登録パラメータ（K8s API 形式）

パラメータ	必須	説明	制約
--spec.category	はい	クラスタカテゴリ	self（CCE）または onpremise（セルフ管理）
--spec.provider	はい	クラスタプロバイダー	huaweicloud または self_managed
--spec.type	はい	クラスタタイプ	cce、baremetal、Kubernetes など
--spec.manageType	はい	管理タイプ	grouped または discrete
--metadata.uid	CCE のみ	CCE クラスタ ID	既存の CCE クラスタを指定する必要があります
--spec.projectID	CCE のみ	プロジェクト ID	ListManagedClusters のレスポンスから取得
--spec.clusterGroupID	いいえ	登録時にフリートに割り当てます	有効なフリートグループ ID

書き込み操作（ユーザーの確認が必要）

操作	CLI コマンド	リスクレベル	確認事項
RegisterCluster	hcloud UCS RegisterCluster	高	UCS のオンボーディングは有料サービスです。登録後、クラスターは UCS のポリシーガバナンス制約の対象になります。クラスター名、カテゴリ、および課金への同意を確認してください。
DeleteCluster	hcloud UCS DeleteCluster	高	登録解除は取り消せません。クラスターは UCS のすべての管理機能、ポリシーガバナンス、およびフリートとの関連付けを失います。実行前にクラスター ID を確認してください。
UpdateCluster	hcloud UCS UpdateCluster	中	クラスターのプロパティ（場所、ラベルなど）を変更します。実行前に変更内容を確認してください。
RegisterClusterGroup	hcloud UCS RegisterClusterGroup	中	クラスターを編成するための新しいフリートグループを作成します。グループ名と説明を確認してください。
DeleteClusterGroup	hcloud UCS DeleteClusterGroup	高	フリートグループを削除します。クラスターの登録は維持されますが、グループレベルのガバナンスとフェデレーションアクセスを失います。実行前にグループ ID を確認してください。
UpdateClusterGroup	hcloud UCS UpdateClusterGroup	中	フリートグループの説明を変更します。新しい説明を確認してください。
JoinGroup	hcloud UCS JoinGroup	中	フリートグループへの参加は、クラスターのガバナンス範囲とポリシーの実行に影響します。クラスター ID と参加先のグループ ID を確認してください。
LeaveGroup	hcloud UCS LeaveGroup	中	フリートグループからの離脱は、クラスターのガバナンス範囲とポリシーの実行に影響し、クラスターはグループレベルのポリシーの適用対象ではなくなります。クラスター ID を確認してください。

パラメーターの一覧については、パラメーターリファレンスを参照してください。

出力形式

応答形式の詳しい例（ShowCluster、ShowClusterList、ShowQuota）については、出力形式を参照してください。

主なフィールドの概要：

• ShowCluster：metadata.uid（UUID）、spec.category（onpremise/self）、status.phase（Failed/Available）
• ShowClusterList：items[]（k8s スタイルの配列）、total（件数）
• ShowQuota：quotas.resources[] の type／quota／used／min／max

検証

検証の手順については、検証方法を参照してください。

ベストプラクティス

1. クラスター名：--metadata.name を使用し、クラスターの目的と環境を表す具体的な名前（例：prod-app-backend、staging-data-pipeline）を付けます。
2. フリートのグループ化：統一されたガバナンスを実現するため、環境（本番／ステージング／開発）またはビジネスドメイン別にクラスターを整理します。
3. Kubeconfig のセキュリティ：kubeconfig ファイルは安全に保管し、公開リポジトリや CI ログに決して公開しないでください。
4. 登録解除時の注意：UCS からクラスターを削除すると、そのクラスターのすべてのポリシーガバナンスとフェデレーションアクセスが無効になります。
5. セルフマネージドクラスターの登録：セルフマネージドクラスターの kubeconfig が有効で、クラスターの API サーバーにアクセスできることを確認します。--metadata.annotations.kubeconfig で渡してください。
6. クォータの監視：上限に達しないよう、新しいクラスターを登録する前にクォータを確認します。
7. フェデレーション kubeconfig の有効期間：使用状況に応じて、フェデレーション kubeconfig トークンの適切な --duration を選択します。

ワークフロー

スキルのワークフローは次のとおりです。

0. ⚠️ 料金の確認（必須） — 操作を実行する前に、料金が発生する可能性についてユーザーに伝え、明示的な同意を得てください。
   • UCS は有料サービスです：クラスターを UCS に登録すると、管理料金が発生します。登録後、クラスターは UCS のポリシーガバナンス上の制約を受けます。
   • ポリシーセンターの費用：クラスターでポリシーセンターを有効にすると、追加のガバナンス料金が発生する場合があります。
   • ユーザーに次の内容を確認します：「料金への影響を理解したうえで、続行しますか？（yes/no）」
   • ユーザーが明示的に同意した場合にのみ続行します。拒否された場合は、停止して操作を実行しないでください。
1. 環境の確認 — hcloud CLI がインストールされ、AK/SK 認証情報が設定されていることを確認します（CLI インストールガイドを参照）。
2. バージョン互換性の確認 — ListRegisteredClusterVersions を呼び出して UCS がサポートする K8s バージョンの一覧を取得し、対象クラスターのバージョンが一覧に含まれていることを確認します。
3. クラスターの登録 — クラスターの種類に応じて登録方法を選択します。
   • CCE クラスター：--spec.category=self --spec.provider=huaweicloud --spec.type=turbo
   • セルフマネージドクラスター：--spec.category=onpremise --spec.provider=self_managed（kubeconfig が必要です）
4. 登録の検証 — ShowCluster または ShowClusterList を呼び出し、クラスターのステータスが Available であることを確認します。
5. クラスター管理（任意）：
   • フリートのグループ化：RegisterClusterGroup / JoinGroup / LeaveGroup
   • アクセス管理：CCE クラスターでは CreateKubernetesClusterCert を使用し、サードパーティークラスターでは ShowClusterAccessInfo + proxy-agent を使用します。
   • プロパティの更新：UpdateCluster（ユーザーの確認が必要です）
6. クラスターの登録解除（任意） — DeleteCluster（⚠️ 元に戻せない操作です。ユーザーの確認が必要です）

KooCLI コマンド形式の標準

すべての操作で hcloud UCS <Operation> --<param>=<value> --cli-region=<region> 形式を使用します。詳しい例とパラメーターの命名規則については、KooCLI コマンド形式を参照してください。

参考ドキュメント

ドキュメント	説明
UCS クラスターのオンボーディング API ガイド	hcloud UCS API リファレンス
出力形式	レスポンス形式の例（検証済み）
IAM 権限ポリシー	必要な権限とポリシー JSON
検証方法	段階的な検証手順
よくある落とし穴	トラブルシューティングガイド
タスク：クラスター登録	登録および登録解除のワークフロー
タスク：フリート管理	フリートグループのワークフロー
タスク：アクセス管理	Kubeconfig とアクセス制御のワークフロー
CLI インストールガイド	hcloud CLI のインストールと設定
パラメーターリファレンス	すべての操作の完全なパラメーターテーブル
KooCLI コマンド形式	コマンド形式の標準と例
受け入れ基準	スキルの受け入れ基準とテストチェックリスト

注意事項

• K8s バージョンの互換性 — UCS でサポートされる K8s の最大バージョンは、時間の経過とともに更新されます。CCE のデフォルトクラスターのバージョンがこの上限を超える場合があります。hcloud UCS ListRegisteredClusterVersions でサポートされるバージョンを照会し、登録前にクラスターのバージョンが一覧に含まれていることを確認してください。
• クラスターの登録解除は取り消せません — クラスターは UCS のすべての管理機能を失います
• セルフマネージドクラスターの kubeconfig は有効である必要があります — 無効な kubeconfig では登録に失敗します。--metadata.annotations.kubeconfig を介して渡してください
• AK/SK をハードコードしてはいけません — 認証情報は環境変数からのみ取得してください
• サポートされる方法は hcloud CLI のみです — すべての操作で hcloud UCS <Operation> 形式を使用します
• フェデレーション kubeconfig にはフリートグループ ID と期間が必要です — --clustergroupid と --duration の両方が必須です
• RegisterCluster は K8s API 形式のパラメーターを使用します — --name／--cluster_type のようなフラットなパラメーターではありません。注：spec.category では CCE／AttachedCluster ではなく self／onpremise を使用し、spec.provider では huawei_cloud ではなく huaweicloud を使用し、spec.type では CCE ではなく小文字の cce を使用し、spec.city では Beijing のような都市名ではなく 110000 のような都市コードを使用します
• ShowQuota には domainid が必要です — アカウント／ドメイン ID は必須のパスパラメーターです

よくある落とし穴

詳しいトラブルシューティングガイドについては、よくある落とし穴と解決策を参照してください。