Skip To Content

使用 CloudFormation 在主-备用模式下部署 ArcGIS Data Store

Esri arcgis-datastore-primarystandby.template.json Amazon Web Services (AWS) CloudFormation 模板可在两个 Amazon Elastic Compute Cloud (EC2) 实例(主实例和备用实例)上创建关系或切片缓存 ArcGIS Data Store,可为 ArcGIS Data Store 部署提供高可用性。

使用此模板时,您具有以下备份存储选项:

  • Amazon Simple Storage Service (S3) 中存储备份文件。
  • 在单独的文件服务器(EC2 实例)上存储备份文件。

此模板可在 Amazon Web Services 中创建以下架构:

位于两个 EC2 实例(主实例和备用实例)上的关系或切片缓存数据存储

在上图中,备份显示在 EC2 文件服务器或 S3 存储段中;备份不会同时在两个位置创建。

许可:

示意图中的某些图标需在得到 Amazon Web Services 权限后方可使用。

提示:
使用此模板作为使用 CloudFormation 在不同的计算机上部署 ArcGIS Enterprise 组件中描述的创建 ArcGIS Enterprise 部署的一部分。

先决条件

先决条件可以按照您必须获取的项目(例如文件和帐户)以及在运行 CloudFormation 模板之前必须执行的任务来进行分组。

必需项目

运行此模板之前,您需要以下内容:

  • Amazon Web Services 帐户。

    帐户必须可以访问基础 AWS 服务(例如 CloudFormationAmazon Elastic Compute Cloud (EC2)Amazon Virtual Private Cloud (VPC)Amazon Simple Storage Service (S3)Systems ManagerAmazon CloudWatchLambdaAWS Identity and Access Management (IAM)Amazon DynamoDBSecrets ManagerAWS Certificate ManagerAmazon Relational Database Service (RDS))。

  • 如果您在 AWS GovCloud 中的 Ubuntu EC2 实例上创建部署,则需要 AMI Id。 如果想要使用基础的标准 Ubuntu AMI,请按照 Esri Amazon Web Services CloudFormation 模板中的说明识别 ID。
  • Amazon Virtual Private Cloud (VPC) 和子网。

    您可以使用以下 CloudFormation 模板之一来创建 VPC包含两个公共子网的 VPC包含两个公共子网和私有子网(含 NAT 网关)的 VPC

  • CloudFormation 模板。

    arcgis-datastore-primarystandby.template.json 模板打开并保存本地副本

必需任务

运行此模板之前,请完成以下任务:

  • 您必须具有将作为 ArcGIS Enterprise 门户的托管服务器使用的 ArcGIS GIS Server 站点。 请确保此站点的类型与您将使用此模板创建的注册到此站点的 ArcGIS Data Store 类型不同。

    您可以使用单机 ArcGIS Server 站点模板多机 ArcGIS Server 站点模板创建此站点。

  • AWS Secrets Manager 中配置密码(此为可选项,但建议选择)。

    您可以在 AWS Secrets Manager 中配置帐户的密码,例如站点管理员用户名和 Windows arcgis 用户密码。 将为您提供密钥的 Amazon 资源名称 (ARN)。 启动堆栈时,在模板参数中使用 ARN 代替密码。 如果您不使用 AWS Secrets Manager 存储密码,则必须在启动堆栈时在模板参数中输入纯文本密码。

    注:

    当您在 AWS Secrets Manager 中创建一个密钥 ARN 以用于与 Esri CloudFormation 模板配合使用的密码时,必须使用其他密钥类型作为密钥类型,然后使用纯文本选项。 有关创建用于密码的 Amazon 资源名称的详细信息,请参阅 AWS CloudFormation 和 ArcGIS

提示:

默认情况下,如果堆栈创建失败,CloudFormation 将删除部分创建的资源。 这十分有用,因为此操作从帐户中移除了无法使用的部署,但是可能使故障排除变得困难。 要在失败状态下保留堆栈,请在启动堆栈之前禁用失败时回滚 CloudFormation 堆栈创建选项。 有关详细信息,请参阅 AWS 帮助中的设置 AWS CloudFormation 选项

参数

有关此 CloudFormation 模板中所使用参数的描述,请参阅下表。 已按参数类型对表进行分组。

Amazon EC2 Configuration

参数名称是否为必需项?参数说明

Platform Type

必需项

选择操作系统平台。 支持的类型如下:

  • Windows (Windows Server 2019)
  • Linux (Ubuntu Server 18.0.4 LTS)

EC2 Instance AMI ID

可选

您可以将此参数值留空。 如果您这样做,CloudFormation 模板将基于您选择的平台类型使用 WindowsUbuntu 的最新 Amazon Machine Image (AMI) ID。

注:

如果您在 Ubuntu Server 上的 AWS GovCloud 中进行部署,则不可以将此参数留空。 有关从 Canonical 为基础 Ubuntu AMI 查找 ID 的说明,请参阅 Esri Amazon Web Services CloudFormation 模板

首次使用特定版本的默认 AMI 时,您必须接受 AWS Marketplace 条款

如果您想要使用自己的自定义 AMI,可以使用以下方式之一输入 AMI ID。

  • 'ami-xxxxx' 格式提供 AMI ID。
  • 如果您将 AMI ID 存储在 AWS SSM 参数存储中,请以 AWS'{{resolve:ssm:[a-zA-Z0-9_.-/]+:\d+}}' 格式提供 SSM 参数名。

如使用自定义 AMI,请确保其满足以下要求:

  • 必须已激活 EC2 实例元数据服务(版本 V2 或 V1)。
  • 必须安装最新版本的 AWS Systems Manager Agent (SSM)。
  • 如果自定义 AMI 具有 Windows 操作系统,则必须安装用于 PowerShellAWS

EC2 Instance Keypair Name

必需项

选择 EC2 密钥对名称以允许远程访问 EC2 实例。

Amazon VPC Configuration

参数名称是否为必需项?参数说明

VPC ID

必需项

选择 VPC ID。

注:

此参数的 VPC 必须与您要将此数据存储添加到的 ArcGIS GIS Server 站点相同。

Subnet ID 1

必需项

选择子网 ID。 您选择的子网 ID 必须在您在上方选择的 VPC 中。

如果您已使用 Esri CloudFormation 模板来创建 VPC,则可以从模板输出参数获取子网 ID。

Subnet ID 2

必需项

选择第二个子网 ID。 此 ID 必须是不同于 Subnet ID 1 的子网 ID。 您选择的子网 ID 必须在您为此部署指定的 VPC 中。

如果您已使用 Esri CloudFormation 模板来创建 VPC,则可以从模板输出参数获取子网 ID。

ArcGIS Server Configuration

参数名称是否为必需项?参数说明

Site Administrator User Name

必需项

提供将用作门户托管服务器的 ArcGIS GIS Server 站点的 ArcGIS Server 主站点管理员的用户名。

Site Administrator User Password

必需项

提供 ArcGIS Server 主站点管理员的密码。 您可以输入纯文本密码或 AWS Secrets Manager 中您的密钥 ID 的 ARN。 有关创建用于密码的 Amazon 资源名称的详细信息,请参阅 AWS CloudFormation 和 ArcGIS

您所提供的密码或密钥 ID 必须与现有的主站点管理员匹配。

ArcGIS Server EC2 Instance ID

必需项

选择配置 ArcGIS Server 站点的 EC2 实例 ID。

注:
如果要将数据库注册到多机 ArcGIS Server 站点,可以从 ArcGIS Server 站点选择任意 EC2 实例 ID。 请勿选择文件服务器 EC2

ArcGIS Data Store Configuration

参数名称是否为必需项?参数说明

Type

必需项

选择要在主-备用模式下部署的 ArcGIS Data Store 类型。 有效值为 relational 或 tileCache。

提示:

要创建时空大数据存储,请使用单机数据存储集群数据存储模板。

EC2 Instance Type

必需项

选择要为 ArcGIS Data Store 实例使用的 EC2 实例类型。 默认值为 m5.2xlarge。

实例将配置 AWS 自动恢复功能

EC2 Instance Root Drive Disk Space

必需项

提供根驱动器的大小(以 GB 为单位)。 默认值为 100 GB。 最小值为 100 GB。 最大值为 1024 GB。

Windows arcgis user password

条件分析

提供 arcgis 用户的密码。 仅在 Windows 中进行部署时,才需要此密码。

您可以输入纯文本密码或 AWS Secrets Manager 中您的密钥 ID 的 ARN。

最佳做法是在 AWS Secrets Manager 中管理您的密码。 有关创建用于密码的 Amazon 资源名称的详细信息,请参阅 AWS CloudFormation 和 ArcGIS

Backup Store Type

必需项

选择 ArcGIS Data Store 备份存储类型。 默认类型为 FileSystem

  • FileSystem - ArcGIS Data Store 备份存储在 ArcGIS 文件服务器 EC2 实例中。
  • CloudStore - ArcGIS Data Store 备份存储在此堆栈创建的 Amazon S3 存储段中。

Backup Store EC2 Instance Type

条件分析

ArcGIS Data Store 备份计算机选择 EC2 实例类型。 默认实例类型为 m5.2xlarge。

注:

仅当您指定 FileSystem 作为备份存储类型时,才需要此项。

Backup Store EC2 Instance Root Drive Disk Space

条件分析

提供根驱动器的大小(以 GB 为单位)。 默认值为 100 GB。 最小值为 100 GB。 最大值为 1024 GB。

注:

仅当您指定 FileSystem 作为备份存储类型时,才需要此项。

输出

当您的堆栈成功创建后,可以在 AWS Management Console 中的 CloudFormation 堆栈的输出选项卡看到以下输出参数。

输出名称输出描述

DeploymentLogsURL

这是 Amazon CloudWatch 日志的 URL,其中存储了所有部署日志。 如果部署失败,您可以参考这些日志以进行故障排除。

StopStackFunctionName

这是停止堆栈 Lambda 函数 URL。 您可以使用此 lambda 函数停止堆栈中的所有 EC2 实例。

StartStackFunctionName

这是开始堆栈 Lambda 函数 URL。 您可以使用此 lambda 函数开始堆栈中的所有 EC2 实例。

注意事项

创建包含 ArcGIS 部署的 CloudFormation 堆栈后,需要考虑以下几项重要内容:

  • 请勿删除此 CloudFormation 模板创建的任何 AWS 资源。 如果您想要了解此模板创建了哪些 AWS 资源,请在 AWS Management Console 中查看此堆栈的资源选项卡。 Esri CloudFormation 模板创建的每个资源还具有元数据标签。 但是,一些资源不会在 AWS Management Console 中显示标签。
  • 您可以使用堆栈输出中显示的 AWS Lambda 函数(在此页面的“输出”部分中列出)在不使用时停止此堆栈中的 EC2 实例,并在需要时重新启动。 此函数对于帮助您管理成本十分有用。

    当您运行 Lambda 函数以停止部署中 EC2 实例时,函数将返回消息提示实例已停止。 但是如果实例已加入自动伸缩组,函数还必须将实例从组中分离。 此过程可能需要花费 10 分钟才能完成。 因此,在您运行 Lambda 启动函数以重新启动部署之前,请至少等待 10 分钟。

疑难解答

如果您在创建此 CloudFormation 堆栈时发现任何故障,请参阅 AWS 上的 ArcGIS 部署疑难解答