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 hostserver: ejecuta sólo la instalación baseagent: configura un nodo agente y requiere URL del servidor más token del clústerstack: 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
k3sy Helm - puede instalar componentes del stack como
cert-manager,Longhorn,Ranchery el registry in-cluster - puede administrar
/etc/hostslocal - puede administrar NFS local del host
- puede instalar trust local de Docker para el registry self-signed
server¶
- puede instalar o reutilizar
k3sy Helm - omite componentes sólo de stack
- omite integraciones locales del stack como
/etc/hostsadministrado por add-ons, Docker registry trust y NFS
agent¶
- apunta a
k3s-agenten lugar del servicio servidor - pide
Agent server URLyAgent cluster tokencuando hace falta instalar el agente - omite Helm y componentes del stack
stack¶
- requiere un
k3sserver ya en funcionamiento yhelminstalado - no instala la base de
k3s - se enfoca en componentes del stack y cluster issuers
- es el camino público esperado para
./productive-k3s-core.sh stack install <name>
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 como camino all-in-one legado. El contrato público ahora prefiere apply para la instalación core-only y stack install <name> para instalar un stack de forma explícita.
Note
server, agent y stack son especialmente valiosos cuando otra capa orquesta la secuencia del bootstrap.