为 Azure Stack Hub 上的应用服务配置部署源

Azure Stack Hub 上的应用服务支持从多个源代码管理提供程序执行按需部署。 应用开发人员可以使用此功能直接从其源代码管理存储库部署。 如果用户想要将应用服务配置为连接到其存储库,云操作员必须先在 Azure Stack Hub 上的应用服务与源代码管理提供程序之间配置集成。

除了本地 Git 以外,还支持以下源代码管理提供程序:

  • GitHub
  • BitBucket
  • OneDrive
  • DropBox

在应用服务管理中查看部署源

  1. 以服务管理员身份登录到 Azure Stack Hub 管理员门户。

  2. 浏览到“所有服务”,然后选择“应用服务”。

    App Service resource provider admin

  3. 选择“源代码管理配置”。 可以看到所有已配置的部署源的列表。

    App Service resource provider admin source control configuration

配置 GitHub

必须具有 GitHub 帐户才能完成此任务。 建议使用组织帐户,而不是个人帐户。

  1. 登录到 GitHub,转到 https://www.github.com/settings/developers ,然后选择“注册新应用程序”。

    GitHub - Register a new application

  2. 输入应用程序名称。 例如,Azure Stack Hub 上的应用服务

  3. 输入“主页 URL”。 主页 URL 必须是 Azure Stack Hub 门户地址。 例如,https://portal.<region>.<FQDN>。 有关 Azure Stack Hub 的完全限定的域名 (FQDN) 的详细信息,请参阅 Azure Stack Hub DNS 命名空间

  4. 输入应用程序说明

  5. 输入“授权回调 URL”。 在默认的 Azure Stack Hub 部署中,该 URL 采用 https://portal.<region>.<FQDN>/TokenAuthorize 格式。

  6. 选择“注册应用程序”。 此时会显示一个页面,其中列出了应用的“客户端 ID”和“客户端机密”。

    GitHub - Completed application registration

  7. 在新的浏览器标签页或窗口中,以服务管理员身份登录到 Azure Stack Hub 管理员门户。

  8. 转到“资源提供程序”并选择“应用服务资源提供程序管理” 。

  9. 选择“源代码管理配置”。

  10. 将“客户端 ID”和“客户端机密”复制并粘贴到 GitHub 的相应输入框中。

  11. 选择“保存” 。

配置 BitBucket

必须具有 BitBucket 帐户才能完成此任务。 建议使用组织帐户,而不是个人帐户。

  1. 登录到 BitBucket 并转到帐户下面的“集成”。

    BitBucket Dashboard - Integrations

  2. 选择“访问管理”下面的“OAuth”,并选择“添加使用者” 。

    BitBucket Add OAuth Consumer

  3. 输入使用者的名称。 例如,Azure Stack Hub 上的应用服务

  4. 为应用输入说明

  5. 输入“回调 URL”。 在默认的 Azure Stack Hub 部署中,该回调 URL 采用 https://portal.<region>.<FQDN>/TokenAuthorize 格式。 要使 BitBucket 集成成功,该 URL 的大小写必须与此处所列相同。

  6. 输入 URL。 此 URL 应是 Azure Stack Hub 门户的 URL。 例如,https://portal.<region>.<FQDN>

  7. 选择所需权限

    • 存储库读取
    • Webhook读写
  8. 选择“保存” 。 现在,“OAuth 使用者”下面会显示此新应用以及密钥机密

    BitBucket Application Listing

  9. 在新的浏览器标签页或窗口中,以服务管理员身份登录到 Azure Stack Hub 管理员门户。

  10. 转到“资源提供程序”并选择“应用服务资源提供程序管理” 。

  11. 选择“源代码管理配置”。

  12. 将“密钥”和“机密”分别复制并粘贴到 BitBucket 的“客户端 ID”和“客户端机密”输入框。

  13. 选择“保存” 。

配置 OneDrive

必须将一个 Microsoft 帐户链接到 OneDrive 帐户才能完成此任务。 建议使用组织帐户,而不是个人帐户。

注意

目前不支持 OneDrive for Business 帐户。

  1. 转到 https://portal.azure.cn/#view/Microsoft_AAD_RegisteredApps/ApplicationsListBlade 并使用你的 Azure 帐户登录。

  2. 在“应用注册”下,选择“新建注册”。

  3. 输入新应用注册的名称:例如,输入“ Azure Stack Hub 上的应用服务”。

  4. 在“支持的帐户类型”下,选择“仅限个人 Microsoft 帐户”。

  5. 输入“重定向 URI”。 选择平台 - Web,在默认的 Azure Stack Hub 部署中,重定向 URI 的格式为 - https://portal.<region>.<FQDN>/TokenAuthorize

  6. 选择“注册”。

  7. 下一屏幕列出了新应用的属性。 将“应用程序(客户端) ID”保存到某个临时位置。

  8. 在“证书和机密”下选择“客户端机密”,然后选择“新建客户端机密”。 提供说明并选择新机密的有效期,然后选择“添加”。

  9. 记下新机密的值。

  10. 在“API 权限”下,选择“添加权限”。

  11. 添加“Microsoft Graph 权限 - 委派权限”。

    • Files.ReadWrite.AppFolder
    • 用户。 读取
  12. 在新的浏览器标签页或窗口中,以服务管理员身份登录到 Azure Stack Hub 管理员门户。

  13. 转到“资源提供程序”并选择“应用服务资源提供程序管理” 。

  14. 选择“源代码管理配置”。

  15. 将“应用程序(客户端) ID”和“机密”分别复制并粘贴到 OneDrive 的“客户端 ID”和“客户端机密”输入框中。

  16. 选择“保存” 。

配置 DropBox

注意

必须使用一个 DropBox 帐户来完成此任务。 建议使用组织帐户,而不是个人帐户。

  1. 转到 https://www.dropbox.com/developers/apps ,并使用 DropBox 帐户凭据登录。

  2. 选择“创建应用”。

    Dropbox apps

  3. 选择“DropBox API”。

  4. 将访问级别设置为“应用文件夹”。

  5. 输入应用的名称

    Dropbox application registration

  6. 选择“创建应用”。 此时会出现一个页面,其中列出了应用的设置,包括应用密钥应用机密

  7. 确保“应用文件夹名称”设置为“Azure Stack Hub 上的应用服务” 。

  8. 设置“OAuth 2 重定向 URI”,然后选择“添加” 。 在默认的 Azure Stack Hub 部署中,该重定向 URI 采用 https://portal.<region>.<FQDN>/TokenAuthorize 格式。

    Dropbox application configuration

  9. 在新的浏览器标签页或窗口中,以服务管理员身份登录到 Azure Stack Hub 管理员门户。

  10. 转到“资源提供程序”并选择“应用服务资源提供程序管理” 。

  11. 选择“源代码管理配置”。

  12. 将“应用程序密钥”和“应用机密”分别复制并粘贴到 DropBox 的“客户端 ID”和“客户端机密”输入框。

  13. 选择“保存”。

重要

如果在升级到 Azure Stack Hub 上的 Azure 应用服务 2022 H1 之后重新配置现有应用程序,则必须撤销所有令牌,并且最终用户需要在其应用程序中使用提供程序重新授权才能从源代码管理提供程序同步

配置 GitHub

必须具有 GitHub 帐户才能完成此任务。 建议使用组织帐户,而不是个人帐户。

  1. 登录到 GitHub,转到 https://www.github.com/settings/developers ,然后选择“注册新应用程序”。

    GitHub - Register a new application

  2. 输入应用程序名称。 例如,Azure Stack Hub 上的应用服务

  3. 输入“主页 URL”。 主页 URL 必须是 Azure Stack Hub 门户地址。 例如,https://portal.<region>.<FQDN>。 有关 Azure Stack Hub 的完全限定的域名 (FQDN) 的详细信息,请参阅 Azure Stack Hub DNS 命名空间

  4. 输入应用程序说明

  5. 输入“授权回调 URL”。 在默认的 Azure Stack Hub 部署中,该 URL 采用 https://api.appservice.<region>.<FQDN>:44300/auth/github/callback 格式。

  6. 选择“注册应用程序”。 此时会显示一个页面,其中列出了应用的“客户端 ID”和“客户端机密”。

    GitHub - Completed application registration

  7. 在新的浏览器标签页或窗口中,以服务管理员身份登录到 Azure Stack Hub 管理员门户。

  8. 转到“资源提供程序”并选择“应用服务资源提供程序管理” 。

  9. 选择“源代码管理配置”。

  10. 将“客户端 ID”和“客户端机密”复制并粘贴到 GitHub 的相应输入框中。

  11. 选择“保存” 。

配置 BitBucket

必须具有 BitBucket 帐户才能完成此任务。 建议使用组织帐户,而不是个人帐户。

  1. 登录到 BitBucket 并转到帐户下面的“集成”。

    BitBucket Dashboard - Integrations

  2. 选择“访问管理”下面的“OAuth”,并选择“添加使用者” 。

    BitBucket Add OAuth Consumer

  3. 输入使用者的名称。 例如,Azure Stack Hub 上的应用服务

  4. 为应用输入说明

  5. 输入“回调 URL”。 在默认的 Azure Stack Hub 部署中,该回调 URL 采用 https://api.appservice.<region>.<FQDN>:44300/auth/bitbucket/callback 格式。 要使 BitBucket 集成成功,该 URL 的大小写必须与此处所列相同。

  6. 输入 URL。 此 URL 应是 Azure Stack Hub 门户的 URL。 例如,https://portal.<region>.<FQDN>

  7. 选择所需权限

    • 存储库读取
    • Webhook读写
  8. 选择“保存” 。 现在,“OAuth 使用者”下面会显示此新应用以及密钥机密

    BitBucket Application Listing

  9. 在新的浏览器标签页或窗口中,以服务管理员身份登录到 Azure Stack Hub 管理员门户。

  10. 转到“资源提供程序”并选择“应用服务资源提供程序管理” 。

  11. 选择“源代码管理配置”。

  12. 将“密钥”和“机密”分别复制并粘贴到 BitBucket 的“客户端 ID”和“客户端机密”输入框。

  13. 选择“保存” 。

配置 OneDrive

必须将一个 Microsoft 帐户链接到 OneDrive 帐户才能完成此任务。 建议使用组织帐户,而不是个人帐户。

注意

目前不支持 OneDrive for Business 帐户。

  1. 转到 https://portal.azure.cn/#view/Microsoft_AAD_RegisteredApps/ApplicationsListBlade 并使用你的 Azure 帐户登录。

  2. 在“应用注册”下,选择“新建注册”。

  3. 输入新应用注册的名称:例如,输入“ Azure Stack Hub 上的应用服务”。

  4. 在“支持的帐户类型”下,选择“仅限个人 Microsoft 帐户”

  5. 输入“重定向 URI”。 选择平台 - Web,在默认的 Azure Stack Hub 部署中,重定向 URI 的格式为 - https://api.appservice.<region>.<FQDN>:44300/auth/onedrive/callback

  6. 选择“注册”

  7. 下一屏幕列出了新应用的属性。 将“应用程序(客户端) ID”保存到某个临时位置。

  8. 在“证书和机密”下选择“客户端机密”,然后选择“新建客户端机密”。 提供说明并选择新机密的有效期,然后选择“添加”。

  9. 记下新机密的值。

  10. 在“API 权限”下,选择“添加权限”

  11. 添加“Microsoft Graph 权限 - 委派权限”。

    • Files.ReadWrite.AppFolder
    • 用户。 读取
  12. 在新的浏览器标签页或窗口中,以服务管理员身份登录到 Azure Stack Hub 管理员门户。

  13. 转到“资源提供程序”并选择“应用服务资源提供程序管理” 。

  14. 选择“源代码管理配置”。

  15. 将“应用程序(客户端) ID”和“机密”分别复制并粘贴到 OneDrive 的“客户端 ID”和“客户端机密”输入框中。

  16. 选择“保存” 。

配置 DropBox

注意

必须使用一个 DropBox 帐户来完成此任务。 建议使用组织帐户,而不是个人帐户。

  1. 转到 https://www.dropbox.com/developers/apps ,并使用 DropBox 帐户凭据登录。

  2. 选择“创建应用”。

    Dropbox apps

  3. 选择“DropBox API”。

  4. 将访问级别设置为“应用文件夹”。

  5. 输入应用的名称

    Dropbox application registration

  6. 选择“创建应用”。 此时会出现一个页面,其中列出了应用的设置,包括应用密钥应用机密

  7. 确保“应用文件夹名称”设置为“Azure Stack Hub 上的应用服务” 。

  8. 设置“OAuth 2 重定向 URI”,然后选择“添加” 。 在默认的 Azure Stack Hub 部署中,该重定向 URI 采用 https://api.appservice.<region>.<FQDN>:44300/auth/dropbox/callback 格式。

    Dropbox application configuration

  9. 在新的浏览器标签页或窗口中,以服务管理员身份登录到 Azure Stack Hub 管理员门户。

  10. 转到“资源提供程序”并选择“应用服务资源提供程序管理” 。

  11. 选择“源代码管理配置”。

  12. 将“应用程序密钥”和“应用机密”分别复制并粘贴到 DropBox 的“客户端 ID”和“客户端机密”输入框。

  13. 选择“保存”。

后续步骤

用户现在可以对持续部署本地 Git 部署等操作使用部署源。