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.
# Stellen Sie eine Verbindung zu GitLab Self-Managed her
Mit einer selbstverwalteten Installation können Sie Verbindungen für die GitLab Enterprise Edition oder GitLab Community Edition herstellen.
Sie können das AWS-Managementkonsole oder das AWS Command Line Interface (AWS CLI) verwenden, um eine Verbindung und einen Host für die GitLab Selbstverwaltung herzustellen.
**Anmerkung**
Indem Sie diese Verbindungsanwendung im GitLab selbstverwalteten Modus autorisieren, gewähren Sie unserem Service die Erlaubnis, Ihre Daten zu verarbeiten. Sie können diese Berechtigungen jederzeit widerrufen, indem Sie die Anwendung deinstallieren.
Bevor Sie eine Verbindung zu GitLab Self-Managed herstellen, müssen Sie einen Host erstellen, der für die Verbindung verwendet werden soll, wie in diesen Schritten beschrieben. Eine Übersicht über den Workflow zur Host-Erstellung für installierte Anbieter finden Sie unter [Workflow zum Erstellen oder Aktualisieren eines Hosts](welcome-hosts-workflow.md).
Sie können Ihren Host optional mit einer VPC konfigurieren. Weitere Informationen zur Netzwerk- und VPC-Konfiguration für Ihre Host-Ressource finden Sie in den VPC-Voraussetzungen unter [(Optional) Voraussetzungen: Netzwerk- oder Amazon-VPC-Konfiguration für Ihre Verbindung](connections-host-create.md#connections-create-host-prereq) und [Fehlerbehebung bei der VPC-Konfiguration für Ihren Host](troubleshooting-connections.md#troubleshooting-connections-host-vpc).
Bevor Sie beginnen:
+ Sie müssen bereits ein Konto bei einer selbstverwalteten Installation erstellt haben GitLab und über die GitLab Enterprise Edition oder GitLab Community Edition verfügen. Weitere Informationen finden Sie unter [https://docs.gitlab.com/ee/subscriptions/self\$1managed/](https://docs.gitlab.com/ee/subscriptions/self_managed/).
**Anmerkung**
Verbindungen bieten nur Zugriff für das Konto, das zum Erstellen und Autorisieren der Verbindung verwendet wurde.
**Anmerkung**
Sie können Verbindungen zu einem Repository erstellen, in dem Sie die Rolle des **Besitzers** haben GitLab, und dann kann die Verbindung mit Ressourcen wie verwendet werden. CodePipeline Bei Repositorys in Gruppen müssen Sie nicht der Gruppenbesitzer sein.
+ Sie müssen bereits ein GitLab persönliches Zugriffstoken (PAT) mit nur den folgenden eingeschränkten Berechtigungen erstellt haben:,. `api` `admin_mode` [Weitere Informationen finden Sie unter \$1access\$1tokens.html. https://docs.gitlab.com/ee/ user/profile/personal](https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html) Sie müssen Administrator sein, um das PAT erstellen und verwenden zu können.
**Anmerkung**
Ihr PAT wird zur Autorisierung des Hosts verwendet und wird nicht anderweitig gespeichert oder von Verbindungen verwendet. Um einen Host einzurichten, können Sie ein temporäres PAT erstellen. Nachdem Sie den Host eingerichtet haben, können Sie das PAT löschen.
**Anmerkung**
Für Organisationen, die GitHub Enterprise Server nutzen oder GitLab selbst verwaltet werden, geben Sie keinen verfügbaren Host weiter. Sie erstellen für jede Verbindung in Ihrer Organisation einen neuen Host und müssen sicherstellen, dass Sie dieselben Informationen in die Netzwerkfelder (VPC-ID, Subnetz IDs und Sicherheitsgruppe IDs) für den Host eingeben. Weitere Informationen finden Sie unter [Verbindungs- und Host-Setup für installierte Anbieter, die Organisationen unterstützen](troubleshooting-connections.md#troubleshooting-organization-host).
**Topics**
+ [Stellen Sie eine Verbindung zur GitLab Selbstverwaltung (Konsole) her](#connections-create-gitlab-managed-console)
+ [Verbindung zu GitLab Self-Managed (CLI) herstellen](#connections-create-gitlab-managed-cli)
## Stellen Sie eine Verbindung zur GitLab Selbstverwaltung (Konsole) her
Gehen Sie wie folgt vor, um in der Konsole einen Host und eine Verbindung zu GitLab Self-Managed herzustellen. Überlegungen zum Einrichten eines Hosts in einer VPC finden Sie unter [(Optional) Voraussetzungen: Netzwerk- oder Amazon-VPC-Konfiguration für Ihre Verbindung](connections-host-create.md#connections-create-host-prereq).
**Anmerkung**
Ab dem 1. Juli 2024 stellt die Konsole Verbindungen mit `codeconnections` der Ressource ARN her. Ressourcen mit beiden Dienstpräfixen werden weiterhin in der Konsole angezeigt.
**Anmerkung**
Sie erstellen einen Host für eine einzelne GitLab selbstverwaltete Installation und können dann eine oder mehrere GitLab selbstverwaltete Verbindungen zu diesem Host verwalten.
**Schritt 1: Erstellen Ihres Hosts**
1. Melden Sie sich bei der an AWS-Managementkonsole, und öffnen Sie dann die AWS Developer Tools-Konsole unter. [https://console.aws.amazon.com/codesuite/settings/connections](https://console.aws.amazon.com/codesuite/settings/connections)
1. Wählen Sie auf der Registerkarte **Hosts** die Option **Create Host (Host erstellen)** aus.
1. Geben Sie unter **Host name (Host-Name)** den gewünschten Namen für Ihren Host ein.
1. **Wählen Sie unter Anbieter** auswählen die Option **GitLabSelbstverwaltet** aus.
1. Geben Sie unter **URL** den Endpunkt für die Infrastruktur ein, auf der der Anbieter installiert ist.
1. Wenn Ihr Server in einer Amazon VPC konfiguriert ist und Sie eine Verbindung mit Ihrer VPC erstellen möchten, wählen Sie **Use a VPC (VPC verwenden)** aus. Wählen Sie andernfalls **No VPC (Keine VPC)** aus.
1. (Optional) Wenn Sie Ihren Host in einer Amazon VPC gestartet haben und eine Verbindung mit Ihrer VPC herstellen möchten, wählen Sie **VPC verwenden** aus und führen Sie folgende Schritte aus.
**Anmerkung**
Für Organisationen, die GitHub Enterprise Server nutzen oder GitLab selbst verwaltet werden, geben Sie keinen verfügbaren Host weiter. Sie erstellen für jede Verbindung in Ihrer Organisation einen neuen Host und müssen sicherstellen, dass Sie dieselben Informationen in die Netzwerkfelder (VPC-ID, Subnetz IDs und Sicherheitsgruppe IDs) für den Host eingeben. Weitere Informationen finden Sie unter [Verbindungs- und Host-Setup für installierte Anbieter, die Organisationen unterstützen](troubleshooting-connections.md#troubleshooting-organization-host).
1. Wählen Sie unter **VPC ID** Ihre VPC-ID aus. Stellen Sie sicher, dass Sie die VPC für die Infrastruktur wählen, in der Ihr Host installiert ist, oder eine VPC, die über VPN oder Direct Connect Zugriff auf Ihre Instance hat.
1. Wenn Sie eine private VPC konfiguriert haben und Ihren Host so konfiguriert haben, dass eine TLS-Validierung bei einer nicht öffentlichen Zertifizierungsstelle durchgeführt wird, geben Sie unter **TLS-Zertifikat** Ihre Zertifikat-ID ein. Der Wert des TLS-Zertifikats ist der öffentliche Schlüssel des Zertifikats.
1. Wählen Sie **Create hoste (Host erstellen)** aus.
1. Sobald die Seite mit den Host-Details angezeigt wird, ändert sich der Status des erstellten Hosts.
**Anmerkung**
Wenn Ihr Host-Setup eine VPC-Konfiguration enthält, können Sie mehrere Minuten für die Bereitstellung von Hostnetzwerkkomponenten einplanen.
Warten Sie, bis Ihr Host in den Status **Pending (Ausstehend)** wechseln und schließen Sie das Setup ab. Weitere Informationen finden Sie unter [Einrichten eines ausstehenden Hosts](connections-host-setup.md).
![\[Screenshot der Konsole mit Details zum GitLab selbst verwalteten Host, bei dem sich der Host im Status Ausstehend befindet.\]](http://docs.aws.amazon.com/de_de/dtconsole/latest/userguide/images/connections-create-glsm-host.png)
**Schritt 2: Einrichten Ihres ausstehenden Hosts**
1. Wählen Sie **Host einrichten** aus.
1. Eine ***host\$1name*Einrichtungsseite** wird angezeigt. **Geben Sie unter Persönliches Zugriffstoken** bereitstellen Ihrem GitLab PAT nur die folgenden abgegrenzten Berechtigungen: und. `api` `admin_mode`
**Anmerkung**
Nur ein Administrator kann das PAT erstellen und verwenden.
![\[Screenshot der Konsole mit dem GitLab persönlichen Zugriffstoken für den neuen Host\]](http://docs.aws.amazon.com/de_de/dtconsole/latest/userguide/images/connections-create-glsm-pat.png)
1. Nachdem Ihr Host erfolgreich registriert wurde, erscheint die Host-Detailseite und zeit den Hoststatus**Available (Verfügbar)** an.
![\[Konsolen-Screenshot mit dem Status „Verfügbar“ für den neuen Host\]](http://docs.aws.amazon.com/de_de/dtconsole/latest/userguide/images/connections-create-glsm-host-available.png)
**Schritt 3: Erstellen einer Verbindung**
1. Melden Sie sich bei der AWS-Managementkonsole an und öffnen Sie dann die AWS Developer Tools-Konsole unter[https://console.aws.amazon.com/codesuite/settings/connections](https://console.aws.amazon.com/codesuite/settings/connections).
1. Wählen Sie **Einstellungen** und dann die Registerkarte **Verbindungen** aus. Wählen Sie **Create Connection (Verbindung erstellen)** aus.
1. Um eine Verbindung zu einem GitLab Repository herzustellen, **wählen Sie unter Anbieter auswählen** die Option **GitLab Selbstverwaltet** aus. Geben Sie unter **Connection name (Verbindungsname)** den Namen für die Verbindung ein, die Sie erstellen möchten.
![\[Screenshot der Konsole mit der ausgewählten Verbindungsoption für GitLab Selbstverwaltung.\]](http://docs.aws.amazon.com/de_de/dtconsole/latest/userguide/images/connections-create-glsm.png)
1. Geben Sie unter **URL** den Endpunkt für Ihren Server ein.
1. Wenn Sie Ihren Server in einer Amazon VPC gestartet haben und eine Verbindung mit Ihrer VPC erstellen möchten, wählen Sie **Use a VPC (Verwenden einer VPC)** aus und geben Sie Folgendes ein.
1. Wählen Sie unter **VPC ID** Ihre VPC-ID aus. Stellen Sie sicher, dass Sie die VPC für die Infrastruktur wählen, in der Ihr Host installiert ist, oder eine VPC, die über VPN oder Direct Connect Zugriff auf Ihren Host hat.
1. Wählen Sie unter **Subnetz-ID (Subnetz-ID)** die Option **Add (Hinzufügen)** aus. Wählen Sie im Feld die Subnetz-ID aus, die Sie für Ihren Host verwenden möchten. Sie können bis zu 10 Subnetze wählen.
Stellen Sie sicher, dass Sie das Subnetz für die Infrastruktur wählen, in der Ihr Host installiert ist, oder ein Subnetz, das über VPN oder Direct Connect Zugriff auf Ihren installierten Host hat.
1. Wählen Sie unter **Sicherheitsgruppe IDs** die Option **Hinzufügen** aus. Wählen Sie im Feld die Sicherheitsgruppe aus, die Sie für Ihren Host verwenden möchten. Sie können bis zu 10 Sicherheitsgruppen auswählen.
Stellen Sie sicher, dass Sie die Sicherheitsgruppe für die Infrastruktur wählen, in der Ihr Host installiert ist, oder eine Sicherheitsgruppe, die über VPN oder Direct Connect Zugriff auf Ihren installierten Host hat.
1. Wenn Sie eine private VPC konfiguriert haben und Ihren Host so konfiguriert haben, dass eine TLS-Validierung bei einer nicht öffentlichen Zertifizierungsstelle durchgeführt wird, geben Sie unter **TLS-Zertifikat** Ihre Zertifikat-ID ein. Der TLS-Zertifikatwert sollte der öffentliche Schlüssel des Zertifikats sein.
1. Wählen Sie **Connect to GitLab self-managed** aus. Die erzeugte Verbindung wird mit dem Status **Pending (Ausstehend)** angezeigt. Für die Verbindung mit den von Ihnen angegebenen Serverinformationen wird eine Hostressource erstellt. Für den Hostnamen wird die URL verwendet.
1. Wählen Sie **Update pending connection (Ausstehende aktualisieren)** aus.
1. Wenn die Anmeldeseite für GitLab angezeigt wird, melden Sie sich mit Ihren Anmeldeinformationen an und wählen Sie dann **Anmelden** aus.
1. Es wird eine Autorisierungsseite mit einer Meldung angezeigt, in der Sie aufgefordert werden, die Verbindung für den Zugriff auf Ihr GitLab Konto zu autorisieren.
Klicken Sie auf **Authorize**.
1. Der Browser kehrt zur Seite der Verbindungskonsole zurück. Unter ** GitLab Verbindung erstellen** wird die neue Verbindung im Feld **Verbindungsname** angezeigt.
1. Wählen Sie **Connect to GitLab self-managed** aus.
Nachdem die Verbindung erfolgreich hergestellt wurde, wird ein Erfolgsbanner angezeigt. Die Verbindungsdetails werden auf der Seite **Verbindungseinstellungen** angezeigt.
## Verbindung zu GitLab Self-Managed (CLI) herstellen
Sie können das AWS Command Line Interface (AWS CLI) verwenden, um einen Host und eine Verbindung für GitLab Self-Managed zu erstellen.
Verwenden Sie hierfür die Befehle **create-host** und **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`.
**Schritt 1: So erstellen Sie einen Host für GitLab Selbstverwaltung (CLI)**
1. Öffnen Sie die Eingabeaufforderung (Windows) oder das Terminal (Linux, macOS oder Unix). Verwenden Sie den AWS CLI , um den **create-host** Befehl auszuführen, und geben Sie dabei die `--name``--provider-type`, und `--provider-endpoint` für Ihre Verbindung an. In diesem Beispiel lautet der Name des Drittanbieters `GitLabSelfManaged` und der Endpunkt `my-instance.dev`.
```
aws codeconnections create-host --name MyHost --provider-type GitLabSelfManaged --provider-endpoint "https://my-instance.dev"
```
Wenn der Befehl erfolgreich ausgeführt wurde, gibt er die Amazon-Ressourcenname (ARN)-Informationen zum Host ähnlich der folgenden zurück.
```
{
"HostArn": "arn:aws:codeconnections:us-west-2:account_id:host/My-Host-28aef605"
}
```
Nach diesem Schritt befindet sich der Host im Status `PENDING` (Ausstehend).
1. Schließen Sie die Host-Einrichtung über die Konsole ab und versetzen Sie den Host im nächsten Schritt in den Status `Available`.
**Schritt 2: Einrichten eines ausstehenden Hosts in der Konsole**
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die Developer Tools-Konsole unter[https://console.aws.amazon.com/codesuite/settings/connections](https://console.aws.amazon.com/codesuite/settings/connections).
1. Schließen Sie das Host-Setup mit der Konsole ab und ändern Sie den Host-Status zu `Available` (Verfügbar). Siehe [Einrichten eines ausstehenden Hosts](connections-host-setup.md).
**Schritt 3: So erstellen Sie eine Verbindung für GitLab Self-Managed (CLI)**
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 `--host-arn` und `--connection-name` für Ihre Verbindung an.
```
aws codeconnections create-connection --host-arn arn:aws:codeconnections:us-west-2:account_id:host/MyHost-234EXAMPLE --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"
}
```
1. Verwenden Sie die Konsole, um die ausstehende Verbindung im folgenden Schritt einzurichten.
**Schritt 4: So stellen Sie eine Verbindung zur GitLab Selbstverwaltung in der Konsole her**
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die Developer Tools-Konsole unter[https://console.aws.amazon.com/codesuite/settings/connections](https://console.aws.amazon.com/codesuite/settings/connections).
1. Verwenden Sie die Konsole, um die ausstehende Verbindung einzurichten und in den Status `Available` zu versetzen. Weitere Informationen finden Sie unter [Aktualisieren einer ausstehenden Verbindung](connections-update.md).