- 概述
- 开始使用
- 概念
- 使用 UiPath CLI
- 操作指南
- CI/CD 方法
- 命令参考
- 迁移
- 参考与支持
Manage UiPath StudioAdmin AOps — SourceControl connections, repositories, automation projects, solutions, CI/CD pipelines, and pipeline executions — using the `uip aops` tool.
uip aops manages StudioAdmin AOps (Automation Ops) — the automation-inventory and CI/CD layer that sits on top of your source-control repositories. A connection links a tenant to a Git provider (GitHub or Azure DevOps); AOps discovers repositories, automation projects, and Studio solutions through that connection; a pipeline defines a CI/CD build/run configuration for a project; each pipeline run produces an execution you can inspect or stop.
This is a discovery-and-CI/CD tool, not an authoring one — uip aops never edits your project source. Connections themselves are provisioned through the StudioAdmin UI; this CLI consumes already-provisioned connections by identifier.
This resource spans four pages
- This page — concepts and the shared pagination convention.
connections—connection(sync/inspect a SourceControl connection, discover its repos/projects/solutions) andrepo(inspect one repository's branches and project files).projects—project(inspect one automation project's files, content, and commit history) andsolution(the same for a Studio solution).pipelines—pipeline(CRUD + run a CI/CD pipeline) andexecution(inspect/stream logs/stop a pipeline run).
概念
- Two backing services, two SDKs.
connection,repo,project, andsolutioncall the SourceControl (SC) service (@uipath/sc-sdk).pipelineandexecutioncall the CICD service (@uipath/cicd-sdk). They're independent identifier namespaces — a connection id is never a pipeline id, and so on. - Typical flow:
connection list(find a connection) →connection sync --wait(refresh it) →connection projects <id>/connection repos <id>(discover what's in it) →pipeline create --file(define a CI/CD pipeline against a discovered process) →pipeline runorpipeline save-and-run→execution logs --follow(watch it to completion). - Pagination convention. Every paginated list verb accepts
--offset/--limit(page-based:--offsetmust be a multiple of--limit, or the command fails client-side before any network call). Defaults vary per verb — documented on each sibling page. --login-validity <minutes>is available on every verb across all six command groups — overrides the interactive-login token lifetime for that one call. Rarely needed.- Destructive operations require
-y, --yes.connection deleteandpipeline deleteboth fail immediately without it — this CLI never prompts interactively. - Fan-out degrades, it doesn't fail outright.
project list(the cross-connection aggregator) queries every visible connection in parallel; if some connections can't be read, the reachable projects are still returned with aWarningnaming which connections were skipped. Only an all-connections failure is a hard error.
大纲
uip aops connection list
uip aops connection state [--connection <id>]
uip aops connection sync [connection-id] [--wait] [--timeout <ms>] [--poll-interval <ms>]
uip aops connection delete <connection-id> -y
uip aops connection repos <connection-id> [--azure-projects-ids <csv>] [--organization-identifier <name>]
uip aops connection repos-bulk --ids <csv>
uip aops connection projects <connection-id> [--repository-ids <csv>] [--target-framework <name>] [--project-type <type>] [--sort-by <field>] [--sort-order <asc|desc>] [--offset <n>] [--limit <n>] [--search <term>]
uip aops connection solutions <connection-id> [--offset <n>] [--limit <n>] [--search <term>]
uip aops connection azure-projects <connection-id> [--organization-identifier <name>]
uip aops repo branches <repo-id>
uip aops repo project-files <repo-id> [--reference <ref>]
uip aops project list [--connections <csv>] [--target-framework <name>] [--project-type <type>] [--offset <n>] [--limit <n>] [--search <term>]
uip aops project get --project-id <id> [--reference <ref>] [--with-branches]
uip aops project files --project-id <id> [--path <path>] [--reference <ref>]
uip aops project content --project-id <id> --path <path> [--reference <ref>]
uip aops project commits --project-id <id> [--path <path>] [--branch <name>] [--offset <n>] [--limit <n>] [--search <term>]
uip aops project commit --project-id <id> --reference <sha>
uip aops solution get <solution-id>
uip aops solution commits <solution-id> [--path <path>] [--branch <name>] [--offset <n>] [--limit <n>] [--search <term>]
uip aops pipeline list [--repository-ids <csv>] [--offset <n>] [--limit <n>] [--search <term>]
uip aops pipeline state
uip aops pipeline processes
uip aops pipeline process <process-id>
uip aops pipeline repos
uip aops pipeline get <pipeline-id> [--for-update] [--output-file <path>]
uip aops pipeline search [--name <name> | --prefix <prefix>]
uip aops pipeline create --file <path> [--telemetry-flow-id <id>]
uip aops pipeline update <pipeline-id> --file <path>
uip aops pipeline delete <pipeline-id> -y
uip aops pipeline run <pipeline-id>
uip aops pipeline save-and-run --file <path> [--telemetry-flow-id <id>]
uip aops pipeline executions <pipeline-id> [--offset <n>] [--limit <n>]
uip aops pipeline executions-bulk --ids <csv>
uip aops execution get <execution-id> [--with-arguments]
uip aops execution logs [execution-id] [--job-key <key>] [--follow] [--limit <n>] [--poll-interval <ms>] [--timeout <ms>]
uip aops execution details [execution-id] [--job-key <key>]
uip aops execution stop [execution-id] [--job-key <key>] [--wait] [--poll-interval <ms>] [--timeout <ms>]
uip aops connection list
uip aops connection state [--connection <id>]
uip aops connection sync [connection-id] [--wait] [--timeout <ms>] [--poll-interval <ms>]
uip aops connection delete <connection-id> -y
uip aops connection repos <connection-id> [--azure-projects-ids <csv>] [--organization-identifier <name>]
uip aops connection repos-bulk --ids <csv>
uip aops connection projects <connection-id> [--repository-ids <csv>] [--target-framework <name>] [--project-type <type>] [--sort-by <field>] [--sort-order <asc|desc>] [--offset <n>] [--limit <n>] [--search <term>]
uip aops connection solutions <connection-id> [--offset <n>] [--limit <n>] [--search <term>]
uip aops connection azure-projects <connection-id> [--organization-identifier <name>]
uip aops repo branches <repo-id>
uip aops repo project-files <repo-id> [--reference <ref>]
uip aops project list [--connections <csv>] [--target-framework <name>] [--project-type <type>] [--offset <n>] [--limit <n>] [--search <term>]
uip aops project get --project-id <id> [--reference <ref>] [--with-branches]
uip aops project files --project-id <id> [--path <path>] [--reference <ref>]
uip aops project content --project-id <id> --path <path> [--reference <ref>]
uip aops project commits --project-id <id> [--path <path>] [--branch <name>] [--offset <n>] [--limit <n>] [--search <term>]
uip aops project commit --project-id <id> --reference <sha>
uip aops solution get <solution-id>
uip aops solution commits <solution-id> [--path <path>] [--branch <name>] [--offset <n>] [--limit <n>] [--search <term>]
uip aops pipeline list [--repository-ids <csv>] [--offset <n>] [--limit <n>] [--search <term>]
uip aops pipeline state
uip aops pipeline processes
uip aops pipeline process <process-id>
uip aops pipeline repos
uip aops pipeline get <pipeline-id> [--for-update] [--output-file <path>]
uip aops pipeline search [--name <name> | --prefix <prefix>]
uip aops pipeline create --file <path> [--telemetry-flow-id <id>]
uip aops pipeline update <pipeline-id> --file <path>
uip aops pipeline delete <pipeline-id> -y
uip aops pipeline run <pipeline-id>
uip aops pipeline save-and-run --file <path> [--telemetry-flow-id <id>]
uip aops pipeline executions <pipeline-id> [--offset <n>] [--limit <n>]
uip aops pipeline executions-bulk --ids <csv>
uip aops execution get <execution-id> [--with-arguments]
uip aops execution logs [execution-id] [--job-key <key>] [--follow] [--limit <n>] [--poll-interval <ms>] [--timeout <ms>]
uip aops execution details [execution-id] [--job-key <key>]
uip aops execution stop [execution-id] [--job-key <key>] [--wait] [--poll-interval <ms>] [--timeout <ms>]
相关内容
connections— SourceControl connections and repositories.projects— automation projects and Studio solutions.pipelines— CI/CD pipelines and executions.