Configuring input.json

input.json 文件允许您配置要部署的 UiPath 产品，应用于所选产品的参数、设置和首选项，以及 Cloud 基础架构的设置。 您必须更新此文件以更改默认值，并为集群使用任何高级配置。

备注：

某些产品可能具有依赖项。 有关详细信息，请参阅 跨产品依赖项。

要编辑 input.json，您可以在客户端计算机上使用自己喜欢的文本编辑器。

常规参数	描述
kubernetes_distribution	指明您使用的 Kubernetes 发行版。 可以是 aks 或 eks。
registries	用于拉取 UiPath 产品和 Automation Suite 的 Docker 映像和 Helm 图表的 URL。 registry.uipath.com
fqdn	Automation Suite 的负载均衡器端点
admin_username	您要设置为主机组织管理员的用户名。
admin_password	要设置的主机管理员密码。
profile	默认值，不可更改 ha：多节点 HA 就绪生产配置文件。
telemetry_optout	true 或 false - 用于选择不将遥测数据发送回 UiPath。 默认情况下，它设置为 false 。 如果要选择退出，请设置为 true。

"kubernetes_distribution": "aks",

  "registries": {
    "docker": {
      "url": "registry.uipath.com"
    },
    "helm": {
      "url": "registry.uipath.com"
    }
  },
  "fqdn": "replace with your fqdn",
  
  "admin_username": "replace with your UiPath admin username",
  "admin_password": "replace with your UiPath admin password",
  
  "profile": "ha",
  
  "telemetry_optout": false

UiPath™ 产品

您可以在安装时和安装后的任何时间启用和禁用 Automation Suite 中的产品。 有关每个产品配置的更多详细信息，请参阅 管理产品。

Orchestrator 示例：

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

自带组件

Automation Suite 允许您使用自己的网守（和 OPA 策略）、证书管理器、监控和日志记录组件。 如果选择排除这些组件，请在安装 Automation Suite 之前确保集群中存在这些组件。

• 有关可选组件和责任矩阵的列表，请参阅 EKS/AKS 堆栈上的Automation Suite 。

• 请务必查看使用 Automation Suite 验证的版本的 兼容性矩阵 。

在以下内容中，所有组件均已排除。 但是，您可以删除希望 Automation Suite 配置的组件。

"exclude_components": [
    "gatekeeper",
    "opa-policies",
    "network-policies",
    "cert-manager",
    "monitoring",
    "logging",
    "velero"
  ]

证书配置

如果安装时未提供证书，则安装程序将创建自行颁发的证书并在集群中对这些证书进行配置。

备注：

请务必指定证书文件的绝对路径。 运行pwd以获取放置文件目录的路径，并将证书文件名附加到input.json中。

参数	描述
server_certificate.ca_cert_file	证书颁发机构证书的绝对路径。此证书颁发机构是对 TLS 证书进行签名的机构。CA 捆绑包必须仅包含用于对 TLS 证书进行签名的链证书。链式证书上限为九个证书。 如果您使用的是自签名证书，则需要指定先前创建的 rootCA.crt 的路径。如果要安装程序生成该路径，请留空。
server_certificate.tls_cert_file	TLS 证书的绝对路径（server.crt 是自签名证书）。如果要安装程序生成该路径，请留空。
server_certificate.tls_key_file	证书密钥的绝对路径（server.key 是自签名证书）。如果要安装程序生成该路径，请留空。
identity_certificate.token_signing_cert_file	用于对令牌进行签名的身份令牌签名证书的绝对路径（identity.pfx 是自签名证书）。如果您希望安装程序使用服务器证书生成身份证书，请留空。
identity_certificate.token_signing_cert_pass	导出身份令牌签名证书时设置的纯文本密码。
additional_ca_certs	包含其他 CA 证书的文件的绝对路径，作为 Automation Suite 的一部分运行的所有服务均会信任这些证书。文件中的所有证书均必须为有效的 PEM 格式。 例如，如果证书不是由公共证书颁发机构颁发，则需要提供包含 SQL Server CA 证书的文件。

基础架构先决条件

您必须提供在 Azure 或 AWS 上配置的先决条件的配置详细信息。 有关 input.json 参数要求，请参阅以下先决条件部分：

• SQL 数据库 （必需）

• 缓存 （必需）

• 存储 （必需）

• 网络 （必需）

• NGINX 入口配置 （可选）

• 代理配置 （可选）

特定于 Orchestrator 的配置

Orchestrator 可以将机器人日志保存到 Elasticsearch 服务器。您可以在 orchestrator.orchestrator_robot_logs_elastic 部分中配置此功能。如果未提供，则系统会将机器人日志保存到 Orchestrator 的数据库中。

下表列出了 orchestrator.orchestrator_robot_logs_elastic 参数：

参数	描述
orchestrator_robot_logs_elastic	Elasticsearch 配置。
elastic_uri	应使用的 Elasticsearch 实例的地址。应以 URI 的形式提供。如已提供，则还需要用户名和密码。
elastic_auth_username	用于身份验证的 Elasticsearch 用户名。
elastic_auth_password	用于身份验证的 Elasticsearch 密码。

Insights 特定配置

如果启用 Insights，则用户可以包含将用于发送计划电子邮件/警示电子邮件的 SMTP 服务器配置。如果未提供，计划电子邮件和警示电子邮件将不起作用。

insights.smtp_configuration 字段详细信息：

参数	描述
tls_version	有效值为 TLSv1_2、TLSv1_1、SSLv23。如果不使用 TLS，则完全省略密钥。
from_email	警示/计划电子邮件的发件人地址。
host	SMTP 服务器的主机名。
port	SMTP 服务器的端口
username	用于 SMTP 服务器身份验证的用户名。
password	用于 SMTP 服务器身份验证的密码。
enable_realtime_monitoring	标记以启用 Insights 实时监控。有效值为 true、false。默认值为 false。

示例

"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 特定配置

如果启用 Process Mining，我们建议用户指定一个辅助 SQL Server，作为独立于主 Automation Suite SQL Server 的数据仓库。数据仓库 SQL Server 将处于高负载状态，可以在 processmining 部分中进行配置：

参数	描述
sql_connection_str	数据库设置为占位符的 DotNet 格式连接字符串: Initial Catalog=DB_NAME_PLACEHOLDER 。
sqlalchemy_pyodbc_sql_connection_str	自定义 Airflow 元数据数据库位置的 Sqlalchemy PYODBC 格式连接字符串：sqlServer:1433/DB_NAME_PLACEHOLDER。 示例： mssql+pyodbc://testadmin%40myhost:mypassword@myhost:1433/AutomationSuite_Airflow?driver=ODBC+Driver+17+for+SQL+Server&TrustServerCertificate=YES&Encrypt=YES 位置 用户: testadmin%40myhost 备注： 如果用户名中包含“@”，则必须将其编码为 %40 示例：（使用 Kerberos 身份验证设置 SQL Server） mssql+pyodbc://:@assql2019.autosuitead.local:1433/AutomationSuite_ProcessMining_Warehouse?driver=ODBC+Driver+17+for+SQL+Server&TrustServerCertificate=YES&Encrypt=YES&Trusted_Connection=yes
warehouse.sql_connection_str	到 Process Mining 数据仓库 SQL Server 的 DotNet 格式的 SQL 连接字符串，其中包含 dbname 的占位符： Initial Catalog=DB_NAME_PLACEHOLDER。
warehouse.sqlalchemy_pyodbc_sql_connection_str	使用 dbname 占位符到 processmining 数据仓库 SQL Server 的 Sqlalchemy PYODBC 格式的 SQL 连接字符串： sqlServer:1433/DB_NAME_PLACEHOLDER。
warehouse.master_sql_connection_str	如果安装程序通过 sql.create_db: true 设置创建数据库，则必须为 Processmining 数据仓库 SQL Server 提供 DotNet 格式的主 SQL 连接字符串。连接字符串中的数据库必须设置为 master。

Process Mining 连接字符串示例

"processmining": {
    "enabled": true,
    "app_security_mode": "system_managed",
    "sql_connection_str": "Server=tcp:shared_sqlserver_fqdn,1433;Initial Catalog=AutomationSuite_ProcessMining_Metadata;Persist Security Info=False;User Id=username;Password='password';MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=True;Connection Timeout=30;Max Pool Size=100;",
    "sqlalchemy_pyodbc_sql_connection_str": "mssql+pyodbc://username:password@shared_sqlserver_fqdn:1433/AutomationSuite_Airflow?driver=ODBC+Driver+17+for+SQL+Server&TrustServerCertificate=YES&Encrypt=YES",
    "warehouse": {
      "sql_connection_str": "Server=tcp:dedicated_sqlserver_fqdn,1433;Initial Catalog=AutomationSuite_ProcessMining_Warehouse;Persist Security Info=False;User Id=username;Password='password';MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=True;Connection Timeout=30;Max Pool Size=100;",
      "sqlalchemy_pyodbc_sql_connection_str": "mssql+pyodbc://useername:password@dedicated_sqlserver_fqdn:1433/AutomationSuite_ProcessMining_Warehouse?driver=ODBC+Driver+17+for+SQL+Server&TrustServerCertificate=YES&Encrypt=YES",
      "master_sql_connection_str": "Server=tcp:dedicated_sqlserver_fqdn,1433;Initial Catalog=master;Persist Security Info=False;User Id=username;Password='password';MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=True;Connection Timeout=30;Max Pool Size=100;"
    },
    "blob_storage_account_use_presigned_uri": true
  },

注意：

设置 Microsoft SQL Server 时，请确保将安装 Airflow 数据库和专用 Process Mining 数据库的 SQL Server 计算机的时区设置为 UTC。

注意：

为 Process Mining 数据仓库 SQL Server 配置连接字符串时，应省略 SQL Server 的命名实例。

SQL Server 命名实例不能在同一 TCP 端口上运行。 因此，仅端口号就足以区分实例。

例如，使用 tcp:server,1445 代替 tcp:server\namedinstance,1445。

注意：模板 PYODBC 连接字符串 sql_connection_string_template_sqlalchemy_pyodbc 与您自带数据库时使用的 PYODBC 连接字符串 sqlalchemy_pyodbc_sql_connection_str 的名称不同。此外，当您使用自己的数据库时，模板 SQL sql_connection_string_template 和 sql_connection_str 的连接字符串名称也不同。

重要提示：

如果您有自己的数据库，并且您在input.json文件的processmining部分中使用sql_connection_str和sqlalchemy_pyodbc_sql_connection_str连接字符串配置，则模板连接字符串sql_connection_string_template和sql_connection_string_template_sqlalchemy_pyodbc如果指定）将被忽略。

重要提示：

以下数据库必须使用默认服务器端口 1433 ：

• warehouse.sql_connection_str
• warehouse.sqlalchemy_pyodbc_sql_connection_str
• warehouse.master_sql_connection_str

不支持非标准 SQL Server 端口。

Automation Suite Robot 特定配置

Automation Suite Robot 可以使用包缓存来优化流程运行，并使其运行速度更快。NuGet 包从文件系统获取，而不是从 Internet/网络下载。这需要至少 10GiB 的额外空间，并且应分配给专用节点的主机文件系统上的文件夹。

要启用包缓存，您需要更新以下input.json参数：

参数	默认值	描述
packagecaching	true	设置为 true 时，机器人使用本地缓存进行包解析。
packagecachefolder	/uipath_asrobots_package_cache	存储包的无服务器代理节点上的磁盘位置。

AI Center 特定配置

为使 AI Center 正常运行，您必须在input.json文件中配置aicenter.external_object_storage.port和aicenter.external_object_storage.fqdn参数。

注意：即使已配置文件的external_object_storage部分，您也必须在input.json文件的aicenter部分中配置参数。

以下示例显示了 AI Center 的有效input.json配置：

"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
}
...