将静态网站部署到您自己的 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) → 添加 → 添加角色分配。选择贡献者角色，将其分配给用户、组或服务主体，按名称搜索该应用，然后进行检查 + 分配。记下资源组的名称及其所属的订阅 ID（在门户中搜索订阅）。

2. 在此处连接

在您的仪表板中打开集成并选择连接账户。选择静态托管 (Netlify, Vercel) 作为组，选择 Azure Static Web Apps 作为账户，填写客户端 ID、Client secret、租户 ID、订阅 ID 和资源组，然后按连接账户。

在保存任何内容之前，我们会对您粘贴的内容进行测试。无法使用的密钥绝不会被存储，并且响应会指出其出错之处。能够使用的密钥将以加密方式保存在我们的密钥保管库中——绝不保密在我们的数据库中——并且绝不会再次显示，甚至不会向您显示。

接下来会发生什么

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

Azure Static Web Apps 是从代码库构建的——它无法接受上传的构建版本——因此网站的代码必须来自已连接的 GitHub、GitLab 或 Bitbucket 代码库。如果您尚未连接，请先连接一个。

• 我们在您的账户上创建服务，将其指向代码库，附加您的自定义域名并触发部署。该域名的页面会显示 Azure Static Web Apps 所需的任何 DNS 记录。
• 使用情况和账单记在您的账户上，可在您自己的供应商仪表板中查看。
• 顶点域通过 TXT 记录验证，子域通过其 CNAME 验证；该域名的页面会显示您的域名需要哪一种。

如果连接失败

Azure 拒绝了该服务主体。 要么是客户端密码已过期——它们总是会过期，取决于您选择的期限——要么是该应用在资源组上不再具有贡献者权限。这两条消息看起来很相似，因此在创建新密码之前请检查角色分配。

未找到任何内容。 请检查订阅 ID 和资源组是否是您为其分配了角色的项，以及租户 ID 是否是注册了该应用的目录。

显示密钥被拒绝。 几乎总是以下三种情况之一：随同复制的空格或换行符、已过期的密钥、或者在您复制后被撤销或重新生成的密钥。创建一个新的并再次粘贴。

连接成功，但稍后某些操作失败。 密钥通过了身份验证，但缺少操作所需的权限。使用上面列出的权限创建一个新密钥，然后断开旧连接并连接新密钥。

断开连接

打开集成，找到该账户并按断开连接。这会立即删除存储的密钥。任何使用该密钥的内容在其下一次操作时都会停止，依赖于它的屏幕会给出提示，而不是默默失败。

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