Testinstanz einrichten

Informationen zu Staginginstanzen

GitHub empfiehlt, eine separate Umgebung zum Testen von Sicherungen, Updates oder Änderungen an der Konfiguration für Ihre GitHub Enterprise Server-Instance einzurichten. Diese Umgebung, die du von deinen Produktionssystemen isolieren solltest, wird als „Stagingumgebung“ bezeichnet.

Beispielsweise kannst du zum Schutz vor Datenverlust die Sicherung deiner Produktionsinstanz regelmäßig überprüfen. Sie können das Backup Ihrer Produktionsdaten regelmäßig auf einer separaten GitHub Enterprise Server-Instanz in einer Stagingumgebung wiederherstellen. In dieser Staging-Instanz könnten Sie auch das Upgrade auf das neueste Feature-Release von GitHub Enterprise Server testen.

Überlegungen zu einer Testumgebung

Wenn Sie eine Umgebung, die Ihrer Produktionsumgebung so ähnlich wie möglich ist, gründlich testen GitHub Enterprise Server und neu erstellen möchten, sollten Sie die externen Systeme berücksichtigen, die mit Ihrer Instanz interagieren. Du kannst beispielsweise in deiner Stagingumgebung Folgendes testen.

• Authentifizierung – insbesondere, wenn du einen externen Authentifizierungsanbieter wie SAML verwendest
• Integration in ein externes Ticketsystem,
• Integration mit einem Continuous Integration-Server
• Externe Skripts oder Software, die GitHub Enterprise Server APIs verwenden
• externer SMTP-Server für E-Mail-Benachrichtigungen.

Testinstanz einrichten

Du kannst eine Staginginstanz neu einrichten und so konfigurieren, wie du möchtest. Weitere Informationen findest du unter Einrichten einer GitHub Enterprise Server-Instanz und Konfigurieren von GitHub Enterprise.

Alternativ kannst du eine Staginginstanz erstellen, die deine Produktionskonfiguration widerspiegelt, indem du eine Sicherung deiner Produktionsinstanz in die Staginginstanz wiederherstellst.

1. Sichere deine Produktionsinstanz.
2. Richte eine Staginginstanz ein.
3. Konfigurieren GitHub Actions.
4. Konfigurieren GitHub Packages.
5. Stelle dein Produktions-Backup wieder her.
6. Überprüfe die Konfiguration der Instanz.
7. Wende die Konfiguration der Instanz an.

1. Sichern Sie Ihre Produktionsinstanz

Wenn Sie Änderungen an einer Instanz testen möchten, die dieselben Daten und dieselbe Konfiguration wie Ihre Produktionsinstanz enthält, sichern Sie die Daten und die Konfiguration von Ihrer Produktionsinstanz mithilfe von GitHub Enterprise Server Backup Utilities. Weitere Informationen finden Sie unter Konfigurieren von Sicherungen auf Ihrer Instanz mit Sicherungshilfsprogrammen.

2. Einrichten einer Staginginstanz

Richte eine neue Instanz ein, die als deine Staging-Umgebung fungiert. Stelle beim Ausführen des Setupvorgangs sicher, dass die Option New Installation ausgewählt ist. Dadurch wird sichergestellt, dass deine Stagingumgebung ordnungsgemäß initialisiert ist und bei Bedarf für die Wiederherstellung einer Sicherung bereit ist.

Du kannst dieselben Leitfäden zum Einrichten und Installieren deiner Testinstanz verwenden, die du für deine Produktionsinstanz verwenden. Weitere Informationen finden Sie unter Einrichten einer GitHub Enterprise Server-Instanz.

Wenn du eine Sicherung deiner Produktionsinstanz wiederherstellen möchtest, fahre mit dem nächsten Schritt fort. Alternativ kannst du die Instanz manuell konfigurieren und die folgenden Schritte überspringen.

3. Konfigurieren GitHub Actions

Optional: Wenn Sie GitHub Actions auf Ihrer Produktionsinstanz verwenden, konfigurieren Sie die Funktion auf der Staging-Instanz, bevor Sie Ihr Produktions-Backup wiederherstellen. Wenn Sie GitHub Actions nicht verwenden, fahren Sie mit Konfigurieren GitHub Packages fort.

Um GitHub Actions auf Ihrer Staginginstanz zu konfigurieren, verwenden Sie Verwaltungskonsole.

Dies Verwaltungskonsole stellt eine sichere, browserbasierte Schnittstelle für die Konfiguration Ihrer GitHub Enterprise Server Instanz auf niedriger Ebene bereit, einschließlich GitHub Actions. Alle Konfigurationsänderungen werden überwacht, und der Zugriff wird über dedizierte Anmeldeinformationen und Netzwerksteuerungen geschützt.

1. Greifen Sie auf die Verwaltungskonsole zu. Weitere Informationen findest du unter Zugreifen auf die Verwaltungskonsole.

2. Öffne auf der Randleiste die Registerkarte Actions.

3. Aktivieren Sie GitHub Actions, indem Sie Enable GitHub Actions aktivieren.

4. Wähle deinen externen Speicheranbieter für den Artefakt- und Protokollspeicher aus.

5. Gib die erforderlichen Speicher- und Authentifizierungsdetails für den ausgewählten Anbieter ein.

6. Teste deine Konfiguration, indem du auf Test storage settings und dann auf Save settings klickst.

Sobald Sie GitHub Actions konfiguriert und aktiviert haben, fahren Sie mit dem nächsten Schritt fort.

4. Konfigurieren GitHub Packages

Optional: Wenn Sie GitHub Packages in Ihrer Produktionsinstanz verwenden, konfigurieren Sie die Funktion auf der Staging-Instanz, bevor Sie Ihr Produktions-Backup wiederherstellen. Wenn Sie GitHub Packages nicht verwenden, springen Sie zu Produktions-Backup wiederherstellen.

Um GitHub Packages für Ihre Staging-Instanz zu konfigurieren:

1. Greifen Sie auf die Verwaltungskonsole zu. Weitere Informationen findest du unter Zugreifen auf die Verwaltungskonsole.
2. Öffne auf der Randleiste die Registerkarte Packages.
3. Aktivieren Sie GitHub Pakete, indem Sie das Kontrollkästchen Enable GitHub Pakete aktivieren.
4. Wähle unter Packages Storage Settings deinen externen Speicheranbieter aus.
5. Teste dein Speicherkonfiguration, indem du auf Test storage settings klickst.
6. Klicke auf Save settings, um deine Konfiguration zu speichern.

5. Wiederherstellen Ihrer Produktionsdatensicherung

Verwende den Befehl ghe-restore, um die restlichen Daten aus der Sicherung wiederherzustellen. Weitere Informationen finden Sie unter Konfigurieren von Sicherungen auf Ihrer Instanz mit Sicherungshilfsprogrammen.

Wenn die Staginginstanz bereits konfiguriert ist und du Einstellungs-, Zertifikats- und Lizenzdaten überschreiben möchtest, füge dem Befehl die Option -c hinzu. Weitere Informationen zur Option finden Sie unter Verwenden der Sicherungs- und Wiederherstellungsbefehle in der GitHub Enterprise Server Backup Utilities Dokumentation.

6. Überprüfen der Konfiguration der Instanz

Um auf die Staginginstanz mit demselben Hostnamen zuzugreifen, aktualisieren Sie die Datei ihrer lokalen Hosts, um den Hostnamen der Staginginstanz nach IP-Adresse aufzulösen, indem Sie die Datei /etc/hosts in macOS oder Linux oder die Datei C:\Windows\system32\drivers\etc in Windows bearbeiten.

Überprüfen Sie dann die Konfiguration der Staging-Instanz in der Verwaltungskonsole. Weitere Informationen finden Sie unter Verwalten Ihrer Instanz über die Web-Benutzeroberfläche.

7. Anwenden der Konfiguration der Instanz

Um die Konfiguration von Verwaltungskonsole anzuwenden, klicken Sie auf Einstellungen speichern.

Die Staginginstanz wieder online schalten

Sie möchten möglicherweise eine Staging-Instanz ausschalten, um Kosten zu sparen, und sie bei Bedarf wieder einschalten.

Eine Instanz kann 60 Tage lang offline bleiben.

Wenn Sie die Instanz innerhalb des zulässigen Offlinezeitraums wieder online schalten, GitHub Enterprise Server instanziiert sie erfolgreich. Wenn die Instanz länger als den zulässigen Zeitraum offline bleibt, kann GitHub Enterprise Server nicht erfolgreich instanziiert werden, und in den Systemprotokollen kann eine Fehlermeldung mit dem Text server has been offline for more than the configured server_rejoin_age_max angezeigt werden. Weitere Informationen findest du unter Informationen zu Systemprotokollen.

Wenn die Instanz im Fehlerzustand hängen bleibt, können Sie sie durch Ausführung dieser Befehle wiederherstellen.

sudo mv /data/user/consul/server_metadata.json /data/user/consul/server_metadata.json.bak
ghe-config-apply

Weiterführende Lektüre

• Über Upgrades auf neue Releases