Preparar el cliente
Obtén la distribución correspondiente a tu sistema desde Developer Tools y compara su checksum con el publicado. Usa la ayuda de esa distribución como referencia de sus comandos. La versión de la CLI puede ser distinta de la versión de la plataforma; no deduzcas compatibilidad únicamente por el nombre del archivo.
La CLI se autentica con una clave personal de Dova. Créala mediante la interfaz autorizada de API Keys y conserva el valor en un mecanismo privado. No es una clave OpenAI. Evita colocar claves o contraseñas en argumentos de comandos, capturas, archivos compartidos o historiales. El inicio de sesión interactivo solicita la clave sin mostrarla.
Consultar antes de modificar
Estos comandos no contienen secretos y consultan el contexto actual:
dova --version
dova --help
dova login
dova status --output json
dova repository list --output json
dova mapping list --output json
dova workflow list --output json
dova run list --output json
dova logoutdova login usa el servicio público configurado por la distribución. Comprueba que status muestra el tenant esperado antes de ejecutar operaciones con efectos. La CLI guarda su configuración de autenticación local; protege la cuenta del sistema y ejecuta logout cuando corresponda. Cerrar la terminal no equivale a revocar la clave personal.
Ejecutar una prueba autorizada
La ayuda de dova workflow run --help describe entradas, parámetros y espera. Selecciona primero un Workflow publicado de laboratorio y sus dependencias aceptadas. La opción --wait observa el intento; un tiempo de espera del cliente no demuestra que la ejecución haya terminado. Consulta Monitor antes de reenviar. Los comandos cancel, terminate, rerun y recover tienen consecuencias distintas y comprobaciones de estado.
Distinguir los dos flujos de autenticación
La API con sesión web conserva login, MFA cuando se exige, cookie y protección CSRF para cambios. Si login responde authenticated:false junto con mfaRequired:true, falta completar MFA; una respuesta HTTP 200 no significa autenticación terminada. Después de verificar MFA, consulta la sesión y utiliza el CSRF vigente para el flujo web correspondiente.
La clave personal Bearer de la CLI no se convierte en una sesión web y no sustituye MFA para configurar el proveedor global de DovaAI. Ese ajuste corresponde al superusuario único autorizado mediante su flujo protegido. No copies cookies del navegador a comandos.
Comprobar y resolver errores
Ante 401, revisa credencial o sesión; ante 403, revisa rol y tenant. Un error de validación requiere corregir el recurso indicado, no repetir escrituras a ciegas. Conserva identificadores públicos del intento para diagnóstico, sin registrar encabezados de autenticación. Una respuesta aceptada debe verificarse en el objeto o intento correspondiente.
Exportar una promoción para Git/DevOps
La interfaz Configuration → Environment promotions permite exportar el manifiesto de una release ya aplicada. El kit GitOps añade promotion-export --release-id <id> --output dova/promotion-release.json mediante app/bin/dova_gitops.py, usando su configuración y autenticación autorizadas. Este comando consulta la release, verifica su digest y escribe el archivo local; no promueve, ejecuta ni modifica Dova o Git.
Ejecuta el comando desde el repositorio local preparado para el kit. Revisa el manifiesto antes de registrarlo en tu control de versiones: conserva artefactos publicados, dependencias y procedencia; las referencias secretas se exportan como placeholders. Registrar repository, commit y tag no autentica un repositorio remoto ni hace un push. GitHub permanece como repositorio y no se activa GitHub Actions.
Contexto de entorno
Antes de utilizar este módulo confirma Tenant, Domain y Environment en el menú de usuario. El entorno inicial es Development. Las capacidades del módulo, el Domain y el entorno se aplican juntas; Production queda de solo lectura sin autorización explícita. Cambiar el selector no mueve artefactos ni publica o ejecuta sus datos. Consulta entornos y recuperación y promoción entre entornos.
GitOps 1.1.2: fijar origen y destino
Descarga el kit GitOps 1.1.2 desde una sesión autorizada de Developer Tools y compara el SHA-256 publicado. Extrae dova_gitops.py, dova-gitops.example.json y README.md en tu repositorio local. Usa Python 3.12 o posterior y claves personales mediante las variables protegidas indicadas por apiKeyEnv; no escribas sus valores en Git.
En dova-gitops.json, source.environment y source.domainId seleccionan el origen de exportación. target.environment selecciona el destino y bindings.domainId es el Domain de destino autorizado. Si incluyes target.domainId, debe coincidir con bindings.domainId. El tenant sigue siendo el autorizado por la clave personal y debe coincidir con la configuración; estos campos no cambian de tenant ni conceden acceso.
Los valores omitidos de entorno usan development; el Domain por defecto es General (dom_general). Declara el contexto de forma explícita cuando trabajes en otro Domain. La versión 1.1.2 fija el Domain de bindings antes de la primera consulta y conserva el mismo Tenant, Domain y Environment al leer, reservar un draft, guardar, publicar y solicitar o liberar el lease de edición. No cambies el contexto de un cliente que ya realizó solicitudes.
Ejemplo sintético: Finance en Test
Este fragmento complementa el ejemplo del kit. Sustituye los IDs por un Domain y Folder existentes y autorizados; no crea Finance ni sus recursos:
{
"source": {"environment": "development", "domainId": "dom_finance"},
"target": {"environment": "test", "domainId": "dom_finance"},
"bindings": {"domainId": "dom_finance", "folderId": "fld_REPLACE_WITH_EXISTING_FINANCE_FOLDER"},
"statePath": "dova/target-state-finance-test.json"
}Completa también URL, tenant, variables de claves y los bindings de Connections, workers, perfiles y archivos que necesite el bundle. Desde el repositorio local, valida y revisa antes de ejecutar una importación autorizada:
python dova_gitops.py --config dova-gitops.json validate
python dova_gitops.py --config dova-gitops.json plan --plan-file dova/plan.json
python dova_gitops.py --config dova-gitops.json apply --plan-file dova/plan.jsonvalidate revisa el bundle local. plan consulta el destino sin escribir. apply sí crea o actualiza definiciones y publica las versiones revisadas en Development, Test o Stage. Las versiones publicadas del origen y sus etiquetas de entorno permanecen intactas. El autorado directo en Production se rechaza antes de solicitudes con production_authoring_requires_environment_promotion; usa la promoción gobernada de Dova para ese destino.
Conservar el estado y resolver un contexto incorrecto
Usa un statePath distinto para cada destino. El estado liga origin, tenant, Domain y Environment; reutilizarlo en otro workspace se rechaza antes de consultar Dova. Un estado antiguo vacío puede adoptar el contexto elegido. Un estado anterior poblado sin alcance exige reconciliación manual de sus IDs y versiones publicadas. Conserva el estado y el journal ante un resultado incierto: no los borres ni cambies sus campos de contexto para forzar otra importación.
Si una importación de Finance intenta usar General, revisa source.domainId, target.environment y bindings.domainId, instala el kit 1.1.2 y vuelve a generar el plan. Los kits históricos 1.1.0 y 1.1.1 conservan sus bytes; 1.1.2 es la distribución con alcance de workspace para Dova 24.