Skip To Content

Preparar los recursos de implementación mediante el comando ArcGIS Enterprise Cloud Builder CLI for AWS PREP

El comando PREP de Interfaz de línea de comandos de ArcGIS Enterprise Cloud Builder para Amazon Web Services automatiza varias tareas esenciales de requisitos previos para una implementación de ArcGIS Enterprise en Amazon Web Services (AWS). Después de preparar un archivo JSON especificando sus parámetros, ejecute el comando PREP para hacer lo siguiente:

  • Crear una pila de red y un bucket de Amazon Simple Storage Service (S3) para su implementación si el bucket no existe aún. El bucket de S3 lo administra Cloud Builder.
  • Crear una Amazon Virtual Private Cloud (VPC) para su implementación.
  • Cargar todos los archivos de autorización y certificados SSL necesarios al bucket de S3.
  • Importar su certificado SSL al Administrador de certificados de AWS.

Solo tiene que volver a ejecutar el comando PREP en las siguientes circunstancias:

  • Desea crear otra implementación en una región diferente o en una red separada.
  • Tiene más de una cuenta de AWS y desea crear implementaciones para distintas cuentas.
  • Necesita actualizar el certificado SSL para su implementación.
  • Sus licencias de ArcGIS han caducado y necesita cargar nuevos archivos de licencia.

El comando PREP devuelve información a un archivo de texto en su unidad local.

  1. Descargue el programa de instalación ArcGIS Enterprise Cloud Builder for Amazon Web Services de My Esri y colóquelo en su unidad local.
  2. Haga doble clic en el archivo Setup.exe para iniciar la instalación. Siga las instrucciones de cada pantalla para completar la instalación.

    La utilidad ArcGIS Enterprise Cloud Builder CLI for AWS y sus archivos y muestras complementarios se instalan en la ubicación que especifique durante la instalación.

  3. Mueva el certificado SSL (.pfx) y los archivos de licencia (.prvc o .ecp para ArcGIS Server y .json para Portal for ArcGIS) al equipo en el que acaba de extraer la utilidad ArcGIS Enterprise Cloud Builder CLI for AWS.
  4. Si desea modificar y usar los archivos .json de muestra suministrados con la utilidad, haga copias de los archivos en la carpeta Configuration\PrepSamples. Asegúrese de colocar las copias en una subcarpeta dentro de la carpeta Configuration.
  5. Antes de ejecutar el comando PREP con la utilidad ArcGIS Enterprise Cloud Builder CLI for AWS, modifique uno de los archivos de preparación de muestra o cree su propio archivo de preparación .json.

    Para crear una VPC y un bucket de S3 y cargar su certificado SSL y archivos de licencia de ArcGIS en un solo paso, modifique su copia del archivo de muestra allprep.json o cree su propio archivo de preparación .json que incluya los parámetros que se muestran en el siguiente ejemplo. Abra el archivo en un editor de texto, defina los parámetros con la información específica para su cuenta e implementación y guarde los cambios. Para una descripción de cada parámetro, consulte Parámetros de ArcGIS Enterprise Cloud Builder CLI for AWS.

    En este ejemplo, la utilidad se conecta a la cuenta de AWS con la clave de acceso y la clave de acceso secreta de la cuenta. Se copiarán los archivos de licencia y un certificado SSL de las carpetas locales especificadas y se colocarán en el bucket de S3 de implementación administrado por ArcGIS Enterprise Cloud Builder for AWS. También se creará una VPC en las zonas de disponibilidad ap-northeast-1b y ap-northeast-1a.

    Tenga en cuenta que es posible que todas sus licencias de ArcGIS Server se encuentren en el mismo archivo.

    {
    	"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",
    		"SSLCertificateFile": "C:\\MyCerts\\wildcard_yourdomain_com.pfx",
    		"SSLCertPassword": "changeit"
    	}
    }

  6. Abra la ventana de comando y cambie los directorios (cd) a la carpeta en la que instaló la utilidad ArcGIS Enterprise Cloud Builder CLI for AWS y los archivos. Ejecute la utilidad con el comando PREP: cloudbuilder.exe PREP -j <prepfilename.json>

    Por ejemplo, para usar un archivo llamado myallprep.json que colocó en una nueva subcarpeta de archivo de preparación de la carpeta Configuration de ArcGIS Enterprise Cloud Builder CLI for AWS, escriba lo siguiente:

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

  7. Localice el archivo de salida de la utilidad ArcGIS Enterprise Cloud Builder CLI for AWS (con el formato PREP_<date><time>.json) en la carpeta CloudBuilder\AWS\CLI\Output de su unidad local. Este archivo contiene información que necesitará cuando cree la implementación.

    La salida de la ejecución del archivo de ejemplo en el paso 5 incluirá un Id. y dos Id. de subred para una nueva VPC, el nombre del bucket de S3 y el Amazon Resource Name (ARN) creado para su certificado SSL.

    "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",
    	     "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"
       }

    Tenga en cuenta que el contenido del archivo de salida variará en función de la información que proporcione en el archivo de configuración.

Ahora ya puede crear una implementación mediante la interfaz de línea de comandos.