你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

快速入门：使用 Azure CLI 生成你的第一个静态站点

项目
04/08/2024

Azure Static Web Apps 通过从代码存储库生成应用来将网站发布到生产环境。

在此快速入门中，你会使用 Azure CLI 将 Web 应用部署到 Azure Static Web Apps。

先决条件

GitHub 帐户。
Azure 帐户。
- 如果没有 Azure 订阅，可以创建免费试用帐户。
已安装 Azure CLI（2.29.0 或更高版本）。
Git 安装程序。

定义环境变量

本快速入门的第一步是定义环境变量。

export RANDOM_ID="$(openssl rand -hex 3)"
export MY_RESOURCE_GROUP_NAME="myStaticWebAppResourceGroup$RANDOM_ID"
export REGION=EastUS2
export MY_STATIC_WEB_APP_NAME="myStaticWebApp$RANDOM_ID"

创建存储库（可选）

（可选）本文使用 GitHub 模板存储库作为另一种方法，使你能够轻松入门。该模板具有一个部署到 Azure Static Web Apps 的入门应用。

导航到以下位置以创建新存储库：https://github.com/staticwebdev/vanilla-basic/generate。
将存储库命名为 my-first-static-web-app。

注意

Azure 静态 Web 应用需要至少一个 HTML 文件来创建 Web 应用。在此步骤中创建的存储库包括单个 index.html 文件。

选择“创建存储库”。

部署静态 Web 应用

从 Azure CLI 将应用部署为静态 Web 应用。

创建资源组。

az group create \
  --name $MY_RESOURCE_GROUP_NAME \
  --location $REGION

结果：

{
  "id": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/my-swa-group",
  "location": "eastus2",
  "managedBy": null,
  "name": "my-swa-group",
  "properties": {
    "provisioningState": "Succeeded"
  },
  "tags": null,
  "type": "Microsoft.Resources/resourceGroups"
}

从存储库部署新的静态 Web 应用。

az staticwebapp create \
    --name $MY_STATIC_WEB_APP_NAME \
    --resource-group $MY_RESOURCE_GROUP_NAME \
    --location $REGION

通过两个方面来部署静态应用。第一个操作创建构成应用的基础 Azure 资源。第二是生成和发布应用程序的工作流。

在转到新静态站点之前，必须先完成部署生成的运行。

返回控制台窗口，并运行以下命令以列出网站 URL。

export MY_STATIC_WEB_APP_URL=$(az staticwebapp show --name  $MY_STATIC_WEB_APP_NAME --resource-group $MY_RESOURCE_GROUP_NAME --query "defaultHostname" -o tsv)

runtime="1 minute";
endtime=$(date -ud "$runtime" +%s);
while [[ $(date -u +%s) -le $endtime ]]; do
    if curl -I -s $MY_STATIC_WEB_APP_URL > /dev/null ; then 
        curl -L -s $MY_STATIC_WEB_APP_URL 2> /dev/null | head -n 9
        break
    else 
        sleep 10
    fi;
done

结果：

<!DOCTYPE html>
<html lang=en>
<head>
<meta charset=utf-8 />
<meta name=viewport content="width=device-width, initial-scale=1.0" />
<meta http-equiv=X-UA-Compatible content="IE=edge" />
<title>Azure Static Web Apps - Welcome</title>
<link rel="shortcut icon" href=https://appservice.azureedge.net/images/static-apps/v3/favicon.svg type=image/x-icon />
<link rel=stylesheet href=https://ajax.aspnetcdn.com/ajax/bootstrap/4.1.1/css/bootstrap.min.css crossorigin=anonymous />

echo "You can now visit your web server at https://$MY_STATIC_WEB_APP_URL"

使用 GitHub 模板

你已使用 Azure CLI 成功将静态 Web 应用部署到 Azure Static Web Apps。了解如何部署静态 Web 应用后，可以探索 Azure Static Web Apps 的更高级的特性和功能。

若要使用 GitHub 模板存储库，请执行以下步骤：

转到 https://github.com/login/device 并输入从 GitHub 获取的代码，以激活和检索 GitHub 个人访问令牌。

转到 https://github.com/login/device 。
输入控制台消息中显示的用户代码。
选择 Continue。
选择 Authorize AzureAppServiceCLI。

通过 Git 查看网站

运行脚本的同时获取存储库 URL 时，请复制存储库 URL，并将其粘贴到浏览器中。
选择“Actions”选项卡。

此时，Azure 正在创建资源以支持你的静态 Web 应用。等待正在运行的工作流旁边的图标变成带有绿色背景的勾选标记。此操作可能需要几分钟才能完成执行。
出现成功图标即表示工作流已完成，你可以返回控制台窗口。
运行以下命令以查询网站的 URL。

   az staticwebapp show \
     --name $MY_STATIC_WEB_APP_NAME \
     --query "defaultHostname"

将该 URL 复制到浏览器中并转到网站。

清理资源（可选）

如果你不打算继续使用此应用程序，请使用 az group delete 命令删除资源组和静态 Web 应用。

后续步骤

添加 API

通过