使用Visual Studio Code扩展启用可部署架构
您可以通过使用IBM Cloud来 启动您的可部署架构。可部署架构生成器Visual Studio Code扩展。 使用扩展功能可以自动生成所需的材料,避免或减少用户每次通过目录运行验证时都要进行单独配置的问题。 该扩展可帮助您轻松地将可部署架构加入到私有目录和项目中。
准备工作
在启用可部署架构之前,请确保完成以下先决条件。
- 下载 Visual Studio Code
- 确认您使用的是“即用即付”或“订阅”账户。 有关详细信息,请参阅 查看账户类型。
- 验证您是否拥有处理专用目录和可部署架构所需的权限。
- IBM Cloud Schematics 服务上的管理员角色
- 目录管理服务的编辑角色
- 账户中所有资源组的查看器角色
- SecretsReader 服务上的 Secrets Manager 角色,如果你计划将安全值存储在 Secrets Manager 实例中的话
- Security and Compliance Center 服务上的读者角色
- 自定义可部署架构中特定资源所需的其他角色。
- 确保将可部署架构的源代码存储在 GitHub 中。 有关将源代码导入版本库的帮助,请参阅 设置源代码版本库。
- 公共或私有 GitHub版本库中的 Terraform 模块,克隆到本地文件夹。 为便于实验,可将此 示例 Terraform 模块 分叉。 如果您的版本库是私有的,您需要一个具有
repo
和read:user
权限的个人访问令牌。
获取 VS 代码扩展
要获取扩展,请打开 VS Code,转到扩展,搜索并选择 IBM CloudDeployable Architecture Builder 下载。 下载后,您可以按照指南开始操作,或使用以下步骤。 如果演示程序没有自动打开,可以使用命令调板。 转到“视图”>“命令调板”。 搜索 Walkthrough
,单击欢迎光临:公开演练...,然后选择开始使用IBM Cloud可部署架构生成器。
启用可部署架构
首次验证可部署架构时,需要执行将其加入IBM Cloud步骤。 使用以下步骤启用可部署架构:
- 登录到 IBM Cloud 帐户。
- 要登录账户,请单击“查看” 并选择“命令调板”。
- 在搜索栏中,搜索
IBM Cloud - Log in
。 - 选择 IBM Cloud- Log in,然后使用 API 密钥、联合 ID 或用户名和密码登录。
- (可选)您可以更改登录环境。 Click 查看, select 命令调色板, search for
IBM Cloud - Log in
, and select IBM Cloud- Log in > Change login environment. 从菜单中选择生产或暂存。
- 确保已从 VS Code 登录GitHub。
- 选择
> 登录到同步设置。
- 选择您的账户。
- 单击 Authorize Visual-Studio-Code.
- 选择
- 克隆你的软件仓库,并将其添加到 VS Code 工作区。
- 从GitHub 克隆你的可部署架构 repo。
- 要将其添加到 VS Code 中的工作区,请单击文件 > 将文件夹添加到工作区...,然后从文件中选择 repo。
- 将目录清单文件添加到 Terraform 模块。
- 要添加目录清单,请右键单击工作区中的模块文件夹。
- 选择 IBM Cloud> 添加可部署的架构清单文件。
- 启用并验证可部署架构。
- 右键单击
ibm_catalog.json
文件,然后选择 IBM Cloud> 验证IBM Cloud上的可部署架构。 - 选择 repo 分支。 或者,您可以单击 + 并输入将创建的新名称。
- 选择现有的私有目录。 或者,您可以单击 + 并输入将创建的新名称。
- 输入提供的版本。
- 选择一个现有项目。 或者,您可以单击 + 并输入将为您创建的新名称。
- 输入您的IBM Cloud将部署资源的账户的 API 密钥。
- 输入结构图的相对路径。 如果您没有图表,我们会提供一个占位符。
- (可选)如果 GitHub 仓库是私有的或在 GitHub Enterprise 中,请输入您的个人访问令牌。
- YAML 输入文件已打开。 编辑
inputs
属性下的值并保存文件。 - 点击继续
- 右键单击
验证开始时,会打开一个显示验证日志的输出通道。 如果没有,请在“输出”视图中从菜单中选择 DA Validation
频道。 验证可能需要几分钟才能完成。