Inicio rápido

Regístrate para obtener una cuenta de Atlas o inicia sesión.

Regístrate e inicia sesión en Atlas o Regístrate e inicia sesión en Atlas.

Instala Atlas Kubernetes Operator.

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

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

Crea una clave secreta de conexión con tus credenciales.

Cree y etiquete un secreto que el operador de Atlas Kubernetes utilizará para autenticarse con Atlas. Elija la pestaña que coincida con su método de autenticación preferido:

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

Si utilizas un almacenamiento externo de secretos, no necesitas poner información confidencial directamente en los secretos de Kubernetes. Para obtener más información, consulta Configurar almacenamiento secreto.

Cree el recurso personalizado AtlasProject.

Ejecuta el siguiente comando para crear el AtlasProject recurso personalizado:

Implementa el recurso personalizado del 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 recurso personalizado AtlasDeployment.

Ejecuta 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.

Crea un secreto con una contraseña para iniciar sesión en la base de datos del clúster de 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 utilizas un almacenamiento externo de secretos, no necesitas poner información confidencial directamente en los secretos de Kubernetes. Para obtener más información, consulta Configurar almacenamiento secreto.

Cree el recurso personalizado AtlasDatabaseUser.

Ejecuta 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

Comprueba el estado de tu usuario de base de datos.

Ejecute el siguiente comando hasta que reciba una respuesta True, lo 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}'

Recuperar 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. Reemplaza los siguientes marcadores de posición con los detalles para tus recursos personalizados:

   my-project	Especifica el valor del campo metadata de tu AtlasProject Recurso Personalizado.
   my-atlas-cluster	Especifica el valor del campo metadata de tu AtlasDeployment Recurso Personalizado.
   my-database-user	Especifica el valor del campo metadata de tu AtlasDatabaseUser Recurso Personalizado.

3. Ejecuta el comando.

   Nota

   Tus cadenas de conexión serán diferentes 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