Skip to content

Uso

Si buscas una lista corta de comandos para copiar y pegar, usa Referencia rápida.

La recomendación normal es:

  • usar remote cuando consumís Productive K3S como producto;
  • usar local cuando desarrollás contra repos hermanos en disco.

Modos de resolución

  • local
  • remote

Si PRODUCTIVE_K3S_SOURCE no está seteada, pk3s usa remote por defecto.

Ejemplos:

PRODUCTIVE_K3S_SOURCE=remote pk3s bundle core info --json
PRODUCTIVE_K3S_SOURCE=local pk3s profile list

Comandos orientados a Core

Ejemplos:

pk3s doctor --core
pk3s install --core-only
pk3s validate --core
pk3s backup --core
pk3s bundle core info --json

Estos comandos operan sobre el host local a través de Productive K3S Core.

Comandos orientados a Infra:

pk3s profile list
pk3s profile validate --profile profiles/multipass/1-server-2-agents.env
pk3s validate --profile profiles/multipass/1-server-2-agents.env
pk3s plan --profile profiles/multipass/1-server-2-agents.env
pk3s apply --profile profiles/multipass/1-server-2-agents.env
pk3s destroy --profile profiles/multipass/1-server-2-agents.env
pk3s status --profile profiles/multipass/1-server-2-agents.env
  • pk3s profile validate valida sólo el contrato del profile.
  • pk3s validate --profile ... ejecuta la validación del escenario de Infra y puede requerir estado generado del deployment.

Qué resuelve hoy el modo remoto

La base remota actual es:

  • Productive K3S Core 0.9.5
  • Productive K3S Infra 0.9.64-0.9.5

El CLI descarga esos bundles publicados desde GitHub Releases, verifica sus checksums, los extrae en el cache local y luego ejecuta sus superficies públicas de comandos.

Por eso pk3s es el camino recomendado para usuarios: mantiene simple la experiencia sin ocultar las versiones reales de los componentes subyacentes.

Controles de telemetría

El CLI puede persistir tu preferencia de telemetría y también overridearla por comando.

Ejemplos:

pk3s config telemetry status
pk3s config telemetry enable
pk3s config observability set pk3s_live_xxxxx
pk3s config observability status
pk3s plan --profile profiles/multipass/1-server-2-agents.env --telemetry disable
pk3s install --core-only --telemetry enable

Cuando el CLI resuelve la telemetría como habilitada, propaga esa decisión y los IDs de correlación hacia las ejecuciones delegadas de Infra o Core.