사용자 지정 리소스

프로세스 생성 및 업데이트

지원되는 사용자 지정 리소스 중 하나에서 spec 필드를 변경할 때마다 Atlas Kubernetes Operator에서 다음 워크플로가 시작됩니다.

1. Atlas Kubernetes Operator는 변경된 사용자 지정 리소스에 대한 이벤트를 수신합니다.

2. Atlas Kubernetes Operator는 status.conditions 필드를 업데이트하여 리소스가 준비되지 않았음을 반영합니다.

   conditions:
   - lastTransitionTime: "2021-03-13T16:26:17Z"
     status: "False"
     type: Ready

3. Atlas 관리 API에 연결하기 위해 Atlas Kubernetes Operator는 다음 위치 중 하나에서 조직 ID 및 API 키를 읽습니다.

   • spec.connectionSecretRef.name ( AtlasProject 사용자 지정 리소스 에 지정된 경우).

     기본값 으로 Atlas Kubernetes Operator 사용자 지정 리소스와 동일한 네임스페이스 AtlasProject 에 연결 비밀을 유지합니다. 다른 네임스페이스에 시크릿을 저장 하려면 spec.connectionSecretRef.namespace 매개변수를 지정합니다.

   • global Atlas Kubernetes Operator 시크릿 <operator-deployment-name>-api-key (spec.connectionSecretRef.name 가 지정되지 않은 경우).

4. Atlas에서 리소스를 만들거나 업데이트하기 위해 Atlas Kubernetes Operator는 연결 정보를 사용하여 Atlas에 API 를 호출합니다.

   참고

   Atlas Kubernetes Operator가 사용자 지정 리소스를 조정하는 동안 Atlas에서 여러 API 호출을 수행하는 경우가 있습니다. 예를 들어AtlasProject 에는 일치하는 API 를 호출하기 위한 IP 액세스 목록 구성이 있습니다.

5. 조정 중에 오류가 발생하면 status.conditions 이 오류를 반영하도록 업데이트됩니다.

   예시

   - lastTransitionTime: "2021-03-15T14:26:44Z"
      message: 'POST https://cloud.mongodb.com/api/atlas/v1.0/groups/604a47de73cd8cag77239021/accessList:
         400 (request "INVALID_IP_ADDRESS_OR_CIDR_NOTATION") The address 192.0.2.1dfdfd5
         must be in valid IP address or CIDR notation.'
      reason: ProjectIPAccessListNotCreatedInAtlas
      status: "False"
      type: IPAccessListReady

6. 업데이트가 성공하면 status.conditions 리소스가 준비되었음을 반영합니다.

   conditions:
   - lastTransitionTime: "2021-03-13T16:26:17Z"
     status: "True"
     type: Ready

프로세스 삭제

Atlas Kubernetes Operator 2.0 부터, Kubernetes에서 사용자 지정 리소스를 삭제하면 객체는 기본적으로 Atlas에 유지되지만 Atlas Kubernetes Operator 는 더 이상 객체를 제어하지 않습니다. 전체 배포에 대해 이 기본값을 되돌리거나 특정 사용자 지정 리소스에 대한 이 기본값을 주석 으로 재정의하여 Atlas Kubernetes Operator가 Atlas에서 해당 객체를 삭제할 수 있도록 할 수 있습니다. 주석으로 재정의하면 다음 워크플로가 시작됩니다.

1. Atlas Kubernetes Operator는 삭제된 사용자 지정 리소스에 대한 이벤트를 수신합니다.

2. Atlas 관리 API에 연결하기 위해 Atlas Kubernetes Operator는 다음 위치 중 하나에서 조직 ID 및 API 키를 읽습니다.

   • spec.connectionSecretRef.name ( AtlasProject 사용자 지정 리소스 에 지정된 경우).

     기본값 으로 Atlas Kubernetes Operator AtlasProject Custom Resource(사용자 지정 리소스)와 동일한 네임스페이스 에 연결 비밀을 유지합니다. 다른 네임스페이스에 시크릿을 저장 하려면 spec.connectionSecretRef.namespace 매개변수를 지정합니다.

   • global Atlas Kubernetes Operator 시크릿 <operator-deployment-name>-api-key (spec.connectionSecretRef.name 가 지정되지 않은 경우).

3. Atlas에서 리소스를 삭제하기 위해 Atlas Kubernetes Operator는 연결 정보를 사용하여 Atlas에 API 호출합니다.

   참고

   Atlas Kubernetes Operator Kubernetes 에서 생성된 모든 관련 객체를 제거합니다. 예시 를 들어 를 AtlasDatabaseUser 제거 하면 Atlas Kubernetes Operator 관련 연결 비밀을 제거합니다.

주석을 사용하여 기본값 건너뛰기 또는 재정의하기

주석을 사용하여 Atlas Kubernetes Operator의 새로운 기본 동작 을 수정할 수 있습니다.

• 사용자 지정 리소스의 metadata 에 mongodb.com/atlas-resource-policy: "delete" 주석을 추가하는 경우, Atlas Kubernetes Operator 리소스를 삭제할 때 Atlas Kubernetes Operator도 Atlas에서 해당 객체를 삭제합니다.

  예시

  apiVersion: atlas.mongodb.com/v1
  kind: AtlasProject
  metadata:
    name: my-project
    annotations:
      mongodb.com/atlas-resource-policy: "delete"

• 새 삭제 동작을 Atlas Kubernetes Operator 2.0 이전에 사용된 기본값으로 되돌린 경우 사용자 지정 리소스의 metadata 에 mongodb.com/atlas-resource-policy: "keep" 주석을 추가하여 Atlas Kubernetes Operator를 삭제할 때 Atlas Kubernetes Operator가 리소스를 삭제하지 않도록 할 수 있습니다. 연산자 리소스.

• 사용자 지정 리소스의 metadata 에 mongodb.com/atlas-reconciliation-policy: "skip" 주석을 추가하면 Atlas Kubernetes Operator가 리소스에 대한 조정을 시작하지 않습니다. 이 주석을 사용하면 주석을 제거할 때까지 사양과의 동기화를 일시 중지할 수 있습니다. 이 주석을 사용하여 사용자 지정 리소스를 수동으로 변경하고 동기화 중에 Atlas Kubernetes Operator가 실행 취소하지 않도록 할 수 있습니다. 이 주석을 제거하면 Atlas Kubernetes Operator가 리소스를 조정하고 사양과 동기화합니다.

• 사용자 지정 리소스의 metadata 에 mongodb.com/atlas-resource-version-policy: "allow" 주석을 추가하면 Atlas Kubernetes Operator에서 해당 버전 레이블이 사용 중인 Atlas Kubernetes Operator 버전과 일치하지 않더라도 리소스를 사용할 수 있습니다. 리소스 버전이 Atlas Kubernetes Operator 버전보다 뒤처진 메이저 버전인 경우 최신 기능이 작동하지 않을 수 있습니다. 사소한 버전 불일치는 이전 버전과 호환됩니다.