

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# DevOps Azure-Verbindungen
<a name="connections-azure"></a>

Mithilfe von Verbindungen können Sie Konfigurationen autorisieren und einrichten, die Ihren Drittanbieter mit Ihren AWS Ressourcen verknüpfen. Um Ihr Drittanbieter-Repository als Quelle für Ihre Pipeline zuzuweisen, verwenden Sie eine Verbindung. 

**Anmerkung**  
Anstatt eine bestehende Verbindung in Ihrem Konto zu erstellen oder zu verwenden, können Sie eine gemeinsame Verbindung zwischen anderen verwenden AWS-Konto. Siehe [Verwenden Sie eine Verbindung, die mit einem anderen Konto geteilt wird](connections-shared.md).

**Anmerkung**  
Diese Funktion ist in den Regionen Asien-Pazifik (Hongkong), Asien-Pazifik (Hyderabad), Asien-Pazifik (Jakarta), Asien-Pazifik (Melbourne), Asien-Pazifik (Osaka), Afrika (Kapstadt), Naher Osten (Bahrain), Naher Osten (VAE), Europa (Spanien), Europa (Zürich), Israel (Tel Aviv) oder AWS GovCloud (US-West) nicht verfügbar. Informationen zu anderen verfügbaren Aktionen finden Sie unter. [Produkt- und Serviceintegrationen mit CodePipeline](integrations.md) Überlegungen zu dieser Aktion in der Region Europa (Mailand) finden Sie in der Anmerkung unter[CodeStarSourceConnection für Bitbucket Cloud GitHub, GitHub Enterprise Server, GitLab .com und GitLab selbstverwaltete Aktionen](action-reference-CodestarConnectionSource.md).

Um eine DevOps Azure-Quellaktion hinzuzufügen CodePipeline, können Sie eine der folgenden Optionen wählen: 
+ Verwenden Sie die CodePipeline Konsolenseite „**Pipeline erstellen****“ oder „Aktion bearbeiten**“, um die ** DevOpsAzure-Anbieteroption** auszuwählen. Informationen [Stelle eine Verbindung zu Bitbucket Cloud (Konsole) her](connections-bitbucket.md#connections-bitbucket-console) zum Hinzufügen der Aktion finden Sie unter. Die Konsole hilft Ihnen beim Erstellen einer Verbindungsressource.
+ Verwenden Sie die CLI, um die Aktionskonfiguration für die `CreateSourceConnection` Aktion mit dem `Azure DevOps` Anbieter wie folgt hinzuzufügen:
  + Informationen zum Erstellen Ihrer Verbindungsressourcen finden Sie unter [Verbindung zu Azure DevOps (CLI) herstellen](#connections-azure-cli) So erstellen Sie eine Verbindungsressource mit der CLI.
  + Verwenden Sie die `CreateSourceConnection` Beispiel-Aktionskonfiguration in[CodeStarSourceConnection für Bitbucket Cloud GitHub, GitHub Enterprise Server, GitLab .com und GitLab selbstverwaltete Aktionen](action-reference-CodestarConnectionSource.md), um Ihre Aktion hinzuzufügen, wie unter gezeigt[Erstellen einer Pipeline (CLI)](pipelines-create.md#pipelines-create-cli).

**Anmerkung**  
Sie können auch mithilfe der Developer Tools-Konsole unter **Einstellungen** eine Verbindung herstellen. Weitere Informationen finden [Sie unter Verbindung erstellen](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-create.html).

Bevor Sie beginnen:
+ Sie müssen ein Konto beim Anbieter des Drittanbieter-Repositorys, z. B. Azure, erstellt haben DevOps
+ Sie müssen bereits ein Code-Repository eines Drittanbieters erstellt haben, z. B. ein DevOps Azure-Repository.

**Anmerkung**  
 DevOps Azure-Verbindungen bieten nur Zugriff auf Repositorys, die dem DevOps Azure-Konto gehören, mit dem die Verbindung hergestellt wurde.  
Um die Verbindung zu installieren, benötigen Sie **Administratorberechtigungen für** das Azure-Konto.

**Topics**
+ [Stellen Sie eine Verbindung zu Azure DevOps (Konsole) her](#connections-azure-console)
+ [Verbindung zu Azure DevOps (CLI) herstellen](#connections-azure-cli)

## Stellen Sie eine Verbindung zu Azure DevOps (Konsole) her
<a name="connections-azure-console"></a>

Gehen Sie wie folgt vor, um mithilfe der CodePipeline Konsole eine Verbindungsaktion für Ihr DevOps Azure-Repository hinzuzufügen.

### Schritt 1: Erstellen oder bearbeiten Sie Ihre Pipeline
<a name="connections-azure-console-action"></a>

**Um Ihre Pipeline zu erstellen oder zu bearbeiten**

1. Melden Sie sich bei der CodePipeline Konsole an.

1. Wählen Sie eine der folgenden Optionen aus.
   + Wählen Sie, ob Sie eine Pipeline erstellen möchten. Folgen Sie den Schritten unter *Pipeline erstellen*, um den ersten Bildschirm zu vervollständigen, und wählen Sie **Weiter**. Wählen Sie auf der **Quellseite** unter **Quellanbieter** die Option **Azure** aus DevOps.
   + Wählen Sie, ob Sie eine bestehende Pipeline bearbeiten möchten. Wählen Sie **Bearbeiten** und dann **Phase bearbeiten** aus. Wählen Sie, ob Sie Ihre Quellaktion hinzufügen oder bearbeiten möchten. Geben Sie auf der Seite **Aktion bearbeiten** unter **Aktionsname** den Namen für Ihre Aktion ein. Wählen Sie **unter Aktionsanbieter** die Option **Azure** aus DevOps.

1. Führen Sie eine der folgenden Aktionen aus:
   + Wenn Sie unter **Verbindung** noch keine Verbindung zu Ihrem Anbieter hergestellt haben, wählen Sie **Connect to Azure** aus DevOps. Fahren Sie mit Schritt 2 fort: Verbindung zu Azure herstellen DevOps.
   + Wenn Sie unter **Verbindung** bereits eine Verbindung zu Ihrem Anbieter hergestellt haben, wählen Sie die Verbindung aus. Fahren Sie mit Schritt 3 fort: Speichern Sie die Quellaktion für Ihre Verbindung.

### Schritt 2: Stellen Sie eine Verbindung zu Azure her DevOps
<a name="connections-azure-console-create"></a>

**Um eine Verbindung zu Azure herzustellen DevOps**

1. Um eine Verbindung zu einem DevOps Azure-Repository herzustellen, **wählen Sie unter Anbieter auswählen** die Option **Azure** aus DevOps. Geben Sie unter **Connection name (Verbindungsname)** den Namen für die Verbindung ein, die Sie erstellen möchten. Wählen Sie **Connect to Azure DevOps** und fahren Sie mit Schritt 2 fort.  
![\[Screenshot der Konsole mit der für Azure ausgewählten Verbindungsoption DevOps.\]](http://docs.aws.amazon.com/de_de/codepipeline/latest/userguide/images/create-connection-azure.png)

1. Auf der DevOps Einstellungsseite **Connect to Azure** wird Ihr Verbindungsname angezeigt.

   Wählen Sie unter ** DevOps Azure-Apps** eine App-Installation aus oder wählen **Sie Neue App installieren**, um eine zu erstellen.
**Anmerkung**  
Sie installieren die App nur einmal für jedes DevOps Azure-Konto. Wenn Sie die Connector-App bereits installiert haben, wählen Sie sie aus und fahren Sie mit dem letzten Schritt in diesem Abschnitt fort.

1. Wenn die Anmeldeseite für Microsoft angezeigt wird, melden Sie sich mit Ihren Anmeldeinformationen an und klicken Sie dann auf Fortfahren.

1. Auf der App-Installationsseite wird eine Meldung angezeigt, dass die Connector-App versucht, eine Verbindung zu Ihrem DevOps Azure-Konto herzustellen. 

   Wählen Sie **Grant access (Zugriff gewähren)**.

1. Auf der Verbindungsseite wird die Verbindungs-ID für Ihre neue Installation angezeigt. Wählen Sie **Connect** aus. Die erstellte Verbindung wird in der Verbindungsliste angezeigt.

### Schritt 3: Speichern Sie Ihre DevOps Azure-Quellaktion
<a name="connections-azure-console-save"></a>

Verwenden Sie diese Schritte auf dem Assistenten oder auf der Seite **Aktion bearbeiten**, um Ihre Quellaktion mit Ihren Verbindungsinformationen zu speichern.

**Um Ihre Quellaktion mit Ihrer Verbindung abzuschließen und zu speichern**

1. Wählen Sie unter **Repository name (Repository-Name)** den Namen Ihres Drittanbieter-Repositorys aus.

1. Unter **Pipeline-Trigger** können Sie Auslöser hinzufügen, wenn es sich bei Ihrer Aktion um eine anCodeConnections Aktion handelt. Weitere Informationen zur Konfiguration der Pipeline-Trigger und zum optionalen Filtern mit Triggern finden Sie unter[Trigger mit Code-Push- oder Pull-Request-Ereignistypen hinzufügen](pipelines-filter.md).

1. Im **Output artifact format (Format des Ausgabeartefakts)** müssen Sie das Format für Ihre Artefakte auswählen. 
   + Um Ausgabeartefakte aus der DevOps Azure-Aktion mit der Standardmethode zu speichern, wählen Sie **CodePipeline Standard**. Die Aktion greift auf die Dateien aus dem Repository zu und speichert die Artefakte in einer ZIP-Datei im Pipeline-Artefaktspeicher.
   + Um eine JSON-Datei zu speichern, die einen URL-Verweis auf das Repository enthält, damit Downstream-Aktionen Git-Befehle direkt ausführen können, wählen Sie **Full clone (Vollständiger Klon)**. Diese Option kann nur von CodeBuild nachgelagerten Aktionen verwendet werden.

     Wenn Sie diese Option wählen, müssen Sie die Berechtigungen für Ihre CodeBuild Projektservice-Rolle aktualisieren, wie unter beschrieben[Fügen Sie CodeBuild GitClone Berechtigungen für Verbindungen zu Bitbucket, Enterprise Server oder .com GitHub hinzu GitHub GitLab](troubleshooting.md#codebuild-role-connections).

1. Wählen Sie im Assistenten **Weiter** oder auf der **Aktionsseite Bearbeiten** die Option **Speichern** aus.

## Verbindung zu Azure DevOps (CLI) herstellen
<a name="connections-azure-cli"></a>

Sie können das AWS Command Line Interface (AWS CLI) verwenden, um eine Verbindung herzustellen. 

Verwenden Sie dazu den Befehl **create-connection**. 

**Wichtig**  
Eine Verbindung, die über AWS CLI oder AWS CloudFormation erstellt wurde, hat standardmäßig `PENDING` den Status. Nachdem Sie eine Verbindung mit der CLI hergestellt haben oder verwenden Sie die Konsole CloudFormation, um die Verbindung so zu bearbeiten, dass sie ihren Status festlegt`AVAILABLE`.

**So stellen Sie eine Verbindung her**

1. Öffnen Sie die Eingabeaufforderung (Windows) oder das Terminal (Linux, macOS oder Unix). Verwenden Sie den AWS CLI , um den **create-connection** Befehl auszuführen, und geben Sie dabei das `--provider-type` und `--connection-name` für Ihre Verbindung an. In diesem Beispiel lautet der Name des Drittanbieters `AzureDevOps` und der angegebene Verbindungsname `MyConnection`.

   ```
   aws codeconnections create-connection --provider-type AzureDevOps --connection-name MyConnection
   ```

   Wenn der Befehl erfolgreich ausgeführt wurde, gibt er die ARN-Informationen der Verbindung ähnlich der folgenden zurück.

   ```
   {
       "ConnectionArn": "arn:aws:codeconnections:us-west-2:account_id:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f"
   }
   ```

1. Verwenden Sie die Konsole, um die Verbindung fertigzustellen. Weitere Informationen finden Sie unter [Aktualisieren einer ausstehenden Verbindung](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-update.html).

1. Die Pipeline erkennt standardmäßig Änderungen, wenn der Code an das Quell-Repository der Verbindung weitergeleitet wird. Gehen Sie wie folgt vor, um die Pipeline-Trigger-Konfiguration für die manuelle Veröffentlichung oder für Git-Tags zu konfigurieren:
   + Um die Pipeline-Trigger-Konfiguration so zu konfigurieren, dass sie nur mit einer manuellen Veröffentlichung beginnt, fügen Sie der Konfiguration die folgende Zeile hinzu: 

     ```
     "DetectChanges": "false",
     ```
   + Weitere Informationen zur Konfiguration der Pipeline-Trigger zum Filtern mit Triggern finden Sie unter[Trigger mit Code-Push- oder Pull-Request-Ereignistypen hinzufügen](pipelines-filter.md). Im Folgenden werden beispielsweise Git-Tags zur Pipeline-Ebene der Pipeline-JSON-Definition hinzugefügt. In diesem Beispiel `release-v1` sind `release-v0` und die Git-Tags, die eingeschlossen werden sollen, und `release-v2` ist das Git-Tag, das ausgeschlossen werden soll.

     ```
     "triggers": [
                 {
                     "providerType": "CodeStarSourceConnection",
                     "gitConfiguration": {
                         "sourceActionName": "Source",
                         "push": [
                             {
                                 "tags": {
                                     "includes": [
                                         "release-v0", "release-v1"
                                     ],
                                     "excludes": [
                                         "release-v2"
                                     ]
                                 }
                             }
                         ]
                     }
                 }
             ]
     ```