Azure Static Web Apps でブランチ プレビュー環境を作成する

運用ブランチではないブランチに加えられたすべての変更をデプロイするようにサイトを構成できます。 このプレビューのデプロイは、ブランチ名を含む安定した URL で発行されます。 たとえば、ブランチに dev という名前が付けられている場合、環境は <DEFAULT_HOST_NAME>-dev.<LOCATION>.azurestaticapps.net のような場所で使用できます。 ポータルのブランチ環境は、静的 Web アプリの [環境] タブから削除できます。

構成

安定した URL 環境を有効にするために、次の変更を .yml 構成ファイルに加えます。

  • GitHub アクションの static-web-apps-deploy ジョブで、または AzureStaticWebApp タスクで production_branch の入力を運用ブランチの名前に設定します。 この操作により、運用ブランチに対する変更が運用環境にデプロイされ、他のブランチへの変更がプレビュー環境にデプロイされます。
  • ワークフロー構成内のトリガー配列内のプレビュー環境にデプロイするブランチを一覧表示し、それらのブランチに対する変更によって GitHub Actions または Azure Pipelines デプロイもトリガーされるようにします。
    • すべてのブランチを追跡する場合、この配列を GitHub Actions の場合は ** に、Azure Pipelines の場合は * に設定します。

次の例では、ブランチ プレビュー環境を有効にする方法を示します。

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"

Note

... では、わかりやすくするためにスキップされたコードを示します。

この例では、プレビュー環境は devstaging のブランチに対し定義されています。 各ブランチは、個別のプレビュー環境にデプロイされます。

次のステップ