Para agentes de IA: um índice de documentação está disponível em https://www.mongodb.com/pt-br/docs/llms.txt — as versões de markdown de todas as páginas estão disponíveis anexando .md a qualquer caminho de URL.

Instale os Controladores MongoDB para o Operador Kubernetes

Observação

Este tutorial pressupõe algum conhecimento do Kubernetes. Se você não estiver familiarizado com o Kubernetes, revise a documentação do Kubernetes sobre objetos do Kubernetes e recursos personalizados antes de começar. O operador do Kubernetes representa MongoDB Ops Manager e implantações do MongoDB como recursos personalizados. Você os cria e gerencia com kubectl da mesma forma que gerencia qualquer outro objeto do Kubernetes. Para saber como esses recursos personalizados se relacionam entre si, consulte Visão geral da arquitetura do MongoDB Controllers para Kubernetes Operator.

Conclua os seguintes pré-requisitos antes de instalar o Kubernetes Operator:

1

Se você precisar de uma solução Kubernetes, consulte a documentação do Kubernetes sobre como escolher a solução certa. Revise as arquiteturas de hardware suportadas.

2
git clone https://github.com/mongodb/mongodb-kubernetes.gitcd mongodb-kubernetesgit checkout 1.15.0

Observação

Você pode usar Helm para instalar o operador Kubernetes. Para saber como instalar o Helm, consulte sua documentação no Github.

3

Por padrão, o Kubernetes Operator usa o namespace mongodb. Para simplificar a instalação, recomendamos criar um namespace com etiqueta mongodb utilizando o seguinte comando kubectl:

kubectl create namespace mongodb

Se não quiser usar o namespace mongodb , você pode rotular seu namespace como quiser:

kubectl create namespace <namespaceName>
4

Se você não implantar um recurso do Ops Manager com o Kubernetes Operator, deverá ter um Ops Manager em execução fora do cluster do Kubernetes. Se você implantar um recurso do Ops Manager no Kubernetes com o Kubernetes Operator, ignore este pré-requisito.

Importante

Sua instalação do Ops Manager deve executar um serviço NTP ativo. Se o relógio do host do Ops Manager estiver fora de sincronia, esse host não poderá se comunicar com o Kubernetes Operator.

Para saber como verificar o serviço NTP do host do Ops Manager, consulte a documentação do RHEL.

Revise os seguintes tópicos de planejamento. Para aprender mais, consulte Planeje a Instalação do operador Kubernetes.

O procedimento de instalação varia de acordo com a forma como você deseja configurar seu ambiente:

Observação

Use o mesmo namespace em todo o

Por padrão, o operador do Kubernetes implanta todos os recursos em seu cluster Kubernetes no namespace mongodb. Você pode implantar recursos do Kubernetes operador em um namespace diferente editando todos os valores de metadata.namespace em mongodb-kubernetes.yaml. Você também deve atualizar o valor de subjects[0].namespace em cada RoleBinding e ClusterRoleBinding no mesmo arquivo. Se você omitir esse valor, as vinculações procurarão o ServiceAccount no namespace mongodb padrão e não conseguirão encontrá-lo:

---apiVersion: v1kind: ServiceAccountmetadata: name: mongodb-kubernetes-operator namespace: production ---apiVersion: rbac.authorization.k8s.io/v1kind: RoleBindingmetadata: name: mongodb-kubernetes-operator namespace: productionroleRef: apiGroup: rbac.authorization.k8s.io kind: Role name: mongodb-kubernetes-operatorsubjects: - kind: ServiceAccount name: mongodb-kubernetes-operator namespace: production ---apiVersion: apps/v1kind: Deploymentmetadata: name: mongodb-kubernetes-operator namespace: production ---# Example truncated---...
1

Para saber mais sobre as configurações de instalação opcionais do Kubernetes Operator, consulte Kubernetes Operator e configurações de instalação do oc.

Observação

Para habilitar a visualização pública de contêineres estáticos, que melhoram e simplificam a segurança, consulte Contêineres estáticos (visualização pública). Não recomendamos usar esse recurso em produção enquanto ele estiver em visualização pública. Para saber mais, consulte Visualizar recursos.

2

Execute o seguinte comando kubectl para implantar a versão escolhida dos CRDs no cluster do Kubernetes:

kubectl apply -f https://raw.githubusercontent.com/mongodb/mongodb-kubernetes/1.15.0/public/crds.yaml
3

Executar o seguinte comando kubectl para implantar a versão escolhida do operador Kubernetes ao cluster Kubernetes:

kubectl apply -f https://raw.githubusercontent.com/mongodb/mongodb-kubernetes/1.15.0/public/mongodb-kubernetes.yaml

Antes de começar, certifique-se de que o sinalizador MANAGED_SECURITY_CONTEXT esteja definido como true ao implantar o operador Kubernetes no OpenShift. Este valor é predefinido no arquivo valores-openshift.yaml.

O procedimento de instalação varia de acordo com a forma como você deseja configurar seu ambiente:

Observação

Use o mesmo namespace em todo o

Por padrão, o operador do Kubernetes implanta todos os recursos em seu cluster Kubernetes no namespace mongodb. Você pode implantar recursos do Kubernetes operador em um namespace diferente editando todos os valores de metadata.namespace em mongodb-kubernetes-openshift.yaml. Você também deve atualizar o valor de subjects[0].namespace em cada RoleBinding e ClusterRoleBinding no mesmo arquivo. Se você omitir esse valor, as vinculações procurarão o ServiceAccount no namespace mongodb padrão e não conseguirão encontrá-lo:

---apiVersion: v1kind: ServiceAccountmetadata: name: mongodb-kubernetes-operator namespace: production ---apiVersion: rbac.authorization.k8s.io/v1kind: RoleBindingmetadata: name: mongodb-kubernetes-operator namespace: productionroleRef: apiGroup: rbac.authorization.k8s.io kind: Role name: mongodb-kubernetes-operatorsubjects: - kind: ServiceAccount name: mongodb-kubernetes-operator namespace: production ---apiVersion: apps/v1kind: Deploymentmetadata: name: mongodb-kubernetes-operator namespace: production ---# Example truncated---...
1

Invoque os seguintes comandos git:

git clone https://github.com/mongodb/mongodb-kubernetes.gitcd mongodb-kubernetesgit checkout 1.15.0
2

Por exemplo, se você clonou o repositório em seu diretório inicial, execute:

cd ~/mongodb-kubernetes
3

Invocar o seguinte comando oc:

oc apply -f crds.yaml
4

Para saber mais sobre as configurações de instalação opcionais do Kubernetes Operator, consulte Kubernetes Operator e configurações de instalação do oc.

Observação

Para habilitar a visualização pública de contêineres estáticos, que melhoram e simplificam a segurança, consulte Contêineres estáticos (visualização pública). Não recomendamos usar esse recurso em produção enquanto ele estiver em visualização pública. Para saber mais, consulte Visualizar recursos.

5
---apiVersion: v1kind: ServiceAccountmetadata: name: enterprise-operator namespace: mongodb imagePullSecrets: - name: <openshift-pull-secret> ---apiVersion: v1kind: ServiceAccountmetadata: name: mongodb-kubernetes-appdb namespace: mongodb imagePullSecrets: - name: <openshift-pull-secret> ---apiVersion: v1kind: ServiceAccountmetadata: name: mongodb-kubernetes-database-pods namespace: mongodb imagePullSecrets: - name: <openshift-pull-secret>

Para saber mais, consulte a configuração registry.imagePullSecrets nas configurações de instalação do Helm.

6

Invocar o seguinte comando oc:

oc apply -f mongodb-kubernetes-openshift.yaml

Para verificar se o Kubernetes Operator foi instalado corretamente, execute o seguinte comando e verifique o resultado:

kubectl describe deployments mongodb-kubernetes-operator -n <metadata.namespace>

Por padrão, existem sistemas no namespace mongodb . Se a seguinte mensagem de erro aparecer, certifique-se de usar o namespace correto:

Error from server (NotFound): deployments.apps "mongodb-kubernetes-operator" not found

Para solucionar problemas do seu operador Kubernetes, consulte Verificar registros do operador Kubernetes e outros tópicos de solução de problemas.

Importante

Se você precisar remover o Kubernetes Operator ou o namespace, primeiro deverá remover os recursos do MongoDB.

Após instalar os Controladores MongoDB para o Operador Kubernetes, você pode: