Developer Tools: CLI, distribuciones y API keys

Objetivo y modelo

Developer Tools reúne distribuciones de Dova CLI, instrucciones iniciales y gestión de API keys personales. La CLI permite trabajar desde una terminal, pero no evita los permisos, límites ni el aislamiento del tenant. Una clave hereda los permisos de su propietario y puede revocarse.

El panel diferencia plataforma, versión, estado de firma y SHA-256 del artefacto. Una distribución disponible no implica que esté firmada: revise el estado mostrado en lugar de asumir una garantía uniforme para todos los paquetes.

Requisitos y preparación

Necesita acceso a la opción y autorización para las operaciones que ejecutará. Seleccione un equipo de laboratorio compatible con la distribución disponible. No guarde claves en scripts versionados, capturas, tickets o el propio manual.

Antes de instalar, compruebe plataforma y versión. Descargue el artefacto desde la acción Download correspondiente y compare su hash con el publicado en el panel. Por ejemplo, en PowerShell puede calcularlo así:

Get-FileHash -Algorithm SHA256 -LiteralPath .\dova-cli-descargado.zip

El nombre del archivo es ilustrativo; utilice el nombre real descargado. Una diferencia de hash requiere detener la instalación y volver a verificar el origen.

Recorrido de la interfaz

1. Revise Available platforms.
2. Seleccione la distribución correcta y compruebe Version, Signing y SHA-256.
3. En API keys, use Create API key sólo para un propósito definido.
4. Capture el secreto únicamente en el mecanismo seguro previsto para su uso; no lo incluya en ejemplos compartidos.
5. Siga Quick start para autenticar la CLI.
6. Use Revoke cuando la clave deje de ser necesaria y compruebe que no se emplee en otra automatización autorizada.

El inventario de claves muestra información como nombre, prefijo y uso. El prefijo permite identificar una clave sin divulgar su valor completo.

POC de sólo lectura

Tras instalar y configurar la CLI, autentique contra la URL de su laboratorio. La siguiente secuencia usa un dominio reservado como marcador de laboratorio:

dova login --url https://dova-lab.example.test
dova repository list --domain "Laboratorio ETL" --output json
dova workflow list --status published --name customer --limit 50
dova run list --status failed,cancelled --sort createdAt --descending --output csv

Sustituya URL, Domain y filtros por los valores autorizados del laboratorio. La URL .example.test es un marcador y debe reemplazarse por el endpoint real del laboratorio.

Resultado esperado: las consultas devuelven únicamente objetos y ejecuciones accesibles para la identidad autenticada. Una lista vacía puede ser válida si el filtro no coincide. Conserve salida sintética sin secretos para comparar el resultado con Repository y Monitor.

Ejecución y recuperación: alcance separado

El Quick start también publica comandos de ejecución con archivos, variables y múltiples fuentes, además de recuperación por identificador. Esas operaciones producen efectos y deben ensayarse con destinos exclusivos del laboratorio. Revise primero Workflows, bindings de Sessions y política de recuperación.

No convierta automáticamente una comprobación de instalación en una ejecución mutante. La POC anterior se limita a lectura.

Errores y mantenimiento

Ante un rechazo, distinga credencial revocada, sesión inválida, permiso insuficiente y filtro incorrecto. Regenerar una clave no resuelve permisos ausentes. Tras una actualización, compruebe la versión instalada y las instrucciones del paquete vigente.

Este capítulo verifica las formas de comando publicadas por la interfaz; no afirma que se hayan descargado paquetes o ejecutado comandos durante su redacción.