Atlas에 대한 액세스 구성

Atlas Kubernetes Operator Atlas Administration API 에 연결하기 위해 Atlas Kubernetes Operator 시크릿에서 조직 ID 및 자격 증명 읽습니다.API 키 또는 서비스 계정을 사용하여 인증할 수 있습니다. 다음 기능을 구성할 수도 있습니다.

Atlas 계정을 만드는 방법에 대해 자세히 학습 Atlas 에 등록 및 로그인을 참조하세요.

Atlas Kubernetes Operator 시크릿

Atlas Kubernetes Operator 구성에 따라 다음 Atlas Kubernetes Operator 시크릿 중 하나를 읽습니다.

범위	위치	설명
글로벌	Atlas Kubernetes Operator 시크릿 이(가) `<operator-deployment-name>-api-key` Atlas Kubernetes Operator 설치한 것과 동일한 네임스페이스 에 생성되었습니다.	`AtlasProject` Custom Resource (사용자 지정 리소스)가 spec.connectionSecretRef.name을(를) 지정하지 않는 한, Atlas Kubernetes Operator 이 시크릿 데이터를 사용하여 Atlas 관리 API 에 연결합니다. `global` Atlas Kubernetes Operator 시크릿을(를) 사용하면 조직의 모든 프로젝트에 단일 자격 증명 세트를 사용할 수 있습니다. 새로운 `AtlasProject` Custom Resource(사용자 지정 리소스)는 동일한 자격 증명을 사용하여 오버헤드를 줄입니다. Atlas Kubernetes Operator 배포서버의 기본 이름은 `mongodb-atlas-operator`입니다. 따라서 시크릿의 이름은 `mongodb-atlas-operator-api-key`로 지정해야 합니다.
프로젝트	`AtlasProject` Custom Resource(사용자 지정 리소스)에서 spec.connectionSecretRef.name(으)로참조된 Atlas Kubernetes Operator 시크릿입니다. 기본값 으로 Atlas Kubernetes Operator 사용자 `AtlasProject` 지정 리소스와 동일한 네임스페이스 에 연결 비밀을 유지합니다. 다른 네임스페이스 에 시크릿을 저장 하려면 spec.connectionSecretRef를 지정합니다. 네임스페이스 매개변수입니다.	Atlas Kubernetes Operator 이 시크릿 데이터를 사용하여 프로젝트 참조하는 모든 `AtlasDeployment` 사용자 지정 `AtlasDatabaseUser` 리소스 및 사용자 지정 리소스 에 대해 Atlas 관리 API 에 연결합니다. spec.connectionSecretRef.name을 지정하지 않으면 Atlas Kubernetes Operator `global` Atlas Kubernetes Operator 시크릿을 사용합니다. 프로젝트 별 Atlas Kubernetes Operator 시크릿을 통해 보다 세분화된 액세스 가능합니다. 단일 자격 증명 설정하다 가 단일 Atlas 프로젝트 에 액세스 할 수 있도록 할 수 있습니다.

매개변수

global 및 project 시크릿 에는 모두 다음 정보가 필요합니다.

Parameter	설명
`orgId`	조직 을식별하는 데 24사용되는 고유한 자리 16진수 입니다.string Atlas
`publicAPIKey`	API 키의 공개 부분입니다.
`privateAPIKey`	API 키의 비공개 부분입니다.

Parameter	설명
`orgId`	조직 을식별하는 데 24사용되는 고유한 자리 16진수 입니다.string Atlas
`clientId`	서비스 계정의 클라이언트 ID입니다.
`clientSecret`	서비스 계정의 클라이언트 비밀입니다. 만든 후에는 이 값을 조회할 수 없습니다.

서비스 계정에 대한 자세한 내용은 서비스 계정을 사용하여 Atlas에 대한 액세스 구성을 참조하세요.

전제 조건

다음 인증 방법 중 하나를 선택합니다.

Atlas에 대한 Atlas Kubernetes Operator 액세스 권한을 구성하려면 다음의 공개 API 키, 비공개 API 키 및 조직 ID 정보가 필요합니다.

Atlas Kubernetes Operator 가 새 Atlas 프로젝트 를 생성하도록 하려면Grant Programmatic Access to an Organization(조직에 프로그래밍 방식 액세스 권한을 부여합니다)을 클릭합니다. 조직 에서 Atlas 관리 API 에 대한 IP 액세스 목록 이 필요한 경우 API 액세스 목록도 구성해야 합니다.

중요
API 키를 Organization Project Creator 조직 역할 이상으로 할당해야 합니다.
기존 Atlas 프로젝트 로 작업하려면 프로젝트에서 프로젝트액세스를 추가합니다. 조직 에서 Atlas 관리 API 에 대한 IP 액세스 목록 이 필요한 경우 API 액세스 목록도 구성해야 합니다.

중요
API 키에 Project Owner 프로젝트 역할을 할당해야 합니다.

Atlas에 대한 Atlas Kubernetes Operator 액세스 권한을 구성하려면 적절한 역할과 함께 서비스 계정과 조직 ID가 필요합니다.

Atlas Kubernetes Operator가 새 Atlas 프로젝트를 생성하도록 하려면 조직 프로젝트 생성자 역할 이상으로 서비스 계정을 생성합니다.
기존 Atlas 프로젝트로 작업하려면 Project Owner 역할을 가진 서비스 계정을 만드세요.

서비스 계정을 만드는 방법을 학습 서비스 계정 개요를 참조하세요.

절차

Atlas 에 대한 Atlas Kubernetes Operator 액세스 구성하려면 자격 자격 증명 사용하여 시크릿을 생성합니다. 원하는 인증 방법과 일치하는 탭 선택합니다.

global Atlas Kubernetes Operator 시크릿의 경우 다음 명령을 실행 .

참고

Atlas Kubernetes Operator 시크릿의 이름은 사전 정의된 형식을 준수해야 합니다. Atlas Kubernetes Operator 배포서버 의 기본값 이름은 입니다.global mongodb-atlas-operator 따라서 시크릿의 이름은 이어야 mongodb-atlas-operator-api-key 합니다.

kubectl create secret generic mongodb-atlas-operator-api-key \
   --from-literal="orgId=<the_atlas_organization_id>" \
   --from-literal="publicApiKey=<the_atlas_api_public_key>" \
   --from-literal="privateApiKey=<the_atlas_api_private_key>" \
   -n <operator_namespace>
kubectl label secret mongodb-atlas-operator-api-key atlas.mongodb.com/type=credentials -n mongodb-atlas-system

project Atlas Kubernetes Operator 시크릿의 경우 다음 명령을 실행 .

kubectl create secret generic my-project-connection \
   --from-literal="orgId=<the_atlas_organization_id>" \
   --from-literal="publicApiKey=<the_atlas_api_public_key>" \
   --from-literal="privateApiKey=<the_atlas_api_private_key>" \
   -n <atlas_project_namespace>
kubectl label secret my-project-connection atlas.mongodb.com/type=credentials -n <atlas_project_namespace>

global Atlas Kubernetes Operator 시크릿의 경우 다음 명령을 실행 .

참고

kubectl create secret generic mongodb-atlas-operator-service-account \
   --from-literal="orgId=<the_atlas_organization_id>" \
   --from-literal="clientId=<the_service_account_client_id>" \
   --from-literal="clientSecret=<the_service_account_client_secret>" \
   -n <operator_namespace>
kubectl label secret mongodb-atlas-operator-service-account atlas.mongodb.com/type=credentials -n mongodb-atlas-system

project Atlas Kubernetes Operator 시크릿의 경우 다음 명령을 실행 .

kubectl create secret generic my-project-connection \
   --from-literal="orgId=<the_atlas_organization_id>" \
   --from-literal="clientId=<the_service_account_client_id>" \
   --from-literal="clientSecret=<the_service_account_client_secret>" \
   -n <atlas_project_namespace>
kubectl label secret my-project-connection atlas.mongodb.com/type=credentials -n <atlas_project_namespace>

Atlas Kubernetes Operator로 서비스 계정을 구성하는 방법에 대해 자세히 알아보려면 서비스 계정을 사용하여 Atlas에 액세스 구성을 참조하세요.

돌아가기

지표

비밀 저장소