ANNOUNCEMENT: Voyage AI joins MongoDB to power more accurate and trustworthy AI applications on Atlas.
Learn more
Menu Docs

Operador de Kubernetes do MongoDB Enterprise Kubernetes Operator kubectl e oc Configurações de instalação

Para fornecer configurações opcionais, edite o arquivo YAML que corresponde ao seu tipo de sistema no diretório onde você clonou o repositório do Kubernetes Operator:

  • Kubernetes de baunilha usando kubectl: mongodb-enterprise.yaml

  • OpenShift usando oc: mongodb-enterprise-openshift.yaml

Se a configuração que você deseja adicionar não existir no arquivo YAML , adicione-a como uma nova array de mapeamentos de pares de valores-chave no arquivo spec.template.spec.containers.name.env. collection:

  • Defina o valor da chave spec.template.spec.containers.name.env.name para o nome da configuração.

  • Defina o valor da chave spec.template.spec.containers.name.env.value para o valor da configuração.

Para preencher valores para imagens de container, consulte Imagens de container.

1spec:
2 template:
3 spec:
4 serviceAccountName: mongodb-enterprise-operator
5 containers:
6 - name: mongodb-enterprise-operator
7 image: <operatorVersionUrl>
8 imagePullPolicy: <policyChoice>
9 env:
10 - name: INIT_APPDB_IMAGE_REPOSITORY
11 value: quay.io/mongodb/mongodb-enterprise-init-appdb-ubi

URL do repositório do qual o Operador Kubernetes baixa a imagem do MongoDB Agent para sistemas de banco de banco de dados não estáticos. Inclua a versão do MongoDB Agent . Para saber mais, consulte Imagens de Container.

1spec:
2 template:
3 spec:
4 serviceAccountName: mongodb-enterprise-operator
5 containers:
6 - name: mongodb-enterprise-operator
7 image: <operatorVersionUrl>
8 imagePullPolicy: <policyChoice>
9 env:
10 - name: AGENT_IMAGE
11 value: quay.io/mongodb/mongodb-agent-ubi:<version>

Versão da imagem que contém o MongoDB Agent usado pelo banco de dados de aplicação.

O valor padrão é 10.2.15.5958-1_4.2.11-ent.

1spec:
2 template:
3 spec:
4 serviceAccountName: mongodb-enterprise-operator
5 containers:
6 - name: mongodb-enterprise-operator
7 image: <operatorVersionUrl>
8 imagePullPolicy: <policyChoice>
9 env:
10 - name: APPDB_AGENT_VERSION
11 value: 10.2.15.5958-1_4.2.11-ent

URL do repositório do qual o Kubernetes Operator baixa a imagem do aplicativo de banco de dados.

1spec:
2 template:
3 spec:
4 serviceAccountName: mongodb-enterprise-operator
5 containers:
6 - name: mongodb-enterprise-operator
7 image: <operatorVersionUrl>
8 imagePullPolicy: <policyChoice>
9 env:
10 - name: APPDB_IMAGE_REPOSITORY
11 value: quay.io/mongodb/mongodb-enterprise-appdb-ubi

Tempo, em segundos, o Operador Kubernetes tenta se conectar ao servidor de API Kubernetes de um cluster endpoint. Esse tempo limite é definido para todos os clusters Kubernetes em sistemas do MongoDB de vários clusters Kubernetes. Se o Kubernetes Operator não receber uma resposta do servidor da API do Kubernetes dentro do tempo especificado, ele registrará o status do cluster como "não íntegro". Para saber mais, consulte Solução de problemas de clusters Kubernetes.

O valor padrão é 10 .

1spec:
2 template:
3 spec:
4 serviceAccountName: mongodb-enterprise-operator
5 containers:
6 - name: mongodb-enterprise-operator
7 image: <operatorVersionUrl>
8 imagePullPolicy: <policyChoice>
9 env:
10 - name: CLUSTER_CLIENT_TIMEOUT
11 value: 10

Versão da imagem do MongoDB Enterprise reconhecimento de data center que o Kubernetes Operator implementa.

1spec:
2 template:
3 spec:
4 serviceAccountName: mongodb-enterprise-operator
5 containers:
6 - name: mongodb-enterprise-operator
7 image: <operatorVersionUrl>
8 imagePullPolicy: <policyChoice>
9 env:
10 - name: DATABASE_VERSION
11 value: 1.32

Política de pull para a imagem do banco de dados MongoDB Enterprise que o Kubernetes Operator implementa.

O Operador Kubernetes aceita os seguintes valores: Sempre, IfNotPresent, Nunca.

O valor padrão é Sempre.

URL do repositório do qual a imagem initContainer que contém os scripts de inicialização do banco de dados de aplicação e o teste de preparação é baixada.

1spec:
2 template:
3 spec:
4 serviceAccountName: mongodb-enterprise-operator
5 containers:
6 - name: mongodb-enterprise-operator
7 image: <operatorVersionUrl>
8 imagePullPolicy: <policyChoice>
9 env:
10 - name: INIT_APPDB_IMAGE_REPOSITORY
11 value: quay.io/mongodb/mongodb-enterprise-init-appdb-ubi

Versão da imagem initContainer que contém os scripts de inicialização do banco de dados de aplicação e o teste de preparação.

O valor padrão é 1.32.

1spec:
2 template:
3 spec:
4 serviceAccountName: mongodb-enterprise-operator
5 containers:
6 - name: mongodb-enterprise-operator
7 image: <operatorVersionUrl>
8 imagePullPolicy: <policyChoice>
9 env:
10 - name: INIT_APPDB_VERSION
11 value: 1.32

URL do repositório do qual a imagem initContainer que contém os scripts de inicialização do MongoDB Agent e o teste de preparação é baixada.

1spec:
2 template:
3 spec:
4 serviceAccountName: mongodb-enterprise-operator
5 containers:
6 - name: mongodb-enterprise-operator
7 image: <operatorVersionUrl>
8 imagePullPolicy: <policyChoice>
9 env:
10 - name: INIT_DATABASE_IMAGE_REPOSITORY
11 value: quay.io/mongodb/mongodb-enterprise-init-database-ubi

Versão da imagem initContainer que contém os scripts de inicialização do MongoDB Agent e o teste de preparação.

O valor padrão é 1.32.

1spec:
2 template:
3 spec:
4 serviceAccountName: mongodb-enterprise-operator
5 containers:
6 - name: mongodb-enterprise-operator
7 image: <operatorVersionUrl>
8 imagePullPolicy: <policyChoice>
9 env:
10 - name: INIT_DATABASE_VERSION
11 value: 1.32

URL do repositório do qual a imagem initContainer que contém os scripts de inicialização do Ops Manager e o teste de preparação é baixada.

1spec:
2 template:
3 spec:
4 serviceAccountName: mongodb-enterprise-operator
5 containers:
6 - name: mongodb-enterprise-operator
7 image: <operatorVersionUrl>
8 imagePullPolicy: <policyChoice>
9 env:
10 - name: INIT_OPS_MANAGER_IMAGE_REPOSITORY
11 value: quay.io/mongodb/mongodb-enterprise-init-ops-manager-ubi

Versão da imagem initContainer que contém os scripts de inicialização do Ops Manager e o teste de preparação.

O valor padrão é 1.32.

1spec:
2 template:
3 spec:
4 serviceAccountName: mongodb-enterprise-operator
5 containers:
6 - name: mongodb-enterprise-operator
7 image: <operatorVersionUrl>
8 imagePullPolicy: <policyChoice>
9 env:
10 - name: INIT_OPS_MANAGER_VERSION
11 value: 1.32

Caminho para os arquivos de backup rotacionados do readiness.log mantidos pelo Readiness Probe.

O valor padrão é /var/log/mongodb-mms-automation/readiness.log.

1spec:
2 template:
3 spec:
4 serviceAccountName: mongodb-enterprise-operator
5 containers:
6 - name: mongodb-enterprise-operator
7 image: <operatorVersionUrl>
8 imagePullPolicy: <policyChoice>
9 env:
10 - name: LOG_FILE_PATH
11 value: /var/log/mongodb-mms-automation/readiness.log

Sinalizador que determina se o Kubernetes Operator herda ou não as configurações de securityContext que seu cluster do Kubernetes managed.

Este valor deve ser verdadeiro se você deseja executar o Operador Kubernetes no OpenShift ou em um ambiente restritivo.

O valor padrão é falso.

1spec:
2 template:
3 spec:
4 serviceAccountName: mongodb-enterprise-operator
5 containers:
6 - name: mongodb-enterprise-operator
7 image: <operatorVersionUrl>
8 imagePullPolicy: <policyChoice>
9 env:
10 - name: MANAGED_SECURITY_CONTEXT
11 value: false

O valor padrão é verdadeiro .

1spec:
2 template:
3 spec:
4 serviceAccountName: mongodb-enterprise-operator
5 containers:
6 - name: mongodb-enterprise-operator
7 image: <operatorVersionUrl>
8 imagePullPolicy: <policyChoice>
9 env:
10 - name: MANAGED_SECURITY_CONTEXT
11 value: true

URL do repositório do qual o Operador Kubernetes baixa a imagem do MongoDB Agent para sistemas de banco de dados de dados. Para saber mais, consulte Imagens de Container.

1spec:
2 template:
3 spec:
4 serviceAccountName: mongodb-enterprise-operator
5 containers:
6 - name: mongodb-enterprise-operator
7 image: <operatorVersionUrl>
8 imagePullPolicy: <policyChoice>
9 env:
10 - name: MDB_AGENT_IMAGE_REPOSITORY
11 value: quay.io/mongodb/mongodb-agent-ubi

No Kubernetes Operator 1.20, o registro de contêiner alterado para a imagem do banco de dados de aplicativo e as imagens usam um novo sufixo de tag. Quando você atualiza o Operador Kubernetes, o Operador Kubernetes atualiza automaticamente o sufixo anterior, -ent, para todas as imagens que fazem referência ao novo registro de contêiner para -ubi8 ou o sufixo definido em MDB_IMAGE_TYPE ou mongodb.imageType.

Por exemplo, o Operador Kubernetes altera quay.io/mongodb/mongodb-enterprise-server:4.4.5-ent para quay.io/mongodb/mongodb-enterprise-server:4.4.5-ubi8 .

Para impedir que o Operador Kubernetes atualize automaticamente o sufixo, defina MDB_APPDB_ASSUME_OLD_FORMAT ou mongodb.appdbAssumeOldFormat como true. Por exemplo, talvez você queira interromper a alteração automática do sufixo se estiver espelhando essa imagem a partir do seu próprio repositório.

O valor padrão é false, que atualiza automaticamente o sufixo da imagem.

1spec:
2 template:
3 spec:
4 serviceAccountName: mongodb-enterprise-operator
5 containers:
6 - name: mongodb-enterprise-operator
7 image: <operatorVersionUrl>
8 imagePullPolicy: <policyChoice>
9 env:
10 - name: MDB_APPDB_ASSUME_OLD_FORMAT
11 value: false

Sinalizador que determina se o Kubernetes Operator habilita ou não a recuperação automática para recursos do MongoDB por Pod.

O valor padrão é verdadeiro .

1spec:
2 template:
3 spec:
4 serviceAccountName: mongodb-enterprise-operator
5 containers:
6 - name: mongodb-enterprise-operator
7 image: <operatorVersionUrl>
8 imagePullPolicy: <policyChoice>
9 env:
10 - name: MDB_AUTOMATIC_RECOVERY_ENABLE
11 value: false

Número de segundos que um recurso personalizado pode permanecer em um estado Pending ou Failed antes de o Operador Kubernetes recuperar automaticamente seus recursos MongoDB .

O valor padrão é 1200 segundos (20 minutos).

Para desabilitar a recuperação automática, configure a variável de ambiente MDB_AUTOMATIC_RECOVERY_ENABLE para false.

1spec:
2 template:
3 spec:
4 serviceAccountName: mongodb-enterprise-operator
5 containers:
6 - name: mongodb-enterprise-operator
7 image: <operatorVersionUrl>
8 imagePullPolicy: <policyChoice>
9 env:
10 - name: MDB_AUTOMATIC_RECOVERY_BACKOFF_TIME_S
11 value: 3600

Determina a arquitetura de containers usada por todos os seus sistemas:

Para habilitar containers estáticos para uma única implantação, use metadata.annotations.mongodb.com/v1.architecture no recurso MongoDB .

O padrão é non-static.

Para habilitar contêineres estáticos, defina como static.

1spec:
2 template:
3 spec:
4 serviceAccountName: mongodb-enterprise-operator
5 containers:
6 - name: mongodb-enterprise-operator
7 image: <operatorVersionUrl>
8 imagePullPolicy: <policyChoice>
9 env:
10 - name: MDB_DEFAULT_ARCHITECTURE
11 value: static

O sufixo da imagem do banco de dados do aplicativo .

No Kubernetes Operator 1.20, o registro de contêiner alterado para a imagem do banco de dados de aplicativo e as imagens usam um novo sufixo de tag. Quando você atualiza o Operador Kubernetes, o Operador Kubernetes atualiza automaticamente o sufixo anterior, -ent, para todas as imagens que fazem referência ao novo registro de contêiner para -ubi8 ou o sufixo definido em MDB_IMAGE_TYPE ou mongodb.imageType.

Por exemplo, o Operador Kubernetes altera quay.io/mongodb/mongodb-enterprise-server:4.4.5-ent para quay.io/mongodb/mongodb-enterprise-server:4.4.5-ubi8 .

Para impedir que o Operador Kubernetes atualize automaticamente o sufixo, defina MDB_APPDB_ASSUME_OLD_FORMAT ou mongodb.appdbAssumeOldFormat como true. Por exemplo, talvez você queira interromper a alteração automática do sufixo se estiver espelhando essa imagem a partir do seu próprio repositório.

O padrão é -ubi8.

1spec:
2 template:
3 spec:
4 serviceAccountName: mongodb-enterprise-operator
5 containers:
6 - name: mongodb-enterprise-operator
7 image: <operatorVersionUrl>
8 imagePullPolicy: <policyChoice>
9 env:
10 - name: MDB_IMAGE_TYPE
11 value: ubi8

Controla se os arquivos de log são enviados para a saída padrão, como quando você executa kubectl describe.

O padrão é true.

1spec:
2 template:
3 spec:
4 serviceAccountName: mongodb-enterprise-operator
5 containers:
6 - name: mongodb-enterprise-operator
7 image: <operatorVersionUrl>
8 imagePullPolicy: <policyChoice>
9 env:
10 - name: MDB_WITH_AGENT_FILE_LOGGING
11 value: true

O número de processos de reconciliação simultâneos que o Kubernetes Operator pode executar.

Exemplo

1spec:
2 template:
3 spec:
4 serviceAccountName: mongodb-enterprise-operator
5 containers:
6 - env:
7 - name: MDB_MAX_CONCURRENT_RECONCILES
8 value: "10"

Enables the Kubernetes Operator to collect and send telemetry to MongoDB for analysis. MDB_OPERATOR_TELEMETRY_SEND_ENABLED must also be set to true for the Kubernetes Operator to send telemetry to MongoDB.

The default is true. If set to false, the Kubernetes Operator doesn't collect or send telemetry to MongoDB.

1spec:
2 template:
3 spec:
4 serviceAccountName: mongodb-enterprise-operator
5 containers:
6 - env:
7 - name: MDB_OPERATOR_TELEMETRY_ENABLED
8 value: "true"

Enables the Kubernetes Operator to send telemetry to MongoDB for analysis. MDB_OPERATOR_TELEMETRY_ENABLED must also be set to true for the Kubernetes Operator to send telemetry.

The default is true. If set to false, the Kubernetes Operator collects telemetry in the ConfigMap named mongodb-enterprise-operator-telemetry, but doesn't send it to MongoDB.

1spec:
2 template:
3 spec:
4 serviceAccountName: mongodb-enterprise-operator
5 containers:
6 - env:
7 - name: MDB_OPERATOR_TELEMETRY_SEND_ENABLED
8 value: "true"

Permite que o operador Kubernetes funcione em ambientes restritos a proxy. Defina essa variável como true junto com as configurações de proxy padrão (HTTP_PROXY, HTTPS_PROXY, NO_PROXY) para propagar essas configurações de proxy do Kubernetes Operator Pod para os MongoDB Agents, permitindo que todos os componentes se comuniquem de forma eficaz por meio do especificado proxies.

Exemplo

1spec:
2 template:
3 spec:
4 serviceAccountName: mongodb-enterprise-operator
5 containers:
6 - env:
7 - name: MDB_PROPAGATE_PROXY_ENV
8 value: "true"
9 - name: HTTP_PROXY
10 value: "http://example-http-proxy:7312"
11 - name: HTTPS_PROXY
12 value: "https://secure-proxy:3242"
13 - name: NO_PROXY
14 value: "google.com"

URL da imagem do MongoDB Enterprise reconhecimento de data center que o Kubernetes Operator implementa.

1spec:
2 template:
3 spec:
4 serviceAccountName: mongodb-enterprise-operator
5 containers:
6 - name: mongodb-enterprise-operator
7 image: <operatorVersionUrl>
8 imagePullPolicy: <policyChoice>
9 env:
10 - name: MONGODB_ENTERPRISE_DATABASE_IMAGE
11 value: quay.io/mongodb/mongodb-enterprise-database-ubi

Etiqueta para o ambiente de implementação dos Operadores Kubernetes. Esse valor afeta os tempos limite padrão e o nível e o formato do registro:

Se o valor for
O nível de registro está definido como
O formato de registro está definido como

dev

debug

text

prod

informações

JSON

O valor padrão é prod.

Política de pull para as MongoDB Ops Manager imagens do que o Kubernetes Operator implementa.

O Operador Kubernetes aceita os seguintes valores: Sempre, IfNotPresent e Nunca.

O valor padrão é Sempre.

1spec:
2 template:
3 spec:
4 serviceAccountName: mongodb-enterprise-operator
5 containers:
6 - name: mongodb-enterprise-operator
7 image: <operatorVersionUrl>
8 imagePullPolicy: <policyChoice>
9 env:
10 - name: OPS_MANAGER_IMAGE_PULL_POLICY
11 value: Always

URL do repositório do qual a imagem de um recurso do Ops Manager é baixada.

1spec:
2 template:
3 spec:
4 serviceAccountName: mongodb-enterprise-operator
5 containers:
6 - name: mongodb-enterprise-operator
7 image: <operatorVersionUrl>
8 imagePullPolicy: <policyChoice>
9 env:
10 - name: OPS_MANAGER_IMAGE_REPOSITORY
11 value: quay.io/mongodb/mongodb-enterprise-ops-manager-ubi

O número de arquivos de backup readiness.log rotacionados e mantidos pelo Readiness Probe.

O valor padrão é 5 .

1spec:
2 template:
3 spec:
4 serviceAccountName: mongodb-enterprise-operator
5 containers:
6 - name: mongodb-enterprise-operator
7 image: <operatorVersionUrl>
8 imagePullPolicy: <policyChoice>
9 env:
10 - name: READINESS_PROBE_LOGGER_BACKUPS
11 value: 1

Controla se os arquivos de backup do readiness.log rotacionados mantidos pela Probe Readiness são compactados para arquivos readiness.log.gz .

O valor padrão é false, que deixa os arquivos readiness.log descompactados.

1spec:
2 template:
3 spec:
4 serviceAccountName: mongodb-enterprise-operator
5 containers:
6 - name: mongodb-enterprise-operator
7 image: <operatorVersionUrl>
8 imagePullPolicy: <policyChoice>
9 env:
10 - name: READINESS_PROBE_LOGGER_COMPRESS
11 value: true

O tamanho máximo do arquivo readiness.log em MB.

O valor padrão é 100.

1spec:
2 template:
3 spec:
4 serviceAccountName: mongodb-enterprise-operator
5 containers:
6 - name: mongodb-enterprise-operator
7 image: <operatorVersionUrl>
8 imagePullPolicy: <policyChoice>
9 env:
10 - name: READINESS_PROBE_LOGGER_MAX_SIZE
11 value: 125

O número máximo de dias para reter arquivos readiness.log rotacionados, começando com a data no carimbo de data/hora do arquivo. Se definido como 0, o Kubernetes Operator não remove readiness.log arquivos com base na idade, mas depende de READINESS_PROBE_LOGGER_BACKUPS para determinar a retenção.

O valor padrão é 0 .

1spec:
2 template:
3 spec:
4 serviceAccountName: mongodb-enterprise-operator
5 containers:
6 - name: mongodb-enterprise-operator
7 image: <operatorVersionUrl>
8 imagePullPolicy: <policyChoice>
9 env:
10 - name: READINESS_PROBE_LOGGER_MAX_AGE
11 value: 3

Namespaces que o Operador do Kubernetes observa quanto a alterações de recursos MongoDB . Se este namespace for diferente do padrão, certifique-se de que a conta do serviço do operador Kubernetes possa acessar esse namespace.

  • Para observar todos os namespaces, especifique * e atribua o ClusterRole para a mongodb-enterprise-operator ServiceAccount que você usa para executar o Kubernetes Operator.

  • Para observar um subconjunto de todos os namespaces, especifique-os em uma lista separada por vírgula, escape de cada vírgula com uma barra invertida e coloque a lista entre aspas, como "operator.watchNamespace=ns1\,ns2".

Observar um subconjunto de namespaces é útil em sistemas em que uma única instância do Kubernetes Operator observa um tipo de recurso de cluster diferente. Por exemplo, você pode configurar o Operador Kubernetes para observar recursos do MongoDB em um subconjunto de namespaces e para monitorar recursos do MongoDBMultiCluster em outro subconjunto de namespaces. Para evitar condições de corrida durante a reconciliação de recursos, para cada tipo de recurso personalizado que você deseja que o Operador Kubernetes assista, certifique-se de definir o escopo para um subconjunto distinto de namespaces.

Importante

Para implantar recursos MongoDB Ops Manager MongoDB do e do em um ou mais namespaces diferente daquele em que você implanta o Kubernetes Operator, consulte Definir escopo para a MongoDB Enterprise Kubernetes Operator implantação do para obter os valores que você deve usar e as etapas adicionais que podem ser necessárias.

O valor padrão é <metadata.namespace>.