Alias

Los alias hacen que las referencias a los paquetes sean estables y legibles. Utilícelos en solicitudes, runbooks, scripts y trabajos de CI cuando copiar ID de paquetes sin formato haga que el flujo de trabajo sea más difícil de entender.

Los alias apuntan sólo a paquetes. Las pistas están referenciadas por UUID o URL que contienen un UUID.

Cada alias reside en un espacio de nombres personal (su propia cuenta, el valor predeterminado) o un espacio de nombres espacio de trabajo (la cuenta compartida del espacio de trabajo activo). Consulte Aliases para saber cómo se resuelven los espacios de nombres.

Crear o actualizar un alias

epismo alias upsert @repo-onboarding --reference $PACK_REFERENCE
epismo alias upsert @release-review --reference $PACK_REFERENCE
epismo alias upsert @deploy --reference @release-review --namespace workspace

--reference acepta un ID de paquete, un alias, una URL compartida o una URL central. El paquete type (workflow o context) se deriva del paquete resuelto. Reutilizar un nombre de alias existente lo redirige al nuevo paquete.

--namespace es personal (predeterminado) o workspace. El formulario workspace comparte el nombre con el espacio de trabajo activo. Solo puede asignar alias a los paquetes que posee: el comando verifica la propiedad antes de escribir.

Los nombres de alias se almacenan sin el inicial @. El CLI acepta repo-onboarding y @repo-onboarding. Los nombres de alias deben tener entre 1 y 255 caracteres después de la normalización y no pueden contener / ni caracteres de control.

Resolver un alias

epismo alias get @repo-onboarding                 # personal first, then workspace fallback
epismo alias get @deploy --namespace workspace    # pin to the workspace's alias
epismo alias get @handle/repo-onboarding          # another account's alias

La respuesta incluye id, type, accountId, alias, namespace (personal | workspace, cuando corresponda) y reference, un @alias listo para usar.

Listar alias

epismo alias list
epismo alias list --type workflow

list devuelve sus alias personales además, cuando un espacio de trabajo está activo, los alias compartidos del espacio de trabajo. Cada entrada está etiquetada con su namespace. --type es opcional.

Eliminar un alias

epismo alias delete @repo-onboarding              # personal
epismo alias delete @deploy --namespace workspace     # the workspace's shared alias

--namespace selecciona el espacio de nombres (predeterminado personal). Solo el propietario del paquete de destino puede eliminar un alias de espacio de trabajo, por lo que no puedes eliminar el alias compartido de un compañero de equipo. Eliminar un alias no elimina el paquete. Al eliminar un paquete, se eliminan los alias que posee y que apuntan a ese paquete.

Errores comunes

• El formulario @handle/alias hace referencia al alias de otra cuenta y es de solo lectura: cree y elimine actos por su cuenta o alias del espacio de trabajo, seleccionados con --namespace.
• No utilices alias para las pistas.
• No confíe en UUID sin formato en las indicaciones cuando un alias pueda hacer que la referencia sea comprensible.