Cuando utiliza ArcGIS Enterprise Cloud Builder Command Line Interface for Amazon Web Services (AWS) para preparar e implementar sitios de ArcGIS Enterprise y ArcGIS Server, proporciona información sobre el tipo de implementación que desea al indicar la ubicación y el nombre del archivo JSON que contiene la configuración que necesita.
Archivos de muestra
El archivo ArcGIS Enterprise Cloud Builder CLI for AWS que descarga de My Esri incluye varios archivos JSON de muestra. Las muestras de JSON representan implementaciones habituales. Existen archivos separados para los pasos preparatorios (que puede utilizar al ejecutar la utilidad ArcGIS Enterprise Cloud Builder CLI for AWS con el comando PREP) y archivos que puede usar para crear la implementación al ejecutar la utilidad ArcGIS Enterprise Cloud Builder CLI for AWS con el comando CREATE.
En las dos tablas siguientes se describen los archivos de muestra suministrados con la utilidad ArcGIS Enterprise Cloud Builder CLI for AWS.
Archivo de muestra de preparación | Descripción |
---|---|
createnetworkvpc.json | Crea un Amazon Virtual Private Cloud (VPC) en la región de AWS que especifique. |
uploadlicensefile.json | Carga licencias de ArcGIS Server y una licencia de Portal for ArcGIS. Si desea especificar un nombre para el bucket de Amazon Simple Storage Service (S3), agregue el parámetro "DeploymentBucket" en la sección "ArcGISEnterpriseFiles"; de lo contrario, se crea un bucket con un nombre predeterminado. |
uploadsslcert.json | Carga un certificado SSL en el bucket de Amazon S3 que especifique e importa el certificado SSL al Administrador de certificados de AWS. |
uploadlicenseandcert.json | Carga licencias de ArcGIS Server, una licencia de Portal for ArcGIS y un certificado SSL en el bucket de Amazon S3 que especifique. También importa el certificado SSL al Administrador de certificados de AWS. |
allprep.json | Crea un VPC y carga licencias de ArcGIS Server, un archivo JSON de Portal for ArcGIS y un certificado SSL al bucket de Amazon S3 que especifique. También importa el certificado SSL al Administrador de certificados de AWS. |
Archivo de muestra de creación | Descripción |
---|---|
baseenterpriseallinone.json | Implementa un ArcGIS Enterprise base en un solo equipo. |
baseenterpriseha.json | Implementa un ArcGIS Enterprise base en dos equipos: uno principal y otro de respaldo. |
baseenterpriseallinonewithra.json | Implementa un ArcGIS Enterprise base más un sitio de ArcGIS Image Server federado configurado como servidor de análisis de ráster del portal. |
baseenterprisehawithga.json | Implementa un ArcGIS Enterprise base en dos equipos más un sitio de ArcGIS GeoAnalytics Server federado configurado como servidor de GeoAnalytics del portal. |
baseenterpriseimagehosting.json | Implementa un ArcGIS Enterprise base más un sitio de ArcGIS Image Server federado configurado como servidor de alojamiento de imágenes del portal. |
baseenterpriseimagehostingrasterstore.json | Implementa un ArcGIS Enterprise base más sitios de ArcGIS Image Server federados configurados como servidor de alojamiento de imágenes del portal. Tiene la opción de utilizar este archivo para crear un almacén en la nube en S3 y registrarlo como un almacén de rásteres. |
standalonegeoevent.json | Implementa un sitio de ArcGIS GeoEvent Server independiente. |
standaloneserver.json | Implementa un sitio de ArcGIS GIS Server independiente. |
standaloneimageserver.json | Implementa un sitio de ArcGIS Image Server independiente. |
standaloneserverwithexistingelb.json | Implementa un sitio de ArcGIS GIS Server independiente con el Elastic Load Balancer que creó anteriormente. |
completeArcGISenterprise.json | Permite implementar un ArcGIS Enterprise base integral o altamente disponible y todos los sitios de ArcGIS Server federados posibles. |
Puede copiar y modificar estos archivos con un editor de texto o crear sus propios archivos JSON. Si utiliza las muestras, reemplace los ajustes de muestra por valores específicos para su implementación. También puede cambiar qué parámetros están presentes en los archivos de muestra.
Los parámetros del archivo JSON se agrupan juntos en los encabezados de la sección (nodo). Estos parámetros y sus agrupaciones se describen en el resto de este tema.
Credenciales y región de AWS
Para conectarse a Amazon Web Services, el comando necesita sus credenciales de AWS. Las credenciales pueden ser la clave de acceso y la clave secreta de su cuenta de AWS o el nombre de perfil de AWS de su cuenta. Estas credenciales se requieren siempre que ejecuta la utilidad ArcGIS Enterprise Cloud Builder CLI for AWS y se agrupan en la sección "AWSCredentials".
También debe especificar la región de AWS en la que desea realizar la implementación. Esta región debe ser la misma para todos los componentes de su implementación.
Parámetro | Descripción | ¿Obligatorio u opcional? |
---|---|---|
"AWSAccessKey" | La clave de acceso de su cuenta de AWS. | Obligatorio si no especifica el parámetro "AWSProfileName". |
"AWSSecretKey" | La clave secreta de su cuenta de AWS. | Obligatorio si no especifica el parámetro "AWSProfileName". |
"AWSProfileName" | El nombre de perfil que configuró para su cuenta de AWS. | Obligatorio si no especifican los parámetros "AWSAccessKey" ni "AWSSecretKey". |
"AWSRegion" | La región de AWS en la que se crearán todas las partes de su implementación. | Obligatorio |
En este ejemplo, las credenciales de autorización son las claves de acceso y secreta de la cuenta de AWS. Las instancias de Amazon Elastic Compute Cloud (EC2) se lanzarán en la región de AWS eu-west-2."AWSCredentials": {
"AWSAccessKey": "AKIAINKWSK6MI4YCPA123",
"AWSSecretKey": "ABCD1E2fghIJkLmNOPQzZuXHlWHOPhMqrTmPEpV",
"AWSRegion": "eu-west-2"
}
En este ejemplo, las credenciales de autenticación son el nombre de perfil configurado para la cuenta de AWS. Las instancias de EC2 se lanzarán en la región de AWS us-west-1."AWSCredentials": {
"AWSProfileName": "betavpc", "AWSRegion": "us-west-1"
}
Parámetros para usar en los archivos de preparación de la implementación
Antes de crear una implementación, debe crear una VPC y un bucket de implementación de S3 y cargar su certificado SSL y sus licencias de software de ArcGIS en el bucket de S3. Puede configurar parámetros en un archivo .json de preparación para completar estos pasos.
Pila de red
La sección "NetworkStack" es una sección opcional del archivo de preparación que le permite crear una VPC.
En este ejemplo, la utilidad creará una VPC en las zonas de AWS eu-west-2b y eu-west-2a, y le asignará una etiqueta de nombre de MyEnterpriseVPC.
"NetworkStack": {
"StackName": "MyEnterpriseVPC", "AZs": "eu-west-2b,eu-west-2a", "CreateFlag": true
}
En la siguiente tabla se describen todos los parámetros que puede usar en la sección "NetworkStack":
Parámetro | Descripción | ¿Obligatorio u opcional? |
---|---|---|
"StackName" | Una etiqueta de nombre única para su VPC, para ayudarle a identificarla. | Es opcional; si no se especifica, se crea una VPC con la etiqueta de nombre arcgis-vpc. |
"AZs" | Especifique dos zonas de disponibilidad de AWS para la VPC. Las zonas deben estar dentro de la región que especificó en el nodo "AWSCredentials". | El parámetro "AZs" es obligatorio si incluye el nodo "NetworkStack" en su archivo. |
"CreateFlag" | Especifica si se creará (true) una VPC o no (false). | El parámetro "CreateFlag" es obligatorio si incluye el nodo "NetworkStack" en su archivo. |
Archivos de ArcGIS Enterprise
"ArcGISEnterpriseFiles" contiene información sobre los archivos de licencia y SSL que la utilidad necesita para crear su implementación.
Los archivos de licencia de ArcGIS Server pueden ser archivos .prvc o .ecp. Las licencias de Portal for ArcGIS se encuentran en archivos .json.
Los archivos SSL deben ser archivos .pfx.
A continuación encontrará una sección "ArcGISEnterpriseFiles" de ejemplo con todos los parámetros posibles especificados:
"ArcGISEnterpriseFiles": {
"DeploymentBucket": "cbtesting", "PortalLicense": "C:\\Licenses\\portal.json", "ServerLicense": "C:\\Licenses\\Server.prvc", "GeoAnalyticsLicense": "C:\\Licenses\\Server_GeoAnalytics.prvc", "ImageServerLicense": "C:\\Licenses\\Server_Image.prvc", "RasterAnalyticsLicense": "C:\\Licenses\\Server_Image.prvc", "ImageHostingLicense": " C:\\Licenses\\Server_Image.prvc ", "GeoEventLicense": " C:\\Licenses\\Server_GeoEvent.prvc.prvc", "SSLCertificateFile": "C:\\SSLCerts\\wildcard_webgistesting_net.pfx", "SSLCertPassword": "abc123"
}
La siguiente tabla contiene descripciones de todos los parámetros que puede usar en el nodo "ArcGISEnterpriseFiles":
Parámetro | Descripción | ¿Obligatorio u opcional? |
---|---|---|
"DeploymentBucket" | El nombre de un bucket de Amazon S3 en el que almacenar archivos de licencia de ArcGIS y archivos de certificados SSL (.pfx). La herramienta comprueba si ya existe un bucket de S3 con el nombre especificado en esta región de AWS. Si no existe, la utilidad crea un bucket en la región que especificó en el nodo "AWSCredentials". | Es opcional; si no se especifica, se crea un bucket de Amazon S3 para usted. |
"PortalLicense" | Su archivo de licencia de Portal for ArcGIS (.json). Especifique la ruta física del archivo de licencia en el disco local para que la utilidad pueda cargarlo en el bucket de S3. | Obligatorio si implementa ArcGIS Enterprise. |
"ServerLicense" | Su archivo de licencia de ArcGIS GIS Server. | Obligatorio si implementa ArcGIS Enterprise o un sitio de ArcGIS GIS Server federado o independiente. |
"ImageServerLicense" | Su archivo de licencia de ArcGIS Image Server. | Obligatorio si implementa un ArcGIS Image Server federado o independiente. |
"GeoAnalyticsLicense" | Su archivo de licencia de ArcGIS GeoAnalytics Server. | Obligatorio si implementa un sitio de ArcGIS GeoAnalytics Server. |
"RasterAnalyticsLicense" | Su archivo de licencia de ArcGIS Image Server. | Obligatorio si implementa un ArcGIS Image Server federado. |
"ImageHostingLicense" | Su archivo de licencia de ArcGIS Image Server. | Obligatorio si implementa un ArcGIS Image Server federado. |
"GeoEventLicense" | Su archivo de licencia de ArcGIS GeoEvent Server. | Obligatorio si implementa un ArcGIS GeoEvent Server federado o independiente. |
"SSLCertificateFile" | El archivo de certificado SSL emitido al dominio de su sitio. Especifique la ruta física del certificado SSL en el disco local para que la utilidad pueda cargarlo en el bucket de S3. | Obligatorio para cargar el certificado SSL. |
"SSLCertPassword" | La contraseña del certificado SSL. | Obligatorio para cargar el certificado SSL. |
Parámetros que se usarán en los archivos para la creación de la implementación
Para crear una implementación, debe proporcionar información sobre el software y el hardware que desea incluir en la implementación. Los parámetros se agrupan en los nodos descritos en las secciones siguientes.
Detalles de la implementación
En la parte superior del archivo, especifique el nombre que se usará en todas las instancias (equipos) de Amazon Elastic Compute Cloud en su implementación, la versión de software de ArcGIS que desea implementar (10.6 o posterior) y qué sistema operativo (Microsoft Windows o Ubuntu Server) se usará para las instancias de EC2 que implemente. Todos estos parámetros son obligatorios.
"DeploymentDetails": {
"DeploymentName": "<name_to_append_to_machines_in_aws_deployment">,
"ArcGISVersion": "<10.6 | 10.6.1 | 10.7 | 10.7.1>",
"OperatingSystem": "<Windows | Ubuntu>"
}
"DeploymentName" debe empezar por un carácter alfabético, solo puede contener caracteres alfanuméricos y su longitud debe ser de al menos tres caracteres.
En este ejemplo, los nombres de todos los equipos de la implementación empezarán por testservers. Las AMI de Esri Ubuntu 10.7.1 se usarán para la implementación. "DeploymentDetails": {
"DeploymentName": "testservers", "ArcGISVersion": "10.7.1", "OperatingSystem": "Ubuntu"
}
Parámetros de CloudFormation
Los parámetros requeridos por las plantillas de CloudFormation se organizan en los siguientes nodos:
- "Default": los parámetros configurados aquí se aplican a todas las partes de la implementación. Los parámetros configurados en default se pueden omitir de los demás nodos.
- "BaseEnterprise": los parámetros configurados en esta sección se aplican solamente a la implementación base de ArcGIS Enterprise.
- "GeoAnalytics": los parámetros configurados en esta sección se aplican solamente a un sitio de ArcGIS GeoAnalytics Server federado.
- "RasterAnalytics": los parámetros configurados en esta sección se aplican solamente a sitios de ArcGIS Image Server federados o independientes.
- "ImageHosting": los parámetros configurados en esta sección se aplican solamente a sitios de ArcGIS Image Server federados para utilizarlos como servidor de alojamiento de imágenes del portal.
- "Server": los parámetros configurados en esta sección se aplican solamente a sitios de ArcGIS GIS Server federados o independientes.
- "ImageServer": los parámetros configurados en esta sección se aplican solamente a sitios de ArcGIS Image Server federados o independientes.
- "GeoEvent": los parámetros configurados en esta sección se aplican solamente a un sitio de ArcGIS GeoEvent Server federado o independiente.
Nota:
Debe incluir un nodo para cada parte de la implementación que desea crear. Por ejemplo, si desea crear una implementación base de ArcGIS Enterprise, un sitio de ArcGIS GeoAnalytics Server federado y un sitio de ArcGIS GIS Server federado, debe tener los nodos "BaseEnterprise", "GeoAnalytics" y "Server" en su archivo de configuración y estos nodos deben contener al menos un parámetro. Por ejemplo, aunque configure los parámetros "Federate" y "ServerLicenseFile" en el nodo "Default", debe incluir al menos uno de ellos en el nodo "Server"; de lo contrario, la utilidad no creará un sitio de ArcGIS GIS Server federado.
Es necesario definir la configuración de VPC en el nodo de "Default". Puede usar los parámetros "VPCId", "Subnet1" y "Subnet2" para definir su VPC o, si desea reutilizar una VPC de una implementación existente creada con esta herramienta o una plantilla de CloudFormation de Esri, puede especificar en su lugar el nombre de la implementación en el parámetro "NetworkStackName". A continuación se describen estos parámetros:
Parámetro | Descripción | ¿Obligatorio u opcional? |
---|---|---|
"VPCId" | Cuando creó su VPC, AWS le asignó un Id. con el formato vpc-xxxxxxxx. Indique aquí el Id. de su VPC. Si usa la utilidad ArcGIS Enterprise Cloud Builder CLI for AWS para preparar su implementación, este Id. aparece en el archivo de salida que se creó cuando ejecutó la utilidad con el comando PREP. | Obligatorio si no especifica el parámetro "NetworkStackName". |
"Subnet1" | El Id. de una de las subredes de su VPC. Si usa la utilidad ArcGIS Enterprise Cloud Builder CLI for AWS para preparar su implementación, este Id. aparece en el archivo de salida que se creó cuando ejecutó la utilidad con el comando PREP. | Obligatorio si no especifica el parámetro "NetworkStackName". |
"Subnet2" | El Id. de la segunda subred de su VPC. Si usa la utilidad ArcGIS Enterprise Cloud Builder CLI for AWS para preparar su implementación, este Id. aparece en el archivo de salida que se creó cuando ejecutó la utilidad con el comando PREP. | Obligatorio si no especifica el parámetro "NetworkStackName". |
"NetworkStackName" | La etiqueta de nombre asignada a una VPC existente. | Obligatorio si no especifican los parámetros "VPCId", "Subnet1" ni "Subnet2". |
Otros valores de parámetros definidos en el nodo "Default" son aplicables a algunos o todos los demás nodos del archivo JSON. Esri recomienda usar el nodo Default para definir parámetros y valores que sean comunes en varios nodos de la implementación. De esta forma, se reduce el archivo de configuración y se evita la repetición de parámetros y valores. Por ejemplo, si implementa un ArcGIS Enterprise base y un ArcGIS GeoEvent Server federado, especifique el parámetro "DeploymentBucket" en el nodo "Default", ya que todos los equipos usarán el mismo bucket. De forma similar, si tiene un certificado SSL de comodín, especifique los parámetros "SSLCertificateFile" y "SSLCertPassword" en el nodo "Default" para que los sitios los usen.
Como se muestra en el siguiente ejemplo, los parámetros "VPCId", "Subnet1" y "Subnet2" se utilizan para definir la VPC. El tamaño de la unidad raíz ("DriveSizeRoot"), el bucket de S3, el nombre de usuario y la contraseña del administrador, y la contraseña de los servicios de software ("RunAsUserPassword") se aplican a todas las partes de esta implementación. Dado que todos los sitios de ArcGIS Server de la implementación se federarán con el portal, "Federate": true también se incluye en el nodo "Default".
"CloudFormationParameters":{ "Default" :{
"VPCId": "vpc-b33fecd5", "Subnet1": "subnet-7a709d1c", "Subnet2": "subnet-26f0f76f", "DriveSizeRoot": "300",
"KeyName": "StackTest_Mine", "DBEngine": "none",
"DBInstanceClass": "db.m4.large", "DBAllocatedStorage": "200", "DeploymentBucket": "mydeployments", "SiteAdmin": "admin", "SiteAdminPassword": "changeit", "RunAsUserPassword": "Change@1234",
"PostInstallationScript": "none", "Federate": true }
}
Si define valores de parámetros en un nodo específico de la implementación, el valor que especifique en ese nodo se usa para esa parte de la implementación. Por ejemplo, si define el parámetro "InstanceType" en los nodos "BaseEnterprise" y "Default", el valor "InstanceType" definido en el nodo "BaseEnterprise" se usa para los equipos de la implementación base de ArcGIS Enterprise, pero el valor "InstanceType" definido para el nodo "Default" se usa para los sitios de ArcGIS GeoAnalytics Server, ArcGIS GIS Server, ArcGIS Image Server y ArcGIS GeoEvent Server que implemente utilizando este archivo JSON.
Parámetros de ArcGIS Enterprise base
Los valores de parámetros que especifica en el nodo "BaseEnterprise" se aplican solamente a pilas de ArcGIS Enterprise creadas con las plantillas de CloudFormation de Esri que implementan ArcGIS Enterprise. Puede usar cualquiera de los siguientes parámetros para la parte de ArcGIS Enterprise base de una implementación:
Parámetro | Descripción | ¿Obligatorio u opcional? |
---|---|---|
"DeploymentBucket" | El nombre del bucket de Amazon S3 en el que colocó sus archivos de licencia de ArcGIS y archivos de certificados SSL (.pfx). | Obligatorio si no lo especificó en el nodo "Default". |
"DriveSizeRoot" | El tamaño (en GB) de la unidad C: o raíz de los equipos de ArcGIS Enterprise. | Obligatorio si no lo especificó en el nodo "Default". |
"InstanceType" | El tipo de instancia de Amazon Elastic Compute Cloud que se usará para el equipo de ArcGIS Enterprise. | Obligatorio si implementa el ArcGIS Enterprise base en un solo equipo. (Cambie el parámetro "Type" a "AllInOne".) |
"FSInstanceType" | El tipo de instancia de Amazon Elastic Compute Cloud que se usará para el servidor de archivos. | Obligatorio si crea una implementación de ArcGIS Enterprise de alta disponibilidad. (Cambie el parámetro "Type" a "HA".) |
"ASInstanceType" | El tipo de instancia de Amazon Elastic Compute Cloud que se usará para el servidor de alojamiento. | Obligatorio si crea una implementación de ArcGIS Enterprise de alta disponibilidad. (Cambie el parámetro "Type" a "HA".) |
"BDSInstanceType" | El tipo de instancia de Amazon Elastic Compute Cloud que se usará para equipos de big data store espaciotemporal. | Obligatorio si no lo especificó en el nodo "Default". Aunque inicialmente no implemente ningún big data store espaciotemporal, debe especificar un tipo de instancia para que el escalado automático se configure en la pila. |
"BDSInstances" | El número de instancias de EC2 que se crearán para un big data store espaciotemporal. Puede especificar "0" si no desea incluir ningún big data store espaciotemporal en la implementación en este momento. De lo contrario, especifique el número de instancias que desee. | Obligatorio si no lo especificó en el nodo "Default". |
"KeyName" | El par de claves de Amazon Elastic Compute Cloud que permiten el acceso remoto a las instancias de EC2. | Obligatorio si no lo especificó en el nodo "Default". |
"StoreType" | El tipo de ubicación de almacenamiento para el almacén de configuración de ArcGIS Server y el directorio de contenido de Portal for ArcGIS. Para usar un equipo con EC2, cambie este parámetro a "FileSystem". Para usar un bucket de S3 para el directorio de contenido del portal y un bucket de S3 y una tabla Amazon DynamoDB para el directorio de contenido del portal, cambie este parámetro a "CloudStore". | Obligatorio si no lo especificó en el nodo "Default". |
"ServerLicenseFile" | El nombre del archivo de licencia de ArcGIS GIS Server para el servidor de alojamiento. Este archivo se debe cargar en el bucket de S3 que especificó para "DeploymentBucket". | Obligatorio si no lo especificó en el nodo "Default". |
"UserLicenseTypeID" | El archivo de licencia Portal for ArcGIS que recibe de Esri cuenta con identificadores (Id.) para los tipos de usuarios de los que tiene licencia para usar en su portal. Un subconjunto de estos Id. está disponible para su uso por parte del administrador inicial. Los Id. presentes en su archivo pueden variar, pero entre los Id. típicos se encuentran, entre otros, creatorUT, GISProfessionalStdUT y editorUT. Estos Id. distinguen entre mayúsculas y minúsculas, de modo que asegúrese de escribirlos como aparece en su archivo Portal for ArcGIS de licencia de .json. | Opcional. Si no se especifica ningún valor para "UserLicenseTypeID" y el archivo de licencia del portal contiene un solo tipo de usuario compatible, se asignará ese tipo de usuario a la cuenta del administrador inicial. Si el archivo de licencia contiene varios tipos de usuarios compatibles, se asignará un tipo de usuario temporal y el administrador inicial tendrá que seleccionar un tipo de usuario después de iniciar sesión en el portal. |
"PortalLicenseFile" | El nombre del archivo de licencia de Portal for ArcGIS. Este archivo se debe cargar en el bucket de S3 que especificó para "DeploymentBucket". | Obligatorio si no lo especificó en el nodo "Default". |
"SiteAdmin" | El nombre de usuario del administrador del sitio principal de ArcGIS Server y las cuentas de administrador iniciales de Portal for ArcGIS. | Obligatorio si no lo especificó en el nodo "Default". |
"SiteAdminPassword" | La contraseña de la cuenta del administrador del sitio. | Obligatorio si no lo especificó en el nodo "Default". |
"SiteEIPAllocationID" | El Id. de asignación de la dirección IP elástica de la VPC que especificó en los parámetros de CloudFormation de "Default". | Obligatorio si implementa el ArcGIS Enterprise base en un solo equipo. (Cambie el parámetro "Type" a "AllInOne".) |
"RunAsUserPassword" | La contraseña de la cuenta utilizada para ejecutar ArcGIS Server, Portal for ArcGIS y los servicios de ArcGIS Data Store Windows. El nombre de inicio de sesión siempre es ArcGIS. | Obligatorio si realiza la implementación en equipos con Windows (cambie el parámetro "OperatingSystem" de "DeploymentDetails" a "Windows") y no especificó este parámetro en el nodo "Default". |
"SSLCertificateFile" | El archivo de certificado SSL emitido al dominio del sitio. Debe ser un archivo .pfx que cargó en el bucket de S3 que especificó para "DeploymentBucket". | Obligatorio si no lo especificó en el nodo "Default". |
"SSLCertPassword" | La contraseña del certificado SSL. | Obligatorio si no lo especificó en el nodo "Default". |
"SiteDomain" | El nombre de dominio de su implementación. Si utiliza AWS Route 53 para administrar sus servidores de nombre de dominio y, por tanto, ha configurado el parámetro "AWSR53ZoneId" en los ajustes de parámetros DNS, puede especificar un nombre de subdominio. Si no especifica un nombre de subdominio, se usará el nombre de dominio basado en el formato de nombre predeterminado. Si no va a usar AWS Route 53 para administrar sus servidores de nombre de dominio y no configuró el parámetro "AWSR53ZoneId", debe especificar un nombre de dominio totalmente calificado para el parámetro "SiteDomain". Si utiliza su propio servidor DNS para administrar su nombre de dominio en lugar de usar AWS Route 53, asegúrese de que el nombre de dominio ("SiteDomain") esté asignado al Elastic Load Balancer o dirección IP elástica adecuados en su DNS antes de ejecutar ArcGIS Enterprise Cloud Builder CLI for AWS, para que el nombre de dominio sea válido en el momento de la federación. Puede crear Elastic Load Balancers (con la Consola de administración de AWS o plantillas de CloudFormation de AWS de Esri) o direcciones IP elásticas (con la Consola de administración de AWS). | Obligatorio si no lo especificó en el nodo "Default". |
"PostInstallationScript" | El nombre de un archivo ZIP que contiene un script de postinstalación personalizado o, si no dispone de un script personalizado, cambie este parámetro a "NONE". Si utiliza un script de postinstalación personalizado, debe cargar el archivo ZIP en el bucket de Amazon S3 que especificó para "DeploymentBucket". | Obligatorio si no lo especificó en el nodo "Default". |
"TemplateURL" | Si desea utilizar su propia plantilla de CloudFormation para esta implementación en lugar de las plantillas suministradas por Esri, puede definir su plantilla. Proporcione una URL HTTPS válida. | Es opcional, pero si especifica este parámetro, debe estar especificado en el nodo "BaseEnterprise", no en el nodo "Default". |
"Type" | Los valores posibles son "AllInOne", para implementar todas las partes de la implementación en un solo equipo, o "HA", para crear una implementación de alta disponibilidad. | Requerido. Debe especificar este parámetro en el nodo "BaseEnterprise", no en el nodo "Default". |
"ELBName" | Especifique el nombre de un Elastic Load Balancer existente creado con plantillas de CloudFormation de AWS de Esri o cambie este parámetro a "NEW_ELB" para crear y usar uno nuevo. Si cambia "ELBName" a "NEW_ELB", AWS asigna un nombre al equilibrador de carga que crea. Debe escribir "NEW_ELB" como se muestra, todo en mayúsculas. | Obligatorio si crea una implementación de ArcGIS Enterprise de alta disponibilidad (cambie el parámetro "Type" a "HA"). |
Parámetros para sitios de ArcGIS GeoAnalytics Server, ArcGIS Image Server y ArcGIS GIS Server y los servidores de alojamiento de imágenes y de análisis de ráster.
Los valores de parámetros que especifica en los nodos "GeoAnalytics", "RasterAnalytics", "ImageHosting", "ImageServer" y "Server" utilizan plantillas de CloudFormation de Esri que lanzan sitios de ArcGIS Server federados o independientes. Tenga en cuenta que los sitios de ArcGIS GeoAnalytics Server deben estar siempre federados con un portal de ArcGIS Enterprise y que para usar un sitio de ArcGIS Image Server como servidor de análisis de ráster o como servidor de alojamiento de imágenes, el sitio debe estar federado con un portal.
Cuando crea sitios de ArcGIS GeoAnalytics Server o ArcGIS Image Server federados, la utilidad ArcGIS Enterprise Cloud Builder CLI for AWS configura estos sitios como servidores de GeoAnalytics, de análisis de ráster y de alojamiento de imágenes de su portal respectivamente; no es necesario configurar esto manualmente.
En la siguiente tabla se enumeran todos los parámetros posibles que puede configurar en los nodos "GeoAnalytics", "RasterAnalytics", "ImageHosting", "ImageServer" y "Server".
Parámetro | Descripción | ¿Obligatorio u opcional? |
---|---|---|
"ServerLicenseFile" | El archivo .prvc o .epc para asignar licencias a su sitio de ArcGIS GeoAnalytics Server, ArcGIS Image Server o ArcGIS GIS Server. | Obligatorio |
"CloudStoreS3BucketPath" | La ruta del bucket en el formato <bucket_name>/<folder_name>. Cuando se usa en los nodos "RasterAnalytics" y "ImageHosting", la utilidad registra esta ubicación como almacén de rásteres del sitio. Cuando se usa en otros nodos, la utilidad registra la ubicación especificada como almacén en la nube. Debe especificar la ubicación en el formato indicado: <bucket_name>/<folder_name>. Asegúrese de que el bucket de S3 exista y se puede acceder a él con las credenciales de AWS que proporciona en el nodo "AWSCredentials". Si el <folder_name> que especifica no existe en el bucket, la utilidad la crea. | Obligatorio para el sitio de ArcGIS Image Server que utiliza como servidor de análisis de ráster del portal. Este parámetro es opcional si crea un sitio de ArcGIS Image Server o ArcGIS GIS Server independiente o federado. Nota:Si su implementación incluye nodos "RasterAnalytics" y "ImageHosting" y tiene pensado utilizar el mismo almacén de rásteres para ambos, utilice el mismo valor para el parámetro "CloudStoreS3BucketPath" en estos dos nodos. |
"Federate" | Especifica si el sitio se federará (true) con su implementación base de ArcGIS Enterprise o si será un sitio independiente (false). Debe definir "Federate" como true al crear un sitio de ArcGIS GeoAnalytics Server. Si no especifica este parámetro en el archivo de configuración de la implementación, el valor predeterminado es false. | Obligatorio |
"DeploymentBucket" | El nombre del bucket de S3 en el que colocó sus archivos de licencia de ArcGIS y archivos de certificados SSL (.pfx). | Obligatorio si no lo especificó en el nodo "Default". |
"DriveSizeRoot" | El tamaño (en GB) de la unidad C: o raíz de los equipos de ArcGIS GeoAnalytics Server, ArcGIS Image Server o ArcGIS GIS Server. | Obligatorio si no lo especificó en el nodo "Default". |
"FSInstanceType" | El tipo de instancia de Amazon Elastic Compute Cloud que se usará para el servidor de archivos. | Obligatorio si no lo especificó en el nodo "Default". |
"ASInstanceType" | El tipo de instancia de Amazon Elastic Compute Cloud que se usará para los equipos de ArcGIS GeoAnalytics Server, ArcGIS Image Server o ArcGIS GIS Server. | Obligatorio si no lo especificó en el nodo "Default". |
"ASInstances" | El número de instancias de Amazon Elastic Compute Cloud lanzadas por AutoScaling. Este número debería ser el mismo que los equipos que componen un sitio de ArcGIS Server. | Obligatorio si no lo especificó en el nodo "Default". |
"KeyName" | El par de claves de Amazon Elastic Compute Cloud que permiten el acceso remoto a las instancias de EC2. | Obligatorio si no lo especificó en el nodo "Default". |
"StoreType" | El tipo de ubicación de almacenamiento para el almacén de configuración del sitio de ArcGIS Server. Para usar un equipo con EC2, cambie este parámetro a "FileSystem". Para usar un bucket de S3 para el directorio de contenido del portal y un bucket de S3 y una tabla Amazon DynamoDB para el directorio de contenido del portal, cambie este parámetro a "CloudStore". | Obligatorio si no lo especificó en el nodo "Default". |
"SiteAdmin" | El nombre de usuario del administrador del sitio principal de ArcGIS Server. | Obligatorio si no lo especificó en el nodo "Default". |
"SiteAdminPassword" | La contraseña de la cuenta del administrador del sitio. | Obligatorio si no lo especificó en el nodo "Default". |
"RunAsUserPassword" | La contraseña de la cuenta utilizada para ejecutar el servicio ArcGIS Server de Windows. El nombre de inicio de sesión siempre es ArcGIS. | Obligatorio si realiza la implementación en equipos con Windows (cambie el parámetro "OperatingSystem" de "DeploymentDetails" a "Windows") y no especificó este parámetro en el nodo "Default". |
"ELBName" | Especifique el nombre de un Elastic Load Balancer existente creado con plantillas de CloudFormation de AWS de Esri o cambie este parámetro a "NEW_ELB" para crear y usar uno nuevo. Si cambia "ELBName" a "NEW_ELB", AWS asigna un nombre al equilibrador de carga que crea. Debe escribir "NEW_ELB" como se muestra, todo en mayúsculas. | Obligatorio si no lo especificó en el nodo "Default". |
"SSLCertificateARN" | Amazon Resource Name (ARN) del certificado SSL emitido para el dominio del sitio. | Obligatorio solamente si no utiliza un Elastic Load Balancer existente. |
"SiteDomain" | El nombre de dominio de su implementación. Si utiliza AWS Route 53 para administrar sus servidores de nombre de dominio (DNS) y, por tanto, ha configurado el parámetro "AWSR53ZoneId" en los ajustes de parámetros DNS, puede especificar un nombre de subdominio. Si no especifica un nombre de subdominio, se usará el nombre de dominio basado en el formato de nombre predeterminado. | Obligatorio si utiliza su propio servidor DNS para administrar su nombre de dominio en lugar de utilizar AWS Route 53. |
"DBEngine" | Si implementa instancias de Windows Amazon Elastic Compute Cloud, puede cambiar este parámetro a uno de los siguientes:
Si implementa instancias de Ubuntu Amazon Elastic Compute Cloud, puede cambiar este parámetro a "none", "aurora-postgresql" o "postgres". | Obligatorio si no lo especificó en el nodo "Default". |
"DBInstanceClass" | La clase de instancia de una instancia de servicio de base de datos relacional de Amazon. | Obligatorio si no especificó este parámetro en el nodo "Default" y cambió "DBEngine" a "sqlserver-se", "postgres" o "aurora-postgresql". |
"DBAllocatedStorage" | El tamaño de almacenamiento asignado (en GB) de una instancia de servicio de base de datos relacional de Amazon. | Obligatorio si no especificó este parámetro en el nodo "Default" y cambio "DBEngine" a "sqlserver-se" o "postgres". |
"PostInstallationScript" | El nombre de un archivo ZIP que contiene un script de postinstalación personalizado o, si no dispone de un script personalizado, cambie este parámetro a "NONE". Si utiliza un script de postinstalación personalizado, debe cargar el archivo ZIP en el bucket de Amazon S3 que especificó para "DeploymentBucket". | Obligatorio si no lo especificó en el nodo "Default". |
"TemplateURL" | Si desea utilizar su propia plantilla de CloudFormation para esta implementación en lugar de las plantillas suministradas por Esri, puede definir su plantilla. Proporcione una URL HTTPS válida. | Opcional. Si especifica este parámetro, debe hacerlo en el nodo de servidor concreto ("GeoAnalytics", "RasterAnalytics", "ImageHosting", "ImageHosting" o "Server"), no en el nodo "Default". |
Parámetros de sitios de ArcGIS GeoEvent Server
Los valores de parámetros que especifica en el nodo "GeoEvent" utilizan la plantilla de CloudFormation de ArcGIS GeoEvent Server de Esri.
En la siguiente tabla se enumeran todos los parámetros posibles que puede configurar en el nodo "GeoEvent".
Parámetro | Descripción | ¿Obligatorio u opcional? |
---|---|---|
"ServerLicenseFile" | El archivo .prvc o .ecp para asignar licencias a su sitio de ArcGIS GeoEvent Server. | Obligatorio |
"Federate" | Especifica si el sitio se federará (true) con su implementación base de ArcGIS Enterprise o si será un sitio independiente (false). Si no especifica este parámetro en el archivo de configuración de la implementación, el valor predeterminado es false. | Obligatorio si no lo especificó en el nodo "Default". |
"DeploymentBucket" | El nombre del bucket de S3 en el que colocó sus archivos de licencia de ArcGIS y archivos de certificados SSL (.pfx). | Obligatorio si no lo especificó en el nodo "Default". |
"DriveSizeRoot" | El tamaño (en GB) de la unidad C: o raíz de los equipos de ArcGIS GeoEvent Server. | Obligatorio si no lo especificó en el nodo "Default". |
"ASInstanceType" | El tipo de instancia de Amazon Elastic Compute Cloud que se usará para los equipos de ArcGIS GeoEvent Server. | Obligatorio si no lo especificó en el nodo "Default". |
"FSInstanceType" | El tipo de instancia de Amazon Elastic Compute Cloud que se usará para el servidor de archivos. | Obligatorio si no lo especificó en el nodo "Default". |
"ELBName" | Especifique el nombre de un Elastic Load Balancer que se creó con la plantilla de CloudFormation de AWS de Esri, o defina este parámetro como "NEW_ELB" para crear y utilizar un nuevo Elastic Load Balancer. Si cambia "ELBName" a "NEW_ELB", AWS asigna un nombre al equilibrador de carga que crea. Debe escribir "NEW_ELB" como se muestra, todo en mayúsculas. | Obligatorio si no lo especificó en el nodo "Default". |
"KeyName" | El par de claves de Amazon Elastic Compute Cloud que permiten el acceso remoto a las instancias de EC2. | Obligatorio si no lo especificó en el nodo "Default". |
"SiteAdmin" | El nombre de usuario del administrador del sitio principal de ArcGIS Server. | Obligatorio si no lo especificó en el nodo "Default". |
"SiteAdminPassword" | La contraseña de la cuenta del administrador del sitio. | Obligatorio si no lo especificó en el nodo "Default". |
"RunAsUserPassword" | La contraseña de la cuenta utilizada para ejecutar el servicio ArcGIS Server de Windows. El nombre de inicio de sesión siempre es ArcGIS. | Obligatorio si realiza la implementación en equipos con Windows (cambie el parámetro "OperatingSystem" de "DeploymentDetails" a "Windows") y no especificó este parámetro en el nodo "Default". |
"SSLCertificateFile" | El archivo de certificado SSL emitido al dominio del sitio. Debe ser un archivo .pfx que cargó en el bucket de S3 que especificó para "DeploymentBucket". | Obligatorio si no lo especificó en el nodo "Default". |
"SSLCertPassword" | La contraseña del certificado SSL. | Obligatorio si no lo especificó en el nodo "Default". |
"SiteDomain" | El nombre de dominio de su implementación. Si utiliza AWS Route 53 para administrar sus servidores de nombre de dominio (DNS) y, por tanto, ha configurado el parámetro "AWSR53ZoneId" en los ajustes de parámetros DNS, puede especificar un nombre de subdominio. Si no especifica un nombre de subdominio, se usará el nombre de dominio basado en el formato de nombre predeterminado. | Obligatorio si utiliza su propio servidor DNS para administrar su nombre de dominio en lugar de utilizar AWS Route 53. |
"PostInstallationScript" | El nombre de un archivo ZIP que contiene un script de postinstalación personalizado o, si no dispone de un script personalizado, cambie este parámetro a "NONE". Si utiliza un script de postinstalación personalizado, debe cargar el archivo ZIP en el bucket de S3 que especificó para "DeploymentBucket". | Obligatorio si no lo especificó en el nodo "Default". |
"TemplateURL" | Si desea utilizar su propia plantilla de CloudFormation para esta implementación en lugar de las plantillas suministradas por Esri, puede definir su plantilla. Proporcione una URL HTTPS válida. | Opcional. Debe especificar este parámetro en el nodo "GeoEvent", no en el nodo "Default". |
Parámetros de DNS
Si utiliza AWS Route 53 para administrar sus servidores de nombre de dominio (DNS), debe definir un Id. de zona de AWS Route 53 en el nodo "DNSParameters". Cuando ejecuta la utilidad ArcGIS Enterprise Cloud Builder CLI for AWS, actualiza el DNS para asignar cada nombre de dominio ("SiteDomain") al Elastic Load Balancer (ELB) o dirección IP elástica (EIP) adecuado.
Este parámetro es obligatorio si utiliza AWS Route 53. Si no utiliza AWS Route 53, puede dejar este parámetro vacío.
En este ejemplo, la zona ZUJQ3S2DAL123 de AWS Route 53 se asignará a la dirección IP elástica que especificó para el parámetro "SiteDomain" de la implementación base."DNSParameters":{
"AWSR53ZoneId": "ZUJQ3S2DAL123"
}