Publicar desde CI/CD
Publica una nueva versión de tu extensión cada vez que subes una etiqueta de versión como v1.2.3, desde GitHub Actions, GitLab CI o cualquier otro sistema de CI, con un token de publicación guardado como el secreto INGOT_PUBLISH_TOKEN.
@ingotide/cli@0.1.0. Si durante la Beta el paquete aún no está en npm, publica desde tu equipo por ahora (ver la guía para creadores) y deja el flujo para más adelante.Cómo funciona: subes la versión en ingot.json, haces commit y subes una etiqueta que coincide. El CI comprueba que la etiqueta coincide con el manifiesto, ejecuta ingot package (las mismas comprobaciones que la tienda), guarda el .ingotx como artefacto y ejecuta ingot publish --no-package con el token del secreto. En CI no hace falta ingot login.
1. Crea un token para el CI
- Abre Panel › Publicador (/dashboard/publisher).
- En Tokens de publicación, ponle el nombre del sistema de CI y del repositorio, por ejemplo
GitHub Actions acme/react-rules. - Elige la caducidad. 90 o 180 días es un buen equilibrio; lo cambiarás antes de que caduque (paso 5).
- Haz clic en Crear token y copia el valor
ingot_pub_…. Solo se muestra una vez.
Usa un token distinto por sistema de CI o repositorio, nunca el de tu portátil, para poder revocar uno sin romper los demás.
2. Guarda el token como secreto
Nunca hagas commit del token, no lo imprimas en los logs ni lo pongas en ingot.json.
GitHub: en el repositorio, abre Settings › Secrets and variables › Actions › New repository secret. Nombre: INGOT_PUBLISH_TOKEN, valor: el token. O con la CLI de GitHub:
gh secret set INGOT_PUBLISH_TOKEN --repo acme/react-rules
GitLab: abre Settings › CI/CD › Variables › Add variable. Clave: INGOT_PUBLISH_TOKEN, valor: el token, y marca Mask variable y Protect variable. Las variables protegidas solo llegan a ramas y etiquetas protegidas, así que protege también tus etiquetas de versión en Settings › Repository › Protected tags (patrón v*).
Otro CI: añade una variable de entorno secreta llamada INGOT_PUBLISH_TOKEN. La CLI la lee sola.
3. Añade el flujo
ingot init ya escribió el archivo (--ci github, por defecto, o --ci gitlab). Para añadirlo a una extensión existente, copia uno de estos archivos.
GitHub Actions
.github/workflows/ingot-publish.yml:
name: Publish to the Ingot store
on:
push:
tags: ['v*.*.*']
workflow_dispatch:
permissions:
contents: read
concurrency:
group: ingot-publish-${{ github.ref }}
cancel-in-progress: false
jobs:
publish:
runs-on: ubuntu-latest
timeout-minutes: 10
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with:
node-version: 22
- name: Check the tag matches ingot.json
if: startsWith(github.ref, 'refs/tags/')
run: |
manifest_version=$(node -p "require('./ingot.json').version")
if [ "v${manifest_version}" != "${GITHUB_REF_NAME}" ]; then
echo "::error::Tag ${GITHUB_REF_NAME} does not match ingot.json version ${manifest_version}"
exit 1
fi
- name: Validate and package
run: npx --yes @ingotide/cli@0.1.0 package
- name: Publish
run: npx --yes @ingotide/cli@0.1.0 publish --no-package
env:
INGOT_PUBLISH_TOKEN: ${{ secrets.INGOT_PUBLISH_TOKEN }}
- uses: actions/upload-artifact@v4
with:
name: ingotx
path: '*.ingotx'
if-no-files-found: error
El trabajo solo lee el repositorio (contents: read) y pasa el token únicamente al paso de publicación.
GitLab CI
.gitlab-ci.yml:
stages:
- package
- publish
default:
image: node:22-alpine
package:
stage: package
script:
- npx --yes @ingotide/cli@0.1.0 package
artifacts:
paths:
- '*.ingotx'
expire_in: 1 week
publish:
stage: publish
needs: [package]
rules:
- if: '$CI_COMMIT_TAG =~ /^v\d+\.\d+\.\d+/'
script:
- test "v$(node -p "require('./ingot.json').version")" = "$CI_COMMIT_TAG" || (echo "Tag $CI_COMMIT_TAG does not match ingot.json" && exit 1)
- npx --yes @ingotide/cli@0.1.0 publish --no-package
El trabajo package se ejecuta en cada push, así que un manifiesto roto hace fallar el pipeline antes de etiquetar. publish solo se ejecuta con etiquetas de versión.
Cualquier otro CI
Los mismos tres comandos funcionan en cualquier sitio con Node.js 22:
npx --yes @ingotide/cli@0.1.0 validate
npx --yes @ingotide/cli@0.1.0 package
INGOT_PUBLISH_TOKEN=*** npx --yes @ingotide/cli@0.1.0 publish --no-package
4. Publica subiendo una etiqueta
ingot version patch # o minor / major; actualiza ingot.json y CHANGELOG.md
git commit -am "v1.2.4"
git tag v1.2.4
git push --follow-tags
La etiqueta debe ser v más la versión exacta de ingot.json. Las versiones previas también funcionan: ingot version 2.0.0-beta.1, etiqueta v2.0.0-beta.1. Revisa la ejecución en tu CI; el log termina con la página de la tienda de la nueva versión.
5. Renueva el token antes de que caduque
El panel muestra la caducidad de cada token y ingot whoami también la imprime. Antes de que caduque: crea un token nuevo, cambia el valor del secreto, vuelve a ejecutar el último flujo para comprobarlo y revoca el token antiguo. Un token revocado o caducado falla al instante con invalid_token o token_expired y no se publica nada.
Si un token se filtra, revócalo primero en Panel › Publicador y después crea uno nuevo.
Solución de problemas
| Error en el log | Causa y solución |
|---|---|
No publish token. | El secreto no está definido o no llega al paso. Comprueba que el nombre es exactamente INGOT_PUBLISH_TOKEN; en GitLab, que la etiqueta está protegida. |
401 invalid_token | El token fue revocado o está mal copiado. Crea uno nuevo y actualiza el secreto. |
401 token_expired | Crea un token nuevo y actualiza el secreto (paso 5). |
403 publisher_mismatch | publisher en ingot.json no es el identificador dueño del token. |
409 version_exists | Esa versión ya se publicó. Sube la versión y empuja una etiqueta nueva; una etiqueta no puede volver a publicar una versión. |
409 version_not_newer | La versión es menor que la última. Usa ingot version patch. |
Tag v1.2.3 does not match ingot.json | Etiquetaste antes de subir la versión. Borra la etiqueta (git tag -d v1.2.3 && git push origin :v1.2.3), sube la versión, haz commit y vuelve a etiquetar. |
400 invalid_manifest o invalid_contents | El log lista cada problema. Ejecuta ingot validate en tu equipo y corrígelos. |
429 rate_limited | Más de 30 subidas en una hora. Espera y vuelve a ejecutar el trabajo. |
The registry must use https:// | INGOT_REGISTRY apunta a una dirección http:// que no es localhost. Quítala para usar la tienda. |
npm ERR! 404 @ingotide/cli | La CLI aún no está en npm (Beta). Publica desde tu equipo por ahora. |