UiPath Documentation
automation-suite
2.2510
true
Automation Suite on EKS/AKS installation guide

Deployment scenarios

Online, offline, and multi-site deployment architectures for Automation Suite on EKS/AKS.

Online deployment

An online deployment of Automation Suite is one that requires internet access during installation and runtime. All the UiPath® products and supporting libraries are hosted in the UiPath® registry or UiPath-trusted third-party store.

You can limit access to the internet with the help of a restricted firewall or a proxy server by blocking all the traffic over the internet other than what is required by Automation Suite. For details on firewall or proxy rules, refer to Configuring the proxy.

Offline deployment

An offline deployment (air-gapped) is a completely isolated setup without access to the internet. This type of setup requires the installation of an additional registry to store all the UiPath® products' container images and binaries, which are shipped in the form of tarball.

Note:

You are not allowed to change the deployment method post-installation. This means that you cannot change to offline if the installation is done online and vice versa. It is recommended to choose your deployment strategy after careful consideration.

Automation Suite on EKS deployment

Deployment architecture

You can reference the following architecture diagrams to deploy Automation Suite on EKS.

Online deployment

Offline deployment

Overview

The previous architecture diagram depicts how Automation Suite can be set up on the AWS EKS cluster.

An EKS cluster is deployed in a single AWS region, where the EC2 worker nodes are in an autoscaling group distributed across three availability zones. The distribution of nodes across availability zones is what brings resiliency to complete zone failure.

Availability zones and networking

Each zone has a private subnet and a public subnet. EC2 worker nodes are hosted in a private subnet, whereas the public subnet hosts an elastic IP address and NAT gateway. The NAT gateway is required to connect to the internet while accessing the EKS control plane from the worker nodes and connecting to the docker registry to get the container images for the Automation Suite deployment.

Elastic IP addresses hosted in each public subnet are passed to Automation Suite during installation to register that as an endpoint where Istio must listen for any incoming traffic. For the same reason, the Network Load Balancer (NLB) must use these endpoints to forward any request made to Automation Suite.

Data sources

Datasources such as Amazon RDS for Microsoft SQL Server, S3 bucket, Elastic File System, and Elastic Cache should be set up to have enough redundancy in case of failure and must be accessed from the private subnet where the EC2 worker instances are hosted.

The Kubernetes cluster must have network connectivity and access to the secret store to retrieve credentials.

Note:
  • Automation Suite has no affinity rules to ensure that the worker pods are distributed equally across the zone. If there is any zone-level failure, there may be a momentary degradation of the service, which would be resolved when that service is automatically moved to a new zone by the EKS control plane.
  • Insights requires the EBS volumes to store the dashboard and the other metadata. In AWS, EBS volumes are tied to the zone in which they are present and do not move when the zone is down. Insights will not be available until the zone on which insights were scheduled is recovered.
  • EKS does not enable autoscaling by default, as opposed to AKS. To activate this feature, you typically need to install and configure additional software like Metrics Server and Cluster-Autoscaler, or alternative solutions that provide similar autoscaling capabilities.

Automation Suite on AKS deployment

Deployment architecture

You can reference the following architecture diagrams to deploy Automation Suite on AKS.

Online deployment

Offline deployment

Overview

An AKS cluster is deployed in a single region where the worker nodes are distributed across the system and user node pools. The core AKS components (except the control plane) are hosted in the system node pool, such as CNI, CoreDNS, etc. Additionally, UiPath® core services are also hosted in the same Node Pool. Additional User Node Pools can host the worker nodes for Automation Suite Robots and GPU.

Node pools and networking

Each Node Pool hosts the Virtual Machine Scale Set (VMSS), ensuring that worker nodes are distributed across multiple zones to provide resiliency to zone failure and scale when required.

The static IP address associated with the Load Balancer is passed to Automation Suite during installation to register that as an endpoint where Istio must listen for any incoming traffic. For the same reason, Azure Load Balancer (L4) must use these endpoints to forward any request to Automation Suite.

Data sources and access

Datasources such as Microsoft SQL Server, Azure Storage Account, and Azure Redis Cache should be set up to have enough redundancy in case of failure and must be accessed from the subnet where the AKS worker nodes are hosted.

The Kubernetes cluster must have network connectivity and access to the secret store to retrieve credentials.

Additionally, there may be a need for an additional Jump Box / Bastion Server, which may have all the required privileges to operate the AKS cluster.

Note:

Automation Suite has no affinity rules to ensure that the worker pods are distributed equally across the zone. If there is any zone-level failure, there may be a momentary degradation of the service, which will be resolved when that service is automatically moved to a new zone by the AKS control plane.

Deployment modes and use cases

Automation Suite supports the following deployment modes:

Deployment modeDescription
Multi-nodeSupported for production use. The following modes are available:
- Lite mode: Lightweight deployment with selective HA configuration. For details, refer to Lite mode installations.
- HA mode: Fully enabled HA. For details, refer to HA installations.

Lite mode installations

Lite mode installations offer a simple, resource-light setup process, including all features except high availability. By default, the infrastructure and shared components are deployed in HA mode, and all services are in lite mode (horizontal pod autoscaling is enabled with a minimum of one replica).

Lite mode ensures flexible infrastructure management by allowing you to enable high availability for select services during or after installation as needed.

Important:

You can use lite mode in production, but you need to be aware of the implications and risks of having services without high availability enabled.

HA installations

Multi-node installations are supported for production deployments, providing increased scalability, enhanced reliability, and efficient resource management. It supports both in-cluster and external high availability.

Deploying Automation Suite with a secretstore

Automation Suite requires several infrastructure credentials to deploy all its products.

Instead of defining credentials directly in the input.json file, you can configure a secretstore to securely manage and supply sensitive information. During deployment, uipathctl retrieves credentials from the configured secret store and applies them automatically.

You can store credentials such as:

  • SQL credentials
    • Username
    • Password
    • SQL Connection Strings
  • Storage credentials
    • S3/AWS
      • Access key
      • Secret key
      • ARN (Amazon Resource Name)
    • Azure
      • Account key
      • Client ID
      • Client secret
      • Subscription ID
      • Tenant ID
  • Redis credentials
    • Password
    • License
  • Kerberos authentication
    • AD username
    • User keytab
    • AD domain
    • Ticket lifetime
Note:

You cannot store certificate paths or certificate-related credentials as part of the secretstore.

Kubernetes Secret

You can use a Kubernetes Secret to provide all sensitive data instead of including it in input.json.

uipathctl uses the credentials stored in the Secret when deploying Automation Suite and its products.

Azure Key Vault

You can configure all sensitive data or credentials in an Azure Key Vault.

uipathctl uses the credentials stored in the Azure Key Vault when deploying Automation Suite.

HashiCorp Vault

You can configure all sensitive data or credentials in a HashiCorp Vault instance. HashiCorp Vault supports KV (Key-Value) secrets engine v1 and v2.

uipathctl authenticates to Vault using either Kubernetes service account tokens or AppRole credentials and retrieves the stored credentials when deploying Automation Suite.

AWS Secrets Manager

You can configure all sensitive data or credentials in AWS Secrets Manager. Secrets can be stored as key-value pairs or plaintext strings.

uipathctl uses the AWS SDK credential chain to authenticate and retrieve credentials from AWS Secrets Manager when deploying Automation Suite.

Was this page helpful?

Connect

Need help? Support

Want to learn? UiPath Academy

Have questions? UiPath Forum

Stay updated