Konfiguration

Die UiPath-CLI wird über Umgebungsvariablen und Flags pro Befehl konfiguriert. Es gibt keine Datei für allgemeine Zwecke: Legen Sie Umgebungsvariablen in der Ausführungsumgebung fest und übergeben Sie Flags für die Befehle.

Konfigurationsquellen

In der Reihenfolge des Rangfolge, von spezifisch zu allgemein:

1. Befehlszeilen-Flag – --tenant, --authority, --client-id, --output, --log-level usw. Flags haben Vorrang vor jeder anderen Quelle.
2. Umgebungsvariable – von der CLI zur Laufzeit gelesene Variablen (siehe Umgebungsvariablen). Die CLI liest jede Variable nur an den dokumentierten Punkten; Es gibt keine implizite Regel „Jedes Flag hat ein env-var-Gegenstück“.
3. Hartcodierte Standardeinstellungen – https://cloud.uipath.com für die Stelle, json für das Ausgabeformat, info für Protokollebene, Seitengröße 50 für Listenverben.

Umgebungsvariablen

Umgebungsvariablen sind der Hauptmechanismus zum Konfigurieren der CLI in CI-Ausführungen, Containern und Entwicklerkonfigurationen pro Shell. Legen Sie sie in der Umgebung des Ausführungsvorgangs (oder in einer .env -Datei, die von Ihrem Ausführungsvorgang verbraucht wird) fest, und die CLI liest sie an den unten dokumentierten Punkten.

Variable	Lesen von	Zweck
UIPATH_URL	uip login, jeder authentifizierte Befehl	Überschreiben Sie die Basis-URL der Identitätsautorität. Die Standardeinstellung ist https://cloud.uipath.com.
UIPATH_CLI_ENABLE_ENV_AUTH	Jeder authentifizierte Befehl	Legen Sie den Literal true fest, um die CLI vom dateibasierten Anmeldeinformationsflow zur Authentifizierung mit Umgebungsvariable zu wechseln. Wenn dieses Gate aktiviert ist, liest die CLI das Zugriffstoken + Mandant + Organisation aus den folgenden Variablen und umgibt den ~/.uipath/ -Anmeldeinformationsordner vollständig. Siehe Authentifizierung – Flow 3.
UIPATH_CLI_AUTH_TOKEN	Nur env-var-Authentifizierungsflow	JWT-Zugriffstoken. Die Server-URL wird aus dem Anspruch iss des Tokens abgeleitet.
UIPATH_CLI_ORGANIZATION_NAME	Nur env-var-Authentifizierungsflow	Organisations-Slug.
UIPATH_CLI_ORGANIZATION_ID	Nur env-var-Authentifizierungsflow	UUID der Organisation.
UIPATH_CLI_TENANT_NAME	Nur env-var-Authentifizierungsflow	Mandanten-Slug.
UIPATH_CLI_TENANT_ID	Nur env-var-Authentifizierungsflow	Mandanten-UUID.
UIPATH_TELEMETRY_DISABLED	Telemetrie-Init	Legen Sie 1 oder true fest, um die anonyme Nutzungstelemetrie zu deaktivieren.
UIPATH_AI_CONNECTION_STRING	Telemetrie-Init	Überschreiben Sie die Application Insights-Verbindungszeichenfolge.
HTTP_PROXY / http_proxy	Netzwerkebene	HTTP-Proxy für ausgehende Anforderungen (Host und Tools).
HTTPS_PROXY / https_proxy	Netzwerkebene	HTTPS-Proxy.
NO_PROXY / no_proxy	Netzwerkebene	Proxy-Umgehungsliste.

Übergeben Sie nicht geheime Werte, die zwischen Bereitstellungen variieren (Mandant, Organisation, Ordnername), als Variablen in Ihrem CI-Ausführungsmodell und verweisen Sie in uip -Befehlen darauf:

env:
  UIPATH_TENANT: Production
  UIPATH_FOLDER: Shared
script:
  - uip login --client-id env.UIPATH_CLIENT_ID --client-secret env.UIPATH_CLIENT_SECRET --tenant "$UIPATH_TENANT"
  - uip or folders list --all --path "$UIPATH_FOLDER"

Warnung:

Kein implizites Lesen von UIPATH_CLIENT_ID / UIPATH_CLIENT_SECRET

Das Festlegen UIPATH_CLIENT_ID und UIPATH_CLIENT_SECRET in der Umgebung allein authentifiziert die CLI nicht . Für Versionen vor 1.0 sind diese implizit gelesen; wurde dieses Verhalten entfernt. Übergeben Sie sie explizit mit dem Präfix env.VAR_NAME auf --client-id / --client-secret oder verwenden Sie den obigen Ablauf für die env-var-Authentifizierung für die tokenbasierte Authentifizierung. Siehe Authentifizierung.

Wo jede Einstellung live sein kann

Einstellung	Markieren	Umgebungsvar	Standard
Stelle/Basis-URL	--authority <url>	UIPATH_URL	https://cloud.uipath.com
ID des externen App-Clients	--client-id <id>	– (festgelegt über Flag mit dem Präfix env.VAR_NAME)	keine
Geheimer Clientschlüssel der externen App	--client-secret <secret>	– (festgelegt über Flag mit dem Präfix env.VAR_NAME)	keine
Mandant	--tenant <name> (oder Sitzung)	–	aus der Sitzung
Ordner	--folder-path / --folder-key pro Befehl	–	keine
Ausgabeformat	--output <format>	–	json
Ausgabefilter	--output-filter <jmespath>	–	keine
Protokollebene	--log-level <level>	–	info
Protokolldatei	--log-file <path>	–	keine
npm-Registrierung für Tools	–	–	.npmrc @uipath:registry (wenn festgelegt), andernfalls npm-Standard
Telemetrie	–	UIPATH_TELEMETRY_DISABLED=1	enabled

Einstellungen ohne eine env-var-Spalte können nur pro Befehl über Flags festgelegt werden.

Beispielkonfigurationen

Ausführung mit minimaler CI (alles über env)

env:
  UIPATH_URL: https://cloud.uipath.com
  UIPATH_CLIENT_ID: ${{ secrets.UIPATH_CLIENT_ID }}
  UIPATH_CLIENT_SECRET: ${{ secrets.UIPATH_CLIENT_SECRET }}
  UIPATH_TENANT: Production
  UIPATH_TELEMETRY_DISABLED: "1"

steps:
  - run: npm install -g @uipath/cli
  - run: uip tools install @uipath/orchestrator-tool @uipath/solution-tool
  - run: |
      uip login \
        --client-id env.UIPATH_CLIENT_ID \
        --client-secret env.UIPATH_CLIENT_SECRET \
        --tenant "$UIPATH_TENANT"
  - run: uip or folders list

Container mit einem vorab ausgegebenen Token (env-var-Authentifizierungsflow)

export UIPATH_CLI_ENABLE_ENV_AUTH=true
export UIPATH_CLI_AUTH_TOKEN="$BUILD_TOKEN"
export UIPATH_CLI_ORGANIZATION_NAME=contoso
export UIPATH_CLI_ORGANIZATION_ID="$ORG_UUID"
export UIPATH_CLI_TENANT_NAME=Default
export UIPATH_CLI_TENANT_ID="$TENANT_UUID"

uip or folders list

Kein uip login Schritt, keine Datei geschrieben. Jeder Befehl authentifiziert sich über die env vars.

Siehe auch

• Authentifizierung – die drei Authentifizierungsflows und welche env-Variablen jeder liest.
• Installieren von UiPath CLI – Proxyvariablen, Telemetrie-Opt-out und CI-Installationsmuster.
• Sitzungen und Anmeldeinformationen – Der von .uipath/ geschriebene Anmeldeinformationsordner uip login.
• Globale Optionen – Flags, die Umgebungsvariablen pro Aufruf überschreiben.