Atualizando agentes
Atualize a configuração de um agente na região do Schematics selecionada no momento para que ele funcione diretamente em sua infraestrutura de nuvem. Atualizar um agente não valida ou implementa seu agente. Selecione a versão do agente a ser atualizada É possível analisar os logs de atividades e recuperar a atualização
Veja a seguir os cenários em que você deve usar o upgrade de agente.
- Para incorporar os problemas, recursos ou imagens vulneráveis por Schematics. Por exemplo, a versão do agente é
1.0.0. Se Schematics lançarv1.0.x, você poderá usar a atualização do agente para atualizarv1.0.0-v1.1.1. - Para atualizar metadados de um agente como atributos
name,description,tags,resource group,versioneagent_metadata. - É possível usar o
agent updatepara revogar a versão atualizada para sua versão existente
A atualização do agente não pode ser feita em um agente implantado por meio de terraform init, terraform plan e terraform apply no espaço de trabalho com o agente implantado.
Antes de Iniciar
Revise e selecione a versão do agente a ser atualizada.
Ao fazer upgrade de um agente no cluster ca-mon, certifique-se de que os pontos de extremidade de serviço private e public estejam ativados. Esses endpoints são necessários apenas durante a instalação ou
upgrade. Após a instalação ou atualização bem-sucedida, você pode desativar o ponto de extremidade do serviço public. No entanto, você deve reativar o ponto de extremidade do serviço public para futuros upgrades do
Agente.
Atualizando uma definição de agente..
Atualize a configuração do seu agente selecionando o cluster e o IBM Cloud Object Storage de sua preferência.
- Faça login no consoleIBM Cloud.
- Clique no ícone
Menu > Platform Automation > Schematics > Extensions.
- Selecione seu agente:
- Selecione Ações > Editar Agente
- É possível editar a Descrição, Cluster, Nome da instância do COS, Nome do depósito do COS, Região do depósito do COS ou Versão do agente como no requisito.
- Selecione seu agente:
- Clique em Atualizar e validar para validar o cluster e a configuração do IBM Cloud Object Storage
- Clique em Implementar para reimplementar um agente..
Criação de uma definição de agente por meio da CLI
Selecione a região do IBM Cloud na qual você deseja atualizar e gerenciar seu agente. Configure o comando da região CLI executando ibmcloud target -r <region>.
Selecione a mesma região que o location especificado no comando agent create O local do depósito do IBM Cloud Object Storage deve ter o formato eu-gb ou us-south e não um nome de cidade.
Para obter mais informações, consulte o comando agent update.
Exemplo
ibmcloud schematics agent update --id AGENT_ID --location <us-south> --agent-location <us-south> --version <1.0.0> --infra-type <ibm_kubernetes> --cluster-id <cg3fgvad0dak571xxx> --cluster-resource-group <Default> --cos-instance-name <agent-cos-instance> --cos-bucket <agent-cos-bucket> --cos-location <us-east> --resource-group <Default>
Verificando a atualização do agente
ibmcloud schematics agent get --id agent-ga-prod-cli-jan-10.soA.cd1c
Atualização de um agente por meio da API
Siga as etapas para atualizar um token de acesso do IAM e autenticar com o Schematics por meio da API. Para obter mais informações, consulte Atualizar um agente..
Você pode usar o método refresh_token para obter um novo token de acesso do IAM caso o seu token do IAM tenha expirado.
Exemplo
curl -X PUT https://schematics.cloud.ibm.com/v2/agents/{agent_id} \-H 'Authorization: Bearer <Auth Key>' -H 'X-Feature-Agents: true' -H 'refresh_token: <refresh_token> ' -d '{
"name": "AgentName",
"description": "New Description",
"resource_group": "Default",
"tags": [
"tag1",
"tag2"
],
"version": "v1.0.0",
"schematics_location": "us-south",
"agent_location": "us-south",
"agent_infrastructure": {
"infra_type": "ibm_kubernetes",
"cluster_id": "cluster_id",
"cluster_resource_group": "Default",
"cos_instance_name": "blueprint_basic",
"cos_bucket_name": "sample_bucket_name",
"cos_bucket_region": "us-east"
},
"agent_inputs": [
{
"name": "ibmcloud_api_key",
"value": "<api_key of the account where cluster and cos are present>",
"metadata": {
"secure": true
}
},
{
"name": "ansible_pull_ibmcloud_api_key",
"value": "jenkins api_key for pulling agents images",
"metadata": {
"secure": true
}
},
{
"name": "devops_api_key",
"value": "api_key where you want to create agent and run fvts",
"metadata": {
"secure": true
}
}
],
"user_state": {
"state": "enable"
}
}'
Verifique se a definição do agente foi criada com êxito, conforme mostrado na saída Registre o ID do agente para ser usado em comandos subsequentes. Por exemplo, agentb1-gsmforvpc.soA.115c.
Agora, execute a API agent deploy com o agent ID para atualizar a área de trabalho Schematics que implementa o agente. A operação agent deploy inicia as operações agent validate e agent deploy para configurar o agente.
Sintaxe
PUT /v2/agents/<enter your agentID>/deploy HTTP/1.1
Host: schematics.cloud.ibm.com
Content-Type: application/json
Authorization: Bearer
Histórico de versões do Agents
Veja um resumo das alterações para cada versão do Schematics Agents. Certifique-se de manter seus agentes do Schematics atualizados para que você possa utilizar todos os recursos disponíveis.
| Versão | Data de liberação | Mudanças |
|---|---|---|
| 1.8.0 | 24 de julho de 2026 | Schematics A versão do agente v1.8.0 é compatível com as versões do Terraform 1.13 e 1.14. |
| 1.7.0 | 5 de março de 2026 | Schematics A versão v1.7.0 do agente adicionou suporte ao método de implantação por meio de Pontos de Fim Privados Virtuais (VPE). |
| 1.6.0 | 15 de dezembro de 2025 | Schematics versão do agente v1.6.0 alinhamento de plataforma (Replatforming), correções de segurança, correção na coleta de logs e suporte a múltiplas credenciais. |
| 1.5.0 | 31 de julho de 2025 | Schematics a versão do agente v1.5.0 agora é compatível com a região ca-mon e com a versão do Terraform 1.10, 1.11,
1.12. |
| 1.4.0 | 25 de abril de 2025 | Schematics a versão do agente v1.4.0 agora é compatível com a região ca-tor. |
| 1.3.1 | 28 de fevereiro de 2025 | Schematics A versão do agente v1.3.1 corrige a geração do inventário Ansible na interface do usuário para credenciais do sistema Windows. |
| 1.3.0 | 30 de outubro de 2024 | Schematics A versão do agente v1.3.0 é compatível com schematics-agent-ansible-job, em vez do endereço existente schematics-ansible-job,
e com a versão do Terraform 1.9. |
| 1.2.0 | 23 de setembro de 2024 | Schematics A versão do agente v1.2.0 é compatível com o Terraform version 1.5 e version 1.6. |
| 1.1.1 | 23 de julho de 2024 | Schematics A versão do agente v1.1.1 aumentou o tempo limite para exclusão do agente e corrigiu problemas relacionados à implantação do agente. |
| 1.1.0 | 19 de março de 2024 | Schematics A versão do agente v1.1.0 adicionou suporte aos agentes Schematics no Red Hat OpenShift Kubernetes Service. |
| 1.0.0 | 10 de janeiro de 2024 | Schematics Versão do agente v1.0.0: o suporte ao agente está disponível para o público em geral (GA), com suporte completo para produção. |
Próximas etapas
- Você pode excluir um agente, exibir um agente ou criar um agente.
- Você pode consultar as Perguntas frequentes sobre agentes para obter informações sobre questões comuns relacionadas à exclusão de um agente.