Skip To Content

运行 CREATE 命令

ArcGIS Enterprise Cloud Builder CLI for AWS 实用程序中的 CREATE 命令可用于创建基础 ArcGIS Enterprise 部署,还可以选择为每个 ArcGIS Server 许可角色创建一个附加的联合计算机。运行该命令创建初始部署后,可以稍后再次运行该命令添加更多 ArcGIS Server 站点。

注:

运行 CREATE 命令之前,请验证您的 AWS 组织是否有足够的可用资源供部署创建新的计算机。如果新部署超出组织的限制,该命令将失败。

您可以从 CreateSamples 文件夹打开一个 Esri 示例 JSON 文件的副本,然后修改它以包含您的参数。例如,要构建针对栅格分析优化的部署,请选择 baseenterpriseallinonewithra.json 文件。

必须先执行 AWS 管理控制台中的几个步骤,然后再执行 CREATE 命令。您需要使用这些步骤的结果作为 JSON 文件中的参数设置。

  1. 使用您在准备部署时指定的相同帐户登录 AWS 管理控制台。请确保您所在的区域与在上一部分中使用 "AWSRegion" 参数指定的区域相同。
  2. 在 AWS 中为基于单机的 ArcGIS Enterprise 部署和 ArcGIS GeoEvent Server 计算机分配新的弹性 IP 地址。复制采用 eipalloc-xxxxxxxx 格式的对应 Allocation ID。在 JSON 文件中,粘贴该 ID 作为 BaseEnterprise SiteEIPAllocationID 参数的值。
  3. ArcGIS Server 和高可用性 ArcGIS Enterprise 部署都需要负载均衡器。您可以按照以下所述创建负载均衡器,也可以使用现有负载均衡器。如果您要使用现有负载均衡器,请继续执行步骤 4。
    • 如果您的组织使用 Amazon Route 53 来管理组织的域名服务 (DNS),并且您的 AWS 帐户具有管理 DNS 的权限,则 ArcGIS Enterprise Cloud Builder CLI for AWS 实用程序可以为您创建一个负载均衡器。此配置并不常见,因此如果您不确定您是否拥有此配置和权限,您可能需要首先创建负载均衡器。
    • 可使用 Esri 示例 AWS CloudFormation 模板(建议选项)创建负载均衡器或在 AWS 管理控制台中创建一个。如果购买了 AWS 之外的域名,则必须先将该域映射到负载均衡器,然后再使用该实用程序创建部署。如果使用 AWS 管理控制台创建负载均衡器,请确保使用与您的部署相同的 VPC 并使用 HTTPS 侦听器配置负载均衡器

      ArcGIS Enterprise Cloud Builder CLI for AWS 实用程序可以将您已创建的负载均衡器与 CloudFormation 模板配合使用,或者在 AWS 管理控制台中使用您已创建的负载均衡器。

    创建负载均衡器后,请记住生成的 DNS 名称,该名称的结尾为 *.elb.amazonaws.com。需要在下一步中使用此信息。

  4. 将负载均衡器的 DNS 名称映射到您的域。如果您正在使用 AWS Route 53 服务,请导航到该页面;如果您尚未这样做,请先注册一个域,然后使用所需站点域名创建一个新的记录集。如果您使用其他服务进行 DNS 映射,请浏览到该站点。无论哪种情况,都需要将基础部署站点名称的类型设置为 CNAME 并将您在第 2 步中获取的 DNS 名称粘贴为值。重复此步骤,将每个负载均衡器的 DNS 名称映射到每个 ArcGIS Server 站点。

    例如,如果要构建针对栅格分析优化的部署,则需要将为栅格分析服务器创建的负载均衡器的 DNS 名称映射到 ArcGIS Image Server 站点。

  5. 将站点域名(如 base.domain.comraster.domain.com)和附加负载均衡器的名称值添加到 JSON 文件作为对应部分中 SiteDomain 的值。

    例如,修改 baseenterpriseallinonewithra.json 示例文件时,需要在 "Default" 部分中设置 VPC ID 值。需要在 "BaseEnterprise""RasterAnalytics" 部分中设置其他值,如下所示:

    "Default" :{  
    	  "VPCId": "vpc-0011xxxxx",	 
    	  "DriveSizeRoot": "100",
    	  "DriveSizeData": "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.prvc",
      "ServerLicenseFile":	"Your_Server_License.prvc",	  
      "Type": "AllInOne"
     },    
    "RasterAnalytics":{
      "ServerLicenseFile": "Your_Server_Image_License.prvc",	
      "ELBName": "your-raster-elb",
      "SiteDomain": "raster.yourdomain.com",	
      "CloudStoreS3BucketPath": "yourbucket/yourfolder",
      "Federate":true,
    }
  6. 在 AWS 中创建一个新的密钥对。将该密钥对名称添加到 JSON 文件作为 KeyName 参数的值。
  7. 在 JSON 文件中,根据需要修改其余参数。有关说明,请参阅 ArcGIS Enterprise Cloud Builder CLI for AWS 的完整参数列表
  8. 保存修改后的 JSON 文件。返回到命令提示符控制台,然后运行 CREATE 命令:cloudbuilder.exe CREATE -j <createfilename.json>

    该实用程序将在 CLI 的 Output 文件夹下为您的 DeploymentName 参数命名的子文件夹中创建一个输出文件。每次针对相同的 ArcGIS Enterprise 部署运行 CREATE 命令时,输出文件将放置在对应的部署子文件夹中。这些文件命名为 <DeploymentName>_<batchID>.json,其中 batchID 字符串包含文件创建时间戳。该实用程序不会删除旧输出文件。

    以下是运行 CREATE 命令创建基础部署以及 ArcGIS GeoAnalytics ServerArcGIS Image ServerArcGIS GIS ServerArcGIS 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 文件中提供的信息。

  9. 运行命令并创建 ArcGIS Enterprise 部署后,可以稍后再次运行该命令来创建附加 ArcGIS Server 站点。更新部署配置文件并再次运行 CREATE 命令;ArcGIS Enterprise Cloud Builder CLI for AWS 实用程序将跳过已部署的组件,并相应地添加新组件。