Grados es una herramienta de automatización de compilación flexible para lenguajes como Java, C++ y Groovy. Toma archivos fuente sin procesar y los compila en una aplicación ejecutable.

Acciones de GitHub habilite muchas acciones dentro de la plataforma GitHub Continuous Integration and Continuous Delivery (CI/CD), que se pueden ejecutar al crear solicitudes de incorporación de cambios o fusiones de código. Estas acciones pueden automatizar tareas comunes, como ejecutar pruebas y marcar versiones de código.
Además, la integración de canalización de Gradle le permite ejecutar comandos de Gradle como acciones. Puede encontrar muchas acciones disponibles en el sitio Mercado GitHub. Sin embargo, este artículo se centra principalmente en cómo crear su propia acción para ejecutar una compilación Gradle de una aplicación Java.
Cómo usar Gradle como una acción
Hay muchos tipos de actividades. Por ejemplo, las acciones de Docker usan Docker para crear el entorno en el que se ejecuta la acción. Mientras tanto, las acciones de JavaScript se ejecutan de forma nativa en una instancia de GitHub, mientras que las acciones compuestas combinan varias acciones en una sola. Este tutorial se centrará en las acciones de Docker.
Creación de una acción de Docker
Usar Docker es más flexible que implementar acciones solo en JavaScript porque tiene más control sobre el entorno y, por lo tanto, qué aplicaciones y bibliotecas puede usar.
Para crear una acción de Docker, comience creando una nueva carpeta que contendrá tres archivos:
- archivo acoplable
- archivo de configuración YAML
- Archivo de secuencia de comandos de acción
Comencemos con el archivo de script de acción. Cree un nuevo archivo llamado gradle_build.sh y agregue el siguiente código:
Este es un script de shell simple que ejecuta el comando de compilación gradle. Si el comando de compilación tiene éxito, la secuencia de comandos obtendrá el nombre del archivo .jar que se está creando y mostrará su ubicación. Si el comando falla, el script sale.
$1 es la variable de entrada que configurará en el siguiente paso. Además, el nombre y el valor de la propiedad en la cadena de salida se declararán más tarde en el archivo de configuración.
Ahora cree un archivo con el siguiente contenido y asígnele el nombre Dockerfile. Luego inserte el siguiente contenido.
Este Dockerfile describe cómo crear un entorno para ejecutar acciones. La primera línea le dice a Docker que use la última imagen de Gradle preexistente de Docker Hub. Con esto, tienes todo lo que necesitas para ejecutar Gradle. El siguiente comando copia el script gradle_build.sh del paso anterior al contenedor de Docker. Finalmente, el código le dice a Docker que ejecute este script al inicio.
Ahora necesita crear un archivo de configuración que defina las entradas y salidas y cómo funcionan. Nombre este archivo action.yml y agregue el siguiente contenido.
Este archivo de configuración pasa un parámetro de entrada denominado opción al script y genera una propiedad denominada ubicación de jar.
Puedes usar varios Opciones de gradación al ejecutar acciones, incluso encadenando múltiples acciones juntas. Esto se debe a que la entrada de la opción es solo una cadena que se pasa directamente después del comando de compilación de gradle.
Por ejemplo, puede establecer un parámetro de opción en el siguiente valor:
En respuesta, su acción ejecutaría el siguiente comando:
El último paso es enviar y etiquetar el código en GitHub para usarlo como una acción en otros repositorios.
Primero, cree un repositorio público de GitHub para alojar la acción denominada gradle-github-action. Luego envíe los cambios a la rama principal y etiquete los cambios con v1.
Esto creará una etiqueta v1 para el repositorio a la que se puede hacer referencia al invocar una acción. Cada vez que actualice su actividad en el futuro, puede publicar una nueva versión con una nueva etiqueta para que los cambios no afecten a los proyectos que utilizan versiones anteriores.
Usar acciones de Gradle
Ahora está utilizando esta acción de Gradle en su proyecto Java para compilar y probar su código. Primero, descargar proyecto java de muestra y abra el archivo de flujo de trabajo de GitHub vacío en .github/workklows/main.yml.
Luego agregue lo siguiente al archivo main.yml:
Esta configuración le dice al flujo de trabajo que ejecute solicitudes push y pull.
El flujo de trabajo que ejecuta gradle_build_job consta de varios pasos. El primer paso utiliza la acción de desproteger para buscar cambios en el servidor. Luego ejecuta la acción de compilación de gradle creada en la sección anterior.
También puede usar un parámetro de opciones para pasar opciones de compilación al ejecutar una acción. Para llamar a una acción que necesita anular
El último paso solo funciona para las solicitudes de incorporación de cambios para cargar un archivo .jar mediante la acción de carga de artefactos proporcionada por GitHub. Para usarlo, debe proporcionar el nombre del artefacto y la ruta del archivo de la salida de gradle-github-action. La acción de carga del artefacto luego carga ese artefacto en GitHub.
Guarde el archivo, luego inicialice el proyecto de muestra como un repositorio de GitHub. Echa un vistazo a la nueva rama donde puedes confirmar y hacer cambios. Una vez que se inserta el código, abra el repositorio de GitHub y observe el resultado del flujo de trabajo en comportamiento Correa.

El resultado debe mostrar los pasos realizados, incluida la verificación del código y el paso Gradle Build. El paso del artefacto de carga aparece como omitido porque aún no se ha creado la solicitud de extracción.
Ahora haga una solicitud de extracción para esa rama y vea el resumen de la ejecución de su flujo de trabajo.

En el resumen, debería ver que el flujo de trabajo está completo y que el archivo .jar aparece bajo el nombre archivo jar (como se especifica en el archivo de configuración del flujo de trabajo). Este archivo ahora está disponible para otros miembros del equipo sin necesidad de descargar y compilar el código.
Al crear su propia acción, tiene control total sobre su funcionalidad y puede adaptarla a sus necesidades específicas. Esto puede ser especialmente útil si tiene requisitos únicos o flujos de trabajo que no están cubiertos por las acciones existentes.
Además, una vez que se desarrolla una acción, se puede reutilizar en varios proyectos. Además, si hace que su recurso compartido sea de código abierto, otros desarrolladores pueden usarlo en sus proyectos e incluso contribuir a su desarrollo. Esto puede crear una comunidad en torno a su acción y aprovechar el conocimiento de los demás.
La propia acción de compilación de GitHub de Gradle
Los ejemplos anteriores mostraron cómo crear acciones. Sin embargo, muchas acciones de GitHub están disponibles en GitHub Marketplace.
Al igual que la acción que acaba de crear, Gradle desarrolló la acción gradle-build para ejecutar compilaciones de Gradle como parte de un flujo de trabajo de GitHub.
Para agregar esta acción lista para usar a su flujo de trabajo, use el siguiente código:
Gradle-build-action es una herramienta valiosa para automatizar compilaciones de Gradle dentro de su flujo de trabajo de GitHub, lo que le permite compilar, probar y publicar proyectos de Gradle. Dado que el equipo de Gradle desarrolla y mantiene esta herramienta, proporciona mucha más flexibilidad que las acciones creadas manualmente.
Uso de recursos compartidos de GitHub para Gradle
En esta publicación, creaste una acción manual de GitHub que ejecuta el comando de compilación de gradle. Usando Docker, configuramos el entorno y configuramos la entrada y salida para la acción antes de usar la acción de GitHub en el proyecto de muestra. Finalmente, comparaste nuestra acción personalizada con la acción oficial de compilación de gradle.
La creación manual de recursos compartidos de GitHub ofrece varias ventajas en comparación con los recursos compartidos listos para usar. Al crear acciones manualmente, tiene control total sobre el comportamiento y la funcionalidad de las acciones, lo que le permite personalizarlas según sus necesidades específicas. Además, la creación manual de actividades puede conducir a flujos de trabajo más eficientes y optimizados, ya que los usuarios pueden diseñar sus actividades para que funcionen sin problemas con su base de código y procesos existentes.
Sin embargo, para las actividades diarias, como crear y probar proyectos de Gradle, el uso de gradle-build-action ya disponible en GitHub Marketplace proporciona un proceso simplificado para integrar Gradle con canalizaciones de GitHub.









