Orbit
Conectando un repositorio de Bitbucket
Bitbucket connects to Orbit through OAuth: you authorise Kapsule once, Orbit lists the repositories your Bitbucket account can reach, and it registers a webhook per repository so every push triggers…
Bitbucket se conecta a Orbit a través de OAuth: autorizas Kapsule una vez, Orbit lista los repositorios que tu cuenta de Bitbucket puede alcanzar, y registra un webhook por repositorio para que cada push dispare una compilación. Esta guía cubre la conexión, la selección de un repositorio, la creación del proyecto, y qué verificar cuando un repositorio no aparece.
Antes de Comenzar
Orbit ve solo lo que tu cuenta de Bitbucket ve. Para un repositorio de workspace necesitas al menos acceso de escritura, y suficiente permiso para que se cree un webhook de repositorio. Si tu workspace restringe consumidores OAuth de terceros, un administrador tiene que permitir Kapsule Orbit antes de que la conexión tenga éxito.
Paso 1: Conectar Bitbucket
- En KPanel, haz clic en Orbit en la barra lateral izquierda.
- Haz clic en New project.
- Deja el modo en Import Git Repo.
- En el paso 1, haz clic en Connect Bitbucket.
Se te envía a Bitbucket para autorizar el consumidor OAuth de Kapsule Orbit. Otorga los permisos solicitados y Bitbucket te devuelve a KPanel con tus repositorios cargados. El paso 1 entonces muestra Just connected.
Si la autorización falla, KPanel muestra el error que Bitbucket devolvió. Léelo en lugar de reintentar a ciegas: una política de workspace bloqueada y una autorización cancelada se ven similares pero necesitan correcciones diferentes.
Paso 2: Seleccionar un Repositorio
Tus repositorios accesibles aparecen como una lista. Haz clic en Select junto al que deseas desplegar. Los repositorios privados llevan una insignia Private; Orbit despliega repositorios públicos y privados por igual.
Si un Repositorio Falta
- Confirma tu nivel de acceso en el repositorio. El acceso de lectura no es suficiente; necesitas acceso de escritura para que Orbit registre el webhook que necesita.
- Verifica que el repositorio esté en un workspace al que realmente perteneces, no uno al que solo tienes un enlace.
- Haz clic en Reconnect Bitbucket en el paso 1 para volver a ejecutar el flujo OAuth y actualizar el token y la lista de repositorios.
Si el panel muestra No repos accessible, la concesión fue exitosa pero no devolvió nada. Reconecta y confirma que aprobaste los scopes del repositorio.
Paso 3: Configurar Tu Proyecto
| Campo | Qué hace |
|---|---|
| Project Name | El nombre que se muestra en KPanel, por ejemplo my-app |
| Deploy URL | El subdominio bajo kaps.run, entonces my-app se convierte en my-app.kaps.run |
Haz clic en Create project. Orbit clona el repositorio, pone en cola la primera compilación, y te lleva a la descripción general del proyecto con el registro en streaming.
El slug de Deploy URL se establece una sola vez, en la creación, y no se puede editar después. Para servir bajo una dirección diferente, adjunta un dominio personalizado. Ver Adding a Custom Domain to Your Project.
Despliegues Automáticos
Orbit registra un webhook en tu repositorio de Bitbucket en la creación del proyecto. Después de eso:
- Un push a tu rama de producción pone en cola un despliegue de producción.
- Un push a cualquier otra rama compila una vista previa aislada en
branch-<branch-name>.kaps.run, si Branch previews está habilitado en Settings bajo Runtime. Ver Branch Preview Deployments in Orbit. - Eliminar una rama pausa su entorno de vista previa, y el almacenamiento se recupera dentro de aproximadamente un día.
Nunca creas o mantienes el webhook tú mismo.
La configuración CI required checks en Orbit controla despliegues por nombres de trabajos de GitHub Actions o un pipeline de GitLab. No controla Bitbucket Pipelines. Si necesitas Bitbucket Pipelines para decidir cuándo ocurre un despliegue, desactiva despliegues disparados por push para esa rama y en su lugar haz que tu pipeline llame a un deploy hook al tener éxito. Ver Triggering Deployments Via Deploy Hooks.
Reconectar o Desconectar Bitbucket
- Haz clic en Orbit, luego en New project.
- En el paso 1, haz clic en Reconnect para volver a ejecutar el flujo OAuth, o en Disconnect para eliminar el enlace.
Reconectar es el primer paso correcto siempre que el listado de repositorios se rompa, porque los tokens OAuth caducan y reconectar genera uno nuevo.
Desconectar mantiene tus proyectos e historial de despliegue, y el despliegue activo sigue sirviendo tráfico. Los despliegues disparados por push se detienen. Los deploy hooks también se detienen, porque un hook lee la cabeza de rama a través de la conexión del proveedor para decidir qué compilar.
Lecturas Relacionadas
- Deploying Your Project para el ciclo completo de despliegue, bloqueos de despliegue y aprobaciones
- Configuring Your Build Command and Output Directory si la primera compilación falla o publica la carpeta equivocada
- Connecting a GitHub Repo y Connecting a GitLab Repo para los otros proveedores