Mise à jour des agents

Mettez à jour la configuration d'un agent dans la région Schematics actuellement sélectionnée afin qu'il fonctionne directement dans votre infrastructure cloud. La mise à jour d'un agent ne valide ni ne déploie votre agent. Sélectionnez la version de l'agent à mettre à jour. Vous pouvez analyser les journaux d'activité et récupérer la mise à jour.

Voici les scénarios que vous devez utiliser pour la mise à niveau de l'agent.

  • Intégrer les questions, les caractéristiques ou les images vulnérables par Schematics. Par exemple, vous utilisez la version d'agent 1.0.0. Si Schematics publie v1.0.x, vous pouvez utiliser la mise à jour de l'agent pour mettre à niveau v1.0.0- v1.1.1.
  • Pour mettre à jour des métadonnées d'agent telles que les attributs name, description, tags, resource group, version et agent_metadata.
  • Vous pouvez utiliser agent update pour révoquer la version mise à jour vers sa version existante.

La mise à jour de l'agent ne peut pas être effectuée sur un agent déployé via terraform init, terraform plan, et terraform apply sur l'espace de travail avec l'agent déployé.

Avant de commencer

Examinez et sélectionnez votre " version de l'agent à mettre à jour.

Lors de la mise à niveau d'un agent dans le cluster ca-mon, assurez-vous que les points d'extrémité de service private et public sont activés. Ces points finaux ne sont nécessaires que lors de l'installation ou de la mise à jour. Après une installation ou une mise à jour réussie, vous pouvez désactiver le point de terminaison du service public. Cependant, vous devez réactiver le point d'extrémité du service public pour les futures mises à niveau de l'agent.

Mise à jour d'une définition d'agent

Mettez à jour la configuration de votre agent en sélectionnant le cluster et l' IBM Cloud Object Storage s de votre choix.

  1. Connectez-vous à la consoleIBM Cloud
  2. Cliquez sur l'icône Menu > Automatisation de la plate-forme > Schematics > Extensions.
    • Sélectionnez votre agent:
      • Sélectionnez Actions > Editer l'agent
      • Vous pouvez modifier la Description, Cluster, nom d'instance COS, nom de compartiment COS, région de compartiment COS ou version de l'agent comme requis.
  3. Cliquez sur Mettre à jour et valider pour valider le cluster et la configuration IBM Cloud Object Storage.
  4. Cliquez sur Déployer pour redéployer un agent.

Création d'une définition d'agent par l'intermédiaire de l'interface de programmation

Sélectionnez la région IBM Cloud dans laquelle vous souhaitez mettre à jour et gérer votre agent. Définissez la commande de région CLI en exécutant ibmcloud target -r <region>. Sélectionnez la même région que le location spécifié dans la commande agent create. L'emplacement du compartiment IBM Cloud Object Storage doit être au format eu-gb ou us-south et non un nom de ville. Pour plus d'informations, voir la commande agent update.

Exemple

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>

Vérification de la mise à jour de

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

Mise à jour d'un agent via l'API

Suivez les étapes pour mettre à jour un jeton d'accès IAM et vous authentifier auprès de Schematics via l'API. Pour plus d'informations, voir Mise à jour d'un agent.

Vous pouvez utiliser la refresh_token pour obtenir un nouveau jeton d'accès IAM si votre jeton IAM a expiré.

Exemple

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

Vérifiez que la définition de l'agent a été créée correctement, comme indiqué dans la sortie. Enregistrez l'ID agent à utiliser dans les commandes suivantes. Par exemple, agentb1-gsmforvpc.soA.115c.

A présent, exécutez l'API agent deploy avec agent ID pour mettre à jour l'espace de travail Schematics qui déploie l'agent. L'opération agent deploy démarre à la fois les opérations agent validate et agent deploy pour configurer l'agent.

Syntaxe

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

Historique des versions des agents

Consultez le récapitulatif des modifications apportées à chaque version d' Schematics Agents. Veillez à maintenir à jour vos agents « Schematics » afin de pouvoir profiter de toutes les fonctionnalités disponibles.

Schematics Historique des versions des agents
Version Date de publication Modifications
1.8.0 24 juillet 2026 SchematicsLa version de l'agent v1.8.0 prend les versions de Terraform et 1.13 1.14.
1.7.0 5 mars 2026 SchematicsLa version v1.7.0 de l'agent prend désormais en charge le mode de déploiement Virtual Private Endpoints (VPE).
1.6.0 15 décembre 2025 Schematics v1.6.0 de la version de l'agent, alignement de la plateforme (replatforming), correctifs de sécurité, correction de la collecte des journaux et prise en charge de plusieurs identifiants.
1.5.0 31 juillet 2025 Schematics la version de l'agent v1.5.0 est maintenant supportée dans la région ca-mon et supporte les versions de Terraform 1.10, 1.11, 1.12.
1.4.0 25 avril 2025 Schematics la version de l'agent v1.4.0 est désormais prise en charge dans la région ca-tor.
1.3.1 28 février 2025 SchematicsLa version v1.3.1 de l'agent corrige la génération de l'inventaire Ansible dans l'interface utilisateur pour les identifiants système Windows.
1.3.0 30 octobre 2024 SchematicsLa version de l'agent v1.3.0 prend en charge schematics-agent-ansible-job à la place d'un existant, et schematics-ansible-job la version de Terraform 1.9.
1.2.0 23 septembre 2024 SchematicsLa version de l'agent v1.2.0 prend en charge Terraform et version 1.5 version 1.6.
1.1.1 23 juillet 2024 SchematicsLa version v1.1.1 de l'agent a prolongé le délai d'expiration pour la suppression des agents et les problèmes liés au déploiement des agents ont été corrigés.
1.1.0 19 mars 2024 SchematicsLa version v1.1.0 de l'agent a ajouté la prise en charge des agents Schematics sur Red Hat OpenShift Kubernetes Service.
1.0.0 10 janvier 2024 Schematics v1.0.0 de version de l'agent : la prise en charge de l'agent est désormais disponible en version générale (GA) avec une prise en charge complète en production.

Etapes suivantes