本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
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 应用程序
-
登录 AWS Management Console 并打开 Amplify 控制台
。 -
在所有应用程序页面中,选择新建应用程序,然后选择托管 Web 应用程序。
-
在 Amplify 托管入门页面上,选择 GitHub,然后选择继续。
-
如果这是首次连接 GitHub 存储库,则浏览器会在 GitHub.com 上打开一个新页面,请求允许在您的 GitHub 账户中进行 AWS Amplify 授权。选择授权。
-
接下来,必须在您的 GitHub 账户中安装 Amplify GitHub 应用程序。在 GitHub.com 上打开一个页面,请求允许在您的 GitHub 账户中安装和授权 AWS Amplify。
-
选择要安装 Amplify GitHub 应用程序的 GitHub 账户。
-
请执行以下操作之一:
-
要将安装应用于所有存储库,请选择所有存储库。
-
要将安装限于您所选择的特定存储库,请选择仅选择存储库。确保在您选择的存储库中包含要迁移的应用程序的存储库。
-
-
选择安装和授权。
-
您将被重定向到 Amplify 控制台中应用程序的添加存储库分支页面。
-
在最近更新的存储库列表中,选择要连接的存储库的名称。
-
在分支列表中,选择要连接的存储库分支的名称。
-
选择下一步。
-
在配置构建设置页面上,选择下一步。
-
在查看页面上,选择保存并部署。
将现有 OAuth 应用程序迁移到 Amplify GitHub 应用程序
您之前从 GitHub 存储库连接的现有 Amplify 应用程序使用 OAuth 来访问存储库。我们强烈建议您迁移这些应用程序,使用 Amplify GitHub 应用程序。
按照以下说明迁移应用程序,并删除您的 GitHub 账户中相应的 OAuth webhook。请注意,根据是否已安装 Amplify GitHub 应用程序,迁移过程会有所不同。迁移第一个应用程序并安装和授权 GitHub 应用程序后,您只需更新存储库权限即可进行后续应用程序迁移。
将应用程序从 OAuth 迁移到 GitHub 应用程序
-
登录 AWS Management Console 并打开 Amplify 控制台
。 -
选择要迁移的应用程序。
-
在应用程序的信息页面上,找到蓝色的迁移到我们的 GitHub 应用程序消息,然后选择开始迁移。
-
在安装和授权 GitHub 应用程序页面上,选择配置 GitHub 应用程序。
-
浏览器会在 GitHub.com 上打开一个新页面,请求允许在您的 GitHub 账户进行 AWS Amplify 授权。选择授权。
-
选择要安装 Amplify GitHub 应用程序的 GitHub 账户。
-
请执行以下操作之一:
-
要将安装应用于所有存储库,请选择所有存储库。
-
要将安装限于您所选择的特定存储库,请选择仅选择存储库。确保在您选择的存储库中包含要迁移的应用程序的存储库。
-
-
选择安装和授权。
-
您将被重定向到 Amplify 控制台中应用程序的安装和授权 GitHub 应用程序页面。如果 GitHub 授权成功,您将看到一条成功消息。选择下一步。
-
在完成安装页面上,选择完成安装。此步骤将删除您现有的 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 应用程序
-
打开 Web 浏览器,导航到 Amplify GitHub 应用程序在您要部署应用程序的 AWS 区域的安装位置。
使用格式
https://github.com/apps/aws-amplify-
,将REGION
/installations/new区域
替换为您自己的输入。例如,如果您要在美国西部(俄勒冈州)区域安装应用程序,请指定https://github.com/apps/aws-amplify-us-west-2/installations/new
。 -
选择要安装 Amplify GitHub 应用程序的 GitHub 账户。
-
请执行以下操作之一:
-
要将安装应用于所有存储库,请选择所有存储库。
-
要将安装限于您所选择的特定存储库,请选择仅选择存储库。确保在您选择的存储库中包含要迁移的应用程序的存储库。
-
-
选择安装。
在您的 GitHub 账户中生成个人访问令牌
-
登录到您的 GitHub 账户。
-
在右上角,找到您的个人资料照片,然后从菜单中选择设置。
-
在左侧导航菜单中,选择 SMTP 设置。
-
在 GitHub 应用程序页面的左侧导航菜单中,选择个人访问令牌。
-
在个人访问令牌页面上,选择生成新令牌。
-
在新建个人访问令牌页面上,请在注释中输入令牌的描述性名称。
-
在选择范围部分,选择 admin:repo_hook。
-
选择生成令牌。
-
复制并保存个人访问令牌。当您使用 CLI、AWS CloudFormation 或开发工具包部署 Amplify 应用程序时,您需要提供令牌。
在您的 GitHub 账户中安装 Amplify GitHub 应用程序并生成个人访问令牌后,您可以使用 Amplify CLI、AWS CloudFormation 或开发工具包部署新应用程序。使用 accessToken
字段指定您在上一步中创建的个人访问令牌。有关更多信息,请参阅 Amplify API 参考中的 CreateApp 和 AWS CloudFormation 用户指南中的 AWS:: Amplify::App。
以下 CLI 命令部署了一个新的 Amplify 应用程序,该应用使用 GitHub 应用程序访问存储库。用您自己的信息替换 myapp-using-githubapp
、https://github.com/Myaccount/react-app
和 MY_TOKEN
。
aws amplify create-app --name
myapp-using-githubapp
--repositoryhttps://github.com/Myaccount/react-app
--access-tokenMY_TOKEN
使用 Amplify GitHub 应用程序设置网页预览
网页预览会将每个向 GitHub 存储库发出的拉取请求 (PR) 部署到一个唯一的预览网址。预览现在使用 Amplify GitHub 应用程序访问您的 GitHub 存储库。有关安装和授权 GitHub 应用程序进行网页预览的说明,请参阅 启用 Web 预览。