Control de versiones Git en MiPanel

Gestiona tus repositorios Git y configura despliegues automáticos de tu sitio web directamente desde MiPanel, sin necesidad de usar la línea de comandos.

¿Qué es Git?

Git es un sistema de control de versiones, una herramienta que registra cada cambio que haces en el código de tu sitio web (o de cualquier proyecto). Con Git puedes:

• Guardar el historial completo de cambios: saber qué cambió, cuándo y quién lo hizo.
• Volver atrás en cualquier momento si algo sale mal.
• Trabajar en equipo sin pisarse los cambios entre varias personas.
• Desplegar tu sitio desde un repositorio remoto (como GitHub, GitLab o Bitbucket) de forma rápida y automática.

La función Control de versiones Git™ de MiPanel te permite conectar tu hosting con un repositorio remoto, clonarlo en tu servidor y gestionar los despliegues desde el panel, sin conocimientos avanzados.

¿Por qué usar Git en tu hosting?

• Despliegues automáticos: al hacer clic en un botón (o mediante un webhook), el código de tu repositorio se publica en tu sitio. Olvídate de subir archivos por FTP uno por uno.
• Menos errores: como el código proviene de un repositorio versionado, siempre sabes qué versión está publicada.
• Revertir cambios: si una actualización rompe tu sitio, puedes volver a una versión anterior en segundos.
• Mejor trabajo en equipo: cada integrante trabaja en su rama y el repositorio central mantiene el orden.
• Respaldos implícitos: tu código queda respaldado en el repositorio remoto (por ejemplo, en GitHub), además de tu copia en el servidor.

Casos de uso comunes

• Sitios web y tiendas: publicar actualizaciones del tema, plugins o código personalizado.
• Temas de WordPress: llevar el tema a un repositorio y desplegarlo sin tocar el administrador de WordPress.
• Aplicaciones propias: proyectos PHP, JavaScript u otros lenguajes que necesiten un flujo de despliegue controlado.
• Desarrollo y producción: mantener una copia de desarrollo en GitHub y desplegar en producción desde el panel.

Requisitos previos

Para clonar un repositorio remoto necesitas:

• Un repositorio Git en un proveedor como GitHub, GitLab o Bitbucket.
• Si el repositorio es privado, necesitas claves SSH configuradas. Puedes verlas y gestionarlas desde el botón Ver claves SSH en esta misma página (se explica más adelante).

Clonar un repositorio

La página Control de versiones Git™ se encuentra en MiPanel → Su cuenta → archivos (Ficheros) → Git Version Control dentro de tu servicio. En la sección Crear repositorio puedes clonar (copiar) un repositorio remoto a tu servidor:

1. Inicia sesión en cp.mipanel.cloud y entra a tu servicio.
2. Ve a Archivos → Git Version Control.
3. En la sección Crear repositorio, escribe la URL de clonación del repositorio remoto. Las URL válidas deben comenzar con los protocolos http://, https://, ssh:// o git://, o comenzar con un nombre de usuario y un dominio (por ejemplo, [email protected]:usuario/repositorio.git).
4. Introduce la Ruta del repositorio: la carpeta donde se guardará el código en tu servidor. Por ejemplo, /home/sites/6a/d/d9c5caba4c/. Si la ruta no existe, el sistema la creará automáticamente al clonar el repositorio.
5. Escribe un Nombre del repositorio. Es solo un nombre para mostrarlo en el panel; no afecta al funcionamiento. No puede incluir los caracteres < y >.
6. Haz clic en Crear repositorio.

Consejo: para saber en qué carpeta debe estar tu sitio (directorio raíz del documento), revisa la página Gestionar dominios, desde donde puedes administrar los nombres de dominio y su directorio raíz.

Lista de repositorios

Una vez creado el repositorio, aparecerá en la sección Lista de repositorios, donde verás:

• Repositorio: el nombre para mostrar que asignaste.
• Ruta del repositorio: la carpeta en el servidor donde se encuentra el código.

Desde la lista puedes buscar repositorios con el campo Buscar y acceder a las opciones de gestión de cada uno (actualizar el código, revisar el estado y gestionar los despliegues).

Claves SSH

Para que el servidor pueda clonar repositorios privados sin contraseña, MiPanel genera claves SSH que debes agregar como deploy keys en tu proveedor de Git (GitHub, GitLab, Bitbucket, etc.).

Haz clic en Ver claves SSH dentro de la página Git Version Control. Ahí encontrarás:

• Clave pública RSA y Clave privada RSA: el par de claves RSA generado para tu cuenta. Usa el botón Copiar para copiar la clave pública y pégala en tu proveedor de Git.
• Regenerar claves RSA: crea un nuevo par de claves RSA. Al regenerarlas, las claves anteriores dejan de funcionar y deberás actualizarlas en tu proveedor de Git.
• Clave pública ed25519 y Clave privada ed25519: un par de claves opcional con el algoritmo moderno ed25519. Por defecto no hay ninguna configurada; puedes crearlas con Regenerar claves ed25519.
• Regenerar todas las claves SSH: restablece todos los pares de claves a la vez.

Importante: la clave privada nunca debe compartirse. Solo debes copiar la clave pública en tu proveedor de Git.

Pasos para conectar un repositorio privado

1. Abre Ver claves SSH en la página Git Version Control.
2. Copia tu clave pública RSA (o la ed25519 si la has creado).
3. En GitHub (por ejemplo), ve a Settings → Deploy keys de tu repositorio y pega la clave con Add deploy key.
4. Vuelve a la página Git Version Control y clona tu repositorio usando la URL SSH ([email protected]:usuario/repositorio.git).

Despliegues automáticos

Además de clonar el repositorio, MiPanel te permite configurar despliegues automáticos: cuando actualizas tu repositorio remoto, el código puede publicarse en tu sitio automáticamente. De esta manera:

• Publicas nuevas versiones de tu sitio con un simple git push desde tu computadora.
• El código en el servidor siempre está al día con la rama que definiste.
• Puedes combinar Git con un flujo de trabajo en equipo: desarrollas localmente, subes los cambios al repositorio y el hosting los publica.

Preguntas frecuentes

¿Necesito conocimientos avanzados para usar Git?

No. MiPanel te ofrece un formulario simple para clonar el repositorio y gestionarlo desde el panel. Para aprovechar todo el potencial de Git (ramas, commits, etc.) sí conviene conocer lo básico, pero el despliegue lo hace el hosting por ti.

¿Qué pasa si la ruta del repositorio no existe?

El sistema la crea automáticamente cuando clonas el repositorio. Asegúrate de que la carpeta sea la correcta para tu sitio (revisa la página Gestionar dominios si tienes dudas).

¿Puedo usar repositorios privados?

Sí. Solo necesitas agregar la clave pública SSH de MiPanel como deploy key en tu proveedor de Git antes de clonar.

¿Qué protocolos acepta la URL de clonación?

Las URL válidas comienzan con http://, https://, ssh:// o git://, o con un formato tipo usuario@dominio (por ejemplo, [email protected]:usuario/repositorio.git).

¿Regenerar las claves SSH rompe mis repositorios?

Sí. Si regeneras las claves, las antiguas dejan de ser válidas. Deberás actualizar la nueva clave pública en todos los proveedores de Git donde la hayas registrado y, en algunos casos, volver a clonar o reconectar el repositorio.