Uso de git (Cursos de e-ghost 2011)
Descargar como ODP, PDF8 recomendaciones1,595 vistas
El documento proporciona una introducción exhaustiva a los sistemas de control de versiones, enfocándose en Git y sus diferenciaciones frente a otros sistemas como CVS y Subversion. Se detalla la terminología y los conceptos fundamentales de Git, incluyendo tipos de objetos, ramas, y operaciones básicas como merge, fetch, y pull. Además, se presentan diversas prácticas recomendadas y trucos para el uso efectivo de Git en entornos de desarrollo colaborativo.
![Iñaki Arenaza [email_address] @iarenaza (Creative Commons Attribution Non-commercial Share Alike 3.0 Spain License) Introducción al uso de](https://image.slidesharecdn.com/uso-git-110728145046-phpapp02/85/Uso-de-git-Cursos-de-e-ghost-2011-1-320.jpg)
Uso de git (Cursos de e-ghost 2011)
- 1. Iñaki Arenaza [email_address] @iarenaza (Creative Commons Attribution Non-commercial Share Alike 3.0 Spain License) Introducción al uso de
- 2. Sistemas de Control de Versiones Centralizados (CVCS) Ejemplos: CVS, Subversion, Perforce, SourceSafe, ... Fuente: http://progit.org/book/ch1-1.html (CC-BY-NC-SA 3.0)
- 3. Sistemas de Control de Versiones Distribuidos (DVCS) Ejemplos: git, Mercurial, Bazaar, BitKeeper,... Fuente: http://progit.org/book/ch1-1.html (CC-BY-NC-SA 3.0)
- 4. Diferencias versus instantáneas git, Mercurial* Bazaar, Mercurial* Fuente: http://progit.org/book/ch1-3.html (CC-BY-NC-SA 3.0) Fuente: http://progit.org/book/ch1-3.html (CC-BY-NC-SA 3.0)
- 5. (Algunas) características de git (Casi) todas las operaciones son locales
- 6. Git tiene integridad fuerte (sha1)
- 7. Git (generalmente) sólo añade datos
- 8. Los tres espacios y tres estados Fuente: http://progit.org/book/ch1-3.html (CC-BY-NC-SA 3.0) Modified* Staged Committed
- 9. Los tres espacios El directorio (repositorio) es donde git almacena los metadatos y la base de datos de objetos para tu proyecto.
- 10. El directorio de trabajo es una copia de trabajo de una versión del proyecto.
- 11. El área de preparación (staging area) es un archivo que almacena información sobre lo que irá en el próximo commit. Antes se le llamaba “el índice”.
- 12. Los tres estados Confirmado/no modificado (committed): los datos están almacenados de manera segura en el directorio.
- 13. Modificado (modified): se ha modificado el archivo pero todavía no se ha confirmado.
- 14. Preparado (staged): se ha marcado para confirmación un archivo modificado en su versión actual.
- 15. Los “tres + 1” estados Fuente: http://progit.org/book/ch2-2.html (CC-BY-NC-SA 3.0) El estado 3+1
- 16. Terminología de git En los ejemplos siguientes $GIT_DIR contiene la ruta de un repositorio git dado
- 17. objeto: unidad de almacenamiento en git. Se identifica de forma unívoca por el SHA1 de su contenido.
- 18. Por tanto, un objeto es inmutable.
- 19. Tipos de objetos de git blob: objeto sin tipo, para guardar el contenido de un fichero. “Un fichero”.
- 20. tree: lista de nombres y permisos, junto con las referencias de objetos blob o tree asociados. “Un directorio”.
- 21. Tipos de objetos de git commit: información de una revisión dada. Incluye: los padres del objeto,
- 22. la persona que ha realizado el commit de la revisión,
- 23. el autor de la revisión,
- 24. la fecha de la misma,
- 26. el objeto tree que corresponde al directorio raíz de la revisión.
- 27. Tipos de objetos de git tag: identifica de forma simbólica a otros objetos y puede ser usado para firmar éstos. Contiene: el nombre y tipo de otro objeto,
- 28. un nombre simbólico (el de la propia tag)
- 29. puede contener un mensaje asociado.
- 30. opcionalmente puede incluir una firma (PGP). En este último caso se denomina un "objeto de etiqueta firmada".
- 31. Terminología de git (cont.) nombre de objeto o identificador de objeto: identificador único del objeto ( de 40 bytes con la representación hexadecimal del SHA1 de su contenido )
- 32. base de datos de objetos: almacena un conjunto de objetos ( habitualmente en $GIT_DIR/objects/ ).
- 33. ref o referencia: cadena de 40 bytes con la representación hexadecimal de un SHA1, o un nombre simbólico ( que se almacena en $GIT_DIR/refs/ ) que denota un objeto particular.
- 34. Terminología de git (cont.) revisión: estado concreto de una serie de ficheros y directorios que ha sido almacenado en la base de datos de objetos. Se hace referencia a él por medio de un objeto commit.
- 35. padre: un objeto commit contiene una lista (potencialmente vacía) de objetos commit que representan a sus predecesores lógicos en la línea de desarrollo, esto es, sus ancestros.
- 36. Tipos de objetos de git Fuente: http://progit.org/book/ch3-1.html (CC-BY-NC-SA 3.0)
- 37. Tipos de objetos de git Fuente: http://progit.org/book/ch3-1.html (CC-BY-NC-SA 3.0)
- 38. Terminología de git (cont.) repositorio: colección de referencias junto con una base de datos de objetos tiene todos los objetos que son alcanzables desde dichas referencias.: Puede contener además algunos meta datos adicionales usados por determinas órdenes de git.
- 39. Puede contenier una copia de trabajo de una revisión. repositorio desnudo (bare): repositorio que no tiene una copia de trabajo. Los de control de git que normalmente estarían presentes en el subdirectorio oculto .git están presentes en el propio directorio del repositorio.
- 40. Terminología de git (cont.) árbol de trabajo o copia de trabajo: Una revisión extraida del repositorio, para poder trabajar con ella.
- 41. índice: una colección de ficheros con información de stat(2), cuyos contenidos están almacenados como objetos. El índice es una versión almacenada del árbol de trabajo.
- 42. Terminología de git (cont.) rama: línea activa de desarrollo. El commit más reciente de una rama se denomina la punta de dicha rama. La punta de la rama se referencia por medio de una cabeza.
- 43. La copia de trabajo está siempre asociada a una rama (la rama "actual" o "checked out") y la cabeza especial “HEAD” apunta a esa rama. cabeza: una referencia con nombre, que apunta al objeto commit de la punta de una rama. Las cabezas se almacenan en $GIT_DIR/refs/heads/, (salvo que se usen referencias empaquetadas).
- 44. Terminología de git (cont.) checkout: acción de actualizar parte o todo el árbol de trabajo con un objeto árbol o blob desde la base de datos de objeto Además actualiza el índice y la referencia HEAD si se ha cambiado de rama.
- 45. Terminología de git (cont.) Fuente: http://progit.org/book/ch3-1.html (CC-BY-NC-SA 3.0) Estado “inicial” master sigue siendo la rama activa en la copia de trabajo $ git branch testing $ git checkout testing testing pasa a ser la rama activa en la copia de trabajo 1 2 3 4
- 46. Terminología de git (cont.) $ git add some-file(s) $ git commit -m ... $ git checkout master $ git add some-file(s) $ git commit -m ... Fuente: http://progit.org/book/ch3-1.html (CC-BY-NC-SA 3.0) 1 2 3
- 47. Terminología de git (cont.) merge: fusionar los contenidos de otra rama (potencialmente desde un repositorio externo) en la rama actual. Si la rama es de otro repositorio, primero se hace un fetch* de la rama y después se fusiona en la rama actual.
- 48. La fusión puede crear un nuevo objeto commit si una de las ramas no es un ancestro de la otra.
- 49. Si una es ancestro de la otra, simplemente se mueve la referencia de la cabeza de la rama fusionada ( fast-forward merge ).
- 50. merge: escenario 1 Fuente: http://progit.org/book/ch3-2.html (CC-BY-NC-SA 3.0) $ git checkout master $ git merge hotfix $ git branch hotfix master $ git checkout hotfix $ git add …. $ git commit 1 2 3
- 51. merge: escenario 2 Fuente: http://progit.org/book/ch3-2.html (CC-BY-NC-SA 3.0) $ git merge iss53 $ git checkout -b iss53 master $ git add …. $ git commit $ git checkout master $ git add …. $ git commit 1 2 3
- 52. Operaciones en el área de trabajo Crear nuevas ramas locales (ultra rápido y baratísimo en disco): Extraer una rama al área de trabajo: Consultar la rama activa: Mostrar el estado del área de trabajo: Marcar cambios para commit: $ git branch mdl21-nested-groups mdl21-ldap-refactor $ git checkout mdl21-nested-groups $ git branch $ git status $ git add fichero1 fichero2 ... $ git rm fichero3 fichero4 ...
- 53. Operaciones en el área de trabajo Mostrar diferencias con el índice o con HEAD: Mostrar diferencias con otras ramas: Hacer commit de los cambios (marcados):
- 54. Usar gitk para visualizar el historial de una rama:
- 55. Usar gitk para visualizar el historial de todas las ramas: $ git diff $ git diff HEAD $ git diff MOODLE_21_STABLE $ git diff MOODLE_21_STABLE..mdl21-ldap-refactor $ git commit $ gitk mdl21-nested-group $ gitk --all
- 56. Terminología de git (cont.) clone: obtener una copia local completa * de un repositorio git remoto. Fuente: http://progit.org/book/ch3-5.html (CC-BY-NC-SA 3.0) * las cabezas de las ramas remotas son inamovibles**
- 57. Terminología de git (cont.) fetch: obtener la cabeza de una rama (o varias) desde un repositorio remoto, copiando los objetos falten y moviendo la(s) cabeza(s) remota(s). Fuente: http://progit.org/book/ch3-5.html (CC-BY-NC-SA 3.0) 1 2
- 58. Terminología de git (cont.) pull: hacer un fetch seguido de un merge, con una rama remota dada.
- 59. push: enviar los objetos de la rama local que no están en la rama remota a la que hace referencia el pull, y actualizar la cabeza de la rama remota. Es la acción complementaria de pull.
- 60. Si la cabeza de la rama remota no es un ancestro de la cabeza de la rama local, el push falla*.
- 61. Operaciones en el área de trabajo Clonar un repositorio “remoto”: $ git clone git://git.moodle.org/moodle.git $ git clone ssh://iarenaza@git.moodle.org/moodle.git $ git clone http://git.moodle.org/moodle.git $ git clone git@github.com:iarenaza/moodle.git $ git clone /ruta/a/moodle.git /ruta/a/otro-moodle.git $ git clone -o moodle.git git@github.com:iarenaza/moodle.git
- 62. Operaciones en el área de trabajo Incorporar nueva rama del repositorio remoto al repositorio local:
- 63. Enviar ramas locales al repositorio remoto: Configurar rama para poder hacer pull desde repositorio remoto: $ git push moodle.git mdl21-nested-groups $ git push moodle.git +mdl21-nested-groups $ git push moodle.git mdl21-nested-groups:mdl21-nestgrp $ git config branch.mdl21-nested-groups.remote \ moodle.git $ git config branch.mdl21-nested-groups.merge \ refs/heads/mdl21-nested-groups $ git fetch moodle.git $ git branch mdl21-enrol-database-refactor \ moodle.git/mdl21-enrol-database-refactor
- 64. Terminología de git (cont.) rebase: re-aplicar una serie de cambios desde una rama en la cabeza de otra rama diferente, y hacer que la cabeza de esa otra rama apunte al resultado. ¡OJO! Rescribe el historial de la rama.
- 65. Puede ser problemático en ramas publicadas en repositorios remotos.
- 66. rebase: “limpieza” del historial Estado “inicial” merge tradicional de “master” y “experiment” rebase de “experiment” sobre “master” merge de “master” y “experiment” tras el rebase 1 2 3 4
- 67. Limpieza del historial IMPORTANTE: No hace rebase de los cambios de una rama si ésta ha sido publicada en otro repositorio.
- 68. Limpieza del historial Sólo se puede aplicar a la rama activa:
- 69. Si hay conflictos, solucionar a mano, y decirle a git qué hemos arreglado:
- 70. Podemos abortar en todo momento: $ git checkout wip-mdl21-enrol-db-refactor $ git rebase MOODLE_21_STABLE $ editar enrol/database/config.html $ git add enrol/database/config.html enrol/database/enrol.php $ editar xxxx $ git add xxxxx $ git rebase --continue $ git rebase --abort
- 71. Creación de parches y series Creación de parches monolíticos:
- 72. Creación de series de parches: $ git checkout mdl21-enrol-db-refactor $ git diff MOODLE_21_STABLE > mdl21-enrol-db-refactor.diff $ git checkout mdl21-enrol-database-refactor $ git format-patch -o serie-enrol-db MOODLE_21_STABLE $ git format-patch -o -s -10 mdl21-enrol-db
- 73. Ejemplo de modelo de trabajo Para mantener modificaciones locales de Moodle en Mondragon Unibertsitatea
- 74. Premisas del modelo de trabajo Repositorio 'compartido' de referencia
- 75. Premisas del modelo de trabajo Aprovechar el repositorio de git.moodle.org No usar 'git clone' para la importación desde git.moodle.org
- 76. Premisas del modelo de trabajo Repositorio compartido sólo con ramas locales
- 77. Premisas del modelo de trabajo Desarrollo siempre en las ramas locales
- 78. Premisas del modelo de trabajo Ramas estándar sólo en repositorios de los desarrolladores
- 79. git.moodle.org repositorio compartido @mondragon.edu copia de trabajo + repositorio desarrollador git-remote + git-push git-fetch git-push git-pull git-fetch git-push git-pull git-remote + git-fetch git-fetch / git-pull git-clone git-clone git-remote + git-fetch git-fetch / git-pull git-fetch git-push git-pull
- 80. Creación repositorio compartido $ git config --global user.name 'Desarrollador-1' $ git config --global user.email 'desa-1@mondragon.edu' $ cd /ruta/repositorio/desarrollador $ mkdir desarrollador-1.git $ cd desarrollador-1.git $ git init Crear repositorio primer desarrollador
- 81. Creación repositorio compartido Importar repositorio de moodle.org $ git remote add -t master -t MOODLE_21_STABLE \ -m master moodle-org \ git://git.moodle.org/moodle.git $ git fetch moodle-org
- 82. Creación repositorio compartido Ramas locales de seguimiento (opcional) $ git branch --track master moodle-org/master $ git branch --track MOODLE_21_STABLE \ moodle-org/MOODLE_21_STABLE
- 83. Creación repositorio compartido Crear ramas locales de trabajo $ git branch mdl21-ldap-refactor moodle-org/MOODLE_21_STABLE
- 84. Creación repositorio compartido Crear repositorio compartido $ cd /ruta/repositorio/compartido $ mkdir compartido.git $ cd compartido.git $ git --bare init --shared=all $ chmod g=rwxs,o=rx . $ sudo chgrp -R git-moodle .
- 85. Creación repositorio compartido Enviar rama local al repositorio compartido $ cd /ruta/repositorio/desarrollador/desarrollador-1.git $ git remote add compartido \ /ruta/repositorio/compartido/compartido.git $ git push compartido mdl21-ldap-refactor
- 86. Creación repositorio compartido Configurar rama local para hacer pull desde repositorio compartido $ git config branch.mdl21-ldap-refactor.remote \ compartido $ git config branch.mdl21-ldap-refactor.merge \ refs/heads/mdl21-ldap-refactor
- 87. Creación repo nuevo desarrollador Clonar repositorio compartido $ git config --global user.name 'Desarrollador-2' $ git config --global user.email 'desa-2@mondragon.edu' $ cd /ruta/repositorio/desarrollador $ git clone -o compartido \ /ruta/repositorio/compartido/compartido.git \ desarrollador-2.git
- 88. Creación repo nuevo desarrollador Importar ramas estándar (opcional) $ cd desarollador-2.git $ git remote add -t master -t MOODLE_21_STABLE \ -m master moodle-org \ git://git.moodle.org/moodle.git $ git fetch moodle-org
- 89. Creación repo nuevo desarrollador Crear ramas locales de trabajo $ git branch mdl21-ldap-refactor \ compartido/mdl21-ldap-refactor $ git checkout mdl21-ldap-refactor
- 90. Algunos trucos bajo la manga (bonus track ☺) git add --interactive
- 91. git cherry-pick
- 92. git stash [save | list | show | apply | remove | clear]
- 93. git bisect
- 94. git blame
- 95. git gc, git prune, git fsck
- 96. .git/hooks/*
- 97. Algunas direcciones de interés git Cheat Sheets: http://devcheatsheet.com/tag/git/ github/GITORIOUS: http://github.com/
- 99. http://thinkshout.com/blog/2011/03/lev/redmine-and-gitosis-project-management-nirvana Gerrit: https://code.google.com/p/gerrit/ Jenkins: http://jenkins-ci.org/