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

# 使用控制 AWS 基础架构编辑器 台
<a name="using-composer-console"></a>

本节详细介绍了如何通过基础设施编排控制台进行访问和使用 AWS 基础架构编辑器 。这是基础设施编排器的默认体验，也是熟悉基础架构编排的好方法。您也可以将基础架构编排控制台与本地 IDE 集成。有关更多信息，请参阅 [将基础架构编排控制台与本地 IDE 连接起来](other-services-ide.md)。

您还可以[从 VS Code 中的 AWS 工具包中访问基础设施编](using-composer-ide.md)排[器，也可以使用专为在中使用而设计的基础设施编排器模式 CloudFormation](using-composer-console-cfn-mode.md)。

有关使用基础架构编排器的一般文档，请参阅[如何作曲](using-composer-basics.md)。

**Topics**
+ [AWS 基础架构编辑器 控制台视觉概述](reference-visual.md)
+ [通过基础设施编排控制台管理您的项目](using-composer-project.md)
+ [将基础架构编排控制台与本地 IDE 连接起来](other-services-ide.md)
+ [允许网页访问基础设施编排器中的本地文件](reference-fsa.md)
+ [在基础设施编排控制台中本地同步并保存您的项目](using-composer-project-local-sync.md)
+ [从 Lambda 控制台将函数导入基础设施编排器](other-services-lambda.md)
+ [导出基础设施编排器可视画布的图像](reference-features-export.md)

# AWS 基础架构编辑器 控制台视觉概述
<a name="reference-visual"></a>

本节提供了 AWS 基础架构编辑器 控制台的直观概述。

**Topics**
+ [主页](#reference-visual-home)
+ [视觉设计师和视觉画布](#reference-visual-designer)

## 主页
<a name="reference-visual-home"></a>

下图是基础设施编排控制台中的主页：

![\[基础设施编排器主页。\]](http://docs.aws.amazon.com/zh_cn/infrastructure-composer/latest/dg/images/aac_ref_01.png)


1. **文档**-转至基础设施编排器文档。

1. **画布**-进入画布并创建或加载项目。

1. **演示**-打开基础架构编辑器演示应用程序。

1. **创建项目**-创建或加载项目。

1. **开始构建**-用于开始构建应用程序的快速链接。

1. **反馈** — 前往此处提交反馈。

## 视觉设计师和视觉画布
<a name="reference-visual-designer"></a>

下图是 Infrastructure Composer 的可视化设计器和视觉画布的图像：

![\[基础架构编辑器的可视化设计器和视觉画布。\]](http://docs.aws.amazon.com/zh_cn/infrastructure-composer/latest/dg/images/aac_ref_02.png)


1. **资源调色板**-显示可以用来设计的卡片。

1. **资源搜索栏**-搜索可以添加到画布的卡片。

1. **列表**-显示应用程序资源的树视图。

1. **主页** — 选择此处进入基础设施编排器主页。

1. **保存状态**-表示是否将基础架构编排器更改保存到本地计算机。状态包括：
   + **自动保存**-**本地同步**已激活，您的项目将自动同步和保存。
   + **更改已保存**-您的应用程序模板已保存到本地计算机。
   + **未保存的更改**-您的应用程序模板中有未保存到本地计算机的更改。

1. **资源**-显示资源选项板。

1. **画布**-在主视图区域中显示应用程序的画布视图。

1. **模板**-在主视图区域显示应用程序的模板视图。

1. **排列**-在画布中排列应用程序架构。

1. **撤消和重做**-在支持时执行**撤消**和**重做**操作。

1. **模板名称**-表示您正在设计的模板的名称。

1. **主视图区域**-根据您的选择显示画布或模板。

1. **资源属性面板**-显示在画布中选择的卡片的相关属性。此面板是动态的。在您配置卡片时，显示的属性将发生变化。

1. **菜单**-提供常规选项，例如：
   + **创建项目**
   + **打开模板文件或项目**
   + **保存模板文件**
   + **[激活本地同步](using-composer-project-local-sync.md)**
   + **[导出画布](reference-features-export.md)**
   + **获取支持**
   + **键盘快捷键**

1. **卡片**-在画布上显示卡片的视图。

1. **线**-表示卡片之间的连接。

1. **分组** — 将选定的卡片组合在一起以进行可视化整理。

1. **卡牌操作**-提供您可以对卡片执行的操作。

   1. **详细信息**-打开资源属性面板。

   1. **分组** — 将选定的卡片组合在一起。

   1. **删除**-从画布中删除卡片。

1. **端口**-指向其他卡的连接点。

1. **资源属性字段**-一组精心策划的属性字段，用于为您的卡片进行配置。

1. **重新居**中 — 在视觉画布上将应用程序图表重新居中。

1. **缩放**-在画布上放大和缩小。

1. **反馈** — 前往此处提交反馈。

# 通过基础设施编排控制台管理您的项目
<a name="using-composer-project"></a>

本主题提供有关在基础设施编排控制台中管理项目时执行的基本任务的指导。这包括创建新项目、保存项目以及导入项目或模板等常见任务。如果您激活[本地同步模式](using-composer-project-local-sync.md)，也可以加载现有项目。激活本地同步模式后，您可以执行以下操作：
+ 创建一个由起始模板和文件夹结构组成的新项目。
+ 通过选择包含项目模板和文件的父文件夹，加载现有项目。
+ 使用基础架构编排器管理您的模板和文件夹

在本地同步模式下，Infrastructure Composer 会自动将项目的模板和文件夹更改保存到本地计算机。如果您的浏览器不支持本地同步模式，或者您更喜欢在未激活本地同步模式的情况下使用 Infrastructure Composer，则可以创建新模板或加载现有模板。要保存更改，必须将模板导出到本地计算机。

**注意**  
基础架构 Composer 支持的应用程序包含以下内容：  
用于定义您的基础架构代码的 CloudFormation 或 AWS Serverless Application Model 模板。
一种用于组织项目文件（例如 Lambda 函数代码、配置文件和生成文件夹）的文件夹结构。

**Topics**
+ [在基础设施编排控制台中创建新项目](using-composer-project-new.md)
+ [在基础设施编排控制台中导入现有项目文件夹](using-composer-project-import-folder.md)
+ [在基础设施编排控制台中导入现有项目模板](using-composer-project-import-template.md)
+ [将现有项目模板保存到基础设施编排控制台中](using-composer-project-save-template.md)

# 在基础设施编排控制台中创建新项目
<a name="using-composer-project-new"></a>

创建新项目时，基础架构编排器会生成一个起始模板。当您在画布上设计应用程序时，您的模板会被修改。要保存您所做的工作，您必须导出模板或激活本地同步模式。

**创建新的项目**

1. 登录[基础设施编排控制台](https://console.aws.amazon.com/composer/home)。

1. 在**主页**上，选择**创建项目**。

**注意**  
您也可以在 Infrastructure Composer 中加载现有的，但必须先[激活本地同步模式](using-composer-project-local-sync.md)。激活后[加载已激活本地同步的现有基础架构编排器项目](using-composer-how-to-load-with-local-sync.md)，请参见加载现有项目。

# 在基础设施编排控制台中导入现有项目文件夹
<a name="using-composer-project-import-folder"></a>

使用本地同步模式，您可以导入现有项目的父文件夹。如果您的项目包含多个模板，则可以选择要加载的模板。

**从主页导入现有项目**

1. 登录[基础设施编排控制台](https://console.aws.amazon.com/composer/home)。

1. 在**主页**上，选择**加载 CloudFormation 模板**。

1. 对于**项目位置**，选择**选择文件夹**。选择项目的父文件夹，**然后选择 “选择”**。
**注意**  
如果您没有收到此提示，则您的浏览器可能不支持本地同步模式所需的文件系统访问 API。有关更多信息，请参阅 [允许网页访问基础设施编排器中的本地文件](reference-fsa.md)。

1. 当浏览器出现提示时，选择 “**查看文件**”。

1. 对于**模板文件**，请从下拉列表中选择您的模板。如果您的项目包含单个模板，则基础架构编排器会自动为您选择该模板。

1. 选择**创建**。

**从画布中导入现有项目**

1. 在画布上选择 **“菜单”** 以打开菜单。

1. 在 “**打开**” 部分中，选择 “**项目文件夹”**。
**注意**  
如果 **“项目文件夹**” 选项不可用，则您的浏览器可能不支持本地同步模式所必需的 File System Access API。有关更多信息，请参阅 [允许网页访问基础设施编排器中的本地文件](reference-fsa.md)。

1. 对于**项目位置**，选择**选择文件夹**。选择项目的父文件夹，**然后选择 “选择”**。

1. 当浏览器出现提示时，选择 “**查看文件**”。

1. 对于**模板文件**，请从下拉列表中选择您的模板。如果您的项目包含单个模板，则基础架构编排器会自动为您选择该模板。

1. 选择**创建**。

导入现有项目文件夹时，基础设施编排器会激活**本地同步模式**。对项目模板或文件所做的更改会自动保存到本地计算机上。

# 在基础设施编排控制台中导入现有项目模板
<a name="using-composer-project-import-template"></a>

当您导入现有 CloudFormation 或 AWS SAM 模板时，Infrastructure Composer 会自动在画布上生成应用程序架构的可视化效果。

您可以从本地计算机导入项目模板。

**导入现有项目模板**

1. 登录[基础设施编排控制台](https://console.aws.amazon.com/composer/home)。

1. 选择 “**创建项目**” 以打开空白画布。

1. 选择 **“菜单”** 以打开菜单。

1. 在 “**打开**” 部分中，选择**模板文件**。

1. 选择您的模板并选择 “**打开**”。

要保存对模板的更改，必须导出模板或激活本地同步模式。

# 将现有项目模板保存到基础设施编排控制台中
<a name="using-composer-project-save-template"></a>

如果您不使用本地同步模式，则必须导出模板才能保存更改。如果您已激活本地同步模式，则无需手动保存模板。更改会自动保存到您的本地计算机上。

**保存现有项目模板**

1. 在 “基础设施编排器” 画布中，选择 **“菜单**” 以打开菜单。

1. 在 “**保存**” 部分，选择 “**保存模板文件**”。

1. 为您的模板提供一个名称。

1. 选择保存模板的位置。

1. 选择**保存**。

# 将基础架构编排控制台与本地 IDE 连接起来
<a name="other-services-ide"></a>

要将 Infrastructure Composer 控制台与本地集成开发环境 (IDE) 连接起来，请使用本地同步模式。此模式会自动将数据同步并保存到您的本地计算机。有关本地同步模式的更多信息，请参阅[在基础设施编排控制台中本地同步并保存您的项目](using-composer-project-local-sync.md)。有关使用本地同步模式的说明，请参阅[在基础设施编排控制台中本地同步并保存您的项目](using-composer-project-local-sync.md)。

**注意**  
并非所有浏览器都提供 “**激活本地同步**” 选项。它在谷歌浏览器和微软 Edge 中可用。

## 在本地 IDE 中使用基础结构编排器的好处
<a name="other-services-ide-benefits"></a>

当您在基础架构编辑器中进行设计时，您的本地模板和项目目录会自动同步和保存。

您可以使用本地 IDE 来查看更改和修改模板。您在本地所做的更改会自动同步到基础架构编排器。

您可以使用 AWS Serverless Application Model 命令行界面 (AWS SAM CLI) 等本地工具来构建、测试、部署应用程序等。以下示例显示了如何将资源拖放到基础架构编排器的可视化画布上，这反过来又会在本地 IDE 的 AWS SAM 模板中创建标记。

![\[使用带有本地 IDE 的基础设施编排器来同步更改。\]](http://docs.aws.amazon.com/zh_cn/infrastructure-composer/latest/dg/images/aac_other_ide_01.gif)


## 将基础架构编排器与本地 IDE 集成
<a name="other-services-ide-steps"></a>

**将基础结构编排器与本地 IDE 集成**

1. 在 Infrastructure Composer 中，创建或加载项目，然后通过选择屏幕右上角的 **“菜单**” 按钮并选择 “激活本地同步” 来**激活本地同步**。
**注意**  
并非所有浏览器都提供 “**激活本地同步**” 选项。它在谷歌浏览器和微软 Edge 中可用。

1. 在本地 IDE 中，打开与基础结构编排器相同的项目文件夹。

1. 在本地 IDE 中使用基础结构编排器。在基础架构编排器中进行的更新将自动与您的本地计算机同步。以下是一些你可以做的事情的例子：

   1. 使用您选择的版本控制系统来跟踪基础设施编排器正在执行的更新。  
![\[在基础架构编排器中进行更改并在本地 IDE 中查看 git 差异。\]](http://docs.aws.amazon.com/zh_cn/infrastructure-composer/latest/dg/images/aac_other_ide_02.gif)

   1. 在本地使用 AWS SAM CLI 来构建、测试、部署应用程序等。要了解更多信息，请参阅[将您的基础架构 Composer 无服务器应用程序部署到云端 AWS](other-services-cfn.md)。  
![\[在本地 IDE 中使用 sam build 和 sam 部署。\]](http://docs.aws.amazon.com/zh_cn/infrastructure-composer/latest/dg/images/aac_other_ide_03.gif)

# 允许网页访问基础设施编排器中的本地文件
<a name="reference-fsa"></a>

基础设施编排控制台支持[本地同步模式](using-composer-project-local-sync.md)和[从 Lambda 控制台导入函数](other-services-lambda.md)。要使用这些功能，需要支持文件系统访问 API 的 Web 浏览器。任何最新版本的 Google Chrome 和 Microsoft Edge 都支持文件系统访问 API 的所有功能，并且可以在 Infrastructure Composer 中与**本地同步**模式一起使用。

File System Access API 允许网页访问您的本地文件系统，以便读取、写入或保存文件。默认情况下，此功能处于关闭状态，需要您通过视觉提示获得许可才能启用。一旦获得授权，此访问权限将在您的网页浏览器会话期间保留。

要了解有关文件系统访问 API 的更多信息，请参阅：
+ *mdn 网络文档*中的@@ [文件系统访问 API](https://developer.mozilla.org/en-US/docs/Web/API/File_System_Access_API)。
+ [文件系统访问 API：简化对 *web.dev 网站*中本地文件的](https://web.dev/file-system-access/)访问。

## 本地同步模式
<a name="reference-fsa-local"></a>

**本地同步**模式允许您在Infrastructure Composer中进行设计时自动同步和保存模板文件和项目文件夹。要使用此功能，需要支持文件系统访问 API 的 Web 浏览器。

## 数据基础架构编排器可以访问
<a name="reference-fsa-access"></a>

Infrastructure Composer 获得对您允许的项目文件夹以及该项目文件夹的任何子文件夹的读写权限。此访问权限用于创建、更新和保存设计时生成的任何模板文件、项目文件夹和备份目录。Infrastructure Composer 访问的数据不用于任何其他目的，也不会存储在本地文件系统之外的任何地方。

### 访问敏感数据
<a name="reference-fsa-access-data"></a>

File System Access API 排除或限制对可能包含敏感数据的特定目录的访问。如果您选择其中一个目录与 Infrastructure Composer *本地同步*模式一起使用，则会出现错误。您可以选择其他本地目录进行连接，也可以在禁用*本地同步*的情况下在默认模式下使用 Infrastructure Composer。

有关更多信息，包括敏感目录的示例，请参阅[用户授予的敏感文件访问权限超出*文件系统访问权限 W3C 草稿社区组报告*中的预](https://wicg.github.io/file-system-access/#privacy-wide-access)期。

如果您使用Windows Subsystem for Linux (WSL)，则由于整个Linux目录位于您的Windows系统中，文件系统访问 API 将无法访问整个目录。您可以在禁用*本地同步*的情况下使用 Infrastructure Composer，也可以配置解决方案，将项目文件从您的WSL目录同步到中的Windows工作目录。然后，使用基础架构编排器*本地同步*模式来处理您的Windows目录。

# 在基础设施编排控制台中本地同步并保存您的项目
<a name="using-composer-project-local-sync"></a>

本节提供有关使用 Infrastruct **ure Composer 的本地同步**模式自动同步项目并将其保存到本地计算机的信息。

出于以下原因，我们建议您使用**本地同步**：

您可以为新项目激活**本地同步**，也可以在激活**本地同步**的情况下加载现有项目。
+ 默认情况下，您需要在设计时手动保存应用程序模板。在您进行更改时，使用**本地同步功能**将应用程序模板自动保存到本地计算机。
+ **本地同步**可管理您的项目文件夹、备份文件夹和[支持的外部文件](using-composer-external-files.md)并将其自动同步到本地计算机。
+ 使用**本地同步**时，您可以将 Infrastructure Composer 与本地 IDE 连接以加快开发速度。要了解更多信息，请参阅[将基础架构编排控制台与本地 IDE 连接起来](other-services-ide.md)。

## 本地同步模式可以保存什么
<a name="reference-features-local-sync-about"></a>

**本地同步**模式会自动同步以下内容并将其保存到本地计算机：
+ **应用程序模板文件**-包含基础架构即代码 AWS Serverless Application Model (IaC AWS SAM) 的 AWS CloudFormation 或 () 模板。
+ **项目文件夹**-用于组织 AWS Lambda 函数的通用目录结构。
+ **Backup 目录** — 名为的备份目录`.aws-composer`，在项目位置的根目录中创建。此目录包含应用程序模板文件和项目文件夹的备份副本。
+ **外部文件**-支持可在基础架构编排器中使用的外部文件。要了解更多信息，请参阅[在基础架构编辑器中引用外部文件](using-composer-external-files.md)。

## 浏览器要求
<a name="reference-features-local-sync-about-browser"></a>

**本地同步**模式需要支持文件系统访问 API 的浏览器。有关更多信息，请参阅 [允许网页访问基础设施编排器中的本地文件](reference-fsa.md)。

## 激活本地同步模式
<a name="reference-features-local-sync-activate"></a>

默认情况下，**本地同步**模式处于停用状态。您可以通过基础设施编辑器**菜单**激活**本地同步**模式。

![\[选中 “激活本地同步” 的 “基础设施编排器” 菜单。\]](http://docs.aws.amazon.com/zh_cn/infrastructure-composer/latest/dg/images/aac_ref_16.png)


有关激活**本地同步**和现有加载项目的说明，请参阅以下主题：。
+ [在基础设施编辑器中激活本地同步](using-composer-how-to-locally-sync.md)
+ [加载已激活本地同步的现有基础架构编排器项目](using-composer-how-to-load-with-local-sync.md)

# 在基础设施编辑器中激活本地同步
<a name="using-composer-how-to-locally-sync"></a>

要激活本地同步，请完成以下步骤：

1. 在基础设施编排器**[主页](reference-visual.md#reference-visual-home)**上，选择**创建项目**。

1. 从 “基础设施编排**” 菜单中**，选择 “**激活本地同步**”。

1. 在 “**项目位置**” 中，按**选择文件夹**，然后选择一个目录。基础设施编排器将在您设计时保存和同步您的模板文件和文件夹。
**注意**  
项目位置不得包含现有的应用程序模板。

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

1. 按**激活**。当系统提示保存更改时，选择**保存更改**。

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

# 加载已激活本地同步的现有基础架构编排器项目
<a name="using-composer-how-to-load-with-local-sync"></a>

要加载已激活本地同步的现有项目，请完成以下步骤：

1. 在基础设施编排器**[主页](reference-visual.md#reference-visual-home)**上，选择**加载 CloudFormation 模板**。

1. 从 “基础架构编辑器**” 菜单中**，选择 “**打开**” > “**项目文件夹”**。

1. 对于**项目位置**，按**选择文件夹**，然后选择项目的根文件夹。

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

1. 对于**模板文件**，选择您的应用程序模板并按**创建**。

1. 当系统提示保存更改时，选择**保存更改**。

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

# 从 Lambda 控制台将函数导入基础设施编排器
<a name="other-services-lambda"></a>

基础架构编排器提供了与 AWS Lambda 控制台的集成。您可以将 Lambda 函数从 Lambda 控制台导入到基础设施编排控制台。然后，使用基础设施编排器画布进一步设计您的应用程序架构。
+ 此集成需要支持文件系统访问 API 的浏览器。有关更多信息，请参阅 [允许网页访问基础设施编排器中的本地文件](reference-fsa.md)。
+ 将 Lambda 函数导入基础设施编排器时，必须激活本地同步模式才能保存所有更改。有关更多信息，请参阅 [在基础设施编排控制台中本地同步并保存您的项目](using-composer-project-local-sync.md)。

要开始使用此集成，请参阅《*AWS Lambda 开发人员指南》 AWS 基础架构编辑器*中的 “[AWS Lambda 与一起使用](https://docs.aws.amazon.com/lambda/latest/dg/services-appcomposer.html)”。

# 导出基础设施编排器可视画布的图像
<a name="reference-features-export"></a>

本主题介绍 AWS 基础架构编辑器 控制台**导出画布**功能。

有关基础设施编排器所有功能的直观概述，请参阅[AWS 基础架构编辑器 控制台视觉概述](reference-visual.md)。

## 关于导出画布
<a name="reference-features-export-about"></a>

**导出画布**功能将应用程序的画布作为图像导出到本地计算机。
+ Infrastructure Composer 会移除可视化设计器用户界面元素，并仅导出应用程序
+ 默认图像文件格式为`png`。
+ 该文件将导出到本地计算机的默认下载位置。

您可以从**菜单**访问**导出画布**功能。

![\[已选择 “导出” 画布的 “基础架构编排器” 菜单。\]](http://docs.aws.amazon.com/zh_cn/infrastructure-composer/latest/dg/images/aac_ref_13.png)


## 导出画布
<a name="reference-features-export-canvas"></a>

导出画布时，基础设施编排器会显示一条状态消息。

如果导出成功，您将看到以下消息：

![\[已选择 “导出” 画布的 “基础架构编排器” 菜单。\]](http://docs.aws.amazon.com/zh_cn/infrastructure-composer/latest/dg/images/aac_ref_14.png)


如果导出失败，您将看到一条错误消息。如果您收到错误消息，请再次尝试导出。

![\[已选择 “导出” 画布的 “基础架构编排器” 菜单。\]](http://docs.aws.amazon.com/zh_cn/infrastructure-composer/latest/dg/images/aac_ref_15.png)