Cómo Conectar Repositorios

Puedes conectar el repositorio con el código de tu aplicación a nuestra Plataforma de Apps al crear una nueva aplicación en el panel de control de Hostman.

La Plataforma de Apps admite repositorios de GitLab, GitHub y BitBucket, así como cualquier repositorio accesible mediante URL, incluidos Gitea, GitLab autoalojado, GitHub Enterprise, etc.

Conectar un repositorio desde GitLab, GitHub o BitBucket

Para conectar el repositorio:

1. Ve a la sección Plataforma de Apps y haz clic en Crear.

2. En el paso Repositorio, haz clic en el icono de la plataforma.

3. Inicia sesión en tu cuenta.

4. Concede acceso a los repositorios necesarios.

5. Selecciona el repositorio para el despliegue en el panel de Hostman.

Si ya iniciaste sesión en tu cuenta de GitHub, GitLab o Bitbucket, Hostman mostrará automáticamente los repositorios disponibles. Solo tienes que seleccionar el que necesites.

Si has iniciado sesión pero no aparece el repositorio que necesitas:

1. Haz clic en Añadir cuenta.

2. Elige una plataforma.

3. Inicia sesión si es necesario.

4. Selecciona los repositorios requeridos y guarda los cambios.

Luego selecciona el repositorio deseado para el despliegue en el panel de Hostman.

Conectar un repositorio por URL

Puedes conectar cualquier repositorio a la Plataforma de Apps que tenga una dirección HTTP o HTTPS externa, incluidos repositorios de GitLab autoalojado, GitHub Enterprise, o repositorios alojados por proveedores que no admitimos directamente (por ejemplo, Gitea).

Esta opción también puede usarse por motivos de seguridad: si no deseas conceder acceso a toda la cuenta de Git, puedes añadir solo un repositorio específico mediante un enlace.

Ten en cuenta que los despliegues automáticos no estarán disponibles para los repositorios conectados por URL. Después de actualizar el código, deberás desplegar la aplicación manualmente seleccionando el commit deseado.

Para repositorios públicos, basta con proporcionar la URL.

Para repositorios privados, deberás proporcionar el usuario y la contraseña de la cuenta, o un token generado en la interfaz del proveedor (GitLab, GitHub, etc.).

Conectar un repositorio

Puedes conectar el repositorio mediante URL al crear una nueva aplicación:

1. Ve a la sección Plataforma de Apps y haz clic en Crear.

2. En el paso Repositorio, haz clic en Conectar el repositorio vía URL.

3. Proporciona la URL del repositorio y los datos de acceso si es privado.

4. Haz clic en Conectar.

5. El repositorio y los commits disponibles se mostrarán en el panel de control.

Obtener un enlace git

El enlace debe tener el formato de URL de Git, por ejemplo:

https://github.com/hostman/app-example.git

En GitHub, puedes obtener el enlace haciendo clic en Código → HTTPS.

En GitLab o BitBucket es similar: ve al repositorio → haz clic en Código/Clonar → Clonar con HTTPS.

Obtener enlace y token en BitBucket

Hay dos formas de obtener un token y un enlace en BitBucket.

Método 1

1. Ve a Configuración personal de Bitbucket → Contraseña de aplicación.

2. Asigna un nombre (Etiqueta) y permisos. Los permisos de solo lectura son suficientes.

3. Haz clic en Crear.

4. Copia la contraseña y pégala en el campo Contraseña o token en el panel de Hostman.

5. Ve al repositorio y haz clic en Clonar. Copia todo lo que aparece después de git clone y pégalo en el campo URL del repositorio.

6. Copia la parte del enlace entre https:// y @ y pégala en el campo Nombre de usuario.

Método 2.

1. Ve a Configuración → Configuración del repositorio → Token de acceso → Crear token de acceso al repositorio.

2. Asigna un nombre y permisos (alcances). Los permisos de lectura del repositorio son suficientes.

3. Copia el valor del campo Tu token de acceso al repositorio y pégalo en el campo Contraseña o token en el panel de Hostman.

4. Como enlace al repositorio, usa la URL del campo Cómo usar este token con tu repositorio Git. Copia todo lo que aparece después de git clone y pégalo en el campo URL del repositorio en el panel de Hostman.

Obtener un token en GitHub

No podrás conectar un repositorio de GitHub con tu contraseña de cuenta; necesitas un token.

Para generar un token en GitHub:

1. Ve a Configuración → Configuración del desarrollador → Tokens de acceso personal → Tokens → Generar nuevo token de acceso personal.

2. Asigna nombre, fecha de vencimiento y permisos al token. Para trabajar con repositorios privados, selecciona repo.

3. Haz clic en Generar token.

4. Copia el token y pégalo en el campo Contraseña o token del panel de Hostman.

Obtener un token en GitLab

Para conectar repositorios de GitLab, puedes usar la contraseña de tu cuenta o un token generado en los ajustes de tu cuenta de GitLab.

1. Ve a Preferencias → Tokens de acceso.

2. Crea un nuevo token, indicando el nombre, fecha de vencimiento y permisos. Como mínimo, necesitas permisos de lectura de repositorios.

3. Haz clic en Crear token de acceso personal.

4. Copia el token y pégalo en el campo Contraseña o token del panel de Hostman.

Eliminar repositorios conectados

Cualquier repositorio agregado puede desvincularse de la Plataforma de Apps.

Si desvinculas un repositorio, los despliegues (automáticos y manuales) de todas las aplicaciones creadas desde ese repositorio dejarán de estar disponibles.

1. Ve a la sección Plataforma de Apps y haz clic en Crear.

2. Ve al paso Repositorio. Haz clic en la lista desplegable de repositorios y luego en Eliminar junto al repositorio que desees quitar.

3. Confirma la acción.

La Plataforma de Apps no muestra el repositorio requerido

Si tu cuenta de GitHub, GitLab o Bitbucket está conectada a la Plataforma de Apps pero no se muestra el repositorio necesario en el panel de control de Hostman, puede deberse a dos razones:

• Añadiste el repositorio después de iniciar sesión en tu cuenta desde la Plataforma de Apps.

• Permitiste el acceso solo a ciertos repositorios y el necesario no está seleccionado.

Para solucionar el problema:

1. Ve a la sección Plataforma de Apps y haz clic en Crear.

2. Ve al paso Repositorio y haz clic en Añadir cuenta.

3. Selecciona una plataforma.

4. Inicia sesión si es necesario.

5. Selecciona el repositorio deseado y guarda los cambios.

Los repositorios conectados aparecerán en el panel de Hostman y podrás seleccionar el que necesites.