빠른 시작

Atlas 계정에 등록하거나 로그인하세요.

Atlas 에 등록 및 로그인 또는 Atlas 에 등록 및 로그인.

Atlas Kubernetes Operator 설치합니다.

다음 방법 중 하나를 선택하여 Atlas Kubernetes Operator 설치합니다.

atlas kubernetes operator install --ipAccessList <IP_OR_CIDR> [options]

자격 증명을 사용하여 연결 시크릿을 생성합니다.

Atlas Kubernetes Operator가 Atlas에 대해 인증하는 데 사용하는 시크릿 을 만들고 레이블을 지정합니다. 원하는 인증 방법에 해당하는 탭을 선택하세요.

kubectl create secret generic mongodb-atlas-operator-api-key \
    --from-literal="orgId=<atlas_organization_id>" \
    --from-literal="publicApiKey=<atlas_api_public_key>" \
    --from-literal="privateApiKey=<atlas_api_private_key>" \
    -n mongodb-atlas-system

kubectl label secret mongodb-atlas-operator-api-key atlas.mongodb.com/type=credentials -n mongodb-atlas-system

kubectl create secret generic mongodb-atlas-operator-service-account \
    --from-literal="orgId=<atlas_organization_id>" \
    --from-literal="clientId=<service_account_client_id>" \
    --from-literal="clientSecret=<service_account_client_secret>" \
    -n mongodb-atlas-system

kubectl label secret mongodb-atlas-operator-service-account atlas.mongodb.com/type=credentials -n mongodb-atlas-system

외부 시크릿 저장을 사용하는 경우 외부 시크릿 관리자가 쿠버네티스 시크릿 쿠버네티스 시크릿를 생성하고 managed. 자세히 알아보려면 Configure Secret Storage(시크릿 저장 구성)를 참조하세요.

AtlasProject 사용자 지정 리소스 만듭니다.

다음 명령을 실행하여 AtlasProject 사용자 지정 리소스를 생성합니다.

Atlas Kubernetes Operator 사용자 지정 리소스 를 배포합니다.

cat <<EOF | kubectl apply -f -
apiVersion: atlas.mongodb.com/v1
kind: AtlasProject
metadata:
  name: my-project
spec:
  name: Test Atlas Operator Project
  projectIpAccessList:
    - ipAddress: <your-ip-address-range>
      comment: "Adding your IP to Atlas access list"
EOF

AtlasDeployment 사용자 지정 리소스 만듭니다.

다음 명령 중 하나를 실행하여 AtlasDeployment 사용자 지정 리소스 를 생성하고 클러스터 를 생성합니다.

유료 계층:

cat <<EOF | kubectl apply -f -
apiVersion: atlas.mongodb.com/v1
kind: AtlasDeployment
metadata:
  name: my-atlas-cluster
spec:
  projectRef:
    name: my-project
  deploymentSpec:
    clusterType: REPLICASET
    name: "Test-cluster"
    tags:
      - key: "environment"
        value: "production"
    replicationSpecs:
      - zoneName: US-Zone
        regionConfigs:
          - electableSpecs:
              instanceSize: M10
              nodeCount: 3
            providerName: AWS
            regionName: US_EAST_1
            priority: 7
EOF

무료 계층:

cat <<EOF | kubectl apply -f -
apiVersion: atlas.mongodb.com/v1
kind: AtlasDeployment
metadata:
  name: my-atlas-cluster
spec:
  projectRef:
    name: my-project
  deploymentSpec:
    clusterType: REPLICASET
    name: "Test-cluster"
    replicationSpecs:
      - regionConfigs:
          - regionName: US_EAST_1
            providerName: TENANT
            backingProviderName: AWS
            electableSpecs:
              instanceSize: M0
              nodeCount: 3
EOF

서버리스 인스턴스 만들려면 서버리스 인스턴스 예시 참조하세요.

비밀번호로 Kubernetes Secret을 만들어 Atlas 클러스터 데이터베이스에 로그인합니다.

P@@ssword% 을(를) 비밀번호로 바꾸고 다음 명령을 실행합니다.

kubectl create secret generic the-user-password --from-literal="password=P@@sword%"

kubectl label secret the-user-password atlas.mongodb.com/type=credentials

외부 시크릿 저장을 사용하는 경우 외부 시크릿 관리자가 쿠버네티스 시크릿 쿠버네티스 시크릿를 생성하고 managed. 자세히 알아보려면 Configure Secret Storage(시크릿 저장 구성)를 참조하세요.

AtlasDatabaseUser 사용자 지정 리소스 만듭니다.

다음 명령을 실행하여 AtlasDatabaseUser 사용자 지정 리소스를 생성합니다.

cat <<EOF | kubectl apply -f -
apiVersion: atlas.mongodb.com/v1
kind: AtlasDatabaseUser
metadata:
  name: my-database-user
spec:
  roles:
    - roleName: "readWriteAnyDatabase"
      databaseName: "admin"
  projectRef:
    name: my-project
  username: theuser
  passwordSecretRef:
    name: the-user-password
EOF

데이터베이스 사용자의 상태를 확인합니다.

데이터베이스 사용자가 준비되었음을 나타내는 True 응답을 받을 때까지 다음 명령을 실행합니다.

kubectl get atlasdatabaseusers my-database-user -o=jsonpath='{.status.conditions[?(@.type=="Ready")].status}'

Atlas Kubernetes Operator가 클러스터에 연결하기 위해 생성한 비밀을 조회하세요.

1. 다음 명령을 복사합니다.

   중요

   다음 명령을 실행하려면 jq 1.6 이상이 필요합니다.

   kubectl get secret {my-project}-{my-atlas-cluster}-{my-database-user} -o json | jq -r '.data | with_entries(.value |= @base64d)';

2. 다음 자리 표시자를 원하는 사용자 지정 리소스의 세부 정보로 바꾸세요.

   my-project	AtlasProject 사용자 지정 리소스의 metadata 필드 값을 지정합니다.
   my-atlas-cluster	AtlasDeployment 사용자 지정 리소스의 metadata 필드 값을 지정합니다.
   my-database-user	AtlasDatabaseUser 사용자 지정 리소스의 metadata 필드 값을 지정합니다.

3. 명령을 실행합니다.

   참고

   연결 문자열은 다음 예제와 다를 수 있습니다.

   {
      "connectionStringStandard": "mongodb://theuser:P%40%40sword%25@test-cluster-shard-00-00.peqtm.mongodb.net:27017,test-cluster-shard-00-01.peqtm.mongodb.net:27017,test-cluster-shard-00-02.peqtm.mongodb.net:27017/?ssl=true&authSource=admin&replicaSet=atlas-pk82fl-shard-0",
      "connectionStringStandardSrv": "mongodb+srv://theuser:P%40%40sword%25@test-cluster.peqtm.mongodb.net",
      "password": "P@@sword%",
      "username": "theuser"
    }

   애플리케이션에서 이 Kubernetes Secret을 사용할 수 있습니다.

   containers:
    - name: test-app
      env:
       - name: "CONNECTION_STRING"
         valueFrom:
           secretKeyRef:
             name: test-atlas-operator-project-test-cluster-theuser
             key: connectionStringStandardSrv