시작하기 전에

ACM 애드온을 설치하기 전에 다음 필수 단계와 정보를 검토하세요.

1. 클러스터가 다음 요구 사항을 충족하는지 확인하십시오.
   • 허브 클러스터는 RHCOS를 실행하는 작업자 노드 3개 이상과 최소 6개의 VCPU 및 64GB RAM이 있는 VPC 클러스터여야 합니다. 고가용성을 위해 클러스터에 3개 영역에 걸쳐 영역당 작업자 노드가 하나 이상 있어야 합니다.
   • 각 관리형 클러스터에는 RHCOS를 실행하는 작업자 노드가 3개 이상 있어야 하며, 최소 6개의 VCPU와 64GB RAM이 있어야 합니다.
2. ACM 애드온에 의해 자동으로 설치되는 연산자와 개선 사항으로 설치할 수 있는 선택적 연산자를 검토하세요.
3. IBM Cloud Kubernetes Service 에서 클러스터에 대한 관리자 플랫폼 액세스 역할과 관리자 서비스 액세스 역할이 있어야 합니다.
4. 최소 3개의 워커 노드가 포함된 VPC 클러스터가 있어야 합니다. 각 워커 노드는 최소 4개의 CPU와 16GB 의 RAM을 갖추어야 합니다. 고가용성을 위해 클러스터에 3개 영역에 걸쳐 영역당 작업자 노드가 하나 이상 있어야 합니다.
5. 클러스터에서 ACM에 사용할 신뢰할 수 있는 프로필을 만듭니다.
6. ACM으로 관리하려는 각 클러스터에 대해, 관리되는 클러스터의 액세스 토큰과 서버 URL 를 사용하여 허브 클러스터에 시크릿을 만들어야 합니다. 이 단계는 설치 전이나 후에 완료할 수 있습니다. ACM용 비밀 번호 준비하기를 참조하세요.
7. CLI를 설치하거나 업데이트합니다.

ACM을 위한 신뢰할 수 있는 프로필 만들기

다음 단계에 따라 ACM에서 사용할 신뢰할 수 있는 프로필을 생성하고, 이를 허브 클러스터에 할당하십시오.

클러스터에 신뢰할 수 있는 프로필을 추가하면, 이를 제거할 수 없으며 해당 리소스에 대해 API 키를 다시 사용할 수 없습니다. 신뢰할 수 있는 프로필이 올바르게 설정되도록 다음 단계를 주의 깊게 따르시기 바랍니다.

ACM을 위한 비밀 준비

ACM으로 관리하려는 각 클러스터에 대해 관리되는 클러스터의 액세스 토큰과 서버를 포함하는 시크릿을 허브 클러스터에 만들어야 합니다( URL ).

ACM 애드온 설치 프로세스 중에 관리되는 클러스터를 가져오려면 설치를 시작하기 전에 다음 단계를 완료하세요. 허브 클러스터에 애드온을 설치한 후에 비밀을 만들고 관리되는 클러스터를 가져오기로 선택한 경우에는 CLI로 추가 단계를 완료하여 이 작업을 수행할 수 있습니다.

관리하려는 각 클러스터에 대해 다음 단계를 수행하십시오.

1. ACM으로 관리하려는 클러스터에서 다음 명령을 실행하여 서버를 찾습니다. URL. 출력에서 마스터 URL 값을 찾아서 기록합니다. 시크릿에서 참조할 서버는 URL 입니다. 또한 다음 단계에서 이 URL 도 사용하게 됩니다.

   ibmcloud oc cluster get -c CLUSTER_NAME_OR_ID
   

   출력 예.

   NAME:                           mycluster
   ID:                             1234567
   State:                          normal
   Created:                        2025-01-22T19:22:16+0000
   Location:                       dal10
   Master URL:                     https://c100-e.<region>.containers.cloud.ibm.com:<port>
   ...
   

2. Red Hat OpenShift OAuth 서버의 기본 URL 를 가져옵니다. MASTER_URL 을 이전 단계에서 확인한 URL 으로 대체하십시오. 이 명령은 /oauth/token 접미사를 제외한 기본 주소 URL 를 추출합니다.

   curl -sS MASTER_URL/.well-known/oauth-authorization-server | jq -r .token_endpoint | sed 's#/oauth/token##'
   

   출력 예.

   https://c111-e.us-east.containers.cloud.ibm.com:31282
   

3. 이전 단계에서 확인한 엔드포인트를 사용하여 액세스 토큰을 가져옵니다. 다음 cURL 명령을 실행하되, URL 을 이전 단계의 출력 결과로, API_KEY 을 본인의 [IBM Cloud API 키](https://cloud.ibm.com/iam/apikeys){: external}으로 대체하십시오. 출력 결과에서 Location 응답 에 포함된 ACCESS_TOKEN 을 찾아보세요. 비밀에 포함할 액세스 토큰입니다.

   curl 요청 예:

   curl -u 'apikey:API_KEY' -H "X-CSRF-Token: a" 'URL/oauth/authorize?client_id=openshift-challenging-client&response_type=token' -vvv
   

   출력 예. ACCESS_TOKEN은 Location 응답 문자열에 포함되어 있습니다.

   < HTTP/1.1 302 Found
   < Cache-Control: no-cache, no-store, max-age=0, must-revalidate
   < Cache-Control: no-cache, no-store, max-age=0, must-revalidate
   < Expires: 0
   < Expires: Fri, 01 Jan 2030 00:00:00 GMT
   < Location: TOKEN_ENDPOINT/oauth/token/implicit#access_token=ACCESS_TOKEN&expires_in=86400&scope=user%3Afull&token_type=Bearer
   ...
   

4. 허브 클러스터에서 클러스터 액세스 토큰과 서버가 포함된 비밀을 만듭니다 URL. 비밀 번호 생성에 대한 자세한 내용은 Kubernetes 문서에서 비밀 번호로 작업하기를 참조하세요.

   비밀 예시.

   apiVersion: v1
   kind: Secret
   metadata:
     name: SECRET_NAME
     namespace: SECRET_NAMESPACE  # The namespace that the secret is to be created in
   type: Opaque
   stringData:
     token: ACCESS_TOKEN
     server: SERVER_URL
   

ACM 운영자

ACM 애드온에 의해 자동으로 설치되는 연산자와 개선 사항으로 설치할 수 있는 선택적 연산자를 검토하세요.

ACM을 설치한 후 관리되는 클러스터 가져오기

ACM으로 관리할 클러스터를 가져오는 방법에는 여러 가지가 있습니다. 클러스터를 가져오기 전에 ACM에 필요한 비밀번호를 만들었는지 확인하세요.

ACM으로 관리되는 모든 클러스터는 클러스터 세트에 속해야 합니다. 새 클러스터 집합을 만들거나 Default 클러스터 집합에 클러스터를 추가할 수 있습니다. 클러스터 집합을 지정하지 않으면 관리되는 클러스터가 Default 옵션에 추가됩니다.

관리형 클러스터 업데이트 또는 제거하기

ACM 인스턴스에서 관리형 클러스터를 제거하거나 업데이트하려면 허브 클러스터에서 ACM 사용자 지정 리소스의 managedClusters 섹션을 편집해야 합니다.

1. 명령을 실행하여 ACM 리소스를 편집합니다.

   oc edit acmhub RESOURCE_NAME
   

2. 리소스의 managedClusters 섹션에서 클러스터 ID, ACM용으로 만든 클러스터 비밀 이름, 비밀의 네임스페이스, 클러스터에 대해 구현하려는 작업을 추가합니다. 서식 지정은 아래 예시를 참조하세요. 작업의 경우 Delete 또는 Update 을 지정합니다. 클러스터를 삭제하려면 시크릿 또는 시크릿 네임스페이스가 필요하지 않습니다.

   다음 예제는 cluster_id_1 을 삭제하고 cluster_id_2 을 업데이트합니다.

   managedclusters:
     - clusterid: "cluster_id_1"
       action: "Delete"
     - clusterid: "cluster_id_2"
       secretname: "managed-secret-2"
       secretnamespace: "managed-namespace-2" # The namespace that the secret was created in
       action: "Update"
   

3. 변경을 저장하고 적용하십시오.

ACM 버전 업그레이드하기

명령을 실행하여 애드온을 새 버전으로 업그레이드합니다.

ibmcloud oc cluster addon update acm --cluster CLUSTER_ID --version ADD-ON_VERSION

애드온이 업데이트되었는지 확인하려면 클러스터 애드온을 나열하세요. 출력에서 ACM 애드온 세부 정보를 찾습니다.

ibmcloud oc cluster addon ls --cluster CLUSTER_ID

ACM 애드온 삭제하기

ACM 애드온을 삭제하려면 다음 단계를 따르세요.

1. 허브 클러스터에서 ACM 리소스를 삭제합니다.

   oc delete acmhub RESOURCE_NAME
   

2. 리소스가 삭제된 후 ACM 애드온을 제거합니다. 동일한 클러스터 ID를 지정합니다.

   ibmcloud oc cluster addon disable acm -f --cluster CLUSTER_ID