部署代理程序必备基础结构

IBM Cloud® Schematics 的代理程序可扩展其直接工作到专用网络上或任何隔离网络区域中的云基础结构的能力。

先决条件

在开始部署代理程序基础结构之前，必须满足以下先决条件。

Schematics 提供了可用于供应代理程序所需的基础结构的样本模板。代理程序基础结构由以下资源组成。

VPC 基础架构作为 public_gateways，subnets。
IBM Cloud® Kubernetes Service 或 Red Hat OpenShift Kubernetes Service 作为 vpc_kubernetes_cluster。

要支持 Red Hat OpenShift Kubernetes Service上的代理程序，您可以根据需求通过安全组和网络访问控制表 (ACL) 来控制出口流量。在集群上部署代理程序之前，需要在 VPC 级别定义任何 Network Security Groups 规则和 ACL。有关更多信息，请参阅 Terraform 脚本以在 VPC 上定义安全组和 ACL。

登录 IBM Cloud控制台。
单击菜单图标>Platform Automation>Schematics>Terraform>Create workspace（创建工作区），使用以下输入创建代理基础架构工作区。
- 在 指定模板 部分中:
  - GitHub、GitLab 或 Bitbucket 存储库 URL- https://github.com/Cloud-Schematics/agent-infrastructure-sample/tree/main/templates/infrastructure。
  - 个人访问令牌- <leave it blank>。您可以点击 Open reference picker 选择您的 Secrets Manager 密钥参考。更多信息，请参阅创建 Secrets Manager 实例。
  - Terraform 版本- terraform_v1.5。您需要选择 Terraform 版本 1.5 或更高版本。
  - 单击 Next。
- 在工作区详细信息部分输入
  - 工作空间名称 为 schematics-agent-infrastructure。
  - 标记为 agents-infra。
  - 资源组 作为 default 或此工作空间的其他资源组。有关更多信息，请参阅创建资源组。您必须具有资源组的访问许可权。
  - 位置作为此工作空间的 North America 或其他区域。如果用于代理程序基础结构和代理程序服务的位置不匹配，那么不会将日志发送到 LogDNA。
  - 单击 Next。
  - 请检查输入的信息是否正确以创建工作空间。
- 单击 Create。
成功创建 schematics-agent-infrastructure 工作空间时，请查看并编辑工作空间“设置”页面中的 agent infrastructure 输入变量。

代理程序基础结构和工作空间可以位于不同的资源组和位置中。可以在任何 Schematics 支持的区域中定义代理程序基础结构工作空间。

Schematics 代理程序基础结构输入
输入变量	数据类型	必需/可选	描述
`agent_prefix`	String	`Required`	提供用于命名代理程序 VPC，集群和日志记录配置的前缀。
`location`	字符串	`Required`	将在其中创建代理程序基础结构 VPC 和集群中的区域。
`resource_group_name`	字符串	`Required`	用于代理程序基础结构和代理程序关联的资源组的名称。例如，`test_agent`。有关更多信息，请参阅创建资源组。您必须具有资源组的访问许可权。
`ibmcloud_api_key`	字符串	`Optional`	用于供应 Schematics 代理程序基础结构资源的 IBM Cloud API 密钥。如果未提供，那么将供应当前已登录的用户凭证中的资源。
`tags`	List (String)	`Optional`	要应用于已部署，VPC 和集群的用户标记的列表。例如，`myproject:agent` 或 `test:agentinfra`。您可以使用标记名称更快地查看代理程序的供应资源。

单击 schematics-agent-infrastructure 工作空间上的 应用计划 以供应代理程序基础结构。配置所有资源最多需要 45-90 分钟。
查看“作业”日志和“资源”页面以监视成功供应的资源，并验证工作空间状态现在是否为 ACTIVE。

从“作业”日志的 Outputs: 部分记录 cluster_id 和 logdna_name。部署代理程序时使用此信息。如果作业失败，并且您未在“作业”日志中观察到 cluster_id 详细信息，那么必须具有 IAM 许可权才能创建 VPC Infrastructure 和 Kubernetes cluster 服务。然后，单击 应用计划 以重新部署代理程序基础结构。

执行以下步骤以查看“代理程序基础结构”工作空间设置。

浏览至“资源列表”页面。
验证是否从资源列表页面供应了以下资源。
- VPC> 搜索 <agent_prefix>-vpc 状态为可用。
- 服务和软件 > <agent_prefix>-logdna 状态为活动。
- 集群 > <agent_prefix>-iks 状态为正常。
可选，您可以使用在“资源列表”页面中指定的用户标记来搜索供应的资源。

您已完成 Schematics 代理程序基础结构设置。