使用以下命令将 Bitbucket 存储库与 A AWS mplify 集成 AWS CloudFormation - AWS Prescriptive Guidance
摘要先决条件和限制架构工具操作说明相关资源附件

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

使用以下命令将 Bitbucket 存储库与 A AWS mplify 集成 AWS CloudFormation

由 Alwin Abraham 创作 () AWS

摘要

AWSAmplify 可帮助您快速部署和测试静态网站，而无需设置通常所需的基础架构。如果您的组织想要使用 Bitbucket 进行源代码控制，无论是迁移现有应用程序代码还是构建新应用程序，都可部署这种模式的方法。通过AWS CloudFormation 使用自动设置 Amplify，您可以查看所使用的配置。

此模式描述了如何使用AWS CloudFormation 将 Bitbucket 存储库与 Amplify 集成，从而创建前端持续集成和持续部署 (CI/CD) 管道和部署环境。AWS此模式方法意味着你可以为可重复的部署构建 Amplify 前端管道。

先决条件和限制

先决条件

  • 有效的亚马逊 Web Services (AWS) 账户

  • 含管理员访问权限的活跃 Bitbucket 账户

  • 访问使用 c URL 或 Postman 应用程序的终端

  • 熟悉 Amplify

  • 熟悉 AWS CloudFormation

  • 熟悉 YAML-格式的文件

架构

Diagram showing user interaction with Bitbucket repository connected to AWS Amplify in AWS Cloud region.

技术堆栈

  • Amplify

  • AWS CloudFormation

  • Bitbucket

工具

  • AWSAmplify — Amplify 帮助开发者开发和部署基于云的移动和网络应用程序。

  • AWS CloudFormation— AWS CloudFormation 是一项服务，可帮助您对AWS资源进行建模和设置，这样您就可以花更少的时间管理这些资源，而将更多的时间集中在运行的应用程序上AWS。

  • Bitbucket – Bitbucket 是一款专为专业团队设计的 Git 存储库管理解决方案。它为你提供了集中位置来管理 Git 存储库、协作处理源代码以及指导你完成开发流程。

代码

bitbucket-amplify.yml文件（附件）包含此模式的AWS CloudFormation 模板。

操作说明

任务描述所需技能
（可选）创建 Bitbucket 存储库。

  1. 登录您的 Bitbucket 账户，并创建新的存储库。有关这方面的更多信息，请参阅 Bitbucket 文档中的创建 Git 存储库。 

  2. 记录工作空间名称。

注意

您也可以使用现有的 Bitbucket 存储库。

DevOps 工程师
打开工作区设置。

  1. 打开工作区并选择存储库选项卡。

  2. 选择要与 Amplify 集成的存储库。

  3. 选择位于存储库名称上方位置的工作区名称。

  4. 在侧栏上，选择设置。

DevOps 工程师
创建OAuth消费者。

  1. 在 “应用程序和功能” 部分中，选择OAuth消费者，然后选择添加消费者。

  2. 输入您的消费者名称，例如，Amplify Integration。

  3. 输入回调URL。尽管此字段为必填项，但它不用于完成集成，因此该值可能是 http://localhost:3000

  4. 选中这是私人使用者复选框。

  5. 选择以下权限：

    • 项目 – Read

    • 存储库 – Admin

    • 拉取请求 – Read

    • 网络钩子 – Read 和 Write

  6. 对所有其他字段保持默认选择，然后选择提交。

  7. 记录生成的密钥与机密。

DevOps 工程师
获取OAuth访问令牌。

  1. 打开终端窗口，并运行以下命令： 

curl -X POST -u "KEY:SECRET" https://bitbucket.org/site/oauth2/access_token -d grant_type=client_credentials 

重要

将KEY和SECRET替换为您之前录制的密钥和密钥。 

2. 在不使用引号的情况下，记录访问令牌。该令牌仅在有限时间内有效，默认时间为两个小时。您必须在此时间范围内运行AWS CloudFormation 模板。

DevOps 工程师
任务描述所需技能
下载 AWS CloudFormation 模板。

下载bitbucket-amplify.ymlAWS CloudFormation 模板（附后）。除了 Amplify 项目与分支外，此模板还在 Amplify 中创建 CI/CD 管道。

创建并部署AWS CloudFormation 堆栈。

  1. 登录您要部署的AWS区域中的AWS管理控制台并打开AWS CloudFormation 控制台。 

  2. 选择创建堆栈（使用新资源），然后选择上传模板文件。 

  3. 上传 bitbucket-amplify.yml文件。

  4. 选择下一步，输入堆栈名称，然后输入以下参数：

    • 访问令牌：粘贴您之前创建的OAuth访问令牌。

    • 存储库 URL：添加 Bitbucket 项目存储库。URLURL通常采用以下格式：https://bitbucket.org/<WORKSPACE_NAME>/<REPO_NAME>

    • 分支名称：该名称必须与您的 Bitbucket 存储库分支的名称相匹配。当你运行AWS CloudFormation 堆栈时，这个分支不需要存在，但它是向环境部署代码所必需的。

    • 项目名称：与 Amplify 项目关联的名称。

5. 选择下一步，然后选择创建堆栈。

DevOps 工程师
任务描述所需技能
将代码部署到存储库中的分支。

  1. 通过运行以下命令，克隆您的 Bitbucket 存储库：git clone https://bitbucket.org/<WORKSPACE_NAME>/<REPO_NAME>

  2. 查看运行AWS CloudFormation 脚本时使用的分支名称。要创建并签出新分支，请运行 git checkout -b <BRANCH_NAME> 命令。要检出现有分支，请运行 git checkout <BRANCH_NAME> 命令

  3. 通过运行 git commit 和 git push 命令，将代码提交至分支，并推送至远程分支。

  4. 然后，Amplify 会构建并部署此应用程序。

有关这方面的更多信息，请参阅 Bitbucket 文档中的 Basic Git 命令。 

应用程序开发人员

相关资源

身份验证方法（Atlassian 文档）

附件

要访问与此文档相关联的其他内容，请解压以下文件：attachment.zip