Dominando el control de versiones: Guía práctica de Git y GitHub para desarrolladores

La vida de un programador es bastante dura como para complicársela más. ¿Por qué no facilitarla y externalizar el control de versiones de sus proyectos a servicios dedicados? La mayoría de los programadores del mundo IT están familiarizados con Git, pero para algunos de los programadores OT en esta comunidad, esto es un concepto totalmente nuevo. Cuando se trabaja con diferentes colegas en el mismo proyecto, compartir código se vuelve aún más complicado; un servicio como GitHub facilita compartir y trabajar juntos en el mismo código. Este blog le guiará a través de sus primeros pasos usando Git y GitHub para mantener su código y proyectos en orden.

---

En este blog usaré GitHub y el cliente de GitHub para Windows, pero tenga en cuenta que hay más opciones incluyendo GitLab. ¡Solo me gusta la facilidad de uso del Cliente GitHub!

---

Configuración de un repositorio en GitHub

Paso 1 - Descargar e instalar el Cliente GitHub para Windows

En realidad, el primer paso sería crear una cuenta de GitHub, pero eso está algo fuera del alcance de este blog.

1. El Cliente se puede descargar desde aquí.
2. Siga la Guía de Instalación
3. Inicie sesión en su cuenta de GitHub

Paso 2 - Crear una carpeta o repositorio para su proyecto

Un repositorio es un lugar para que su proyecto viva. ¡Haga una carpeta para cada proyecto! Cada vez que algo cambie en esta carpeta, el cliente de GitHub lo detectará y podrá guardar o enviar sus cambios al repositorio en línea en GitHub.

1. Haga clic en "Crear un nuevo repositorio en su disco duro..."
2. Dé a su nuevo repositorio un nombre y descripción.
3. Puede cambiar la ruta del repositorio si lo desea, o dejarla como está (la forma perezosa)
4. Haga clic en "Inicializar este repositorio con un README" (¡Perezoso no significa no seguir buenas prácticas y documentar su código!)
5. Cree el repositorio

Paso 3 - Crear un proyecto PLCnext

Git funciona genial con archivos basados en texto. Por suerte, en PLCnext Engineer hay una opción para guardar su proyecto como un montón de archivos de texto, perfecto para Git y por tanto para nuestro cliente de GitHub.

1. Abra PLCnext Engineer y comience a crear un proyecto como de costumbre.
2. Cuando esté listo para guardar su proyecto, elija Guardar Proyecto Como (F12)
3. Navegue a su repositorio de GitHub (por defecto: Este PC/documentos/GitHub)
4. Guarde su proyecto como "Proyecto sin comprimir"

Paso 4 - Confirmar sus cambios (Commit)

Para "guardar" cambios en su repositorio, necesita confirmarlos (commit) en una rama (branch). Qué es exactamente una rama lo explicaré más tarde, por ahora solo tiene que recordar que necesita confirmar sus cambios en una rama para guardarlos.

Dé a su commit un título nuevo y una breve descripción para que pueda recordar qué cambió exactamente.

Paso 5 - Publicar o enviar (Push) su repositorio

El paso final para crear un repositorio en línea es enviar (push) nuestro repositorio local a GitHub. Esto es tan fácil como presionar un botón o presionar (ctrl + p). Elija si su código debe ser privado y si pertenece a usted o a una organización.

Paso 6 - ¡Documentar!

Presione (Ctrl + shift + G) para ver el repositorio en línea en GitHub en su navegador. ¡Voilá! Ahí está su proyecto PLCnext en GitHub. ¿Recuerda el "Inicializar README"? Ese es el texto que está viendo ahora frente a usted. En el README.md debería explicar la estructura del proyecto, el propósito y tal vez alguna información de contacto para futura referencia.

Por ahora haga algunos cambios en el archivo README.md haciendo clic en el lápiz. El archivo está "Escrito" en MarkDown, más información sobre MarkDown se puede encontrar aquí.

Si ha hecho algunos cambios, nuevamente haga commit a la rama master.

Paso 7 - Traer (Pull) cambios a su repositorio local

El Cliente de Windows detectará que se hicieron algunos cambios en el Repositorio en GitHub. ¡No olvide traer (pull) los cambios para empezar a trabajar en la versión más reciente de nuevo!

---

Consejos y trucos

Rastreador de Issues (Issue Tracker)

GitHub tiene un maravilloso rastreador de issues, úselo para rastrear problemas conocidos en su software y discutir soluciones con las otras partes interesadas.

Proyectos

Use el Tablero de Proyectos integrado para rastrear sus tareas con un tablero kanban. Si quiere, puede automatizar su kanban con disparadores integrados para facilitar aún más la vida.

Ramas (Branches)

Ah, aquí estamos. Vea, dije que iba a explicar qué son las ramas. Bueno, dejaré que GitHub explique qué son las ramas...

¿Va a hacer muchos cambios o implementar una nueva característica? Cree una rama para mantener sus cambios aislados y fusione (merge) su "rama de característica" en su rama master con una pull request.

Lanzamientos (Release)

¿Listo para desplegar un proyecto? Cree un release para añadir a su AS Build.