Atlas Open Service 브로커 설치 및 구성

Kubernetes 배포를 위한 네임스페이스 를 생성합니다.

설치를 간소화하려면 다음 atlas kubectl 을 사용하여 로 레이블이 지정된 네임스페이스를 만드는 것이 좋습니다. 명령:

kubectl create namespace atlas

atlas 네임스페이스를 사용하지 않으려면 네임스페이스에 원하는 레이블을 지정할 수 있습니다.

kubectl create namespace <NAMESPACE_NAME>

Deployment 및 Service 리소스 정의를 만듭니다.

1. 다음 리소스 정의 예시를 복사합니다.

   이 파일은 원하는 구성에 맞게 수정할 수 있는 YAML 파일입니다. 여기에는 Deployment 및 Service 사양이 모두 포함되어 있습니다.

   참고

   이 예제에서는 배포 이름, 서비스 이름 및 pod 레이블로 atlas-service-broker 를 사용합니다. 리소스 간에 일관적인 경우 이러한 필드를 다른 값으로 업데이트할 수 있습니다.

   ---
   # Deployment to run the service broker.
   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: atlas-service-broker
     labels:
       app: atlas-service-broker
   spec:
     replicas: 1
     selector:
       matchLabels:
         app: atlas-service-broker
     template:
       metadata:
         labels:
           app: atlas-service-broker
       spec:
         containers:
           - name: atlas-service-broker
             image: quay.io/mongodb/mongodb-atlas-service-broker:latest
             ports:
               - containerPort: 4000
             env:
               - name: BROKER_HOST
                 value: "0.0.0.0"
   ---
   # Service to expose the service broker inside the cluster.
   apiVersion: v1
   kind: Service
   metadata:
     name: atlas-service-broker
     labels:
       app: atlas-service-broker
   spec:
     selector:
       # Will match pods deployed by the "atlas-service-broker" deployment.
       app: atlas-service-broker
     ports:
       - protocol: TCP
         port: 80
         targetPort: 4000

2. 원하는 텍스트 편집기를 열고 리소스 정의를 새 텍스트 파일에 붙여넣습니다.

3. Atlas Open Service Broker 서버가 수신하는 container 포트를 확인하거나 편집합니다.

   Resource	환경 변수	설명	기본값
   Deployment	spec.template.spec .containers.ports.containerPort	Atlas Open Service 브로커 서버가 수신 대기하는 포트입니다. Service 리소스의 targetPort 값과 일치해야 합니다.	4000
   Service	spec.ports.targetPort	Atlas Open Service 브로커 서버가 수신 대기하는 포트입니다. Deployment 리소스의 containerPort 값과 일치해야 합니다.	4000

4. 파일을 deployment-and-service.yaml(으)로 저장합니다.

Atlas Open Service 브로커를 설치합니다.

다음 kubectl 명령을 사용합니다.

kubectl apply -f deployment-and-service.yaml -n <NAMESPACE>

Kubernetes 시크릿을 만듭니다.

Atlas Open Service 브로커가 객체 를 생성하거나 업데이트하는 경우 프로그래매틱 API 키와 프로젝트 ID를 Kubernetes 시크릿 으로 저장해야 합니다..

동일한 네임스페이스에 여러 시크릿이 존재할 수 있습니다.

Kubernetes 시크릿을 생성하려면 다음을 수행합니다.

1. 다음 사항이 있는지 확인합니다.

   • 원하는 Atlas 프로그래밍 방식 API 키에 대한 공개 및 비공개 키.

     프로그래밍 방식 API 키가 없는 경우 새 프로그래밍 방식 API 키를 생성합니다.

   • Atlas 프로젝트의 프로젝트 ID 입니다.

2. 다음 리소스 정의 예시를 복사합니다.

   이는 원하는 구성에 맞게 수정할 수 있는 YAML 입니다.

   apiVersion: v1
   kind: Secret
   metadata:
     name: <SECRET_NAME>
   type: Opaque
   stringData:
     username: <PUBLIC_KEY>@<PROJECT_ID>
     password: <PRIVATE_KEY>

3. 다음 필드를 편집합니다:

   필드 이름	설명
   stringData.username	Atlas 공개 키 뒤에 @ , 프로젝트 ID가 옵니다.
   stringData.password	Atlas 비공개 키.

   username 및 password 은(는) Atlas Open Service 브로커에 대한 기본 인증에 사용됩니다.

   예시

   apiVersion: v1
   kind: Secret
   metadata:
     name: atlas-service-broker-auth
   type: Opaque
   stringData:
     username: ABCAXNVY@5d49a272ce4bd97b2e1234abc
     password: 123e8d75-cxfb-x012-bx5c-abc4356e3xyz

4. 파일을 secret.yaml(으)로 저장합니다.

5. 다음 Kubernetes 명령을 호출하여 시크릿을 생성합니다.

   kubectl apply -f secret.yaml -n <NAMESPACE>

   플래그는 네임스페이스 를 제한합니다. 이 -n 시크릿이 적용됩니다.

6. 다음 Kubernetes 명령을 호출하여 시크릿을 확인합니다.

   kubectl describe secrets/<SECRET_NAME> -n <NAMESPACE>

   이 명령은 shell에서 시크릿 설명을 반환합니다.

   Name:         <SECRET_NAME>
   Namespace:    <NAMESPACE>
   Labels:       <none>
   Annotations:
   Type:         Opaque
   Data
   ====
   password:  36 bytes
   username:  36 bytes

Service 브로커 리소스 정의를 생성합니다.

1. 다음 리소스 정의 예시를 복사합니다.

   원하는 구성에 맞게 수정할 수 있는 YAML 파일입니다.

   apiVersion: servicecatalog.k8s.io/v1beta1
   kind: <SERVICE_BROKER_SCOPE>
   metadata:
     name: atlas-service-broker
   spec:
     url: http://<SERVICE_NAME>.<NAMESPACE>
     authInfo:
       basic:
         secretRef:
           name: <SECRET_NAME>
           namespace: <NAMESPACE>

2. 다음 필드를 편집합니다:

   필드 이름	설명
   kind	이 값은 Atlas Open Service 브로커를 전체 Kubernetes cluster에서 사용할 수 있는지, 아니면 Kubernetes cluster 내의 단일 네임스페이스에서만 사용할 수 있는지를 결정합니다. 서비스 브로커 리소스에 대한 자세한 내용 은 서비스 카탈로그 설명서를 참조하세요. 가능한 값은 다음과 같습니다. ServiceBroker 단일 네임스페이스로만 범위가 지정된 Atlas Open Service 브로커를 배포합니다. 모든 Atlas cluster는 Atlas Open Service 브로커와 동일한 네임스페이스에 프로비저닝되어야 합니다. ClusterServiceBroker 전체 Kubernetes cluster로 범위가 지정된 Atlas Open Service 브로커를 배포합니다. Atlas cluster는 모든 네임스페이스에 프로비저닝할 수 있습니다.
   spec.url	http://<SERVICE_NAME>.<NAMESPACE> 형식의 브로커 URL입니다. <SERVICE_NAME> Service 리소스에 있는 metadata.name 의 값입니다. 예시 http://atlas-service-broker.atlas
   spec.authInfo .basic.secretRef.name	이전 단계에서 생성한 Kubernetes 시크릿의 이름입니다.
   spec.authInfo .basic.secretRef.namespace	네임스페이스입니다.

3. 파일을 service-broker.yaml(으)로 저장합니다.

서비스 카탈로그 에 Atlas Open Service 브로커 등록

다음 kubectl 명령을 사용합니다.

kubectl apply -f service-broker.yaml -n <NAMESPACE>

Atlas CLI를 사용하여 Atlas Open Service 브로커의 상태를 확인하세요.

svcat get brokers -n <NAMESPACE>

이 명령은 브로커의 상태를 반환합니다. 브로커 상태가 나타나지 않으면 잠시 기다렸다가 명령을 다시 호출합니다.

           NAME          NAMESPACE                 URL                   STATUS
+----------------------+-----------+-----------------------------------+--------+
  atlas-service-broker               http://atlas-service-broker.atlas     Ready

브로커의 상태가 Ready 이외인 경우 service-broker.yaml metadata.name 를 다음 명령으로 전달하여 자세한 오류 메시지를 확인합니다.

svcat describe broker <METADATA.NAME> -n <NAMESPACE>