Créer des environnements d’aperçu de branche dans Azure Static Web Apps

  • Article

Vous pouvez configurer votre site pour déployer toutes les modifications apportées aux branches qui ne sont pas une branche de production. Ce déploiement en préversion est publié à une URL stable qui inclut le nom de la branche. Par exemple, si la branche est nommée dev, l’environnement est disponible à un emplacement comme <DEFAULT_HOST_NAME>-dev.<LOCATION>.azurestaticapps.net. Vous pouvez supprimer un environnement de branche dans le portail via l’onglet Environnements de votre application web statique.

Configuration

Pour activer les environnements d’URL stables, apportez les modifications suivantes à votre fichier configuration.yml.

  • Définissez l’entrée production_branch sur votre nom de branche de production sur le travail static-web-apps-deploy dans l’action GitHub ou sur la tâche AzureStaticWebApp. Cette action garantit que les changements apportés à votre branche de production sont déployés dans l’environnement de production, tandis que les changements apportés aux autres branches sont déployés dans un environnement de prévisualisation.
  • Répertoriez les branches que vous souhaitez déployer dans des environnements d’aperçu dans le tableau de déclencheurs dans la configuration de votre flux de travail afin que les modifications apportées à ces branches déclenchent également le déploiement GitHub Actions ou Azure Pipelines.
    • Définissez ce tableau sur ** pour GitHub Actions ou * pour Azure Pipelines si vous souhaitez suivre toutes les branches.

Exemple

L’exemple suivant montre comment activer les environnements d’aperçu de branche.

name: Azure Static Web Apps CI/CD

on:
  push:
    branches:
      - main
      - dev
      - staging
  pull_request:
    types: [opened, synchronize, reopened, closed]
    branches:
      - main

jobs:
  build_and_deploy_job:
    ...
    name: Build and Deploy Job
    steps:
      - uses: actions/checkout@v2
        with:
          submodules: true
      - name: Build And Deploy
        id: builddeploy
        uses: Azure/static-web-apps-deploy@v1
        with:
          ...
          production_branch: "main"

Remarque

Le ... indique le code ignoré pour plus de clarté.

Dans cet exemple, les environnements d’aperçu sont définis pour les branches dev et staging. Chaque branche est déployée dans un environnement d’aperçu distinct.

Étapes suivantes

Créer des environnements d’aperçu nommés