docs/_posts/socialserv/2023-02-22-GitES.md

---
title: Taller de Git & GitFlow
author: Decentralized Climate Foundation
date: 2023-02-22
category: socialservice
layout: post
---


El proposito del siguiente documento es aprender mientras se utiliza git y gitflow, en especial para trabajos colaborativos.

## Proceso

### Los siguientes pasos serian:

1. Crear cuenta en [git DCF](https://git.decentralizedclimate.org/DecentralizedClimateFoundation/docs){:target="_blank"}.
Para crear la cuenta se necesita un correo electrónico y un nombre de usuario, despues presionas en la esquina superior derecha el <**Registro**> e ingresas tu correo de registro, nombre de usuario <**Nombre**> y contraseña **<Contraseña>**.
De esta forma tendras tu propia cuenta dentro de la plataforma git de DCF y clonar los repositorios de la Fundacion para contribuir.


2. Crear un Issue en [git DCF](https://git.decentralizedclimate.org/DecentralizedClimateFoundation/docs){:target="_blank"} con un titulo breve sobre el tema  <**Titulo brevemente**> , nombre del estudiante. <**Nombre del Estudiante**>  y una descripción <**Descripción**> mas detallada sobre el caso o mejora que se desea realizar.

3. Hacer un Fork del repositorio [docs](https://git.decentralizedclimate.org/DecentralizedClimateFoundation/docs){:target="_blank"} del git de DCF, el cual podemos realizar al clickear el boton en la parte superior derecha donde dice Fork, ahi podemos cambiarle el titulo (Se recomienda mantenerlo y solo aceptar el fork a nuestro repositorio).

4. Se debe tener un acceso a la  VPN y solicitar un certiicado, Contacte al [Sysadmin](mailto:david@decentralizedclimate.org) se sugiere el uso de [OpenVPN Connect](https://openvpn.net/client/client-connect-vpn-for-windows/){:target="_blank"}, para el uso del certificado  que se envie, tambien se sugiere el uso de [MobaXterm](https://mobaxterm.mobatek.net/){:target="_blank"} si eres usuario de Windous y si eres usuario de Linux o Mac os ya tienes por defecto un cliente ssh.

5. Una ves obtenido su certificado (certificado.ovpn) importarlo en la OpenVPN y encenderla. 

6. En su  MobaXterm o terminal preferida  se siguen los siguientes comandos:

    ```shell
    $ ssh <nombreUsuario>@10.162.235.52 #Nos conectamos ala maquina con IP "10.162.235.52" con el usuario que se nos fue asignado y ingresar la password que le fue dada.

    $  su [team numero] #Aqui se usara el team al que seas unido ejemplo si eres del team 2 de**
    ```

    >**Si estas dentro de tmux para salir utiliza Ctrl+b despues apretar d para no cerrar la sesion de todo.**


7. Una ves en su team clonar el siguiente repositorio:

    ```shell
    $ git clone https://git.decentralizedclimate.org/DecentralizedClimateFoundation/docs
    ```


8. Entramos al proyecto clonado previamente  en la maquina y ingresamos en la siguiente ruta: docs/

    ```shell
    $ cd docs/
    ```
9. Inicializamos git flow con el siguiente comando, y dejamos todo por dafault: 

    ```shell
    $ git flow init

        Which branch should be used for bringing forth production releases?
           - master
        Branch name for production releases: [master]
        Branch name for "next release" development: [develop]

        How to name your supporting branch prefixes?
        Feature branches? [feature/]
        Bugfix branches? [bugfix/]
        Release branches? [release/]
        Hotfix branches? [hotfix/]
        Support branches? [support/]
        Version tag prefix? []
        Hooks and filters directory? [/home/team2/docs/docs2/.git/hooks]
    
     ```
10. Checamos la rama en la que estamos que tiene que ser 'develop':

    
    ```shell

    $ git checkout
        Your branch is up to date with 'origin/develop'.

     ```

11. Sigue el [Readme](https://git.decentralizedclimate.org/DecentralizedClimateFoundation/docs){:target='_blank'} para instalar y visualizar jekyll mientras continuas el taller.


12. Abrimos el Feature con el siguiente comando:

    ```sh

    $ git flow feature start <MyFeature> #MyFeature se cambia por el nombre que quieras identificarlo

    ```

13. Entramos ala ruta siguiente dentro de 'docs/':


    ```shell
    $ cd _posts/socialserv/
    ```
14. Buscaremos el archivo que editaremos en este caso '2023-02-22-GitES.md' para eso hacemos primero un 'ls' para listar los archivos en la carpeta que estamos y despues usamos vim para editarlo.

    ```shell

    $ ls

    2023-01-27-socialServicesWorkFlowModel.md  
    2023-02-24-Web3StaticES.md         
    2023-03-15-gitflowCheetSheet_ES.md
    2023-02-22-GitES.md                        
    2023-03-15-gitflowCheetSheet_EN.md

    $ vim  2023-02-22-GitES.md 
    ```


    >Se adjunta un Cheat Sheet de vim para guiarte y editar de forma correcta y eficiente el archivo en vim.


    ```shell
    # Cheat Sheet de Comandos Básicos de Vim

    Modo Normal:
    - `i` - Cambiar al modo de inserción.
    - `x` - Eliminar el carácter actual.
    - `dd` - Eliminar la línea actual.
    - `yy` - Copiar la línea actual.
    - `p` - Pegar el contenido copiado o eliminado después de la línea actual.
    - `u` - Deshacer la última acción.
    - `Ctrl + r` - Rehacer la última acción deshecha.
    - `:w` - Guardar el archivo.
    - `:q` - Salir de Vim.
    - `:q!` - Salir de Vim sin guardar cambios.

    Modo de Inserción:
    - `Esc` - Cambiar al modo normal.

    Modo de Comando:
    - `:set number` - Mostrar números de línea.
    - `:set nonumber` - Ocultar números de línea.
    - `:set tabstop=4` - Establecer el tamaño de la pestaña en 4 espacios.
    - `:set expandtab` - Utilizar espacios en lugar de tabulaciones.
    - `:set autoindent` - Habilitar la indentación automática.
    - `:set syntax=python` - Establecer la sintaxis resaltada para Python (sustituir "python" por el lenguaje correspondiente).
    - `:help <comando>` - Mostrar la ayuda sobre el comando especificado.
    ```

    Puedes agregar, editar o mejorar el documento asi como estudiar el cheetsheet de gitflow y de gitlab.

15. Una ves echo los cambios en el documento y guardarlos, salimos de vim escribiendo  ':wq' en modo normal (presionando "esc") , hay que registrarlos en git con el siguiente comando: 
 
    ```shell
    $ git add . # El punto significa que queremos agregar los cambios a todos los archivos
    ```
    > Antes de agregar algo, recuerda estar en la raiz del proyecto git en este caso **docs** 

    Con esto agregamos el archivo o archivos modificados al area de preparacion.

    Despues debemos crear el commit con los cambios agregados.

16. Después de ejecuta ,`git add` puedes crear un commit utilizando el comando `git commit -m <Mensaje del commit>`. Al hacerlo, se crea un nuevo commit que contiene los cambios registrados en el área de preparación. El mensaje del cmit proporcionado después del parámetro -m describe los cambios realizados en ecommit :


    ```shell
    $ git commit -m 'Mensaje'
    ```

    > Aclara que se modifico, agrego o mejoro en el commit brevemente pero conciso.
 
17. Una vez echo el commit se finaliza el desarrollo del  feature:
 
    ```shell
    $ git flow finish <myFeature>

    $ git checkout
        Your branch is up to date with 'origin/develop'.
    ```
    > Se utliza `git checkout` para verificar que estamos en la rama develop 

18. Al terminar el Feature debemos hacer el push con referencia.

    ```shell
    $ git pull 
    $ git push  
    ```

    > Por buena practica se recomienda hacer primero un pull y despues nuestro respectivo push.

    Esto nos pedira nuestro usuario y un codigo ssh que nos proporciona el mismo git.
    > El ssh lo puedes generar al entrar a [Configuracion ~ Aplicaciones]  le ingresamos un nombre y generamos el codigo que sustituira a la contraseña.

    Verifica que si se hizo el git push en tu repositorio forkeado en la pagina de git debes ingresar a tu repositorio y ver que el push fue agregado de forma correcta.



19. Puedes comprobar que tu commit esta ya en la rama develop cuando hagas uso del comando:


    ```shell
    $ git log
    ```

    > El cual nos da un historial de los commits del proyecto con los datos de quien lo hizo a que hora y la fecha.

20. Hacer el Pull Request en el git de Decentralized Climate de la rama develop personal a la rama develop del Repositorio de DCF.

21. ***Exito*** concluiste tu Taller de Git y GitFlow. :) 

## CONTACTO Y DESARROLLADORES
> Work developed in collaboration with the [Decentralized Climate Foundation](https://decentralizedclimate.org){:target="_blank"}.

- [David E. Perez Negron R.](mailto:david@neetsec.com) @p1r0

- [Gustavo Bermudez](mailto:nizaries44@gmail.com)

- [Sebastian Zarraga](https://github.com/SebastianZR)

## Referencias

1. Cheatsheet de git flow: [https://danielkummer.github.io/git-flow-cheatsheet/](https://danielkummer.github.io/git-flow-cheatsheet){:target="_blank"}, 2023-07-17.

2. Video Sobre gitflow: [https://www.youtube.com/watch?v=BYrt6luynCI](https://www.youtube.com/watch?v=BYrt6luynCI){:target="_blank"}, 2023-07-17.

3. Link Hackmd a Git: [https://hackmd.io/c/tutorials/%2Fs%2Flink-with-github](https://hackmd.io/c/tutorials/%2Fs%2Flink-with-github){:target="_blank"}, 2023-07-17.

4. Adam P., "Mardown Cheatsheet", [https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet]( https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet){:target="_blank"}, 2023-07-17.

5. Cheatsheet de vim: [https://devhints.io/vim](https://devhints.io/vim){:target="_blank"}, 2023-07-17.

6. Cheatsheet [Git & GitFlow ES]({% post_url socialserv/2023-03-15-gitflowCheetSheet_ES %}){:target="_blank"}, 2023-07-17.