Atlas オープン サービス ブロードキャストのインストールと構成

Kubernetes配置用の名前空間を作成します。

インストールを簡素化するために、次の kubectl コマンドを使用して atlas というラベルの付いた名前空間を作成することを検討してください。

kubectl create namespace atlas

atlas名前空間を使用しない場合は、名前空間に次のようにラベルを付けることができます。

kubectl create namespace <NAMESPACE_NAME>

Deployment と Service のリソース定義を作成します。

1. 次のリソース定義の例をコピーします。

   これは、必要な構成に合わせて変更できるYAMLファイルです。 これにはDeploymentとServiceの両方の仕様が含まれます。

   注意

   この例では、配置名、サービス名、ポッド ラベルとして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 Blog サーバーがリッスンするコンテナ ポートを確認または編集します。

   Resource	環境変数	説明	default
   Deployment	spec.template.spec .containers.ports.containerPort	Atlas Open Service Blog サーバーがリッスンするポート。 Serviceリソース内のtargetPortの値と一致する必要があります。	4000
   Service	spec.ports.targetPort	Atlas Open Service Blog サーバーがリッスンするポート。 Deploymentリソース内のcontainerPortの値と一致する必要があります。	4000

4. ファイルをdeployment-and-service.yamlとして保存します。

Atlas Open Service ブロックをインストールします。

次の kubernetes コマンドを使用します。

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

Kubernetes シークレットを作成します。

Atlas Open Service Blog が Atlas プロジェクト内のオブジェクトを作成または更新するには、 プログラマティックAPIキーとプロジェクトID をKubernetes secret として保存する必要があります。

複数のシークレットが同じ名前空間に存在できます。

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 Blog に対する基本認証に使用されます。

   例

   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

サービス プロバイダーのリソース定義を作成します。

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 Blog がKubernetesクラスター全体で使用できるか、 Kubernetesクラスター内の単一の名前空間のみで使用できるかが決まります。サービス カタログのドキュメントの詳細については、サービス カタログのドキュメント を参照してください。 可能な値は次のとおりです。 ServiceBroker スコープが 1 つの名前空間のみに設定されている Atlas Open Service Blog を配置します。 すべての Atlas クラスターは、Atlas Open Service Blog と同じ名前空間でプロビジョニングする必要があります。 ClusterServiceBroker Kubernetes クラスター全体にスコープが設定された Atlas Open Service Blog を配置します。 Atlas クラスターは任意の名前空間でプロビジョニングできます。
   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 Blog をサービスカタログに登録

次の kubernetes コマンドを使用します。

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

サービスカタログ CLI を使用して、Atlas オープン サービス ブロックのステータスを確認します。

svcat get brokers -n <NAMESPACE>

コマンドは、ポートのステータスを返します。 プロバイダーのステータスが表示されない場合は、少し時間待ってからコマンドを再度呼び出します。

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

エージェントのステータスがReady 以外の場合は、metadata.name からのservice-broker.yaml を次のコマンドに渡して、詳細なエラー メッセージを表示します。

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