Con Git de DirectAdmin puedes clonar un repositorio de GitHub (o GitLab) en tu hosting y publicar sus archivos con un clic, o solos cada vez que haces git push. El selector de Git solo muestra tus dominios principales, no los subdominios. Aun así puedes publicar en un subdominio: el repositorio se crea en el dominio principal y se despliega en la carpeta del subdominio.
Antes de empezar: el subdominio tiene que existir. Si aún no lo creaste, sigue la guía Cómo agregar un subdominio en DirectAdmin. En el video usamos app.cimapruebas.com.
Paso 1: Entra a tu panel DirectAdmin
Inicia sesión con tu usuario y tu contraseña.
Paso 2: Funciones Avanzadas › Git
En el menú de la izquierda, abre Funciones Avanzadas y entra a Git. El selector de arriba a la derecha solo lista dominios: deja el dominio principal del que cuelga tu subdominio. Si no ves Git, escríbenos para activarlo en tu plan.
Paso 3: Pulsa «Crear repositorio»
Pulsa Crear repositorio.
Paso 4: Escribe un nombre
En Nombre, escribe un nombre sin espacios, por ejemplo mi-app.
Paso 5: Pega la dirección de GitHub
En Remoto, pega la dirección de tu repositorio, la que termina en .git (en GitHub: botón Code › HTTPS). Si el repositorio es público, deja Archivo de llave vacío. Si es privado, mira la sección Repositorio privado.
Paso 6: Crear repositorio: el panel lo clona
Pulsa Crear repositorio. El panel clona el repositorio de GitHub y lo muestra en la lista.
Paso 7: Menú ⋯ › Editar
En la fila de tu repositorio, abre el menú de tres puntos (⋯) y elige Editar.
Paso 8: Elige la rama que se publica
En Despliegue Rama, elige la rama que quieres publicar: normalmente main (en el video, master).
Paso 9: Escribe la carpeta del subdominio
Este es el paso clave. En Despliegue Carpeta, escribe la carpeta del subdominio relativa a tu carpeta personal, sin /home/tu-usuario al principio:
domains/app.tudominio.com/public_html
Si escribes la ruta completa (/home/usuario/domains/…), el despliegue falla, porque el panel la suma a tu carpeta personal. La carpeta debe existir: el panel la crea al agregar el subdominio.
Paso 10: Pulsa «Guardar»
Pulsa Guardar. Verás el aviso Repositorio modificado.
Paso 11: Menú ⋯ › Despliegue
Abre otra vez el menú ⋯ y elige Despliegue. Verás Despliegue completado y tu subdominio ya muestra el sitio del repositorio.
Paso 12: Info: copia la webhook url
En el mismo menú, abre Info. Ahí ves la carpeta y la rama de despliegue, y la webhook url. Cópiala y guárdala en privado: con esa dirección cualquiera puede lanzar un despliegue de tu repositorio.
Despliegue automático con cada git push
En GitHub, entra a tu repositorio › Settings › Webhooks › Add webhook y completa:
| Campo en GitHub | Valor |
|---|---|
| Payload URL | La webhook url de Info |
| Content type | application/json |
| Which events…? | Just the push event |
| Active | Marcado |
Desde ahí, cada git push a la rama elegida trae los cambios y actualiza el subdominio, sin entrar al panel. También puedes desplegar a mano cuando quieras con ⋯ › Despliegue.
Repositorio privado
Un repositorio privado necesita una llave SSH de despliegue (deploy key) y la dirección SSH:
| Dónde | Qué hacer |
|---|---|
| Tu hosting (SSH) | Crea la llave: ssh-keygen -t ed25519 -N "" -f ~/.ssh/github |
| GitHub | Repositorio › Settings › Deploy keys › Add deploy key: pega el contenido de ~/.ssh/github.pub (solo lectura) |
| Remoto | [email protected]:usuario/repositorio.git |
| Archivo de llave | .ssh/github (relativo a tu carpeta personal) |
Si tu plan no tiene acceso SSH, escríbenos y te ayudamos a crear la llave.
Ten en cuenta
- Todo lo de la rama se publica, también el
READMEu otros archivos. No subas a GitHub claves ni archivos.env. - El despliegue reemplaza los archivos con el mismo nombre, pero no borra los que ya estaban en la carpeta.
- Git copia los archivos tal como están: si tu proyecto necesita compilarse (por ejemplo
npm run build), sube a la rama la versión ya compilada. - El repositorio queda en
domains/tudominio.com/nombre.git, fuera de la web.
Consejo: si solo quieres un repositorio para subir cambios con
git pushdesde tu computador, mira Cómo crear un repositorio Git en DirectAdmin. Fuente: documentación oficial de Git en DirectAdmin. El sitio del video es la plantilla «Dimension» de HTML5 UP (licencia CC BY 3.0).
¿Dudas? Escríbenos a [email protected].
¿Te sirvió esta guía?