Freigeben über

Verwalten von Dienstverbindungen

  • Artikel

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019

Mit Dienstverbindungen können Sie authentifizierte Verbindungen zwischen Azure-Pipelines mit externen und Remotediensten für die Ausführung von Aufgaben in einem Auftrag erstellen. Nachdem Sie eine Verbindung hergestellt haben, können Sie die Dienstverbindung anzeigen, bearbeiten und Sicherheit hinzufügen.

Beispielsweise könnten Sie eine Verbindung mit einer der folgenden Kategorien und deren Diensten herstellen.

  • Ihr Microsoft Azure-Abonnement: Erstellen Sie eine Dienstverbindung mit Ihrem Microsoft Azure-Abonnement, und verwenden Sie den Namen der Dienstverbindung in einer Azure-Aufgabe zur Websitebereitstellung in einer Releasepipeline.
  • Ein anderer Buildserver oder Dateiserver: Erstellen Sie eine standardmäßige GitHub Enterprise Server-Dienstverbindung mit einem GitHub-Repository.
  • Eine Continuous Integration-Onlineumgebung: Erstellen sie eine Jenkins-Dienstverbindung für die fortlaufende Integration von Git-Repositorys.
  • Auf Remotecomputern installierte Dienste: Erstellen Sie eine Azure Resource Manager-Dienstverbindung mit einem virtuellen Azure-Computer (VM) mit einer verwalteten Dienstidentität.
  • Externe Dienste: Erstellen Sie eine Dienstverbindung mit einer Docker-Registrierung, einem Kubernetes-Cluster oder einem Maven-Repository.

Tipp

Weitere Informationen finden Sie unter Allgemeine Dienstverbindungstypen.

Voraussetzungen

Sie können eine Dienstverbindung basierend auf Ihren zugewiesenen Benutzerrollen erstellen, anzeigen, verwenden und verwalten. Weitere Informationen finden Sie unter Dienstverbindungsberechtigungen.

Erstellen einer Dienstverbindung

Führen Sie die folgenden Schritte aus, um eine Dienstverbindung für Azure Pipelines zu erstellen.

  1. Wechseln Sie zu Ihrem Projekt in Ihrer Sammlung oder Organisation.

  2. Wählen Sie Projekteinstellungen>Dienstverbindungen aus.

  3. Wählen Sie "Neue Dienstverbindung" aus, wählen Sie den benötigten Dienstverbindungstyp und dann "Weiter" aus.

  4. Wählen Sie eine Authentifizierungsmethode und anschließend Weiter aus.

  5. Geben Sie die Parameter für die Dienstverbindung ein. Die Parameter variieren je nach Dienstverbindungstyp und Authentifizierungsmethode.

    Screenshot der Dienstverbindungsparameter.

  6. Je nach Dienstverbindungstyp und Authentifizierungsmethode gibt es möglicherweise einen Link zum Überprüfen der Verbindung. Der Überprüfungslink sendet einen REST-Aufruf mit den eingegebenen Informationen an den externen Dienst und gibt an, ob der Aufruf erfolgreich war.

  7. Geben Sie den erforderlichen Verbindungsnamen ein. Der Name, den Sie verwenden, um in den Aufgabeneigenschaften auf die Dienstverbindung zu verweisen. Wenn Sie YAML verwenden, verwenden Sie diesen Namen als azureSubscription oder den entsprechenden Abonnementnamenwert im Skript.

  8. Geben Sie optional unter Beschreibung eine Beschreibung ein.

  9. Wählen Sie "Zugriffsberechtigung für alle Pipelines erteilen" aus, damit alle Pipelines diese Verbindung verwenden können. Wenn Sie diese Option nicht auswählen, müssen Sie die Dienstverbindung bearbeiten, um jede Pipeline explizit zu autorisieren, die sie verwendet.

  10. Wählen Sie "Speichern" oder "Überprüfen" und "Speichern" aus.

Hinweis

Das neue Dienstverbindungsfenster kann für die verschiedenen Arten von Dienstverbindungen unterschiedlich angezeigt werden und unterschiedliche Parameter aufweisen. Weitere Informationen finden Sie in der Liste der Parameter unter Allgemeine Dienstverbindungstypen für jeden Dienstverbindungstyp.

Bearbeiten der Dienstverbindung

Führen Sie die folgenden Schritte aus, um eine Dienstverbindung zu bearbeiten.

  1. Wählen Sie in Ihrem Projekt "Project settings>Service connections" aus.

  2. Wählen Sie die Dienstverbindung aus, die Sie bearbeiten möchten.

  3. Wählen Sie die Dienstverbindung aus, die Sie bearbeiten möchten.

  4. Auf der Registerkarte "Übersicht " werden die Details der Dienstverbindung angezeigt. Sie können z. B. den Verbindungstyp, den Ersteller und den Authentifizierungstyp verwenden.

    Screenshot der Übersichtsseite des Azure Resource Manager.

  5. Auf der Registerkarte "Verwendungsverlauf " wird die Liste der Pipelines angezeigt, die die Dienstverbindung verwendet haben.

    Screenshot des Azure Resource Manager-Nutzungsverlaufs.

  6. Auf der Registerkarte "Genehmigungen und Überprüfungen " können Sie die Genehmigungen und Überprüfungen verwalten, um eine Phase in einer Pipeline für die Verwendung der Dienstverbindung zuzulassen.

    Screenshot der Azure Resource Manager-Genehmigungen und -Prüfungen.

  7. Um die Dienstverbindung zu aktualisieren, wählen Sie Bearbeiten aus. Die Parameter, die Sie bearbeiten können, hängen vom Dienstverbindungstyp und der Authentifizierungsmethode ab.

  8. Sicherheit und Löschen sind Teil der weiteren Optionen in der oberen rechten Ecke.

    Screenshot der weiteren Optionen von Azure Resource Manager.

Weitere Informationen zum Verwalten von Sicherheitsberechtigungen finden Sie unter Festlegen von Dienstverbindungsberechtigungen.

Verwenden einer Dienstverbindung

Nachdem Sie Ihre Dienstverbindung erstellt haben, führen Sie die folgenden Schritte aus, um sie zu verwenden.

  1. Kopieren Sie den Verbindungsnamen als azureSubscription (oder den entsprechenden Verbindungsnamen) in Ihren Code.

    Screenshot der YaML-Dienstverbindungseinstellung.

  1. Autorisieren Sie die Dienstverbindung mithilfe einer der folgenden Techniken:

  • Um jede beliebige Pipeline für die Verwendung der Dienstverbindung zu autorisieren, öffnen Sie in Azure Pipelines die Seite „Einstellungen“, wählen Sie „Dienstverbindungen“ aus, und aktivieren Sie die Einstellung Nutzung dieser Verbindung für alle Pipelines erlauben für die Verbindung.

  • Um eine Dienstverbindung für eine bestimmte Pipeline zu autorisieren, öffnen Sie die Pipeline durch Auswählen von Bearbeiten, und fügen Sie der Warteschlange manuell einen Build hinzu. Daraufhin werden ein Ressourcenautorisierungsfehler und die Aktion „Ressourcen autorisieren“ für den Fehler angezeigt. Wählen Sie diese Aktion aus, um die Pipeline explizit als autorisierten Benutzer der Dienstverbindung hinzuzufügen.

Sie können außerdem eigene benutzerdefinierte Dienstverbindungen erstellen.

Allgemeine Dienstverbindungstypen

Azure Pipelines unterstützt standardmäßig die folgenden Dienstverbindungstypen:

Dienstverbindungstyp Beschreibung
Azure – klassisch Stellen Sie eine Verbindung mit Ihrem Azure-Abonnement über Anmeldeinformationen oder Zertifikate her.
Azure Repos/TFS Stellen Sie eine Verbindung mit Azure Repos in Ihrer DevOps-Organisation oder -Sammlung her.
Azure Resource Manager Stellen Sie eine Verbindung mit Azure-Ressourcen her.
Azure Service Bus Stellen Sie eine Verbindung mit einer Azure Service Bus-Warteschlange her.
Bitbucket-Cloud Stellen Sie eine Verbindung mit einem Bitbucket-Cloud-Repository her.
Cargo Stellen Sie eine Verbindung mit einem Cargo-Paket-Repository her.
Chef Stellen Sie eine Verbindung mit Chef ein Repository her.
Docker-Host Stellen Sie eine Verbindung mit einem Docker-Host her.
Docker Registry Stellen Sie eine Verbindung mit einer Docker-Registrierung über einen Docker Hub, eine Azure-Containerregistrierung oder andere Quellen her.
Allgemein Stellen Sie eine Verbindung mit einem generischen Server her.
GitHub Stellen Sie eine Verbindung mit einem GitHub-Repository her.
GitHub Enterprise Server Stellen Sie eine Verbindung mit einem GitHub Enterprise-Repository her.
Eingehender Webhook Stellen Sie eine Verbindung mit einem eingehenden Webhook her.
Jenkins Stellen Sie eine Verbindung mit einem Jenkins-Server her.
Jira Stellen Sie eine Verbindung mit einem Jira-Server her.
Kubernetes Stellen Sie eine Verbindung mit einem Kubernetes-Cluster her.
Maven Stellen Sie eine Verbindung mit einem Maven-Repository her.
npm Stellen Sie eine Verbindung mit einem npm-Repository her.
NuGet
Andere Git Stellen Sie eine Verbindung mit einem Git-Repository her.
Python-Paketdownload Stellen Sie eine Verbindung mit einem Python-Repository her, um sie herunterzuladen.
Python-Paketupload Stellen Sie eine Verbindung mit einem Python-Repository zum Hochladen her.
Service Fabric Stellen Sie eine Verbindung mit einem Azure Service Fabric-Cluster her.
SSH Stellen Sie eine Verbindung mit einem Host über SSH her.
Subversion Stellen Sie eine Verbindung mit einem Apache Subversion-Repository her.
Visual Studio App Center Stellen Sie eine Verbindung mit dem Visual Studio App Center-Server her.

Klassische Azure-Dienstverbindung

Verwenden Sie die folgenden Parameter, um mithilfe von Azure-Anmeldeinformationen oder einem Azure-Verwaltungszertifikat eine Verbindung mit einem Microsoft Azure-Abonnement zu definieren und zu schützen.

Parameter Beschreibung
Authentifizierungsmethode Erforderlich. Wählen Sie Anmeldeinformationen oder Zertifikatbasiert aus.
Umgebung Erforderlich. Wählen Sie Azure Cloud, Azure Stack oder eine der vordefinierten Azure Government Clouds aus, in denen Ihr Abonnement definiert ist.
Abonnement-ID Erforderlich. Der GUID-ähnliche Bezeichner für Ihr Azure-Abonnement (nicht der Abonnementname). Sie können die Abonnement-ID aus dem Azure-Portal kopieren.
Abonnementname Erforderlich. Der Name Ihres Microsoft Azure-Abonnements.
Benutzername Erforderlich für die Authentifizierung der Anmeldeinformationen. Benutzername eines Geschäfts- oder Schulkontos (z. B. @fabrikam.com)). Microsoft-Konten (z. B. werden @live oder @hotmail) nicht unterstützt).
Kennwort Erforderlich für die Authentifizierung der Anmeldeinformationen. Kennwort für den angegebenen Benutzer.
Verwaltungszertifikat Erforderlich für zertifikatbasierte Authentifizierung. Kopieren Sie den Wert des Verwaltungszertifikatschlüssels aus Ihrer XML-Datei mit den Veröffentlichungseinstellungen oder dem Azure-Portal.
Verbindungsname Erforderlich. Der Name, den Sie verwenden, um in den Aufgabeneigenschaften auf die Dienstverbindung zu verweisen. Wenn Sie YAML verwenden, verwenden Sie denselben Namen wie in azureSubscription oder den entsprechenden Abonnementnamen im Skript.
Beschreibung Optional. Die Beschreibung der Dienstverbindung.
Sicherheit Optional. Wählen Sie "Zugriffsberechtigung für alle Pipelines erteilen" aus, damit alle Pipelines diese Verbindung verwenden können. Wenn Sie diese Option nicht auswählen, müssen Sie die Dienstverbindung für jede Pipeline, die sie verwendet, explizit autorisieren.

Wählen Sie für die Zertifikatauthentifizierung "Überprüfen " aus, um Ihre Verbindungsinformationen zu überprüfen.

Wenn Ihr Abonnement in einer Azure Government Cloud definiert ist, stellen Sie sicher, dass Ihre Anwendung die relevanten Konformitätsanforderungen erfüllt, bevor Sie eine Dienstverbindung konfigurieren.

Azure Repos

Stellen Sie eine Verbindung mit einer Azure DevOps-Organisation oder Projektsammlung mithilfe einer einfachen oder tokenbasierten Authentifizierung her. Verwenden Sie die folgenden Parameter, um eine Verbindung mit einer anderen Azure DevOps-Organisation zu definieren und zu schützen.

Parameter Beschreibung
Authentifizierungsmethode Wählen Sie tokenbasierte oder Standardauthentifizierung aus.
Verbindungs-URL Erforderlich. Die URL der DevOps-Organisation oder Projektsammlung.
Benutzername Erforderlich für die Standardauthentifizierung. Der Benutzername zum Herstellen einer Verbindung mit dem Dienst.
Kennwort Erforderlich für die Standardauthentifizierung. Das Kennwort für den angegebenen Benutzernamen.
Persönliches Zugriffstoken Erforderlich für die tokenbasierte Authentifizierung. Das Token, das für die Authentifizierung beim Dienst verwendet werden soll. Weitere Informationen
Verbindungsname Erforderlich. Der Name, den Sie verwenden, um in den Aufgabeneigenschaften auf die Dienstverbindung zu verweisen. Wenn Sie YAML verwenden, verwenden Sie denselben Namen wie in azureSubscription oder den entsprechenden Abonnementnamen im Skript.
Beschreibung Optional. Die Beschreibung der Dienstverbindung.
Sicherheit Optional. Wählen Sie "Zugriffsberechtigung für alle Pipelines erteilen" aus, damit alle Pipelines diese Verbindung verwenden können. Wenn Sie diese Option nicht auswählen, müssen Sie die Dienstverbindung für jede Pipeline, die sie verwendet, explizit autorisieren.

Wählen Sie " Überprüfen " aus, um Ihre Verbindungsinformationen zu überprüfen.

Weitere Informationen finden Sie unter Authentifizieren des Zugriffs mit persönlichen Zugriffstoken für Azure DevOps.

Herstellen einer Verbindung mit Microsoft Azure

Informationen zum Erstellen einer Dienstverbindung mit einem Azure Resource Manager-Dienst finden Sie unter Herstellen einer Verbindung mit Microsoft Azure.

Azure Service Bus-Dienstverbindung

Verwenden Sie die folgenden Parameter, um eine Verbindung mit einer Microsoft Azure Service Bus-Warteschlange zu definieren und zu schützen.

Parameter Beschreibung
Service Bus-Warteschlangenname Der Name einer vorhandenen Azure Service Bus-Warteschlange.
Service Bus-Verbindungszeichenfolge Primäre oder sekundäre Verbindungszeichenfolge für Ihre Warteschlange. Informationen zum Abrufen der Verbindungszeichenfolge finden Sie unter "Abrufen der Verbindungszeichenfolge".
Verbindungsname Erforderlich. Der Name, den Sie verwenden, um in den Aufgabeneigenschaften auf die Dienstverbindung zu verweisen. Wenn Sie YAML verwenden, verwenden Sie denselben Namen wie in azureSubscription oder den entsprechenden Abonnementnamen im Skript.
Beschreibung Optional. Die Beschreibung der Dienstverbindung.
Sicherheit Optional. Wählen Sie "Zugriffsberechtigung für alle Pipelines erteilen" aus, damit alle Pipelines diese Verbindung verwenden können. Wenn Sie diese Option nicht auswählen, müssen Sie die Dienstverbindung für jede Pipeline, die sie verwendet, explizit autorisieren.

Bitbucket-Clouddienstverbindung

Verwenden Sie OAuth mit Autorisierung erteilen oder einen Benutzernamen und ein Kennwort mit Standardauthentifizierung, um eine Verbindung mit der Bitbucket-Cloud zu definieren. Damit die Pipelines weiterhin funktionieren, muss Ihr Repositoryzugriff aktiv bleiben.

Parameter Beschreibung
Authentifizierungsmethode Wählen Sie "Autorisierung erteilen" oder "Standardauthentifizierung" aus.
OAuth-Konfiguration Erforderlich für die Erteilungsautorisierung. OAuth-Verbindung mit Bitbucket.
Benutzername Erforderlich für die Standardauthentifizierung. Der Benutzername zum Herstellen einer Verbindung mit dem Dienst.
Kennwort Erforderlich für die Standardauthentifizierung. Das Kennwort für den angegebenen Benutzernamen.
Verbindungsname Erforderlich. Der Name, den Sie verwenden, um in den Aufgabeneigenschaften auf die Dienstverbindung zu verweisen. Wenn Sie YAML verwenden, verwenden Sie denselben Namen wie in azureSubscription oder den entsprechenden Abonnementnamen im Skript.
Beschreibung Optional. Die Beschreibung der Dienstverbindung.
Sicherheit Optional. Wählen Sie "Zugriffsberechtigung für alle Pipelines erteilen" aus, damit alle Pipelines diese Verbindung verwenden können. Wenn Sie diese Option nicht auswählen, müssen Sie die Dienstverbindung für jede Pipeline, die sie verwendet, explizit autorisieren.

Wählen Sie "Überprüfen" oder "Autorisieren" aus, um Ihre Verbindungsinformationen zu überprüfen.

Cargo-Dienstverbindung

Verwenden Sie die folgenden Parameter, um eine Verbindung mit einem Cargo-Artefaktrepository zu definieren und zu schützen.

Parameter Beschreibung
Authentifizierungsmethode Wählen Sie die Authentifizierungsmethode für das Artefaktrepository aus: Standard (Benutzer/Kennwort, einschließlich Azure DevOps-PATs) oder Autorisierungswert (einschließlich crates.io-Token).
Repository-URL Erforderlich. URL für das Repository. Verwenden Sie für crates.io https://crates.io.
Benutzername Erforderlich, wenn die Standardauthentifizierung ausgewählt ist. Der Benutzername zum Herstellen der Verbindung mit dem Endpunkt. Der Wert kann beliebig sein, wenn als Authentifizierungsmethode das persönliche Zugriffstoken oder der Autorisierungswert verwendet werden.
Kennwort Erforderlich, wenn die Standardauthentifizierung ausgewählt ist. Das Kennwort zum Herstellen der Verbindung mit dem Endpunkt. Persönliche Zugriffstoken gelten für Azure DevOps Services-Organisationen.
Token Erforderlich, wenn die Autorisierungswertauthentifizierung ausgewählt ist.
Name der Dienstverbindung Name für die Dienstverbindung
Verbindungsname Erforderlich. Der Name, den Sie verwenden, um in den Aufgabeneigenschaften auf die Dienstverbindung zu verweisen. Wenn Sie YAML verwenden, verwenden Sie denselben Namen wie in azureSubscription oder den entsprechenden Abonnementnamen im Skript.
Beschreibung Optional. Die Beschreibung der Dienstverbindung.
Sicherheit Optional. Wählen Sie "Zugriffsberechtigung für alle Pipelines erteilen" aus, damit alle Pipelines diese Verbindung verwenden können. Wenn Sie diese Option nicht auswählen, müssen Sie die Dienstverbindung für jede Pipeline, die sie verwendet, explizit autorisieren.

Chef-Dienstverbindung

Verwenden Sie die folgenden Parameter, um eine Verbindung mit einem Chef-Automatisierungsserver zu definieren und zu schützen.

Parameter Beschreibung
Server-URL Erforderlich. Die URL des Chef-Automatisierungsservers.
Knotenname (Benutzername) Erforderlich. Der Name des Knotens, mit dem eine Verbindung hergestellt werden soll. Normalerweise ist dieser Parameter Ihr Benutzername.
Clientschlüssel Erforderlich. Der in der Chef-PEM-Datei angegebene Schlüssel.
Name der Dienstverbindung Name für die Dienstverbindung
Verbindungsname Erforderlich. Der Name, den Sie verwenden, um in den Aufgabeneigenschaften auf die Dienstverbindung zu verweisen. Wenn Sie YAML verwenden, verwenden Sie denselben Namen wie in azureSubscription oder den entsprechenden Abonnementnamen im Skript.
Beschreibung Optional. Die Beschreibung der Dienstverbindung.
Sicherheit Optional. Wählen Sie "Zugriffsberechtigung für alle Pipelines erteilen" aus, damit alle Pipelines diese Verbindung verwenden können. Wenn Sie diese Option nicht auswählen, müssen Sie die Dienstverbindung für jede Pipeline, die sie verwendet, explizit autorisieren.

Docker-Hostdienstverbindung

Verwenden Sie die folgenden Parameter, um eine Verbindung mit einem Docker-Host zu definieren und zu schützen.

Parameter Beschreibung
Server-URL Erforderlich. Die URL des Docker-Hosts.
ZS-Zertifikat Erforderlich. Ein Zertifikat einer vertrauenswürdigen Zertifizierungsstelle, das zur Authentifizierung beim Host verwendet werden soll.
Zertifikat Erforderlich. Ein Clientzertifikat, das zur Authentifizierung beim Host verwendet werden soll.
Schlüssel Erforderlich. Der in der Docker-key.pem-Datei angegebene Schlüssel.
Name der Dienstverbindung Name für die Dienstverbindung
Verbindungsname Erforderlich. Der Name, den Sie verwenden, um in den Aufgabeneigenschaften auf die Dienstverbindung zu verweisen. Wenn Sie YAML verwenden, verwenden Sie denselben Namen wie in azureSubscription oder den entsprechenden Abonnementnamen im Skript.
Beschreibung Optional. Die Beschreibung der Dienstverbindung.
Sicherheit Optional. Wählen Sie "Zugriffsberechtigung für alle Pipelines erteilen" aus, damit alle Pipelines diese Verbindung verwenden können. Wenn Sie diese Option nicht auswählen, müssen Sie die Dienstverbindung für jede Pipeline, die sie verwendet, explizit autorisieren.

Weitere Informationen zum Schutz Ihrer Verbindung mit dem Docker-Host finden Sie unter Schützen des Docker-Daemon-Sockets.

Dienstverbindung für Docker-Registrierung

Sie können eine Dienstverbindung mit einer Docker-Containerregistrierung erstellen.

Wählen Sie den Registrierungstyp aus:

Docker Hub oder andere

Geben Sie die folgenden Parameter ein, um eine Verbindung mit einer Docker Hub-Registrierung oder anderen zu definieren.

Parameter Beschreibung
Docker-Registrierung Erforderlich. Die URL der Docker-Registrierung.
Docker-ID Erforderlich. Der Bezeichner der Docker-Kontobenutzerin/des Docker-Kontobenutzers.
Docker-Kennwort Erforderlich. Das Kennwort für die Docker-ID. (Docker Hub erfordert anstelle eines Kennworts ein PAT.)
E-Mail Optional. Eine E-Mail-Adresse für den Empfang von Benachrichtigungen.
Verbindungsname Erforderlich. Der Name, den Sie verwenden, um in den Aufgabeneigenschaften auf die Dienstverbindung zu verweisen. Wenn Sie YAML verwenden, verwenden Sie denselben Namen wie in azureSubscription oder den entsprechenden Abonnementnamen im Skript.
Beschreibung Optional. Die Beschreibung der Dienstverbindung.
Sicherheit Optional. Wählen Sie "Zugriffsberechtigung für alle Pipelines erteilen" aus, damit alle Pipelines diese Verbindung verwenden können. Wenn Sie diese Option nicht auswählen, müssen Sie die Dienstverbindung für jede Pipeline, die sie verwendet, explizit autorisieren.

Sie können "Überprüfen" auswählen, um Ihre Anmeldeinformationen zu überprüfen, bevor Sie die restlichen Parameter eingeben.

Azure Container Registry

Sie können eine Verbindung mit einer Azure-Containerregistrierung herstellen, indem Sie entweder einen Dienstprinzipal - oder verwalteten Identitätsauthentifizierungstyp verwenden.

Dienstprinzipalauthentifizierungstyp

Geben Sie die folgenden Parameter ein, um eine Verbindung mit einer Azure-Containerregistrierung mithilfe eines Dienstprinzipals zu definieren.

Parameter BESCHREIBUNG
Abonnement Erforderlich. Das Azure-Abonnement, das die Containerregistrierung enthält, die für die Erstellung einer Dienstverbindung verwendet werden soll.
Azure Container Registry Erforderlich. Die Azure Container Registry, die zum Erstellen einer Dienstverbindung verwendet werden soll.
Verbindungsname Erforderlich. Der Name, den Sie verwenden, um in den Aufgabeneigenschaften auf die Dienstverbindung zu verweisen. Wenn Sie YAML verwenden, verwenden Sie denselben Namen wie in azureSubscription oder den entsprechenden Abonnementnamen im Skript.
Beschreibung Optional. Die Beschreibung der Dienstverbindung.
Sicherheit Optional. Wählen Sie "Zugriffsberechtigung für alle Pipelines erteilen" aus, damit alle Pipelines diese Verbindung verwenden können. Wenn Sie diese Option nicht auswählen, müssen Sie die Dienstverbindung für jede Pipeline, die sie verwendet, explizit autorisieren.
Verwalteter Identitätsauthentifizierungstyp

Geben Sie die folgenden Parameter ein, um eine Verbindung mit einer Azure-Containerregistrierung mithilfe einer verwalteten Dienstidentität zu definieren.

Parameter Beschreibung
Abonnement-ID Erforderlich. Der GUID-ähnliche Bezeichner für Ihr Azure-Abonnement (nicht der Abonnementname). Sie können die Abonnement-ID aus dem Azure-Portal kopieren.
Abonnementname Erforderlich. Der Name Ihres Microsoft Azure-Abonnements.
Mandanten-ID Erforderlich. Der GUID-ähnliche Bezeichner für Ihren Azure Active Directory-Mandanten. Sie können die Mandanten-ID aus dem Azure-Portal kopieren.
Azure-Containerregistrierungs-Anmeldeserver Erforderlich. Der Anmeldeserver der Azure-Containerregistrierung.
Verbindungsname Erforderlich. Der Name, den Sie verwenden, um in den Aufgabeneigenschaften auf die Dienstverbindung zu verweisen. Wenn Sie YAML verwenden, verwenden Sie denselben Namen wie in azureSubscription oder den entsprechenden Abonnementnamen im Skript.
Beschreibung Optional. Die Beschreibung der Dienstverbindung.
Sicherheit Optional. Wählen Sie "Zugriffsberechtigung für alle Pipelines erteilen" aus, damit alle Pipelines diese Verbindung verwenden können. Wenn Sie diese Option nicht auswählen, müssen Sie die Dienstverbindung für jede Pipeline, die sie verwendet, explizit autorisieren.

Generische Dienstverbindung

Verwenden Sie die folgenden Parameter, um eine Verbindung mit einem beliebigen generischen Dienst- oder Anwendungstyp zu definieren und zu schützen.

Parameter Beschreibung
Server-URL Erforderlich. Die Dienst-URL des Diensts.
Benutzername Optional. Der Benutzername zum Herstellen einer Verbindung mit dem Dienst.
Kennwort/Tokenschlüssel Optional. Das Kennwort oder Zugriffstoken für den angegebenen Benutzernamen.
Verbindungsname Erforderlich. Der Name, den Sie verwenden, um in den Aufgabeneigenschaften auf die Dienstverbindung zu verweisen. Wenn Sie YAML verwenden, verwenden Sie denselben Namen wie in azureSubscription oder den entsprechenden Abonnementnamen im Skript.
Beschreibung Optional. Die Beschreibung der Dienstverbindung.
Sicherheit Optional. Wählen Sie "Zugriffsberechtigung für alle Pipelines erteilen" aus, damit alle Pipelines diese Verbindung verwenden können. Wenn Sie diese Option nicht auswählen, müssen Sie die Dienstverbindung für jede Pipeline, die sie verwendet, explizit autorisieren.

GitHub-Dienstverbindung

Verwenden Sie die folgenden Parameter, um eine Verbindung mit einem GitHub-Repository zu definieren.

Tipp

Es gibt eine bestimmte Dienstverbindung für Andere Git-Server und GitHub Enterprise Server-Verbindungen.

Parameter BESCHREIBUNG
Autorisierung auswählen Erforderlich. Entweder Autorisierung erteilen oder Persönliches Zugriffstoken.
Token Erforderlich für die Autorisierung des persönlichen Zugriffstokens. Ihr GitHub Personal Access Token (PAT).
Autorisierung erteilen Erforderlich für die Erteilungsautorisierung. Die OAuth-Konfiguration, die zum Herstellen einer Verbindung mit dem Dienst verwendet werden soll. Wählen Sie beispielsweise AzurePipelines aus, um die Azure-Pipeline zu verbinden.
Verbindungsname Erforderlich. Der Name, den Sie verwenden, um in den Aufgabeneigenschaften auf die Dienstverbindung zu verweisen. Wenn Sie YAML verwenden, verwenden Sie denselben Namen wie in azureSubscription oder den entsprechenden Abonnementnamen im Skript.
Beschreibung Optional. Die Beschreibung der Dienstverbindung.
Sicherheit Optional. Wählen Sie "Zugriffsberechtigung für alle Pipelines erteilen" aus, damit alle Pipelines diese Verbindung verwenden können. Wenn Sie diese Option nicht auswählen, müssen Sie die Dienstverbindung für jede Pipeline, die sie verwendet, explizit autorisieren.

Hinweis

Wenn Sie für die Option Autorisierung auswählen die Option Autorisierung erteilen auswählen, wird im Dialogfeld die Schaltfläche Autorisieren angezeigt, mit der die GitHub-Signaturseite geöffnet wird. Wenn Sie Persönliches Zugriffstoken auswählen, fügen Sie es in das Textfeld Token ein. Das Dialogfeld zeigt die empfohlenen Bereiche für das Token an: Repository, Benutzer*in, admin:repo_hook. Weitere Informationen finden Sie unter Erstellen eines Zugriffstokens für die Befehlszeilenverwendung. Führen Sie dann die folgenden Schritte aus, um Ihr GitHub-Konto in Ihrem Profil zu registrieren.

  1. Öffnen Sie Ihre Benutzereinstellungen über Ihren Kontonamen rechts neben der Überschrift der Azure Pipelines-Seite.
  2. Wählen Sie Persönliches Zugriffstoken aus.
  3. Wählen Sie Hinzufügen aus, und geben Sie die Informationen ein, die zum Erstellen des Tokens erforderlich sind.

Weitere Informationen finden Sie unter Artefaktquellen – Versionskontrolle.

GitHub Enterprise Server-Dienstverbindung

Verwenden Sie die folgenden Parameter, um eine Verbindung mit einem GitHub Enterprise-Repository zu definieren.

Tipp

Es gibt eine bestimmte Dienstverbindung für Andere Git-Server und standardmäßige GitHub-Dienstverbindungen.

Parameter BESCHREIBUNG
Autorisierung auswählen Erforderlich. Entweder Persönliches Zugriffstoken, Benutzername und Kennwort oder OAuth2.
Server-URL Erforderlich. Die Dienst-URL des Diensts.
Nicht vertrauenswürdige TLS/SSL-Zertifikate akzeptieren Legen Sie diese Option fest, damit Clients ein selbstsigniertes Zertifikat akzeptieren können, anstatt das Zertifikat in der TFS-Dienstrolle oder auf den Computern zu installieren, auf denen der Agent gehostet wird.
Token Erforderlich für die Autorisierung des persönlichen Zugriffstokens.
Benutzername Erforderlich für Authentifizierung mit Benutzername und Kennwort. Der Benutzername zum Herstellen einer Verbindung mit dem Dienst.
Kennwort Erforderlich für Authentifizierung mit Benutzername und Kennwort. Das Kennwort für den angegebenen Benutzernamen.
OAuth-Konfiguration Erforderlich für die OAuth2-Autorisierung. Sie können eine vorhandene OAuth-Konfiguration verwenden oder eine neue Konfiguration erstellen.
GitHub Enterprise Server-Konfigurations-URL Die URL wird aus der OAuth-Konfiguration abgerufen.
Verbindungsname Erforderlich. Der Name, den Sie verwenden, um in den Aufgabeneigenschaften auf die Dienstverbindung zu verweisen. Wenn Sie YAML verwenden, verwenden Sie denselben Namen wie in azureSubscription oder den entsprechenden Abonnementnamen im Skript.
Beschreibung Optional. Die Beschreibung der Dienstverbindung.
Sicherheit Optional. Wählen Sie "Zugriffsberechtigung für alle Pipelines erteilen" aus, damit alle Pipelines diese Verbindung verwenden können. Wenn Sie diese Option nicht auswählen, müssen Sie die Dienstverbindung für jede Pipeline, die sie verwendet, explizit autorisieren.

Hinweis

Wenn Sie Persönliches Zugriffstoken (Pat) auswählen, müssen Sie das PAT in das Textfeld Token einfügen. Das Dialogfeld zeigt die empfohlenen Bereiche für das Token an: Repository, Benutzer*in, admin:repo_hook. Weitere Informationen finden Sie unter Erstellen eines Zugriffstokens für die Befehlszeilenverwendung. Führen Sie dann die folgenden Schritte aus, um Ihr GitHub-Konto in Ihrem Profil zu registrieren.

  1. Öffnen Sie Ihre Benutzereinstellungen über Ihren Kontonamen rechts neben der Überschrift der Azure Pipelines-Seite.
  2. Wählen Sie Persönliches Zugriffstoken aus.
  3. Wählen Sie Hinzufügen aus, und geben Sie die Informationen ein, die zum Erstellen des Tokens erforderlich sind.

Eingehende WebHook-Dienstverbindung

Verwenden Sie die folgenden Parameter, um eine eingehende Webhook-Dienstverbindung zu erstellen.

Parameter Beschreibung
WebHook-Name Erforderlich. Der Name des WebHook.
Geheimnis Optional. Der geheime Schlüssel, der für die Authentifizierung mit dem WebHook verwendet werden soll.
HTTP-Header Optional. Der Kopfzeilenname, auf dem prüfsummen gesendet werden.
Verbindungsname Erforderlich. Der Name, den Sie verwenden, um in den Aufgabeneigenschaften auf die Dienstverbindung zu verweisen. Wenn Sie YAML verwenden, verwenden Sie denselben Namen wie in azureSubscription oder den entsprechenden Abonnementnamen im Skript.
Beschreibung Optional. Die Beschreibung der Dienstverbindung.
Sicherheit Optional. Wählen Sie "Zugriffsberechtigung für alle Pipelines erteilen" aus, damit alle Pipelines diese Verbindung verwenden können. Wenn Sie diese Option nicht auswählen, müssen Sie die Dienstverbindung für jede Pipeline, die sie verwendet, explizit autorisieren.

Jenkins-Dienstverbindung

Verwenden Sie die folgenden Parameter, um eine Verbindung mit dem Jenkins-Dienst zu definieren.

Parameter Beschreibung
Server-URL Erforderlich. Die URL des Jenkins-Servers.
Nicht vertrauenswürdige TLS/SSL-Zertifikate akzeptieren Legen Sie diese Option fest, damit Clients ein selbstsigniertes Zertifikat akzeptieren können, anstatt das Zertifikat in der TFS-Dienstrolle oder auf den Computern zu installieren, auf denen der Agent gehostet wird.
Benutzername Erforderlich. Der Benutzername zum Herstellen einer Verbindung mit dem Dienst.
Kennwort Erforderlich. Das Kennwort für den angegebenen Benutzernamen.
Verbindungsname Erforderlich. Der Name, den Sie verwenden, um in den Aufgabeneigenschaften auf die Dienstverbindung zu verweisen. Wenn Sie YAML verwenden, verwenden Sie denselben Namen wie in azureSubscription oder den entsprechenden Abonnementnamen im Skript.
Beschreibung Optional. Die Beschreibung der Dienstverbindung.
Sicherheit Optional. Wählen Sie "Zugriffsberechtigung für alle Pipelines erteilen" aus, damit alle Pipelines diese Verbindung verwenden können. Wenn Sie diese Option nicht auswählen, müssen Sie die Dienstverbindung für jede Pipeline, die sie verwendet, explizit autorisieren.

Sie können "Überprüfen" auswählen, um Ihre Anmeldeinformationen zu überprüfen, bevor Sie die restlichen Parameter eingeben.

Weitere Informationen finden Sie unter Azure Pipelines-Integration in Jenkins und Artefaktquellen – Jenkins.

Jira-Dienstverbindung

Verwenden Sie die folgenden Parameter, um eine Verbindung mit dem Jira-Dienst zu definieren.

Parameter Beschreibung
Server-URL Erforderlich. Die URL des Jira-Servers.
Verbindungsname Erforderlich. Der Name, den Sie verwenden, um in den Aufgabeneigenschaften auf die Dienstverbindung zu verweisen. Wenn Sie YAML verwenden, verwenden Sie denselben Namen wie in azureSubscription oder den entsprechenden Abonnementnamen im Skript.
Beschreibung Optional. Die Beschreibung der Dienstverbindung.
Sicherheit Optional. Wählen Sie "Zugriffsberechtigung für alle Pipelines erteilen" aus, damit alle Pipelines diese Verbindung verwenden können. Wenn Sie diese Option nicht auswählen, müssen Sie die Dienstverbindung für jede Pipeline, die sie verwendet, explizit autorisieren.

Kubernetes-Dienstverbindung

Verwenden Sie die folgenden Parameter, wenn Sie eine Verbindung mit einem Kubernetes-Cluster definieren. Wählen Sie die Authentifizierungsmethode aus den folgenden Optionen aus:

  • Kubeconfig
  • Dienstkonto
  • Azure-Abonnement

Kubeconfig-Option

Parameter Beschreibung
Kubeconfig Erforderlich. Inhalt der kubeconfig-Datei.
Clusterkontext Optional. Kontext innerhalb der kubeconfig-Datei, der zum Identifizieren des Clusters verwendet werden soll.
Accept untrusted certificates Legen Sie diese Option fest, damit Clients ein selbstsigniertes Zertifikat akzeptieren können.
Verbindungsname Erforderlich. Der Name, den Sie verwenden, um in den Aufgabeneigenschaften auf die Dienstverbindung zu verweisen. Wenn Sie YAML verwenden, verwenden Sie denselben Namen wie in azureSubscription oder den entsprechenden Abonnementnamen im Skript.
Beschreibung Optional. Die Beschreibung der Dienstverbindung.
Sicherheit Optional. Wählen Sie "Zugriffsberechtigung für alle Pipelines erteilen" aus, damit alle Pipelines diese Verbindung verwenden können. Wenn Sie diese Option nicht auswählen, müssen Sie die Dienstverbindung für jede Pipeline, die sie verwendet, explizit autorisieren.

Dienstkontooption

Parameter Beschreibung
Server-URL Erforderlich. API-Server-URL des Clusters.
`Secret` Der geheime Schlüssel, der dem Dienstkonto zugeordnet ist, das für die Bereitstellung verwendet werden soll.
Verbindungsname Erforderlich. Der Name, den Sie verwenden, um in den Aufgabeneigenschaften auf die Dienstverbindung zu verweisen. Wenn Sie YAML verwenden, verwenden Sie denselben Namen wie in azureSubscription oder den entsprechenden Abonnementnamen im Skript.
Beschreibung Optional. Die Beschreibung der Dienstverbindung.
Sicherheit Optional. Wählen Sie "Zugriffsberechtigung für alle Pipelines erteilen" aus, damit alle Pipelines diese Verbindung verwenden können. Wenn Sie diese Option nicht auswählen, müssen Sie die Dienstverbindung für jede Pipeline, die sie verwendet, explizit autorisieren.

Verwenden Sie den folgenden Befehl, um die Server-URL abzurufen.

kubectl config view --minify -o 'jsonpath={.clusters[0].cluster.server}'

Verwenden Sie die folgende Abfolge von Befehlen, um das geheime Objekt abzurufen, das zum Herstellen einer Verbindung und Authentifizierung mit dem Cluster erforderlich ist.

kubectl get serviceAccounts <service-account-name> -n <namespace> -o 'jsonpath={.secrets[*].name}'

Ersetzen Sie im folgenden Befehl service-account-secret-name durch die Ausgabe des vorherigen Befehls.

kubectl get secret <service-account-secret-name> -n <namespace> -o json

Kopieren Sie das im YAML-Formular abgerufene Secret-Objekt, und fügen Sie es in das Textfeld „Geheimnis“ ein.

Hinweis

Stellen Sie bei Verwendung der Dienstkontooption sicher, dass eine RoleBinding vorhanden ist, die Berechtigungen für edit ClusterRole das gewünschte Dienstkonto gewährt. Dies ist erforderlich, damit das Dienstkonto von Azure Pipelines zum Erstellen von Objekten im ausgewählten Namespace verwendet werden kann.

Azure-Abonnementoption

Parameter Beschreibung
Azure-Abonnement Erforderlich. Das Azure-Abonnement, das den Cluster enthält, der für die Erstellung einer Dienstverbindung verwendet werden soll.
Cluster Name des Azure Kubernetes Service-Clusters.
Namespace Namespace innerhalb des Clusters.
Verbindungsname Erforderlich. Der Name, den Sie verwenden, um in den Aufgabeneigenschaften auf die Dienstverbindung zu verweisen. Wenn Sie YAML verwenden, verwenden Sie denselben Namen wie in azureSubscription oder den entsprechenden Abonnementnamen im Skript.
Beschreibung Optional. Die Beschreibung der Dienstverbindung.
Sicherheit Optional. Wählen Sie "Zugriffsberechtigung für alle Pipelines erteilen" aus, damit alle Pipelines diese Verbindung verwenden können. Wenn Sie diese Option nicht auswählen, müssen Sie die Dienstverbindung für jede Pipeline, die sie verwendet, explizit autorisieren.

Für einen Cluster mit Azure RBAC-Unterstützung wird im ausgewählten Namespace zusammen mit dem RoleBinding-Objekt ein ServiceAccount erstellt, sodass der erstellte ServiceAccount nur Aktionen für den ausgewählten Namespace ausführen kann.

Für einen Cluster ohne Azure RBAC-Unterstützung wird im ausgewählten Namespace ein ServiceAccount erstellt, aber der erstellte ServiceAccount verfügt über clusterweite (namespaceübergreifende) Berechtigungen.

Hinweis

Mit dieser Option werden alle Abonnements aufgelistet, auf die der Ersteller der Dienstverbindung verschiedene Azure-Mandanten übergreifend Zugriff hat. Wenn keine Abonnements anderer Azure-Mandanten angezeigt werden, überprüfen Sie Ihre Microsoft Entra-Berechtigungen in diesen Mandanten.

Maven-Dienstverbindung

Verwenden Sie die folgenden Parameter, wenn Sie eine Verbindung mit einem Maven-Repository definieren und schützen.

Parameter Beschreibung
Authentifizierungsmethode Erforderlich. Wählen Sie "Benutzername" und "Kennwort" oder "Authentifizierungstoken" aus.
Registrierungs-URL Erforderlich. Die URL des Maven-Repositorys.
Registrierungs-ID Erforderlich. Die ID des Servers, der dem ID-Element des Repositorys/Spiegels entspricht, mit dem Maven versucht, eine Verbindung herzustellen.
Benutzername Erforderlich, wenn der Verbindungstyp Benutzername und Kennwort ist. Der Benutzername für die Authentifizierung.
Kennwort Erforderlich, wenn der Verbindungstyp Benutzername und Kennwort ist. Das Kennwort zu dem Benutzernamen.
Persönliches Zugriffstoken Erforderlich, wenn der Verbindungstyp Authentifizierungstoken ist. Das Token, das für die Authentifizierung beim Dienst verwendet werden soll. Weitere Informationen
Verbindungsname Erforderlich. Der Name, den Sie verwenden, um in den Aufgabeneigenschaften auf die Dienstverbindung zu verweisen. Wenn Sie YAML verwenden, verwenden Sie denselben Namen wie in azureSubscription oder den entsprechenden Abonnementnamen im Skript.
Beschreibung Optional. Die Beschreibung der Dienstverbindung.
Sicherheit Optional. Wählen Sie "Zugriffsberechtigung für alle Pipelines erteilen" aus, damit alle Pipelines diese Verbindung verwenden können. Wenn Sie diese Option nicht auswählen, müssen Sie die Dienstverbindung für jede Pipeline, die sie verwendet, explizit autorisieren.

npm-Dienstverbindung

Verwenden Sie die folgenden Parameter, wenn Sie eine Verbindung mit einem npm-Server definieren und schützen.

Parameter Beschreibung
Authentifizierungsmethode Erforderlich. Wählen Sie "Benutzername" und "Kennwort" oder "Authentifizierungstoken" aus.
Registrierungs-URL Erforderlich. Die URL des Maven-Repositorys.
Benutzername Erforderlich, wenn der Verbindungstyp Benutzername und Kennwort ist. Der Benutzername für die Authentifizierung.
Kennwort Erforderlich, wenn der Verbindungstyp Benutzername und Kennwort ist. Das Kennwort zu dem Benutzernamen.
Persönliches Zugriffstoken Erforderliches Authentifizierungstoken ist ausgewählt. Das persönliche Zugriffstoken (PAT), das mit dem Dienst oder der Registrierung authentifiziert werden soll. PATs gelten für Repositorys, die sie unterstützen, z https://registry.npmjs.org . B. DevOps Services-Organisationen oder Azure DevOps Server. Weitere Informationen finden Sie unter Verwenden von persönlichen Zugriffstoken.
Verbindungsname Erforderlich. Der Name, den Sie verwenden, um in den Aufgabeneigenschaften auf die Dienstverbindung zu verweisen. Wenn Sie YAML verwenden, verwenden Sie denselben Namen wie in azureSubscription oder den entsprechenden Abonnementnamen im Skript.
Beschreibung Optional. Die Beschreibung der Dienstverbindung.
Sicherheit Optional. Wählen Sie "Zugriffsberechtigung für alle Pipelines erteilen" aus, damit alle Pipelines diese Verbindung verwenden können. Wenn Sie diese Option nicht auswählen, müssen Sie die Dienstverbindung für jede Pipeline, die sie verwendet, explizit autorisieren.

NuGet-Dienstverbindung

Verwenden Sie die folgenden Parameter, wenn Sie eine Verbindung mit einem NuGet-Server definieren und schützen.

Parameter Beschreibung
Authentifizierungsmethode Erforderlich. Wählen Sie "ApiKey", "Externe Azure-Pipelines" oder "Standardauthentifizierung" aus.
Feed-URL Erforderlich. Die URL des NuGet-Servers.
ApiKey Erforderlich, wenn der Verbindungstyp ApiKey ist. Der Authentifizierungsschlüssel.
Persönliches Zugriffstoken Erforderlich, wenn der Verbindungstyp Externe Azure Pipelines ist. Das Token, das für die Authentifizierung mit NuGet-Feeds in anderen Azure Services-Organisationen oder Azure DevOps Server verwendet werden soll. Dienst verbinden können. Weitere Informationen finden Sie unter Verwenden von persönlichen Zugriffstoken.
Benutzername Erforderlich, wenn der Verbindungstyp Standardauthentifizierung ist. Der Benutzername für die Authentifizierung.
Kennwort Erforderlich, wenn der Verbindungstyp Standardauthentifizierung ist. Das Kennwort zu dem Benutzernamen.
Verbindungsname Erforderlich. Der Name, den Sie verwenden, um in den Aufgabeneigenschaften auf die Dienstverbindung zu verweisen. Wenn Sie YAML verwenden, verwenden Sie denselben Namen wie in azureSubscription oder den entsprechenden Abonnementnamen im Skript.
Beschreibung Optional. Die Beschreibung der Dienstverbindung.
Sicherheit Optional. Wählen Sie "Zugriffsberechtigung für alle Pipelines erteilen" aus, damit alle Pipelines diese Verbindung verwenden können. Wenn Sie diese Option nicht auswählen, müssen Sie die Dienstverbindung für jede Pipeline, die sie verwendet, explizit autorisieren.

Informationen zum Konfigurieren von NuGet für die Authentifizierung mit Azure Artifacts und anderen NuGet-Repositories finden Sie unter Nuget-Authentifizierung.

Dienstverbindung mit anderem Git-Repository

Verwenden Sie die folgenden Parameter, um eine Verbindung mit einem externen Git-Repositoryserver zu definieren und zu schützen. Es gibt eine bestimmte Dienstverbindung für GitHub und GitHub Enterprise Server.

Parameter Beschreibung
Git-Repository-URL Erforderlich. Die URL des Git-Repositoryservers.
Versuch des Zugriffs auf diesen Git-Server über Azure Pipelines Wenn diese Option aktiviert ist, versucht Azure Pipelines, eine Verbindung mit dem Repository herzustellen, bevor die Ausführung einer Pipeline in die Warteschlange gesetzt wird. Sie können diese Einstellung deaktivieren, um die Leistung zu verbessern, wenn Sie mit Repositorys arbeiten, die nicht öffentlich zugänglich sind. CI-Trigger funktionieren nicht, wenn ein anderes Git-Repository nicht öffentlich zugänglich ist. Sie können nur manuelle oder geplante Pipelineausführungen starten.
Benutzername Optional. Der Benutzername, der für das Herstellen der Verbindung mit dem Git-Repositoryserver verwendet wird.
Kennwort/Token Optional. Das Kennwort oder Zugriffstoken für den angegebenen Benutzernamen.
Verbindungsname Erforderlich. Der Name, den Sie verwenden, um in den Aufgabeneigenschaften auf die Dienstverbindung zu verweisen. Wenn Sie YAML verwenden, verwenden Sie denselben Namen wie in azureSubscription oder den entsprechenden Abonnementnamen im Skript.
Beschreibung Optional. Die Beschreibung der Dienstverbindung.
Sicherheit Optional. Wählen Sie "Zugriffsberechtigung für alle Pipelines erteilen" aus, damit alle Pipelines diese Verbindung verwenden können. Wenn Sie diese Option nicht auswählen, müssen Sie die Dienstverbindung für jede Pipeline, die sie verwendet, explizit autorisieren.

Weitere Informationen finden Sie unter Artefaktquellen.

Python-Paketdownload-Dienstverbindung

Verwenden Sie die folgenden Parameter, wenn Sie eine Verbindung mit einem Python-Repository zum Herunterladen von Python-Paketen definieren und schützen.

Parameter Beschreibung
Authentifizierungsmethode Erforderlich. Wählen Sie "Benutzername" und "Kennwort" oder "Authentifizierungstoken" aus.
Python-Repository-URL für den Download Erforderlich. Die URL des Python-Feeds.
Persönliches Zugriffstoken Erforderlich, wenn der Verbindungstyp Authentifizierungstoken ist. Das persönliche Zugriffstoken (PAT), das zur Authentifizierung mit Python-Feeds verwendet werden soll, die sie unterstützen, und DevOps Services-Organisationen. Weitere Informationen finden Sie unter Verwenden von persönlichen Zugriffstoken.
Benutzername Erforderlich, wenn der Verbindungstyp Benutzername und Kennwort ist. Der Benutzername für die Authentifizierung.
Kennwort Erforderlich, wenn der Verbindungstyp Benutzername und Kennwort ist. Das Kennwort zu dem Benutzernamen.
Verbindungsname Erforderlich. Der Name, den Sie verwenden, um in den Aufgabeneigenschaften auf die Dienstverbindung zu verweisen. Wenn Sie YAML verwenden, verwenden Sie denselben Namen wie in azureSubscription oder den entsprechenden Abonnementnamen im Skript.
Beschreibung Optional. Die Beschreibung der Dienstverbindung.
Sicherheit Optional. Wählen Sie "Zugriffsberechtigung für alle Pipelines erteilen" aus, damit alle Pipelines diese Verbindung verwenden können. Wenn Sie diese Option nicht auswählen, müssen Sie die Dienstverbindung für jede Pipeline, die sie verwendet, explizit autorisieren.

Python-Paketupload-Dienstverbindung

Verwenden Sie die folgenden Parameter, wenn Sie eine Verbindung mit einem Python-Repository zum Hochladen von Python-Paketen definieren und schützen.

Parameter Beschreibung
Authentifizierungsmethode Erforderlich. Wählen Sie "Benutzername" und "Kennwort" oder "Authentifizierungstoken" aus.
Python-Repository-URL für den Upload Erforderlich. Die URL des Python-Feeds.
EndpointName Erforderlich. Das einzigartige Repository, das für den Twine-Upload verwendet wird. Leerzeichen und Sonderzeichen sind nicht zulässig.
Persönliches Zugriffstoken siehe Verwenden von persönlichen Zugriffstoken.
Benutzername Erforderlich, wenn der Verbindungstyp Benutzername und Kennwort ist. Der Benutzername für die Authentifizierung.
Kennwort Erforderlich, wenn der Verbindungstyp Benutzername und Kennwort ist. Das Kennwort zu dem Benutzernamen.
Verbindungsname Erforderlich. Der Name, den Sie verwenden, um in den Aufgabeneigenschaften auf die Dienstverbindung zu verweisen. Wenn Sie YAML verwenden, verwenden Sie denselben Namen wie in azureSubscription oder den entsprechenden Abonnementnamen im Skript.
Beschreibung Optional. Die Beschreibung der Dienstverbindung.
Sicherheit Optional. Wählen Sie "Zugriffsberechtigung für alle Pipelines erteilen" aus, damit alle Pipelines diese Verbindung verwenden können. Wenn Sie diese Option nicht auswählen, müssen Sie die Dienstverbindung für jede Pipeline, die sie verwendet, explizit autorisieren.

Service Fabric-Dienstverbindung

Beim Erstellen einer Dienstverbindung mit einem Service Fabric-Cluster haben Sie drei Optionen für die Authentifizierungsmethode: Zertifikatbasiert, Microsoft Entra-Anmeldeinformationen oder Windows-Sicherheit mit gMSA.

Zertifikatbasierte Authentifizierungsoption

Parameter Beschreibung
Clusterendpunkt Erforderlich. Der Clientverbindungsendpunkt für den Cluster. Präfix des Werts mit tcp://. Dieser Wert setzt das Veröffentlichungsprofil außer Kraft.
Serverzertifikatsuche Wählen Sie "Fingerabdruck" oder "Allgemeiner Name" aus, wenn der Verbindungstyp "Zertifikat" oder "Microsoft Entra-Anmeldeinformationen" ist.
Serverzertifikatfingerabdruck(n) Erforderlich, wenn der Verbindungstyp zertifikatbasiert ist oder Microsoft Entra-Anmeldeinformationen und Serverzertifizierungssuche fingerabdruck ist. Die Fingerabdrucke der Zertifikate des Clusters, die verwendet werden, um die Identität des Clusters zu überprüfen. Dieser Wert setzt das Veröffentlichungsprofil außer Kraft. Trennen sie mehrere Fingerabdrucke durch ein Komma (',')
Clientzertifikat Erforderlich, wenn der Verbindungstyp Zertifikatbasiert ist. Base64-Codierung der Clientzertifikatdatei des Clusters. Sie können das Zertifikat mithilfe des folgenden PowerShell-Skripts codieren: [System.Convert]::ToBase64String([System.IO.File]::ReadAllBytes("C:\path\to\certificate.pfx"))
Benutzername Erforderlich, wenn der Verbindungstyp Microsoft Entra-Anmeldeinformationen ist. Der Benutzername für die Authentifizierung.
Kennwort Erforderlich, wenn der Verbindungstyp Microsoft Entra-Anmeldeinformationen ist. Optional, wenn die Authentifizierungsmethode zertifikatbasiert ist. Das Kennwort des Zertifikats.
Ungesichert Optional. Aktivieren Sie diese Option, um die Windows-Sicherheitsauthentifizierung zu überspringen.
Cluster-SPN Optional. Gilt, wenn "Ungesichert" ausgewählt ist.
Verbindungsname Erforderlich. Der Name, den Sie verwenden, um in den Aufgabeneigenschaften auf die Dienstverbindung zu verweisen. Wenn Sie YAML verwenden, verwenden Sie denselben Namen wie in azureSubscription oder den entsprechenden Abonnementnamen im Skript.
Beschreibung Optional. Die Beschreibung der Dienstverbindung.
Sicherheit Optional. Wählen Sie "Zugriffsberechtigung für alle Pipelines erteilen" aus, damit alle Pipelines diese Verbindung verwenden können. Wenn Sie diese Option nicht auswählen, müssen Sie die Dienstverbindung für jede Pipeline, die sie verwendet, explizit autorisieren.

Microsoft Entra-Authentifizierungsoption für Anmeldeinformationen

Parameter Beschreibung
Clusterendpunkt Erforderlich. Der Clientverbindungsendpunkt für den Cluster. Präfix des Werts mit tcp://. Dieser Wert setzt das Veröffentlichungsprofil außer Kraft.
Serverzertifikatsuche Wählen Sie "Fingerabdruck" oder "Allgemeiner Name" aus.
Serverzertifikatfingerabdruck(n) Erforderlich, wenn der Verbindungstyp zertifikatbasiert ist oder Microsoft Entra-Anmeldeinformationen und Serverzertifizierungssuche fingerabdruck ist. Die Fingerabdrucke der Zertifikate des Clusters, die verwendet werden, um die Identität des Clusters zu überprüfen. Dieser Wert setzt das Veröffentlichungsprofil außer Kraft. Trennen sie mehrere Fingerabdrucke durch ein Komma (',')
Allgemeiner Serverzertifikatname(n) Erforderlich, wenn der Serverzertifikatsuchname allgemein ist. Die allgemeinen Namen der Zertifikate des Clusters, die verwendet werden, um die Identität des Clusters zu überprüfen. Dieser Wert setzt das Veröffentlichungsprofil außer Kraft. Trennen Sie mehrere gemeinsame Namen durch ein Komma (',')
Clientzertifikat Erforderlich, wenn der Verbindungstyp Zertifikatbasiert ist. Base64-Codierung der Clientzertifikatdatei des Clusters. Sie können das Zertifikat mithilfe des folgenden PowerShell-Skripts codieren: [System.Convert]::ToBase64String([System.IO.File]::ReadAllBytes("C:\path\to\certificate.pfx"))
Kennwort Erforderlich, wenn der Verbindungstyp Microsoft Entra-Anmeldeinformationen ist. Optional, wenn die Authentifizierungsmethode zertifikatbasiert ist. Das Kennwort des Zertifikats.
Ungesichert Optional. Aktivieren Sie diese Option, um die Windows-Sicherheitsauthentifizierung zu überspringen.
Cluster-SPN Optional. Gilt, wenn "Ungesichert" ausgewählt ist.
Verbindungsname Erforderlich. Der Name, den Sie verwenden, um in den Aufgabeneigenschaften auf die Dienstverbindung zu verweisen. Wenn Sie YAML verwenden, verwenden Sie denselben Namen wie in azureSubscription oder den entsprechenden Abonnementnamen im Skript.
Beschreibung Optional. Die Beschreibung der Dienstverbindung.
Sicherheit Optional. Wählen Sie "Zugriffsberechtigung für alle Pipelines erteilen" aus, damit alle Pipelines diese Verbindung verwenden können. Wenn Sie diese Option nicht auswählen, müssen Sie die Dienstverbindung für jede Pipeline, die sie verwendet, explizit autorisieren.

Windows-Sicherheit mit GMSA-Authentifizierungsoption

Parameter Beschreibung
Clusterendpunkt Erforderlich. Der Clientverbindungsendpunkt für den Cluster. Präfix des Werts mit tcp://. Dieser Wert setzt das Veröffentlichungsprofil außer Kraft.
Ungesichert Optional. Aktivieren Sie diese Option, um die Windows-Sicherheitsauthentifizierung zu überspringen.
Cluster-SPN Optional. Vollqualifizierte Domänen-SPN für gMSA-Konto. Dieser Parameter gilt nur, wenn die Option "Ungesichert " deaktiviert ist. Weitere Informationen zur Verwendung von gMSA mit einem Cluster finden Sie unter Konfigurieren der Windows-Sicherheit mithilfe von gMSA
Verbindungsname Erforderlich. Der Name, den Sie verwenden, um in den Aufgabeneigenschaften auf die Dienstverbindung zu verweisen. Wenn Sie YAML verwenden, verwenden Sie denselben Namen wie in azureSubscription oder den entsprechenden Abonnementnamen im Skript.
Beschreibung Optional. Die Beschreibung der Dienstverbindung.
Sicherheit Optional. Wählen Sie "Zugriffsberechtigung für alle Pipelines erteilen" aus, damit alle Pipelines diese Verbindung verwenden können. Wenn Sie diese Option nicht auswählen, müssen Sie die Dienstverbindung für jede Pipeline, die sie verwendet, explizit autorisieren.

SSH-Dienstverbindung

Verwenden Sie die folgenden Parameter, wenn Sie eine Verbindung mit einem Remotehost mithilfe von Secure Shell (SSH) definieren und sichern.

Parameter Beschreibung
Hostname Erforderlich. Der Name des Remotehostcomputers oder die IP-Adresse.
Portnummer Erforderlich. Die Portnummer des Remotehostcomputers. Der Standard ist Port 22.
Privater Schlüssel Der gesamte Inhalt der Datei mit dem privaten Schlüssel, wenn dieser Authentifizierungstyp verwendet wird.
Benutzername Erforderlich. Der Benutzername, der beim Herstellen einer Verbindung mit dem Remotehostcomputer verwendet werden soll.
Kennwort/Passphrase Das Kennwort oder die Passphrase für den angegebenen Benutzernamen, wenn ein Schlüsselpaar als Anmeldeinformationen verwendet wird.
Verbindungsname Erforderlich. Der Name, den Sie verwenden, um in den Aufgabeneigenschaften auf die Dienstverbindung zu verweisen. Wenn Sie YAML verwenden, verwenden Sie denselben Namen wie in azureSubscription oder den entsprechenden Abonnementnamen im Skript.
Beschreibung Optional. Die Beschreibung der Dienstverbindung.
Sicherheit Optional. Wählen Sie "Zugriffsberechtigung für alle Pipelines erteilen" aus, damit alle Pipelines diese Verbindung verwenden können. Wenn Sie diese Option nicht auswählen, müssen Sie die Dienstverbindung für jede Pipeline, die sie verwendet, explizit autorisieren.

Weitere Informationen finden Sie unter SSH-Task und Kopieren von Dateien über SSH.

Subversion-Dienstverbindung

Verwenden Sie die folgenden Parameter, wenn Sie eine Verbindung mit dem Subversion-Repository definieren und schützen.

Parameter Beschreibung
Url des Subversion-Repositorys Erforderlich. Die URL des Subversion-Repositorys.
Nicht vertrauenswürdige TLS/SSL-Zertifikate akzeptieren Aktivieren Sie diese Option, damit der SVN-Client selbstsignierte SSL-Serverzertifikate akzeptiert, ohne sie in der Azure DevOps-Dienstrolle zu installieren und Agent-Computer zu erstellen.
Bereichsname Erforderlich, wenn die Dienstverbindung für externe Subversion-Komponenten hergestellt wird. Wenn Sie mehrere Anmeldeinformationen in einer Build- oder Releasepipeline verwenden, verwenden Sie diesen Parameter, um den Bereich anzugeben, der die für die Dienstverbindung angegebenen Anmeldeinformationen enthält.
Benutzername Erforderlich. Der Benutzername zum Herstellen einer Verbindung mit dem Dienst.
Kennwort Erforderlich. Das Kennwort für den angegebenen Benutzernamen.
Verbindungsname Erforderlich. Der Name, den Sie verwenden, um in den Aufgabeneigenschaften auf die Dienstverbindung zu verweisen. Wenn Sie YAML verwenden, verwenden Sie denselben Namen wie in azureSubscription oder den entsprechenden Abonnementnamen im Skript.
Beschreibung Optional. Die Beschreibung der Dienstverbindung.
Sicherheit Optional. Wählen Sie "Zugriffsberechtigung für alle Pipelines erteilen" aus, damit alle Pipelines diese Verbindung verwenden können. Wenn Sie diese Option nicht auswählen, müssen Sie die Dienstverbindung für jede Pipeline, die sie verwendet, explizit autorisieren.

Sie können den Bereichsnamen auf verschiedene Arten finden:

  • Wenn Sie über HTTP oder HTTPS auf das Repository zugreifen: Öffnen Sie das Repository in einem Webbrowser ohne gespeicherte Anmeldeinformationen. Er verwendet den Bereichsnamen im Authentifizierungsdialogfeld.

  • Verwenden Sie die Svn-Befehlszeile. Wenn Sie die Anmeldeinformationen gespeichert haben, führen Sie z. B. aus. svn info https://svnserver/repo Der Bereichsname wird angezeigt, wenn Sie aufgefordert werden, ein Kennwort einzugeben.

  • Wenn Sie die Anmeldeinformationen für den Zugriff auf das Repository gespeichert haben, suchen Sie in einem der Dateien im Abschnitt "Subversion-Authentifizierungscache" Ihres Benutzerprofils nach dem Bereichsnamen. Beispiel: ~/.subversion/auth/svn/simple oder C:\Users\yourname\Application Data\Subversion\auth\svn.simple.

Visual Studio App Center-Dienstverbindung

Verwenden Sie die folgenden Parameter, wenn Sie eine Verbindung mit dem Visual Studio App Center definieren und schützen.

Parameter Beschreibung
Server-URL Erforderlich. Die URL des App Center-Diensts.
API-Token Erforderlich. Das Token, das für die Authentifizierung beim Dienst verwendet werden soll. Weitere Informationen finden Sie in der API-Dokumentation.
Verbindungsname Erforderlich. Der Name, den Sie verwenden, um in den Aufgabeneigenschaften auf die Dienstverbindung zu verweisen. Wenn Sie YAML verwenden, verwenden Sie denselben Namen wie in azureSubscription oder den entsprechenden Abonnementnamen im Skript.
Beschreibung Optional. Die Beschreibung der Dienstverbindung.
Sicherheit Optional. Wählen Sie "Zugriffsberechtigung für alle Pipelines erteilen" aus, damit alle Pipelines diese Verbindung verwenden können. Wenn Sie diese Option nicht auswählen, müssen Sie die Dienstverbindung für jede Pipeline, die sie verwendet, explizit autorisieren.

Erweiterungen für andere Dienstverbindungen

Andere Dienstverbindungstypen und -aufgaben können als Erweiterungen installiert werden. Sehen Sie sich die folgenden Beispiele für Dienstverbindungen an, die über Erweiterungen verfügbar sind:

  • TFS-Artefakte für Azure Pipelines. Auch wenn der TFS-Computer von Azure-Pipelines nicht erreichbar ist, können Sie lokale TFS-Builds mit Azure-Pipelines über eine TFS-Dienstverbindung und das Team Build -Artefakt (extern) bereitstellen. Weitere Informationen finden Sie unter Externes TFS und in diesem Blogbeitrag.

  • TeamCity-Artefakte für Azure Pipelines. Diese Erweiterung ermöglicht die Integration in TeamCity über eine TeamCity-Dienstverbindung, sodass in TeamCity erstellte Artefakte mithilfe von Azure Pipelines bereitgestellt werden können. Weitere Informationen finden Sie unter TeamCity.

  • SCVMM-Integration (System Center Virtual Machine Manager). Stellen Sie eine Verbindung mit einem SCVMM-Server her, um virtuelle Computer bereitzustellen und Aktionen auszuführen, z. B.:

    • Verwalten von Prüfpunkten
    • Starten und Beenden virtueller Computer (VMs)
    • Ausführen von PowerShell-Skripts

  • VMware-Ressourcenbereitstellung. Stellen Sie eine Verbindung mit einem VMware vCenter Server von Visual Studio Team Services oder TFS her, um virtuelle VMware-Computer bereitzustellen, zu starten, zu beenden oder zu snapshotn.

  • Power Platform Build Tools. Verwenden Sie Microsoft Power Platform Build Tools, um allgemeine Build- und Bereitstellungsaufgaben im Zusammenhang mit Apps zu automatisieren, die auf Microsoft Power Platform basieren. Nach der Installation der Erweiterung verfügt der Verbindungstyp des Power Platform-Diensts über die folgenden Eigenschaften.

Parameter BESCHREIBUNG
Verbindungsname Erforderlich. Der Name, den Sie verwenden, um auf diese Dienstverbindung in Aufgabeneigenschaften zu verweisen.
Server-URL Erforderlich. Die URL der Power Platform-Instanz. Beispiel: https://contoso.crm4.dynamics.com
Mandanten-ID Erforderlich. Mandanten-ID (im Azure-Portal auch als Verzeichnis-ID bezeichnet), bei der die Authentifizierung erfolgt. Unter https://aka.ms/buildtools-spn finden Sie ein Skript, das die Mandanten-ID anzeigt und die Anwendungs-ID und den zugehörigen geheimen Clientschlüssel konfiguriert. Der Anwendungsbenutzer muss auch in CDS erstellt werden.
Anwendungs-ID Erforderlich. Azure-Anwendungs-ID für die Authentifizierung.
Geheimer Clientschlüssel der Anwendungs-ID Erforderlich. Geheimer Clientschlüssel des Dienstprinzipals, der der obigen Anwendungs-ID zugeordnet ist, um die Identität nachzuweisen.

Sie können außerdem eigene benutzerdefinierte Dienstverbindungen erstellen.

Hilfe und Support