Início rápido

Registre-se para uma conta Atlas ou faça login.

Registre-se e faça login no Atlas ou Registre-se e faça login no Atlas.

Instale o Atlas Kubernetes Operator.

Escolha um dos seguintes métodos para instalar o Atlas Kubernetes Operator:

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

Crie um segredo com suas chaves de API e ID da organização.

Para criar e rotular um segredo, execute os seguintes comandos com suas chaves de API e ID da organização:

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

Se você usar o armazenamento externo de segredos, não precisará colocar informações confidenciais diretamente nos segredos do Kubernetes. Para saber mais, consulte Configurar Armazenamento Secreto.

Crie o recurso personalizado AtlasProject.

Execute o seguinte comando para criar o Recurso Personalizado doAtlasProject :

Implemente o recurso personalizado do 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

Crie o recurso personalizado AtlasDeployment.

Execute um dos seguintes comandos para criar um AtlasDeployment Recurso Personalizado e criar um cluster:

Nível 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

Nível 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 criar uma instância sem servidor, consulte o exemplo de instância sem servidor.

Crie um segredo com uma senha para entrar no reconhecimento de data center do cluster do Atlas.

Substitua P@@ssword% pela sua senha e execute os seguintes comandos:

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

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

Se você usar o armazenamento externo de segredos, não precisará colocar informações confidenciais diretamente nos segredos do Kubernetes. Para saber mais, consulte Configurar Armazenamento Secreto.

Crie o recurso personalizado AtlasDatabaseUser.

Execute o seguinte comando para criar o Recurso Personalizado doAtlasDatabaseUser :

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 o status do seu usuário do banco de dados.

Execute o seguinte comando até receber uma resposta do True , que indica que o trigger de reconhecimento de data center está pronto:

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

Recupere o segredo que o Atlas Kubernetes Operator criou para conectar ao cluster.

1. Copie o seguinte comando:

   Importante

   O comando a seguir requer jq 1.6 ou superior.

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

2. Substitua os seguintes espaços reservados pelos detalhes dos seus recursos personalizados:

   my-project	Especifique o valor do campo metadata do seu Recurso PersonalizadoAtlasProject .
   my-atlas-cluster	Especifique o valor do campo metadata do seu Recurso PersonalizadoAtlasDeployment .
   my-database-user	Especifique o valor do campo metadata do seu Recurso PersonalizadoAtlasDatabaseUser .

3. Execute o comando.

   Observação

   Sua string de conexão será diferente do exemplo a seguir.

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

   Você pode usar este segredo em seu aplicação:

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