ArcGIS Enterprise Cloud Builder Command Line Interface for Amazon Web Services (AWS) 实用程序中的 CREATE 命令可用于创建基础 ArcGIS Enterprise 部署,还可以选择为每个 ArcGIS Server 许可角色创建一个附加的联合计算机。运行该命令创建初始部署后,可以稍后再次运行该命令添加更多 ArcGIS Server 站点。
注:
运行 CREATE 命令之前,请验证您的 AWS 组织是否有足够的可用资源供部署创建新的计算机。如果新部署超出组织的限制,该命令将失败。
您可以从 CreateSamples 文件夹打开一个 Esri 示例 JSON 文件的副本,然后修改它以包含您的参数。例如,要构建针对栅格分析优化的部署,请选择 baseenterpriseallinonewithra.json 文件。
或者,您还可以使用从 ArcGIS Enterprise Cloud Builder for AWS 应用程序中下载的摘要 JSON 文件作为新部署的模板。但是,无法使用 ArcGIS Enterprise Cloud Builder CLI for AWS 来添加使用 ArcGIS Enterprise Cloud Builder for AWS 应用程序创建的部署。
必须先执行 AWS Management Console 中的几个步骤,然后再执行 CREATE 命令。您需要使用这些步骤的结果作为 JSON 文件中的参数设置。
- 使用您在准备部署时指定的相同帐户登录 AWS Management Console 。请确保您所在的区域与在上一部分中使用 "AWSRegion" 参数指定的区域相同。
- 对于单机 ArcGIS Enterprise 基础部署和 ArcGIS GeoEvent Server 计算机,请在 AWS 中为 Amazon Virtual Private Cloud (VPC) 分配一个新的弹性 IP 地址。复制采用 eipalloc-xxxxxxxx 格式的对应 Allocation ID。在 JSON 文件中,粘贴该 ID 作为 BaseEnterprise 下 SiteEIPAllocationID 参数的值。
如果您正在创建单机 ArcGIS Enterprise 基础部署,请继续步骤 5。
- ArcGIS Server 和高可用性 ArcGIS Enterprise 部署都需要负载均衡器。您可以按照以下所述创建负载均衡器,也可以使用现有负载均衡器。如果您要使用现有负载均衡器,请继续执行步骤 4。
- 如果您的组织使用 Amazon Route 53 来管理组织的域名服务 (DNS),并且您的 AWS 帐户具有管理 DNS 的权限,则 ArcGIS Enterprise Cloud Builder CLI for AWS 实用程序可以为您创建一个负载均衡器。此配置并不常见,因此如果您不确定您是否拥有此配置和权限,您可能需要首先创建负载均衡器。
- 可使用 Esri 示例 AWS CloudFormation 模板(建议选项)创建负载均衡器或在 AWS Management Console 中创建一个。如果购买了 AWS 之外的域名,则必须先将该域映射到负载均衡器,然后再使用该实用程序创建部署。如果使用 AWS Management Console 创建负载均衡器,请确保使用与您的部署相同的 VPC 并使用 HTTPS 侦听器配置负载均衡器。
ArcGIS Enterprise Cloud Builder CLI for AWS 实用程序可以将您已创建的负载均衡器与 CloudFormation 模板配合使用,或者在 AWS Management Console 中使用您已创建的负载均衡器。
创建负载均衡器后,请记住生成的 DNS 名称,该名称的结尾为 *.elb.amazonaws.com。需要在下一步中使用此信息。
- 将负载均衡器的 DNS 名称映射到您的域。如果您正在使用 AWS Route 53 服务,请导航到该页面;如果您尚未这样做,请先注册一个域,然后使用所需站点域名创建一个记录集。如果您使用其他服务进行 DNS 映射,请浏览到该站点。无论哪种情况,都需要将基础部署站点名称的类型设置为 CNAME 并将您在第 2 步中获取的 DNS 名称粘贴为值。重复此步骤,将每个负载均衡器的 DNS 名称映射到每个 ArcGIS Server 站点。
例如,如果要构建针对栅格分析优化的部署,则需要将为栅格分析服务器创建的负载均衡器的 DNS 名称映射到 ArcGIS Image Server 站点。
- 将站点域名(如 base.domain.com 和 raster.domain.com)和附加负载均衡器的名称值添加到 JSON 文件作为对应部分中 SiteDomain 的值。
例如,修改 baseenterpriseallinonewithra.json 示例文件时,需要在 "Default" 部分中设置 VPC ID 值。需要在 "BaseEnterprise" 和 "RasterAnalytics" 部分中设置其他值,如下所示:
"Default" :{ "VPCId": "vpc-0011xxxxx", "DriveSizeRoot": "100", "KeyName": "YOURKEYNAME", "FSInstanceType": "m4.xlarge", "ASInstanceType": "m4.xlarge", "SecondaryInstances": "2", "BDSInstanceType": "m4.xlarge", "BDSInstances": "0", "DBEngine": "postgres", "DBInstanceClass": "db.m4.large", "DBAllocatedStorage": "200", "DeploymentBucket": "enterprisefiles", "StoreType": "CloudStore", "SiteAdmin": "admin", "SiteAdminPassword": "changeit", "RunAsUserPassword": "P@ssw0rd123", "SSLCertificateFile": "wildcard_yourdomain_com.pfx", "SSLCertPassword": "AvertUR1s", "SSLCertificateARN": "arn:aws:acm:ap-northeast-1:123456789123:certificate/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "PostInstallationScript": "none" }, "BaseEnterprise":{ "SiteEIPAllocationID": "eipalloc-xxxxxxxx", "InstanceType": "m4.xlarge", "SiteDomain": "basedep.yourdomain.com", "PortalLicenseFile": "Your_Portal_License.json", "UserLicenseTypeID" : "My_User_Type_UT" "ServerLicenseFile": "Your_GIS_Server_License.prvc", "Type": "AllInOne" }, "RasterAnalytics":{ "ServerLicenseFile": "Your_Image_Server_License.prvc", "ELBName": "your-raster-elb", "SiteDomain": "raster.yourdomain.com", "CloudStoreS3BucketPath": "yourbucket/yourfolder", "Federate":true, }
- 在 AWS 中创建密钥对。将该密钥对名称添加到 JSON 文件作为 KeyName 参数的值。
- 在 JSON 文件中,根据需要修改其余参数。有关说明,请参阅 ArcGIS Enterprise Cloud Builder CLI for AWS 的完整参数列表。
- 保存修改后的 JSON 文件。返回到命令提示符控制台,然后运行 CREATE 命令:cloudbuilder.exe CREATE -j <createfilename.json>
该实用程序将在 ArcGIS Enterprise Cloud Builder CLI for AWS 的 Output 文件夹下为您的 DeploymentName 参数命名的子文件夹中创建一个输出文件。每次针对相同的 ArcGIS Enterprise 部署运行 CREATE 命令时,输出文件将放置在对应的部署子文件夹中。这些文件命名为 <DeploymentName>_<batchID>.json,其中 batchID 字符串包含文件创建时间戳。该实用程序不会删除旧输出文件。
日志文件存储在您解压缩 ArcGIS Enterprise Cloud Builder for Amazon Web Services 的目录中的 Logs 文件夹内。
以下是运行 CREATE 命令创建基础部署以及 ArcGIS GeoAnalytics Server、栅格分析服务器、ArcGIS GIS Server 和 ArcGIS GeoEvent Server 站点时生成的输出文件的内容示例:
"BaseEnterprise":{ "PortalURL": "http://enterprise.yourdomain.com/portal/home", "ServerURL": "http://enterprise.yourdomain.com/server/manager" }, "GeoAnalytics":{ "ServerURL": "http://geoanalytics.yourdomain.com/arcgis/manager" }, "RasterAnalytics":{ "ServerURL": "http://rasteranalytics.yourdomain.com/arcgis/manager" }, "Server":{ "ServerURL": "http://server.yourdomain.com/arcgis" }, "GeoEvent":{ "ServerURL": "http://geoevent.yourdomain.com/server/manager", "GeoEventServerURL": "http://geoevent.yourdomain.com:6143/geoevent/manager" }
请注意,输出文件的内容取决于您在配置 JSON 文件中提供的信息。
- 运行命令并创建 ArcGIS Enterprise 部署后,可以稍后再次运行该命令来创建附加 ArcGIS Server 站点。更新同一部署配置文件并再次运行 CREATE 命令;ArcGIS Enterprise Cloud Builder CLI for AWS 实用程序将跳过已部署的组件,并相应地添加新组件。