选择您的 Cookie 首选项

我们使用必要 Cookie 和类似工具提供我们的网站和服务。我们使用性能 Cookie 收集匿名统计数据,以便我们可以了解客户如何使用我们的网站并进行改进。必要 Cookie 无法停用,但您可以单击“自定义”或“拒绝”来拒绝性能 Cookie。

如果您同意,AWS 和经批准的第三方还将使用 Cookie 提供有用的网站功能、记住您的首选项并显示相关内容,包括相关广告。要接受或拒绝所有非必要 Cookie,请单击“接受”或“拒绝”。要做出更详细的选择,请单击“自定义”。

设置 Amplify 对 GitHub 存储库的访问权限

聚焦模式
设置 Amplify 对 GitHub 存储库的访问权限 - AWS Amplify 托管

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

Amplify 现在使用 GitHub 应用程序功能来授权 Amplify 以只读形式访问 GitHub 存储库。使用 Amplify GitHub 应用程序,就可以对权限进行更精细的调整,使您能够授予 Amplify 仅访问指定存储库的权限。要了解有关 GitHub 应用程序的详细信息,请参阅 GitHub 网站上的 About GitHub Apps

当您连接存储在 GitHub 存储库中的新应用程序时,默认情况下 Amplify 使用 GitHub 应用程序来访问存储库。但是,您之前从 GitHub 存储库连接的现有 Amplify 应用程序使用 OAuth 进行访问。CI/CD 将继续适用于这些应用程序,但我们强烈建议您对其进行迁移以使用新的 Amplify GitHub 应用程序。

当您使用 Amplify 控制台部署新应用程序或迁移现有应用程序时,系统会自动将您定向到 Amplify GitHub 应用程序的安装位置。要手动访问应用程序的安装登录页面,请打开 Web 浏览器并按地区导航到该应用程序。使用格式 https://github.com/apps/aws-amplify-REGION,将区域替换为要部署 Amplify 应用程序的区域。例如,要在美国西部(俄勒冈州)区域安装 Amplify GitHub 应用程序,请导航至 https://github.com/apps/aws-amplify-us-west-2。

为新部署安装和授权 Amplify GitHub 应用程序

当您利用 GitHub 存储库中的现有代码向 Amplify 部署新应用程序时,请按照以下说明安装和授权 GitHub 应用程序。

安装和授权 Amplify GitHub 应用程序
  1. 登录 AWS Management Console 并打开 Amplify 控制台

  2. 所有应用程序页面中,选择新建应用程序,然后选择托管 Web 应用程序

  3. Amplify 托管入门页面上,选择 GitHub,然后选择继续

  4. 如果这是首次连接 GitHub 存储库,则浏览器会在 GitHub.com 上打开一个新页面,请求允许在您的 GitHub 账户中进行 AWS Amplify 授权。选择授权

  5. 接下来,必须在您的 GitHub 账户中安装 Amplify GitHub 应用程序。在 GitHub.com 上打开一个页面,请求允许在您的 GitHub 账户中安装和授权 AWS Amplify。

  6. 选择要安装 Amplify GitHub 应用程序的 GitHub 账户。

  7. 请执行以下操作之一:

    • 要将安装应用于所有存储库,请选择所有存储库

    • 要将安装限于您所选择的特定存储库,请选择仅选择存储库。确保在您选择的存储库中包含要迁移的应用程序的存储库。

  8. 选择安装和授权

  9. 您将被重定向到 Amplify 控制台中应用程序的添加存储库分支页面。

  10. 最近更新的存储库列表中,选择要连接的存储库的名称。

  11. 分支列表中,选择要连接的存储库分支的名称。

  12. 选择下一步

  13. 配置构建设置页面上,选择下一步

  14. 查看页面上,选择保存并部署

将现有 OAuth 应用程序迁移到 Amplify GitHub 应用程序

您之前从 GitHub 存储库连接的现有 Amplify 应用程序使用 OAuth 来访问存储库。我们强烈建议您迁移这些应用程序,使用 Amplify GitHub 应用程序。

按照以下说明迁移应用程序,并删除您的 GitHub 账户中相应的 OAuth webhook。请注意,根据是否已安装 Amplify GitHub 应用程序,迁移过程会有所不同。迁移第一个应用程序并安装和授权 GitHub 应用程序后,您只需更新存储库权限即可进行后续应用程序迁移。

将应用程序从 OAuth 迁移到 GitHub 应用程序
  1. 登录 AWS Management Console 并打开 Amplify 控制台

  2. 选择要迁移的应用程序。

  3. 在应用程序的信息页面上,找到蓝色的迁移到我们的 GitHub 应用程序消息,然后选择开始迁移

  4. 安装和授权 GitHub 应用程序页面上,选择配置 GitHub 应用程序

  5. 浏览器会在 GitHub.com 上打开一个新页面,请求允许在您的 GitHub 账户进行 AWS Amplify 授权。选择授权

  6. 选择要安装 Amplify GitHub 应用程序的 GitHub 账户。

  7. 请执行以下操作之一:

    • 要将安装应用于所有存储库,请选择所有存储库

    • 要将安装限于您所选择的特定存储库,请选择仅选择存储库。确保在您选择的存储库中包含要迁移的应用程序的存储库。

  8. 选择安装和授权

  9. 您将被重定向到 Amplify 控制台中应用程序的安装和授权 GitHub 应用程序页面。如果 GitHub 授权成功,您将看到一条成功消息。选择下一步

  10. 完成安装页面上,选择完成安装。此步骤将删除您现有的 webhook,并创建一个新的 webhook,然后完成迁移。

为 AWS CloudFormation、CLI 和 SDK 部署设置 Amplify GitHub 应用程序

您之前从 GitHub 存储库连接的现有 Amplify 应用程序使用 OAuth 来访问存储库。这可能包括您使用命令行界面 (CLI)、AWS CloudFormation 或开发工具包部署的应用程序。我们强烈建议您迁移这些应用程序,使用新的 Amplify GitHub 应用程序。迁移必须在 AWS Management Console 的 Amplify 控制台中执行。有关说明,请参阅 将现有 OAuth 应用程序迁移到 Amplify GitHub 应用程序

您可以使用 AWS CloudFormation、Amplify CLI 和开发工具包来部署一个新的 Amplify 应用程序,该应用使用 GitHub 应用程序访问存储库。此过程要求您首先在您的 GitHub 账户中安装 Amplify GitHub 应用程序。接下来,您需要在您的 GitHub 账户中生成个人访问令牌。最后,部署应用程序并指定个人访问令牌。

在您的账户中安装 Amplify GitHub 应用程序
  1. 打开 Web 浏览器,导航到 Amplify GitHub 应用程序在您要部署应用程序的 AWS 区域的安装位置。

    使用格式 https://github.com/apps/aws-amplify-REGION/installations/new,将区域替换为您自己的输入。例如,如果您要在美国西部(俄勒冈州)区域安装应用程序,请指定 https://github.com/apps/aws-amplify-us-west-2/installations/new

  2. 选择要安装 Amplify GitHub 应用程序的 GitHub 账户。

  3. 请执行以下操作之一:

    • 要将安装应用于所有存储库,请选择所有存储库

    • 要将安装限于您所选择的特定存储库,请选择仅选择存储库。确保在您选择的存储库中包含要迁移的应用程序的存储库。

  4. 选择安装

在您的 GitHub 账户中生成个人访问令牌
  1. 登录到您的 GitHub 账户。

  2. 在右上角,找到您的个人资料照片,然后从菜单中选择设置

  3. 在左侧导航菜单中,选择 SMTP 设置

  4. GitHub 应用程序页面的左侧导航菜单中,选择个人访问令牌

  5. 个人访问令牌页面上,选择生成新令牌

  6. 新建个人访问令牌页面上,请在注释中输入令牌的描述性名称。

  7. 选择范围部分,选择 admin:repo_hook

  8. 选择生成令牌

  9. 复制并保存个人访问令牌。当您使用 CLI、AWS CloudFormation 或开发工具包部署 Amplify 应用程序时,您需要提供令牌。

在您的 GitHub 账户中安装 Amplify GitHub 应用程序并生成个人访问令牌后,您可以使用 Amplify CLI、AWS CloudFormation 或开发工具包部署新应用程序。使用 accessToken 字段指定您在上一步中创建的个人访问令牌。有关更多信息,请参阅 Amplify API 参考中的 CreateAppAWS CloudFormation 用户指南中的 AWS:: Amplify::App

以下 CLI 命令部署了一个新的 Amplify 应用程序,该应用使用 GitHub 应用程序访问存储库。用您自己的信息替换 myapp-using-githubapphttps://github.com/Myaccount/react-appMY_TOKEN

aws amplify create-app --name myapp-using-githubapp --repository https://github.com/Myaccount/react-app --access-token MY_TOKEN

使用 Amplify GitHub 应用程序设置网页预览

网页预览会将每个向 GitHub 存储库发出的拉取请求 (PR) 部署到一个唯一的预览网址。预览现在使用 Amplify GitHub 应用程序访问您的 GitHub 存储库。有关安装和授权 GitHub 应用程序进行网页预览的说明,请参阅 启用 Web 预览

隐私网站条款Cookie 首选项
© 2025, Amazon Web Services, Inc. 或其附属公司。保留所有权利。