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) 存储段。
- 为部署创建 Amazon Virtual Private Cloud (VPC)。
- 将所有所需的授权文件和 SSL 证书上传到该 S3 存储段。
- 将 SSL 证书导入到 AWS 证书管理器。
在下列情况下只需再次运行 PREP 命令:
- 想要在其他区域或单独的网络上创建另一个部署。
- 您拥有多个 AWS 帐户,并且想要为不同的帐户创建部署。
- 您需要更新部署的 SSL 证书。
- 您的 ArcGIS 许可已过期,您需要上传新的许可文件。
PREP 命令会以文本文件格式将信息返回到本地驱动器。
- 从 My Esri 下载 ArcGIS_Enterprise_Cloud_Builder_AWS_CLI_<version>_<#>.exe 文件,然后将其放置到本地驱动器上。
- 双击该 ArcGIS_Enterprise_Cloud_Builder_AWS_CLI_<version>_<#>.exe 文件以提取其内容。提取期间,可以为提取文件指定位置或使用默认位置 c:\Program Files\ArcGIS\CloudBuilder\AWS\CLI。您必须是 Windows 管理员才能提取到默认位置。
ArcGIS Enterprise Cloud Builder CLI for AWS 实用程序及其支持文件和示例将提取到您指定的位置。
- 将 SSL 证书 (.pfx) 和许可文件(ArcGIS Server 为 .prvc 或 .ecp,Portal for ArcGIS 为 .json)移至您刚刚提取 ArcGIS Enterprise Cloud Builder CLI for AWS 实用程序的计算机。
- 如果您想要修改并使用实用程序随附的示例 .json 文件,请为 Configuration 文件夹中的文件创建副本。请确保将副本放置在 Configuration 文件夹下的子文件夹内。
- 在使用 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。
请注意,您的所有 ArcGIS Server 许可可能在同一个文件中。
{ "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": "C:\\ArcGISLicenses\\Your_Portal_License.json", "ServerLicense": "C:\\ArcGISLicenses\\Your_GIS_Server_License.prvc", "GeoAnalyticsLicense": "C:\\ArcGISLicenses\\Your_GeoAnalytics_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", "SSLCertificateFile": "C:\\MyCerts\\wildcard_yourdomain_com.pfx", "SSLCertPassword": "changeit" } }
- 打开命令提示符,然后将目录 (cd) 更改为您提取 ArcGIS Enterprise Cloud Builder CLI for AWS 实用程序和文件的文件夹。使用 PREP 命令运行该实用程序:cloudbuilder.exe PREP -j <prepfilename.json>
例如,要使用位于 ArcGIS Enterprise Cloud Builder CLI for AWS myallprep.json 文件夹中新准备文件子文件夹中的名为 Configuration 的文件,需要输入以下内容:
cloudbuilder.exe PREP -j Configuration\MyPrepFiles\myallprep.json
- 在本地驱动器的 PREP_<date><time>.json 文件夹中查找 ArcGIS Enterprise Cloud Builder CLI for AWS 实用程序的输出文件(格式为 CloudBuilder\AWS\CLI\Output)。此文件包含创建部署时所需的信息。
在第 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" }
请注意,输出文件的内容取决于您在配置文件中提供的信息。
现在已做好使用命令行界面创建部署的准备。