Início rápido para o operador Kubernetes

Adicione o repositório MongoDB Helm Charts for Kubernetes ao Helm.

helm repo add mongodb https://mongodb.github.io/helm-charts

Instale o MongoDB Enterprise Kubernetes Operator

Para instalar o Operador Kubernetes com o Gráfico Helm, consulte as instruções no repositório.

Exemplo

O seguinte comando instala o MongoDB Enterprise Kubernetes Operator no namespace do mongodb com a opção opcional do --create-namespace. Por padrão, o Kubernetes Operator utiliza o namespace default.

helm install enterprise-operator mongodb/enterprise-operator --namespace mongodb --create-namespace

Configure kubectl como padrão para seu namespace.

Caso ainda não tenha feito isso, execute o seguinte comando para executar todos os comandos kubectl no namespace que você criou:

kubectl config set-context $(kubectl config current-context) --namespace=mongodb

Configurar o operador Kubernetes

1. Acesse a página de configuração do Kubernetes na interface do usuário do Cloud Manager.

2. Clique em Create New API Keys ou Use Existing API Keys.

3. Preencha o formulário. Para saber mais, consulte Acesso programático ao Cloud Manager.

4. Clique em Generate Key and YAML.

Copie e salve o ConfigMap.

Copie e salve o arquivo config-map.yaml gerado.

Exemplo:

apiVersion: v1
kind: ConfigMap
metadata:
  name: my-project
  namespace: mongodb
data:
  baseUrl: https://cloud.mongodb.com
  projectName: my-project # this is an optional parameter
  orgId: 5ecd252f8c1a75033c74106c # this is a required parameter

Para saber mais, consulte as descrições do parâmetro.

Copie e salve o segredo.

Copie e salve o arquivo secret.yaml gerado.

Exemplo:

apiVersion: v1
kind: Secret
metadata:
  name: organization-secret
  namespace: mongodb
stringData:
  user: <public_key>
  publicAPIKey: <private_key>

Por motivos de segurança, o MongoDB Cloud Manager exibe este arquivo apenas uma vez.

Aplique o ConfigMap e Secreto.

Execute o seguinte comando:

kubectl apply -f secret.yaml -f config-map.yaml

Implemente o recurso conjunto de réplicas.

1. Copie e salve o seguinte arquivo YAML:

   apiVersion: mongodb.com/v1
   kind: MongoDB
   metadata:
     name: demo-mongodb-cluster-1
     namespace: mongodb
   spec:
     members: 3
     version: 4.4.5-ent
     type: ReplicaSet
     security:
       authentication:
         enabled: true
         modes: ["SCRAM"]
     cloudManager:
       configMapRef:
         name: my-project
     credentials: organization-secret
     persistent: true
     podSpec:
       podTemplate:
         spec:
          containers:
           - name: mongodb-enterprise-database
             resources:
               limits:
                 cpu: 2
                 memory: 1.5G
               requests:
                 cpu: 1
                 memory: 1G
               persistence:
                 single:
                   storage: 10Gi

2. Execute o seguinte comando:

   kubectl apply -f <replica-set-conf>.yaml

Crie um segredo com sua senha de usuário do banco de dados

Você pode optar por usar uma senha de texto simples ou uma senha codificada em Base64. As senhas de texto simples usam stringData.password e as senhas codificadas em Base64 usam data.password.

Para obter uma senha de texto não criptografado, crie e salve o seguinte arquivo YAML:

apiVersion: v1
kind: Secret
metadata:
  name: mms-user-1-password
  # corresponds to user.spec.passwordSecretKeyRef.name
type: Opaque
stringData:
  password: <my-plain-text-password>
  # corresponds to user.spec.passwordSecretKeyRef.key

Para obter uma senha codificada em Base64, crie e salve o seguinte arquivo YAML:

apiVersion: v1
kind: Secret
metadata:
  name: mms-user-1-password
  # corresponds to user.spec.passwordSecretKeyRef.name
type: Opaque
data:
  password: <base-64-encoded-password>
  # corresponds to user.spec.passwordSecretKeyRef.key

Criar um utilizador de banco de dados.

1. Copie e salve o seguinte arquivo de Especificação de recursos do usuário do MongoDB:

   apiVersion: mongodb.com/v1
   kind: MongoDBUser
   metadata:
     name: mms-scram-user-1
   spec:
     passwordSecretKeyRef:
       name: mms-user-1-password
       # Match to metadata.name of the User Secret
       key: password
     username: "mms-scram-user-1"
     db: "admin" #
     mongodbResourceRef:
       name: "demo-mongodb-cluster-1"
       # Match to MongoDB resource using authenticaiton
     roles:
     - db: "admin"
       name: "clusterAdmin"
     - db: "admin"
       name: "userAdminAnyDatabase"
     - db: "admin"
       name: "readWrite"
     - db: "admin"
       name: "userAdminAnyDatabase"

2. Execute o seguinte comando:

   kubectl apply -f <database-user-conf>.yaml

Opcional: visualize o usuário recém-criado no Cloud Manager ou no Ops Manager.

Você pode visualizar o usuário recém-criado no Cloud Manager ou Ops Manager:

1. Na visualização Deployment do projeto, clique na guia Security.

2. Clique no separador MongoDB Users aninhado.

Conecte-se ao conjunto de réplicas.

Execute as seguintes etapas no aplicativo Cloud Manager:

1. Clique em Deployment na navegação à esquerda.

2. Clique em para o sistema ao qual você deseja se conectar.

3. Clique em Connect to this instance.

4. Execute o comando de conexão em um terminal para se conectar ao sistema.