Atlas 프로젝트를 Atlas Kubernetes Operator로 가져오기
기존 Kubernetes 배포가 있고 Atlas Kubernetes Operator 사용을 시작하려는 경우, Atlas CLI atlas kubernetes config generate 또는 atlas kubernetes config apply 명령을 사용하여 Atlas 프로젝트, 배포 및 데이터베이스 사용자를 내보낼 수 있습니다.
두 명령 모두 Atlas Kubernetes Operator가 실행되는 Kubernetes 또는 OpenShift cluster에서 사용할 수 있도록 구성을 Atlas Kubernetes Operator 호환 형식으로 내보낼 수 있습니다. atlas kubernetes config generate 명령은 YAML형식의 구성을 터미널의 stdout 로 출력하여 이를 달성하고, atlas kubernetes config apply 명령은 구성을 메모리에 저장하고 대상 Kubernetes cluster로 직접 전송합니다.
개요
두 명령 모두 다음과 같은 Atlas Kubernetes Operator 리소스를 포함하는 .yaml형식의 구성을 생성합니다.
매개변수
이 명령은 다음 매개 변수를 사용합니다.
Parameter | 설명 | 필요성 |
|---|---|---|
--projectId | 프로젝트를 식별하는 고유한 24자리 16진수 문자열입니다. 생략하면 기본값은 atlascli 구성 파일의 projectId 값입니다. | 필수 사항입니다. |
--clusterName | 내보낼 클러스터를 식별하는 쉼표로 구분된 사람이 읽을 수 있는 레이블 목록입니다. 이는 projectId 매개변수에 지정된 프로젝트의 클러스터여야 합니다. 생략하면 명령은 지정된 프로젝트의 모든 클러스터를 내보냅니다. | 선택 사항. |
--includeSecrets | Atlas 자격 증명 시크릿에 대한 구성 파일의 항목을 채우는 플래그입니다. 생략하면 명령이 시크릿을 생성하지만 데이터로 채우지는 않습니다. 시크릿은 일반 텍스트로 렌더링됩니다. | 선택 사항. |
--targetNamespace | 리소스를 내보낼 Kubernetes 네임스페이스입니다. 이 명령어는 내보낸 각 Atlas 엔터티의 metadata.namespace 필드를 이 매개변수의 값으로 채웁니다. | 필수 사항입니다. |
--operatorVersion | 파일을 내보낼 Atlas Kubernetes Operator의 버전입니다. 생략하면 명령은 Atlas Kubernetes Operator v1.5.1과 호환되는 파일을 내보냅니다. | 선택 사항. |
이 명령은 다음 매개 변수를 사용합니다.
Parameter | 설명 | 필요성 |
|---|---|---|
--projectId | 프로젝트를 식별하는 고유한 24자리 16진수 문자열입니다. 생략하면 기본값은 atlascli 구성 파일의 projectId 값입니다. | 필수 사항입니다. |
--orgId | 프로젝트 를 등록할 조직 을 식별하는 24고유한 자리 16진수 입니다.string Atlas 생략하면 기본값은 atlascli 구성 파일 의 orgId 값 또는 ORGID 환경 변수입니다. | 선택 사항. |
--clusterName | 내보낼 클러스터를 식별하는 쉼표로 구분된 사람이 읽을 수 있는 레이블 목록입니다. 이는 projectId 매개변수에 지정된 프로젝트 의 클러스터여야 합니다. 생략하면 명령은 지정된 프로젝트 의 모든 클러스터를 내보냅니다. | 선택 사항. |
--targetNamespace | 리소스를 내보낼 Kubernetes 네임스페이스입니다. 이 명령어는 내보낸 각 Atlas 엔터티의 metadata.namespace 필드를 이 매개변수의 값으로 채웁니다. | 필수 사항입니다. |
--operatorVersion | 파일을 내보낼 Atlas Kubernetes Operator의 버전입니다. 생략하면 명령은 Atlas Kubernetes Operator v1.5.1과 호환되는 파일을 내보냅니다. | 선택 사항. |
--kubeContext | Kubeconfig 클러스터 에 연결하는 데 사용할 컨텍스트입니다. | 필수 사항 |
--kubeconfig | kubeconfig 파일 의 경로입니다. | 필수 사항 |
호환성
atlascli Atlas에서 구성을 Atlas Kubernetes Operator에 종속적인 형식으로 내보냅니다. 다음 표에서는 어떤 버전의 atlascli 가 어떤 버전의 Atlas Kubernetes Operator를 지원하는지 설명합니다.
atlascli 버전 | Atlas Kubernetes Operator 버전 |
|---|---|
1.4.0 | 1.5.0 |
예시
다음 예제에서는 이름이 sampleProject 프로젝트이고, 클러스터 이름이 sample1, sample2, sample3, 프로젝트 ID가 63500d1139dd494b92fe4376, 대상 네임스페이스가 sampleNamespace 라고 가정합니다.
모든 Atlas 배포 및 자격 증명이 있는 시크릿을 포함하여 전체 프로젝트를 내보내려면 다음 명령을 실행합니다.
atlas kubernetes config generate --projectId=63500d1139dd494b92fe4376 \ --includeSecrets --targetNamespace=sampleNamespace
프로젝트에서 비밀 자격 증명 없이 특정 Atlas 배포서버 두 개를 내보내려면 다음 명령을 실행합니다.
atlas kubernetes config generate --projectId=63500d1139dd494b92fe4376 \ --clusterName=sample1,sample2 --targetNamespace=sampleNamespace
앞의 명령 예시에서 출력을 kubectl apply 명령에 파이프 하여 생성된 구성을 Kubernetes 또는 OpenShift cluster에 적용 할 수 있습니다. 다음 명령 예제에서 이를 설명합니다.
atlas kubernetes config generate --projectId=63500d1139dd494b92fe4376 \ --clusterName=sample1,sample2 --targetNamespace=sampleNamespace \ | kubectl apply -f -
또는 stdout 를 .yaml 파일로 리디렉션 하여 생성된 구성을 저장할 수 있습니다. 다음 명령어는 비밀 자격 증명 없이 프로젝트에서 단일 Atlas 배포를 가져와서 myAtlasProject.yaml 에 출력을 저장합니다.
atlas kubernetes config generate --projectId=63500d1139dd494b92fe4376 \ --clusterName=sample3 --targetNamespace=sampleNamespace \ myAtlasProject.yaml
구성 적용
이 시나리오에서 생성된 구성을 Kubernetes 또는 Openshift 클러스터에 적용하려면 .yaml 파일을 kubectl apply 명령에 인수로 전달합니다.
kubectl apply -f myAtlasProject.yaml
전체 프로젝트 를 내보내려면 다음 명령을 실행 합니다.
atlas kubernetes config apply --projectId=63500d1139dd494b92fe4376 \ --targetNamespace=sampleNamespace
프로젝트 에서 두 개의 특정 Atlas 배포서버를 내보내려면 다음 명령을 실행 합니다.
atlas kubernetes config apply --projectId=63500d1139dd494b92fe4376 \ --clusterName=sample1,sample2 --targetNamespace=sampleNamespace In contrast to ``atlas kubernetes config generate``, this command directly applies the generated configuration without any further manual operation on your part.