feat(motor): agregar version fijable en build y clusterlog bootstrap-instance
Primer paso hacia separar el motor (herramienta genérica) de cada instancia (contenido de un deployment): Version deja de ser const para poder inyectarse con -ldflags en `make build` (git describe, sin tags aún), y el comando nuevo bootstrap-instance genera el esqueleto mínimo de una instancia (zola.toml, content/<sección>/_index.md, admins.json vacío, .clusterlog-version) reusando saveAdmins() en vez de duplicar su formato. Documentado en CLI.md; el empaquetado de templates/tema y el CI de instancia quedan para cuando el motor publique releases. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,51 @@
|
||||
# {{TITLE}}
|
||||
|
||||
Este repositorio es una **instancia de clusterlog**: contiene el contenido,
|
||||
los datos y la configuración de un deployment concreto, no el código del
|
||||
motor. Se generó con:
|
||||
|
||||
```bash
|
||||
clusterlog bootstrap-instance --output . --product-name "{{PRODUCT_NAME}}"
|
||||
```
|
||||
|
||||
## Qué hay aquí
|
||||
|
||||
- `content/` — documentación, manuales, memorias, proyectos y tareas de esta
|
||||
instancia. Empieza con las seis secciones vacías (`_index.md` únicamente).
|
||||
- `data/admins.json`, `config/allowed_signers` — registro de administradores,
|
||||
vacío hasta el primer `admin add`.
|
||||
- `zola.toml` — configuración de este deployment (`base_url`, nombre del
|
||||
producto). Cámbiela antes de publicar.
|
||||
- `.clusterlog-version` — versión del motor `clusterlog` usada para generar
|
||||
este esqueleto. Manténgala sincronizada con el binario que use su CI.
|
||||
|
||||
## Primeros pasos
|
||||
|
||||
1. Cambie `base_url` en `zola.toml` por el dominio real de este deployment.
|
||||
2. Registre al primer administrador (recibe `owner` automáticamente):
|
||||
|
||||
```bash
|
||||
clusterlog --root . --ssh-key ~/.ssh/id_ed25519.pub admin add \
|
||||
--id ana --name "Ana Torres" --email ana@example.org \
|
||||
--key ~/.ssh/id_ed25519.pub --roles owner,admin
|
||||
```
|
||||
|
||||
3. Inicialice Git y firme el primer commit (vea la sección "Registrar al
|
||||
primer administrador" en la documentación del motor para el detalle
|
||||
completo de `git config`/`commit -S`).
|
||||
4. Genere la proyección y valide:
|
||||
|
||||
```bash
|
||||
clusterlog --root . sync
|
||||
clusterlog --root . validate --skip-zola
|
||||
```
|
||||
|
||||
## Pendiente (no incluido por este comando)
|
||||
|
||||
- Plantillas Tera y el tema `zola.386`: todavía se obtienen desde un checkout
|
||||
del repositorio del motor (`make theme` / `scripts/bootstrap-theme.sh`).
|
||||
Empaquetarlos en un release descargable del motor es trabajo de una fase
|
||||
posterior.
|
||||
- Un workflow de CI para esta instancia (que descargue el binario del motor
|
||||
por versión fijada) no se generó todavía: el motor aún no publica releases
|
||||
binarios. Se agrega en cuanto exista ese release.
|
||||
Reference in New Issue
Block a user