此 arcgis-ami-linux.template.json Amazon Web Services (AWS) CloudFormation 模板可创建一个包含 Linux 操作系统和您选择的 ArcGIS Enterprise 组件的 Amazon Machine Image (AMI)。
有关受支持的 Linux 操作系统的列表，请参阅使用 CloudFormation 在 AWS 上部署 ArcGIS 时受支持的操作系统。
先决条件
先决条件可以按照您必须获取的项目（例如文件和帐户）以及在运行 CloudFormation 模板之前必须执行的任务来进行分组。
必需项目
您需要以下内容才能运行模板：
- Amazon Web Services 帐户。
帐户必须可以访问基础 AWS 服务（例如 CloudFormation、Amazon Elastic Compute Cloud (EC2)、Amazon Virtual Private Cloud (VPC)、Systems Manager、Amazon CloudWatch、AWS Identity and Access Management (IAM) 和 Secrets Manager。
- Amazon Virtual Private Cloud (VPC) 和子网。
您可以使用以下 CloudFormation 模板之一来创建 VPC：包含两个公共子网的 VPC 或包含两个公共子网和私有子网（含 NAT 网关）的 VPC。
所选 Linux 操作系统的 AMI ID（请参阅上方列出的受支持的 Linux 操作系统）。 您可以通过 Amazon Web Services Management Console 获取 AMI ID。 如果您使用 AWS Marketplace 中的 AMI，则必须先进行订阅以使用 CloudFormation，然后才能将其用于此 CloudFormation 模板。
- arcgis-ami-linux.template.json CloudFormation 模板。
必需任务
确保已在您计划使用的基础 AMI 中安装 AWS Systems Manager 代理，以便使用此 CloudFormation 模板创建 ArcGIS Enterprise AMI。 默认情况下，AWS Systems Manager 代理将安装在 AWS 基础 Ubuntu AMI 上。 但如果您计划使用 AMI 而非 AWS 基础 Ubuntu AMI，则必须在基础 Linux 操作系统 AMI 中配置 AWS Systems Manager 代理。 按照下方的步骤在基础 Linux 操作系统 AMI 中安装 AWS Systems Manager。
- 使用 AWS Management Console 从基础 AMI 创建 Amazon Elastic Compute Cloud (EC2) 实例。
- 在您在上一步中创建的 EC2 实例上安装 AWS Systems Manager 代理。
请参阅 AWS 文档中的说明。
- 使用 AWS Management Console 从 EC2 实例创建 AMI。
- 使用您上一步骤在此 CloudFormation 模板中创建的 AMI 创建 ArcGIS Enterprise AMI。
参数
有关此 CloudFormation 模板中所使用参数的描述，请参阅下表。 已按参数类型对表进行分组。
Amazon EC2 配置
| 参数名称 | 是否为必需项？ | 参数说明 |
|---|---|---|
Source Amazon Machine Image (AMI) ID | 必填 | 提供源 Amazon Machine Image (AMI) ID。 有关受支持的 Linux 操作系统的列表，请参阅使用 CloudFormation 在 AWS 上部署 ArcGIS 时受支持的操作系统。 如果您使用 AWS Marketplace 中的基础 AMI，则必须在将其用于此模板之前使用该 AMI 进行订阅。 确保已在源 AMI 中配置 AWS Systems Manager。 |
Target AMI name | 必填 | 提供 AMI 的名称。 必须以字母开头。 名称必须是字母数字，并且可以包含下划线 (_) 或破折号 (-)。 最小长度为 6 个字符，最大长度为 127 个字符。 AMI 名称必须唯一。 |
Target AMI description | 必填 | 提供 AMI 的描述。 必须以字母开头。 描述必须是字母数字，并且可以包含下划线 (_)、大括号 ({}) 和冒号 (-)。 最小长度为 6 个字符，最大长度为 255 个字符。 默认 AMI 描述为 EsriLinuxAmi_from_{{SourceAmiId}}_on_{{global:DATE_TIME}}。 如果您使用默认描述，则 {{SoureAmiId}} 将替换为源 Amazon 机器镜像 ID 参数值，而 {{global:DATE_TIME}} 将替换为创建 AMI 的日期和时间。 |
EC2 Instance Type | 必填 | 指定 EC2 实例类型。 默认值为 m5.2xlarge。 实例类型必须至少具有 4 个 vCPU 和 8 GB RAM。 |
Device Name for EBS Volume | 必填 | 选择镜像中包含的 EBS 卷的设备名称。 您必须选择通过源 Amazon 机器镜像 ID 参数指定的 AMI 所使用的同一设备名称。 可用值如下：
|
EBS Volume Size | 必填 | 指定将包含在镜像中的 EBS 卷的大小（以 GB 为单位）。 确保此大小等于或大于附加到您为 Source Amazon Machine Image (AMI) ID 参数指定的源 AMI 的快照卷大小。 |
EC2 Instance Keypair Name | 必填 | 选择 EC2 密钥对名称以允许远程访问 EC2 实例。 |
VPC ID | 必填 | 选择 VPC ID。 如果需要创建 VPC，可以使用其中一个 VPC 示例模板：包含公共子网的 VPC 或 包含公共和私有子网及 NAT 网关的 VPC。 |
Subnet ID | 必填 | 选择子网 ID。 您选择的子网 ID 必须在您在上方选择的 VPC 中。 如果您已使用 Esri CloudFormation 模板来创建 VPC，则可以从模板输出参数获取子网 ID。 |
ArcGIS 软件配置
| 参数名称 | 是否为必需项？ | 参数说明 |
|---|---|---|
ArcGIS Enterprise Component | 必填 | 选择要在 AMI 上安装的 ArcGIS Enterprise 组件。 可用值如下：
注：当您选择 ArcGIS Enterprise 基础时，Portal for ArcGIS 将在上下文名称门户中包含 ArcGIS Web Adaptor，ArcGIS Server 将在上下文名称服务器中包含 ArcGIS Web Adaptor，且 ArcGIS Data Store 将安装在 AMI 上。 |
ArcGIS GeoEvent Server | 可选 | 选择是否安装 ArcGIS GeoEvent Server。 可用值为 true 或 false。 注：仅当您将 ArcGIS Enterprise 组件参数设置为 ArcGIS Enterprise 基础或 ArcGIS Server 时，才会使用此参数。 |
ArcGIS Web Adaptor | 可选 | 选择是否安装 ArcGIS Web Adaptor。 可用值为 true 或 false。 注：此参数将在您将 ArcGIS Enterprise 组件参数设置为以下任意值时被忽略：
|
ArcGIS Web Adaptor Name | 条件分析 | 提供 ArcGIS Web Adaptor 上下文名称。 此名称将显示在门户、ArcGIS Server 或 ArcGIS Mission Server URL 中。 名称必须以字母为开头并且仅包含字母数字字符。 如果将 ArcGIS Web Adaptor 参数设置为 true，则此参数是必需的，如果将 ArcGIS Web Adaptor 参数设置为 false，则此参数将被忽略。 |
输出
当您的堆栈成功创建后，可以在 AWS Management Console 中的 CloudFormation 堆栈的输出选项卡看到以下输出参数。
| 输出名称 | 输出描述 |
|---|---|
TargetAMIName | 使用此 CloudFormation 模板创建的 AMI 的名称。 您可以使用 AMI 名称在 AWS Management Console 中检索 AMI ID。 |
DeploymentLogsURL | 这是 Amazon CloudWatch 日志的 URL，其中存储了所有部署日志。 如果部署失败，您可以参考这些日志以进行故障排除。 |
注意事项
创建自定义 AMI 的 CloudFormation 堆栈后，需要考虑以下几项重要内容：
- 此模板将创建 CloudFormation 堆栈和自定义 AMI。
- 创建 CloudFormation 后，可使用 TargetAMIName CloudFormation 输出参数值从 AWS Management Console 检索 AMI ID。
- 您可以在创建 AMI 后删除 CloudFormation 堆栈。 将不会删除使用 CloudFormation 堆栈创建的 AMI。 要删除堆栈（或 AMI），请使用 AWS Management Console。
疑难解答
如果您在创建此 CloudFormation 堆栈时发现任何故障，请参阅 AWS 上的 ArcGIS 部署疑难解答。