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 no 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.
Adicione os Charts do 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 no qual 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
Instale o CustomResourceDefinitions para sistemas 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.
Instale o operador Kubernetes usando o seguinte comando oc:
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.
Adicione o repositório MongoDB Helm Charts for Kubernetes ao 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: