Helm Charts クイックスタート

Atlas アカウントを登録するか、ログインします。

Register and Log in to Atlas or Register and Log in to Atlas.

組織の認証情報を作成します。

Atlas Kubernetes Operator が Atlas で認証するために使用する認証情報を作成します。次のいずれかを選択します。

Atlas Kubernetes Operatorの配置。

次のいずれかのコマンドセットを実行します。

• Atlas Kubernetes Operator でKubernetesクラスター内のすべての名前空間を監視するには、次のコマンドを実行します。

  helm repo add mongodb https://mongodb.github.io/helm-charts
  helm install atlas-operator --namespace=atlas-operator --create-namespace mongodb/mongodb-atlas-operator

• Atlas Kubernetes Operator で特定の 名前空間 --watchNamespacesのセットを監視するには、 フラグを監視する名前空間のコンマ区切りリストに設定します。例、atlas-operator名前空間のみを監視するには、次のコマンドを実行します。

  helm install atlas-operator --namespace=atlas-operator --set watchNamespaces=atlas-operator --create-namespace mongodb/mongodb-atlas-operator

Atlas データベース配置 を配置します。

1. Atlas プロジェクトとそのデータベースユーザーをカスタマイズします。

   注意

   Githubには、次の追加の HelmCharts ChartsGithub の例があります。

   • atlas-basic : Atlasプロジェクト、 クラスター、データベースユーザーの作成を含む、Atlas Kubernetes Operator の簡単な配置例。

   • atlas-advanced : マルチリージョン配置、オートスケーリング動作などに関連するボイラープレートを使用した拡張可能で高度な Atlas Kubernetes Operator の配置例。

   install-values.yamlという名前のファイルを作成し、次のサンプル コードを貼り付けます。これにより、次の処理が行われます。

   • プロジェクト名をMy Projectに設定します。

   • すべての IP アドレス（0.0.0.0）にプロジェクトへのアクセスを許可します。

   • Creates a database user named dbadmin that has the dbAdmin role.

   • Creates a database user named dbuser that has the readWrite role.

   project: # Project custom values
     atlasProjectName: "My Project"
     projectIpAccessList:
       - cidrBlock: "0.0.0.0/0"
   users: # Custom database users
     - username: dbadmin
       databaseName: admin
       roles:
         - databaseName: admin-role
           roleName: dbAdmin
     - username: dbuser
       databaseName: admin
       roles:
         - databaseName: user-role
           roleName: readWrite

2. 次のコマンドを実行します。

   次のコマンドの --set フラグと --values フラグは、組織 ID、認証情報、Atlas プロジェクト構成で Values.yaml ファイルの値とデフォルトの Helm Charts の値を上書きします。

   注意

   mongodb/atlas-deployment は、リポジトリ内のチャートの名前を参照します。

   API キーサービス アカウント

   helm install atlas-deployment \
   mongodb/atlas-deployment \
   --namespace=my-cluster \
   --create-namespace \
   --set atlas.secret.orgId='<orgid>' \
   --set atlas.secret.publicApiKey='<publicKey>' \
   --set atlas.secret.privateApiKey='<privateApiKey>' \
   --values install-values.yaml

   注意

   認証とその他のチャートパラメータのサポートされている Helm 値の完全なリストについては、helm-charts リポジトリの values.yaml ファイルを参照してください。

   Atlas Kubernetes Operator のカスタム リソース パラメータの詳細については、「AtlasDeploymentカスタム リソース」を参照してください。

   サーバーレスインスタンスを作成するには、「 サーバーレスインスタンスの例 」を参照してください。

データベースユーザーのステータスを確認します。

次のコマンドを実行して、 dbadminデータベースユーザーが準備ができるまで待ちます。

kubectl wait --for=condition=ready  --timeout=10m -n my-cluster atlasdatabaseusers/atlas-deployment-dbadmin

Atlas Kubernetes Operator がデータベース配置に接続するために作成したシークレットを取得します。

次のコマンドを実行して、dbadmin データベースユーザーの接続文字列とパスワードを取得します。 接続文字列は出力例とは異なります。

kubectl get secret -n my-cluster my-project-cluster-name-dbadmin  -o json | jq -r '.data | with_entries(.value |= @base64d)';

{
   "connectionStringStandard": "mongodb://admin-user:%25SomeLong%25password$foradmin@atlas-cluster-shard-00-00.nlrvs.mongodb.net:27017,atlas-cluster-shard-00-01.nlrvs.mongodb.net:27017,atlas-cluster-shard-00-02.nlrvs.mongodb.net:27017/?ssl=true&authSource=admin&replicaSet=atlas-11q9bn-shard-0",
   "connectionStringStandardSrv": "mongodb+srv://admin-user:%25SomeLong%25password$foradmin@atlas-cluster.nlrvs.mongodb.net",
   "password": "%SomeLong%password$foradmin",
   "username": "dbadmin"
}

アプリケーションでは、次のシークレットを使用できます。

containers:
 - name: test-app
   env:
     - name: "CONNECTION_STRING"
       valueFrom:
         secretKeyRef:
           name: my-project-cluster-name-dbadmin
           key: connectionStringStandardSrv