- Información general
- Requisitos
- Preinstalación
- Preparar la instalación
- Descarga de los paquetes de instalación
- Configurar el registro compatible con OCI
- Conceder permisos de instalación
- Instalar y configurar la malla de servicio
- Instalar y configurar la herramienta GitOps
- Instalar el operador de secretos externos en Kubernetes
- Aplicar configuraciones varias
- Ejecutar uipathctl
- Instalación
- Después de la instalación
- Migración y actualización
- Supervisión y alertas
- Administración de clústeres
- Configuración específica del producto
- Configuración avanzada de Orchestrator
- Configurar parámetros de Orchestrator
- Configurar AppSettings
- Configurar el tamaño máximo de la solicitud
- Anular la configuración de almacenamiento a nivel de clúster
- Configurar NLog
- Guardar los registros del robot en Elasticsearch
- Configurar almacenes de credenciales
- Configurar clave de cifrado por tenant
- Limpiar la base de datos de Orchestrator
- Omitir la instalación de la biblioteca de host
- Ai Trust Layer
- Solución de problemas
- Error de aprovisionamiento de AI Center después de actualizar a 2023.10 o posterior
- Volúmenes de Insights creados en dos zonas diferentes después de la migración
- La actualización falla debido a los tamaños de PVC de Insights anulados
- Los componentes de copia de seguridad de Velero permanecen después de actualizar en AKS desde Automation Suite 2024.10.x
- La configuración de la copia de seguridad no funciona debido a un fallo en la conexión a Azure Government
- Los pods en el espacio de nombres de UiPath se atascaban al habilitar los taints de nodo personalizados
- No se puede iniciar Automation Hub y Apps con la configuración de proxy
- La copia de seguridad de Velero falla con el error de validación fallida
- Solución de problemas de secretos externos
- Durable Execution Service troubleshooting
- Los pods de AI Center y Document Understanding no se inician con la verificación del certificado TLS habilitada
- Errores de validación del certificado TLS
- Fluentd no exporta registros en entornos IPv6
- Studio Desktop no puede cargar conectores y actividades de Integration Service
- Mitigación manual de Política de red de ArgoCD (GHSA-47m3-95c7-g2g8)
- Configurar solicitudes de recursos y límites para cargas de trabajo creadas por uipathctl
Instalar y configurar la malla de servicio
Instala y configura la malla de servicios de Istio para Automation Suite en EKS/AKS.
Los permisos de instalación son relevantes solo si no puedes proporcionar privilegios de administrador al instalador de Automation Suite. Si puedes proporcionar los privilegios de administrador necesarios al instalador, no es necesario que sigas las instrucciones de esta sección.
Automation Suite requiere la malla de servicios de Istio para la entrada y la red.
La instalación y configuración de Service Mesh es un proceso de varios pasos. Cuál de los pasos debes realizar depende de si puedes otorgar o no privilegios de administrador al instalador de Automation Suite sobre tu clúster. Para obtener más información, consulta la siguiente tabla:
| Paso | Privilegios de administrador | Sin privilegios de administrador |
|---|---|---|
| Paso 1: instalar la malla de servicio | Paso no necesario | Paso obligatorio |
| Paso 2: configurar Istio e instalar el complemento WASM para el enrutamiento | Paso no necesario | Paso obligatorio |
Paso 1: instalar la malla de servicio
Para instalar Istio, consulta la documentación oficial de Istio.
Automation Suite no requiere aplicaciones como Kiali y Jaeger. Sin embargo, puedes utilizarlos a tu discreción.
Proporcionar la configuración de Istio
Para proporcionar la configuración de Istio, debes establecer los siguientes parámetros en el archivo input.json :
"ingress": {
"gateway_selector": {
"istio": "ingressgateway"
},
"ingress_gateway_secret": "istio-ingressgateway-certs",
"namespace": "<istio-system>",
"istio_gateway_service_name": "istio-ingressgateway"
},
"ingress": {
"gateway_selector": {
"istio": "ingressgateway"
},
"ingress_gateway_secret": "istio-ingressgateway-certs",
"namespace": "<istio-system>",
"istio_gateway_service_name": "istio-ingressgateway"
},
La siguiente tabla describe los parámetros de configuración de Istio:
| Parámetro | Valor |
|---|---|
ingress.gateway_selector.istio | Esta es la etiqueta predeterminada utilizada internamente por Automation Suite. Sin embargo, tu entorno puede utilizar una etiqueta diferente para la puerta de enlace de entrada de Istio dependiendo de cómo se haya configurado el clúster. El valor predeterminado es ingressgateway. |
ingress.ingress_gateway_secret | El nombre del secreto que contiene los archivos de certificado. El valor predeterminado es istio-ingressgateway-certs. |
ingress.namespace | El espacio de nombres donde has instalado la malla de servicio. |
ingress.istio_gateway_service_name* | El nombre del servicio de puerta de enlace de entrada de Istio. El valor predeterminado es istio-ingressgateway. |
* Disponible a partir de Automation Suite 2.2510.2.
Para comprobar la etiqueta utilizada por tu puerta de enlace de entrada de Istio, ejecuta el siguiente comando:
kubectl -n <istio-system> get deploy istio-ingressgateway -o jsonpath="{.metadata.labels.istio}"; echo
kubectl -n <istio-system> get deploy istio-ingressgateway -o jsonpath="{.metadata.labels.istio}"; echo
Paso 2: configurar Istio e instalar el complemento WASM para el enrutamiento
Información general
Este paso requiere privilegios de administrador para la instalación en el espacio de nombres de Istio.
Hay dos formas de realizar la instalación:
- Opción A: si no puedes proporcionar los permisos que requiere el instalador de Automation Suite, debes realizar este paso antes de la instalación de Automation Suite.
- Opción B: durante la instalación de Automation Suite. Este método requiere que el archivo Kubeconfig que utilizas durante la instalación de Automation Suite tenga los permisos necesarios. Para revisar los permisos, consulta la sección Conceder permisos de instalación . Si puedes proporcionar todos los permisos necesarios, omite este paso.
Configuración e instalación
Para configurar Istio e instalar el complemento WASM para el enrutamiento, sigue los siguientes pasos:
-
Crea un
imagepullsecreten el espacio de nombres donde instalaste la malla de servicio. Para crear elimagepullsecret, utiliza tu flujo de trabajo habitual o sigue los siguientes pasos:registry= <registry_url> #provide the registry where the UiPath images are hosted username= <user_name> #provide the username which will be used for the authentication password= <password> #provide the password which will be used for the authentication namespace= <namespace> #namespace where you want to create a secret kubectl create secret docker-registry uipathpullsecret --namespace=${namespace} \ --docker-server=${registry} --docker-username=${username} \ --docker-password=${password} --dry-run=client -o yaml \ | kubectl apply -f -registry= <registry_url> #provide the registry where the UiPath images are hosted username= <user_name> #provide the username which will be used for the authentication password= <password> #provide the password which will be used for the authentication namespace= <namespace> #namespace where you want to create a secret kubectl create secret docker-registry uipathpullsecret --namespace=${namespace} \ --docker-server=${registry} --docker-username=${username} \ --docker-password=${password} --dry-run=client -o yaml \ | kubectl apply -f - -
Arrastra el diagrama de Helm a un directorio local,
<uipath-istio-configure>:helm pull oci://<docker-registry>/helm/istio-configure --version <istio-configure-version> \ --untar --untardir <uipath-istio-configure>helm pull oci://<docker-registry>/helm/istio-configure --version <istio-configure-version> \ --untar --untardir <uipath-istio-configure>El siguiente ejemplo muestra el comando después de reemplazar los marcadores de posición con valores reales:
helm pull oci://registry.mycompany.com/helm/istio-configure --version 2.2510.0 \ --untar --untardir uipath-istio-configurehelm pull oci://registry.mycompany.com/helm/istio-configure --version 2.2510.0 \ --untar --untardir uipath-istio-configure -
Crea un archivo de valores de parámetros para aplicar durante la instalación de Helm de
istio-configure. Utiliza la siguiente muestra como plantilla para el archivo y reemplaza los marcadores de posición<fqdn>,<cluster_type>,<pullsecret>,<registry>y<uipath_namespace>con los valores adecuados:fqdn: <fqdn> #the FQDN of the Automation Suite gateway: selector: istio: ingressgateway global: cluster_type: <cluster_type> # REQUIRED. Example: eks, aks, openshift kubernetesDistribution: <cluster_type> # REQUIRED. Example: eks, aks, openshift imagePullSecret: name: <pullsecret> #name of pull secret which you had create earlier minProtocolVersion: TLSV1_2 #TLS versions uipath: registry: <registry> #registry url without the protocol uipathServiceNamespace: <uipath_namespace> #namespace where the uipath application is deployed patchIstioService: false istioGatewayServiceName: "istio-ingressgateway" wasm: image: pullSecret: <pullsecret> #name of pull secret which you had create earlier registry: oci://<registry> #registry url without the protocolfqdn: <fqdn> #the FQDN of the Automation Suite gateway: selector: istio: ingressgateway global: cluster_type: <cluster_type> # REQUIRED. Example: eks, aks, openshift kubernetesDistribution: <cluster_type> # REQUIRED. Example: eks, aks, openshift imagePullSecret: name: <pullsecret> #name of pull secret which you had create earlier minProtocolVersion: TLSV1_2 #TLS versions uipath: registry: <registry> #registry url without the protocol uipathServiceNamespace: <uipath_namespace> #namespace where the uipath application is deployed patchIstioService: false istioGatewayServiceName: "istio-ingressgateway" wasm: image: pullSecret: <pullsecret> #name of pull secret which you had create earlier registry: oci://<registry> #registry url without the protocol -
Instala
istio-configureen el espacio de nombres de Istio, utilizando Helm. En el siguiente comando, sustituye el marcador de posición<istio_namespace>por el espacio de nombres donde está instalado Istio, y<path_to_the_values_yaml>por la ubicación del archivo YAML que contiene los valores de los parámetros:helm upgrade --debug --install --wait custom-istio-configure \ uipath-istio-configure/istio-configure --version 2.2510.0 \ --namespace <istio_namespace> -f <path_to_the_values.yaml>helm upgrade --debug --install --wait custom-istio-configure \ uipath-istio-configure/istio-configure --version 2.2510.0 \ --namespace <istio_namespace> -f <path_to_the_values.yaml> -
Si utilizas un registro que no está firmado por una autoridad conocida, debes añadir la variable de entorno
WASM_INSECURE_REGISTRIESa la implementaciónistio-ingressgateway, para que Istio pueda extraer la imagen que utiliza el complemento WASM. Para añadir la variable de entorno, ejecuta el siguiente comando:kubectl -n <istio-system> patch deployment istio-ingressgateway --type json -p='[{"op": "add", "path": "/spec/template/spec/containers/0/env", "value": [{"name": "WASM_INSECURE_REGISTRIES", "value": "registry.mycompany.com"}]}]'kubectl -n <istio-system> patch deployment istio-ingressgateway --type json -p='[{"op": "add", "path": "/spec/template/spec/containers/0/env", "value": [{"name": "WASM_INSECURE_REGISTRIES", "value": "registry.mycompany.com"}]}]' -
Añade
istio-configurea la secciónexclude_componentsen tu archivoinput.json. Para obtener más información, consulta Configurar input.json. -
Crea secretos de certificado utilizando el nombre proporcionado en
ingress.ingress_gateway_secretdentro del espacio de nombres<istio-system>.
Si actualizas el FQDN después de la instalación, debes volver a configurar Istio y el complemento WASM, a menos que el instalador de Automation Suite tenga privilegios administrativos. Para volver a configurar, debes seguir los siguientes pasos:
- Actualiza el archivo de valores de parámetros mencionado en el paso 3 con el nuevo FQDN.
- Repite todos los pasos para configurar Istio e instalar el complemento WASM para el enrutamiento.