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.
# Bitbucket Cloud-Verbindungen
Mithilfe von Verbindungen kannst du Konfigurationen autorisieren und einrichten, die deinen Drittanbieter mit deinen AWS Ressourcen verknüpfen. Um Ihr Drittanbieter-Repository als Quelle für Ihre Pipeline zu verknüpfen, verwenden Sie eine Verbindung.
**Anmerkung**
Anstatt eine bestehende Verbindung in deinem Konto herzustellen oder zu verwenden, kannst du 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 im Hinweis unter[CodeStarSourceConnection für Bitbucket Cloud GitHub, GitHub Enterprise Server und GitLab.com GitLab selbstverwaltete Aktionen](action-reference-CodestarConnectionSource.md).
Um eine Bitbucket Cloud-Quellaktion hinzuzufügen CodePipeline, kannst du eine der folgenden Optionen wählen:
+ Verwende den ** Assistenten zum ** Erstellen einer Pipeline in der CodePipeline Konsole oder auf der ** Seite ** „Aktion bearbeiten“, um die ** ** Bitbucket-Provider-Option auszuwählen. Weitere Informationen findest du unter [Erstelle eine Verbindung zu Bitbucket Cloud (Konsole)](#connections-bitbucket-console) So fügst du die Aktion hinzu. Die Konsole hilft Ihnen beim Erstellen einer Verbindungsressource.
**Anmerkung**
Sie können Verbindungen mit einem Bitbucket-Cloud-Repository erstellen. Installierte Bitbucket-Anbietertypen wie Bitbucket Server werden nicht unterstützt.
+ Verwenden Sie die CLI, um die Aktionskonfiguration für die `CreateSourceConnection` Aktion beim `Bitbucket` Anbieter wie folgt hinzuzufügen:
+ Informationen zum Erstellen Ihrer Verbindungsressourcen finden Sie unter [Erstelle eine Verbindung zu Bitbucket Cloud (CLI)](#connections-bitbucket-cli) So erstellen Sie eine Verbindungsressource mit der CLI.
+ Verwenden Sie das `CreateSourceConnection` Beispiel für eine Aktionskonfiguration [CodeStarSourceConnection für Bitbucket Cloud GitHub, GitHub Enterprise Server und GitLab.com GitLab selbstverwaltete Aktionen](action-reference-CodestarConnectionSource.md) unter, um Ihre Aktion hinzuzufügen, wie unter gezeigt[Erstellen einer Pipeline (CLI)](pipelines-create.md#pipelines-create-cli).
**Anmerkung**
Sie können eine Verbindung auch mithilfe der Developer Tools-Konsole unter ** Einstellungen herstellen**. Siehe Verbindung [ erstellen](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-create.html).
Bevor Sie beginnen:
+ Du musst ein Konto beim Anbieter des Drittanbieter-Repositorys wie Bitbucket Cloud erstellt haben.
+ Du musst bereits ein Code-Repository eines Drittanbieters erstellt haben, z. B. ein Bitbucket Cloud-Repository.
**Anmerkung**
Bitbucket Cloud-Verbindungen bieten nur Zugriff auf Repositorys, die dem Bitbucket Cloud-Konto gehören, mit dem die Verbindung hergestellt wurde.
Wenn die Anwendung in einem Bitbucket Cloud-Workspace installiert wird, benötigst ** du die Berechtigungen „Workspace verwalten“. ** Andernfalls wird die Option zum Installieren der App nicht angezeigt.
**Topics**
+ [Erstelle eine Verbindung zu Bitbucket Cloud (Konsole)](#connections-bitbucket-console)
+ [Erstelle eine Verbindung zu Bitbucket Cloud (CLI)](#connections-bitbucket-cli)
## Erstelle eine Verbindung zu Bitbucket Cloud (Konsole)
Gehe wie folgt vor, um mithilfe der CodePipeline Konsole eine Verbindungsaktion für dein Bitbucket-Repository hinzuzufügen.
**Anmerkung**
Sie können Verbindungen mit einem Bitbucket-Cloud-Repository erstellen. Installierte Bitbucket-Anbietertypen wie Bitbucket Server werden nicht unterstützt.
### Schritt 1: Erstelle oder bearbeite deine Pipeline
**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 auszufüllen, und wählen Sie ** Weiter**. Wähle auf der ** ** Quellseite unter ** Source Provider ** die Option ** Bitbucket ** aus.
+ Wähle, ob du eine bestehende Pipeline bearbeiten möchtest. Wählen Sie ** „Bearbeiten“ ** und dann ** „Phase bearbeiten“**. 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ähle unter ** Aktionsanbieter ** die Option ** Bitbucket ** aus.
1. Führen Sie eine der folgenden Aktionen aus:
+ Wähle unter ** Verbindung ** die Option ** Mit ** Bitbucket verbinden aus, falls du noch keine Verbindung zu deinem Anbieter hergestellt hast. Fahre mit Schritt 2: Verbindung zu Bitbucket herstellen fort.
+ Wenn du bereits eine ** Verbindung ** zu deinem Anbieter hergestellt hast, wähle unter Verbindung die Verbindung aus. Fahren Sie mit Schritt 3: Speichern Sie die Quellaktion für Ihre Verbindung fort.
### Schritt 2: Erstelle eine Verbindung zu Bitbucket Cloud
**Um eine Verbindung zu Bitbucket Cloud herzustellen**
1. Gib auf der ** Einstellungsseite „Mit Bitbucket ** verbinden“ deinen Verbindungsnamen ein und wähle ** Mit Bitbucket verbinden. **
Das ** Feld „**Bitbucket-Apps“ wird angezeigt.
1. Wählen Sie unter **Bitbucket apps (Bitbucket-Apps)** eine App-Installation aus oder wählen Sie **Install a new app (Neue App installieren)**, um eine App zu erstellen.
**Anmerkung**
Du installierst die App nur einmal für jeden Bitbucket Cloud-Workspace oder -Account. Wenn du die Bitbucket-App bereits installiert hast, wähle sie aus und fahre mit Schritt 4 fort.
1. Wenn die Anmeldeseite für Bitbucket Cloud angezeigt wird, melde dich mit deinen Zugangsdaten an und entscheide dich dann dafür, fortzufahren.
1. Auf der App-Installationsseite wird in einer Meldung angezeigt, dass die AWS CodeStar App versucht, eine Verbindung zu deinem Bitbucket-Konto herzustellen.
Wenn Sie einen Bitbucket-Workspace verwenden, ändern Sie die Option **Authorize for (Autorisieren für)** auf den Workspace. Es werden nur Workspaces angezeigt, für die Sie über den Administratorzugriff verfügen.
Wählen Sie **Grant access (Zugriff gewähren)**.
1. In der **Bitbucket-App** wird die Verbindungs-ID für die neue Installation angezeigt. Wählen Sie **Connect** aus. Die erstellte Verbindung wird in der Verbindungsliste angezeigt.
### Schritt 3: Speichere deine Bitbucket Cloud-Quellaktion
Verwende diese Schritte im Assistenten oder auf der ** Seite ** „Aktion bearbeiten“, um deine Quellaktion mit deinen 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 CodeConnections Aktion handelt. Weitere Informationen zur Konfiguration der Pipeline-Trigger und zum optionalen Filtern nach 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 Bitbucket Cloud-Aktion mit der Standardmethode zu speichern, wähle „**CodePipeline Standard**“. Die Aktion greift auf die Dateien aus dem Bitbucket Cloud-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 nachgelagerten Aktionen verwendet werden CodeBuild .
Wenn Sie diese Option wählen, müssen Sie die Berechtigungen für Ihre CodeBuild Projektservice-Rolle aktualisieren, wie unter gezeigt[Füge CodeBuild GitClone Berechtigungen für Verbindungen zu Bitbucket, Enterprise Server oder hinzu GitHub GitHub GitLab.com](troubleshooting.md#codebuild-role-connections).
1. Wählen Sie im Assistenten ** Weiter oder ** auf der ** Aktionsseite ** „Bearbeiten“ die Option ** Speichern ** aus.
## Erstelle eine Verbindung zu Bitbucket Cloud (CLI)
Du kannst das AWS Command Line Interface (AWS CLI) verwenden, um eine Verbindung herzustellen.
**Anmerkung**
Sie können Verbindungen mit einem Bitbucket-Cloud-Repository erstellen. Installierte Bitbucket-Anbietertypen wie Bitbucket Server werden nicht unterstützt.
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 oder hergestellt haben CloudFormation, bearbeiten Sie die Verbindung mithilfe der Konsole, um ihren Status zu ermitteln`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 `Bitbucket` und der angegebene Verbindungsname `MyConnection`.
```
aws codestar-connections create-connection --provider-type Bitbucket --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:codestar-connections: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 Code an das Verbindungsquellen-Repository übertragen wird. Gehen Sie wie folgt vor, um die Pipeline-Trigger-Konfiguration für die manuelle Freigabe oder für Git-Tags zu konfigurieren:
+ Um die Pipeline-Trigger-Konfiguration so zu konfigurieren, dass sie nur mit einer manuellen Version beginnt, fügen Sie der Konfiguration die folgende Zeile hinzu:
```
"DetectChanges": "false",
```
+ Weitere Informationen zur Konfiguration der Pipeline-Trigger-Konfiguration zum Filtern nach 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 einzuschließenden Git-Tags und `release-v2` das auszuschließende Git-Tag.
```
"triggers": [
{
"providerType": "CodeStarSourceConnection",
"gitConfiguration": {
"sourceActionName": "Source",
"push": [
{
"tags": {
"includes": [
"release-v0", "release-v1"
],
"excludes": [
"release-v2"
]
}
}
]
}
}
]
```