CLI / Integraciones

Integraciones

Lleva un ambiente a Vercel, Fly.io o GitHub Actions sin pasar por el servidor de Kofre.

Cómo funciona#

kofre sync descifra el ambiente en tu máquina y lo envía con la API del servicio de destino, usando tu propia sesión (vercel login, fly auth login, gh auth login) o un token en --token. El servidor de Kofre no ve ni los valores ni los tokens. Con --dry-run solo lista los nombres.

Terminal

$ kofre sync vercel --env prod --dry-run
Se enviarían 3 variables de prod a Vercel (prj_acme):
  DATABASE_URL
  JWT_SECRET
  STRIPE_SECRET_KEY

Vercel#

Toma el proyecto y el equipo de .vercel/project.json (lo deja vercel link). El ambiente decide el target: dev → development, staging → preview, prod → production; --target lo cambia. Las variables se crean como encrypted y se sobrescriben si ya existen.

Terminal

$ vercel link
$ kofre sync vercel --env prod

Fly.io#

Usa la app de fly.toml o la de --app. Fly aplica los secretos desplegando una versión nueva, así que la app se reinicia con los valores.

Terminal

$ kofre sync fly --env prod --app acme-api

GitHub Actions#

Pide la clave pública del repositorio, sella cada valor con ella (caja sellada de libsodium, como hace gh secret set) y lo guarda como secreto de Actions. Con --environment van al environment de GitHub; sin él, al repositorio.

Terminal

$ kofre sync github --env prod --environment production

Si prefieres no copiar valores a GitHub, la alternativa es un token de servicio: el workflow instala la CLI y ejecuta kofre run con KOFRE_TOKEN, como se explica en CI/CD.