/ /

Tutorials

Página inicial do Docs

/ /

API

Tutorials

Página inicial do Docs

Atualizar a configuração de automação de um projeto

Aconfiguração de automação do de um projeto determina o estado do objetivo de seus processos e agentes do MongoDB . O MongoDB Agent cria a implantação de acordo com os objetivos especificados.

Para atualizar a configuração:

Recupere a configuração atual.
Você pode usar o endpoint /groups/{PROJECT-ID}/automationConfig para obter a configuração completa ou usar o endpoint /groups/{PROJECT-ID}/automationConfig/noSecrets para obter a configuração com informações confidenciais editadas, como senhas ou valores de chave.
Faça alterações em uma cópia da configuração atual, alterando apenas os itens que você deseja modificados.
Substitua toda a configuração PUT usando, com a configuração atualizada no corpo da solicitação. Você deve PUT usar. Não PATCHuse.
Quando você envia atualizações, o Ops Manager faz modificações internas nos dados e, em seguida, salva sua nova versão da configuração.

Observação

Alguns parâmetros não podem ser atualizados através do endpoint automationConfig . Para saber mais, consulte:

Para fazer atualizações no MongoDB Agent diferentes de hostname, você deve fazer isso por meio de um endpoint diferente.

Importante

Uma configuração de automação pode conter informações confidenciais, incluindo senhas ou valores de chave. Para atualizar a configuração de automação de um projeto sem atualizar nenhum campo que contenha informações confidenciais, use o endpoint /groups/{PROJECT-ID}/automationConfig/noSecrets.

Pré-requisitos

Você deve ter acesso àAPI . Para saber mais, consulte Configurar o acesso à API.

Variáveis para recursos de API de configuração de automação

Os recursos da API usam uma ou mais dessas variáveis. Substitua essas variáveis pelos valores desejados antes de chamar esses recursos da API.

Nome	Tipo	Descrição
`PUBLIC-KEY`	string	Sua chave de API pública para suas credenciais de API.
`PRIVATE-KEY`	string	Sua chave de API privada para suas credenciais de API .
`<OpsManagerHost>:<Port>`	string	URL da sua instância do Ops Manager.
`GROUP-ID`	string	Identificador único do seu projeto a partir das configurações do projeto.
`CLUSTER-ID`	string	Identificador único do seu cluster.

Procedimento

Recupere e valide a configuração de automação do Ops Manager.

Use o recurso automationConfig para recuperar a configuração. Emita o comando a seguir, substituindo os espaços reservados pelas variáveis para recursos da API de configuração de automação.

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
     --request GET "https://<OpsManagerHost>:<Port>/api/public/v1.0/groups/{PROJECT-ID}/automationConfig?pretty=true" \
     --output currentAutomationConfig.json

Valide o arquivo de configuração de automação baixado.
Compare o campo version do currentAutomationConfig.json com o do arquivo de backup da Configuração de Automação, mms-cluster-config-backup.json. O valor version é o último elemento em ambos os documentos JSON . Você pode encontrar este arquivo em qualquer host que execute o MongoDB agente em:
- Linux e macOS: /var/lib/mongodb-mms-automation/mms-cluster-config-backup.json
- Windows: %SystemDrive%\MMSAutomation\versions\mms-cluster-config-backup.json
Se os valores version corresponderem, você estará trabalhando com a versão atual do arquivo de configuração de automação.

Edite o arquivo de configuração de automação baixado.

Abra currentAutomationConfig.json no seu editor de texto preferido.

Para saber mais sobre as opções de configuração de automação, consulte Configuração da automação.

Se você estiver atualizando o MongoDB Agent, consulte Atualizar versões do agente antes de continuar com este procedimento.

Envie a configuração de automação atualizada.

Use o recurso automationConfig para enviar a configuração de automação atualizada.

Emita o comando a seguir com o caminho para o documento de configuração atualizado e substitua os espaços reservados pelas variáveis para recursos da API de configuração de automação.

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
     --header "Content-Type: application/json" \
     --request PUT "https://<OpsManagerHost>:<Port>/api/public/v1.0/groups/{PROJECT-ID}/automationConfig?pretty=true" \
     --data @currentAutomationConfig.json

Após a atualização bem-sucedida da configuração, a API retorna o código de status HTTP 200 OK para indicar que a solicitação foi bem-sucedida.

Confirme a atualização bem-sucedida da configuração de automação.

Recupere a configuração de automação do Ops Manager e confirme se ela contém as alterações. Para recuperar a configuração, emita o seguinte comando, substituindo os espaços reservados pelas variáveis para recursos de API de configuração de automação.

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
     --request GET "https://<OpsManagerHost>:<Port>/api/public/v1.0/groups/{PROJECT-ID}/automationConfig?pretty=true"

Verifique o status do sistema para garantir que o estado do objetivo seja atingido.

Use o recurso automationStatus para recuperar o status do sistema. Emita o comando a seguir, substituindo os espaços reservados pelas variáveis para recursos da API de configuração de automação.

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
     --request GET "https://<OpsManagerHost>:<Port>/api/public/v1.0/groups/{PROJECT-ID}/automationStatus?pretty=true"

Confirme que os valores de todos os campos lastGoalVersionAchieved na array processes correspondem ao campo goalVersion . Para saber mais sobre o status da implementação, consulte Obter o status de automação do plano mais recente.

Voltar

Distribuir cluster

Girar arquivo de chave