¡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 con extensión .git localizado dentro de ~/public_repos. Por ejemplo, puedes crear un directorio llamado mi_programa.git:
mkdir ~/public_repos/mi_programa.git/
Ingresa al directorio del respositorio e inicialízalo:
cd ~/public_repos/mi_programa.git/ ; git init --bare
3. Configura el repositorio creado
Edita el fichero config del directorio del repositorio, agregando el siguiente contenido al final del fichero (no olvides de adecuarlo con tu nombre de usuari@):
[gitweb] owner = usuario <usuario@texto-plano.xyz>
Agrega una descripción del repositorio en un fichero llamado 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" > 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/$USER/public_repos/<REPO>
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