Voraussetzungen

Bevor Sie einen privaten Worker installieren, müssen Sie sicherstellen, dass Sie über ein IBM Cloud®-Konto verfügen, um Authentifizierungsschlüssel zu erstellen. Sie benötigen die neueste kubectl-Version, die auf dem Desktop-Computer des Administrators installiert ist. Außerdem benötigen Sie einen Kubernetes-Cluster (Version 1.15 oder höher) mit Administratorrechten, um einen privaten Worker zu installieren.

• Vorgeschlagene Kubernetes-Clusterkonfigurationen:

  • IBM Cloud Kubernetes Service Version 1.21 oder höher, um Workloads isoliert auf IBM Cloud Public auszuführen.
  • Red Hat® OpenShift® on IBM Cloud® Version 4.9 oder höher

• Netzzugriff:

  • Eingehend: Nicht erforderlich.

  • Der ausgehende Netzwerkzugriff erfolgt über, wobei (TCP:443) die Region mit dem Standort der Auslieferungspipeline übereinstimmt und entweder ( au-syd Sydney, Australien), eu-de (Frankfurt, Deutschland), eu-gb (London, Vereinigtes Königreich), jp-tok (Tokio, Japan), us-south (Dallas, USA), us-east (Washington, D.C., USA), br-sao (São Paulo) oder ca-tor (Toronto, Kanada) ist. Geben Sie beispielsweise für die Region 'Frankfurt' https://private-worker-service.eu-de.devops.cloud.ibm.com (TCP:443) an. Verwenden Sie für den Netzzugriff auf den globalen Endpunkt für die API-Schlüsselprüfung https://iam.cloud.ibm.com (TCP:443).

• Berechtigungen zum Abrufen von Images aus 'icr.io'. Private Worker benötigen die Tekton-Pipeline-Infrastruktur und müssen Tekton-Release-Images aus 'icr.io' abrufen können, um die Installation privater Worker durchzuführen.

  Um Bilder aus der icr.io Container-Registry zu beziehen, müssen Sie möglicherweise eine spezifische Kubernetes ClusterImagePolicy definieren.

Da Private Workers nicht mit Red Hat OpenShift-Pipelines kompatibel sind, wird empfohlen, diese nicht auf einem Cluster mit Red Hat OpenShift-Pipelines zu installieren.

Privaten Delivery Pipeline-Worker installieren

Um einen privaten Worker zu installieren, müssen Sie über Administratorzugriff auf einen Cluster verfügen. Die Installation eines privaten Workers kann nur über die Befehlszeile ausgeführt werden, weil keine grafische Benutzerschnittstelle verfügbar ist.

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

kubectl apply --filename "https://private-worker-service.{REGION}.devops.cloud.ibm.com/install?private=true"

Privaten Delivery Pipeline-Worker registrieren

$ ibmcloud iam service-id-create {worker-pool-name} -d "{worker-pool-description}"
Creating service ID {worker-pool-name} bound to current account as username@domain.com...OK
Service ID {worker-pool-name} is created successfully
Name           {worker-pool-name}
Description    {worker-pool-description}
CRN            crn:v1:bluemix:public:iam-identity::a/8d63fb1cc5e99e86dd7229dddff75fef::serviceid:ServiceId-38ffff31-3ea3-4ecc-9732-190f7a993097
Bound To       crn:v1:bluemix:public:::a/8d63fb1cc5e99e86dd7229dddff75fef:::
Version        1-6df15bde97b6e87f583a557f8731888f
Locked         false
UUID         ServiceId-38ffff31-3ea3-4ecc-9732-190f7a993097

$ ibmcloud iam service-api-key-create {worker-api-key-name} (SERVICE\_ID\_NAME|SERVICE\_ID\_UUID) \[-d, --description DESCRIPTION\] \[--file OUT_FILE\]
Creating API key  {worker-api-key-name} of service
SERVICE\_ID\_NAME as username@domain.com...
OK
Service API key {worker-api-key-name} is created
Successfully saved API key information to FILE
Please preserve the API key! It cannot be retrieved after it's created.
Name           {worker-api-key-name}
Description    Description
Bound To       crn:v1:bluemix:public:iam-identity::a/2cac145ae78048679b129009cfe8c7f9::serviceid:ServiceId-9a6a14e5-5811-4c2c-9131-0e1d4bb7dfe1
Created At     2019-07-04T10:51+0000
API Key        doJX9kORc4q5PRkH19H3lePDwYRAKNWk4XlIuEBrriOD
Locked         false
UUID           ApiKey-c1ee0fb5-90f2-476e-a260-a796e6d7f5f7

$ kubectl create secret generic {WORKER_NAME}-auth -n default --from-literal=apikey={API_KEY} && kubectl apply --filename "https://private-worker-service.{REGION}.devops.cloud.ibm.com/install/worker?serviceId={SERVICE_ID}&name={WORKER_NAME}"
workeragent.devops.cloud.ibm.com/worker-name created
secret/worker-name-auth created

  * `au-syd` (Sydney, Australien)
  * `eu-de` (Frankfurt, Deutschland)
  * `eu-gb` (London, Vereinigtes Königreich)
  * `jp-tok` (Tokio, Japan)
  * `us-south` (Dallas, USA)
  * `us-east` (Washington, D.C., USA)
  * `ca-tor` (Toronto, Kanada)
  * `br-sao` (São Paulo, Brasilien)

   $ kubectl create secret generic {WORKER_NAME}-auth -n default --from-literal=apikey={API_KEY} && kubectl apply --filename "https://private-worker-service.{REGION}.devops.cloud.ibm.com/install/worker?serviceId={SERVICE_ID}&name={WORKER_NAME}&private=true"

  *  Frankfurt `eu-de`
  *  London `eu-gb`
  *  Dallas `us-south`
  * Washington, D.C. `us-east`

$ kubectl get workeragents
NAME           SERVICEID     AGENT   REGISTERED   VERSION   AUTH   CONSTRAINED   PAUSED
<worker_name>  <ServiceId>   OK      Succeeded    OK        OK     false         false

Privaten Delivery Pipeline Worker für die Verwendung privater Endpunkte konfigurieren

Private Worker verwenden standardmäßig öffentliche Endpunkte für die Kommunikation. Ein Clusteradministrator kann die Konfiguration des privaten Workers so aktualisieren, dass private Endpunkte verwendet werden, sodass die Kommunikation zwischen dem privaten Worker und dem IBM Cloud® Continuous Delivery-Service nicht das öffentliche Internet verwendet.

1. Rufen Sie den Namen des Agenten ab, der auf dem Cluster installiert ist:

kubectl get workeragents -n default

2. Ändern Sie die apiUrlfür diesen Agenten:

kubectl patch workeragent {WORKER_NAME} --type='merge' -p '{"spec": {"apiUrl":"https://private-worker-service.private.{REGION}.devops.cloud.ibm.com"}}'

Dabei ist {REGION} die Position der Toolchain-Pipeline. Private Endpunkte sind in den folgenden Regionen verfügbar:

*  Dallas `us-south`
* Washington `us-east`
*  Frankfurt `eu-de`
*  London `eu-gb`

Zur Verwendung dieses Features benötigen Sie ein VRF-aktiviertes IBM Cloud-Konto.

3. Optional. Geben Sie den folgenden Befehl ein, um zur Verwendung öffentlicher Endpunkte für den Agenten zurückzukehren:

kubectl patch workeragent {WORKER_NAME} -n default --type='merge' -p '{"spec": {"apiUrl":"https://private-worker-service.{REGION}.devops.cloud.ibm.com"}}'

Privaten Delivery Pipeline-Worker für die Verwendung von Satellite-Linkendpunkten konfigurieren

Private Worker verwenden standardmäßig öffentliche Endpunkte für die Kommunikation. Ein Clusteradministrator kann die Konfiguration des privaten Workers so aktualisieren, dass Satellite-Linkendpunkte verwendet werden, sodass die Kommunikation zwischen dem privaten Worker und dem Service Continuous Delivery über Satellite-Linkendpunkte erfolgt.

1. Erstellen Sie einen Cloud Satellite Linkendpunkt für den Service IBM Cloud® Continuous Delivery und legen Sie FQDN und Service indication name so fest, dass der folgende Wert verwendet wird:

private-worker-service.{REGION}.devops.cloud.ibm.com

Dabei ist {REGION} die Position der Toolchain-Pipeline.

2. Erstellen Sie eine Konfigurationszuordnung im Namensbereich des privaten Workers, die die öffentlichen Endpunkte den Satellite-Linkendpunkten zuordnet:

apiVersion: v1
kind: ConfigMap
metadata:
   name: pipelineworker-url-map
data:
   iam.cloud.ibm.com: <default IAM satellite link endpoint for your satellite location>
   private-worker-service.{REGION}.devops.cloud.ibm.com: <satellite link endpoint created in step 1)>

Sie können der configmap Endpunkte hinzufügen, wie z. B. diese Standard-Link-Endpunkte Satellite.

Installation eines privaten Delivery Pipeline-Workers aktualisieren

Wenn der private Worker als inaktiv berichtet wird, müssen Sie die Installation aktualisieren.

Um die Version Ihres privaten Workers anzuzeigen, geben Sie einen der folgenden Befehle ein:

• IBM Cloud Kubernetes Service: kubectl -n tekton-pipelines describe deploy private-worker-agent | grep Image
• Red Hat® OpenShift® on IBM Cloud®: kubectl -n openshift-operators describe deploy private-worker-agent-controller-manager | grep Image

Führen Sie die folgenden Schritte aus, um die Installation Ihres privaten Workers zu aktualisieren:

1. Führen Sie den Installationsbefehl erneut aus.
2. Registrieren Sie den privaten Worker erneut in Ihrem Kubernetes-Cluster.

Sie können die apikey wiederverwenden, die Sie für den vorhandenen privaten Worker verwendet haben.

Weitere Informationen über Delivery Pipeline Privatangestellte finden Sie unter Fehlerbehebung für Delivery Pipeline Privatangestellte und FAQs für Pipeline Privatangestellte.