Fuente del código
Conecta el proyecto a un repositorio en GitHub, Azure DevOps, GitLab o Bitbucket, o usa la subida de .zip, y elige las branches de Producción y Preview.
Fuente del código
La fuente del código define de dónde recibe el proyecto el código en cada deploy. Se configura en la configuración del proyecto, pestaña Repositorio, en Mecanismo de despliegue:
| Mecanismo | Cómo ocurre el deploy |
|---|---|
| GitHub | En cada push a la branch configurada. |
| Azure DevOps | En cada push a Azure Repos. |
| GitLab | En cada push a GitLab. |
| Bitbucket | En cada push a Bitbucket. |
| Archivo .zip | En cada subida manual de una nueva versión, solo para Producción. Consulta Deploys. |
Para conectar un proveedor Git, haz clic en Conectar con {proveedor}. Roberty solo accede a los repositorios que autorices, y puedes desconectar en cualquier momento. No hay conexión por token personal (PAT, app password o token de proyecto): la autorización siempre se hace iniciando sesión en el proveedor.
GitHub
- Instala la Roberty GitHub App en tu cuenta u organización de GitHub.
- Autoriza el acceso a los repositorios que quieras. Al terminar, vuelves automáticamente al proyecto.
- Elige el repositorio y la branch de cada entorno.
Si la app ya está instalada en más de una cuenta, elige la cuenta — Organización o Personal — o usa Conectar otra cuenta para instalarla en otra. Los push llegan por la propia app: no hay nada que configurar en el repositorio.
Azure DevOps
- Haz clic en Conectar con Azure DevOps e inicia sesión con la cuenta Microsoft de la organización (cuenta corporativa de Microsoft Entra ID).
- Si la cuenta participa en más de una organización de Azure DevOps, elige la organización donde está el repositorio.
- Elige el repositorio y las branches. La lista trae los repositorios de todos los proyectos de la organización.
Al guardar, Roberty crea automáticamente un Service Hook "Code pushed" en el proyecto de Azure DevOps.
Requisitos y límites:
- Las cuentas personales de Microsoft (Outlook, Hotmail, Live) no son compatibles: la organización debe estar vinculada a un directorio de Microsoft Entra ID.
- Se requiere la aprobación del administrador: si el directorio de la empresa no permite que los usuarios aprueben aplicaciones, la pantalla de conexión muestra un enlace de aprobación. Ábrelo o cópialo para un administrador de Microsoft Entra, que aprueba Roberty una vez para la organización; después, vuelve a conectar.
- Solo se admite Azure DevOps Services — Azure DevOps Server (on-premises) y los repositorios TFVC no.
- Las políticas de acceso condicional que exigen IP también en flujos no interactivos pueden bloquear las llamadas de Roberty. En ese caso, habla con soporte.
- Si la autorización se cancela, la cuenta no participa en ninguna organización o el enlace de conexión caduca, la pantalla muestra el motivo y permite intentarlo de nuevo.
Desconectar elimina el Service Hook creado por Roberty. Para revocar también el consentimiento de la aplicación, elimina Roberty en myapps.microsoft.com.
GitLab
- Haz clic en Conectar con GitLab, inicia sesión con tu cuenta de gitlab.com y autoriza la aplicación Roberty Code.
- Elige el repositorio y las branches. La lista trae los proyectos no archivados de los que tu cuenta es miembro, personales y de grupos.
Al guardar, Roberty crea automáticamente un webhook de push en el proyecto de GitLab.
Requisitos y límites:
- Solo gitlab.com — GitLab self-managed y GitLab Dedicated no son compatibles.
- Para que Roberty cree el webhook, tu cuenta necesita el rol Maintainer u Owner en el proyecto. Con un rol menor, la conexión funciona, pero el webhook se tiene que configurar manualmente.
Desconectar elimina el webhook creado por Roberty y revoca el acceso de la aplicación.
Bitbucket
- Haz clic en Conectar con Bitbucket e inicia sesión con tu cuenta de bitbucket.org.
- Si la cuenta participa en más de un workspace de Bitbucket, elige el workspace donde está el repositorio.
- Elige el repositorio y las branches. La lista trae los repositorios del workspace elegido.
Al guardar, Roberty crea automáticamente un webhook "Repository push" en el repositorio.
Requisitos y límites:
- Solo Bitbucket Cloud — Bitbucket Data Center y Bitbucket Server no son compatibles.
- Un workspace por proyecto. Para usar un repositorio de otro workspace, desconecta y vuelve a conectar eligiendo el otro workspace.
- Para que Roberty cree el webhook, tu cuenta debe ser administradora del repositorio. Sin ese permiso, la conexión funciona, pero el webhook se tiene que configurar manualmente.
Desconectar elimina el webhook creado por Roberty. Para revocar también el acceso de la aplicación, elimina Roberty Code en Personal settings → App authorizations en Bitbucket.
Repositorio y branches
Con el proveedor conectado, elige de dónde se sincroniza el código de cada entorno:
| Campo | Obligatorio | Descripción |
|---|---|---|
| Repositorio | Sí | Busca entre los repositorios disponibles en el proveedor. |
| Producción | Sí | Branch desplegada en los dispositivos de Producción. |
| Preview | No | Branch de pruebas, desplegada en el dispositivo de Preview. |
La misma branch no se puede usar en los dos entornos. Al guardar, el repositorio y las branches pasan a valer para los próximos deploys. A partir de ahí, cada push a una de estas branches genera un deploy en los dispositivos del entorno correspondiente.
La tarjeta de la cuenta conectada muestra el estado Conexión activa o Reconexión necesaria.
Webhook
En Azure DevOps, GitLab y Bitbucket, los push llegan por un webhook que Roberty intenta crear al guardar la configuración. El panel Webhook muestra el estado:
| Estado | Qué significa |
|---|---|
| Activo | Deploy automático activo: cada push a las branches configuradas genera un deploy. Muestra la fecha del último push recibido. |
| Configuración manual | Tu cuenta no tiene permiso para crear el webhook. El panel muestra la URL y el secreto listos para copiar, y alguien con permiso sigue los pasos de abajo una vez. |
| Falló | El webhook no se creó. Los push no generan deploy hasta que se resuelva. Usa Intentar de nuevo. |
Pasos de la configuración manual:
- Azure DevOps (administrador del proyecto): Project settings → Service hooks → +, elige Web Hooks y el evento Code pushed, selecciona el repositorio (deja Branch y Pushed by en [Any]), pega la URL y el header en HTTP headers y finaliza.
- GitLab (Maintainer del proyecto): Settings → Webhooks → Add new webhook, pega la URL y el Signing token, marca solo Push events en Trigger y guarda.
- Bitbucket (administrador del repositorio): Repository settings → Webhooks → Add webhook, pega la URL y el Secret, deja solo Repository push en Triggers y guarda.
Después, usa Verificar de nuevo. El primer push recibido también marca el webhook como activo.
Volver a conectar
En Azure DevOps, GitLab y Bitbucket, la autorización puede caducar o ser revocada (cambio de contraseña, política del directorio, cuenta eliminada). En ese caso, el proyecto muestra Vuelve a conectar {proveedor} y los push no generan deploy hasta la reconexión. El repositorio y las branches quedan bloqueados para edición hasta que vuelvas a conectar.
Al volver a conectar con la misma cuenta — y, en Azure DevOps y Bitbucket, la misma organización o workspace —, el repositorio, las branches y el webhook siguen configurados. Elegir otro workspace de Bitbucket cuenta como una conexión nueva.
Cambiar de proveedor
Cambiar proveedor desconecta el proveedor actual para que conectes otro:
- Se elimina la conexión con el proveedor actual del proyecto.
- Los dispositivos dejan de ejecutar y quedan sin código hasta que conectes el nuevo proveedor y elijas repositorio y branches.
- La plataforma no copia el código: llevar el repositorio al nuevo proveedor es responsabilidad tuya.
- El historial de deploys se mantiene, pero el rollback solo está disponible para los deploys del proveedor conectado.
Cambiar entre Git y .zip
El mecanismo de despliegue se puede cambiar entre repositorio Git y subida de .zip. No es posible cambiarlo mientras haya un deploy en curso.
De Git a .zip:
- Se elimina la conexión con el proveedor Git del proyecto.
- El dispositivo de Preview se desvincula y se borran sus programaciones.
- Los dispositivos de Producción dejan de ejecutar y quedan sin código hasta la primera subida de .zip.
De .zip a Git:
- El archivo .zip se elimina de la plataforma y el espacio se devuelve al workspace.
- Los dispositivos dejan de ejecutar y quedan sin código hasta que conectes un proveedor Git y elijas repositorio y branch.
En los dos sentidos, el historial de deploys se mantiene, pero sin volver a desplegar versiones anteriores, y llevar el código a la nueva fuente es responsabilidad tuya.
Permisos
Solo los administradores del workspace pueden desconectar el proveedor, cambiar de proveedor y cambiar el mecanismo de despliegue.