github-actions

Repositorio de composite actions reutilizables (action.yaml) para los workflows de GitHub de Billin. Cada carpeta del raíz es una action distinta; en los demás repos se referencian así:

- uses: BillinTeam/github-actions/<nombre-de-la-carpeta>@v2.29
  with:
    # inputs de esa action

Versionado

Todas las actions comparten el mismo número de versión. No hay tags por carpeta: un tag v2.N apunta a un commit de main y fija la snapshot de todas las actions de ese momento.

Concepto	Detalle
Tag en remoto	v2.29 (Helm 4.0.4, helmfile v1.8.3, sops en /usr/local/bin, chartmuseum v0.11.1, jkroepke/helm-secrets 4.7.10)
Próximo tag previsto	v2.30 — (reservado para el siguiente cambio del monorepo)
Referencia en YAML	Siempre el prefijo v + semver menor de equipo: @v2.26, no @2.25 ni @main en producción
Helm CLI (deploy/push)	4.0.4 dentro de delivery-k8s y helm-push; los repos consumidores deben alinear su setup-helm si lo ejecutan antes de llamar a la action

Al subir versión en un repo consumidor (p. ej. tortilla), conviene alinear todas las referencias a BillinTeam/github-actions/* del mismo tag salvo que haya una razón documentada para quedarse en uno antiguo.

Acciones disponibles

Carpeta	Para qué sirve	Inputs / outputs destacados
setup-node	Checkout, Node (20.x por defecto) y caché de node_modules vía package-lock.json.	Input: node-version. Output: dependencies-cache-hit.
pr-title-validator	Comprueba que el título del PR sigue Conventional Commits; comenta en el PR y falla el job si no cumple.	Input: repo-token.
gcp-auth	Auth en GCP (google-github-actions/auth + setup-gcloud); opcionalmente credenciales del cluster GKE.	Inputs: gcpProjectId, gcpServiceAccountKey, getGkeCredentials, gcpZone.
feat-branch-name	Deriva namespace y nombre corto de rama feat/hotfix para deploys efímeros (regex de REGEX_* en el workflow).	Input: appPrefix, deployFromPR. Outputs: namespace, branch_short.
docker-push	Build y push de imagen Docker a Artifact Registry (europe-west1-docker.pkg.dev); expone digest SHA256.	Inputs: dockerfilePath, dockerImageUrl, dockerImageTag, GCP creds. Output: docker_image_sha.
helm-push	Helm 4.0.4; plugin chartmuseum v0.11.1 (helm cm-push en Helm 4). Empaqueta chart y sube a Chart Museum.	Inputs: rutas de chart, versión, Chart Museum, tag/digest de imagen.
delivery-k8s	Helm 4.0.4; helmfile v1.8.3 (Helm 4) + jkroepke/helm-secrets 4.7.x (3 plugins). sops en /usr/local/bin; HELM_SECRETS_HELM_PATH, HELMFILE_RENDER_YAML=true antes de sync.	Inputs: helmfileVersion (default v1.8.3), helmSecretsVersion (default 4.7.10), etc.
destroy-environment	Borra el namespace de Kubernetes de una rama feat/hotfix al eliminar la rama (destroy workflow).	Inputs: namespacePrefix, gkeClusterName, gcpClusterZone. Output: branch_short.

Ejemplos de uso (tortilla, referencia)

Action	Versión usada en tortilla (ejemplo)	Dónde
setup-node	@v2.14	install-dependencies, lint, test, build-app, helm-push workflow
gcp-auth	@v2.22	helm-deploy, e2e, destroy-feature
feat-branch-name	@v2.29	helm-deploy
delivery-k8s	@v2.29	helm-deploy
destroy-environment	@v2.29	destroy-feature
helm-push	@v2.29	composite helm-push (tortilla: setup-helm 4.0.4)
pr-title-validator	@v2.16	workflow pr-title

Los consumidores deben usar el mismo tag v2.N en todas las referencias y la misma versión de Helm 4.0.4 si ejecutan setup-helm antes de la action compartida.

Publicar una nueva versión (tag usable en otros repos)

1. Cambios en main

   • Modificar las actions necesarias.
   • Añadir al inicio de este README una sección ## TAG 2.N con una línea que resuma el cambio (como las versiones anteriores).

2. Merge

   • El tag debe crearse sobre el commit que ya está en origin/main (normalmente el merge del PR).

3. Crear y subir el tag (desde clone actualizado):

   cd /path/to/github-actions
   git fetch origin
   git checkout main
   git pull origin main
   
   # Revisar que el commit es el correcto
   git log -1 --oneline
   
   # Tag ligero (mismo estilo que v2.23 y anteriores)
   git tag v2.24
   
   # Opcional: tag anotado (mensaje visible con git show)
   # git tag -a v2.24 -m "Helm 4: --verify=false on helm plugin install"
   
   git push origin main
   git push origin v2.24

4. Comprobar en GitHub

   • En Releases / Tags debe aparecer v2.24.
   • Probar en un workflow: uses: BillinTeam/github-actions/delivery-k8s@v2.29.

5. Repos consumidores

   • PR que sustituya la referencia anterior por el nuevo tag v2.N donde corresponda.
   • No hace falta publicar cada carpeta por separado: un solo tag actualiza todas las actions.

Notas

• No reescribir tags ya usados en producción (git tag -f / force-push de tags): los workflows cachean por referencia; un tag movido rompe reproducibilidad.
• Si solo cambia una action pero el equipo versiona el monorepo junto, igualmente se incrementa v2.N global.
• Para probar un cambio antes del tag, los repos pueden apuntar temporalmente a un SHA (@<commit-full-sha>), solo en ramas de prueba; en main de producto usar siempre tag v2.N.

Historial de versiones

Cambios anotados en este README. Tags v2.15–v2.17 existen en el remoto sin entrada aquí (ver git log entre tags si hace falta detalle).

TAG 2.29

delivery-k8s: instalar sops en /usr/local/bin para que jkroepke/helm-secrets lo encuentre al desencriptar (antes solo existía ./sops en el workspace).

TAG 2.28

delivery-k8s: helmfile v1.8.3 (sustituye roboll/helmfile v0.132; compatible con Helm 4); tarball helmfile_*_linux_amd64.tar.gz; HELMFILE_RENDER_YAML=true para helmfile.yaml con plantillas Go.

TAG 2.27

delivery-k8s: sustituir zendesk/helm-secrets por jkroepke/helm-secrets 4.7.10 (tres .tgz); exportar HELM_SECRETS_HELM_PATH antes de helmfile sync.

TAG 2.26

helm-push: subir plugin chartmuseum de v0.10.4 a v0.11.1 (soporte Helm 4 para helm cm-push).

TAG 2.25

Fijar Helm 4.0.4 (azure/setup-helm@v4.2.0) al inicio de delivery-k8s y helm-push para no depender del runner ni chocar con Helm 3 en consumidores.

TAG 2.24

Helm 4: añadir --verify=false al instalar plugins desde URLs git (helm-secrets en delivery-k8s, helm-push en chartmuseum).

TAG 2.23

Variables extra de entorno para Helm en delivery-k8s y refactor de actions.

TAG 2.22

Corrección de formato YAML en gcp-auth.

TAG 2.21

gcpZone deja de ser obligatorio en gcp-auth.

TAG 2.20

Nueva action gcp-auth.

TAG 2.19

Login a Google Artifact Registry en docker-push.

TAG 2.18

helm-push: uso de helm cm-push (Chart Museum).

TAG 2.14

setup-node: Node 20.x.

TAG 2.8

setup-node: Node 16.x.

TAG 2.7

setup-node: Node 14.x.