Configuring input.json

Configura el archivo input.json con los productos, la infraestructura, los certificados y la configuración avanzada de UiPath para Automation Suite.

El archivo input.json te permite configurar los productos de UiPath® que quieres implementar, los parámetros, configuración y preferencias aplicados a los productos seleccionados y la configuración de tu infraestructura en la nube. Debes actualizar este archivo para cambiar los valores predeterminados y utilizar cualquier configuración avanzada para tu clúster.

Nota:

Some products might have dependencies. For details, refer to Automation Suite products.

Para editar input.json, puede usar su editor de texto favorito en su máquina cliente.

La siguiente tabla describe los principales parámetros input.json que debes actualizar para configurar Automation Suite correctamente.

Parámetros generales	Descripción
kubernetes_distribution	La distribución de Kubernetes que utilizas. Para Automation Suite en OpenShift, el valor es openshift.
install_type	Determina si el clúster se implementa en línea o sin conexión. Si no se especifica, el clúster se implementa en modo en línea. Para implementar el clúster en modo sin conexión, debes establecer explícitamente el valor del parámetro install_type en offline. Valores posibles: online o offline Valor predeterminado: online
registries	URL para extraer las imágenes de docker y gráficos de helm para los productos de UiPath® y Automation Suite. registry.uipath.com
istioMinProtocolVersion	La versión mínima del protocolo TLS aceptada por Istio para comunicaciones seguras. Se puede establecer como TLSV1_2 o TLSV1_3.
fqdn	El nombre de dominio completo para acceder al producto. Asegúrate de que Istio Ingress puede acceder al FQDN.
admin_username	El nombre de usuario que te gustaría establecer como administrador de la organización anfitriona.
admin_password	La clave de administrador del host que se establecerá.
profile	Valor predeterminado, no modificable: - ha: perfil de producción multinodo preparado para alta disponibilidad.
network	Enables IPv4/IPv6 operation for the cluster networking stack used by Automation Suite. For details, refer to Networking.
telemetry_optout	true o false : se utiliza para cancelar el envío de telemetría a UiPath®. Está establecido en false de forma predeterminada. Si quieres excluirte, establécelo en true.
fips_enabled_nodes	Indica si quieres habilitar FIPS 140-2 en los nodos en los que planeas instalar Automation Suite. Los valores posibles son true y false.
storage_class	Especifique la clase de almacenamiento que se utilizará para el aprovisionamiento de PV. Esta clase de almacenamiento debe admitir varias réplicas para una alta disponibilidad óptima y poseer capacidades de copia de seguridad. For details, refer to the Block storage section.
storage_class_single_replica	Proporcione la clase de almacenamiento que se utilizará para el aprovisionamiento de PV. Esta clase de almacenamiento puede tener una única réplica para los componentes que no requieren alta disponibilidad. La clase de almacenamiento no puede tener capacidades de copia de seguridad. For details, refer to the File storage section. El valor storage_class_single_replica puede ser el mismo que el valor storage_class .
storage_class_name_with_rwx_support	Especifica la ClaseDeAlmacenamiento que admite el modo de acceso ReadWriteMany (RWX). Este campo garantiza que los componentes que requieren volúmenes persistentes compartidos utilicen el almacenamiento habilitado para RWX correcto. Este campo no puede estar vacío si Studio Web o ECS están habilitados. Si se deja vacío, se produce un error durante la validación. Para instalaciones nuevas, proporciona un nombre de ClaseDeAlmacenamiento compatible con RWX (ReadWriteMany). Para actualizaciones de versiones anteriores a la 2.2510.0 utilizando Studio Web, utiliza el mismo nombre de clase de almacenamiento que se especifica en storage_class_single_replica, asegurándote de que admite el modo de acceso RWX.
exclude_components	Utiliza este parámetro para evitar que se instalen componentes no esenciales. For details, refer to Bring your own components.
namespace	Especifique el espacio de nombres donde desea instalar Automation Suite. For details, refer to Custom namespace configuration.
argocd.application_namespace	El espacio de nombres de la aplicación que planeas instalar. Idealmente, debería ser el mismo que el espacio de nombres en el que planeas instalar Automation Suite.
argocd.project	El proyecto ArgoCD necesario para implementar Automation Suite. Esto solo es necesario si quieres utilizar la instancia de ArgoCD compartida o global en lugar de una instancia de ArgoCD dedicada.
workload_resources	Configures CPU and memory requests and limits for workloads created by uipathctl. For details, refer to Configuring resource requests and limits for uipathctl-created workloads.

For a configuration example, refer to input.json example.

Productos de UiPath®

You can enable and disable products in Automation Suite at the time of installation and at any point post-installation. For details on each product configuration, refer to Managing products.

Ejemplo de Orchestrator:

"orchestrator": {
  "enabled": true,
  "external_object_storage": {
    "bucket_name": "uipath-as-orchestrator"
  },
  "testautomation": {
    "enabled": true
  },
  "updateserver": {
    "enabled": true
  }

Traiga sus propios componentes

Automation Suite te permite traer tus propias políticas de Gatekeeper y OPA, Cert Manager, Istio, supervisión, componentes de registro y más. Si decides excluir estos componentes, asegúrate de que estén disponibles en tu clúster antes de instalar Automation Suite.

• For the list of optional components and responsibility matrix, refer to Automation Suite stack.
• Make sure to review the compatibility matrix for versions that are validated with Automation Suite.

El siguiente ejemplo muestra una lista de componentes excluidos. Puede eliminar los componentes que desea que Automation Suite aprovisione.

"exclude_components": [
    "argocd",
    "monitoring",
    "istio",
    "istio-configure",
    "logging",
    "gatekeeper",
    "network-policies",
    "velero",
    "alerts",
    "cert-manager",
    "external-secrets"
]

Excluir Istio

If you bring your own Istio component, make sure to include the gateway_selector labels from your Istio gateway in the input.json file. Starting from Automation Suite 2.2510.2, you can also set the istio_gateway_service_name parameter in the ingress section of input.json to configure the Istio ingress gateway service name. For details, refer to OpenShift input.json example.

Para encontrar la etiqueta del selector de puerta de enlace, realiza los siguientes pasos:

1. Enumera todos los pods en el espacio de nombres <istio-system> ejecutando el comando oc get pods -n <istio-system> .
2. Encuentra el que se adapte a tu implementación de la puerta de enlace de Istio.

Nota:

Si planeas instalar el complemento WASM tú mismo y quieres evitar proporcionar al instalador de Automation Suite acceso de escritura al espacio de nombres <istio-system> , debes añadir el componente istio-configure a la lista exclude_components .

Excluir Cert Manager

Si eliges traer tu propio Cert Manager y tu certificado TLS lo emite una CA privada o no pública, debes incluir manualmente tanto el certificado de la hoja como los certificados de la CA intermedios en el archivo de certificado TLS. En el caso de las CA públicas, los sistemas cliente confían automáticamente en ellas, y no se requiere ninguna otra acción adicional por tu parte.

Sin roles de clúster

Si concedes al instalador de Automation Suite solo permisos de ámbito de espacio de nombres, sin ningún rol de clúster, debes traer tus propios componentes. En este flujo, el instalador no puede implementar o gestionar componentes que crean recursos en el ámbito del clúster, por lo que debes aprovisionar esos componentes en el clúster tú mismo y excluirlos. Para ver el modelo de permisos completo, consulta Conceder permisos de instalación sin roles de clúster.

Añade lo siguiente a tu input.json:

• Enumera los componentes que proporcionas tú mismo en exclude_components.
• Establece telemetry_optout en true. La telemetría no se puede habilitar en este flujo porque requiere permisos de ámbito de clúster que uipathadmin no tiene.

{
  "exclude_components": [
    "argocd",
    "istio",
    "istio-configure",
    "logging",
    "monitoring",
    "gatekeeper",
    "velero",
    "alerts",
    "cert-manager",
    "network-policies",
    "external-secrets"
  ],
  "telemetry_optout": true
}

Configuración de certificados

Si no se proporciona un certificado en el momento de la instalación, el instalador crea certificados y los configura en el clúster.

Nota:

Los certificados pueden crearse en el momento de la instalación solo si concedes privilegios de administrador al instalador de Automation Suite durante la instalación. Si no puedes conceder privilegios de administrador al instalador, debes crear y gestionar los certificados tú mismo.

For details on how to obtain a certificate, refer to Managing the certificates.

Nota:

Asegúrese de especificar la ruta absoluta de los archivos de certificado. Ejecute pwd para obtener la ruta del directorio donde se encuentran los archivos y añada el nombre del archivo de certificado a input.json.

Parámetro	Descripción
server_certificate.ca_cert_file	Ruta absoluta al certificado de Autoridad de certificación (AC). Esta AC es la autoridad que firma el certificado TLS. Un paquete de CA debe contener solo los certificados de cadena utilizados para firmar el certificado TLS. El límite de la cadena es de nueve certificados. Si utilizas un certificado autofirmado, debes especificar la ruta a rootCA.crt, que creaste previamente. Déjalo en blanco si quieres que lo genere el instalador.
server_certificate.tls_cert_file	Ruta absoluta al certificado TLS (server.crt es el certificado autofirmado). Déjalo en blanco si quieres que lo genere el instalador. Si proporcionas el certificado tú mismo, el archivo server.crt debe contener toda la cadena, como se muestra en el siguiente ejemplo: -----server cert----- -----root ca chain-----
server_certificate.tls_key_file	Ruta absoluta a la clave de certificado (server.key es el certificado autofirmado). Déjalo en blanco si quieres que lo genere el instalador.
identity_certificate.token_signing_cert_file	Ruta absoluta al certificado de firma del token de identidad utilizado para firmar tokens (identity.pfx es el certificado autofirmado). Déjelo en blanco si desea que el instalador genere un certificado de identidad utilizando el certificado del servidor.
identity_certificate.token_signing_cert_pass	Contraseña de texto sin formato establecida al exportar el certificado de firma del token de identidad.
additional_ca_certs	Ruta absoluta al archivo que contiene los certificados AC adicionales que desea que sean de confianza para todos los servicios que se ejecutan como parte de Automation Suite. Todos los certificados del archivo deben tener un formato PEM válido. Por ejemplo, debe proporcionar el archivo que contiene el certificado AC del servidor SQL si el certificado no ha sido emitido por una autoridad de certificación pública.

Requisitos previos de infraestructura

Debes proporcionar detalles de configuración de los requisitos previos que configuraste en Azure o AWS. Para input.json los requisitos de los parámetros, consulta las siguientes secciones de requisitos previos:

• SQL database (mandatory)
• Caching (mandatory)
• Storage (mandatory)
• Proxy configuration (optional)

Configuración del almacén de objetos externo

Configuración general

Automation Suite le permite traer su propio proveedor de almacenamiento externo. Puede elegir entre los siguientes proveedores de almacenamiento:

• Azure
• AWS
• Compatible con S3

Puedes configurar el almacenamiento de objetos externos de una de las siguientes formas:

• durante la instalación;
• después de la instalación, utilizando el archivo input.json .

Nota:

• Para que Automation Suite funcione correctamente al utilizar URL prefirmadas, debes asegurarte de que tu almacén de objetos externo sea accesible desde el clúster de Automation Suite, los navegadores y todas tus máquinas, incluidas las estaciones de trabajo y las máquinas robot.
• El cifrado del lado del servidor con el servicio de gestión de claves (SSE-KMS) solo puede habilitarse en los depósitos de Automation Suite implementados en cualquier región creada después del 30 de enero de 2014. La funcionalidad SSE-KMS requiere API SignV4 puras. Las regiones creadas antes del 30 de enero de 2014 no utilizan API SignV4 puras debido a la compatibilidad con versiones anteriores de SignV2. Por lo tanto, SSE-KMS solo es funcional en las regiones que utilizan SignV4 para la comunicación. Para averiguar cuándo se aprovisionaron las diversas regiones, consulta la documentación de AWS.

Si utilizas un Punto final privado para acceder al contenedor, debes añadir el parámetro fqdn en el archivo input.json y especificar el Punto final privado como valor.

La siguiente tabla enumera los parámetros input.json que puedes usar para configurar cada proveedor de almacenamiento de objetos externo:

Parámetro	Azure	AWS	Compatible con S3	Descripción
external_object_storage.enabled	✅	✅	✅	Especifique si desea traer su propio almacén de objetos. Valores posibles: true y false.
external_object_storage.create_bucket	✅	✅	✅	Especifique si desea aprovisionar el depósito. Valores posibles: true y false.
external_object_storage.storage_type	✅	✅	✅	Especifica el proveedor de almacenamiento que deseas configurar. El valor distingue entre mayúsculas y minúsculas. Valores posibles: azure y s3. Muchos almacenes de objetos de S3 requieren el conjunto de CORS para todo el tráfico del clúster de Automation Suite. Debe configurar la política CORS en el nivel de almacén de objetos para permitir el FQDN del clúster.
external_object_storage.fqdn	❌	✅	✅	Especifique el FQDN del servidor S3. Obligatorio en el caso de la instancia de AWS y el perfil que no es de instancia.
external_object_storage.port	❌	✅	✅	Especifique el puerto S3. Obligatorio en el caso de la instancia de AWS y el perfil que no es de instancia.
external_object_storage.region	❌	✅	✅	Especifica la región de AWS donde se alojan los depósitos. Obligatorio en el caso de la instancia de AWS y el perfil que no es de instancia.
external_object_storage.access_key	❌	✅	✅	Especifique la clave de acceso para la cuenta S3. Obligatorio en el caso del perfil que no es de instancia de AWS.
external_object_storage.secret_key	❌	✅	✅	Especifique la clave secreta para la cuenta S3. Obligatorio en el caso del perfil que no es de instancia de AWS.
external_object_storage.use_instance_profile	❌	✅	✅	Especifica si quieres utilizar un perfil de instancia. Un perfil de instancia de AWS Identity and Access Management (IAM) otorga acceso seguro a los recursos de AWS para las aplicaciones o servicios que se ejecutan en instancias de Amazon Elastic Compute Cloud (EC2). Si optas por AWS S3, un perfil de instancia permite que una instancia EC2 interactúe con los depósitos de S3 sin la necesidad de que se almacenen en la instancia las credenciales de AWS explícitas (como las claves de acceso).
external_object_storage.bucket_name_prefix1	❌	✅	✅	Indica el prefijo para los nombres de los depósitos. Opcional en el caso del perfil sin instancia de AWS.
external_object_storage.bucket_name_suffix1	❌	✅	✅	Indique el sufijo de los nombres de depósito. Opcional en el caso del perfil sin instancia de AWS.
external_object_storage.account_key	✅	❌	❌	Especifique la clave de la cuenta de Azure.
external_object_storage.account_name	✅	❌	❌	Especifique el nombre de la cuenta de Azure.
external_object_storage.azure_fqdn_suffix	✅	❌	❌	Especifica el sufijo FQDN de Azure. Parámetro opcional.

¹ Al configurar el almacenamiento de objetos externo, debes seguir las reglas y convenciones de nomenclatura de tu proveedor tanto para bucket_name_prefix como bucket_name_suffix. Además, el sufijo y el prefijo deben tener una longitud combinada de no más de 25 caracteres, y no debes terminar el prefijo o comenzar el sufijo con un guion (-), ya que ya añadimos el carácter automáticamente.

Para garantizar una comunicación segura y compatible con Automation Suite, tu almacén de objetos compatible con S3 debe admitir uno o más de los siguientes conjuntos de cifrado TLS seguros:

• TLS 1.3:
  • TLS_AES_128_GCM_SHA256
  • TLS_AES_256_GCM_SHA384
  • TLS_CHACHA20_POLY1305_SHA256
• TLS 1.2:
  • TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA
  • TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA
  • TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA
  • TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA
  • TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256
  • TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384
  • TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256
  • TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
  • TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256
  • TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256

Nota:

La lista de conjuntos de cifrado compatibles puede evolucionar con el tiempo para alinearse con las mejores prácticas de seguridad y las actualizaciones en la biblioteca criptográfica de Go. Para obtener la lista actualizada, consulta la documentación de Go.

Configuración específica del producto

You can use the parameters described in the General configuration section to update the general Automation Suite configuration. This means that all installed products would share the same configuration.

Si deseas configurar uno o más productos de forma diferente, puedes anular la configuración general. Solo tienes que especificar los productos para los que deseas configurar el almacenamiento de objetos externo de forma diferente y utilizar los mismos parámetros para definir tu configuración. Ten en cuenta que todos los demás productos instalados seguirían heredando la configuración general.

El siguiente ejemplo muestra cómo anular la configuración general de Orchestrator:

"external_object_storage": {
  "enabled": false, // <true/false>
  "create_bucket": true, // <true/false>
  "storage_type": "s3", // <s3,azure,aws>
  "fqdn": "",  // <needed in the case of aws instance and non-instance profile>
  "port": 443, // <needed in the case of aws instance and non-instance profile>
  "region": "", 
  "access_key": "", // <needed in the case of aws non instance profile>
  "secret_key": "", // <needed in the case of aws non instance profile>
  "bucket_name_prefix": "",
  "bucket_name_suffix": "",
  "account_key": "",
  "account_name": "",
  "azure_fqdn_suffix": "core.windows.net",
},

"orchestrator": {
  "external_object_storage": {
    "enabled": false, // <true/false>
    "create_bucket": true, // <true/false>
    "storage_type": "s3", // <s3,azure>
    "fqdn": "",  // <needed in the case of aws instance and non-instance profile>
    "port": 443, // <needed in the case of aws instance and non-instance profile>
    "region": "", 
    "access_key": "", // <needed in case of aws non instance profile>
    "secret_key": "", // <needed in case of aws non instance profile>
    "bucket_name_prefix": "",
    "bucket_name_suffix": "",
    "account_key": "",
    "account_name": "",
    "azure_fqdn_suffix": "core.windows.net",
  }
}

Rotating the blob storage credentials for Process Mining

To rotate the blob storage credentials for Process Mining in Automation Suite the stored secrets must be updated with the new credentials. Refer to Rotating blob storage credentials.

Configuración de URL prefirmada

Puedes utilizar el marcador disable_presigned_url para especificar si te gustaría deshabilitar el acceso a la URL prefirmada en el nivel global. De forma predeterminada, las URL prefirmadas están habilitadas para toda la plataforma. Los posibles valores son: true y false.

{
  "disable_presigned_url" : true
}

Nota:

• Solo puedes cambiar el valor predeterminado de este parámetro en las nuevas instalaciones. La operación es irreversible y no se aplica a un clúster existente.
• Puedes aplicar esta configuración solo a toda la plataforma. No puedes anular la configuración global en el nivel de producto.

Configuración de registro externo compatible con OCI

Para configurar un registro externo compatible con OCI, actualiza los siguientes parámetros en el archivo input.json:

Claves	Valor
registries.docker.url	Valor predeterminado: registry.uipath.com la URL o FQDN del registro que Automation Suite utilizará para alojar las imágenes del contenedor.
registries.docker.username registries.docker.password	Información de autenticación que se utilizará para extraer las imágenes de Docker del registro. Si uno de los valores se encuentra en el archivo de entrada, debes proporcionar ambos al configurar el registro externo.
registries.docker.pull_secret_value	El secreto de extracción del registro. Este campo es opcional.
registries.helm.url	Valor predeterminado: registry.uipath.com la URL o FQDN del registro que Automation Suite utilizará para alojar el diagrama de Helm del servicio.
registries.helm.username registries.helm.password	Información de autenticación que se utilizará para extraer diagramas de Helm del registro. Si uno de los valores se encuentra en el archivo de entrada, debes proporcionar ambos al configurar el registro externo.
registry_ca_cert	La ubicación del archivo CA correspondiente al certificado configurado para el registro. Si el registro está firmado por una autoridad de certificación privada alojada en tus instalaciones, debes proporcionarlo para establecer la confianza.
registries.docker.pull_secret_name	El nombre del secreto de Kubernetes que almacena las credenciales de registro. Utiliza este parámetro para hacer referencia a un secreto existente que contiene la información de autenticación para el registro.

Nota:

Puedes utilizar diferentes métodos para generar la versión codificada del pull_secret_value, incluido el que utiliza Docker.

La siguiente muestra de configuración muestra una definición de secreto de Kubernetes utilizada para almacenar las credenciales de registro:

apiVersion: v1
kind: Secret
metadata:
  name: registry-credentials
data:
  url: base64Encode(sfbrdevhelmweacr.azurecr.io)
  username: base64Encode(registry-username)
  password: base64Encode(registry-password)

La siguiente muestra de configuración muestra una configuración de registro típica compatible con OCI:

{
    "registries": {
        "docker": {
            "url": "registry.domain.io",
            "username": "username",
            "password": "password", 
            "pull_secret_value": "pull-secret-value"
        },
        "helm": {
            "url": "registry.domain.io",
            "username": "username",
            "password": "password"
        },
        "trust": {
            "enabled": true,
            "public_key": "LS0tLS1CRUdJTiBQVUJMSUMgS0VZLS0tLS0KTUZrd0V3WUhLb1pJemowQ0FRWUlLb1pJemowREFRY0RRZ0FFNE4vSzNzK2VXUTJHU3NnTTJNcUhsdEplVHlqRQp1UC9sd0dNTnNNUjhUZTI2Ui9TTlVqSVpIdnJKcEx3YmpDc0ZlZUI3L0xZaFFsQzlRdUU1WFhITDZ3PT0KLS0tLS1FTkQgUFVCTElDIEtFWS0tLS0tCg==",
            "detection_mode": false
        }
    },
    "registry_ca_cert": "/etc/pki/ca-trust/extracted/ca-bundle.trust.crt"
}

Configuración de espacio de nombres personalizado

Puedes especificar un único espacio de nombres personalizado que reemplace los espacios de nombres predeterminados uipath, uipath-check y uipath-installer . Para definir un espacio de nombres personalizado, proporciona un valor para el parámetro opcional namespace . Si no proporcionas un valor para el parámetro namespace , se utilizan los espacios de nombres predeterminados en su lugar.

Configuración de etiqueta de espacio de nombres personalizada

Si quieres que los espacios de nombres de UiPath contengan etiquetas de espacio de nombres personalizadas, añade la siguiente sección al archivo input.json . Asegúrate de añadir tus propias etiquetas.

 "namespace_labels": {
        "install-type": "aksoffline",
        "uipathctlversion": "rc-10_0.1",
        "updatedLabel": "rerun"
    },

Configuración de tolerancia de nodo personalizada

Si necesita taints y tolerancias personalizadas en los nodos en los que tiene previsto instalar Automation Suite, actualice input.json con los siguientes indicadores. Asegúrate de proporcionar los valores adecuados al campo spec .

"tolerations": [
  {
    "spec": {
      "key": "example-key", 
      "operator": "Exists",
      "value": "optional-value",
      "effect": "NoSchedule"
    }
  },
  {
    "spec": {
      "key": "example-key2", 
      "operator": "Exists",
      "value": "optional-value2",
      "effect": "NoSchedule"
    }
  }
]

Instalar varias instancias de Automation Suite en un solo clúster

Si instalas varias instancias de Automation Suite en el mismo clúster, debes crear un archivo input.json diferente para cada instalación y rellenar los valores JSON con diferentes recursos como:

• FQDN: cada instalación debe tener un FQDN diferente.
• Espacio de nombres: cada instalación debe tener un espacio de nombres diferente. Proporcione el valor del espacio de nombres en el que concedió todos los permisos para que se instale Automation Suite.
• argocd.application_namespace : debe ser el mismo que el espacio de nombres en el que Automation Suite tiene todos los permisos para instalarse.
• argocd.project : predeterminado.
• fabric.redis : rellena los detalles sobre las diferentes instalaciones de redis, ya sea que estén ubicadas interna o externamente al clúster de OpenShift.
• SQL: rellena los detalles sobre las diferentes bases de datos, ya sea que estén ubicadas interna o externamente al clúster de OpenShift.
• sql_connection_string _template : rellena los detalles sobre las diferentes bases de datos, ya sea que estén ubicadas interna o externamente al clúster de OpenShift.

Estos diferentes recursos pueden ser el servicio Redis, la base de datos o el espacio de nombres. Sin embargo, en la anotación de servicio de entrada, la IP del equilibrador de carga será una IP común que apunte al mismo clúster de OpenShift.

Configuración específica de Orchestrator

Orchestrator puede guardar los registros del robot en un servidor Elasticsearch. Esta funcionalidad se puede configurar en la sección orchestrator.orchestrator_robot_logs_elastic. De no proporcionarse, los registros del robot se guardan en la base de datos de Orchestrator.

La siguiente tabla enumera los parámetros orchestrator.orchestrator_robot_logs_elastic:

Parámetro	Descripción
orchestrator_robot_logs_elastic	Configuración de Elasticsearch.
elastic_uri	La dirección de la instancia de Elasticsearch que debe utilizarse. Debe proporcionarse en forma de URI. Si se facilita, también se requieren el nombre de usuario y la contraseña.
elastic_auth_username	El nombre de usuario de Elasticsearch utilizado para la autenticación.
elastic_auth_password	La contraseña de Elasticsearch que se utiliza para la autenticación.

Configuración específica de Insights

Si se habilita Insights, los usuarios pueden incluir la configuración del servidor SMTP que se utilizará para enviar correos electrónicos programados o de alerta. Si no se proporciona, los correos electrónicos programados y los de alerta no funcionarán.

You can use the uipathctl command-line tool to apply configuration changes. For details, refer to the uipathctl reference guide.

Detalles de los campos de insights.smtp_configuration:

Parámetro	Descripción
tls_version	Los valores válidos son TLSv1_2, TLSv1_1 y SSLv23. Omitir la clave si no utiliza TLS.
from_email	Dirección desde la que se enviarán los correos electrónicos de alerta o programados.
host	Nombre del host del servidor SMTP.
port	Puerto del servidor SMTP.
username	Nombre de usuario para la autenticación del servidor SMTP.
password	Contraseña para la autenticación del servidor SMTP.
enable_realtime_monitoring	Indicador para habilitar la supervisión en tiempo real de Insights. Los valores válidos son true y false. El valor predeterminado es false.

Ejemplo

"insights": {
    "enabled": true,
    "enable_realtime_monitoring": true,
    "smtp_configuration": {
      "tls_version": "TLSv1_2",
      "from_email": "[e-mail]",
      "host": "smtp.sendgrid.com",
      "port": 587,
      "username": "login",
      "password": "password123"
    }
  }

Process Mining-specific configuration

If enabling Process Mining, we recommend users to specify a SECONDARY SQL server to act as a data warehouse that is separate from the primary Automation Suite SQL Server. The data warehouse SQL Server will be under heavy load and can be configured in the processmining section:

Parámetro	Descripción
sql_connection_str	Cadena de conexión con formato DotNet con la base de datos establecida como marcador de posición: Initial Catalog=DB_NAME_PLACEHOLDER.
airflow.metadata_db_connection_str1	Esto se aplica a la base de datos AutomationSuite Airflow de PostgreSQL. Cadena de conexión en formato Sqlalchemy PSYCOPG2 para la ubicación de la base de datos de metadatos de flujo de aire personalizado: PostgreSQL:5432/DB_NAME_PLACEHOLDER. Ejemplo: postgresql+psycopg2://testadmin:<password>@postgres.company.com:5432/DB_NAME_PLACEHOLDER También puedes utilizar metadata_db_connection_str en la sección processmining a nivel global en el archivo input.json para proporcionar el valor para la metadatabase de Airflow. En este caso, airflow.metadata_db_connection_str es opcional.
warehouse.sql_connection_str	Cadena de conexión SQL con formato DotNet al SQL Server del almacén de datos de Process Mining con marcador de posición para dbname: Initial Catalog=DB_NAME_PLACEHOLDER.
warehouse.sqlalchemy_pyodbc_sql_connection_str	Cadena de conexión SQL con formato PYODBC de Sqlalchemy al SQL Server del almacén de datos de Process Mining con marcador de posición para dbname: sqlServer:1433/DB_NAME_PLACEHOLDER.
warehouse.master_sql_connection_str	If the installer is creating databases through sql.create_db: true setting, a DotNet formatted master SQL connection string must be provided for the processmining data warehouse SQL Server. Database in the connection string must be set as master.

¹ Ejemplo de configuración:

"processmining": {
  "enabled": true,
  "app_security_mode": "system_managed",
  "airflow": {
    "metadata_db_connection_str": "postgresql+psycopg2://testadmin:<password>@sfdev8454496-postgresql.postgres.database.azure.com:5432/AutomationSuite_Airflow"
  }
}

Ejemplo de cadena de conexión de Process Mining con PostgreSQL para AutomationSuite_Airflow

"processmining": {
    "enabled": true,
    "app_security_mode": "system_managed",
    "airflow": {
      "metadata_db_connection_str": "postgresql+psycopg2://testadmin:<password>@sfdev8454496-postgresql.postgres.database.azure.com:5432/AutomationSuite_Airflow"
    },
    "warehouse": {
      "sql_connection_str": "Server=tcp:kerberossql.autosuitead.local,1433;Initial Catalog=AutomationSuite_Warehouse;Persist Security Info=False;User Id=testadmin;Password='<password>';MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=True;Connection Timeout=30;Max Pool Size=100;",
      "sqlalchemy_pyodbc_sql_connection_str": "mssql+pyodbc://testadmin:<password>@kerberossql.autosuitead.local:1433/AutomationSuite_Warehouse?driver=ODBC+Driver+17+for+SQL+Server&TrustServerCertificate=YES&Encrypt=YES",
      "master_sql_connection_str": "Server=tcp:kerberossql.autosuitead.local,1433;Initial Catalog=master;Persist Security Info=False;User Id=testadmin;Password='<password>';MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=True;Connection Timeout=30;Max Pool Size=100;"

Al utilizar la autenticación Kerberos, utiliza los parámetros Integrated Security y Trusted_Connection . Al establecer Integrated Security como true y Trusted_Connection como yes, se utilizan las credenciales del usuario que ha iniciado sesión actualmente para la conexión. En este caso, no es necesario especificar un nombre de usuario y una contraseña independientes.

Nota:

Al configurar las cadenas de conexión para el SQL Server del almacén de datos de Process Mining, se debe omitir la instancia con nombre de SQL Server.

Las instancias con nombre de SQL Server no pueden operar en el mismo puerto TCP. Por lo tanto, el número de puerto por sí solo es suficiente para distinguir entre instancias.

Por ejemplo, utiliza tcp:server,1445 en lugar de tcp:server\namedinstance,1445.

Los nombres de la cadena de conexión PYODBC de la plantilla postgresql_connection_string_template_sqlalchemy_pyodbc (para PostgreSQL) y la cadena de conexión PYODBC sqlalchemy_pyodbc_sql_connection_str utilizada al traer tu propia base de datos son diferentes. Los nombres de las cadenas de conexión también son diferentes para la plantilla SQL sql_connection_string_template y sql_connection_str utilizada cuando traes tu propia base de datos.

Si traes tu propia base de datos y la configuraste utilizando las cadenas de conexión sql_connection_str y sqlalchemy_pyodbc_sql_connection_str o airflow.metadata_db_connection_str en la sección processmining del archivo input.json , las cadenas de conexión de la plantilla sql_connection_string_template y postgresql_connection_string_template_sqlalchemy_pyodbc (por PostgreSQL) se ignoran si se especifica.

Automation Suite Robots-specific configuration

Los robots de Automation Suite pueden usar el almacenamiento en caché de paquetes para optimizar las ejecuciones de procesos y permitir que se ejecuten más rápido. Los paquetes NuGet se obtienen del sistema de archivos en lugar de descargarse de Internet. Esto requiere un espacio adicional de mínimo 10 GB y debe asignarse a una carpeta en el sistema de archivos de la máquina host de los nodos dedicados.

Para habilitar el almacenamiento en caché de paquetes, debe actualizar los siguientes parámetros input.json :

Parámetro	Valor predeterminado	Descripción
packagecaching	true	Cuando se establece en true, los robots usan una caché local para la resolución de paquetes.
packagecachefolder	/uipath_asrobots_package_cache	La ubicación del disco en el nodo del agente sin servidor donde se almacenan los paquetes.

Si las políticas de RBAC de tu clúster restringen los permisos get y list en los nodos, Automation Suite Robots no puede determinar automáticamente el número máximo de trabajos simultáneos. En este caso, configura el siguiente parámetro input.json para definir el límite explícitamente:

Parámetro	Valor predeterminado	Descripción
concurrency_limit	No establecido	El número máximo de trabajos que pueden ejecutarse simultáneamente. Cuando no se establece, los robots de Automation Suite utilizan los permisos get y list en los nodos para determinar el límite automáticamente en función de la capacidad de nodo disponible.

Configuración específica de AI Center

Esta sección solo se aplica a los puntos finales de S3 (no es necesario para Azure Storage).

Para que AI Center funcione correctamente, debes configurar los parámetros aicenter.external_object_storage.port y aicenter.external_object_storage.fqdn en el archivo input.json .

Nota:

Debes configurar los parámetros en la sección aicenter del archivo input.json incluso si has configurado la sección external_object_storage del archivo.

El siguiente ejemplo muestra una configuración input.json válida para AI Center:

"aicenter": {
  "external_object_storage" {
    "port": 443,
    "fqdn": "s3.us-west-2.amazonaws.com"
  }
},
"external_object_storage": {
  "enabled": true,
  "create_bucket": false,
  "storage_type": "s3", 
  "region": "us-west-2", 
  "use_instance_profile": true
}
...

Configuración específica de Integration Service

Configuración de la cola de la nube soberana

En entornos de nube soberanos o nacionales donde los puntos finales de cola utilizan un sufijo FQDN no estándar, puedes anular el predeterminado utilizando el campo queue_config.fqdn_suffix opcional en integrationservices en input.json.

De forma predeterminada, Integration Service utiliza amazonaws.com para AWS y core.windows.net para Azure.

Ejemplos de casos de uso: China AWS (amazonaws.com.cn), China Azure (core.chinacloudapi.cn), Azure US Government (core.usgovcloudapi.net).

"integrationservices": {
  "queue_config": {
    "fqdn_suffix": ""
  }
}

• Si fqdn_suffix se deja vacío o se omite el campo, se aplican los valores predeterminados del gráfico: amazonaws.com para AWS o core.windows.net para Azure.
• Si se proporciona un valor no vacío, anula el sufijo FQDN del punto final de la cola para las URL de cola de AWS y Azure.
• Si se establece azure_fqdn_suffix en external_object_storage, Integration Service utiliza automáticamente el mismo valor para el sufijo del punto final de la cola. No es necesario establecer queue_config.fqdn_suffix por separado en ese caso.

Autenticación principal de servicio para SQL

Al utilizar la autenticación SQL con un servicio principal de Azure Active Directory para la conexión de la base de datos, debes añadir explícitamente una sección advanced_configuration al bloque integrationservices en input.json. Sustituye your-tenant-id por tu ID de tenant de Azure.

"integrationservices": {
  "enabled": true,
  "advanced_configuration": {
    "gallupx": {
      "extraEnv": {
        "AZURE_TENANT_ID": "your-tenant-id"
      }
    }
  }
}

Configuración específica de Document Understanding

Autenticación principal de servicio para SQL

Al utilizar la autenticación SQL con un servicio principal de Azure Active Directory para la conexión de la base de datos, debes añadir explícitamente una sección advanced_configuration al bloque documentunderstanding en input.json. Sustituye your-tenant-id por tu ID de tenant de Azure.

"documentunderstanding": {
    "enabled": true,
    "enable_sql_wi": null,
    "advanced_configuration": {
      "du-annotations": {
        "additionalConfigs": {
          "AZURE_TENANT_ID": "your-tenant-id"
        }
      }
    },
},