Referencia rápida

Esta página está pensada para copiar y pegar comandos. No reemplaza la especificación completa del CLI; es la lista corta más útil para el uso diario.

General

Ver la versión del CLI:

pk3s version

Ver el BOM recursivo del CLI y de los bundles que resuelve:

pk3s bom --json | jq

Usar repos sibling locales en lugar de bundles remotos publicados:

PRODUCTIVE_K3S_SOURCE=local pk3s bom --json | jq

Catálogo y discovery

Listar los profiles publicados en el catálogo:

pk3s profile list

Ver un profile y el resumen de inputs de instalación:

pk3s profile show multipass-1-server-2-agents

Listar los addons publicados en el catálogo:

pk3s addon list
pk3s addon show nginx

Listar los stacks publicados en el catálogo:

pk3s stack list
pk3s stack show cluster-health

Profiles e infraestructura

Validar un profile publicado:

pk3s profile validate multipass-1-server-2-agents

Instalar un cluster local de Multipass desde un profile publicado:

pk3s infra install multipass-1-server-2-agents

Ver el estado actual de ese deployment:

pk3s infra status multipass-1-server-2-agents

Destruir ese deployment:

pk3s infra destroy multipass-1-server-2-agents

Instalar un profile que requiere overrides locales específicos de la instalación:

pk3s infra install aws-single-node-basic --env-file ./aws.env

Inspeccionar un profile antes de instalarlo para saber si --env-file es obligatorio:

pk3s profile show aws-single-node-basic

Addons

Validar un addon publicado:

pk3s addon validate nginx

Instalar un addon dentro de un profile ya instalado:

pk3s addon install nginx --profile multipass-1-server-2-agents

Instalar un addon y publicarlo por Traefik con un único host de ingress:

pk3s addon install nginx --profile multipass-1-server-2-agents --public-host nginx.k3s.lab.internal

Instalar un addon contra un kubeconfig explícito en vez de un profile:

pk3s addon install nginx --kubeconfig ~/.kube/config

Instalar un addon contra un cluster registrado o un contexto específico:

pk3s addon install nginx --cluster local-dev
pk3s addon install nginx --cluster-context default

Stacks

Instalar un stack publicado por nombre de catálogo:

pk3s stack install cluster-health --dry-run

Instalar un stack en un target explícito:

pk3s stack install cluster-health --cluster local-dev
pk3s stack install cluster-health --kubeconfig ~/.kube/config
pk3s stack install cluster-health --cluster-context default
pk3s stack install cluster-health --profile multipass-1-server-2-agents

Exportar un stack publicado como installer autocontenido:

pk3s stack export cluster-health --output ./cluster-health-installer

Telemetría

Ver la preferencia actual de telemetría:

pk3s config telemetry status

Habilitar la preferencia persistida de telemetría:

pk3s config telemetry enable

Deshabilitar telemetría para un único comando mutante:

pk3s infra install multipass-1-server-2-agents --telemetry disable

Notas cortas

• profile list, profile show, addon list, addon show, stack list, stack show, bom --json y version son comandos de solo lectura.
• infra install, infra destroy, addon install y stack install son comandos mutantes.
• addon install --profile <name> requiere estado persistido del profile por una corrida previa de infra install o infra status.
• --public-host solo funciona cuando el addon declara soporte para el contrato básico de ingress administrado por Core.