Docs Menu
Docs Home
/
MongoDB Atlas
/
MongoDB Atlas Kubernetes Operator
/
시작하기

독립적인 사용자 지정 리소스 정의

이 페이지의 내용

  • 고려 사항
  • 독립 CRD로 마이그레이션

Atlas Kubernetes Operator Kubernetes Operator를 사용하여 프로젝트 자체를 관리 하지 않고도 Atlas Kubernetes Operator 를 사용하여 Atlas 프로젝트 의 리소스를 관리 수 있습니다. 이 독립적인 사용자 지정 리소스 정의('독립 CRD') 모델에서는 AtlasDeployment Custom Resource(사용자 지정 리소스) 및 AtlasDatabaseUser Custom Resource(사용자 지정 리소스)와 같은 리소스를 Atlas ID 를 통해 직접 Atlas 프로젝트 와 연결합니다.

독립적인 CRD를 사용하면 프로젝트에 다양한 프로그래밍 방식의 인프라 관리 시스템을 사용하고, Atlas Kubernetes Operator 를 사용하여 데이터베이스 사용자 또는 개별 배포와 같이 더 자주 변경되는 리소스를 관리 있습니다.

독립적인 CRD를 사용하면 Atlas 프로젝트 관리 를 사용자 및 배포와 같은 하위 리소스 관리 에서 분리함으로써 필요에 따라 이러한 책임을 조직 내의 다른 직원이나 다른 팀에 할당할 수 있습니다.

고려 사항

Atlas Kubernetes Operator 를 사용하여 프로젝트 를 관리 하는 경우 리소스 의 매개 변수를 사용하여 Atlas Administration API 인증 spec.connectionSecretRef.name 을 atlasProject 구성하거나 이 매개 변수를 설정하지 않고 기본값 인 글로벌 Atlas 자격 증명 으로 둘 수 있습니다. 독립적인 CRD를 사용하는 경우 각 리소스 에 대해 spec.connectionSecret.name 를 지정할 수 있습니다. 이 매개변수가 설정하다 경우 spec.connectionSecretRef.name 또는 글로벌 Atlas 자격 증명 보다 우선합니다.

Atlas 프로젝트 ID 를 사용하여 상위 리소스 를 참조하는 모든 리소스 에는 이 매개변수를 설정해야 하며, 그렇지 않으면 선택 사항입니다.

예시

atlasProject spec.name 매개변수 대신 Atlas ID 로 상위 프로젝트 를 참조하는 atlasDeployment CRD를 정의합니다. 다음과 같이 atlasDeployment 리소스 에 대해 spec.connectSecret.name 를 정의해야 합니다.

apiVersion: atlas.mongodb.com/v1
kind: AtlasDeployment
metadata:
  name: test-cluster-name
  namespace: mongodb-atlas-system
spec:
  externalProjectRef:
    id: 671998971c8520583f24f411
  connectionSecret:
    name: my-atlas-key
  deploymentSpec:
    clusterType: REPLICASET
    name: service-name
    tags:
    - key: "environment"
      value: "production"
    backupEnabled: true
    replicationSpecs:
      - zoneName: US-Zone
        numShards: 3
        regionConfigs:
          - regionName: CENTRAL_US
            providerName: GCP
            backingProviderName: GCP
            priority: 7
            electableSpecs:
              instanceSize: M10
              nodeCount: 3

독립 CRD로 마이그레이션

기존 CRD를 atlasProject수준 관리 에서 독립적인 관리 마이그레이션 하려면 다음을 수행합니다.

1

프로젝트 조정 비활성화 및 하위 리소스 참조 편집

  1. 상위 리소스의 metadata 에 mongodb.com/atlas-reconciliation-policy: "skip" 주석을 추가합니다. 이렇게 하면 Atlas Kubernetes Operator 가 상위 리소스 와 해당 하위 리소스를 조정하려고 시도하는 것을 방지할 수 있습니다. 다음 사항을 고려하세요.

    apiVersion: atlas.mongodb.com/v1
    kind: AtlasProject
    metadata:
     name: my-project
     annotations:
       mongodb.com/atlas-reconciliation-policy: "skip"
    spec:
     name: Test project
     connectionSecretRef:
       name: my-atlas-key
     projectIpAccessList:
       - cidrBlock: "203.0.113.0/24"
         comment: "CIDR block for Application Server B - D"

    경고

    이 주석을 적용 하지 않으면 Atlas Kubernetes Operator 는 사용자가 다른 리소스를 수정할 때 조정을 계속 시도합니다. Atlas Kubernetes Operator 에서 새 기본값: 삭제 보호 2.0 기능이 비활성화된 사용자의 경우, 리소스 를 제거 할 때 Atlas Kubernetes Operator 가 Atlas 프로젝트 를 atlasProject 제거하거나 활성 하위 리소스가 있는 프로젝트 를 제거 하려고 시도하는 차단된 상태 가 될 수 있습니다. 예를 들어 데이터베이스 사용자 또는 배포서버입니다.

  2. 이름 atlasProject 대신 Atlas 프로젝트 ID 를 점 키도록 프로젝트 참조를 수정합니다.

    예를 예시 atlasDatabaseUser 리소스 를 분리하려면 다음을 수행합니다.

    apiVersion: atlas.mongodb.com/v1
    kind: AtlasDatabaseUser
    metadata:
     name: my-database-user
    spec:
     roles:
       - roleName: readWriteAnyDatabase
         databaseName: admin
     externalProjectRef:
       id: 671998971c8520583f24f411
     username: theuser
     passwordSecretRef:
       name: the-user-password
2

Atlas Kubernetes Operator 가 새 리소스 상태를 동기화 할 때까지 기다립니다.

3

(조건부)atlasProject CRD를 제거합니다.

Atlas Kubernetes Operator 를 사용한 프로젝트 관리를 중지하려면 이제 atlasProject CRD를 제거 하면 됩니다. Atlas Kubernetes Operator 를 사용하여 프로젝트 및 연결된 하위 리소스를 계속 관리하려면 다음 단계로 건너뛰세요.

4

(조건부) 조정 정책 주석 제거

atlasProject 에 종속된 리소스가 여전히 있는 시나리오에서처럼 Atlas Kubernetes Operator 로 프로젝트 를 계속 관리하려면 atlasProject CRD에서 조정 정책 주석을 제거하여 조정을 다시 활성화하세요.

돌아가기

정부용 Atlas

다음

호환성