¡Esta es una revisión vieja del documento!
Hemos implementado un repositorio de git que puedes utilizar libremente para cualquier script, aplicación o cualquier material que necesite versionado que quieras compartir con nosotros y otras personas en internet. Este artículo no va a explicar el uso básico de GIT pero habrá otro manual de uso básico o puedes revisar otros en Internet.
Partimos de la base de que tienes un repositorio local listo para subir al sistema. Si no tienes un repositorio local, pídeselo al ~admin)
Cómo utilizar tu repositorio de git remoto
Nuestra comunidad te ofrece un servidor, donde puedes almacenar repositorios git y actualzarlos, incluso desde el equipo local que utilizas para conectarte a texto-plano.xyz.
En nuestro servidor texto-plano
1. Crea enlace simbólico a git
Para poder utilizar git, debes contar con un enlace simbólico desde tu directorio ~/public_repos/ al directorio de sistema /var/www/cgit_repos/html/$USER. Dicho enlace simbólico ya debería existir, pero en caso de no estarlo puedes hacerlo con el siguiente comando:
ln -s /var/www/cgit_repos/$USER ~/public_repos
2. Genera un repositorio de proyecto
El repositorio de proyecto es un directorio localizado dentro de ~/public_repos/. Por ejemplo, puedes crear un directorio llamado mi_programa:
mkdir ~/public_repos/mi_programa/
Ingresa al directorio del respositorio e inícialo:
cd ~/public_repos/mi_programa/ ; git init --bare
3. Configura el repositorio creado
Una vez dentro del directorio del repositorio, edita el fichero .git/config, agregando el siguiente contenido al final del fichero (no olvides de adecuarlo con tu nombre de usuari@):
[gitweb] owner = usuario <usuario@texto-plano.xyz>
También puedes agregar una descripción del repositorio en un fichero llamado .git/description, que tenga únicamente una línea. Podrás hacerlo usando echo o bien tu editor favorito:
echo "mi fabulosa aplicación que sirve para X cosa" > ~/public_repos/mi_programa/.git/description
Con esto ya podrás utilizar git en texto-plano.xyz. Tu repositorio debería aparecer en https://git.texto-plano.xyz/
En tu dispositivo local
Para que tu repositorio en tu dispositivo local reconozca este repo remoto situado en texto-plano.xyz, debes añadir un repositorio remoto a tu sistema.
Dependerá de si trabajas tu aplicación desde tu ~usuario en texto-plano o si lo haces desde tu PC local:
Desde tu home en texto-plano.xyz
git remote add texto-plano.xyz /home/<USUARIO>/public_repos/<REPOSITORIO>
Si estás en tu dispositivo o PC local
git remote add texto-plano.xyz <USUARIO>@texto-plano.xyz:public_repos/<REPO>
(emplea SSH para conectarse)
Cuando quieras especificar qué ficheros se van a subir debes utilizar:
git add fichero
…Y tienes que hacerle un commit a los cambios
git commit -m "Commit Inicial"
(Opcionalmente, puedes revisar los cambios antes de que se suban)
git log
Cuando necesites actualizar un cambio:
git push -u texto-plano.xyz master
(o el nombre que le hayas puesto a la rama principal)
(Tomado desde la wiki de tilde.institute cuyo sistema es análogo al nuestro)
Para más información ver: la documentación de git