Implantar um recurso Ops Manager

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=<metadata.namespace>

Crie segredos para seus certificados.

Se você estiver usando o HashiCorp Vault como sua ferramenta de armazenamento secreto, poderá Criar um Vault Secret .

Para saber mais sobre suas opções de armazenamento secreto, consulte Configurar armazenamento secreto.

1. Depois de ter seus certificados TLS e chaves privadas, execute o seguinte comando para criar um segredo que armazena MongoDB Ops Manager o certificado TLS :

   kubectl create secret tls <prefix>-<metadata.name>-cert \
     --cert=<om-tls-cert> \
     --key=<om-tls-key>

2. Execute o seguinte comando para criar um novo segredo que armazena o certificado TLS do banco de dados do aplicação :

   kubectl create secret tls <prefix>-<metadata.name>-db-cert \
     --cert=<appdb-tls-cert> \
     --key=<appdb-tls-key>

Adicione certificados adicionais aos certificados CA personalizados.

Se o certificado TLS do Ops Manager for assinado por uma CA personalizada, o certificado de CA também deverá conter certificados adicionais que permitam ao Backup Daemon do Ops Manager baixar binários do MongoDB da Internet. Para criar o(s) certificado(s) TLS, crie um ConfigMap para manter o certificado CA:

1. Obtenha toda a cadeia de certificados TLS para o Ops Manager no downloads.mongodb.com. O comando openssl a seguir gera o certificado na cadeia para seu diretório de trabalho atual, no formato .crt:

   openssl s_client -showcerts -verify 2 \
   -connect downloads.mongodb.com:443 -servername downloads.mongodb.com < /dev/null \
   | awk '/BEGIN/,/END/{ if(/BEGIN/){a++}; out="cert"a".crt"; print >out}'

2. Concatene o arquivo de certificado da CA para o Ops Manager com toda a cadeia de certificados TLS de downloads.mongodb.com obtida na etapa anterior:

   cat <custom_ca_cert.pem> cert2.crt cert3.crt cert4.crt  >> mms-ca.crt

   Observação

   • Substitua o espaço reservado <custom_ca_cert.pem> pelo seu arquivo PEM de certificado de CA personalizado.

   • Não inclua seu arquivo cert1.crt, pois é o certificado do servidor do MongoDB que não deve ser incluído.

3. Crie o ConfigMap para o Ops Manager:

   kubectl create configmap om-http-cert-ca --from-file="mms-ca.crt"

Copie um dos seguintes exemplos de objeto do Ops Manager Kubernetes.

Altere as configurações para corresponder ao Ops Manager e à configuração do banco de dados de aplicativo.

1
---
2
apiVersion: mongodb.com/v1
3
kind: MongoDBOpsManager
4
metadata:
5
  name: <myopsmanager>
6
spec:
7
  replicas: 1
8
  version: <opsmanagerversion>
9
  adminCredentials: <adminusercredentials> # Should match metadata.name
10
                                           # in the Kubernetes secret
11
                                           # for the admin user
12
13
  externalConnectivity:
14
    type: LoadBalancer
15
  security:
16
      certsSecretPrefix: <prefix> # Required. Text to prefix 
17
                                  # the name of the secret that contains
18
                                  # Ops Manager's TLS certificate.
19
      tls:
20
        ca: "om-http-cert-ca"  # Optional. Name of the ConfigMap file
21
                               # containing the certificate authority that
22
                               # signs the certificates used by the Ops
23
                               # Manager custom resource.
24
25
  applicationDatabase:
26
    topology: SingleCluster
27
    members: 3
28
    version: "8.0.0-ubi8"
29
    security:
30
      certsSecretPrefix: <prefix> # Required. Text to prefix to the 
31
                                  # name of the secret that contains the Application
32
                                  # Database's TLS certificate. Name the secret 
33
                                  # <prefix>-<metadata.name>-db-cert.
34
      tls:
35
        ca: "appdb-ca" # Optional, unless enabling TLS for |mms|. 
36
                       # Name of the ConfigMap file
37
                       # containing the certicate authority that
38
                       # signs the certificates used by the
39
                       # application database.
40
41
...

1
---
2
apiVersion: mongodb.com/v1
3
kind: MongoDBOpsManager
4
metadata:
5
  name: <myopsmanager>
6
spec:
7
  replicas: 1
8
  version: <opsmanagerversion>
9
  adminCredentials: <adminusercredentials> # Should match metadata.name
10
                                           # in the Kubernetes secret
11
                                           # for the admin user
12
13
  externalConnectivity:
14
    type: LoadBalancer
15
  security:
16
      certsSecretPrefix: <prefix> # Required. Text to prefix 
17
                                  # the name of the secret that contains
18
                                  # Ops Manager's TLS certificate.
19
      tls:
20
        ca: "om-http-cert-ca"  # Optional. Name of the ConfigMap file
21
                               # containing the certificate authority that
22
                               # signs the certificates used by the Ops
23
                               # Manager custom resource.
24
25
  applicationDatabase:
26
    topology: MultiCluster
27
    clusterSpecList:
28
    - clusterName: cluster1.example.com
29
      members: 4
30
    - clusterName: cluster2.example.com
31
      members: 3
32
    - clusterName: cluster3.example.com
33
      members: 2
34
    version: "8.0.0-ubi8"
35
    security:
36
      certsSecretPrefix: <prefix> # Required. Text to prefix to the 
37
                                  # name of the secret that contains the Application
38
                                  # Database's TLS certificate. Name the secret 
39
                                  # <prefix>-<metadata.name>-db-cert.
40
      tls:
41
        ca: "appdb-ca" # Optional, unless enabling TLS for |mms|. 
42
                       # Name of the ConfigMap file
43
                       # containing the certicate authority that
44
                       # signs the certificates used by the
45
                       # application database.
46
47
...

Abra seu editor de texto preferido e cole a especificação do objeto em um novo arquivo de texto.

Defina as configurações específicas para o seu sistema.

Opcional: Configure as configurações de Backup.

Para configurar o backup, você deve habilitá-lo e, em seguida:

• Escolha configurar um armazenamento de snapshots S3 ou um blockstore.Se vocêimplantar um armazenamento de snapshots S3 e um blockstore, o Ops Manager escolherá aleatoriamente um para usar no backup.

• Escolha configurar um armazenamento de oplog ou um armazenamento de oplog S3. Se você implantar um armazenamento de oplog e um armazenamento de oplog S3, o Ops Manager escolherá aleatoriamente um deles para usar para o backup de oplog.

Você também deve configurar um armazenamento de snapshots S3 ou um blockstore.

Se você implantar um armazenamento de snapshots S3 e um blockstore, o Ops Manager escolherá aleatoriamente um para usar para backup.

Para configurar um armazenamento de snapshots, defina as seguintes configurações:

Para configurar um blockstore, defina as seguintes configurações:

Opcional: defina quaisquer configurações adicionais para um backup do Ops Manager.

Adicione quaisquer configurações opcionais para backups que você deseja aplicar à sua implantação no arquivo de especificação do objeto . Por exemplo, para cada tipo de armazenamento de backup e para processos de daemon de backup do Ops Manager, você pode atribuir rótulos para associar armazenamentos de backup específicos ou processos de daemon de backup a projetos específicos. Use os elementos spec.backup.[*].assignmentLabels dos recursos do OpsManager.

Opcional: defina quaisquer configurações adicionais para um sistema do Ops Manager.

Adicione quaisquer configurações opcionais que você deseja aplicar ao seu sistema ao arquivo de especificação do objeto .

Salve este arquivo com uma extensão de arquivo .yaml.

Crie sua instância do Ops Manager.

Execute o seguinte comando kubectl no nome do arquivo da definição de recurso do Ops Manager:

kubectl apply -f <opsmgr-resource>.yaml

kubectl apply \
  --context "$MDB_CENTRAL_CLUSTER_FULL_NAME" \
  --namespace "mongodb"
   -f https://raw.githubusercontent.com/mongodb/mongodb-kubernetes/1.1.0/public/samples/ops-manager/ops-manager-external.yaml

Monitore o status da sua instância do Ops Manager.

Para verificar o status do recurso do Ops Manager, invoque o seguinte comando:

kubectl get om -o yaml -w

O comando retorna a saída semelhante à seguinte no campo status enquanto o recurso distribui:

status:
 applicationDatabase:
  lastTransition: "2022-04-01T09:49:22Z"
  message: AppDB Statefulset is not ready yet
  phase: Pending
  type: ""
  version: ""
 backup:
  phase: ""
 opsManager:
  phase: ""

O Operador Kubernetes reconcilia os recursos na seguinte ordem:

1. banco de dados de aplicativo.

2. Gerente de operações.

3. Backup.

O Operador Kubernetes não reconcilia um recurso até que o anterior entre na fase Running .

Depois que o recurso Ops Manager concluir a fase Pending , o comando retornará uma saída semelhante à seguinte no campo status se você habilitou o Backup:

status:
 applicationDatabase:
     lastTransition: "2022-04-01T09:50:20Z"
     members: 3
     phase: Running
     type: ReplicaSet
     version: "8.0.0-ubi8"
  backup:
   lastTransition: "2022-04-01T09:57:42Z"
   message: The MongoDB object <namespace>/<oplogresourcename>
     doesn't exist
   phase: Pending
   opsManager:
     lastTransition: "2023-04-01T09:57:40Z"
     phase: Running
     replicas: 1
     url: https://om-svc.cloudqa.svc.cluster.local:8443
     version: "8.0.0"

O backup permanece em um estado Pending até que você configure o banco de dados de backup.

Após o recurso concluir a fase Pending , o comando retornará uma saída semelhante à seguinte no campo status :

status:
  applicationDatabase:
     lastTransition: "2022-12-06T18:23:22Z"
     members: 3
     phase: Running
     type: ReplicaSet
     version: "8.0.0-ubi8"
   opsManager:
     lastTransition: "2022-12-06T18:23:26Z"
     message: The MongoDB object namespace/oplogdbname doesn't exist
     phase: Pending
     url: https://om-svc.dev.svc.cluster.local:8443
     version: ""

O backup permanece em um estado Pending até que você configure o banco de dados de backup.

Acesse o aplicativo Ops Manager.

As etapas realizadas diferem com base em como você está roteando o tráfego para o aplicativo Ops Manager no Kubernetes. Se você configurou o Operador do Kubernetes para criar um serviço do Kubernetes para você ou criou um serviço do Kubernetes manualmente, use um dos seguintes métodos para acessar o aplicativo Ops Manager:

Para saber como acessar o aplicativo Ops Manager usando um serviço de terceiros, consulte a documentação da sua solução.

Criar credenciais para o Operador Kubernetes.

Para configurar as credenciais, você deve criar uma MongoDB Ops Manager organização , gerar API chaves de programáticas e criar um segredo. Essas atividades seguem os pré-requisitos e o procedimento na página Criar Credenciais para o Operador Kubernetes .

Crie um projeto utilizando um ConfigMap.

Para criar um projeto, siga os pré-requisitos e o procedimento na página Criar um projeto por sistema do MongoDB usando um ConfigMap.

Defina os seguintes campos no ConfigMap do seu projeto:

• Defina data.baseUrl no ConfigMap para a URL do aplicativo de Ops Manager. Para encontrar esta URL, invoque o seguinte comando:

  kubectl get om -o yaml -w

  O comando retorna a URL da aplicação Ops Manager no campo status.opsManager.url, semelhante ao seguinte exemplo:

  status:
     applicationDatabase:
       lastTransition: "2022-12-06T18:23:22Z"
       members: 3
       phase: Running
       type: ReplicaSet
       version: "8.0.0-ubi8"
     opsManager:
       lastTransition: "2022-12-06T18:23:26Z"
       message: The MongoDB object namespace/oplogdbname doesn't exist
       phase: Pending
       url: https://om-svc.dev.svc.cluster.local:8443
       version: ""

  Importante

  Se você implantar o Ops Manager com o Kubernetes Operator e o Ops Manager gerenciar os recursos do banco de dados MongoDB implantados fora do cluster do Kubernetes em que foi implantado, será necessário definir data.baseUrl com o mesmo valor da configuração spec.configuration.mms.centralUrl na especificação de recursos do Ops Manager.

  Para saber mais, consulte Gerenciando sistemas externos do MongoDB .

• Defina data.sslMMSCAConfigMap como o nome do seu ConfigMap que contém o certificado CA raiz usado para assinar o certificado do host do Ops Manager. O Operador Kubernetes exige que você nomeie o certificado deste recurso do Ops Manager mms-ca.crt no ConfigMap.

Implemente os recursos do MongoDB database para concluir a configuração do backup.

Por padrão, o Ops Manager ativa o Backup. Crie um recurso de banco de dados MongoDB para os armazenamentos de oplog e snapshots para concluir a configuração.

1. Implemente um MongoDB database para o armazenamento de oplog no mesmo namespace que o Ops Manager.

   Observação

   Crie este reconhecimento de data center como um conjunto de réplica de três membros.

   Combine o metadata.name do recurso com o spec.backup.opLogStores.mongodbResourceRef.name que você especificou em sua definição de recurso do Ops Manager.

2. Implante um recurso de banco de dados MongoDB para o armazenamento de snapshots S3 no mesmo namespace que o recurso Ops Manager.

   Observação

   Crie o armazenamento de snapshots S3 como um conjunto de réplicas.

   Combine o metadata.name do recurso ao spec.backup.s3Stores.mongodbResourceRef.name que você especificou em sua definição de recurso do Ops Manager.

Confirme se o recurso do Ops Manager está em execução.

Para verificar o status do recurso do Ops Manager, invoque o seguinte comando:

kubectl get om -o yaml -w

Quando o Ops Manager está em execução, o comando retorna a saída semelhante à seguinte, no campo status :

status:
  applicationDatabase:
    lastTransition: "2022-12-06T17:46:15Z"
    members: 3
    phase: Running
    type: ReplicaSet
    version: "8.0.0-ubi8"
  opsManager:
    lastTransition: "2022-12-06T17:46:32Z"
    phase: Running
    replicas: 1
    url: https://om-backup-svc.dev.svc.cluster.local:8443
    version: "8.0.0"

Consulte Solucionar problemas do operador Kubernetes para obter informações sobre os status de distribuição de recursos.

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=<metadata.namespace>

Copie um dos seguintes exemplos de objeto do Ops Manager Kubernetes.

Altere as configurações para corresponder à configuração do MongoDB Ops Manager .

1
---
2
apiVersion: mongodb.com/v1
3
kind: MongoDBOpsManager
4
metadata:
5
  name: <myopsmanager>
6
spec:
7
  replicas: 1
8
  version: <opsmanagerversion>
9
  adminCredentials: <adminusercredentials> # Should match metadata.name
10
                                           # in the secret
11
                                           # for the admin user
12
  externalConnectivity:
13
    type: LoadBalancer
14
15
  applicationDatabase:
16
    topology: SingleCluster
17
    members: 3
18
    version: <mongodbversion>
19
...

1
---
2
apiVersion: mongodb.com/v1
3
kind: MongoDBOpsManager
4
metadata:
5
  name: <myopsmanager>
6
spec:
7
  replicas: 1
8
  version: <opsmanagerversion>
9
  adminCredentials: <adminusercredentials> # Should match metadata.name
10
                                           # in the Kubernetes secret
11
                                           # for the admin user
12
13
  externalConnectivity:
14
    type: LoadBalancer
15
16
  applicationDatabase:
17
    topology: MultiCluster
18
    clusterSpecList:
19
    - clusterName: cluster1.example.com
20
      members: 4
21
    - clusterName: cluster2.example.com
22
      members: 3
23
    - clusterName: cluster3.example.com
24
      members: 2
25
    version: "8.0.0-ubi8"
26
27
...

Abra seu editor de texto preferido e cole a especificação do objeto em um novo arquivo de texto.

Defina as configurações incluídas no exemplo anterior .

Opcional: Configure as configurações de backup.

Para configurar o backup, você deve habilitá-lo e, em seguida:

• Escolha configurar um armazenamento de snapshots S3 ou um blockstore.Se vocêimplantar um armazenamento de snapshots S3 e um blockstore, o Ops Manager escolherá aleatoriamente um para usar no backup.

• Escolha configurar um armazenamento de oplog ou um armazenamento de oplog S3. Se você implantar um armazenamento de oplog e um armazenamento de oplog S3, o Ops Manager escolherá aleatoriamente um deles para usar para o backup de oplog.

Você também deve configurar um armazenamento de snapshots S3 ou um blockstore.Sevocê implantar um armazenamento de snapshots S3 e um blockstore, o Ops Manager escolherá aleatoriamente um para usar no backup.

Para configurar um armazenamento de snapshots S3, defina as seguintes configurações:

Para configurar um blockstore, defina as seguintes configurações:

Opcional: defina quaisquer configurações adicionais para um backup do Ops Manager.

Adicione quaisquer configurações opcionais para backups que você deseja aplicar à sua implantação no arquivo de especificação do objeto . Por exemplo, para cada tipo de armazenamento de backup e para processos de daemon de backup do Ops Manager, você pode atribuir rótulos para associar armazenamentos de backup específicos ou processos de daemon de backup a projetos específicos. Use os elementos spec.backup.[*].assignmentLabels dos recursos do OpsManager.

Opcional: defina quaisquer configurações adicionais para um sistema do Ops Manager.

Adicione quaisquer configurações opcionais que você deseja aplicar ao seu sistema ao arquivo de especificação do objeto .

Salve este arquivo com uma extensão de arquivo .yaml.

Crie sua instância do Ops Manager.

Execute o seguinte comando kubectl no nome do arquivo da definição de recurso do Ops Manager:

kubectl apply -f <opsmgr-resource>.yaml

kubectl apply \
  --context "$MDB_CENTRAL_CLUSTER_FULL_NAME" \
  --namespace "mongodb"
   -f https://raw.githubusercontent.com/mongodb/mongodb-kubernetes/1.1.0/public/samples/ops-manager/ops-manager-external.yaml

Monitore o status da sua instância do Ops Manager.

Para verificar o status do recurso do Ops Manager, invoque o seguinte comando:

kubectl get om -o yaml -w

O comando retorna uma saída semelhante ao seguinte, no campo status enquanto o recurso implementa:

status:
 applicationDatabase:
  lastTransition: "2023-04-01T09:49:22Z"
  message: AppDB Statefulset is not ready yet
  phase: Pending
  type: ""
  version: ""
 backup:
  phase: ""
 opsManager:
  phase: ""

O Operador Kubernetes reconcilia os recursos na seguinte ordem:

1. banco de dados de aplicativo.

2. Gerente de operações.

3. Backup.

O Operador Kubernetes não reconcilia um recurso até que o anterior entre na fase Running .

Depois que o recurso MongoDB Ops Manager concluir a fase Pending, o comando retornará a saída semelhante à seguinte no campo status se você tiver habilitado o backup:

 status:
   applicationDatabase:
     lastTransition: "2023-04-01T09:50:20Z"
     members: 3
     phase: Running
     type: ReplicaSet
     version: "8.0.0-ubi8"
  backup:
   lastTransition: "2022-04-01T09:57:42Z"
   message: The MongoDB object <namespace>/<oplogresourcename>
     doesn't exist
   phase: Pending
   opsManager:
     lastTransition: "2022-04-01T09:57:40Z"
     phase: Running
     replicas: 1
     url: http://om-svc.cloudqa.svc.cluster.local:8080
     version: "8.0.0"

O backup permanece em um estado Pending até que você configure os bancos de dados de backup.

Acesse o aplicativo Ops Manager.

As etapas realizadas diferem com base em como você está roteando o tráfego para o aplicativo Ops Manager no Kubernetes. Se você configurou o Operador do Kubernetes para criar um serviço do Kubernetes para você ou criou um serviço do Kubernetes manualmente, use um dos seguintes métodos para acessar o aplicativo Ops Manager:

Para saber como acessar o aplicativo Ops Manager usando um serviço de terceiros, consulte a documentação da sua solução.

Opcional: Crie credenciais para o Operador Kubernetes.

Se você habilitou o backup, você deverá criar uma organização MongoDB Ops Manager , gerar chaves de API programáticas e criar um segredo em sua ferramenta de armazenamento secreto. Essas atividades seguem os pré-requisitos e o procedimento na página Criar Credenciais para o Operador Kubernetes .

Opcional: Crie um projeto utilizando um ConfigMap.

Se você habilitou o backup, crie um projeto seguindo os pré-requisitos e o procedimento na página Criar um projeto por sistema do MongoDB usando um ConfigMap.

Você deve definir data.baseUrl no ConfigMap para o URL do aplicativo de Ops Manager. Para encontrar esta URL, invoque o seguinte comando:

kubectl get om -o yaml -w

O comando retorna a URL da aplicação Ops Manager no campo status.opsManager.url, semelhante ao seguinte exemplo:

 status:
   applicationDatabase:
     lastTransition: "2022-04-01T10:00:32Z"
     members: 3
     phase: Running
     type: ReplicaSet
     version: "8.0.0-ubi8"
  backup:
   lastTransition: "2022-04-01T09:57:42Z"
   message: The MongoDB object <namespace>/<oplogresourcename>
     doesn't exist
   phase: Pending
   opsManager:
     lastTransition: "2022-04-01T09:57:40Z"
     phase: Running
     replicas: 1
     url: http://om-svc.cloudqa.svc.cluster.local:8080
     version: "8.0.0"

Opcional: implemente os recursos do banco de dados de dados MongoDB para concluir a configuração do backup.

Se você habilitou o Backup, crie um recurso de banco de dados MongoDB para os armazenamentos de oplog e snapshots para concluir a configuração.

1. Implemente um MongoDB database para o armazenamento de oplog no mesmo namespace que o Ops Manager.

   Observação

   Crie este banco de dados como um conjunto de réplicas.

   Combine o metadata.name do recurso com o spec.backup.opLogStores.mongodbResourceRef.name que você especificou em sua definição de recurso do Ops Manager.

2. Escolha uma das seguintes opções:

   1. Implante um recurso deMongoDB database para o blockstore no mesmo namespace que o recurso MongoDB Ops Manager .

      Combine o metadata.name do recurso ao spec.backup.blockStores.mongodbResourceRef.name que você especificou em sua definição de recurso do Ops Manager.

   2. Configure um bucket S3 para ser usado como armazenamento de snapshots do S3.

      Certifique-se de que você pode acessar o bucket S3 usando os detalhes especificados na definição de recurso do Ops Manager.

Opcional: confirme que o recurso MongoDB Ops Manager está em execução.

Se você ativou o backup, verifique o status do recurso do MongoDB Ops Manager invocando o seguinte comando:

kubectl get om -o yaml -w

Quando o MongoDB Ops Manager está em execução, o comando retorna a seguinte saída no campo status :

status:
  applicationDatabase:
    lastTransition: "2022-04-01T10:00:32Z"
    members: 3
    phase: Running
    type: ReplicaSet
    version: "8.0.0-ubi8"
  backup:
    lastTransition: "2022-04-01T10:00:53Z"
    phase: Running
    version: "8.0.0-ubi8"
  opsManager:
    lastTransition: "2022-04-01T10:00:34Z"
    phase: Running
    replicas: 1
    url: http://om-svc.cloudqa.svc.cluster.local:8080
    version: "8.0.0"

Consulte Solucionar problemas do operador Kubernetes para obter informações sobre os status de distribuição de recursos.