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.
Erstellen eines Hosts
Sie können das AWS Management Console oder das AWS Command Line Interface (AWS CLI) verwenden, um eine Verbindung zu einem Code-Repository eines Drittanbieters herzustellen, das auf Ihrer Infrastruktur installiert ist. Beispielsweise könnten Sie GitHub Enterprise Server als virtuelle Maschine auf einer EC2 Amazon-Instance ausführen. Bevor Sie eine Verbindung zu GitHub Enterprise Server herstellen, erstellen Sie einen Host, der für die Verbindung verwendet werden soll.
Eine Übersicht über den Workflow zur Host-Erstellung für installierte Anbieter finden Sie unter Workflow zum Erstellen oder Aktualisieren eines Hosts.
Bevor Sie beginnen:
-
(Optional) Wenn Sie Ihren Host mit einem erstellen möchtenVPC, müssen Sie bereits ein Netzwerk oder eine virtuelle private Cloud (VPC) erstellt haben.
-
Sie müssen Ihre Instanz bereits erstellt haben und, falls Sie eine Verbindung zu Ihrer herstellen möchtenVPC, Ihren Host in Ihrem gestartet habenVPC.
Anmerkung
Jede VPC kann jeweils nur einem Host zugeordnet werden.
Sie können Ihren Host optional mit einem konfigurierenVPC. Weitere Informationen zum Netzwerk und zur VPC Konfiguration Ihrer Hostressource finden Sie in den VPC Voraussetzungen unter (Optional) Voraussetzungen: Netzwerk- oder VPC Amazon-Konfiguration für Ihre Verbindung undFehlerbehebung bei der VPC Konfiguration für Ihren Host.
Informationen zum Erstellen eines Hosts und einer Verbindung zu GitHub Enterprise Server mithilfe der Konsole finden Sie unterErstellen Sie Ihre GitHub Enterprise Server-Verbindung (Konsole). Die Konsole erstellt einen Host für Sie.
Informationen zur Verwendung der Konsole zum Erstellen eines Hosts und einer Verbindung zu GitLab Self-Managed finden Sie unterStellen Sie eine Verbindung zu GitLab Self-Managed her. Die Konsole erstellt einen Host für Sie.
(Optional) Voraussetzungen: Netzwerk- oder VPC Amazon-Konfiguration für Ihre Verbindung
Wenn Ihre Infrastruktur mit einer Netzwerkverbindung konfiguriert ist, können Sie diesen Abschnitt überspringen.
Wenn Ihr Host nur in einem erreichbar istVPC, befolgen Sie diese VPC Anforderungen, bevor Sie fortfahren.
VPCAnforderungen
Sie können optional wählen, ob Sie Ihren Host mit einem erstellen möchtenVPC. Im Folgenden finden Sie allgemeine VPC Anforderungen, je nachdem, VPC was Sie für Ihre Installation eingerichtet haben.
-
Sie können ein öffentliches VPC mit öffentlichen und privaten Subnetzen konfigurieren. Sie können den Standard VPC für Ihre verwenden, AWS-Konto wenn Sie keine bevorzugten CIDR Blöcke oder Subnetze haben.
-
Wenn Sie eine private Instanz VPC konfiguriert haben und Ihre GitHub Enterprise Server-Instanz so konfiguriert haben, dass die TLS Validierung mithilfe einer nicht öffentlichen Zertifizierungsstelle durchgeführt wird, müssen Sie das TLS Zertifikat für Ihre Hostressource bereitstellen.
-
Wenn Connections Ihren Host erstellt, wird der VPC Endpunkt (PrivateLink) für Webhooks für Sie erstellt. Weitere Informationen finden Sie unter AWS CodeConnections und VPC Schnittstellenendpunkte ()AWS PrivateLink.
-
Konfiguration der Sicherheitsgruppen:
-
Die bei der Hosterstellung verwendeten Sicherheitsgruppen benötigen Regeln für eingehenden und ausgehenden Datenverkehr, die es der Netzwerkschnittstelle ermöglichen, eine Verbindung zu Ihrer GitHub Enterprise Server-Instanz herzustellen
-
Die mit Ihrer GitHub Enterprise Server-Instanz verbundenen Sicherheitsgruppen (die nicht Teil des Host-Setups sind) benötigen eingehenden und ausgehenden Zugriff über die Netzwerkschnittstellen, die durch Verbindungen erzeugt werden.
-
-
Ihre VPC Subnetze müssen sich in verschiedenen Availability Zones in Ihrer Region befinden. Availability Zones sind unabhängige Standorte, die von Fehlern in anderen Availability Zones nicht betroffen sind. Jedes Subnetz muss sich vollständig innerhalb einer Availability Zone befinden und darf nicht mehrere Zonen umfassen.
Weitere Informationen zum Arbeiten mit VPCs und Subnetzen finden Sie unter VPCund Subnet Sizing for IPv4 im VPCAmazon-Benutzerhandbuch.
VPCInformationen, die Sie für die Hosteinrichtung angeben
Wenn Sie die Hostressource für Ihre Verbindungen im nächsten Schritt erstellen, müssen Sie Folgendes angeben:
-
VPCID: Die ID des Servers, auf dem Ihre GitHub Enterprise Server-Instanz installiert ist oder VPC der über VPN Direct Connect Zugriff auf Ihre installierte GitHub Enterprise Server-Instanz hat. VPC
-
Subnetz-ID oderIDs: Die ID des Subnetzes für den Server, auf dem Ihre GitHub Enterprise Server-Instanz installiert ist, oder ein Subnetz mit Zugriff auf Ihre installierte GitHub Enterprise Server-Instanz über VPN oder Direct Connect.
-
Sicherheitsgruppe oder Gruppen: Die Sicherheitsgruppe für den Server, auf dem Ihre GitHub Enterprise Server-Instanz installiert ist, oder eine Sicherheitsgruppe mit Zugriff auf Ihre installierte GitHub Enterprise Server-Instanz über VPN oder Direct Connect.
-
Endpoint (Endpunkt): Halten Sie Ihren Server-Endpunkt bereit und fahren Sie mit dem nächsten Schritt fort.
Weitere Informationen, einschließlich zur Fehlerbehebung VPC oder zu Hostverbindungen, finden Sie unterFehlerbehebung bei der VPC Konfiguration für Ihren Host.
Benötigte Berechtigungen
AWS CodeConnections Erstellt im Rahmen der Hosterstellung in Ihrem Namen Netzwerkressourcen, um die VPC Konnektivität zu erleichtern. Dazu gehören eine Netzwerkschnittstelle, AWS CodeConnections um Daten von Ihrem Host abzufragen, und ein VPC Endpunkt, über den der Host Ereignisdaten über Webhooks an Verbindungen sendet. PrivateLink Damit Sie diese Netzwerkressourcen erstellen können, müssen Sie sicherstellen, dass die für die Host-Erstellung verwendete Rolle über die folgenden Berechtigungen verfügt:
ec2:CreateNetworkInterface ec2:CreateTags ec2:DescribeDhcpOptions ec2:DescribeNetworkInterfaces ec2:DescribeSubnets ec2:DeleteNetworkInterface ec2:DescribeVpcs ec2:CreateVpcEndpoint ec2:DeleteVpcEndpoints ec2:DescribeVpcEndpoints
Weitere Informationen zur Fehlerbehebung bei Berechtigungen oder Hostverbindungen in a finden Sie VPC unterFehlerbehebung bei der VPC Konfiguration für Ihren Host.
Weitere Informationen zum VPC Webhook-Endpunkt finden Sie unterAWS CodeConnections und VPC Schnittstellenendpunkte ()AWS PrivateLink.
Themen
Erstellen eines Hosts für eine Verbindung (Konsole)
Bei Verbindungen für Installationen, z. B. mit GitHub Enterprise Server oder mit GitLab Self-Managed, verwenden Sie einen Host, der den Endpunkt für die Infrastruktur darstellt, in der Ihr Drittanbieter installiert ist.
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.
Informationen zu Überlegungen zur Einrichtung eines Hosts in einem finden Sie VPC unterStellen Sie eine Verbindung zu GitLab Self-Managed her.
Informationen zum Erstellen eines Hosts und einer Verbindung zu GitHub Enterprise Server mithilfe der Konsole finden Sie unterErstellen Sie Ihre GitHub Enterprise Server-Verbindung (Konsole). Die Konsole erstellt einen Host für Sie.
Informationen zur Verwendung der Konsole zum Erstellen eines Hosts und einer Verbindung zu GitLab Self-Managed finden Sie unterStellen Sie eine Verbindung zu GitLab Self-Managed her. Die Konsole erstellt einen Host für Sie.
Anmerkung
Sie erstellen einen Host nur einmal pro GitHub Enterprise Server oder GitLab selbstverwaltetem Konto. Alle Ihre Verbindungen zu einem bestimmten GitHub Enterprise Server oder einem GitLab selbstverwalteten Konto verwenden denselben Host.
Erstellen Sie einen Host für eine Verbindung () CLI
Sie können das AWS Command Line Interface (AWS CLI) verwenden, um einen Host für installierte Verbindungen zu erstellen.
Anmerkung
Sie erstellen einen Host nur einmal pro GitHub Enterprise Server-Konto. Alle Ihre Verbindungen zu einem bestimmten GitHub Enterprise Server-Konto verwenden denselben Host.
Sie verwenden Sie einen Host, der den Endpunkt für die Infrastruktur darstellt, in der der Drittanbieter installiert ist. Um einen Host mit dem zu erstellenCLI, verwenden Sie den create-host Befehl. Sobald Sie den Host vollständig erstellt haben, befindet sich der Host im Status Pending (Ausstehend). Danach müssen Sie den Host einrichten (set up), damit er in den Status Available (Verfügbar) kommt. Sobald der Host verfügbar ist, führen Sie die Schritte zum Erstellen einer Verbindung aus.
Wichtig
Ein über den erstellter Host AWS CLI befindet sich standardmäßig im Pending Status. Nachdem Sie einen Host mit dem erstellt habenCLI, verwenden Sie die Konsole, um den Host so einzurichten, dass er seinen Status festlegtAvailable.
Informationen zum Erstellen eines Hosts und einer Verbindung zum GitHub Enterprise Server mithilfe der Konsole finden Sie unterErstellen Sie Ihre GitHub Enterprise Server-Verbindung (Konsole). Die Konsole erstellt einen Host für Sie.
Informationen zur Verwendung der Konsole zum Erstellen eines Hosts und einer Verbindung zu GitLab Self-Managed finden Sie unterStellen Sie eine Verbindung zu GitLab Self-Managed her. Die Konsole erstellt einen Host für Sie.
