Kubiy CLI (kubiy-paas-cli)

English: Official CLI for the Kubiy PaaS platform. Install from npm and use the kubiy command to manage your apps and services deployed on Kubiy.

Español: CLI oficial para la plataforma PaaS de Kubiy. Instala el paquete desde npm y usa el comando kubiy para interactuar con tus apps y servicios desplegados en Kubiy.

Installation / Instalación

npm install -g kubiy-paas-cli

# Get help / Ver ayuda
kubiy

English: This installs the global kubiy binary on your system.

Español: Esto instalará el binario global kubiy en tu sistema.

Main commands / Comandos principales

| Command | English | Español | |--------|---------|---------| | kubiy link <appId> [--env=prod\|stg\|dev] [--apikey=...] [--save-secrets] | Link the current project to a Kubiy app/service and create .kubiy.json. | Vincula el proyecto actual con una app/servicio de Kubiy y genera el archivo .kubiy.json. | | kubiy deploy --message "<text>" [--static] [--dir=<folder>] | Deploy your project to Kubiy using .kubiy.json. | Realiza un deploy de tu proyecto a Kubiy. Usa la configuración de .kubiy.json. | | kubiy service:get <serviceId> | Show detailed information for a Kubiy service. | Muestra información detallada de un servicio en Kubiy. | | kubiy logs [<serviceId>] [--kind=deploy\|app] [--lines=200] | Show deploy or app logs for a service. | Muestra logs de deploy o de la app para un servicio. | | kubiy rollback <deployId> | Roll back to the given deploy using .kubiy.json. | Ejecuta un rollback al deployId indicado usando los datos de .kubiy.json. | | kubiy rollback <appId> <serviceId> <deployId> | Explicit variant with all IDs passed on the command line. | Variante explícita que recibe todos los identificadores por línea de comandos. | | kubiy config --lang es\|en | Set or show CLI language (Spanish or English). | Define o muestra el idioma del CLI (español o inglés). | | kubiy version | Show the current CLI version. | Muestra la versión actual del CLI. |

You can also pass the language per run: kubiy --lang en deploy ...
También puedes indicar el idioma por ejecución: kubiy --lang es deploy ...

Command kubiy login

English: In this version of the CLI, the command kubiy login <cliToken> is temporarily disabled and is not used in the current authentication flow. If you run it, the CLI will show a message that it is disabled.

Español: En esta versión del CLI, el comando kubiy login <cliToken> está deshabilitado temporalmente y no se utiliza en el flujo actual de autenticación. Si lo ejecutas, el CLI mostrará un mensaje indicando que está deshabilitado.

Security / Seguridad

English: This CLI acts as a client to the Kubiy API:

• No secrets are hardcoded (no API keys or tokens in the source code).
• Tokens and API keys are always provided from outside (by the user or configuration).
• All sensitive operations are validated and authorized on the Kubiy API, not in the CLI.
• Requests are always made over HTTPS to https://cli.kubiy.cloud/v1 (or the configured URL).

Recommendations: Do not share your cliToken or API keys. Do not commit .kubiy.json files from real projects to public repos if they contain sensitive identifiers or keys.

Español: Este CLI actúa como cliente frente a la API de Kubiy:

• No incluye ningún secreto hardcodeado (no hay API keys ni tokens dentro del código fuente).
• Los tokens y apikeys se proporcionan siempre desde fuera (por el usuario o por configuración).
• Todas las operaciones delicadas se validan y autorizan en la API de Kubiy, no en el CLI.
• Las llamadas se realizan siempre sobre HTTPS hacia https://cli.kubiy.cloud/v1 (o la URL configurada).

Recomendaciones: No compartas tu cliToken ni apikeys. No subas archivos .kubiy.json de proyectos reales a repos públicos si contienen identificadores o claves sensibles.

Publishing to npm / Publicación en npm

English: This package is ready to be published as a public npm package:

• Package name: kubiy-paas-cli
• Global command: kubiy (defined in the bin field)
• Only the needed files are published (index.js and src/)

To publish a new version:

# 1. Make sure you've updated "version" in package.json

cd kubiy-npm-cli
npm login          # once, if you haven't already
npm publish        # publishes kubiy-paas-cli as a public package

After publishing, users can install it with:

npm install -g kubiy-paas-cli
kubiy version

Español: Este paquete está preparado para publicarse como paquete público en npm:

• Nombre del paquete: kubiy-paas-cli
• Comando global: kubiy (definido en el campo bin)
• Solo se publican los archivos necesarios (index.js y src/)

Para publicar una nueva versión:

# 1. Asegúrate de haber actualizado "version" en package.json

cd kubiy-npm-cli
npm login          # una sola vez, si aún no lo hiciste
npm publish        # publica kubiy-paas-cli como paquete público

Después de publicar, los usuarios pueden instalarlo con:

npm install -g kubiy-paas-cli
kubiy version