Git-Hosting aus der Ferne nutzen
Das Video-Tutorial ansehen
Dieses Szenario kann nützlich sein, wenn du bereits mit einem Remote-Repository in GitHub arbeitest (github.com) oder BitBucket (bitbucket.org). Du schickst die Änderungen an dieses entfernte Repository und Sandbox.page holt sie dann aus dem entfernten Repository und stellt sie auf deiner Website bereit.
Git Repository klonen
Du kannst ein Git-Repository erstellen, das ein Klon eines entfernten Repositorys ist. Gehe zu Websites & Domains und klicken Git. Wenn du bereits Git-Repositories für deine Domäne erstellt hast, klicke auf den Repository hinzufügen Schaltfläche. Du siehst den Bildschirm zum Erstellen eines neuen Repositorys:
Zuerst musst du auswählen, wo dein Code gespeichert wird. In diesem Szenario wählst du Fernes Git-Hosting wie GitHub oder BitBucket.
Remote Git-Repository. Gib den Pfad zu deinem Remote-Repository in BitBucket oder GitHub ein. Du kannst ihn entweder im HTTPS- oder SSH-Format eingeben. HTTP/HTTPS-Authentifizierung wird nicht unterstützt. Du kannst das HTTP/HTTPS-Protokoll also nur verwenden, wenn ein Repository keine Authentifizierung erfordert. Wenn ein privates Git-Repository verwendet wird, musst du dich mit einem von Sanbox.page generierten SSH-Schlüssel authentifizieren (siehe SSH-Verbindung verwenden für Details).
In der Deine Website Abschnitt die folgenden Angaben:
-
Der Einsatzmodus. Standardmäßig wird der Automatischer Einsatz verwendet wird. Das bedeutet, dass alle Änderungen, die in das Git-Repository übertragen werden, automatisch auf der Produktionsseite bereitgestellt werden. Wenn du den Verteilungsmodus ändern möchtest, klicke auf die Schaltfläche automatisch eingesetzt Link und wähle eine andere Option in der geöffneten Bereitstellungsmodus Fenster. Wenn Manuelle Bereitstellung ausgewählt ist, musst du die Dateien manuell aus dem Git-Repository auf deinem Hosting bereitstellen. Wenn Kein Einsatz ausgewählt ist, werden die Dateien nicht an der Produktionsstätte bereitgestellt (dies kann z. B. zum Speichern und Austauschen von Code verwendet werden).
-
Ein Zielverzeichnis für die Veröffentlichung von Git-Dateien auf deiner Website. Standardmäßig wird das /httpdocs Verzeichnis verwendet wird. Du kannst es in ein anderes bestehendes Verzeichnis ändern, indem du auf den Verzeichnisnamen klickst.
Klicke OK. Sandbox.page wird versuchen, sich mit dem entfernten Repository zu verbinden und es zu klonen.
Nachdem der Fortschrittsdialog anzeigt, dass das Klonen erfolgreich abgeschlossen wurde, wird das neue Repository auf der Git Seite.
Das neue Repository wird angezeigt unter Websites & Domains > Git. Der Name des entfernten Repositorys wird als Git-Repository-Name verwendet. Du kannst das Repository später umbenennen (siehe die Ein Repository umbenennen oder entfernen Abschnitt).
Das erstellte Repository ist ein Klon des entfernten Repositorys und wird verwendet, um Änderungen daraus zu ziehen und sie im Zielverzeichnis zu verteilen.
SSH-Verbindung verwenden
Du kannst SSH verwenden, um dich mit dem entfernten Git-Repository zu verbinden. In diesem Fall gibst du beim Hinzufügen eines neuen Repositorys die URL des entfernten Repositorys im SSH-Format an. Die Öffentlicher SSH-Schlüssel Feld erscheint und zeigt den öffentlichen SSH-Schlüssel an, der automatisch von der Sandbox.page generiert wurde.
Bevor Sie auf OK auf diesem Bildschirm, musst du den SSH-Schlüssel zu den Einstellungen des entfernten Git-Repositorys hinzufügen. Weitere Informationen findest du in der Dokumentation zum Hinzufügen eines SSH-Schlüssels für GitHub und BitBucket.
Ziehen und Bereitstellen der Dateien
Nachdem du deine Website-Dateien übertragen und in das Remote-Repository gepusht hast, gehe zu Websites & Domains und klicken Sie auf die Updates ziehen neben dem Namen des Repositorys klicken. Die Änderungen aus dem Remote-Repository werden in das geklonte Git-Repository übernommen.
Du kannst die Informationen zur letzten Übergabe sehen unter Websites & Domains > Git.
Standardmäßig verwendet die Sandbox.page die Automatischer Einsatz Modus. Das bedeutet, dass eine Datei, nachdem sie in das Repository verschoben wurde, sofort im Zielverzeichnis bereitgestellt wird (du kannst diesen Modus bei Bedarf ausschalten, siehe die Bereitstellungsmodus auswählen Abschnitt).
Wenn du zum Beispiel eine index.html Datei mit dem Text "Hallo! Willkommen auf meiner Website", kannst du sofort auf die URL der Website klicken, um die Änderungen zu sehen.
Zweig oder Pfad ändern
Von einem neuen Zweig aus bereitstellen
Es ist gängige Praxis, mit mehreren Zweigen in einem Repository zu arbeiten. Es kann immer nur ein Zweig gleichzeitig aktiv sein. Standardmäßig wird der Meister Zweig wird für die Bereitstellung verwendet.
Um einen neuen Zweig hinzuzufügen, musst du ihn in deinem Remote-Repository erstellen und dann die Änderungen ziehen. Danach kannst du einen von zwei (oder mehr) aktiven Zweigen auf der Sandbox.page auswählen. Gehe zu Websites & Domains > Git, klick Zweig und Pfad ändernund wähle im geöffneten Fenster den Namen des Zweigs im Feld Zweigstelle Menü.
Nachdem du einen neuen Zweig ausgewählt und auf OKwird auf der Sandbox.page der neue aktive Zweig angezeigt.
Ändern Sie den Bereitstellungspfad
Standardmäßig wird die /httpdocs Verzeichnis wird für die Veröffentlichung von Git-Dateien auf deiner Website verwendet. Wenn du den Bereitstellungspfad ändern möchtest, gehst du zu Websites & Domains > Gitklicken Sie auf die Zweig und Pfad ändern Link und wähle im geöffneten Fenster das neue Verzeichnis aus.
Wähle einen Verteilungsmodus
Du kannst einen Bereitstellungsmodus für dein Repository auswählen. Gehe zu Websites & Domains > Git, klick Repository-Einstellungen und wähle eine der Optionen unter Einsatzmodus auswählen:
-
Automatischer Einsatz. Wähle diese Option, wenn du möchtest, dass die Sandbox.page alle Änderungen sofort auf der Produktionsseite bereitstellt.
-
Manuelle Bereitstellung. In diesem Fall musst du die Dateien manuell bereitstellen, indem du auf die Schaltfläche Vom Repository aus bereitstellen Taste bei Websites & Domains > Git. Du kannst Dateien auch manuell verteilen, indem du auf die Schaltfläche Bereitstellen Schaltfläche neben dem Repository-Namen unter Websites & Domains.
-
Keine Bereitstellung (Repository Hosting). In diesem Fall werden die Dateien nicht in der Produktionsumgebung bereitgestellt. Du kannst diese Option zum Beispiel nutzen, wenn du ein Git-Repository nur zum Speichern und Austauschen von Code verwenden willst.
Webhooks für authentischen Pull verwenden
Du kannst Webhooks verwenden, um dein entferntes Repository so zu konfigurieren, dass es Sandbox.page über bestimmte Ereignisse benachrichtigt (z. B. über das Einstellen von Dateien in das Repository). Einzelheiten dazu findest du in der Dokumentation zur Verwaltung von Webhooks in BitBucket oder GitHub.
Für ein Repository wird automatisch eine Webhook-URL erstellt. Um die Webhook-URL anzuzeigen, klicke auf Repository-Einstellungen.
Kopiere die Webhook-URL, füge sie zu deinem Remote-Repository hinzu und konfiguriere sie so, dass sie bei einem Push-Ereignis im Repository ausgelöst wird. Dadurch wird Sandbox.page jedes Mal, wenn eine Datei in das entfernte Repository gepusht wird, über das Push-Ereignis benachrichtigt und zieht die Dateien automatisch ab, sodass du nicht mehr auf die Schaltfläche Updates ziehen Schaltfläche. Wenn für ein Repository eine automatische Bereitstellung konfiguriert ist, werden die gezogenen Dateien sofort auf der Website bereitgestellt.
Hinweis: Wenn Sandbox.page mit einem selbstsignierten Zertifikat gesichert ist, funktioniert der Webhook beim Aufruf über das HTTPS-Protokoll aufgrund von SSL/TLS-Handshake-Problemen möglicherweise nicht. Wenn dies der Fall ist, gib stattdessen das HTTP-Protokoll in der Webhook-URL an.
Zusätzliche Bereitstellungsaktionen aktivieren
In vielen Fällen reicht die Veröffentlichung von Dateien nicht aus, um die Bereitstellung einer Website abzuschließen. Wenn du zum Beispiel ein Framework wie Ruby on Rails verwendest, musst du nach der Bereitstellung eine Datenmigrationsaufgabe mit einem Befehl wie diesem ausführen: bin/rails db:migrate.
Sandbox.page bietet dir die Möglichkeit, einen oder mehrere zusätzliche Befehle zu definieren, die jedes Mal ausgeführt werden, wenn die Dateien auf der Website bereitgestellt werden.
Gehe zu Websites & Domains > Git, klick Repository-Einstellungen, wählen Zusätzliche Bereitstellungsaktionen aktivierenund gib einen oder mehrere Shell-Befehle ein, die jedes Mal ausgeführt werden, wenn der Inhalt des Repositorys bereitgestellt wird. Gib jeden einzelnen Befehl in eine neue Zeile ein.
Hinweis: Wenn unter Linux der SSH-Zugang für den Systembenutzer der Domäne verboten ist, werden alle angegebenen Befehle in einer chroot-Umgebung ausgeführt. Das Heimatverzeichnis des Systembenutzers des Abonnements wird als Stammverzeichnis des Dateisystems für dieses Abonnement behandelt, und es können keine ausführbaren Dateien außerhalb des Chroot-Gefängnisses ausgeführt werden. Wenn der Pfad zu deiner Website zum Beispiel lautet /var/www/vhosts/example.com/httpdocsIn einer chroot-Umgebung lautet der Pfad dann /httpdocsDu kannst also keine Befehle ausführen, die eine Ebene über der /httpdocs Verzeichnis.
Commit-Logs anzeigen
Um die gesamte Commit-Historie für den aktuellen Zweig zu sehen, gehe zu Websites&Domains > Gitund klicken Sie auf die Commit-Logs Link. Für jede Übertragung werden folgende Informationen angezeigt: Zeit, eindeutige Kennung, Benutzername und eine Übertragungsnachricht. Klicke auf Auffrischen um das Commit-Log zu aktualisieren.
Du kannst die Commit-Logs nach jedem Parameter filtern. So kannst du zum Beispiel alle Commits finden, die von einem bestimmten Benutzer ab einem bestimmten Datum durchgeführt wurden. Klicke auf das 
Taste, gib die Suchparameter ein und klicke auf Suche.
Ein Repository umbenennen oder entfernen
Du kannst dein Repository jederzeit umbenennen. Wenn du zum Beispiel die Entwicklung abgeschlossen hast, kannst du den Namen des Repositorys von website-dev zu Website um Verwechslungen zu vermeiden. Gehe zu Websites&Domains > Git, klick Repository-Einstellungenund gib den neuen Namen im Feld Name des Repositorys Feld.
Wenn du das Repository entfernen möchtest, klickst du auf das Repository entfernen Link auf der Git Bildschirm. In diesem Fall entfernt Sandbox.page nur das Repository; das Zielverzeichnis mit den veröffentlichten Daten bleibt unverändert.