Testinstanz einrichten

Informationen zu Staginginstanzen

GitHub empfiehlt, dass du eine separate Umgebung zum Testen von Sicherungen, Updates oder Änderungen an der Konfiguration für Ihre GitHub Enterprise Server-Instance einrichtest. 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. Du kannst die Sicherung deiner Produktionsdaten in einer separaten GitHub Enterprise Server-Instanz in einer Stagingumgebung regelmäßig wiederherstellen. In dieser Staginginstanz könntest du auch das Upgrade auf das neueste Featurerelease von GitHub Enterprise Server testen.

Überlegungen zu einer Stagingumgebung

Wenn du GitHub Enterprise Server gründlich testen und eine Umgebung neu erstellen möchtest, die deiner Produktionsumgebung möglichst ähnlich ist, berücksichtige die externen Systeme, die mit deiner 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 in einen CI-Server,
• Externe Skripts oder Software, die 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 GitHub Enterprise Server-Instanz einrichten 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. Konfiguriere GitHub Actions.
4. Konfiguriere GitHub Packages.
5. Stelle deine Produktionssicherung wieder her.
6. Überprüfe die Konfiguration der Instanz.
7. Wende die Konfiguration der Instanz an.

1. Sichern deiner Produktionsinstanz

Wenn du Änderungen an einer Instanz testen möchtest, die dieselbe Daten und Konfiguration wie deine Produktionsinstanz enthält, sichere die Daten und die Konfiguration aus der Produktionsinstanz mithilfe von GitHub Enterprise Server Backup Utilities. Weitere Informationen finden Sie unter Konfigurieren von Sicherungen auf deiner Instanz mithilfe von 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 Bereitstellen und Installieren deiner Testinstanz verwendest, die du für deine Produktionsinstanz verwendest. Weitere Informationen finden Sie unter GitHub Enterprise Server-Instanz einrichten.

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 von GitHub Actions

Wenn du GitHub Actions auf deiner Produktionsinstanz verwendest, konfiguriere optional das Feature auf der Staginginstanz vor dem Wiederherstellen deiner Produktionssicherung. Wenn du GitHub Actions nicht verwendest, fahre mit Konfigurieren von GitHub Packages fort.

Um GitHub Actions auf deiner Staginginstanz zu konfigurieren, verwende die Verwaltungskonsole.

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

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

2. Öffne auf der Randleiste die Registerkarte Actions.

3. Aktiviere GitHub Actions, in dem du das Kontrollkästchen für Enable GitHub Actions aktivierst.

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.

Nachdem du GitHub Actions konfiguriert und aktiviert hast, fahre mit dem nächsten Schritt fort.

4. Konfigurieren von GitHub Packages

Wenn du GitHub Packages auf deiner Produktionsinstanz verwendest, konfiguriere optional das Feature auf der Staginginstanz vor dem Wiederherstellen deiner Produktionssicherung. Wenn du GitHub Packages nicht verwendest, fahre mit Wiederherstellen deiner Produktionssicherung fort.

So konfigurierst du GitHub Packages für deine Staginginstanz:

1. Greife auf die Verwaltungskonsole zu. Weitere Informationen findest du unter Zugreifen auf die Verwaltungskonsole.
2. Öffne auf der Randleiste die Registerkarte Packages.
3. Aktiviere GitHub Packages, indem du das Kontrollkästchen für Enable GitHub Packages aktivierst.
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 deiner Produktionssicherung

Verwende den Befehl ghe-restore, um die restlichen Daten aus der Sicherung wiederherzustellen. Weitere Informationen finden Sie unter Konfigurieren von Sicherungen auf deiner Instanz mithilfe von 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 zu dieser Option findest du unter Verwenden der Sicherung und Wiederherstellen von Befehlen in der Dokumentation zu GitHub Enterprise Server Backup Utilities.

6. Überprüfen der Konfiguration der Instanz

Um mithilfe desselben Hostnamen auf die Staginginstanz zuzugreifen, aktualisiere deine lokale Hostdatei, um den Hostnamen der Staginginstanz nach IP-Adresse aufzulösen. Bearbeite dazu die Datei /etc/hosts in macOS oder Linux oder die Datei C:\Windows\system32\drivers\etc in Windows.

Überprüfe dann die Konfiguration der Staginginstanz auf der Verwaltungskonsole. Weitere Informationen finden Sie unter Verwalten Ihrer Instanz über die Web-Benutzeroberfläche.

7. Anwenden der Konfiguration der Instanz

Zum Anwenden der Konfiguration aus der Verwaltungskonsole, klicke auf Einstellungen speichern.

Staginginstanz wieder online schalten

Sie können eine Staginginstanz ausschalten, um Kosten zu sparen, und sie bei Bedarf wieder einschalten.

Eine Instanz kann 60 Tage lang offline bleiben.

Wenn du die Instanz innerhalb des zulässigen Offlinezeitraums wieder online schaltest, wird GitHub Enterprise Server erfolgreich instanziiert. Wenn die Instanz länger als der zulässige Zeitraum offline bleibt, wird GitHub Enterprise Server nicht erfolgreich instanziiert, und in den Systemprotokollen wird möglicherweise eine Fehlermeldung mit dem Text server has been offline for more than the configured server_rejoin_age_max aufgeführt. 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 Themen

• Informationen zu Upgrades auf neue Releases