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

教程:将 VuePress 站点发布到 Azure 静态 Web 应用

本文演示如何创建 VuePress Web 应用程序并将其部署到 Azure Static Web Apps。 最终结果是一个新的 Azure 静态 Web 应用应用程序,其中包含关联的 GitHub Actions,可让你控制应用的生成和发布方式。

本教程中,您将学习如何:

  • 创建 VuePress 应用
  • 设置 Azure 静态 Web 应用
  • 将 VuePress 应用部署到 Azure

先决条件

创建 VuePress 应用

从命令行接口创建 VuePress 应用(CLI):

  1. 为 VuePress 应用创建新文件夹。

    mkdir static-site
    
  2. 添加 文件夹 README.md 文件。

    echo '# Hello From VuePress' > README.md
    
  3. 初始化 package.json 文件。

    npm init -y
    
  4. 将 VuePress 添加为 devDependency.

    npm install --save-dev vuepress
    
  5. 在文本编辑器中打开 package.json 文件,并将生成命令添加到 scripts 该节。

    ...
    "scripts": {
        "build": "vuepress build"
    }
    ...
    
  6. 创建一个 .gitignore 文件以排除 node_modules 文件夹。

    echo 'node_modules' > .gitignore
    
  7. 初始化 Git 存储库。

     git init
     git add -A
     git commit -m "initial commit"
    

将应用程序推送到 GitHub

需要 GitHub 上的存储库才能连接到 Azure 静态 Web 应用。 以下步骤演示如何为站点创建存储库。

  1. https://github.com/new 名为 vuepress-static-app 创建空白 GitHub 存储库(不创建自述文件)。

  2. 将 GitHub 存储库作为远程存储库添加到本地存储库。 请确保在以下命令中添加 GitHub 用户名代替 <YOUR_USER_NAME> 占位符。

    git remote add origin https://github.com/<YOUR_USER_NAME>/vuepress-static-app
    
  3. 将本地存储库推送到 GitHub。

    git push --set-upstream origin main
    

部署 Web 应用

以下步骤演示如何创建新的静态站点应用并将其部署到生产环境。

创建应用程序

  1. 转到 Azure 门户

  2. 选择“ 创建资源”

  3. 搜索 静态 Web 应用

  4. 选择 静态 Web 应用

  5. 选择 创建

  6. 在“ 基本信息 ”选项卡上,输入以下值。

    资产 价值
    Subscription Azure 订阅名称。
    资源组 my-vuepress-group
    名称 vuepress-static-app
    计划类型 免费
    Azure Functions API 和过渡环境的区域 选择离你最近的区域。
    来源 GitHub
  7. 选择 “使用 GitHub 登录 ”并使用 GitHub 进行身份验证。

  8. 输入以下 GitHub 值。

    资产 价值
    组织 选择所需的 GitHub 组织。
    存储 库 选择 vuepress-static-app
    分支 选择 main

    注释

    如果未看到任何存储库,可能需要在 GitHub 上授权 Azure 静态 Web 应用。 浏览到 GitHub 存储库,转到 “设置 > 应用程序 > 授权的 OAuth 应用”,选择 “Azure 静态 Web 应用”,然后选择“ 授予”。 对于组织存储库,你必须是组织的所有者才能授予权限。

  9. 在“生成详细信息”部分,从“生成预设”下拉列表中选择 VuePress,并保留默认值。

查看并创建

  1. 选择 “查看 + 创建 ”以验证详细信息是否正确。

  2. 选择 “创建 ”以开始创建应用服务静态 Web 应用并预配 GitHub Actions 进行部署。

  3. 部署完成后,选择“转到资源”

  4. 在资源屏幕上,选择 URL 链接以打开已部署的应用程序。 可能需要等待一两分钟,GitHub Actions 才能完成。

    已部署的应用程序

清理资源

如果不打算继续使用此应用程序,可以通过以下步骤删除 Azure 静态 Web 应用资源:

  1. 打开 Azure 门户
  2. 在顶部搜索栏中,按前面提供的名称搜索应用程序
  3. 单击应用
  4. 单击“ 删除 ”按钮
  5. 单击“ ”以确认删除作

后续步骤