クイック スタート

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

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

Atlas Kubernetes Operator のインストール。

Atlas Kubernetes Operator をインストールするには、次のいずれかの方法を選択します。

atlas kubernetes operator install --ipAccessList <IP_OR_CIDR> [options]

認証情報を使用して接続シークレットを作成します。

Atlas Kubernetes OperatorがAtlasでèª èa証するために使用するsecretを作成し、ラベルを付けます。お好みの認証方法に合わせてタブを選択します。

kubectl create secret generic mongodb-atlas-operator-api-key \
    --from-literal="orgId=<atlas_organization_id>" \
    --from-literal="publicApiKey=<atlas_api_public_key>" \
    --from-literal="privateApiKey=<atlas_api_private_key>" \
    -n mongodb-atlas-system

kubectl label secret mongodb-atlas-operator-api-key atlas.mongodb.com/type=credentials -n mongodb-atlas-system

kubectl create secret generic mongodb-atlas-operator-service-account \
    --from-literal="orgId=<atlas_organization_id>" \
    --from-literal="clientId=<service_account_client_id>" \
    --from-literal="clientSecret=<service_account_client_secret>" \
    -n mongodb-atlas-system

kubectl label secret mongodb-atlas-operator-service-account atlas.mongodb.com/type=credentials -n mongodb-atlas-system

外部シークレット ストレージを使用する場合、外部シークレット マネージャーは Kubernetes secret を作成および管理します。詳細については、「シークレット ストレージの構成」を参照してください。

AtlasProject カスタムリソースを作成します。

次のコマンドを実行して、 AtlasProjectカスタム リソースを作成します。

Atlas Kubernetes Operator カスタム リソースを配置します。

cat <<EOF | kubectl apply -f -
apiVersion: atlas.mongodb.com/v1
kind: AtlasProject
metadata:
  name: my-project
spec:
  name: Test Atlas Operator Project
  projectIpAccessList:
    - ipAddress: <your-ip-address-range>
      comment: "Adding your IP to Atlas access list"
EOF

AtlasDeployment カスタムリソースを作成します。

次のいずれかのコマンドを実行してAtlasDeploymentカスタム リソースを作成し、クラスターを作成します。

有料階層:

cat <<EOF | kubectl apply -f -
apiVersion: atlas.mongodb.com/v1
kind: AtlasDeployment
metadata:
  name: my-atlas-cluster
spec:
  projectRef:
    name: my-project
  deploymentSpec:
    clusterType: REPLICASET
    name: "Test-cluster"
    tags:
      - key: "environment"
        value: "production"
    replicationSpecs:
      - zoneName: US-Zone
        regionConfigs:
          - electableSpecs:
              instanceSize: M10
              nodeCount: 3
            providerName: AWS
            regionName: US_EAST_1
            priority: 7
EOF

無料クラスター:

cat <<EOF | kubectl apply -f -
apiVersion: atlas.mongodb.com/v1
kind: AtlasDeployment
metadata:
  name: my-atlas-cluster
spec:
  projectRef:
    name: my-project
  deploymentSpec:
    clusterType: REPLICASET
    name: "Test-cluster"
    replicationSpecs:
      - regionConfigs:
          - regionName: US_EAST_1
            providerName: TENANT
            backingProviderName: AWS
            electableSpecs:
              instanceSize: M0
              nodeCount: 3
EOF

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

Atlas クラスター データベースにログインするためのパスワードを使用して Kubernetes secret を作成します。

P@@ssword%をパスワードに置き換え、次のコマンドを実行します。

kubectl create secret generic the-user-password --from-literal="password=P@@sword%"

kubectl label secret the-user-password atlas.mongodb.com/type=credentials

外部シークレット ストレージを使用する場合、外部シークレット マネージャーは Kubernetes secret を作成および管理します。詳細については、「シークレット ストレージの構成」を参照してください。

AtlasDatabaseUser カスタムリソースを作成します。

次のコマンドを実行して、 AtlasDatabaseUserカスタム リソースを作成します。

cat <<EOF | kubectl apply -f -
apiVersion: atlas.mongodb.com/v1
kind: AtlasDatabaseUser
metadata:
  name: my-database-user
spec:
  roles:
    - roleName: "readWriteAnyDatabase"
      databaseName: "admin"
  projectRef:
    name: my-project
  username: theuser
  passwordSecretRef:
    name: the-user-password
EOF

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

データベースユーザーが準備できたことを示すTrue応答が返されるまで、次のコマンドを実行します。

kubectl get atlasdatabaseusers my-database-user -o=jsonpath='{.status.conditions[?(@.type=="Ready")].status}'

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

1. 次のコマンドをコピーします。

   重要

   次のコマンドにはjq 1.6 以上が必要です。

   kubectl get secret {my-project}-{my-atlas-cluster}-{my-database-user} -o json | jq -r '.data | with_entries(.value |= @base64d)';

2. 次のプレースホルダーをカスタム リソースの詳細に置き換えます。

   my-project	AtlasProjectカスタム リソースのmetadataフィールドの値を指定します。
   my-atlas-cluster	AtlasDeploymentカスタム リソースのmetadataフィールドの値を指定します。
   my-database-user	AtlasDatabaseUserカスタム リソースのmetadataフィールドの値を指定します。

3. コマンドを実行します。

   注意

   接続文字列は次の例とは異なります。

   {
      "connectionStringStandard": "mongodb://theuser:P%40%40sword%25@test-cluster-shard-00-00.peqtm.mongodb.net:27017,test-cluster-shard-00-01.peqtm.mongodb.net:27017,test-cluster-shard-00-02.peqtm.mongodb.net:27017/?ssl=true&authSource=admin&replicaSet=atlas-pk82fl-shard-0",
      "connectionStringStandardSrv": "mongodb+srv://theuser:P%40%40sword%25@test-cluster.peqtm.mongodb.net",
      "password": "P@@sword%",
      "username": "theuser"
    }

   この Kubernetes Secret はアプリケーションで使用できます。

   containers:
    - name: test-app
      env:
       - name: "CONNECTION_STRING"
         valueFrom:
           secretKeyRef:
             name: test-atlas-operator-project-test-cluster-theuser
             key: connectionStringStandardSrv