Início rápido dos Charts do Helm

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

Registre uma nova conta do Atlas ou faça login na sua conta do Atlas.

Crie chaves API para a sua organização.

Crie uma chave de API (interface de programação de aplicativos) em uma organização e configure o API Access List.

Você precisa das seguintes informações da chave de API pública, chave de API privada e ID da organização para configurar o acesso do Atlas Kubernetes Operator ao Atlas.

• Para que o Atlas Kubernetes Operator possa criar um novo projeto Atlas, crie uma chave de API (Interface de Programação de Aplicação) em uma organização. Se a sua organização exigir uma lista de acesso de IP para a API de administração do Atlas, você também deverá configurar a lista de acesso à API.

  Importante

  Você deve atribuir a chave API ao role da organização Organization Project Creator ou superior.

• Para trabalhar em um projeto existente do Atlas, crie uma chave de API (Interface de Programação de Aplicação) para um projeto. Se a sua organização exigir uma lista de acesso de IP para a API de administração do Atlas, você também deverá configurar a lista de acesso à API.

  Importante

  Você deve atribuir à chave de API ao role de projeto Project Owner .

Implemente o Atlas Kubernetes Operator

Execute um dos seguintes conjuntos de comandos:

• Se você deseja que o Atlas Kubernetes Operator observe todos os namespaces no cluster Kubernetes, execute os seguintes comandos:

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

• Se você quiser que o Atlas Kubernetes Operator assista apenas seu próprio namespace, defina o --watchNamespaces sinalizador como seu próprio namespace e execute o seguinte comando:

  Observação

  Você pode definir o --watchNamespaces sinalizador somente para seu próprio namespace. Definindo o --watchNamespaces sinalizador para qualquer outro namespace atualmente não é compatível.

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

Implemente o Sistema de Banco de Dados Atlas.

1. Personalize o projeto Atlas e seus utilizadores de banco de dados.

   Crie um arquivo denominado install-values.yaml e cole o seguinte código de exemplo, que faz o seguinte:

   • Define o nome do projeto para My Project.

   • Permite que todos os endereços IP (0.0.0.0) acessem o projeto.

   • Cria um usuário do banco de dados denominado dbadmin que tem a função dbAdmin .

   • Cria um usuário do banco de dados denominado dbuser que tem a função readWrite .

   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. Execute o seguinte comando.

   Os sinalizadores --set e --values no comando a seguir substituem os valores do arquivo Values.yaml e os valores padrão do Helm Charts pelo ID de sua organização, pelas chaves de API e pela configuração do projeto Atlas.

   Observação

   mongodb/atlas-deployment faz referência ao nome de um gráfico no repositório.

   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

   Para saber mais sobre os parâmetros disponíveis, consulte Recurso PersonalizadoAtlasDeployment .

   Para criar uma instância sem servidor, consulte o exemplo de instância sem servidor.

Verifique o status do seu usuário do banco de dados.

Execute o seguinte comando para aguardar o usuário do banco de dados do dbadmin se tornar pronto:

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

Recupere o segredo que o Atlas Kubernetes Operator criou para conectar ao sistema de banco de dados.

Execute o seguinte comando para recuperar a cadeia de conexão e senha para o usuário do banco de dados do dbadmin. Suas cadeias de conexão serão diferentes da saída do exemplo.

kubectl get secret -n my-cluster my-project-cluster-name-dbadmin  -ojson | 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"
}

Você pode usar o seguinte segredo em seu aplicativo:

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