将静态站点部署到您自己的 Azure Static Web Apps 帐户

连接它为您带来的作用

连接您自己的 Azure Static Web Apps 账户，即可让您从 Zinn® 控制面板将静态站点发布到您的 Azure Static Web Apps 账户。您拥有该项目和账单；我们负责处理部署、自定义域名和 DNS 记录。

开始之前

一个 Azure 订阅、一个用于站点的资源组，以及一个存放代码且已连接的 GitHub、GitLab 或 Bitbucket 账户 —— Azure Static Web Apps 通过代码仓库进行构建。Azure 的免费计划允许商业用途，且每个应用程序支持两个自定义域名。

1. 在 Azure Static Web Apps 创建密钥

Azure 将此称为服务主体。在 Microsoft Entra 管理中心依次打开 Entra ID → 应用程序注册 → 新注册，为其命名并注册。在应用程序的概览页面上，复制应用程序(客户端) ID 和目录(租户) ID。然后打开证书和密码 → 客户端密码 → 新建客户端密码，选择有效期并添加 —— 请立即复制机密的值，Azure 只会显示一次。

在 Azure 门户中，打开您希望我们使用的资源组，然后依次点击访问控制 (IAM) → 添加 → 添加角色分配。选择 Contributor 角色，将其分配给用户、组或服务主体，按名称搜索该应用程序，然后查看 + 分配。记下该资源组的名称及其所属的订阅 ID（在门户中搜索订阅）。

2. 在此处进行连接

在您的控制面板中打开集成并选择连接账户。选择静态托管 (Netlify, Vercel) 作为分组，选择 Azure Static Web Apps 作为账户，填写客户端 ID、客户端密码、租户 ID、订阅 ID 和资源组，然后点击连接账户。

在保存任何内容之前，我们会测试您粘贴的内容。无法使用的密钥绝不会被存储，并且返回信息会说明问题所在。可以正常使用的密钥会以加密形式保存在我们的机密保管库中 —— 绝不会保存在我们的数据库中 —— 并且永远不会再次显示，即使对您也是如此。

后续操作

• 当您创建或移动静态站点时，该账户将显示为部署目标。

Azure Static Web Apps 通过代码仓库进行构建 —— 它无法接收上传的构建产物 —— 因此站点的代码必须来自已连接的 GitHub、GitLab 或 Bitbucket 代码仓库。如果您尚未连接，请先连接一个。

• 我们会在您的账户上创建该服务，将其指向代码仓库，绑定您的自定义域名并触发部署。域名的页面会显示 Azure Static Web Apps 所需的任何 DNS 记录。
• 用量和计费均在您的账户中，可在您自己的供应商控制面板中查看。
• 根域名通过 TXT 记录进行验证，子域名通过其 CNAME 验证；域名的页面会显示您的域名需要哪一种。

如果无法连接

Azure 拒绝了该服务主体。要么是客户端密码已过期 —— 按照您选择的有效期，它们总是会过期的 —— 要么是该应用程序在资源组上不再拥有 Contributor 权限。这两条提示信息看起来很相似，因此在创建新密码之前请先检查角色分配。

未找到任何内容。请检查订阅 ID 和资源组是否为已分配角色的相应项，并确保租户 ID 为注册该应用程序的目录。

显示密钥被拒绝。绝大多数情况下是以下三种情况之一：复制时附带了空格或换行符、密钥已过期，或者密钥在您复制后已被撤销或重新生成。请创建一个新密钥并重新粘贴。

已连接，但后续出现故障。密钥已通过身份验证，但缺少该操作所需的权限。请按照上述列出的权限创建一个新密钥，然后断开旧连接并连接新密钥。

断开连接

打开集成，找到该账户并点击断开连接。这会立即删除存储的密钥。任何正在使用该密钥的操作都会在其下一步操作时停止，依赖它的界面会明确提示，而不是静默失败。

断开连接不会撤销已经完成的操作 —— 我们在您账户上更改的记录、部署或设置将保持原样。如果您认为密钥本身可能已泄露，还请在供应商处将其撤销；断开连接只会删除我们这里的副本，不会删除他们那里的副本。