Antes de empezar
Necesitas:- Acceso a la Consola de Acrity.
- Un usuario con permiso de Admin de workspace en el workspace.
- Permiso para instalar o autorizar el proveedor de código usado por el equipo.
- Al menos un repositorio con pull requests o merge requests activos.
- Opcionalmente, acceso administrativo a una herramienta de gestión de trabajo como Jira, Linear o ClickUp.
Flujo recomendado
Aplicaciones conectadas, Credenciales, Conectores, Repositorios y Policy Engine requieren un Admin de workspace (los admins de plataforma también tienen acceso).
Revisa idioma y miembros
En el selector de workspace y en la configuración del workspace, confirma el idioma predeterminado, los Admins de workspace y los usuarios que necesitan dar seguimiento a las revisiones.
Conecta el proveedor de código
Ve a
Consola > Aplicaciones conectadas cuando puedas usar OAuth o una GitHub App. Usa Consola > Credenciales para credenciales manuales. Usa Consola > Conectores cuando el VCS sea privado, self-hosted o esté en una red restringida.Conecta repositorios
En
Consola > Repositorios, selecciona Conectar repositorio, elige el origen de autenticación y confirma los repositorios que deben recibir revisiones.Bootstrap de ARCHITECTURE.md
Abre el repositorio en
Consola > Repositorios > Detalle del repositorio e inicia el Bootstrap de ARCHITECTURE.md. Esto da a las revisiones el contexto del proyecto del que dependen. Un repositorio no está listo para revisiones hasta que tiene un ARCHITECTURE.md generado con Bootstrap, así que completa este paso para cada repositorio que conectes.Ajusta la política de revisión
Usa
Consola > Policy Engine para las reglas del workspace y, cuando sea necesario, ajusta configuraciones específicas en Consola > Repositorios > Detalle del repositorio.Valida el primer PR o MR
Abre o actualiza un PR/MR en el proveedor de código y sigue la revisión en el dashboard Ops — donde aparecen las revisiones — y en la salida del proveedor. Usa
Consola > Audit Trail solo para detalles técnicos del evento y diagnóstico.Decisión rápida: ¿qué tipo de conexión usar?
| Escenario | Usa |
|---|---|
| GitHub Cloud con instalación administrada | GitHub App conectada |
| GitLab, Bitbucket, Azure DevOps, Jira, Linear o ClickUp mediante OAuth | Aplicaciones conectadas |
| Token personal, token de proyecto o credencial técnica | Credenciales |
| VCS privado, VCS self-hosted o sin acceso entrante hacia la cloud | Conectores |
Checklist de preparación para producción
- El workspace tiene al menos dos Admins de workspace.
- Los repositorios importantes aparecen como listos en
Consola > Repositorios, cada uno con un ARCHITECTURE.md generado con Bootstrap. - Los idiomas del workspace y de los repositorios son correctos.
- La política de autores bloquea las cuentas que no deben generar costo ni actividad de revisión.
- Las API keys tienen el alcance mínimo, expiración y allowlist de IP cuando corresponde.
- Los webhooks salientes usan HMAC cuando el destino admite verificación.
- Los Admins de workspace revisaron las páginas de seguridad antes de configurar credenciales de producción.