De API publiceren met GitHub-acties

Voltooid

U hebt uw API aan uw web-app toegevoegd en ze worden beiden lokaal uitgevoerd. Nu is het tijd om uw API en app naar Azure Static Web Apps te publiceren.

Tijdens het maken van de Azure Static Web Apps-instantie voor uw hoofdvertakking, is er een GitHub-actie voor u gegenereerd. De GitHub Action luistert naar de hoofdbranch van uw opslagplaats voor doorvoer- en pull-aanvragen. Wanneer de GitHub-actie deze wijzigingen detecteert, wordt uw app gebouwd en gepubliceerd.

Toen u uw Azure Static Web Apps-resource hebt gemaakt, hebt u de maplocatie voor uw API-project opgegeven door de standaardwaarde van api te accepteren. Azure Static Web Apps heeft de Azure Functions-app in die map gebouwd en geïmplementeerd. De app werkt echter niet omdat de HTTP GET-API nog niet is gemaakt.

De GitHub-actie activeren

De GitHub-actie maakt en publiceert uw web-app en API zodra een wijziging in uw hoofdvertakking wordt gedetecteerd. U kunt wijzigingen rechtstreeks doorvoeren of een pull-aanvraag maken voor de hoofdvertakking. Beide wijzigingen activeren de GitHub-actie. Wanneer wijzigingen worden gedetecteerd in de hoofdbranch , wordt de GitHub-actie geactiveerd om de app op dezelfde URL voor uw livewebsite te publiceren.

Preproductieomgevingen met preview-URL's

Soms wilt u uw wijzigingen in een staging-site zien voordat u deze op de live website publiceert. Met Azure Static Web Apps kunt u uw wijzigingen zien via preproductieomgevingen die elk hun eigen preview-URL hebben. U kunt een preproductieomgeving maken door een pull-aanvraag te maken op basis van de vertakking waarop uw GitHub Action kijkt. Uw livewebsite wordt niet beïnvloed. In plaats daarvan wordt een nieuwe versie van uw app gemaakt in een eigen preproductieomgeving. Als u teruggaat en uw pull-aanvraag controleert op GitHub, ziet u dat er een koppeling naar de preproductieversie wordt geplaatst op het tabblad Gesprek.

In de volgende tabel ziet u hoe Azure Static Web Apps uw app publiceert naar verschillende URL's. Uw app wordt naar één URL gepubliceerd terwijl een pull-aanvraag voor dezelfde vertakking naar een andere URL wordt gepubliceerd. Deze automatisch gegenereerde URL's worden geleverd door Azure Static Web Apps voor de productie-app en pull-aanvragen. U kunt eventueel een aangepast domein toewijzen aan de productie-app.

Source Beschrijving URL
Hoofdvertakking Voorbeeld van een url van een livewebsite https://purple-rain-062d03304.azurestaticapps.net/
Pull-aanvraag #5 Voorbeeld van een voorbeeld-URL https://purple-rain-062d03304-5.<location>.azurestaticapps.net/

U werkt momenteel in de API-vertakking. U maakt een pull-aanvraag van uw API-vertakking naar de hoofdbranch . Wanneer u de pull-aanvraag maakt voor de hoofdvertakking, publiceert de GitHub Action de app naar een preproductieomgeving.

Zodra de werkstroom klaar is met het bouwen en implementeren van uw app, voegt de GitHub-bot een opmerking toe aan uw pull-aanvraag. Deze opmerking bevat een koppeling naar de URL van de preproductieomgeving. U kunt deze koppeling selecteren om uw gefaseerde wijzigingen te bekijken.

Vervolgens maakt u een pull-aanvraag en gaat u naar de gefaseerde versie van uw app.