Mini-Lektion · Deutsch

So prüfst du Website-Änderungen vor dem Veröffentlichen

Bereite mit einem Assistenten eine kleine Websiteänderung vor, prüfe ihre separate Vorschauadresse und lasse die Produktion bis zur Freigabe unberührt.

Interaktive Lektion startenLektionsnotizen lesen

Für wen ist das gedacht?

Für alle, die aus einem Repository veröffentlichen und Änderungen vor der Freigabe prüfen möchten. Ein Programmierassistent und Repository- beziehungsweise Hostingwerkzeuge können die Branchabläufe übernehmen.

Bevor du beginnst

Dein eigenes separates GitHub-Repository, verbunden mit einem Netlify-Übungsprojekt mit aktivierten Pull-Request-Vorschauen. Cloud-Builds verbrauchen Kontoguthaben. Der Workshop liefert Vorher- und Änderungsdateien; nutze eine entbehrliche Website statt einer echten Produktionsänderung.

Geschätzte Dauer: 20–32 Min.

Schätzungen für die mitgelieferten Startdateien bei bereits eingerichteten Konten und Werkzeugen. Einrichtung, Deployment-Warteschlangen sowie E-Mail- und DNS-Wartezeiten kommen hinzu. Cloud-Build-Wartezeiten und Kontoeinrichtung kommen hinzu. Öffentliche Vorschauen dürfen keine privaten Testdaten oder Produktionsgeheimnisse enthalten.

Was du lernen wirst

  • Erstelle eine separate Prüfversion.
  • Vergleiche Vorschau und aktuelle Website anhand derselben Aufgabe.
  • Beziehe die Freigabe auf die tatsächlich geprüfte Version.

Workshop-Dateien

Schritt 1

Bestimme die beiden Versionen

Eine Prüfung braucht sowohl einen Ausgangspunkt als auch eine vorgeschlagene Änderung.

Veröffentliche mit der mitgelieferten Startseite P1 auf deinem separaten Übungshostingprojekt. Vergleiche sie mit Hilfe des Assistenten mit der Änderungsseite: P1 sagt „Find contact information“, P2 „Contact me“. Beide sollen denselben Contact-Abschnitt erreichen.

Behalte die aktuell veröffentlichte P1-Adresse als Ausgangsstand. Das vorgeschlagene P2 gehört auf einen nicht zusammengeführten Prüfbranch und in dessen separate Vorschau. Halte ihre sichtbaren Versionsmarkierungen fest, um die getestete Seite zu erkennen.

Ein konkretes Beispiel

Das ist eine kleine Textänderung, kein neues Kontaktsystem. Die vorgeschlagene Beschriftung soll klarer werden, während das bestehende Kontaktziel funktioniert.

Nutze die bereitgestellte Übungswebsiteänderung. Hilf mir, einen separaten Prüfbranch und Pull Request mit Netlify-Vorschau zu erstellen und die aktuell veröffentlichte Übungsversion unverändert zu lassen. Zeige beide URLs und benenne die geprüfte Version. Führe ohne meine Freigabe keinen Merge und keine Produktionsveröffentlichung durch. Hilf beim Testen der geänderten Aufgabe und beim Festhalten offener Probleme.

Dateien für diesen Schritt

Start hereWorkshop-Dateien

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Prüfe eine Änderung vor ihrer Veröffentlichung

Gib einer vorgeschlagenen Version eine eigene Prüf-URL, während die Produktion weiter funktioniert.

Eine Vorschau lässt dich das tatsächlich gebaute Branch-Ergebnis prüfen, bevor du es in den Produktionsquellcode übernimmst. Eine gut aussehende lokale Datei kann trotzdem falsche Build-Pfade oder Umgebungseinstellungen haben.

Dieser Workshop nutzt eine bewusst kleine Änderung: P1 sagt „Find contact information“, P2 „Contact me“. Du identifizierst beide Versionen und prüfst vor einer Zusammenführungsentscheidung dieselbe Kontaktaufgabe.

Ausgearbeitetes Beispiel

Solange der Pull Request nicht zusammengeführt ist, sollte die Vorschau P2 und die normale öffentliche Website weiterhin P1 zeigen. Haben sich beide geändert, untersuche, welcher Branch in die Produktion deployt.

Extra implementation exercise

Warum sollte dein Prüfprotokoll Vorschau- und Produktionsversion enthalten?

Ausgearbeitete Lösung anzeigen

Es belegt, dass die Vorschau die vorgeschlagene Änderung enthält, während die öffentliche Website die freigegebene Version behält. Eine funktionierende Vorschau allein beweist diese Trennung nicht.

  • Belegt die geprüfte Version.
  • Bestätigt, dass die Produktion nicht versehentlich geändert wurde.

Schritt 2

Erstelle eine Prüfvorschau

Lass dich vom Assistenten durch die Repositoryschritte führen.

Verwende das separate Übungsrepository und aktiviere dessen Pull-Request-Vorschauen im Hostingkonto. Bitte den Assistenten, einen Prüfbranch mit der mitgelieferten P2-Änderung zu erstellen, diesen zu pushen und einen noch nicht zusammengeführten Pull Request zu öffnen. Diese gehosteten Builds können Kontoguthaben verbrauchen.

Öffne die entstandene Vorschau und lies die sichtbare P2-Markierung. Speichere ihre URL mit dem genauen geprüften Commit aus Repository oder Hoster. Ein späterer Commit auf demselben Branch ist eine neu zu prüfende Version.

Ein konkretes Beispiel

Ein Branch namens improve-contact-label kann über die Zeit verschiedene Commits enthalten. Eine Freigabe seiner ersten Vorschau deckt den nächsten Commit nicht automatisch ab.

Netlify: Deploy Previews

Dateien für diesen Schritt

Start hereWorkshop-Dateien

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Eröffne eine Branch-Prüfung mit reproduzierbarer Änderung

Verbinde einen Pull Request mit einer konkreten Quellrevision.

Folge commands.txt nur in deinem eigenen entbehrlichen Repository. Committe die P2-Änderung auf einem Branch und eröffne einen Pull Request, ohne ihn zusammenzuführen. Netlifys Deploy Preview sollte eine gebaute URL diesem Pull Request und seiner Revision zuordnen.

Lies die Deployment-Details, statt Erfolg aus dem Browser abzuleiten. Protokolliere den Commit und prüfe das Veröffentlichungsverzeichnis. Fehlt eine Vorschau, untersuche Vorschau-Projekteinstellungen und Build-Protokolle; veröffentliche den Branch nicht ersatzweise in die Produktion.

Öffne vor den Branch-Befehlen die bestehende öffentliche P1-URL, klicke ihren Kontaktlink und protokolliere den funktionierenden P1-Commit in review-record.csv. Gibt es kein funktionierendes P1-Deployment, erstelle zuerst diese Ausgangsbasis. Fülle für die Hausaufgabe beide Zeilen aus: Ansicht, URL, Commit, sichtbare Version, Kontaktaufgabenergebnis und unerwartete Nebenwirkungen.

Ändert sich während deiner Arbeit der Produktionsbranch, prüfe vor dem Fortfahren den Aktualisierungs- und Konfliktstatus des Pull Requests. Hole den aktuellen Branchzustand und löse Konflikte bewusst in deinem eigenen Branch; bitte bei Unsicherheit um Hilfe, statt fremde Arbeit zu überschreiben. Prüfe nach der Konfliktlösung die neue Vorschaurevision erneut.

Fehlt die Vorschau-URL, prüfe, ob Deploy Previews für Repository-Pull-Requests aktiv sind, der Branch nicht ausgeschlossen ist, das Build-Protokoll erfolgreich ist und netlify.toml auf das vorgesehene öffentliche Verzeichnis zeigt. Öffne in der Deploys-Historie des Anbieters das aktuelle Produktionsdeployment, um seinen tatsächlichen Quellcommit zu finden.

Ausgearbeitetes Beispiel

Ein grüner Commit-Check und eine lesbare Vorschau sollten dieselbe Revision betreffen. Eine spätere Branch-Bearbeitung erzeugt eine neue Revision mit eigenem Prüfbedarf.

Netlify: Deploy Previews

Extra implementation exercise

Du hast Commit A geprüft und danach Commit B auf denselben Branch gepusht. Deckt die alte Freigabe B ab?

Ausgearbeitete Lösung anzeigen

Nein. Der Branchname blieb gleich, aber der Inhalt änderte sich. Prüfe die aus B gebaute Vorschau und die Unterschiede.

  • Bindet die Prüfung an eine konkrete Revision.
  • Prüft die geänderte Vorschau vor der Übernahme erneut.

Schritt 3

Wiederhole die Besucheraufgabe sicher

Ein anderer Hostname macht echte Dienste nicht harmlos.

Öffne veröffentlichtes P1 und Vorschau-P2 ohne Anmeldung in einer schmalen Ansicht. Aktiviere jeweils die Kontaktaktion und prüfe, dass Contact erreichbar bleibt. Stoppe bei diesem statischen Beispiel am Kontaktziel; sende keine E-Mail an die Platzhalteradresse.

Wendest du diese Technik später auf Formulare, Zahlungen oder gespeicherte Daten an, prüfe zuerst die Diensteinstellungen der Vorschau. Ein neuer Vorschauhostname kann weiterhin einen echten Dienst aufrufen. Verwende dafür separate Testkonten und Testdaten.

Ein konkretes Beispiel

Im mitgelieferten Beispiel erreichen P1 und P2 beide Contact. P2 ändert nur den sichtbaren Linktext und die Versionsmarkierung. Keine Version muss E-Mail senden oder einen Datenbankeintrag schreiben.

Netlify: Umgebungsvariablen und Deployment-Kontexte · Netlify: Umgebungsvariablen für Deployment-Kontexte

Dateien für diesen Schritt

Start hereWorkshop-Dateien

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Trenne Vorschaudaten und Nebenwirkungen

Eine andere URL isoliert das Backend nicht automatisch.

Unser statisches Kontaktlink-Beispiel hat keine Backend-Nebenwirkungen. Prüfe in echten Anwendungen die Vorschau-Kontextvariablen gesondert: Datenbank, E-Mail-Empfänger, Zahlungsmodus und Zugangsdaten können weiter auf Produktion zeigen.

Nutze bei Bedarf entbehrliche Testdaten und Anbieter-Sandboxes. Eine vor beiläufigem Ansehen geschützte Vorschau kann weiterhin eine Serverfunktion mit den konfigurierten Zugangsdaten ausführen.

Liest deine Funktion beispielsweise SUPABASE_URL, behalte denselben Variablennamen, konfiguriere aber seinen Deploy-Preview-Kontextwert auf das entbehrliche Datenbankprojekt. Erfinde keinen neuen Variablennamen, den der Code nie liest. Prüfe in diesem Kontext auch jedes Geheimnis, jeden Empfänger und jeden Zahlungsmodus; das Kopieren des Produktionswerts hebt die Isolation auf.

Öffne im Netlify-Projektdashboard die Umgebungsvariableneinstellungen und bearbeite den Deploy-Preview-Kontextwert unabhängig vom Production-Wert. Speichere für diesen Kontext nur einen Testdienstwert, löse einen neuen Vorschau-Build aus und prüfe seine Revision; eine Dashboard-Änderung beweist nicht, dass eine ältere bereitgestellte Funktion sie übernommen hat. Siehe die offizielle Kontextanleitung unten.

Ausgearbeitetes Beispiel

Ein Vorschau-Kontaktformular mit dem produktiven Mailanbieter könnte echte Nachrichten senden. Das Wort „preview“ in seiner URL verhindert den Aufruf nicht.

Netlify: Umgebungsvariablen und Deployment-Kontexte · Netlify: Umgebungsvariablen für Deployment-Kontexte

Extra implementation exercise

Reicht ein eigener Vorschau-Hostname, um zu garantieren, dass Testkäufe kein echtes Geld abbuchen?

Ausgearbeitete Lösung anzeigen

Nein. Konfiguriere die Vorschau mit Testzugangsdaten und isolierten Diensten und prüfe dann ihr tatsächliches Verhalten. Getrennte Hostnamen allein genügen nicht.

  • Prüft Zahlungszugangsdaten, Modus und Datenziele.
  • Verwechselt getrennte Frontend-URLs nicht mit Backend-Isolation.

Schritt 4

Triff eine versionsbezogene Prüfentscheidung

Die Freigabe folgt dem tatsächlich geprüften Ergebnis.

Fülle review-record.csv mit URLs, geprüfter Version, Beobachtungen und verbleibenden Problemen aus. Bitte um begrenzte Korrekturen und prüfe die resultierende Vorschau erneut.

Lasse die aktuelle Website bis zu einer ausdrücklichen Freigabeentscheidung unverändert. Ändert sich die Version nach der Prüfung, benenne die erneut zu testenden Punkte.

Ein konkretes Beispiel

Eine nützliche Prüfung ist konkret: „P2s geänderter Kontakttext erreicht bei 390px und am Desktop denselben Abschnitt; der veröffentlichte Stand bleibt P1.“ Sie nennt die getestete Revision und führt den Pull Request nicht zusammen.

Dateien für diesen Schritt

Start hereWorkshop-Dateien

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Deine Aufgabe: reiche eine prüfbare Änderung ein

Halte die Änderung klein und unterstütze die Prüfung mit beobachtbaren Ergebnissen.

Ergänze im Branch eine weitere Beschriftungs- oder Layoutverbesserung. Prüfe direktes Öffnen, mobile Breite und die Kontaktaufgabe in seiner Vorschau. Vergleiche sie mit der Produktionsversion.

Liefere eine kurze Änderungsbeschreibung mit Vorschau-URL, Quellrevision und Beobachtungen. Führe erst zusammen, nachdem die vorgesehene prüfende Person die tatsächliche Version freigegeben hat; diese Übung verlangt keine Übernahme in die Produktion.

Nutze für die schmale Prüfung die Browser-Entwicklertools bei 390px Ansichtsfenster und danach bei Desktopbreite. Protokolliere tatsächliche Breite und Kontaktaufgabenergebnis in review-record.csv; diese Aufgabe lässt den Branch unzusammengeführt.

Ausgearbeitetes Beispiel

„Kontaktbeschriftung geändert; Link erreicht #contact weiterhin bei 390px und Desktopbreite“ ist hilfreicher als „sieht besser aus“.

Die vollständige exemplarische Anleitung findest du in reference/assignment-walkthrough.txt. Vergleiche ihre Schritte mit deinem Ergebnis und fülle das Testprotokoll mit Beobachtungen aus deinem eigenen Projekt aus.

Extra implementation exercise

Erstelle eine Branch-Vorschau und ein vollständiges Vergleichsprotokoll ohne Produktionsänderung.

Ausgearbeitete Lösung anzeigen

Bestätige, dass P1 auf der öffentlichen Übungs-URL bereits funktioniert, und protokolliere seinen Commit. Ändere im Prüfbranch die sichtbare Markierung in P2 und die Kontaktbeschriftung in „Contact me“, committe und pushe den Branch in deinem eigenen Konto und eröffne einen nicht zusammengeführten Pull Request.

Protokolliere beide Zeilen in review-record.csv: Produktions-URL/Commit/P1/Kontakt funktioniert; Vorschau-URL/neuer Commit/P2/Kontakt funktioniert. Öffne beide abgemeldet und bei schmaler Breite. Bei Nebenwirkungen müssen die Backend-Einstellungen der Vorschau auf isolierte Testdienste zeigen. Wiederhole diese Ansichtsprüfungen bei 390px und Desktopbreite; nutze getrennte CSV-Zeilen und notiere jede tatsächliche Breite.

Prüfe nach einem weiteren Branch-Commit die neue Vorschaurevision erneut. Die Referenzbeschreibung zeigt die für Prüfer nötigen Informationen; halte den Branch unzusammengeführt und übernimm im Rahmen dieser Aufgabe nichts in die Produktion.

  • Die Produktion bleibt während der Prüfung auf ihrer freigegebenen Revision.
  • Genau die Vorschaurevision besteht die genannte Besucheraufgabe.

War diese Lektion hilfreich?

Hinterlasse ein Like oder teile sie mit jemandem, dem sie helfen könnte.

Weiterlernen

Weitere Lektionen entdecken