Inicio rápido

Regístrese para obtener una cuenta Atlas o inicie sesión.

Registre una nueva cuenta Atlas o inicie sesión en su cuenta Atlas.

Instalar el operador Atlas Kubernetes.

Elija uno de los siguientes métodos para instalar Atlas Kubernetes Operator:

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

Crea un secreto con tus claves API y el ID de tu organización.

Para crear y etiquetar un secreto, ejecute los siguientes comandos con sus claves API y el ID de la organización:

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

Si usa almacenamiento secreto externo, no necesita guardar información confidencial directamente en los secretos de Kubernetes. Para obtener más información, consulte Configurar almacenamiento secreto.

Cree el AtlasProject recurso personalizado.

Ejecute el siguiente comando para crear el AtlasProject recurso personalizado:

Implemente el recurso personalizado 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

Cree el AtlasDeployment recurso personalizado.

Ejecute uno de los siguientes comandos para crear un AtlasDeployment recurso personalizado y crear un clúster:

Nivel de pago:

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

Nivel gratuito:

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

Para crear una instancia sin servidor, consulte el ejemplo de instancia sin servidor.

Cree un secreto con una contraseña para iniciar sesión en la base de datos del clúster Atlas.

Reemplace P@@ssword% con su contraseña y ejecute los siguientes comandos:

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

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

Si usa almacenamiento secreto externo, no necesita guardar información confidencial directamente en los secretos de Kubernetes. Para obtener más información, consulte Configurar almacenamiento secreto.

Cree el AtlasDatabaseUser recurso personalizado.

Ejecute el siguiente comando para crear el AtlasDatabaseUser recurso personalizado:

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

Verifique el estado de su usuario de base de datos.

Ejecute el siguiente comando hasta que reciba una respuesta True, que indica que el usuario de la base de datos está listo:

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

Recupere el secreto que Atlas Kubernetes Operator creó para conectarse al clúster.

1. Copie el siguiente comando:

   Importante

   El siguiente comando requiere jq 1.6 o superior.

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

2. Reemplace los siguientes marcadores de posición con los detalles de sus recursos personalizados:

   my-project	Especifique el valor del metadata campo de su AtlasProject recurso personalizado.
   my-atlas-cluster	Especifique el valor del metadata campo de su AtlasDeployment recurso personalizado.
   my-database-user	Especifique el valor del metadata campo de su AtlasDatabaseUser recurso personalizado.

3. Ejecuta el comando.

   Nota

   Las cadenas de conexión serán diferentes a las del siguiente ejemplo.

   {
      "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"
    }

   Puedes usar este secreto en tu aplicación:

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