Hemos implementado un repositorio de git que puedes utilizar libremente para cualquier guión, 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 para el repositorio de tu software que deseas compartir, denominado mi_programa:
mkdir ~/public_repos/mi_programa/
Ingresa al directorio del respositorio de mi_programa, e inicialízalo en nuestro servidor git compartido:
cd ~/public_repos/mi_programa/ ; git init --bare
3. Configura el repositorio creado
Asegúrate de editar el fichero ~/public_repos/mi_programa/.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>
Si bien es opcional, es muy recomendable agregarle aste repositorio de mi_programa una descripción del repositorio. Esto se hace agregando una única línea d etexto en el fichero de descripción correpondiente, en este caso ~/public_repos/mi_programa/.git/description. Puedes hacerlo uzando tu tu editor favorito o bien usando el comando echo, como en este ejemplo:
echo "mi programa es fabuloso para hacer 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/mi_programa
Si estás en tu dispositivo o PC local
git remote add texto-plano.xyz <USUARIO>@texto-plano.xyz:public_repos/mi_programa
(emplea SSH para conectarte)
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