Notas de versão do MongoDB Enterprise Kubernetes Operator
Nesta página
- MongoDB Enterprise Kubernetes Operator 1.26 Enterprise Série
- MongoDB Enterprise Kubernetes Operator 1.25 Enterprise Série
- MongoDB Enterprise Kubernetes Operator 1.24 Enterprise Série
- MongoDB Enterprise Kubernetes Operator Série 1.23
- MongoDB Enterprise Kubernetes Operator série 1.22
- MongoDB Enterprise Kubernetes Operator série 1.21
- Notas de versão mais antigas
MongoDB Enterprise Kubernetes Operator 1.26 Enterprise Série
MongoDB Enterprise Kubernetes Operator 1.26.0Enterprise
Lançado 2024-06-21
Novas funcionalidades
Melhora a utilização da CPU e o dimensionamento vertical do Operador Kubernetes e consegue uma reconciliação mais rápida de todos os recursos gerenciados, permitindo o controle do número de reconciliações que o Operador Kubernetes pode realizar em paralelo.
Você pode definir
MDB_MAX_CONCURRENT_RECONCILES
para a implantação do Kubernetes Operator ouoperator.maxConcurrentReconciles
no gráfico Helm de instalação do Kubernetes Operator. Se não for fornecido, o valor padrão será 1. A capacidade de controlar o número de reconciliações pode levar a um aumento da carga no MongoDB Ops Manager e no Kubernetes API servidor da do na mesma janela de tempo. Observe o uso do recurso do Kubernetes Operator e ajusteoperator.resources.requests
eoperator.resources.limits
se necessário. Para saber mais, consulte Gerenciamento de recursos para Pods e contêineres na documentação do Kubernetes.Adiciona suporte para OpenShift 4.15. Para saber mais, consulte Compatibilidade do operadorMongoDB Enterprise Kubernetes Operator .
Alterações na instalação do gráfico Helm
Adiciona um parâmetro
operator.maxConcurrentReconciles
que permite controlar o número de reconciliações que o Operador Kubernetes pode executar em paralelo. O valor padrão é 1.Adiciona o operador.webhook.installClusterRole Parâmetro que controla se deseja instalar a função de cluster, permitindo que o Operador Kubernetes configure webhooks de entrada. Defina este parâmetro como
false
quando as funções de cluster não forem permitidas. O valor padrão étrue
.
Correções de Bugs
Recurso MongoDB : corrige um bug em que a configuração de um recurso MongoDB com várias entradas no
spec.agent.startupOptions
causaria reconciliação adicional desnecessária doStatefulSet
subjacente.Recursos do MongoDB, MongoDBMultiCluster : Corrige um bug em que o Kubernetes Operator não observava alterações nos certificados X-509 configurados para a autenticação do MongoDB Agent .
Recurso MongoDB : corrige um bug em que os sinalizadores booleanos passados para o MongoDB Agent não podem ser definidos como
false
se o valor padrão fortrue
.
MongoDB Enterprise Kubernetes Operator 1.25 Enterprise Série
MongoDB Enterprise Kubernetes Operator 1.25.0Enterprise
Lançado 2024-04-30
alteração interruptiva
Recurso MongoDBOpsManager . O Operador Kubernetes não é mais compatível com o MongoDB Ops Manager 5.0. Atualize para uma versão posterior do MongoDB Ops Manager. Embora o MongoDB Ops Manager 5.0 possa continuar funcionando com o Kubernetes Operator, o MongoDB não testará o Kubernetes Operator no MongoDB Ops Manager 5.0.
Novas funcionalidades
Recurso MongoDBOpsManager : adiciona suporte para distribuir o aplicativo MongoDB Ops Manager em vários clusters Kubernetes . Para saber mais, consulte Implantar recursos MongoDB Ops Manager em vários clusters Kubernetes .
(Pré-visualização pública) MongoDB, recursos do OpsManager : introduz contêineres estáticos opt-in (prévia pública) para todos os tipos de sistemas.
Nesta versão, use contêineres estáticos somente para fins de teste. Os containers estáticos podem se tornar o padrão em uma versão posterior.
Para ativar o modo de contêineres estáticos, defina a variável de ambiente
MDB_DEFAULT_ARCHITECTURE
no nível do Operador Kubernetes comostatic
. Como alternativa, anote umMongoDB
ouOpsManager
recurso personalizado específico commongodb.com/v1.architecture: "static"
.O Operador Kubernetes oferece suporte à migração contínua entre arquiteturas estáticas e não estáticas. Para saber mais, consulte:
Recurso OpsManager : adiciona o campo
spec.internalConnectivity
para permitir substituições para o serviço usado pelo Operador Kubernetes para garantir a conectividade interna com os Pods de hospedagem de recursosOpsManager
.Recurso MongoDB : você pode recuperar um recurso devido a uma configuração de automação quebrada em clusters fragmentados. Em versões anteriores, você pôde recuperar outros tipos de recursos, mas não clusters fragmentados. Para saber mais, consulte Recuperar recurso devido a configuração de automação quebrada.
Recursos MongoDB, MongoDBMultiCluster : Esses recursos agora permitem adicionar espaços reservados em serviços externos.
Você pode definir anotações para serviços externos gerenciados pelo Operador Kubernetes que contêm espaços reservados que serão automaticamente substituídos pelos valores adequados. Anteriormente, o Operador Kubernetes configurava as mesmas anotações para todos os serviços externos criados para cada Pod. A partir desta versão, você pode adicionar espaços reservados para que o Kubernetes Operator possa personalizar anotações em cada serviço com valores relevantes e exclusivos para cada Pod específico. Para saber mais, consulte:
MongoDB
recurso:spec.externalAccess.externalService.annotations
MongoDBMultiCluster
recurso spec.externalAccess.externalService.annotations
O plugin
kubectl mongodb
: Permite imprimir informações de construção ao utilizar o plugin.O comando
setup
do plugin-inkubectl mongodb
: Adiciona o registro.imagePullSecrets configuração. Se especificado, as contas de serviço criadas fazem referência ao segredo especificado no campoimagePullSecrets
.Melhora o gerenciamento de configurações quando o Kubernetes Operator observa mais de um namespace e quando você instala o Kubernetes Operator em um namespace diferente do namespace no qual o Kubernetes Operator monitora recursos.
Otimiza a configuração de roles e permissões em clusters de membros do Kubernetes usando uma única conta de serviço por cluster do Kubernetes com roles e vinculações de funções configuradas corretamente (nenhuma função de cluster é necessária) para cada namespace assistido.
Amplia o processo de reconciliação baseado em eventos existente por uma reconciliação baseada em tempo que é acionada a cada 24 horas. Isso garante que todos os agentes de monitoramento sejam sempre atualizados em tempo hábil.
OpenShift e OLM Operator: remove o requisito de permissões em todo o cluster. Anteriormente, o Operador Kubernetes precisava dessas permissões para configurar webhooks de entrada. A partir desta versão, os webhooks são configurados automaticamente pelo OLM.
Adiciona uma variável de ambiente opcional do
MDB_WEBHOOK_REGISTER_CONFIGURATION
para o Operador Kubernetes. A variável controla se o Kubernetes Operator deve executar a configuração automática do webhook de entrada. O padrão étrue
. A variável é definida comofalse
para sistemas OLM e OpenShift.
Alterações na instalação do gráfico Helm
Altera o
agent.version
padrão para107.0.0.8502-1
. Isso altera o agente padrão usado nos sistemas do Kubernetes Operator que você instala usando um gráfico Helm.Adiciona a variável
operator.additionalArguments
com o padrão de[]
para permitir que você passe argumentos adicionais para o binário do Operador Kubernetes.Adiciona a variável
operator.createResourcesServiceAccountsAndRoles
com o padrão detrue
para controlar se deve instalar funções e contas de serviço para recursosMongoDB
eOpsManager
. Quando você usa o plug-inkubectl mongodb
para configurar o Operador Kubernetes para uma implantação de cluster multi-Kubernetes, o plug-in instala todas as funções e contas de serviço necessárias. Portanto, para evitar conflitos, em alguns casos, não instale essas funções usando o gráfico do Helm do Operador Kubernetes.
Correções de Bugs
Recurso MongoDBMultiCluster : corrige um problema em que o Operador Kubernetes relatou que os campos
spec.externalAccess.externalDomain
espec.clusterSpecList[*].externalAccess.externalDomains
eram necessários mesmo embora não fossem usados. O Operador Kubernetes acionou prematuramente uma validação para estes campos nos casos em que os recursos personalizados continham uma estruturaspec.externalAccess
definida. A partir desta versão, o Operador Kubernetes verifica a exclusividade de domínios externos somente quando você define os domínios externos nas configuraçõesspec.externalAccess.externalDomain
ouspec.clusterSpecList[*].externalAccess.externalDomains
.Recurso MongoDB : corrige um bug em que, ao excluir um recurso
MongoDB
, as políticascontrolledFeature
permaneciam definidas na instância relacionada do MongoDB Ops Manager ou Cloud Manager , tornando a limpeza na interface do usuário impossível no caso de perda do Operador Kubernetes .Recurso OpsManager : corrige um problema em que o segredo
admin-key
foi excluído quando você removeu o recurso personalizadoOpsManager
. A correção da exclusão secretaadmin-key
facilita a reinstalação do MongoDB Ops Manager.Teste de preparação do MongoDB: Corrige uma mensagem de erro enganosa para o teste de preparação:
"... kubelet Readiness probe failed:..."
. Isso afeta todas as implantações do MongoDB.Operador: corrige casos em que, em algumas instâncias, durante a comunicação com o recurso personalizado do
OpsManager
, o Operador Kubernetes ignorou a verificação do TLS, mesmo que você tenha ativado o TLS.
Melhorias
Plug- in Kubectl: Os
kubectl mongodb
binários do plug-in lançados agora estão assinados e as assinaturas são publicadas com os ativos de versão . A chave pública está disponível neste endereço. Os binários de plug-inkubectl mongodb
lançados também são notarizados para MacOS.Imagens liberadas assinadas: Todas as imagens de container publicadas para o Operador Kubernetes são assinadas criptograficamente. Isso é visível no MongoDB Quay registro. Você pode verificar as assinaturas usando a chave pública MongoDB. As imagens lançadas estão disponíveis neste endereço.
MongoDB Enterprise Kubernetes Operator 1.24 Enterprise Série
MongoDB Enterprise Kubernetes Operator 1.24.0Enterprise
Lançado 2023-12-21
MongoDBOpsManager Resource
Novas funcionalidades
Adiciona suporte para o próximo MongoDB Ops Manager 7.0.x série.
Correções de Bugs
Corrige um problema que impediu o encerramento correto de um backup.
MongoDB Enterprise Kubernetes Operator Série 1.23
MongoDB Enterprise Kubernetes Operator série 1.23.0
Lançado em 13/11/2023
Avisos e mudanças significativas
Alinha os números da versão da imagem do componente com a tag de lançamento do Kubernetes Operator para que fique claro quais imagens combinam com qual versão do Kubernetes Operator. Isso afeta as seguintes imagens:
quay.io/mongodb/mongodb-enterprise-database-ubi
quay.io/mongodb/mongodb-enterprise-init-database-ubi
quay.io/mongodb/mongodb-enterprise-init-appdb-ubi
quay.io/mongodb/mongodb-enterprise-init-ops-manager-ubi
Para saber mais, consulte MongoDB Enterprise Kubernetes Operator kubectl e oc Configurações de instalação e Configurações de instalação do MongoDB Enterprise Kubernetes Operator Helm.
Substitui
spec.exposedExternally
(descontinuado no Kubernetes Operator 1.19) porspec.externalAccess
.
Correções de Bugs
Corrige um problema ao dimensionar um conjunto de réplicas em um sistema MongoDB de cluster multi-Kubernetes quando um cluster de membros perdeu conectividade. A correção aborda os procedimentos de recuperação manuais e automatizados.
Corrige um problema em que a alteração dos nomes dos logs de auditoria do agente de automação e do MongoDB impedia que eles fossem enviados para os logs do Pod do Kubernetes. Não há restrições sobre os nomes de arquivos dos logs de auditoria MongoDB a partir do Kubernetes Operator 1.22.
Permite que os seguintes novos tipos de registro do contêiner
mongodb-enterprise-database
fluam diretamente para logs do Kubernetes:agent-launcher-script
monitoring-agent
backup-agent
Corrige um problema que impediu o armazenamento do recurso
MongoDBUser
no namespace configurado nospec.mongodbResourceRef.namespace
.
MongoDB Enterprise Kubernetes Operator série 1.22
MongoDB Enterprise Kubernetes Operator 1.22.0
Lançado em 21/09/2023
Mudanças de última hora
O Operador Kubernetes não utiliza mais o estado Reconciling
para todos os recursos personalizados. Na maioria dos casos, este estado foi substituído por Pending
e uma mensagem correspondente. Se você utilizar ferramentas de monitoramento com os recursos MongoDB personalizados implantados com o Kubernetes Operator, você poderá precisar ajustar seus painéis e regras de alerta para utilizar o nome de estado do Pending
.
MongoDBOpsManager Resource
Melhorias
Adiciona suporte para configurar logRotate no MongoDB Agent para o Banco de Dados de Aplicativo adicionando os seguintes novos campos ao recurso
MongoDBOpsManager
:Agora, você pode configurar o systemLog para enviar logs para um local personalizado diferente do diretório
/var/log/mongodb-mms-automation
padrão utilizando os seguintes novos campos no recursoMongoDBOpsManager
:Melhora o tratamento de clusters de bancos de dados de aplicativos em sistemas MongoDB de vários clusters Kubernetes.
Na última versão, para reduzir os processos, o Kubernetes Operator exigiu uma conexão com o cluster do Kubernetes. Isso pode bloquear o processo de reconciliação devido a uma interrupção do cluster completo.
Nesta versão, o Kubernetes Operator gerencia com sucesso os clusters íntegros restantes, desde que eles tenham a maioria dos votos para eleger um primário. O Kubernetes Operator não remove os processos associados da configuração de automação e configuração do conjunto de réplicas. O Kubernetes Operator exclui estes processos somente se você excluir o cluster correspondente do
spec.applicationDatabase.clusterSpecList
ou alterar o número de membros do cluster para zero. Quando o Kubernetes Operator exclui esses processos, ele reduz o dimensionamento do conjunto de réplicas removendo os processos vinculados a esse cluster, um de cada vez.
MongoDB
Resource
Melhorias
Adiciona um mecanismo de recuperação automática para recursos
MongoDB
quando um recurso personalizado permanece em um estadoPending
ouFailed
por um longo período de tempo. Além disso, introduz as seguintes variáveis de ambiente:Para saber mais, consulte Recuperar recurso devido a configuração de automação quebrada.
Permite rotear os registros de auditoria do recurso
MongoDB
para os registros do Kubernetes Pod. Certifique-se de gravar os registros de auditoria do recursoMongoDB
no arquivo/var/log/mongodb-mms-automation/mongodb-audit.log
. O Pod que hospeda o recurso monitora este arquivo e anexa seu conteúdo aos logs do Kubernetes.Para enviar registros de auditoria para os registros do pod do Kubernetes, use o seguinte exemplo de configuração no recurso
MongoDB
:spec: additionalMongodConfig: auditLog: destination: file format: JSON path: /var/log/mongodb-mms-automation/mongodb-audit.log As entradas de registro de auditoria das tags do Kubernetes Operator com a chave
mongodb-audit
nos logs do Pod.Para extrair entradas do registro de auditoria, use um comando semelhante ao exemplo a seguir:
kubectl logs -c mongodb-enterprise-database replica-set-0 | \ jq -r 'select(.logType == "mongodb-audit") | .contents'
Correções de Bugs
Corrige um problema em que não era possível definir a configuração despec.backup.autoTerminateOnDeletion
como true
para clusters fragmentados. Essa configuração controla se o Kubernetes Operator interrompe e encerra o backup quando você exclui um recurso do MongoDB. Se omitido, o valor padrão é false
.
MongoDB Enterprise Kubernetes Operator série 1.21
MongoDB Enterprise Kubernetes Operator 1.21.0
Lançado em 25/08/2023
Mudanças de última hora
Renomeia a variável de ambiente
CURRENT_NAMESPACE
paraNAMESPACE
. Esta variável acompanha o namespace do Operador Kubernetes. Se você definiu essa variável editando os recursosMongoDB
, atualizeCURRENT_NAMESPACE
paraNAMESPACE
enquanto atualiza o Operador Kubernetes.
Correções de Bugs
Corrige um problema em que os rótulos de substituição
StatefulSet
falhavam ao substituir oStatefulSet
.
Melhorias
Suporta a configuração de backups do Banco de Dados do Aplicativo e MongoDB para o recurso
MongoDBMultiCluster
.Adiciona documentação para configurar um sistema de recursos do
MongoDBMultiCluster
em um ambiente GitOps. Para saber mais, consulte Configurar recursos para GitOps.Adiciona
MetadataWrapper
, um invólucro de rótulos e anotações aos recursosMongoDB
,MongoDBMultiCluster
eMongoDBOpsManager
. O invólucro suporta a substituição demetadata.Labels
emetadata.Annotations
.
MongoDBOpsManager Resource
Alterações e depreciações recentes
O
appdb-ca
não é adicionado automaticamente ao armanezamento JVM de confiança no Ops Manager. Oappdb-ca
é o CA salvo no ConfigMap especificado emspec.applicationDatabase.security.tls.ca
. Isso afeta você se:Use o mesmo certificado personalizado para o
appdb-ca
e o armazenamento de snapshots do S3.Você usa uma versão do Kubernetes Operator anterior à 1.17.0 ou montou seu próprio armazenamento confiável no Ops Manager.
Se você precisar usar o mesmo certificado personalizado para
appdb-ca
e o armazenamento de snapshots do Armazenamento de snapshots do S3,spec.backup.s3Stores.customCertificateSecretRefs
especifique a CA com .Substitui as configurações
spec.backup.s3Stores.customCertificate
espec.backup.s3OpLogStores.customCertificate
. Em vez disso, usespec.backup.s3OpLogStores.customCertificateSecretRefs
espec.backup.s3Stores.customCertificateSecretRefs
.
Correções de Bugs
Corrige um problema que impediu a configuração de um número de porta arbitrário para
spec.externalConnectivity.port
ao utilizar o tipo de serviço doLoadBalancer
para expor o Ops Manager externamente.Corrige um problema que fazia com que o Ops Manager rejeitasse certificados ao permitir que o Kubernetes Operator importasse o
appdb-ca
, que é um pacote de CAs, para o armazenamento JVM de confiança do Ops Manager.
Melhorias
Permite a configuração do recurso
MongoDBOpsManager
com um aplicativo de banco de dados altamente disponível em vários clusters do Kubernetes, adicionando os seguintes novos campos ao recursoMongoDBOpsManager
:O valor padrão para o novo campo
spec.applicationDatabase.topology
opcional ésingleCluster
e será usado se você omitir o valor. Para atualizar para o Kubernetes Operator 1.21, você não precisa atualizar seus recursos doMongoDBOpsManager
. Isso torna a adição da configuração despec.applicationDatabase.topology
compatível com sistemas de cluster Kubernetes únicas do Banco de Dados de Aplicativos. Para saber mais, consulte Implantar um recurso do Ops Manager e a Especificação de recurso do Ops Manager.Permite que você adicione uma lista de certificados personalizados para backups no armazenamento de snapshots do S3 usando os campos
spec.backup.s3Stores.customCertificateSecretRefs
espec.backup.s3OpLogStores.customCertificateSecretRefs
no recursoMongoDBOpsManager
.
Notas de versão mais antigas
Para ver as notas de versão das versões mais antigas do operador, clique aqui.