Atlas へのアクセスを設定する

Atlas Administration APIに接続するために、Atlas Kubernetes Operator は Atlas Kubernetes Operator シークレットから組織IDとAPIキーを読み取ります。次の機能を設定することもできます。

To learn more about creating an Atlas account, see Register and Log in to Atlas.

Atlas Kubernetes Operator Secrets

構成に応じて、Atlas Kubernetes Operator は、次の Atlas Kubernetes Operator シークレットのいずれかから読み取りを行います。

スコープ	ロケーション	説明
グローバル	Atlas Kubernetes `<operator-deployment-name>-api-key`Operator をインストールしたのと同じ名前空間に作成された Atlas Kubernetes Operator シークレット。	Atlas Kubernetes Operator は、 `AtlasProject`カスタムリソースで`spec.connectionSecretRef.name`が指定されていない限り、このシークレットデータを使用して Atlas Administration API に接続します。 `global` Atlas Kubernetes Operator secrets let you use one API key for all the projects in an organization. Any new `AtlasProject` Custom Resource uses the same API key for reduced overhead. Atlas Kubernetes Operator 配置のデフォルト名は `mongodb-atlas-operator` です。したがって、シークレットの名前は `mongodb-atlas-operator-api-key` にする必要があります。
プロジェクト	Atlas Kubernetes Operator `spec.connectionSecretRef.name`シークレットは、`AtlasProject` カスタムリソース内ので参照されます。デフォルトでは、Atlas Kubernetes Operator はカスタムリソース `AtlasProject`と同じ名前空間に接続シークレットを保持します。シークレットを別の名前空間に保存するには、 `spec.connectionSecretRef.namespace`パラメータを指定します。	Atlas Kubernetes Operator はこのシークレットデータを使用して、プロジェクトを参照する任意の`AtlasDeployment` カスタムリソースと `AtlasDatabaseUser` カスタムリソースの Atlas APIに接続します。 `spec.connectionSecretRef.name`を指定しない場合、Atlas Kubernetes Operator は`global` Atlas Kubernetes Operator シークレットを使用します。 Atlas Kubernetes Operator プロジェクトごとのシークレットにより、より細かいアクセスが可能になります。単一の Atlas プロジェクトにアクセスするために、単一の API キーを使用したい場合があるかもしれません。

パラメーター

global と project のいずれのシークレットにも次の情報が必要です。

Parameter	説明
`orgId`	組織を識別するために使用される一意の 24桁の 16 進数。stringAtlas
`publicAPIKey`	Public part of the API key.
`privateAPIKey`	Private part of the API key.

前提条件

Atlas Kubernetes Operator から Atlas へのアクセスを構成するには、次の公開 API キー、プライベート API キー、および組織 ID 情報が必要です。

Atlas Kubernetes Operator で新しい Atlasプロジェクトを作成する場合は、組織へのプログラムによるアクセスの付与。組織で Atlas Administration APIのIP アクセスリストが必要な場合は、 APIアクセスリストも設定する必要があります。

重要
API キーには、 Organization Project Creator組織ロール以上を割り当てる必要があります。
既存の Atlasプロジェクトを操作する場合は、プロジェクトからプロジェクトアクセスを追加します。組織で Atlas Administration APIのIP アクセスリストが必要な場合は、 APIアクセスリストも設定する必要があります。

重要
Project Ownerプロジェクトロールに API キーを割り当てる必要があります。

手順

Atlas への Atlas Kubernetes Operator アクセスを構成するには、次のいずれかの手順を実行します。

global Atlas Kubernetes Operator シークレットについては、次のコマンドを実行します。

注意

global Atlas Kubernetes Operator シークレットの名前は、事前定義された形式に準拠している必要があります。Atlas Kubernetes Operator 配置のデフォルト名は 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 mongodb-atlas-operator-api-key atlas.mongodb.com/type=credentials -n mongodb-atlas-system

戻る

メトリクス

シークレットストレージ