PDF de programación - Tutorial de Git en Español

Tutorial de
Git en
Español

Este tutorial es
una traducción
con
algunos
agregados de
Git Tutorial, de
Lars Vogel.

Para
la
traducción se
han mejorado
algunas cosas
para
adaptarlas
al
habla hispana.
todas
De
maneras,
el
vocabulario
puede
usado
resultarte raro.
No estoy de
acuerdo
con
traducir todas
las
palabras
desde el inglés

al
español,
porque muchas
veces esto es
imposible. Me
he encontrado
en
libros de
bases de Datos
que me hablan
de
"comprometer"
una
transacción,
cuando podrían
directamente
haber usado la
palabra
"commit". Por
eso,
tales
palabras
quedan
inglés,
corresponde.
También puede
resultarte raro
que transforme
esas palabras
en verbos y las
conjuge, como
por ejemplo, la
de
acción
un
hacer
"commit"
la
llamo
"comitear". Si

en
como

nunca
lo
escuchaste, no
te preocupes,
porque esta es
la jerga que se
utiliza en
la
industria.

1. Git
1.1. ¿Qué es Git?
1.2. Terminología importante
1.3. Staging index

2. Instalación
3. Configuración
3.1. Configuración del usuario
3.2. Resaltado de colores
3.3. Ignorar ciertos archivos

4. Empezando con Git

4.1. Creando contenido
4.2. Crear el repositorio y hacer
un commit
4.3. Ver las diferencias via diff y
commitear los cambios
4.4. Status, Diff y el log de
Commit
4.5. Corrección de mensajes de
commit - git amend
4.6. Eliminar archivos

5. Trabajando con repositorios
externos

5.1. Creando un repositorio Git
externo
5.2. Subir los cambios a otro
repositorio - Push
5.3. Add remote
5.4. Mostrar los repositorios
externos existentes
5.5. Clonar tu repositorio
5.6. Trayendo los cambios - Pull

6. Revertir cambios
7. Etiquetando en Git - Tagging
8. Branches y Merging
8.1. Branches
8.2. Merging
8.3. Borrar un branch

9. Resolviendo conflictos
después de un merge
10. Rebase
10.1. Utilizando rebase para
varios commits en un mismo
branch
10.2. rebase entre branches
10.3. Buenas prácticas para el
uso de rebase

11. Creando y aplicando
parches
12. Definiendo un alias
13. Ignorando un archivo /
directorio
14. Otros comándos útiles
15. Instalando un servidor Git

16. Repositorios remotos online
16.1. Clonando repositorios
remotos
16.2. Agregando más
repositorios remotos
16.3. Operaciones remotas via
HTTP y un proxy

17. Proveedores de hosting Git
17.1. GitHub
17.2. Bitbucket

18. Herramientas gráficas para
Git
19. Obtené la versión original
para Kindle
20. Preguntas y comentarios
21. Links y recursos útiles

distribuído

1. Git
1.1. ¿qué es Git?
Git es un sistema de control de
versiones
(scvd)
escrito en C. Un sistema de
control de versiones permite la
creación de una historia para
una colección de archivos e
incluye
funcionalidad para
revertir la colección de archivos
a otro estado. Otro estado
puede significar a otra colección

la

de

diferente
archivos
contenido diferente de
archivos.

o
los

Podés, por ejemplo, cambiar la
colección de archivos a un
estado de 2 días atras, o podés
cambiar entre los estados para
caracteristicas experimentales
y problemas de producción.

es

control

de
todos

completa del

Esta colección de archivos
generalmente
llamada
"código fuente". En un sistema
de
versiones
tienen una
distribuído
copia
código
fuente (incluyendo la historia
completa del código fuente) y
puede
operaciones
referidas al control de versiones
mediante esa copia local. El uso
de un scvd no requiere un
repositorio central.

realizar

Si haces cambios al código
fuente, haces esos cambios
relevantes para el control de
versiones
al
staging index) y después los
agregas al repositorio (commit).

agregas

(los

Git mantiene
las
versiones. Por lo tanto podés

todas

revertir a cualquier punto en la
historia de tu código fuente
usando Git.

los

(tal

vez

Git realiza los commits a tu
repositorio local y es posible
sincronizar ese repositorio con
remotos)
otros
repositorios. Git
te permite
clonar
repositoriso, por
ejemplo, crear una copia exacta
de un repositorio incluyendo la
historia completa del código
fuente. Los dueños de
los
repositorios pueden sincronizar
via push
los
(transfiere
cambios
al
repositorio remoto) o pull
(obtiene los cambios desde un
repositorio remoto).

cambios
los

varias

Git soporta el concepto de
branching, es decir, podés
tener
versiones
diferentes de tu código fuente.
Si querés desarrollar una nueva
característica, podés abrir un
branch en tu código fuente y
hacer
los cambios en este
el
branch
principal
tu
código.

afectar
de

desarrollo

sin

Git puede ser usado desde la

de

gráficas,

comandos;

linea
esta
manera será la descripta en
este tutorial. También existen
herramientas
por
ejemplo Egit para el IDE Eclipse,
pero estas herramientas no van
a
ser descriptas en este
tutorial.
1.2. Terminología
importante

Término
RepositorioUn repositorio

Definición

contiene la historia,
las diferentes
versiones en el
tiempo y todas los
distintos branch y
etiquetas. En Git,
cada copia del
repositorio es un
repositorio
completo. El
repositoro te
permite obtener
revisiones en tu
copia actual.
Un branch es una
linea separada de
código con su propia
historia. Te es
posible crear un

Branch

nuevo branch de a
partir de uno
existente y cambiar
el código
independientemente
de otros branches.
Uno de los branches
es el original
(generalmente
llamado master). El
usuario selecciona
un branch y trabaja
en ese branch
seleccionado, el cual
es llamado copia
actual (working
copy). Seleccionar
un branch es
llamado "obtener un
branch" (checkout a
branch)
Un tag (una
etiqueta) apunta a
un cierto punto en el
tiempo en un branch
específico. Con un
tag, es posible tener
un punto con un
tiempo al cual
siempre sea posible
revertir el código,
por ejemplo, ponerle
el tag "testing" al
código 25.01.2009

Etiquetas
(Tags)

Commit

URL

Revisión

Vos hacés un
commit de los
cambios a un
repositorio. Esto
crea una revisión
nueva la cual puede
ser obtenida
después, por
ejemplo si querés
ver el código fuente
de una versión
anterior. Cada
commit contiene el
autor y el que
realizó el commit
(comiteador), siendo
así posible
identificar el origen
del cambio. El autor
y el comiteador
pueden ser
diferentes personas.
Una URL en Git
determina la
ubicación de un
repositorio.
Representa una
versión del código
fuente. Git identifica
revisiones con un id
SHA1. Los id son de
160 bits de largo y
son representados
en hexadecimal. La

última versión
puede ser
direccionada a
través de "HEAD", la
versión anterior
mediante "HEAD-1"
y así siguiendo.
1.3. Staging index
(el índice)
Git requiere que los cambios
sean marcados explicitamente
para el próximo commit. Por
ejemplo, si haces un cambio en
un archivo y querés que y
querés que ese cambio sea
relevante para el próximo
commit, es necesario que
agregues el archivo a lo que se
llama
"staging
index" mediante el comando
git add. Dicho índice será
una imagen completa de los
cambios.

comunmnete

ser
al

Los nuevos archivos siempre
explicitamente
deben
añadidos
índice.
Para
archivos que ya han sido
comiteados podés usar
la
opción -a durante el commit.

2.
Instalación

En Ubuntu podés
la
herramienta de consola de Git
con el siguiente comando:

instalar

sudo apt-get
install git-core

Para otras distribuciones de
Linux deberías consultar
la
documentación correspondiente
a la distro.

Una versión de Git para
Windows podés encontrarla en
el sitio del proyecto msysgit. La
URL
es:
http://code.google.com/p/msysgit/
.

3.
Configuración

te

permite

Git
almacenar
configuraciones globales en el
archivo .gitconfig. Ese archivo

en

información

ser ubicado

debe
tu
directorio de usuario (el home).
Como mencioné anteriormente
Git almacena el comiter y el
autor para cada commit. Esta y
otra
adicional
puede ser almacenada en la
configuración global.

en

A continuación veremos cómo
configurar Git para utilizar un
usuario y dirección de correo
electrónico
particular,
habilitar
los colores y cómo
decirle a Git que ignore ciertos
archivos.
3.1. Configuración
del usuario
Configurá tu usuario e email
para Git mediante los siguientes
comandos:

# Configura el
usuario que será
usado por git
# Obviamente
deberías usar tu
nombre
git config --
global user.name
"Santiago

Basulto"
# Lo mismo
para el correo
electrónico
git config --
global user.email
"santiago.basulto
-
[email protected]
"
# Configurar
para que todos los
cambios generen un
push por defecto
git config --
global
push.default
"matching"

3.2. Resaltado de
colores
Esto activará el resaltado de
colores en la consola:

git config --
global
color.status auto
git config --
global
color.branch auto

en

estar

3.3. Ignorar ciertos
archivos
Git puede ser configurado para
que ignore ciertos archivos y
directorios. Esta configuración
es realizada mediante el archivo
.gitignore. Este archivo
puede
cualquier
directorio y puede contener
patrones para archivos. Por
ejemplo, es posible decirle a git
que ignore el directorio bin y
todos los archivos que finalicen
con
extensión pyc
la
(archivos
python
compilados)
el
siguiente patrón en el archivo
.gitignore
directorio
principal.

de
mediante

en

el

bin
*.pyc

ofrece

también

la
Git
configuración
global
core.excludefile para especificar
de manera global qué patrones
ignorar.

4.

Empezando
con Git

Git

local

continuación

trataré de
A
través de una
guiarte a
utilización típica de Git. Vas a
crear algunos archivos, crear un
repositorio
y
commitear los archivos en este
repositorio.
Después
clonaremos el
repositorio y
haremos push y pull entre los
repositorios. Los comentarios
(marcados con #) antes de
cada comando explican
las
acciones específicas.

una

para

conso