Skip To Content

使用 ArcGIS Enterprise Cloud Builder CLI for AWS PREP 命令准备部署资源

ArcGIS Enterprise Cloud Builder Command Line Interface for Amazon Web Services PREP 命令可用于自动执行 在 Amazon Web Services (AWS) 上进行 ArcGIS Enterprise 部署时所需的多个基本先决条件任务。 准备 JSON 文件并指定您的参数之后,运行 PREP 命令执行以下操作:

  • 为您的部署创建一个网络堆栈和 Amazon Simple Storage Service (S3) 存储段(如果该存储段尚不存在)。 S3 存储段由 Cloud Builder 托管。
  • 为部署创建 Amazon Virtual Private Cloud (VPC)
  • 将所有所需的授权文件和 SSL 证书上传到该 S3 存储段。
  • 将 SSL 证书导入到 AWS 证书管理器。

在下列情况下只需再次运行 PREP 命令:

  • 想要在其他区域或单独的网络上创建另一个部署。
  • 您拥有多个 AWS 帐户,并且想要为不同的帐户创建部署。
  • 您需要更新部署的 SSL 证书。
  • 您的 ArcGIS 许可已过期,您需要上传新的许可文件。

PREP 命令会以文本文件格式将信息返回到本地驱动器。

  1. My Esri 下载 ArcGIS Enterprise Cloud Builder for Amazon Web Services 安装程序,然后将其放置到本地驱动器上。
  2. 双击 Setup.exe 文件以开始安装。 请按照每个屏幕上的说明进行操作,以完成安装。

    ArcGIS Enterprise Cloud Builder CLI for AWS 实用程序及其支持文件和示例将安装到安装过程中所指定的位置。

  3. 将 SSL 证书 (.pfx) 和许可文件(ArcGIS Server.prvc.ecpPortal for ArcGIS.json)移至您刚刚提取 ArcGIS Enterprise Cloud Builder CLI for AWS 实用程序的计算机。
  4. 如果您想要修改并使用实用程序随附的示例 .json 文件,请为 Configuration\PrepSamples 文件夹中的文件创建副本。 请确保将副本放置在 Configuration 文件夹下的子文件夹内。
  5. 在使用 ArcGIS Enterprise Cloud Builder CLI for AWS 实用程序运行 PREP 命令之前,修改示例准备文件之一或自行创建 .json 准备文件。

    要创建 VPCS3 存储段并一步上传 SSL 证书和 ArcGIS 许可文件,可修改 allprep.json 示例文件副本,或自行创建包含以下示例所示参数的 .json 准备文件。 在文本编辑器中打开该文件,将参数设置为帐户和部署特定信息,然后保存更改。 有关每个参数的说明,请参阅 ArcGIS Enterprise Cloud Builder CLI for AWS 参数

    在此示例中,实用程序将使用帐户访问密钥和保密密钥连接到 AWS 帐户。 将从指定的本地文件夹中复制许可文件和 SSL 证书,并将其放置在 ArcGIS Enterprise Cloud Builder for AWS 托管的 S3 部署存储段中。 还将在可用区域 ap-northeast-1b 和 ap-northeast-1a 中创建 VPC

    请注意,您的所有 ArcGIS Server 许可可能在同一个文件中。

    {
    	"AWSCredentials": {
    		"AWSAccessKey": "ABCDEFGHIMI4YCPABC",
    	 "AWSSecretKey": "ABCDLZDYIzZuXHlWHOPhMqrTmABCD",
    		"AWSRegion": "ap-northeast-1"
    	},
    	"NetworkStack": {
    		"StackName": "EnterpriseVPC",
    		"AZs": "ap-northeast-1b,ap-northeast-1a",
    		"CreateFlag":true
    	},
    	"ArcGISEnterpriseFiles": {
    	 "PortalLicense": "C:\\ArcGISLicenses\\Your_Portal_License.json",
    		"ServerLicense": "C:\\ArcGISLicenses\\Your_GIS_Server_License.prvc",
    		"GeoAnalyticsLicense": "C:\\ArcGISLicenses\\Your_GeoAnalytics_Server_License.prvc",
      "NotebookServerLicense": "C:\\ArcGISLicenses\\Your_Notebook_Server_License.prvc",
      "MissionServerLicense": "C:\\ArcGISLicenses\\Your_Mission_Server_License.prvc",
      "ImageServerLicense": "C:\\ArcGISLicenses\\Your_Image_Server_License.prvc",
    		"RasterAnalyticsLicense": "C:\\ArcGISLicenses\\Your_Image_Server_License.prvc",
    		"ImageHostingLicense": "C:\\ArcGISLicenses\\Your_Image_Server_License.prvc",
    		"GeoEventLicense": "C:\\ArcGISLicenses\\Your_GeoEvent_Server_License.prvc",
    	 "WorkflowManagerLicense": "C:\\ArcGISLicenses\\Your_Workflow_Manager_License.prvc",
    		"SSLCertificateFile": "C:\\MyCerts\\wildcard_yourdomain_com.pfx",
    		"SSLCertPassword": "changeit"
    	}
    }

  6. 打开命令提示符,然后将目录 (cd) 更改为您安装 ArcGIS Enterprise Cloud Builder CLI for AWS 实用程序和文件的文件夹。 使用 PREP 命令运行该实用程序:cloudbuilder.exe PREP -j <prepfilename.json>

    例如,要使用位于 ArcGIS Enterprise Cloud Builder CLI for AWS Configuration 文件夹中新准备文件子文件夹中的名为 myallprep.json 的文件,需要输入以下内容:

    cloudbuilder.exe PREP -j Configuration\MyPrepFiles\myallprep.json

  7. 在本地驱动器的 CloudBuilder\AWS\CLI\Output 文件夹中查找 ArcGIS Enterprise Cloud Builder CLI for AWS 实用程序的输出文件(格式为 PREP_<date><time>.json)。

    此文件包含创建部署时所需的信息。

    在第 5 步中运行示例文件的输出将包含新 VPC 的一个 ID 和两个子网 ID、S3 存储段名称以及为 SSL 证书创建的唯一 Amazon 资源名称 (ARN)。

    "NetworkStack": {
          "VPCId": "vpc-z9fb11ba",
          "subnet1": "subnet-z319acee",
          "subnet2": "subnet-f4fc658f"
       },
       "DeploymentDetails": {
          "PortalLicense": "resources/licenses/<version>/portal/Your_Portal_License.json",
    	    	"ServerLicense": "resources/licenses/<version>/server/Your_GIS_Server_License.prvc",
    	    	"GeoAnalyticsLicense": "resources/licenses/<version>/geoanalytics/Your_GeoAnalytics_Server_License.prvc",
          "NotebookServerLicense": "resources/licenses/<version>/notebookserver/Your_Notebook_Server_License.prvc",
          "MissionServerLicense": "resources/licenses/<version>/missionserver/Your_Mission_Server_License.prvc",
          "ImageServerLicense": "resources/licenses/<version>/image/Your_Image_Server_License.prvc",
    	    	"RasterAnalyticsLicense": "resources/licenses/<version>//rasteranalytics/Your_Image_Server_License.prvc",
    	    	"ImageHostingLicense": "resources/licenses/<version>//imagehosting/Your_Image_Server_License.prvc",
    	    	"GeoEventLicense": "resources/licenses/<version>/geoevent/Your_GeoEvent_Server_License.prvc",
    	    	"WorkflowManagerLicense": "resources/licenses/<version>/workflow/Your_Workflow_Manager_License.prvc",
    	     "SSLCertificateFile": "resources/sslcerts/wildcard_yourdomain_com.pfx",
          "SSLCertificateARN": "arn:aws:acm:ap-northeast-1:123456789123:certificate/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
          "DeploymentBucket": "esri-aws-1234567890"
       }

    输出文件的内容取决于您在配置文件中提供的信息。

现在已做好使用命令行界面创建部署的准备。