actualización de UIP

Sintaxis y opciones para la `actualización de uip`, que actualiza las herramientas y habilidades instaladas y busca o aplica una versión de CLI más reciente.

uip update actualiza todas las herramientas y habilidades instaladas, y busca (y aplica de forma predeterminada) una versión de CLI más reciente. Es el equivalente de un comando a ejecutar uip tools update y una actualización de habilidades juntos, más la propia comprobación de actualización automática de la CLI.

Sinopsis

uip update [--dry-run] [--tools-only | --skills-only] [--no-tools] [--no-skills] [--no-cli-check] [--no-self] [--channel <stable|preview>] [--name <tool-name>] [--agent <agent>] [--local | --no-local]

uip update respeta las opciones globales (--output, --output-filter, --log-level, --log-file). Los códigos de salida siguen el contrato estándar, con una adición a continuación.

Opciones

Marca	Descripción
--dry-run	Vista previa de lo que cambiaría sin aplicarlo.
--tools-only	Actualizar herramientas; omite la sección de habilidades. Mutuamente exclusivo con --skills-only y con --no-tools.
--skills-only	Actualizar habilidades; omite la sección de herramientas. Mutuamente exclusivo con --tools-only y con --no-skills.
--no-tools	No actualice las herramientas.
--no-skills	No actualizar habilidades.
--no-cli-check	No busques una versión de CLI más reciente en absoluto.
--no-self	Busca una versión de CLI más reciente e informa, pero no la instales: imprime un aviso con el comando de actualización manual en lugar de la actualización automática.
--channel <channel>	Anula el canal de lanzamiento para esta ejecución: stable o preview (consulta uip config updateChannel). Sin este marcador, el canal se resuelve desde core.updateChannel/la propia compilación de CLI en ejecución.
--name <tool-name>	Restringe la actualización de herramientas a un nombre de herramienta de ámbito.
--agent <agent>	Restringe la actualización de habilidades a un agente de codificación.
--local	Restrinja la actualización de habilidades solo al ámbito local (proyecto).
--no-local	Restrinja la actualización de habilidades solo al ámbito global.

--tools-only combinado con --no-tools (o --skills-only combinado con --no-skills) es una contradicción y falla con ValidationError antes de que se ejecute algo.

Política de versión

No hay un marcador de versión por invocación: uip update siempre tiene como objetivo el destino de la versión efectiva: tu pin core.version de uip config si se establece uno; de lo contrario, la última versión publicada.

• Sin pin : se dirige a la última versión, cruzando los límites MENOR y MAYOR libremente (una uip update explícita es que el usuario opte por eso, a diferencia de la sincronización diaria en segundo plano unattended, que se limita a sí misma para evitar un salto MAYOR inesperado).
• major.minor pin (un pin de "línea", por ejemplo 1.196): realiza un seguimiento del último parche dentro de esa línea.
• major.minor.patch pin (un pin exacto, por ejemplo 1.196.3) — congela las actualizaciones por completo. uip update omite el motor de actualización por completo, emite un sobre Success con cada sección marcada como no ejecutada e imprime una advertencia a stderr explicando el pin y cómo borrarlo (uip config set version <major.minor> para realizar un seguimiento de una línea, o uip config clear version para seguir la última de nuevo).

Ejemplos

# Update everything installed, including the CLI itself
uip update

# Update tools and skills but only report on a newer CLI, don't self-update
uip update --no-self

# Preview without applying
uip update --dry-run

# Tools only, on the preview channel
uip update --tools-only --channel preview

Forma de datos (--json de salida)

{
  "Code": "UpdateResult",
  "Data": {
    "DryRun": false,
    "Channel": "stable",
    "Cli": {
      "current": "1.4.2",
      "available": "1.4.3",
      "action": "updated",
      "reason": null
    },
    "Tools": [
      { "name": "orchestrator-tool", "status": "updated", "from": "1.4.2", "to": "1.4.3" }
    ],
    "Skills": { "Sections": [] },
    "Errors": [],
    "HasFailures": false
  }
}

Cli.action es uno de updated, notice (existe un CLI más reciente pero no se aplicó — debido a --no-self, o porque la actualización automática se rechazó por otro motivo), none (ya actual), o skipped (un pin exacto core.version congeló la ejecución; consulta más arriba). Tools/Skills son null, no una matriz vacía, cuando esa sección se omitió por completo (--tools-only, --skills-only, --no-tools, --no-skills o el corto circuito de pin congelado).

Una ejecución con Cli.action: "notice" también registra el comando de actualización manual en stderr (npm install -g @uipath/cli@<version>, o un equivalente informado por la herramienta).

Códigos de salida

uip update sigue el contrato estándar, con una adición: un fallo parcial sigue devolviendo un sobre Success (el orquestador no se detiene en el primer subsistema que falla; ejecuta cada sección e informa de cada resultado en Data.Errors), pero el proceso sigue siendo distinto de cero cuando Data.HasFailures es true. Marca HasFailures, no solo Result, si un script necesita detectar un fallo de actualización parcial.

Relacionado

• config de uip : version y updateChannel rigen los objetivos de uip update .
• herramientas uip — uip tools update es el equivalente solo a herramientas con sus propios marcadores dedicados.
• Habilidades de uip : instalación de habilidades y comportamiento de actualización por agente.

Ver también

• Opciones globales
• Códigos de salida