Skip To Content

Crear implementaciones utilizando el comando ArcGIS Enterprise Cloud Builder CLI for AWS CREATE

El comando CREATE de la utilidad ArcGIS Enterprise Cloud Builder Command Line Interface for Amazon Web Services (AWS) crea una implementación base de ArcGIS Enterprise con la opción de crear un equipo federado adicional para cada rol de licenciamiento de ArcGIS Server. Después de ejecutar el comando para crear su implementación inicial, puede volver a ejecutarlo más tarde para agregar más sitios de ArcGIS Server.

Nota:

Antes de ejecutar el comando CREATE, verifique que su organización de AWS tenga suficientes recursos disponibles para que la implementación cree los nuevos equipos. El comando fallará si la nueva implementación supera el límite de su organización.

Puede abrir una copia de uno de los archivos JSON de muestra de Esri de la carpeta CreateSamples y modificarlo para incluir sus propios parámetros. Por ejemplo, para crear una implementación optimizada para análisis de ráster, elija el archivo baseenterpriseallinonewithra.json.

Como alternativa, puede usar un archivo JSON de resumen que descargó de la aplicación ArcGIS Enterprise Cloud Builder for AWS como plantilla para nuevas implementaciones. Sin embargo, no puede usar ArcGIS Enterprise Cloud Builder CLI for AWS para agregar a las implementaciones creadas mediante la aplicación ArcGIS Enterprise Cloud Builder for AWS.

Debe completar varios pasos en AWS Management Console antes de ejecutar el comando CREATE. Utilizará los resultados de estos pasos como ajustes de parámetros en su archivo JSON.

  1. Inicie sesión en AWS Management Console con la misma cuenta que especificó al preparar la implementación. Asegúrese de que se encuentra en la misma región que especificó con el parámetro "AWSRegion" en la sección anterior.
  2. En el caso de implementaciones base de ArcGIS Enterprise en un solo equipo y el equipo de ArcGIS GeoEvent Server, asigne una nueva dirección IP elástica en AWS para Amazon Virtual Private Cloud (VPC). Copie el Allocation ID correspondiente, que tendrá el formato eipalloc-xxxxxxxx. En su archivo JSON, pegue el Id. como valor para el parámetro SiteEIPAllocationID en BaseEnterprise.

    Si va a crear una implementación base de ArcGIS Enterprise en un solo equipo, continúe en el paso 5.

  3. Tanto ArcGIS Server como las implementaciones de ArcGIS Enterprise de alta disponibilidad requieren un equilibrador de carga. Puede crear los equilibradores de carga según se describe a continuación o utilizar los equilibradores de carga existentes. Si desea utilizar los equilibradores de carga existentes, continúe con el paso 4.
    • La utilidad ArcGIS Enterprise Cloud Builder CLI for AWS puede crear un equilibrador de carga para usted si su organización utiliza Amazon Route 53 para administrar el servicio de nombres de dominio (DNS) de su organización y si su cuenta de AWS tiene permisos para administrar el DNS. Esta configuración no es común, por lo que si tiene dudas sobre si cuenta con esta configuración y con los permisos, es probable que tenga que crear primero el equilibrador de carga.
    • Cree el equilibrador de carga con una plantilla de AWS CloudFormation de muestra de Esri (opción recomendada) o cree uno en AWS Management Console. Si adquirió un nombre de dominio ajeno a AWS, debe asignar el dominio al equilibrador de carga antes de crear su implementación con la utilidad. Si crea un equilibrador de carga con AWS Management Console, asegúrese de utilizar la misma VPC que su implementación y configure los equilibradores de carga con un agente de escucha HTTPS.

      La utilidad ArcGIS Enterprise Cloud Builder CLI for AWS puede utilizar el equilibrador de carga que creó con la plantilla de CloudFormation o en AWS Management Console.

    Una vez haya creado los equilibradores de carga, anote los nombres DNS resultantes, que terminan en *.elb.amazonaws.com. Necesitará esta información en el paso siguiente.

  4. Asigne los nombres DNS de sus equilibradores de carga a su dominio. Si utiliza el servicio AWS Route 53, vaya a esa página, registre un dominio si aún no lo ha hecho y cree un conjunto de registros con el nombre de dominio del sitio deseado. Si utiliza un servicio deferente para la asignación de DNS, vaya a ese sitio. En cualquier caso, cambie el tipo de nombre del sitio de la implementación base a CNAME y pegue como valor el nombre DNS que adquirió en el paso 2. Repita este proceso para asignar el nombre DNS de cada equilibrador de carga a cada sitio de ArcGIS Server.

    Por ejemplo, si va a crear una implementación optimizada para el análisis de ráster, debe asignar el nombre DNS del equilibrador de carga que creó para su servidor de análisis de ráster a su sitio de ArcGIS Image Server.

  5. Agregue los nombres de dominio del sitio (por ejemplo, base.domain.com y raster.domain.com) y los valores de Nombre de los equilibradores de carga adicionales a su archivo JSON como valores para SiteDomain en la sección adecuada.

    Por ejemplo, al modificar el archivo de muestra baseenterpriseallinonewithra.json, el valor de Id. de la VPC se define en la sección "Default". El resto de valores se definen en las secciones "BaseEnterprise" y "RasterAnalytics" del siguiente modo:

    "Default" :{  
    	  "VPCId": "vpc-0011xxxxx",	 
    	  "DriveSizeRoot": "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.json",
      "UserLicenseTypeID" : "My_User_Type_UT"
      "ServerLicenseFile":	"Your_GIS_Server_License.prvc",	  
      "Type": "AllInOne"
     },    
    "RasterAnalytics":{
      "ServerLicenseFile": "Your_Image_Server_License.prvc",	
      "ELBName": "your-raster-elb",
      "SiteDomain": "raster.yourdomain.com",	
      "CloudStoreS3BucketPath": "yourbucket/yourfolder",
      "Federate":true,
    }
  6. Cree un par de claves en AWS. Agregue el nombre del par de claves a su archivo JSON como valor para el parámetro KeyName.
  7. En su archivo JSON, modifique el resto de parámetros si es necesario. Consulte la lista completa de parámetros de ArcGIS Enterprise Cloud Builder CLI for AWS para obtener descripciones.
  8. Guarde su archivo JSON modificado. Vuelva a su consola de comandos y ejecute el comando CREATE: cloudbuilder.exe CREATE -j <createfilename.json>

    La utilidad crea un archivo de salida en la carpeta Output de ArcGIS Enterprise Cloud Builder CLI for AWS, dentro de una subcarpeta que toma el nombre de su parámetro DeploymentName. Cada vez que ejecuta el comando CREATE para la misma implementación de ArcGIS Enterprise, se colocan archivos de salida en la subcarpeta correspondiente de la implementación. Los archivos se denominan <DeploymentName>_<batchID>.json, donde la cadena batchID contiene una marca de tiempo de creación del archivo. La utilidad nunca elimina archivos de salida antiguos.

    Se crean archivos de registro en una carpeta Logs en el directorio en el que extrajo ArcGIS Enterprise Cloud Builder for Amazon Web Services.

    A continuación se muestra un ejemplo del contenido de un archivo de salida generado al ejecutar el comando CREATE para crear una implementación base y sitios de ArcGIS GeoAnalytics Server, servidor de análisis de ráster, ArcGIS GIS Server y ArcGIS 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"
       }

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

  9. Una vez ejecutado el comando y creada su implementación de ArcGIS Enterprise, puede volver a ejecutar el comando más adelante para crear sitios de ArcGIS Server adicionales. Actualice el mismo archivo de configuración de la implementación y ejecute de nuevo el comando CREATE; la utilidad ArcGIS Enterprise Cloud Builder CLI for AWS omitirá los componentes que ya estén implementados y agregará los nuevos componentes como corresponda.