このページの改善にご協力ください

このユーザーガイドに貢献するには、すべてのページの右側のペインにある「GitHub でこのページを編集する」リンクを選択してください。

機能リソースの使用

このトピックでは、すべての機能タイプで機能リソースを管理するための一般的なオペレーションについて説明します。

EKS 機能リソース

EKS 機能は、Amazon EKS クラスターでマネージド機能を有効にする AWS リソースです。機能は EKS で実行されるため、コントローラーやその他の運用コンポーネントをワーカーノードにインストールして維持する必要がありません。機能は、特定の EKS クラスター用に作成され、ライフサイクル全体でそのクラスターと関連付けられます。

各機能リソースには、次のものがあります。

機能ステータスについて

機能リソースには、現在の状態を示すステータスがあります。機能のステータスとヘルスは、EKS コンソールまたは AWS CLI を使用して表示できます。

コンソール:

AWS CLI:

aws eks describe-capability \
  --region region-code \
  --cluster-name my-cluster \
  --capability-name my-capability-name

機能ステータス

CREATING: 機能のセットアップ中です。コンソールから移動できます。この機能はバックグラウンドで引き続き作成されます。

ACTIVE: 機能の実行中ですぐに使用できるようになります。リソースが想定どおりに動作しない場合は、リソースのステータスと IAM アクセス許可を確認してください。ガイダンスについては、「EKS 機能をトラブルシューティングする」を参照してください。

UPDATING: 設定変更の適用中です。ステータスが ACTIVE に戻るまで待ちます。

DELETING: クラスターから機能を削除中です。

CREATE_FAILED: セットアップでエラーが発生しました。一般的な原因には、以下が含まれます。

特定のエラーの詳細については、機能ヘルスセクションを確認してください。

UPDATE_FAILED: 設定の更新に失敗しました。機能ヘルスセクションで詳細を確認し、IAM アクセス許可を検証します。

機能を作成する

クラスターに機能を作成するには、以下のトピックを参照してください。

機能を一覧表示する

クラスター上のすべての機能リソースを一覧表示できます。

コンソール

AWS CLI

list-capabilities コマンドを使用して、クラスター上のすべての機能を表示します。region-code はクラスターがある AWS リージョンに、my-cluster はクラスターの名前に置き換えます。

aws eks list-capabilities \
  --region region-code \
  --cluster-name my-cluster
         

{
    "capabilities": [
        {
            "capabilityName": "my-ack",
            "arn": "arn:aws:eks:us-west-2:111122223333:capability/my-cluster/ack/my-ack/abc123",
            "type": "ACK",
            "status": "ACTIVE",
            "createdAt": "2025-11-02T10:30:00.000000-07:00",
            "modifiedAt": "2025-11-02T10:32:15.000000-07:00",
        },
        {
            "capabilityName": "my-kro",
            "arn": "arn:aws:eks:us-west-2:111122223333:capability/my-cluster/kro/my-kro/abc123",
            "type": "KRO",
            "status": "ACTIVE",
            "version": "v0.6.3",
            "createdAt": "2025-11-02T10:30:00.000000-07:00",
            "modifiedAt": "2025-11-02T10:32:15.000000-07:00",
        },
        {
            "capabilityName": "my-argocd",
            "arn": "arn:aws:eks:us-west-2:111122223333:capability/my-cluster/argocd/my-argocd/abc123",
            "type": "ARGOCD",
            "status": "ACTIVE",
            "version": "3.1.8-eks-1",
            "createdAt": "2025-11-21T08:22:28.486000-05:00",
            "modifiedAt": "2025-11-21T08:22:28.486000-05:00"
        }
    ]
}

機能の説明

設定やステータスなど、特定の機能に関する詳細情報を取得します。

コンソール

AWS CLI

describe-capability コマンドを使用して、詳細情報を表示します。region-code をクラスターがある AWS リージョンに、my-cluster をクラスターの名前に、capacity-name を機能名 (ack、argocd、または kro) に置き換えます。

aws eks describe-capability \
  --region region-code \
  --cluster-name my-cluster \
  --capability-name capability-name
         

出力例:

{
  "capability": {
    "capabilityName": "my-ack",
    "capabilityArn": "arn:aws:eks:us-west-2:111122223333:capability/my-cluster/ack/my-ack/abc123",
    "clusterName": "my-cluster",
    "type": "ACK",
    "roleArn": "arn:aws:iam::111122223333:role/AmazonEKSCapabilityACKRole",
    "status": "ACTIVE",
    "configuration": {},
    "tags": {},
    "health": {
      "issues": []
    },
    "createdAt": "2025-11-19T17:11:30.242000-05:00",
    "modifiedAt": "2025-11-19T17:11:30.242000-05:00",
    "deletePropagationPolicy": "RETAIN"
  }
}

機能の設定を更新する

機能の設定の一部は、作成後に更新できます。使用できる設定オプションは、機能タイプによって異なります。

AWS CLI

update-capability コマンドを使用して機能を変更します。

aws eks update-capability \
  --region region-code \
  --cluster-name my-cluster \
  --capability-name capability-name \
  --role-arn arn:aws:iam::[.replaceable]111122223333:role/NewCapabilityRole
         

機能を削除する

クラスター上で機能が不要になった場合は、機能リソースを削除できます。

コンソール

AWS CLI

delete-capability コマンドを使用して、機能リソースを削除します。

region-code をクラスターがある AWS リージョンに、my-cluster をクラスターの名前に、capacity-name を削除する機能名に置き換えます。

aws eks delete-capability \
  --region region-code \
  --cluster-name my-cluster \
  --capability-name capability-name
         

次のステップ