Menu Docs
Página inicial do Docs
/
Operador de Kubernetes do MongoDB Enterprise
/

Instale o MongoDB Enterprise Kubernetes Operator

Nesta página

  • Pré-requisitos e considerações
  • Instalar com Kubernetes
  • Instalar com OpenShift
  • Verificar a instalação
  • Próximos passos

Antes de instalar o Operador Kubernetes, certifique-se de planejar a instalação:

Observação

Este tutorial pressupõe algum conhecimento do Kubernetes e links para documentação relevante do Kubernetes. Se você não estiver familiarizado com o Kubernetes, analise essa documentação primeiro.

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 Kubernetes distribui todos os recursos do seu cluster Kubernetes no namespace{ mongodb. Você pode distribuir recursos do Kubernetes Operator para um namespace diferente editando todos os valores para metadata.namespace em mongodb-enterprise.yaml:

##---
# Source: mongodb-enterprise-operator/templates/serviceaccount.yaml
---
apiVersion: v1
kind: ServiceAccount
metadata:
name: mongodb-enterprise-operator
namespace: production
##---
# Source: mongodb-enterprise-operator/templates/operator.yaml
---
apiVersion: apps/v1
kind: Deployment
metadata:
name: mongodb-enterprise-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.

2

Preencha o espaço reservado do <version> e execute o seguinte comando do kubectl para implantar sua versão escolhida do Operador Kubernetes para seu cluster Kubernetes:

kubectl apply -f https://raw.githubusercontent.com/mongodb/mongodb-enterprise-kubernetes/<version>/mongodb-enterprise.yaml
3

Preencha o espaço reservado do <version> e execute o seguinte comando do kubectl para distribuir a versão escolhida dos CRDs ao seu agrupamento do Kubernetes:

kubectl apply -f https://raw.githubusercontent.com/mongodb/mongodb-enterprise-kubernetes/<version>/crds.yaml

Use os Charts Helm do MongoDB para Kubernetes.

1

Você pode adicionar o Gráfico Helm do Operador Kubernetes localmente executando:

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

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

3

Execute o seguinte comando kubectl com a versão desejada do Kubernetes Operator para implantar os CRDs no cluster do Kubernetes:

kubectl apply -f https://raw.githubusercontent.com/mongodb/mongodb-enterprise-kubernetes/<version>/crds.yaml
4

Execute o seguinte comando helm para distribuir o Operador Kubernetes para o namespace padrão no seu cluster Kubernetes:

helm install --upgrade enterprise-operator mongodb/enterprise-operator

Você pode passar os sinalizadores --namespace e --create-namespace para distribuir o operador Kubernetes em um namespace não padrão, da seguinte forma:

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

O MongoDB reconstrói imagens do Kubernetes Operator todos os dias para integrar as atualizações mais recentes de segurança e sistema operacional.

Por padrão, o helm instala a compilação mais recente para a versão do Operador Kubernetes que você especifica.

Para instalar uma compilação anterior, especifique o ID de compilação como um parâmetro com --set build=<build-id>. Os ID de compilação estão sempre no formato -b<YYYYMMDD>T000000Z, onde <YYYYMMDD> é a data em que a compilação que você deseja usar foi criada.

Exemplo

Este exemplo mostra como instalar o Operador Kubernetes com a imagem mais recente:

helm install enterprise-operator mongodb/enterprise-operator

Este exemplo mostra como instalar o Kubernetes Operator com a imagem criada à meia-noite de 5 de fevereiro de 2021:

helm install enterprise-operator mongodb/enterprise-operator \
--set build=-b20210205T000000Z

Observação

O MongoDB recomenda usar a compilação padrão (mais recente).

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 valores-openshift.yaml arquivo.

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 Kubernetes distribui todos os recursos do seu cluster Kubernetes no namespace mongodb. Você pode distribuir recursos do Kubernetes Operator para um namespace diferente editando todos os valores para metadata.namespace em mongodb-enterprise-openshift.yaml:

##---
# Source: mongodb-enterprise-operator/templates/serviceaccount.yaml
---
apiVersion: v1
kind: ServiceAccount
metadata:
name: enterprise-operator
namespace: production
##---
# Source: mongodb-enterprise-operator/templates/operator.yaml
---
apiVersion: apps/v1
kind: Deployment
metadata:
name: enterprise-operator
namespace: production
---
# Example truncated
---
...
1

Invocar o seguinte comando git:

git clone https://github.com/mongodb/mongodb-enterprise-kubernetes.git
2

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

cd ~/mongodb-enterprise-kubernetes
3

Invoque o seguinte oc comando:

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.

5
---
# Source: mongodb-enterprise-operator/templates/serviceaccount.yaml
---
apiVersion: v1
kind: ServiceAccount
metadata:
name: enterprise-operator
namespace: mongodb
imagePullSecrets:
- name: <openshift-pull-secret>
---
apiVersion: v1
kind: ServiceAccount
metadata:
name: mongodb-enterprise-appdb
namespace: mongodb
imagePullSecrets:
- name: <openshift-pull-secret>
---
apiVersion: v1
kind: ServiceAccount
metadata:
name: mongodb-enterprise-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

Invoque o seguinte oc comando:

oc apply -f mongodb-enterprise-openshift.yaml

Use os Charts Helm do MongoDB para Kubernetes.

Você pode instalar o Operador Kubernetes com Helm 3.

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

Instale os Charts Helm do MongoDB para Kubernetes:

helm install enterprise-operator mongodb/enterprise-operator \
--values https://raw.githubusercontent.com/mongodb/helm-charts/main/charts/enterprise-operator/values-openshift.yaml

Use o valores-openshift.yaml configurações. Para saber mais sobre as configurações de instalação opcionais do Kubernetes Operator, consulte Configurações de instalação do Operator Helm.

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.

O MongoDB reconstrói imagens do Kubernetes Operator todos os dias para integrar as atualizações mais recentes de segurança e sistema operacional.

Por padrão, o helm instala a compilação mais recente para a versão do Operador Kubernetes que você especifica.

Para instalar uma compilação anterior, especifique o ID de compilação como um parâmetro com --set build=<build-id>. Os ID de compilação estão sempre no formato -b<YYYYMMDD>T000000Z, onde <YYYYMMDD> é a data em que a compilação que você deseja usar foi criada.

Exemplo

Este exemplo mostra como instalar o Operador Kubernetes com a imagem mais recente:

helm install enterprise-operator mongodb/enterprise-operator

Este exemplo mostra como instalar o Kubernetes Operator com a imagem criada à meia-noite de 5 de fevereiro de 2021:

helm install enterprise-operator mongodb/enterprise-operator \
--set build=-b20210205T000000Z

Observação

O MongoDB recomenda usar a compilação padrão (mais recente).

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

kubectl describe deployments mongodb-enterprise-operator -n <metadata.namespace>
oc describe deployments mongodb-enterprise-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-enterprise-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 o MongoDB Enterprise Kubernetes Operator, você pode: