Skip to content

Modos De Productive K3S Core

apply.sh expone modos explícitos de ejecución mediante --mode.

Modos soportados

Modo Propósito
single-node Modo combinado legado. Instala el core más el stack default en una sola pasada
server Modo default. Hace bootstrap sólo de los componentes core del nodo servidor
agent Suma un nodo como agente de K3S
stack Instala o reutiliza un stack explícito sobre un clúster existente

Significado operativo

Internamente el script trata a los modos como switches de capacidades:

  • single-node: ejecuta instalación base, instalación del stack y tareas locales del host
  • server: ejecuta sólo la instalación base
  • agent: configura un nodo agente y requiere URL del servidor más token del clúster
  • stack: requiere un clúster existente y Helm, y luego opera sólo sobre los componentes del stack seleccionado

Qué cambia según el modo

single-node

  • puede instalar k3s y Helm
  • puede instalar componentes del stack como cert-manager, Longhorn, Rancher y el registry in-cluster
  • puede administrar /etc/hosts local
  • puede administrar NFS local del host
  • puede instalar trust local de Docker para el registry self-signed

server

  • puede instalar o reutilizar k3s y Helm
  • omite componentes sólo de stack
  • omite integraciones locales del stack como /etc/hosts administrado por add-ons, Docker registry trust y NFS

agent

  • apunta a k3s-agent en lugar del servicio servidor
  • pide Agent server URL y Agent cluster token cuando hace falta instalar el agente
  • omite Helm y componentes del stack

stack

  • requiere un k3s server ya en funcionamiento y helm instalado
  • no instala la base de k3s
  • se enfoca en componentes del stack y cluster issuers
  • se alcanza mediante el camino público artifact-only ./productive-k3s-core.sh stack install --tgz <artefacto>
  • recibe la identidad del stack desde los metadatos del paquete; nunca resuelve un nombre ni un checkout fuente hermano

Por qué importa la separación por modos

El modelo de modos es lo que hace posible la orquestación desde productive-k3s-infra. Le da a la automatización de infraestructura una interfaz estable para:

  • provisioning base de nodos
  • joins de agentes
  • instalación del stack del clúster una vez que el clúster ya existe

Notas

Note

single-node se conserva por compatibilidad del runtime pero ya no implica un stack de aplicaciones default. Usá apply para la instalación core-only y stack install --tgz <artefacto> para un stack empaquetado exacto.

Note

La instalación pública de add-ons sigue otra frontera: ./productive-k3s-core.sh addon install --tgz <artifact>. La instalación directa de add-ons por nombre de fuente ya no forma parte del contrato público de core.

Note

server, agent y stack son especialmente valiosos cuando otra capa orquesta la secuencia del bootstrap.