Instale o MongoDB Enterprise Kubernetes Operator
Nesta página
Pré-requisitos e considerações
Antes de instalar o Operador Kubernetes, certifique-se de planejar a instalação:
Escolha uma topologia de implantação.
Leia as considerações.
Conclua os pré- requisitos.
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.
Instalar com 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 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 ...
Opcional: Personalize o Operador Kubernetes YAML antes de instalá-lo.
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.
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
Use os Charts Helm do MongoDB para Kubernetes.
Adicionar os Charts MongoDB Helm para Kubernetes.
Você pode adicionar o Gráfico Helm do Operador Kubernetes localmente executando:
helm repo add mongodb https://mongodb.github.io/helm-charts
Personalize seu Gráfico Helm antes de implementá-lo.
Para saber mais sobre as configurações de instalação opcionais do Kubernetes Operator, consulte Configurações de instalação do Operator Helm.
Implemente o Operador Kubernetes.
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
Instalar uma compilação diária específica com o Helm
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).
Instalar com OpenShift
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 ...
Clone o repositório do MongoDB Enterprise Kubernetes Operator.
Invocar o seguinte comando git
:
git clone https://github.com/mongodb/mongodb-enterprise-kubernetes.git
Navegue até o diretório em que você clonou o repositório do MongoDB Enterprise Kubernetes Operator.
Por exemplo, se você clonou o repositório em seu diretório inicial, execute:
cd ~/mongodb-enterprise-kubernetes
Instalar as CustomResourceDefinitions para implementações do MongoDB .
Invoque o seguinte oc comando:
oc apply -f crds.yaml
Opcional: personalize o Kubernetes Operator YAML antes de instalá-lo.
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.
Adicione seu <openshift-pull-secret>
às ServiceAccount
definições do no Operador Kubernetes YAML antes de instalá-lo.
# 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.
Use os Charts Helm do MongoDB para Kubernetes.
Você pode instalar o Operador Kubernetes com Helm 3.
Adicionar os Charts MongoDB Helm para Kubernetes repositório para o Helm.
helm repo add mongodb https://mongodb.github.io/helm-charts
Instale o Operador Kubernetes utilizando helm
o .
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.
Instalar uma compilação diária específica com o Helm
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).
Verificar a instalação
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.
Próximos passos
Após instalar o MongoDB Enterprise Kubernetes Operator, você pode: