Looking for an English version?

Documentación de SAS G-CLI Tools

Primeros pasos

Acerca de

A menudo recibo preguntas sobre cómo empezar con Integración Continua (CI) y Entrega Continua (CD) en LabVIEW. Muchos desarrolladores reconocen su valor, pero no saben por dónde comenzar. El primer paso suele ser poder usar la CLI para automatizar diversas tareas de desarrollo. Eso es exactamente para lo que sirven estas herramientas. SAS G-CLI Tools es un conjunto de herramientas de código abierto G-CLI para tareas comunes en LabVIEW. Cada herramienta se proporciona en su propio paquete VIPM, por lo que puedes instalar únicamente las que necesites. Cada herramienta G-CLI también es open source y está alojada en su propio repositorio de GitLab, por lo que puedes hacer un fork y modificarlas todo lo que necesites para adaptarlas a tu flujo de trabajo específico. Estas herramientas son útiles para automatizar el proceso de pruebas y compilación en LabVIEW. Con ellas, puedes escribir un script sencillo en Bash que ejecute tus pruebas unitarias y, si todas pasan, compile tu ejecutable y lo empaquete. Esto te ayuda a crear un proceso robusto y repetible. Estas herramientas esenciales son los bloques fundamentales de un pipeline CI/CD.

¿Por qué?

CI/CD es la mejor inversión que puedes hacer en la gestión de riesgos para tu proyecto. Previene las dos principales fuentes de defectos en el software: construir mal el “OBJETO” correcto o construir el “OBJETO INCORRECTO”. Ejecutar pruebas unitarias regularmente mediante CI ayuda a garantizar que el software funcione como se espera y que estés construyendo el OBJETO correcto. Entregar software de manera continua a los usuarios mediante CD asegura que puedas recibir retroalimentación rápida de los usuarios, garantizando que todos estén alineados y construyendo el OBJETO CORRECTO.

Configurar CI/CD puede resultar abrumador. Hay muchos elementos en movimiento y, además, no existe mucha documentación clara y accesible. Este proyecto busca cambiar eso.

¿Nuevo en CI?

Comenzar con CI puede resultar abrumador. Si eres completamente nuevo en este tema, aquí te recomiendo cómo empezar.

  1. Consulta nuestros videos introductorios. Te ofrecerán una buena visión general de lo que es posible y de lo que implica.
  2. Mapea tu proceso actual. Piensa en lo que ocurre después de realizar un cambio en tu software. ¿Qué pasos sigues para verificar que el cambio funciona y que no se rompió nada? Luego, ¿cómo construyes tu aplicación y la distribuyes? Escribe todo el proceso.
  3. Revisa la lista de herramientas G-CLI aquí y conecta los pasos de tu proceso con las herramientas G-CLI. Escribe un script en Bash que ejecute cada paso en orden. El objetivo es tener un único script que los desarrolladores puedan ejecutar localmente para correr las pruebas, compilar el programa y generar el instalador.
  4. Una vez tengas ese script, dirígete a la sección Configurando un GitLab Runner. Ahí se te guiará para configurar un GitLab Runner y hacer que ejecute tu script.
  5. También revisa uno de nuestros Proyectos de Ejemplo. Te proporcionará inspiración y/o un buen punto de partida.
  6. Recoge retroalimentación y mejora. Una vez que tengas un pipeline en funcionamiento, será fácil ajustar pasos existentes y añadir nuevos.

En algún momento después del paso 3, vale la pena revisar los proyectos de ejemplo. Pueden hacer exactamente lo que necesitas. Al menos te mostrarán lo que es posible y te indicarán la dirección correcta para unir todas las piezas.

¿Ya estás usando alguna forma de CI?

Visita nuestros proyectos de ejemplo para ver estas herramientas en acción. Todos los ejemplos son repositorios de GitLab que puedes bifurcar y experimentar. También querrás revisar la sección de Configuración de Runners Dinámicos.

Videos Introductorios

Estas herramientas G-CLI representan uno de los primeros pasos para configurar un pipeline de CI/CD.
Aquí encontrarás algunos videos introductorios sobre GitLab CI y CI/CD en general.
Ninguno de ellos trata específicamente sobre SAS-GCLI-Tools, pero proporcionan información de contexto valiosa y necesaria.
Estos enlaces están aquí para ayudarte a poner en marcha el resto de la configuración del pipeline CI/CD.

Otras opciones alternativas que vale la pena explorar:

  • Explorando BLT - Demostración de BLT, una forma alternativa de realizar muchas tareas de CI.
  • Comenzando con GitHub Actions - Presentación práctica que te guía para configurar un agente de GitHub (similar a un GitLab Runner).
  • Niko Naredi sobre Azure DevOps - Esta presentación de Niko es básicamente lo que describo aquí para GitLab, pero aplicada a Azure DevOps.

Instalación

Cada una de estas herramientas G-CLI está disponible en VIPM.
Esta es la forma más fácil de instalarlas.

Aquí están los enlaces para descargar los últimos paquetes desde VIPM:

Licencia

Todas las herramientas están licenciadas bajo la licencia MIT.
Se incluye un archivo de licencia en cada paquete de instalación VIPM.

Verificación de G-CLI

Debes asegurarte de que G-CLI esté incluido en tu PATH.
Las instrucciones para esto varían según la shell que estés usando.

Para probar que G-CLI funciona, simplemente puedes hacer lo siguiente:

g-cli echo -- "hello world"

Versiones Soportadas

  • LabVIEW – Estas herramientas están empaquetadas con VIPM usando LabVIEW 2020, por lo que deberían funcionar con cualquier arquitectura y versión de LabVIEW 2020 o posterior.
  • Sistema Operativo – Actualmente estas herramientas son solo para Windows, aunque la última versión de G-CLI aparentemente también funciona en Linux, por lo que podría ser posible. Si lo pruebas y funciona, házmelo saber. Yo sigo usando Windows 10, pero no hay razón para que no funcionen en Windows 11.
  • G-CLI – Versión 2.4.0.4 o posterior.