Aggiornamento degli agenti

Aggiorna la configurazione di un agente nella regione di Schematics attualmente selezionata per consentirne il funzionamento diretto nella tua infrastruttura cloud. L'aggiornamento di un agent non convalida o distribuisce l'agent. Selezionare la versione dell'agente da aggiornare. È possibile analizzare i log di attività e ripristinare l'aggiornamento.

Di seguito sono riportati gli scenari in cui è necessario utilizzare l'aggiornamento dell'agente.

  • Per incorporare i problemi, le caratteristiche o le immagini vulnerabili di Schematics. Ad esempio, la versione dell'agent è 1.0.0. Se Schematics rilascia v1.0.x, è possibile utilizzare agent update per aggiornare v1.0.0- v1.1.1.
  • Per aggiornare i metadati di un agent come gli attributi name, description, tags, resource group, version e agent_metadata.
  • È possibile utilizzare agent update per revocare la versione aggiornata alla versione esistente.

L'aggiornamento dell'agente non può essere eseguito su un agente distribuito tramite terraform init, terraform plan e terraform apply sull'area di lavoro con l'agente distribuito.

Prima di iniziare

Esaminare e selezionare il " versione agente da aggiornare.

Quando si aggiorna un agente nel cluster ca-mon, assicurarsi che entrambi gli endpoint di servizio private e public siano abilitati. Questi endpoint sono necessari solo durante l'installazione o l'aggiornamento. Dopo l'installazione o l'aggiornamento, è possibile disattivare l'endpoint del servizio public. Tuttavia, è necessario riattivare l'endpoint del servizio public per i futuri aggiornamenti dell'agente.

Aggiornamento di una definizione agent

Aggiorna la configurazione dell'agente selezionando il cluster e l' IBM Cloud Object Storage e desiderati.

  1. Accedere alla consoleIBM Cloud.
  2. Fare clic sull'icona del menu ad hamburger > Automazione piattaforma > Schematics > Estensioni.
    • Selezionare l'agent:
      • Selezionare Azioni > Modifica agent
      • Puoi modificare la Descrizione, il Cluster, il nome istanza COS, il nome bucket COS, la regione bucket COS o la versione agent come nel requisito.
  3. Fai clic su Aggiorna e convalida per confermare il cluster e la configurazione IBM Cloud Object Storage.
  4. Fare clic su Distribuisci per ridistribuire un agente.

Creazione di una definizione di agente tramite CLI

Seleziona la regione IBM Cloud in cui vuoi aggiornare e gestire il tuo agent. Imposta il comando della regione CLI eseguendo ibmcloud target -r <region>. Selezionare la stessa regione del location specificato sul comando agent create. L'ubicazione del bucket IBM Cloud Object Storage deve essere nel formato eu-gb o us-south e non un nome città. Per ulteriori informazioni, vedere il comando agent update.

Esempio

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>

Verifica dell'aggiornamento dell'agent

ibmcloud schematics agent get --id agent-ga-prod-cli-jan-10.soA.cd1c

Aggiornamento di un agente tramite API

Segui i passi per aggiornare un token di accesso IAM e autenticarti con Schematics tramite l'API. Per ulteriori informazioni, consultare Aggiornamento di un agent.

Puoi utilizzare refresh_token per ottenere un nuovo token di accesso IAM se il tuo token IAM è scaduto.

Esempio

  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"
  }
  }'

Verificare che la definizione dell'agent sia stata creata correttamente, come mostrato nell'output. Registrare l'ID agent da utilizzare nei comandi successivi. Ad esempio, agentb1-gsmforvpc.soA.115c.

Ora, esegui l'API agent deploy con agent ID per aggiornare lo spazio di lavoro Schematics che distribuisce l'agent. L'operazione agent deploy avvia le operazioni agent validate e agent deploy per configurare l'agente.

Sintassi

  PUT /v2/agents/<enter your agentID>/deploy HTTP/1.1
  Host: schematics.cloud.ibm.com
  Content-Type: application/json
  Authorization: Bearer

Cronologia delle versioni degli agenti

Ecco una sintesi delle modifiche apportate a ciascuna versione di Schematics Agents. Assicurati di mantenere aggiornati i tuoi agenti di Schematics, in modo da poter utilizzare tutte le funzionalità disponibili.

Schematics Cronologia delle versioni degli agenti
Versione Data di rilascio Modifiche
1.8.0 24 luglio 2026 Schematics La versione dell'agent v1.8.0 supporta le versioni di Terraform 1.13 e 1.14.
1.7.0 5 marzo 2026 Schematics La versione v1.7.0 dell'agente ha aggiunto il supporto per le modalità di distribuzione tramite Virtual Private Endpoints (VPE).
1.6.0 15 dicembre 2025 Schematics versione dell'agente v1.6.0, allineamento della piattaforma (Replatforming), correzioni di sicurezza, correzione relativa alla raccolta dei log e supporto per credenziali multiple.
1.5.0 31 luglio 2025 Schematics la versione dell'agente v1.5.0 è ora supportata nella regione ca-mon e supporta le versioni di Terraform 1.10, 1.11, 1.12.
1.4.0 25 aprile 2025 Schematics la versione dell'agente v1.4.0 è ora supportata nella regione ca-tor.
1.3.1 28 febbraio 2025 Schematics La versione v1.3.1 dell'agente risolve il problema relativo alla generazione dell'inventario Ansible nell'interfaccia utente per le credenziali di sistema di Windows.
1.3.0 30 ottobre 2024 Schematics La versione dell'agente v1.3.0 supporta schematics-agent-ansible-job al posto dell'attuale schematics-ansible-job e la versione di Terraform 1.9.
1.2.0 23 settembre 2024 Schematics La versione dell'agent v1.2.0 supporta Terraform version 1.5 e version 1.6.
1.1.1 23 luglio 2024 Schematics Versione dell'agente v1.1.1: è stato esteso il tempo di attesa per l'eliminazione degli agenti e sono stati risolti i problemi relativi alla distribuzione degli agenti.
1.1.0 19 marzo 2024 Schematics La versione dell'agente v1.1.0 ha aggiunto il supporto per gli agenti Schematics su Red Hat OpenShift Kubernetes Service.
1.0.0 10 gennaio 2024 Schematics Versione dell'agente v1.0.0: l'agente è ora disponibile in versione GA (Generally Available) con supporto completo per l'ambiente di produzione.

Passi successivi