Actualización de agentes

Actualiza la configuración de un agente en la región de Schematics seleccionada actualmente para que funcione directamente en tu infraestructura en la nube. La actualización de un agente no valida ni despliega el agente. Seleccione la versión del agente que desea actualizar. Puede analizar los registros de actividad y recuperar la actualización.

A continuación se indican los escenarios en los que debe utilizar la actualización del agente.

  • Incorporar los problemas, características o imágenes vulnerables por Schematics. Por ejemplo, está utilizando la versión de agente 1.0.0. Si Schematics libera v1.0.x, puede utilizar la actualización del agente para actualizar v1.0.0- v1.1.1.
  • Para actualizar los metadatos de un agente como, por ejemplo, los atributos name, description, tags, resource group, version y agent_metadata.
  • Puede utilizar agent update para revocar la versión actualizada a su versión existente.

La actualización del agente no se puede realizar en un agente desplegado a través de terraform init, terraform plan y terraform apply en el espacio de trabajo con el agente desplegado.

Antes de empezar

Revise y seleccione la versión de su agente que desea actualizar.

Cuando actualice un Agente en el clúster ca-mon, asegúrese de que los puntos finales de servicio private y public están habilitados. Estos puntos finales sólo son necesarios durante la instalación o actualización. Tras la instalación o actualización correcta, puede desactivar el punto final del servicio public. Sin embargo, debe volver a habilitar el punto final del servicio public para futuras actualizaciones del Agente.

Actualización de una definición de agente

Actualiza la configuración de tu agente seleccionando el clúster y el IBM Cloud Object Storage que prefieras.

  1. Inicie sesión en la consolaIBM Cloud.
  2. Haga clic en el icono de menú hamburguesa > Automatización de plataformas > Schematics > Extensiones.
    • Seleccione el agente:
      • Seleccione Acciones > Editar agente
      • Puede editar Descripción, Clúster, Nombre de instancia de COS, Nombre de grupo de COS, Región de grupo de COS o Versión de agente como en el requisito.
  3. Pulse Actualizar y validar para validar el clúster y la configuración de IBM Cloud Object Storage.
  4. Pulse Desplegar para volver a desplegar un agente.

Creación de una definición de agente mediante CLI

Seleccione la región IBM Cloud donde desea actualizar y gestionar el agente. Establezca Mandato de región de CLI ejecutando ibmcloud target -r <region>. Seleccione la misma región que el location especificado en el mandato agent create. La ubicación del grupo IBM Cloud Object Storage debe tener el formato eu-gb o us-south y no un nombre de ciudad. Para obtener más información, consulte el comando actualización del agente.

Ejemplo

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>

Verificación de la actualización del agente

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

Actualización de un agente a través de la API

Siga los pasos para actualizar una señal de acceso de IAM y autenticarse con Schematics a través de la API. Para obtener más información, consulte Actualizar un agente.

Puedes utilizar el refresh_token para obtener un nuevo token de acceso de IAM si tu token de IAM ha caducado.

Ejemplo

  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 que la definición de agente se ha creado correctamente tal como se muestra en la salida. Anote el ID de agente para utilizarlo en mandatos posteriores. Por ejemplo, agentb1-gsmforvpc.soA.115c.

Ahora, ejecute la API agent deploy con agent ID para actualizar el espacio de trabajo Schematics que despliega el agente. La operación agent deploy inicia las operaciones agent validate y agent deploy para configurar el agente.

Sintaxis

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

Historial de versiones de los agentes

Consulta un resumen de las modificaciones de cada versión de los agentes de Schematics. Asegúrate de mantener actualizados tus agentes de « Schematics » para poder utilizar todas las funciones disponibles.

Schematics Historial de versiones de agentes
Versión Fecha del release Cambios
1.8.0 24 de julio de 2026 SchematicsLa versión del agente v1.8.0 es compatible con las versiones de Terraform y 1.13 1.14.
1.7.0 5 de marzo de 2026 SchematicsLa versión v1.7.0 del agente ha incorporado compatibilidad con el método de implementación de puntos finales privados virtuales (VPE).
1.6.0 15 de diciembre de 2025 SchematicsVersión del agente v1.6.0: adaptación a la plataforma (cambio de plataforma), correcciones de seguridad, corrección de la recopilación de registros y compatibilidad con múltiples credenciales.
1.5.0 31 de julio de 2025 Schematics la versión del agente v1.5.0 es ahora compatible en la región ca-mon y admite las versiones de Terraform 1.10, 1.11, 1.12.
1.4.0 25 de abril de 2025 Schematics la versión del agente v1.4.0 es ahora compatible en la región ca-tor.
1.3.1 28 de febrero de 2025 SchematicsLa versión v1.3.1 del agente corrige la generación del inventario de Ansible en la interfaz de usuario para las credenciales del sistema Windows.
1.3.0 30 de octubre de 2024 SchematicsLa versión del agente v1.3.0 es compatible con schematics-agent-ansible-job en lugar de la versión existente y schematics-ansible-job la versión de Terraform 1.9.
1.2.0 23 de septiembre de 2024 SchematicsLa versión del agente v1.2.0 es compatible con Terraform y version 1.5 version 1.6.
1.1.1 23 de julio de 2024 SchematicsVersión del agente v1.1.1: se ha ampliado el tiempo de espera para la eliminación de agentes y se han solucionado los problemas relacionados con la implementación de los mismos.
1.1.0 19 de marzo de 2024 SchematicsLa versión del agente v1.1.0 ha añadido compatibilidad con los agentes de Schematics en Red Hat OpenShift Kubernetes Service.
1.0.0 10 de enero de 2024 SchematicsVersión del agente v1.0.0: el soporte para el agente ya está disponible de forma generalizada (GA) con soporte completo para entornos de producción.

Próximos pasos