Skip To Content

运行 PREP 命令

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

  • 为部署创建网络堆栈和 Amazon 简单存储服务 (S3) 存储段。
  • 为部署创建 VPC。
  • 将所有所需的授权文件和 SSL 证书上传到该 S3 存储段。
  • 将 SSL 证书导入到 AWS 证书管理器。

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

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

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

  1. My Esri 下载 ArcGIS_Enterprise_Cloud_Builder_AWS_CLI_<version>_<#>.exe 文件,然后将其放置到本地驱动器上。
  2. 双击该 ArcGIS_Enterprise_Cloud_Builder_AWS_CLI_<version>_<#>.exe 文件以提取其内容。提取期间,可以为提取文件指定位置或使用默认位置 c:\Program Files\ArcGIS\CloudBuilder\AWS\CLI。您必须是 Windows 管理员才能提取到默认位置。

    ArcGIS Enterprise Cloud Builder CLI for AWS 实用程序及其支持文件和示例将提取到您指定的位置。

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

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

    在此示例中,实用程序将使用帐户访问密钥和保密密钥连接到 AWS 帐户。将在区域 ap-northeast-1 中创建名为 EnterpriseFiles 的 Amazon S3 存储段,然后从指定的本地文件夹复制许可文件和 SSL 证书并放置在该 S3 存储段中。还将在可用区域 ap-northeast-1b 和 ap-northeast-1a 中创建 VPC。

    {
    	"AWSCredentials": {
    		"AWSAccessKey": "ABCDEFGHIMI4YCPABC",
    	 "AWSSecretKey": "ABCDLZDYIzZuXHlWHOPhMqrTmABCD",
    		"AWSRegion": "ap-northeast-1"
    	},
    	"NetworkStack": {
    		"StackName": "EnterpriseVPC",
    		"AZs": "ap-northeast-1b,ap-northeast-1a",
    		"CreateFlag":true
    	},
    	"ArcGISEnterpriseFiles": {
    	 "DeploymentBucket": "enterprisefiles",
    		"PortalLicense": "D:\\ArcGISLicenses\\Your_Portal_License.prvc",
    		"ServerLicense": "D:\\ArcGISLicenses\\Your_Server_License.prvc",
    		"GeoAnalyticsLicense": "D:\\ArcGISLicenses\\Your_Server_GeoAnalytics_License.prvc",
    		"RasterAnalyticsLicense": "D:\\ArcGISLicenses\\Your_Server_Image_License.prvc",
    		"GeoEventLicense": "D:\\ArcGISLicenses\\Your_Server_GeoEvent_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": {
          "DeploymentBucket": "enterprisefiles",
          "SSLCertificateARN": "arn:aws:acm:ap-northeast-1:123456789123:certificate/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
       }

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

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