Proyecto

General

Perfil

Uso básico de github » Histórico » Versión 1

Molina Coballes, Alberto, 03-05-2012 15:56

1 1 Molina Coballes, Alberto
h1. Uso básico de github
2
3
Para desarrollar la documentación de forma colaborativa se va a utilizar el sistema de control de versiones git, en particular se va a utilizar la forja github. Se ha creado en github la cuenta pi-fp-cloud que se encargará de ir creando todos los repositorios a los que se irán uniendo todos los participantes como colaboradoes.
4
5
h2. Crea una cuenta en github
6
7
* Entra en github.com y crea una cuenta nueva
8
* Configura las claves ssh siguiendo las instrucciones
9
* Solicita en el foro que te añadan como colaborador a los repositorios de pi-fp-cloud
10
11
h2. Usando el repositorio por primera vez
12
13
* Abre una terminal
14
* Instala el paquete git
15
* Configura sesión de git:
16
<pre>
17
git config --global user.name "<pon aquí tu nombre>"
18
git config --global user.email <pon aquí tu email>
19
</pre>
20
* Ubícate en el directorio donde quieras que se clonen los repositorios (supongamos ~/github):
21
<pre>
22
mkdir ~/github
23
cd ~/github
24
</pre>
25
* Clonamos un repositorio (por ejemplo el de infraestructura):
26
<pre>
27
git clone git@github.com:pi-fp-cloud/infraestructura.git
28
</pre>
29
Tendrás en local el directorio infraestructura con la última versión de todos los ficheros.
30
31
h2. Haciendo modificaciones y subiéndolas a github
32
33
* Podemos hacer modificaciones sobre los ficheros existentes o crear ficheros nuevos que queramos añadir al repositorio. Por ejemplo, supongamos que hacemos alguna modificación sobre el fichero servidores.xml, si preguntamos a git sobre el estado actual, nos responderá:
34
<pre>
35
$ git status
36
# On branch master
37
# Changed but not updated:
38
#   (use "git add <file>..." to update what will be committed)
39
#   (use "git checkout -- <file>..." to discard changes in working directory)
40
#
41
#	modified:   src/servidores.xml
42
#
43
no changes added to commit (use "git add" and/or "git commit -a")
44
</pre>
45
Es decir que ha cambiado el fichero src/servidores.xml, pero no se ha consignado (no se ha marcado para actualizar en el repositorio), si realmente queremos incluir las modificaciones en el repositorio, hacemos:
46
<pre>
47
git add src/servidores.xml
48
</pre>
49
Si volvemos a preguntar por el estado de git:
50
<pre>
51
$ git status
52
# On branch master
53
# Changes to be committed:
54
#   (use "git reset HEAD <file>..." to unstage)
55
#
56
#	modified:   src/servidores.xml
57
#
58
</pre>
59
Vamos a actualizar el repositorio (en git hay que hacerlo en dos pasos a diferencia de otros sistemas de control de versiones):
60
<pre>
61
$ git commit -m "Comentario sobre el fichero modificado"
62
$ git push
63
</pre>
64
65
h2. Abriendo una sesión sobre un repositorio existente
66
67
El clonado del repositorio sólo se suele hacer la primera vez, las demás simplemente se accede al directorio donde se encuentra la copia local y se actualiza:
68
69
* Abrimos una terminal
70
* Configura sesión de git (se puede añadir al fichero de configuración de la shell (~/.bashrc por ejemplo)):
71
<pre>
72
git config --global user.name "<pon aquí tu nombre>"
73
git config --global user.email <pon aquí tu email>
74
</pre>
75
* Accede al directorio con la copia local del repositorio (con el mismo ejemplo de antes):
76
<pre>
77
$ cd ~/github/infraestructura
78
</pre>
79
Actualiza el repositorio local:
80
<pre>
81
git pull
82
</pre>