Agenten aktualisieren

Aktualisieren Sie eine Agentenkonfiguration in der aktuell ausgewählten „ Schematics “-Region, damit diese direkt in Ihrer Cloud-Infrastruktur funktioniert. Durch die Aktualisierung eines Agenten wird der Agent nicht validiert oder implementiert. Wählen Sie die zu aktualisierende Agentenversion aus. Sie können die Aktivitätenprotokolle analysieren und die Aktualisierung wiederherstellen.

Im Folgenden sind die Szenarien aufgeführt, in denen Sie das Agenten-Upgrade verwenden müssen.

  • Zur Aufnahme der Probleme, Merkmale oder gefährdeten Bilder von Schematics. Beispiel: Sie verwenden die Agentenversion 1.0.0. Wenn Schematics v1.0.x freigibt, können Sie das Agenten-Update verwenden, um v1.0.0- v1.1.1 zu aktualisieren.
  • Zum Aktualisieren von Agentenmetadaten wie name-, description-, tags-, resource group-, version-und agent_metadata-Attributen.
  • Sie können agent update verwenden, um die aktualisierte Version der vorhandenen Version zu widerrufen.

Die Agentenaktualisierung kann bei einem eingesetzten Agenten nicht über terraform init, terraform plan und terraform apply auf dem Arbeitsbereich mit dem eingesetzten Agenten durchgeführt werden.

Vorbereitende Schritte

Prüfen und wählen Sie die zu aktualisierende Version Ihres Agenten.

Wenn Sie einen Agenten im Cluster ca-mon aktualisieren, stellen Sie sicher, dass sowohl der private als auch der public Service-Endpunkt aktiviert sind. Diese Endpunkte werden nur während der Installation oder des Upgrades benötigt. Nach der erfolgreichen Installation oder Aktualisierung können Sie den Dienst public endpoint deaktivieren. Sie müssen jedoch den Dienstendpunkt public für zukünftige Agent-Upgrades wieder aktivieren.

Agentendefinition aktualisieren

Aktualisieren Sie Ihre Agent-Konfiguration, indem Sie den gewünschten Cluster und die gewünschte IBM Cloud Object Storage auswählen.

  1. Melden Sie sich bei der KonsoleIBM Cloud an.
  2. Klicken Sie auf das Hamburger-Symbol Menü > Plattformautomatisierung > Schematics > Erweiterungen.
    • Wählen Sie Ihren Agenten aus:
      • Wählen Sie Aktionen > Agenten bearbeiten aus.
      • Sie können die Beschreibung, den Cluster, den COS-Instanznamen, den COS-Bucketnamen, die COS-Bucketregion oder die Agentenversion entsprechend den Anforderungen bearbeiten.
  3. Klicken Sie auf Aktualisieren und validieren, um den Cluster und die Konfiguration von IBM Cloud Object Storage zu überprüfen.
  4. Klicken Sie auf Bereitstellen, um einen Agenten erneut bereitzustellen.

Erstellen einer Agentendefinition über CLI

Wählen Sie die Region IBM Cloud aus, in der Sie Ihren Agenten aktualisieren und verwalten möchten. Legen Sie den CLI-Regionsbefehl fest, indem Sie ibmcloud target -r <region> ausführen. Wählen Sie dieselbe Region wie die im Befehl agent create angegebene location aus. Die IBM Cloud Object Storage-Bucketposition muss das Format eu-gb oder us-south aufweisen und kein Ortsname. Weitere Informationen finden Sie unter dem Befehl Agent update.

Beispiel

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>

Agentenaktualisierung überprüfen

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

Aktualisieren eines Agenten über API

Führen Sie die Schritte aus, um ein IAM-Zugriffstoken zu aktualisieren und über die API bei Schematics zu authentifizieren. Weitere Informationen finden Sie unter Agenten aktualisieren.

Sie können die verwenden, refresh_token um ein neues IAM-Zugriffstoken zu erhalten, falls Ihr IAM-Token abgelaufen ist.

Beispiel

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

Stellen Sie sicher, dass die Agentendefinition wie in der Ausgabe gezeigt erfolgreich erstellt wurde. Zeichnen Sie die Agenten-ID zur Verwendung in nachfolgenden Befehlen auf. Beispiel: agentb1-gsmforvpc.soA.115c.

Führen Sie jetzt die API agent deploy mit dem agent ID aus, um den Arbeitsbereich Schematics zu aktualisieren, der den Agenten implementiert. Die Operation agent deploy startet die Operationen agent validate und agent deploy zum Einrichten des Agenten.

Syntax

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

Versionsgeschichte der Agenten

Hier finden Sie eine Übersicht über die Änderungen in den einzelnen Versionen von Schematics-Agenten. Achten Sie darauf, Ihre „ Schematics “-Agenten stets auf dem neuesten Stand zu halten, damit Sie alle verfügbaren Funktionen nutzen können.

Schematics Agenten Versionsgeschichte
Version Freigabedatum Änderungen
1.8.0
  1. Juli 2026
SchematicsDie Agent-Version v1.8.0 unterstützt die Terraform-Versionen und 1.13 1.14.
1.7.0
  1. März 2026
Schematics Mit der Agent-Version v1.7.0 wurde die Unterstützung für die Bereitstellungsmethode Virtual Private Endpoints (VPE) hinzugefügt.
1.6.0
  1. Dezember 2025
SchematicsAgentenversions- v1.6.0-Plattformanpassung (Replatforming), Sicherheitskorrekturen, Korrektur bei der Protokollsammlung und Unterstützung für mehrere Anmeldedaten.
1.5.0
  1. Juli 2025
Schematics die Agentenversion v1.5.0 wird nun in der Region ca-mon unterstützt und unterstützt die Terraform Versionen 1.10, 1.11, 1.12.
1.4.0
  1. April 2025
Schematics die Agentenversion v1.4.0 wird jetzt in der Region ca-tor unterstützt.
1.3.1
  1. Februar 2025
SchematicsDie Agent-Version v1.3.1 behebt das Problem bei der Erstellung des Bestands Ansible in der Benutzeroberfläche für Windows-Systemanmeldedaten.
1.3.0
  1. Oktober 2024
SchematicsDie Agent-Version v1.3.0 unterstützt schematics-agent-ansible-job anstelle einer bestehenden und schematics-ansible-job die Terraform-Version 1.9.
1.2.0
  1. September 2024
SchematicsDie Agent-Version v1.2.0 unterstützt Terraform und version 1.5 version 1.6.
1.1.1
  1. Juli 2024
SchematicsAgent-Version v1.1.1: Die Zeitüberschreitung beim Löschen von Agenten wurde verlängert, und Probleme bei der Bereitstellung von Agenten wurden behoben.
1.1.0
  1. März 2024
SchematicsMit der Agent-Version v1.1.0 wurde die Unterstützung für die Schematics-Agenten auf der Red Hat OpenShift Kubernetes Service hinzugefügt.
1.0.0
  1. Januar 2024
SchematicsAgent-Version v1.0.0: Der Agent ist allgemein verfügbar (GA) und wird mit umfassendem Produktionssupport bereitgestellt.

Nächste Schritte