이 페이지 개선에 도움 주기

이 사용자 가이드에 기여하려면 모든 페이지의 오른쪽 창에 있는 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를 클러스터 이름으로 바꾸며 capability-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를 클러스터 이름으로 바꾸며 capability-name을 삭제한 기능 이름으로 바꿉니다.

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

다음 단계