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 Schematicsv1.0.xfreigibt, können Sie das Agenten-Update verwenden, umv1.0.0-v1.1.1zu aktualisieren. - Zum Aktualisieren von Agentenmetadaten wie
name-,description-,tags-,resource group-,version-undagent_metadata-Attributen. - Sie können
agent updateverwenden, 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.
- Melden Sie sich bei der KonsoleIBM Cloud an.
- Klicken Sie auf das
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.
- Wählen Sie Ihren Agenten aus:
- Klicken Sie auf Aktualisieren und validieren, um den Cluster und die Konfiguration von IBM Cloud Object Storage zu überprüfen.
- 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.
| Version | Freigabedatum | Änderungen |
|---|---|---|
| 1.8.0 |
|
SchematicsDie Agent-Version v1.8.0 unterstützt die Terraform-Versionen und 1.13 1.14. |
| 1.7.0 |
|
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 |
|
SchematicsAgentenversions- v1.6.0-Plattformanpassung (Replatforming), Sicherheitskorrekturen, Korrektur bei der Protokollsammlung und Unterstützung für mehrere Anmeldedaten. |
| 1.5.0 |
|
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 |
|
Schematics die Agentenversion v1.4.0 wird jetzt in der Region ca-tor unterstützt. |
| 1.3.1 |
|
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 |
|
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 |
|
SchematicsDie Agent-Version v1.2.0 unterstützt Terraform und version 1.5 version 1.6. |
| 1.1.1 |
|
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 |
|
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 |
|
SchematicsAgent-Version v1.0.0: Der Agent ist allgemein verfügbar (GA) und wird mit umfassendem Produktionssupport bereitgestellt. |
Nächste Schritte
- Sie können einen Agenten löschen, einen Agenten anzeigen oder einen Agenten erstellen.
- In den Agenten-FAQ finden Sie alle allgemeinen Fragen zum Löschen eines Agenten.