使用基础架构编排器构建您的第一个应用程序 - AWS 基础设施编辑器

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

使用基础架构编排器构建您的第一个应用程序

在本教程中,您将使用 AWS 基础设施编辑器 创建用于管理数据库中用户的创建、读取、更新和删除 (CRUD) 无服务器应用程序。

在本教程中,我们在中使用基础设施编排器 AWS Management Console。我们建议您使用 Google Chrome 或 Microsoft Edge,以及一个全屏浏览器窗口。

您是无服务器技术的新手吗?

我们建议您初步了解以下主题:

要了解更多信息,请参阅 的无服务器概念 AWS 基础设施编辑器

资源属性参考

在构建应用程序时,请使用此表作为参考,配置您的 Amazon API Gateway 和 AWS Lambda 资源的属性。

方法 路径 函数名称

GET

/items

getItems

GET

/items/ {id}

getItem

PUT

/items/ {id}

updateItem

POST

/item

addItem

DELETE

/items/ {id}

deleteItem

第 1 步:创建您的项目

要开始使用您的CRUD无服务器应用程序,请在 Infrastructure Composer 中创建一个新项目并激活本地同步

创建新的空白项目
  1. 登录基础设施编排控制台

  2. 主页上,选择创建项目

如下图所示,Infrastructure Composer 打开可视化画布并加载起始(空白)应用程序模板。

带有空白视觉画布的基础设施编排器。
激活本地同步
  1. 从 “基础设施编排” 菜单中,选择 “保存” > “激活本地同步”。

    选中 “激活本地同步” 的 “基础设施编辑器” 菜单。
  2. 在 “项目位置” 中,按选择文件夹,然后选择一个目录。在您设计时,基础设施编排器将在这里保存和同步您的模板文件和文件夹。

    项目位置不得包含现有的应用程序模板。

    注意

    本地同步需要支持文件系统访问的浏览器API。有关更多信息,请参阅 数据基础架构编排器可以访问

  3. 当系统提示允许访问时,选择 “查看文件”。

  4. 按 “激活” 开启本地同步。当系统提示保存更改时,选择保存更改

    激活后,自动保存指示器将显示在画布的左上角区域。

第 2 步:向画布添加卡片

开始使用增强的组件卡设计应用程序架构,首先是API网关RESTAPI和五个 Lambda 函数。

将 API Gateway 和 Lambda 卡片添加到画布中

在 “资源” 选项板的 “增强组件” 部分下,执行以下操作:

  1. APIGateway 卡片拖到画布上。

  2. Lambda 函数卡片拖到画布上。重复此操作,直到在画布上添加了五张 Lambda 函数卡。

基础设施编排器画布视图,包含一个API网关和五张 Lambda 功能卡。

步骤 3:配置您的API网关 REST API

接下来,在API网关卡中添加五条路线。

向 API Gateway 卡添加路由
  1. 打开API网关卡的资源属性面板。要打开面板,请双击卡片。或者,选择卡片,然后选择 “详细信息”。

  2. 在 “资源属性” 面板的 “路由” 下,执行以下操作:

    注意

    对于以下每条路由,请使用资源属性参考表中指定的HTTP方法和路径值。

    1. 在 “方法” 中,选择指定的HTTP方法。例如,GET

    2. 路径中,输入指定的路径。例如,/items

    3. 选择 Add route(添加路由)。

    4. 重复前面的步骤,直到添加完所有五条指定路线。

  3. 选择保存

基础设施编排器可视化画布,其中包含包含五条路径的API网关资源。Resource properties面板显示 “方法”、“路径” 和 “添加路径” 的选项。

第 4 步:配置您的 Lambda 函数

按照资源属性参考表中的规定,分别命名五个 Lambda 函数。

命名 Lambda 函数
  1. 打开 Lambda 函数卡片的资源属性面板。要打开面板,请双击卡片。或者,选择卡片,然后选择 “详细信息”。

  2. 资源属性面板中,为逻辑 ID 输入指定的函数名称。例如,getItems

  3. 选择保存

  4. 重复前面的步骤,直到命名完所有五个函数。

基础设施编排器可视化画布,包含五张命名的 Lambda 函数资源卡。

第 5 步:Connect 你的卡片

按照资源属性参考表中的指定,将API网关卡上的每条路由连接到其相关的 Lambda 功能卡。

连接您的卡片
  1. 单击 APIGateway 卡上的右侧端口,然后将其拖到指定 Lambda 功能卡的左侧端口。例如,单击 GET/items 端口并将其拖动到的左侧端口。getItems

  2. 重复上一步操作,直到将API网关卡上的所有五条路由都连接到相应的 Lambda 功能卡。

基础设施编排器可视化画布,与五个 Lambda 函数RESTAPI相关联。

第 6 步:整理画布

通过将您的 Lambda 函数组合在一起并整理所有卡片来整理视觉画布。

将您的函数组合在一起
  1. 按住 Shift 键,然后选择画布上的每张 Lambda 功能卡。

  2. 选择分组

为你的群组命名
  1. 双击群组顶部,靠近群组名称(群组)。

    组属性面板打开。

  2. 在 “群组属性” 面板上,在 “群组名称” 栏中输入API

  3. 选择保存

整理你的卡片

在画布上,在主视图区域上方,选择排列

Infrastructure Composer 排列和对齐视觉画布上的所有卡片,包括你的新群组 (API),如下所示:

基础设施编排器可视化画布将所有 Lambda 函数组合在一起。

步骤 7:添加并连接 DynamoDB 表

现在,向您的应用程序架构中添加一个 DynamoDB 表,并将其连接到您的 Lambda 函数。

添加和连接 DynamoDB 表
  1. 从资源选项板(资源)的 “增强组件” 部分下,将 D ynamoDB 表格卡片拖到画布上。

  2. 单击 Lambda Func tion 卡上的右侧端口,然后将其拖到 DynamoDB 表卡的左侧端口。

  3. 重复上一步操作,直到将所有五张 Lambda 功能卡都连接到 Dynam oDB 桌卡。

  4. (可选)要重新整理和重新对齐画布上的卡片,请选择 “排列”。

基础设施编排器可视化画布,其中有一个 DynamoDB 表连接到群组。API

第 8 步:查看您的 AWS CloudFormation 模板

恭喜您!您已成功设计出可随时部署的无服务器应用程序。最后,选择 “模板”,查看基础架构编排器自动为您生成的 AWS CloudFormation 模板。

在模板中,基础设施编排器定义了以下内容:

  • Transform声明,它将模板指定为 AWS Serverless Application Model (AWS SAM) 模板。有关更多信息,请参阅《AWS Serverless Application Model 开发人员指南》中的AWS SAM 模板剖析

  • 一种AWS::Serverless::Api资源,用于指定您的API网关RESTAPI及其五条路由。

  • 五个AWS::Serverless::Function资源,用于指定您的 Lambda 函数的配置,包括其环境变量和权限策略。

  • 一种AWS::DynamoDB::Table资源,用于指定您的 DynamoDB 表及其属性。

  • Metadata部分,其中包含有关您的资源组的信息 (API)。有关本节的更多信息,请参阅《AWS CloudFormation 用户指南》中的元数据

显示应用程序模板代码的 “基础设施编排器” 模板视图。

第 9 步:集成到您的开发工作流程中

使用 Infrastructure Composer 创建的模板文件和项目目录进行进一步的测试和部署。

后续步骤

现在,您已经准备好使用基础架构编排器构建自己的应用程序了。有关使用基础架构编排器的详细资料,请参阅如何作曲 AWS 基础设施编辑器。准备好部署应用程序时,请参阅将您的基础架构 Composer 无服务器应用程序部署到云端 AWS