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 rilasciav1.0.x, è possibile utilizzare agent update per aggiornarev1.0.0-v1.1.1. - Per aggiornare i metadati di un agent come gli attributi
name,description,tags,resource group,versioneagent_metadata. - È possibile utilizzare
agent updateper 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.
- Accedere alla consoleIBM Cloud.
- Fare clic sull'icona del menu
> 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.
- Selezionare l'agent:
- Fai clic su Aggiorna e convalida per confermare il cluster e la configurazione IBM Cloud Object Storage.
- 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.
| 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
- È possibile cancellare un agente, visualizzare un agente o creare un agente.
- È possibile consultare le agent FAQ per tutte le domande più comuni relative all'eliminazione di un agente.