Mit privaten Delivery Pipeline-Workern arbeiten

DevOps Insights wird am 31. August 2026 das Ende des Betriebs erreichen und eingestellt werden. Continuous Delivery wird am 12. Februar 2027 in den folgenden Regionen eingestellt: au-syd, ca-tor, us-east. Code Risk Analyzer wird zu diesem Zeitpunkt ebenfalls in allen Regionen eingestellt. Wenn diese Funktionen in einer Region nicht aktiv genutzt werden, können sie in dieser Region vorzeitig eingestellt werden, sodass keine neuen Instanzen mehr akzeptiert werden. Weitere Informationen

Delivery Pipeline verwendet öffentliche und private Worker für die Ausführung von Pipelinejobs. Standardmäßig werden Pipelinejobs ausgeführt, indem öffentliche Worker in einer öffentlichen von IBM verwalteten und gemeinsam genutzten Infrastruktur verwendet werden.

In bestimmten Szenarios benötigt Delivery Pipeline möglicherweise Zugriff auf interne oder lokale Ressourcen. In diesen Situationen können Sie eine Verbindung zu einem privaten Delivery Pipeline-Worker herstellen und ihn für die Ausführung in Ihrer eigenen Kubernetes-Infrastruktur integrieren.

Voraussetzungen

Stellen Sie vor der Einrichtung eines privaten Workers sicher, dass die folgenden Ressourcen vorhanden sind:

Ein Kubernetes-Cluster. Sie müssen über einen Cluster verfügen, um einen privaten Worker zu installieren. Sie können einen eigenen Cluster bereitstellen oder einen Cluster über die IBM Cloud Kubernetes Service einrichten.
Optional. Eine Toolchain mit einer Pipeline, die mindestens eine Phase enthält. Sie können eine Toolchain erstellen, indem Sie die Toolintegration für private Delivery Pipeline-Worker verwenden. Sie können auch eine Toolchain mithilfe der Toolchain-Vorlage Kubernetes-App entwickeln erstellen:
1. Melden Sie sich bei IBM Cloud an.
2. Rufen Sie https://cloud.ibm.com/devops/create auf und wählen Sie die Vorlage Develop a Kubernetes app toolchain aus.
3. Füllen Sie die Felder für die Delivery Pipeline aus.
4. Klicken Sie auf Erstellen, um Ihre Kubernetes-App-Toolchain zu erstellen.

Privaten Delivery Pipeline-Worker einrichten

Toolchains stellen einen integrierten Satz von Tools zum Erstellen, Bereitstellen und Verwalten Ihrer Apps bereit. Toolintegrationen sind die Bausteine einer Toolchain. Eine Pipeline, die in einer Toolchain enthalten ist, die über eine oder mehrere private Worker-Integrationen verfügt, hat zusätzliche Optionen zur Verfügung. Für Classic-Pipelines sind diese Optionen auf der Registerkarte Worker der Seite "Stagekonfiguration" verfügbar. Für Tekton-Pipelines sind diese Optionen in den Einstellungen verfügbar, die auf der Seite Worker angegeben werden.

Für Tekton-Pipelines können Sie auch einen Worker pro Auslöser angeben, der den Worker überschreibt, der auf Pipelineebene auf der Seite Worker konfiguriert ist.

Führen Sie die folgenden Schritte aus, um einen privaten Worker einzurichten:

Konfigurieren Sie die Toolintegration für private Delivery Pipeline-Worker für Ihre Toolchain.
Konfigurieren Sie Ihren Kubernetes-Cluster mit einem privaten Worker.
Verwenden Sie den privaten Worker in Ihrer Pipeline.

Delivery Pipeline Private Worker-Toolintegration über die Konsole konfigurieren

Führen Sie die folgenden Schritte aus, um die Toolintegration für private Delivery Pipeline-Worker für Ihre Toolchain zu konfigurieren:

Klicken Sie in der IBM Cloud Konsole auf das Menü-Symbol ( ) > Plattformautomatisierung > Toolchains. Klicken Sie auf der Seite 'Toolchains' auf eine Toolchain, um die zugehörige Übersichtsseite zu öffnen.

a. Klicken Sie auf Tool hinzufügen.

b. Klicken Sie im Abschnitt mit den Toolintegrationen auf Delivery Pipeline Private Worker.
Geben Sie einen Namen für die Toolintegration ein. Dieser Name identifiziert einen Pool privater Worker auf der Registerkarte Worker der Pipeline-Phase.
Geben Sie Ihren Service-ID-API-Schlüssel ein, um den Zugriff auf die Arbeitswarteschlange zu authentifizieren, in der ein oder mehrere private Worker auf Arbeit warten können. Wenn Sie keinen Service-ID-API-Schlüssel haben, klicken Sie auf Erstellen, um einen für diesen privaten Worker zu generieren.
Klicken Sie auf Integration erstellen.
Klicken Sie auf der Übersichtsseite Ihrer Toolchain auf der Karte Delivery Pipelines auf Delivery Pipeline Private Worker. Es wird eine Liste aller Worker angezeigt, die mithilfe eines API-Schlüssels registriert wurden, der dieser Service-ID zugeordnet ist.

Die Liste mit Workern ist leer, bis Sie zum ersten Mal private Delivery Pipeline-Worker verwenden.

Weitere Informationen zur Integration des Delivery Pipeline Private Worker-Tools finden Sie unter Delivery Pipeline Private Worker konfigurieren.

Integration des Tools Delivery Pipeline Private Worker mit der API konfigurieren

Rufen Sie ein IAM-Trägertoken ab..
Bestimmen Sie die Region und ID der Toolchain, zu der Sie die Toolintegration Delivery Pipeline hinzufügen wollen.

Fügen Sie die Toolintegration für private Delivery Pipeline-Worker zur Toolchain hinzu.

curl -X POST \
  https://api.{region}.devops.cloud.ibm.com/toolchain/v2/toolchains/{toolchain_id}/tools \
  -H 'Authorization: Bearer {token}' \
  -H 'Accept: application/json` \
  -H 'Content-Type: application/json' \
    -d '{
    "tool_type_id": "private_worker",
    "parameters": {
      "name":"{tool_integration_name}", "workerQueueCredentials":"{sid_apikey}"
      }
  }'

In der folgenden Tabelle werden alle im vorherigen Schritt verwendeten Variablen aufgelistet und beschrieben.

Variablen zum Hinzufügen der Delivery Pipeline Private Worker Tool Integration mit der API
Variable	Beschreibung
`{region}`	Die Region, in der sich die Toolchain befindet, z. B. `us-south`.
`{tool_integration_name}`	Ein Name für Ihre Toolintegration, z. B. `dev-worker`.
`{toolchain_id}`	Die ID der Toolchain, zu der die Toolintegration hinzugefügt wird
`{token}`	Ein gültiges IAM-Bearer-Token.
`{sid_apikey}`	Ein Service-ID-API-Schlüssel, der vom privaten Worker für die Authentifizierung bei der Arbeitswarteschlange verwendet wird.

Integration des Tools Delivery Pipeline Private Worker mit Terraform konfigurieren

Um das Terraform CLI zu installieren und das IBM Cloud Provider-Plugin für Terraform zu konfigurieren, folgen Sie dem Lernprogramm für Erste Schritte mit Terraform auf IBM Cloud®.
Erstellen Sie eine Terraform-Konfigurationsdatei mit dem Namen main.tf. Fügen Sie in dieser Datei die Konfiguration hinzu, um mithilfe der HashiCorp-Konfigurationssprache eine Pipeline zu erstellen. Weitere Informationen zur Verwendung dieser Konfigurationssprache finden Sie in der Terraform-Dokumentation.

Ein privater Worker muss zu einer Toolchain gehören. Sie können Toolchains auch mit Terraform erstellen.

Im folgenden Beispiel werden eine Toolchain und ein privater Worker unter Verwendung der angegebenen Terraform-Ressourcen erstellt.
```
data "ibm_resource_group" "group" {
  name = "default"
}
resource "ibm_cd_toolchain" "my_toolchain" {
  name              = "terraform_toolchain"
  resource_group_id = data.ibm_resource_group.group.id
}
resource "ibm_cd_toolchain_tool_privateworker" "my_private_worker" {
  parameters {
     name = "terraform-private-worker"
     worker_queue_credentials = "{my_sid_apikey}"
  }
  toolchain_id = ibm_cd_toolchain.my_toolchain.id
}
```
Weitere Informationen zu ibm_cd_toolchain_tool_privateworker finden Sie in den Argumentreferenzdetails in der Dokumentation zur Terraform-Registry.
Initialisieren Sie bei Bedarf die Terraform-CLI.
```
terraform init
```
Erstellen Sie einen Terraform-Ausführungsplan. Dieser Plan fasst alle Aktionen zusammen, die ausgeführt werden müssen, um eine Toolchain mit einem privaten Worker zu erstellen.
```
terraform plan
```
Wenden Sie den Terraform-Ausführungsplan an. Terraform führt alle erforderlichen Aktionen aus, um die Toolchain und den privaten Worker zu erstellen.
```
terraform apply
```

Kubernetes-Cluster konfigurieren

Konfigurieren Sie Ihren Kubernetes-Cluster mit einem privaten Worker:

Klicken Sie in der IBM Cloud-Konsole auf das Menüsymbol und wählen Sie DevOps aus. Klicken Sie auf der Seite 'Toolchains' auf eine Toolchain, um die zugehörige Übersichtsseite zu öffnen.
Klicken Sie auf der Karte Delivery Pipelines auf die Delivery Pipeline Private Worker-Toolintegration, die Sie konfigurieren möchten.
Klicken Sie auf Einführung und befolgen Sie dann die Schritte zum Installieren und Registrieren eines privaten Workers in Ihrem Kubernetes-Cluster.

Private Delivery Pipeline-Worker in Ihrer Pipeline verwenden

Führen Sie die folgenden Schritte aus, um den privaten Worker in Ihrer Pipeline zu verwenden:

Klicken Sie in der IBM Cloud Konsole auf das Menü-Symbol ( ) > Plattformautomatisierung > Toolchains. Klicken Sie auf der Seite 'Toolchains' auf eine Toolchain, um die zugehörige Übersichtsseite zu öffnen.
Klicken Sie auf der Karte Delivery Pipelines auf die Pipeline, mit der Sie den privaten Worker verwenden möchten.
Wenn Sie eine Classic-Pipeline verwenden, klicken Sie auf der Seite 'Pipeline' auf der Stage auf das Symbol Stage-Konfiguration. Klicken Sie anschließend auf Stage konfigurieren und anschließend auf die Registerkarte Worker.
Wenn Sie eine Tekton-Pipeline verwenden, wählen Sie ab dem Auslöser, für den Sie einen Worker angeben möchten, die Seite 'Worker' aus.
Wählen Sie den privaten Worker aus, den Sie in Ihrer Pipeline verwenden möchten.

Standardmäßig werden Pipelinejobs und Pipelineausführungen unter Verwendung eines Pools von gemeinsam genutzten IBM-verwalteten Workern in der Region ausgeführt, in der die Pipeline definiert ist.
Klicken Sie auf Speichern.
Sie können Ihre Classic-Pipeline-Stage oder Tekton-Pipeline manuell ausführen oder Sie können warten, bis ein Auslöser die Pipelineausführung startet. Die Pipelineausführung wird unter Verwendung des angegebenen privaten Workers im zugeordneten Kubernetes-Cluster abgeschlossen. Sie können die Protokolldateiausgabe für die Jobs oder die Seite 'Ausführungsdetails' in Tekton-Pipelines anzeigen, um festzustellen, welcher Worker verwendet wurde.

Ausgabe von privaten Delivery Pipeline-Workern überprüfen

Wenn Ihnen die Rolle eines Toolchain-Bearbeiters zugewiesen wird, können Sie die Pipeline-Ausführungsprotokolle auf der Seite mit dem Phaseverlaufsprotokoll der Pipeline anzeigen.

Wenn Ihnen die Rolle des Toolchain-Administrators zugewiesen wurde oder Sie über Zugriff auf Worker-Cluster verfügen, können Sie die Kubernetes-Ressourcen in der Installation auch über die Befehlszeilenschnittstelle 'kubectl' überprüfen.

Private Arbeitskräfteproduktion
Aktion	Befehl
Anzeigen der Liste von Namensbereichen im Cluster	`$ kubectl get ns` (während die Pipeline ausgeführt wird). Mindestens ein Namensbereich mit dem Präfix `pw-` wird während der Pipeline-Jobausführung zurückgegeben. Zum Beispiel `pw-f0fb3cdb-5173-4785-ae92-bb05268e041e`.
Anzeigen des Pods, der den Pipelinejob ausführt	`$ kubectl get pods -n pw-f0fb3cdb-5173-4785-ae92-bb05268e041e`
Starten einer Bash-Sitzung in einem Pod namens `pw-f0fb3cdb-5173-4785-ae92-bb05268e041e`	`kubectl -n pw-f0fb3cdb-5173-4785-ae92-bb05268e041e exec -it job-pod-e56e78 bash`

Berechtigungsnachweise der Toolintegration für private Delivery Pipeline-Worker ändern

Nachdem Sie Ihren privaten Worker eingerichtet haben, können Sie die Berechtigungsnachweise aktualisieren, die für die Toolintegration verwendet werden. Möglicherweise möchten Sie diese Berechtigungsnachweise ändern, wenn sie gelöscht, abgelaufen oder gefährdet sind. Sie können die Berechtigungsnachweise aktualisieren, indem Sie eine neue Service-ID erstellen oder den API-Schlüssel aktualisieren.

Service-ID erstellen

Eine Service-ID dient (ähnlich wie eine Benutzer-ID, die einen Benutzer identifiziert) zur Identifikation eines Service oder einer Anwendung. Sie können eine Service-ID dazu verwenden, einer Anwendung außerhalb von IBM Cloud® den Zugriff auf Ihren IBM Cloud®-Service zu erteilen. Weitere Informationen zu Service-IDs finden Sie im Artikel Service-IDs erstellen und damit arbeiten.

Führen Sie die folgenden Schritte aus, um eine Service-ID zu erstellen:

Klicken Sie in der IBM Cloud Konsole auf das Menü-Symbol ( ) > Plattformautomatisierung > Toolchains. Klicken Sie auf der Seite 'Toolchains' auf eine Toolchain, um die zugehörige Übersichtsseite zu öffnen.
Klicken Sie auf der Karte Delivery Pipelines auf die Toolintegration für private Worker, die Sie ändern möchten, klicken Sie auf das Menü und anschließend auf Konfigurieren, um auf die Konfigurationsoptionen zuzugreifen.
Klicken Sie auf Erstellen.
Geben Sie einen Namen und eine Beschreibung für die Service-ID ein.
Klicken Sie auf Integration speichern.
Klicken Sie im DevOps-Dashboard auf der Seite Toolchains auf eine Toolchain, um die zugehörige Übersichtsseite zu öffnen.
Klicken Sie auf der Karte Delivery Pipelines auf die Delivery Pipeline Private Worker-Toolintegration, für die Sie neue Benutzerberechtigungsnachweise angeben möchten.
Klicken Sie auf Einführung und führen Sie die Schritte 2 und 3 aus, um den privaten Worker in Ihrem Cluster zu registrieren und zu überprüfen.

API-Schlüssel aktualisieren

Bei einem API-Schlüssel handelt es sich um einen eindeutigen Code, der an eine API übergeben wird, um die aufrufende Anwendung oder den aufrufenden Benutzer zu identifizieren. Um eine böswillige Verwendung einer API zu verhindern, können Sie mithilfe von API-Schlüsseln nachverfolgen und kontrollieren, wie diese API verwendet wird. Weitere Informationen zu API-Schlüsseln finden Sie unter Informationen zu API-Schlüsseln.

Führen Sie die folgenden Schritte aus, um den API-Schlüssel für die Verwendung mit der Toolintegration für private Delivery Pipeline-Worker zu aktualisieren:

Klicken Sie in der IBM Cloud Konsole auf das Menü-Symbol ( ) > Plattformautomatisierung > Toolchains. Klicken Sie auf der Seite 'Toolchains' auf eine Toolchain, um die zugehörige Übersichtsseite zu öffnen.
Rufen Sie auf der Karte Delivery Pipelines den Delivery Pipeline Private Worker auf, den Sie ändern wollen, klicken Sie auf das Menü und klicken Sie dann auf Konfigurieren, um auf die Konfigurationsoptionen zuzugreifen.
Geben Sie Ihren neuen API-Schlüssel an. Es wird empfohlen, den API-Schlüssel nicht direkt zu verwenden. Verwenden Sie stattdessen einen Secrets Manager, um den API-Schlüssel zu speichern und einen Verweis auf diesen gespeicherten Schlüssel in Ihrer privaten Worker-Konfiguration hinzuzufügen.
Klicken Sie auf Integration speichern.

Sie können den Zugriff auf einen privaten Worker widerrufen, indem Sie den entsprechenden API-Schlüssel löschen. Aufgrund von Caching-Richtlinien und der Invalidierung kann es bis zu 60 Minuten dauern, bis ein gelöschter API-Schlüssel verhindert, dass Jobs ausgeführt werden. Weitere Informationen zum Löschen eines API-Schlüssels finden Sie unter API-Schlüssel für eine Service-ID löschen.

Privaten Delivery Pipeline-Worker löschen

Führen Sie die folgenden Schritte aus, um einen privaten Worker zu löschen:

Löschen Sie den privaten Worker aus dem Pool der Worker.
Löschen Sie den privaten Worker aus Ihrem Kubernetes-Cluster.

Privaten Delivery Pipeline-Worker aus dem Pool der Worker löschen

Führen Sie die folgenden Schritte aus, um den privaten Worker aus dem Pool der Worker zu löschen:

Klicken Sie in der IBM Cloud Konsole auf das Menü-Symbol ( ) > Plattformautomatisierung > Toolchains. Klicken Sie auf der Seite 'Toolchains' auf eine Toolchain, um die zugehörige Übersichtsseite zu öffnen.
Klicken Sie auf der Karte Delivery Pipelines auf die Delivery Pipeline Private Worker-Toolintegration, die Sie konfigurieren wollen.
Klicken Sie auf Übersicht.
Klicken Sie auf das Menü für den privaten Worker, den Sie löschen möchten, um auf die Konfigurationsoptionen zuzugreifen.
Klicken Sie auf Entfernen und dann auf Bestätigen.

Wenn Sie alle privaten Worker aus einem Pool von Workern löschen, schlagen nachfolgende Ausführungen der Stage 'Classic Pipelines' fehl und die Nachricht No workers currently registeredwird im Stageprotokoll angezeigt. Für Tekton-Pipelines werden nachfolgende Phasenausführungsanforderungen in eine Warteschlange gestellt und erst ausgeführt, wenn ein Worker im ausgewählten Worker-Pool verfügbar ist.

Obwohl das Löschen einer Toolintegration für private Worker aus einer Toolchain verhindert, dass diese Toolchain den Pool von Workern verwendet, können andere Toolchains weiterhin den Workerpool verwenden. Sie können einen Pool von Workern aus allen Toolchains löschen, indem Sie die Service-ID löschen, die der Toolintegration für private Delivery Pipeline-Worker zugeordnet ist.

Privaten Delivery Pipeline-Worker aus Ihrem Kubernetes-Cluster löschen

Führen Sie die folgenden Schritte in der Konsole aus, um den privaten Worker aus Ihrem Cluster zu löschen:

Klicken Sie auf die Toolintegration für private Delivery Pipeline-Worker, die Sie konfigurieren möchten.
Klicken Sie auf Einführung und befolgen Sie die Schritte zum Löschen des privaten Workers aus Ihrem Cluster.

Führen Sie den folgenden Befehl aus, um den privaten Worker über die Befehlszeilenschnittstelle aus Ihrem Cluster zu löschen:

kubectl delete --filename "https://private-worker-service.{REGION}.devops.cloud.ibm.com/install/worker?serviceId={SERVICE_ID}&apikey={APIKEY}&name={WORKER_NAME}"

Toolintegration für Delivery Pipeline Private Worker über die Konsole löschen

Wenn Sie die Toolintegration für private Delivery Pipeline-Worker aus Ihrer Toolchain löschen, kann diese Löschung nicht mehr rückgängig gemacht werden.

Führen Sie die folgenden Schritte aus, um eine Toolintegration für private Delivery Pipeline-Worker zu löschen:

Klicken Sie in der IBM Cloud Konsole auf das Menü-Symbol ( ) > Plattformautomatisierung > Toolchains. Klicken Sie auf der Seite 'Toolchains' auf eine Toolchain, um die zugehörige Übersichtsseite zu öffnen.
Klicken Sie auf der Karte Delivery Pipelines auf die Delivery Pipeline Private Worker-Toolintegration, die Sie löschen wollen, und klicken Sie dann auf das Menü, um auf die Konfigurationsoptionen zuzugreifen.
Klicken Sie auf Löschen, um die Toolintegration aus Ihrer Toolchain zu löschen.
Bestätigen Sie dies, indem Sie nochmals auf Löschen klicken. Die Toolintegration für private Delivery Pipeline-Worker wird aus der Toolchain entfernt und ist auf der Registerkarte Worker auf der Seite für die Delivery Pipeline-Phase-Konfiguration nicht mehr verfügbar.

Wenn Sie die Toolintegration für private Delivery Pipeline-Worker aus einer Toolchain löschen und der private Worker für eine Pipeline-Phase konfiguriert ist, wird sie weiterhin auf der Registerkarte Worker auf der Phase-Konfigurationsseite aufgelistet. Der private Worker ist jedoch inaktiviert und mit REMOVED (entfernt) gekennzeichnet. Sie müssen einen anderen privaten Worker auswählen (sofern vorhanden) oder stattdessen einen öffentlichen Worker verwenden.

Integration des Tools Delivery Pipeline Private Worker mit der API löschen

Rufen Sie ein IAM-Trägertoken ab..
Bestimmen Sie die Region und ID der Toolchain, zu der Sie die Toolintegration Delivery Pipeline hinzufügen wollen.

Entfernen Sie die Toolintegration für Delivery Pipeline Private Worker aus der Toolchain.

curl -X DELETE \
  https://api.{region}.devops.cloud.ibm.com/toolchain/v2/toolchains/{toolchain_id}/tools/{worker_id} \
  -H 'Authorization: Bearer {token}'

In der folgenden Tabelle werden alle im vorherigen Schritt verwendeten Variablen aufgelistet und beschrieben.

Variablen zum Löschen der Delivery Pipeline Private Worker Tool-Integration mit der API
Variable	Beschreibung
`{region}`	Die Region, in der sich die Toolchain befindet, z. B. `us-south`.
`{worker_id}`	Die ID des zu löschenden privaten Worker-Tools.
`{toolchain_id}`	Die ID der Toolchain, zu der die Toolintegration hinzugefügt wird
`{token}`	Ein gültiges IAM-Bearer-Token.

Integration des Tools ' Delivery Pipeline Private Worker' mit Terraform löschen

Suchen Sie die Terraform-Datei (z. B. main.tf), die den Block resource für die vorhandene Pipeline enthält.

Die resource im folgenden Beispiel beschreibt eine vorhandene Pipeline.

data "ibm_resource_group" "group" {
  name = "default"
}
resource "ibm_cd_toolchain" "my_toolchain" {
  name              = "terraform_toolchain"
  resource_group_id = data.ibm_resource_group.group.id
}
resource "ibm_cd_toolchain_tool_privateworker" "my_private_worker" {
  parameters {
     name = "terraform-private-worker"
     worker_queue_credentials = "{my_sid_apikey}"
  }
  toolchain_id = ibm_cd_toolchain.my_toolchain.id
}

Entfernen Sie den ibm_cd_toolchain_privateworker resource-Block aus Ihrer Terraform-Datei.
Initialisieren Sie bei Bedarf die Terraform-CLI.
```
terraform init
```
Erstellen Sie einen Terraform-Ausführungsplan. Dieser Plan fasst alle Aktionen zusammen, die ausgeführt werden müssen, um eine Toolchain mit einem privaten Worker zu erstellen.
```
terraform plan
```
Wenden Sie den Terraform-Ausführungsplan an. Terraform führt alle erforderlichen Aktionen aus, um den privaten Worker aus Ihrer Toolchain zu entfernen.
```
terraform apply
```

Da der private Workeragent möglicherweise in anderen Toolchains verwendet wird, verbleibt er in Ihren Clustern, bis Sie ihn löschen.

Status des privaten Workers Delivery Pipeline anzeigen

Sie können den Status des privaten Workers in einem Cluster anzeigen, um zu überprüfen, ob der private Worker registriert ist und einen gültigen API-Schlüssel verwendet. Die Registrierung privater Worker und die Zuweisung von API-Schlüsseln werden während der ersten Registrierung privater Worker eingerichtet. Mit diesen Einstellungen kann der private Worker mit dem IBM Cloud® Continuous Delivery-Framework kommunizieren und als aktiv betrachtet werden.

Führen Sie die folgenden Schritte aus, um den Status des privaten Workers auf dem Cluster anzuzeigen, auf dem er installiert ist:

Melden Sie sich als berechtigter Benutzer bei dem Cluster an, der den Worker hostet.
Führen Sie den folgenden Befehl aus, um alle Agenten aufzulisten, die im Cluster registriert sind:
```
kubectl get workeragents
```
Für jeden Agenten sind die folgenden Informationen aufgeführt:
- Name: Der für diesen Worker registrierte Name.
- ServiceID: Die serviceId dieses Arbeiters.
- Agent: Gibt an, ob der Worker-Agent ordnungsgemäß im Cluster arbeitet, indem er OK angibt oder eine Fehlernachricht anzeigt.
- Registriert: Der Registrierungsstatus des Workers, z. B. Succeeded oder Unregistered.
- Version: Die Version dieses Workers für die aktuelle Version, die vom Framework verwendet wird, wie z. B. OK, Outdated oder Unsupported.
- Auth: Die Gültigkeit des API-Schlüssels, der vom Worker verwendet wird, wie z. B. OK oder Error.
- Eingeschränkt: Gibt an, ob Clusterprobleme vorhanden sind, die sich auf den Worker auswirken, indem sie OK angeben oder eine Fehlernachricht anzeigen.
- Angehalten: Gibt an, ob der Agent aktiv nach neuen Aufgaben sucht, indem er true oder false angibt.

Um den Gesamtstatus eines registrierten privaten Worker-Pools zu überprüfen, überprüfen Sie die Übersichtsseite des privaten Delivery Pipeline-Workers in der Toolchain, in der er verwendet wird.

Klicken Sie in der IBM Cloud Konsole auf das Menü-Symbol ( ) > Plattformautomatisierung > Toolchains. Klicken Sie auf der Seite 'Toolchains' auf eine Toolchain, um die zugehörige Übersichtsseite zu öffnen.
Klicken Sie auf der Karte Delivery Pipelines auf die Toolintegration für private Worker, für die Sie eine Liste aller registrierten Worker anzeigen wollen. Dieser Worker-Pool enthält mindestens einen privaten Worker, der auf verschiedenen Clustern installiert ist, aber ein ServiceId gemeinsam nutzt. Wenn Arbeit einem privaten Worker-Pool zugeordnet wird, sind alle privaten Worker, die im Pool aufgelistet sind, zur Ausführung der Workload berechtigt.

Die folgenden Informationen werden für jeden in diesem Pool registrierten Worker bereitgestellt:
- Name: Der Name des registrierten Workers.
- Status: Der aktuelle Status des Workers.
- Version: Die aktuelle Version des Workers. Wenn die aktuelle Version veraltet ist, wird eine Benachrichtigung angezeigt.
- Tekton-Version: Die Tekton-Releaseversion.
- Cluster: Der Name des Clusters, auf dem der Worker registriert ist, sofern verfügbar
- Letzte aktive: Der Zeitpunkt, zu dem der Agent zuletzt berichtet hat.
Private Worker können einen der folgenden Status annehmen:
- active: Der private Worker funktioniert normal.
- inactive: Der private Worker ist offline. Überprüfen Sie Ihren Cluster. Möglicherweise müssen Sie den privaten Worker erneut registrieren.
- unsupported: Die verwendete Version des privaten Workers wird nicht mehr unterstützt. Der private Worker lässt sich nicht ausführen, und Sie müssen auf die neueste Version aktualisieren.

Privaten Delivery Pipeline-Worker aktualisieren

Führen Sie die folgenden Schritte aus, um einen privaten Worker auf die neueste Version zu aktualisieren:

Melden Sie sich als berechtigter Benutzer bei dem Cluster an, der den Worker hostet.
Führen Sie den folgenden Befehl aus:

kubectl apply --filename "https://private-worker-service.{REGION}.devops.cloud.ibm.com/update"

Delivery Pipeline Private Worker-Images

Das Installationsscript für private Worker extrahiert erforderliche Images aus dem globalen IBM Cloud® Container Registry. Es extrahiert die neuesten Images von privaten Pipeline-Workern und die entsprechenden Tekton-Framework-Images, die Fixes für gefundene Sicherheitslücken enthalten.

Die Image-URL für den privaten Worker der Pipeline lauteticr.io/continuous-delivery/pipeline/pipeline-private-worker:<agent version>.

Bei der Installation des Private Worker werden außerdem die folgenden unterstützenden Open-Source-Images in den Cluster heruntergeladen:

icr.io/continuous-delivery/pipeline/tekton/controller
icr.io/continuous-delivery/pipeline/tekton/entrypoint
icr.io/continuous-delivery/pipeline/tekton/nop
icr.io/continuous-delivery/pipeline/tekton/sidecarlogresults
icr.io/continuous-delivery/pipeline/tekton/events
icr.io/continuous-delivery/pipeline/tekton/workingdirinit
icr.io/continuous-delivery/pipeline/tekton/powershell
icr.io/continuous-delivery/pipeline/tekton/resolvers
icr.io/continuous-delivery/pipeline/tekton/webhook

Der private Worker Agent verwendet auch die folgenden internen Images:

icr.io/continuous-delivery/pipeline/pipeline-private-worker-util
icr.io/continuous-delivery/pipeline/tekton/kubectl-jq
icr.io/continuous-delivery/pipeline/tekton/ubi
icr.io/continuous-delivery/pipeline/tekton/base

Unterstützung für vorherige private Worker-Images von Delivery Pipeline

Um die aktuellen Features und Fixes zu nutzen und die vollständige Konformität zu gewährleisten, wird empfohlen, dass Sie Ihre privaten Worker-Images auf dem neuesten Stand halten.

Für jedes nachfolgende Release eines privaten Worker-Image wird die Versionsnummer aktualisiert.

Agentenänderungen führen zu einem Inkrement der Nebenversion, z. B. Änderungen in Version 14.10 in Version 14.11.
Eine neue Änderung des Tekton-Frameworks führt zu einem Inkrement der Hauptversion, z. B. Änderung der Version 14.11 in Version 15.0.

IBM Cloud® Continuous Delivery unterstützt die n-1-Hauptversion des aktuellen privaten Worker-Image. Wenn das aktuelle Image beispielsweise die Version 14.xhat, können auch Images der Vorgängerversion 13.x ausgeführt werden. Nachdem die Hauptversion des Pipeline-Worker-Image auf 15.xerhöht wurde, sind Images der Versionen 14.x zulässig, aber alle Images der Version 13.x oder früher gelten als veraltet.