docs(i18n): align Spanish translations with English originals (TESTING-UPGRADE, UPGRADE-2.3-to-2.4, ZaneyOS-Upgrade, zcli)

This commit is contained in:
Don Williams 2025-08-30 16:56:59 -04:00
commit bf110107af
4 changed files with 534 additions and 56 deletions

View file

@ -1,27 +1,160 @@
[English](TESTING-UPGRADE.md) | [Español](TESTING-UPGRADE.es.md)
# Probando la actualización
# Pruebas de los Scripts de Actualización ZaneyOS 2.3 → 2.4
## VM
## 🧪 Configuración del Entorno de Pruebas
- Iniciar VM
- ejecutar `zcli update`
- reiniciar
- ejecutar `zcli update`
- reiniciar
Esta rama (históricamente `ddubs-dev`) contiene los scripts de actualización para pruebas seguras antes de fusionar a main.
## Nixstation
### Prerrequisitos para Probar:
- Un sistema ZaneyOS 2.3 (rama stable-2.3)
- Acceso a los archivos de la rama main
- Respaldo de tu sistema (el script crea uno, pero también se recomienda respaldo manual)
- Iniciar Nixstation
- ejecutar `zcli update`
- reiniciar
- ejecutar `zcli update`
- reiniciar
### Obtén el script de forma segura (NO hagas `git pull` todavía)
Para evitar sobrescribir tu configuración local antes de tener un respaldo, descarga solo el script sin alterar tu working tree:
## Laptop
Opción A — Usando tu remoto git existente:
```bash
git -C ~/zaneyos fetch origin
git -C ~/zaneyos show origin/main:upgrade-2.3-to-2.4.sh > ~/upgrade-2.3-to-2.4.sh
chmod +x ~/upgrade-2.3-to-2.4.sh
```
- Iniciar Laptop
- ejecutar `zcli update`
- reiniciar
- ejecutar `zcli update`
- reiniciar
Opción B — Usando curl:
```bash
curl -fsSL https://gitlab.com/zaney/zaneyos/-/raw/main/upgrade-2.3-to-2.4.sh -o ~/upgrade-2.3-to-2.4.sh
chmod +x ~/upgrade-2.3-to-2.4.sh
```
## 📋 Plan de Pruebas
### Fase 1: Validación del Script
1. **Chequeo de Sintaxis**: Verifica que los scripts no tengan errores de sintaxis
2. **Dry Run**: Prueba la detección de versión y creación de respaldo
3. **Permisos**: Asegura que los scripts sean ejecutables y con permisos correctos
### Fase 2: Pruebas de Respaldo
1. **Creación de Respaldo**: Verifica que se cree un respaldo completo
2. **Integridad del Respaldo**: Confirma que el respaldo contenga los archivos necesarios
3. **Prueba de Reversión**: Prueba el revert sin realizar la actualización
### Fase 3: Pruebas de Actualización
1. **Actualización Completa**: Realiza la actualización 2.3 → 2.4
2. **Migración de Configuración**: Verifica que se preserven todos los ajustes
3. **Manejo de Terminales**: Confirma que las terminales queden habilitadas correctamente
4. **Transición a SDDM**: Prueba la seguridad del cambio de display manager
### Fase 4: Validación Post-Actualización
1. **Arranque del Sistema**: Verifica que el sistema arranque correctamente con SDDM
2. **Funcionalidad de Aplicaciones**: Prueba que todas las aplicaciones funcionen
3. **Persistencia de Configuración**: Confirma que se preservaron los ajustes personalizados
## 🔧 Comandos de Prueba
### Para obtener la rama de pruebas (si aplica históricamente):
```bash
cd ~/zaneyos
git fetch origin
git checkout ddubs-dev
git pull origin ddubs-dev
```
### Probar Sintaxis de Scripts:
```bash
bash -n upgrade-2.3-to-2.4.sh
bash -n revert-to-2.3.sh
```
### Probar Detección de Versión (Seguro):
```bash
# Esto solo verificará la versión y creará un respaldo, luego saldrá
./upgrade-2.3-to-2.4.sh
# Responde 'N' cuando pregunte si desea continuar
```
### Probar la Reversión:
```bash
# Tras crear un respaldo, prueba la reversión
./upgrade-2.3-to-2.4.sh --revert
# O usa el wrapper
./revert-to-2.3.sh
```
## 📊 Plantilla de Resultados de Prueba
### Configuración del Sistema:
- **Versión Actual**: 2.3 (rama: stable-2.3)
- **Terminal Usada**: [kitty/alacritty/wezterm/ghostty]
- **Ajustes Personalizados**: [lista de personalizaciones]
- **Hardware**: [descripción breve]
### Resultados:
#### ✅ Pre-Flight:
- [ ] Validación de sintaxis ok
- [ ] Detección de versión correcta
- [ ] Respaldo creado con éxito
- [ ] Herramientas requeridas detectadas (git, nh, etc.)
#### ✅ Respaldo y Reversión:
- [ ] Respaldo completo creado
- [ ] Ubicación del respaldo mostrada claramente
- [ ] Script de revert funciona
- [ ] Sistema restaurado a 2.3 tras revert
- [ ] Ajustes originales preservados
#### ✅ Proceso de Actualización:
- [ ] Migración de configuración completa
- [ ] Manejo de terminal correcto
- [ ] Build con opción 'boot' exitoso
- [ ] Sin errores durante la actualización
#### ✅ Post-Actualización:
- [ ] Sistema reinicia correctamente
- [ ] SDDM se muestra correctamente (sin pantalla en negro)
- [ ] DE carga correctamente
- [ ] Terminal preferida funciona
- [ ] Aplicaciones funcionan
- [ ] Ajustes (tema, fondo, etc.) preservados
### Problemas Encontrados:
[Describe cualquier problema]
### Recomendaciones:
[Sugerencias de mejora]
## 🚨 Notas de Seguridad
1. **Probar en VM** recomendado
2. **Respaldo externo** adicional
3. **Plan de recuperación** (USB live de NixOS)
4. **Tiempo**: reserva 1–2 horas
5. **Red** estable para descargas
## 📝 Reporte de Resultados
Incluye:
1. Especificaciones del sistema
2. Configuración inicial (rama 2.3 y personalizaciones)
3. Resultados completos usando la plantilla
4. Mensajes de error o logs
5. Capturas de pantalla
## 🔄 Iteración
Tras probar:
1. Reporta resultados e incidencias
2. Se aplican mejoras
3. Re‑prueba
4. Cuando sea estable, fusionar a main
## 📞 Soporte durante pruebas
Si encuentras problemas:
1. Revisa el archivo de log (ruta mostrada por el script)
2. Prueba la reversión a 2.3
3. Reporta el problema incluyendo el log
4. Tu respaldo siempre está disponible para recuperación manual
¡Recuerda! Es software en pruebas: ten siempre un plan de recuperación.

View file

@ -1,33 +1,221 @@
[English](UPGRADE-2.3-to-2.4.md) | [Español](UPGRADE-2.3-to-2.4.es.md)
# Actualización de ZaneyOS de 2.3 a 2.4
# Guía de Actualización ZaneyOS 2.3 → 2.4
Esta guía te guiará a través del proceso de actualización de ZaneyOS de la versión 2.3 a la 2.4.
Esta guía proporciona scripts de actualización seguros para migrar de ZaneyOS 2.3 a 2.4, manejando cambios incompatibles y preservando tu configuración personalizada.
## Prerrequisitos
## 🔄 Cambios Importantes en 2.4
- ZaneyOS 2.3 instalado
- Acceso a internet
- **SDDM** ahora es el display manager predeterminado (antes tui-greetd)
- **Selección de terminal**: terminales habilitables por bandera
- **Nuevas variables**: añadidas en `variables.nix`
- **Breaking changes**: actualizaciones directas fallan por variables faltantes
## Instrucciones
## 📋 Qué hace el Script de Actualización
1. Abre una terminal.
2. Ejecuta el siguiente comando para actualizar tu sistema:
1. **Análisis previo** con reporte detallado
2. **Respaldo completo** de tu sistema actual
3. **Verificación de versión** (debes estar en 2.3)
4. **Actualización segura**: cambia a main (2.4) y migra
5. **Migración de variables** al nuevo formato
6. **Manejo de terminales**: habilita tu preferida en 2.4
7. **Build seguro** con `boot` para evitar problemas con SDDM
8. **Opción de revert** fácil si algo sale mal
## 🛡️ Características de Seguridad
- **Respaldo completo** de ~/zaneyos antes de cambios
- **Boot vs Switch**: usa build de arranque seguro
- **Revert** sencillo para restaurar 2.3
- **Validaciones** previas al proceso
- **Logging** exhaustivo para troubleshooting
## 🚀 Cómo Actualizar
### Paso 0: Obtén el script de forma segura (NO hagas git pull)
Para evitar sobrescribir tu configuración local antes de crear un respaldo, descarga solo el script sin modificar tu working tree.
Opción A — Usando tu remoto git (recomendado):
```bash
zcli update
# Trae refs sin tocar tu working tree
git -C ~/zaneyos fetch origin
# Escribe el script desde origin/main a tu home
git -C ~/zaneyos show origin/main:upgrade-2.3-to-2.4.sh > ~/upgrade-2.3-to-2.4.sh
chmod +x ~/upgrade-2.3-to-2.4.sh
```
3. Reinicia tu sistema.
4. Después de reiniciar, ejecuta el siguiente comando para verificar que tu sistema se ha actualizado a la versión 2.4:
Opción B — Usando curl:
```bash
zcli version
curl -fsSL https://gitlab.com/zaney/zaneyos/-/raw/main/upgrade-2.3-to-2.4.sh -o ~/upgrade-2.3-to-2.4.sh
chmod +x ~/upgrade-2.3-to-2.4.sh
```
5. Si la versión es 2.4, entonces has actualizado exitosamente tu sistema.
Ambos métodos mantienen tu repo local intacto. El script creará un respaldo completo antes de cambiar ramas.
## Solución de problemas
### Paso 1: Ejecuta el Script
Si tienes algún problema durante el proceso de actualización, por favor, abre un problema en el [rastreador de problemas de ZaneyOS](https://github.com/zaneyos/zaneyos/issues).
```bash
# Puedes ejecutarlo desde cualquier ruta; opera sobre ~/zaneyos
~/upgrade-2.3-to-2.4.sh
```
### Paso 2: Revisa el Análisis Previo
El script realizará un análisis completo de tu configuración actual:
- **Analiza flake.nix** (inputs y perfil actual)
- **Escanea hosts** y detecta personalizaciones
- **Revisa paquetes globales** en modules/core/packages.nix
- **Detecta personalizaciones de shell** (zsh, bash, eza)
- **Identifica módulos personalizados** y archivos personales
- **Genera un informe detallado** en `~/zaneyos-upgrade-analysis-TIMESTAMP.txt`
**Verás claramente:**
- ✅ **Qué se migrará automáticamente** (variables, paquetes, configs)
- ⚠️ **Qué requiere atención manual** (inputs personalizados, archivos personales)
- 📋 **Resumen** de hosts y personalizaciones detectadas
### Paso 3: Sigue los Prompts
Luego de revisar el análisis, el script:
- Creará un respaldo (verás la ruta)
- Pedirá confirmación antes de continuar
- Descargarà 2.4 desde main
- Migrará automáticamente tu configuración
- Compilará el nuevo sistema
- Pedirá reinicio
### Paso 4: Reinicia el Sistema
Tras un build exitoso:
```bash
sudo reboot
```
Tu sistema iniciará con:
- SDDM como gestor de acceso
- Todos tus ajustes preservados
- Funcionalidades de 2.4 disponibles
## 🔧 Detalles de Migración
### Ajustes preservados automáticamente:
- Usuario y email de Git
- Preferencia de navegador
- Elección de terminal (con habilitación automática)
- Layout de teclado y console keymap
- NFS, impresión y Thunar
- Formato de reloj (12h/24h)
- Ajustes de monitores
- Fondo (stylixImage)
- Tema de Waybar
- Animaciones
- Hardware
- **Paquetes globales** (modules/core/packages.nix)
- **Paquetes por host** (hosts/[hostname]/host-packages.nix)
- **Imports personalizados** (hosts/[hostname]/default.nix si aplica)
### Manejo de Terminales:
Si usabas una terminal específica en 2.3:
- **Kitty**: ya habilitada por defecto en 2.4
- **Alacritty**: se habilita `alacrittyEnable = true`
- **WezTerm**: se habilita `weztermEnable = true`
- **Ghostty**: se habilita `ghosttyEnable = true`
## ⚠️ Notas Importantes
### Display Manager SDDM
- 2.4 usa SDDM por defecto
- La actualización usa `boot` para evitar problemas visuales
- **Debes reiniciar** tras la actualización; no uses `switch`
### Ubicación del Respaldo
```
~/.config/zaneyos-backups/zaneyos-2.3-upgrade-backup-TIMESTAMP/
```
## 🔄 Cómo Revertir
Si algo falla, puedes revertir fácilmente:
### Opción 1: Script de revert
```bash
cd ~/zaneyos
./revert-to-2.3.sh
```
### Opción 2: Script principal
```bash
cd ~/zaneyos
./upgrade-2.3-to-2.4.sh --revert
```
### Opción 3: Reversión manual
1. Elimina `~/zaneyos`: `rm -rf ~/zaneyos`
2. Restaura desde el respaldo: `cp -r ~/.config/zaneyos-backups/[backup-name]/zaneyos ~/`
3. Rebuild: `nh os boot ~/zaneyos --hostname [profile]`
4. Reinicia
## 🔍 Troubleshooting
### Fallos de build
- Revisa el log (ruta mostrada por el script)
- Asegura espacio en disco suficiente
- Prueba revert y reporta
### Problemas de visualización tras reinicio
- Si ves pantalla en negro, espera unos segundos a que SDDM arranque
- Cambia a TTY (Ctrl+Alt+F2) si lo necesitas
- Inicia sesión y ejecuta `systemctl status display-manager`
### Aplicaciones faltantes
- Verifica tu terminal preferida en `~/zaneyos/hosts/[hostname]/variables.nix`
- Confirma que navegador y otras apps sigan disponibles
### Log de ejecución
Cada corrida genera un log en: `~/zaneyos-upgrade-TIMESTAMP.log`
## 📁 Estructura tras la actualización
```
~/zaneyos/hosts/[tu-hostname]/
├── hardware.nix (preservado de 2.3)
└── variables.nix (actualizado a 2.4 con tus ajustes)
```
## 🆘 Recuperación de Emergencia
Si algo sale mal:
1. Tu respaldo 2.3 está intacto
2. Arranca con un USB live de NixOS
3. Monta el sistema y restaura el respaldo
4. Tus datos y configuración están seguros
## ✅ Lista de Verificación Post‑Actualización
Tras actualizar y reiniciar:
- [ ] Aparece la pantalla de login de SDDM
- [ ] El escritorio carga correctamente
- [ ] Se abre tu terminal preferida
- [ ] El navegador funciona
- [ ] Se preservó fondo/tema
- [ ] Configuración de monitores correcta
- [ ] Aplicaciones necesarias disponibles
## 🤝 Ayuda
Si encuentras problemas:
1. Revisa el log de ejecución
2. Prueba la reversión a 2.3
3. Reporta con contenido del log
4. Tu respaldo permite recuperación manual
---
## Archivos de Script
- `upgrade-2.3-to-2.4.sh` — Script principal
- `revert-to-2.3.sh` — Wrapper de reversión
- `UPGRADE-2.3-to-2.4.md` — Esta documentación
Recuerda: se crea un respaldo completo antes de cualquier cambio, por lo que siempre puedes recuperarte.

View file

@ -1,33 +1,147 @@
[English](ZaneyOS-Upgrade.md) | [Español](ZaneyOS-Upgrade.es.md)
# Actualización de ZaneyOS
# 🚀 Procedimiento de Actualización de ZaneyOS
Esta guía te guiará a través del proceso de actualización de ZaneyOS.
## ⚠️ DEPRECADO - Usa el nuevo sistema de actualización automatizado
## Prerrequisitos
> **IMPORTANTE:**
>
> Este procedimiento manual ha sido **reemplazado** por un sistema automatizado mucho más seguro y completo.
>
> **Usa el nuevo sistema:**
> - Revisa: `UPGRADE-2.3-to-2.4.md` (documentación completa)
> - Ejecuta: `./upgrade-2.3-to-2.4.sh` (actualización automatizada)
> - Incluye respaldos automáticos, migración de variables y reversión sencilla
- ZaneyOS instalado
- Acceso a internet
---
## Instrucciones
## 🆕 Nuevo Sistema Automatizado
1. Abre una terminal.
2. Ejecuta el siguiente comando para actualizar tu sistema:
Proporciona:
- **Respaldo completo** antes de cambios
- **Migración automática** de variables 2.3 → 2.4 (15+ variables)
- **Manejo de terminales** crítico para 2.4
- **Build seguro** con `boot` para evitar problemas visuales
- **Reversión con un comando** si algo falla
- **Logs** completos para diagnóstico
### Inicio Rápido
```bash
zcli update
# Obtén el script sin modificar tu repo
git -C ~/zaneyos fetch origin && \
git -C ~/zaneyos show origin/main:upgrade-2.3-to-2.4.sh > ~/upgrade-2.3-to-2.4.sh && \
chmod +x ~/upgrade-2.3-to-2.4.sh
# Ejecuta el script (crea respaldo completo antes de cambiar ramas)
~/upgrade-2.3-to-2.4.sh
```
3. Reinicia tu sistema.
4. Después de reiniciar, ejecuta el siguiente comando para verificar que tu sistema se ha actualizado:
Alternativa (curl):
```bash
zcli version
curl -fsSL https://gitlab.com/zaney/zaneyos/-/raw/main/upgrade-2.3-to-2.4.sh -o ~/upgrade-2.3-to-2.4.sh
chmod +x ~/upgrade-2.3-to-2.4.sh
~/upgrade-2.3-to-2.4.sh
```
5. Si la versión es la última versión, entonces has actualizado exitosamente tu sistema.
### Instrucciones Detalladas
```bash
less UPGRADE-2.3-to-2.4.md
```
## Solución de problemas
---
Si tienes algún problema durante el proceso de actualización, por favor, abre un problema en el [rastreador de problemas de ZaneyOS](https://github.com/zaneyos/zaneyos/issues).
## ⚠️ ¿Por qué usar el sistema nuevo?
El proceso manual es **incompleto y riesgoso** porque:
- ❌ Maneja pocas variables (2.4 añade 15+)
- ❌ No hay respaldo automático
- ❌ No maneja dependencias de terminal
- ❌ No hay opción de revertir si falla
- ❌ Faltan variables críticas como `doomEmacsEnable`, monitores, tema
- ❌ Referencias desactualizadas (`fr`, `fu` en vez de `zcli`)
---
# 📜 Procedimiento Manual Original (DEPRECADO)
> **⚠️ ADVERTENCIA:** Proceso manual desactualizado e incompleto.
> **Usa el sistema automatizado indicado arriba.**
---
### 1. 📝 Preparación
1. **Asegura que tu ZaneyOS actual esté al día:**
- Ve a tu carpeta ZaneyOS:
```bash
cd ~/zaneyos
```
- Si tienes cambios sin commit, súbelos primero.
- Trae los últimos cambios:
```bash
git stash && git fetch && git pull
```
- Verifica que host y GPU en `flake.nix` coincidan con tu sistema.
- Puedes editarlos manualmente.
- Dependiendo de tu build actual, quizá puedas ejecutar `zcli update-host`.
- Si hay cambios, reconstruye y reinicia (`zcli rebuild`).
2. **Respalda tu directorio actual:**
```bash
mv ~/zaneyos ~/zaneyos-backup
```
3. **Clona la rama v2.4:**
```bash
git clone https://gitlab.com/zaney/zaneyos.git -b Stable-2.4 --depth=1
cd ~/zaneyos
```
---
### 2. 🔄 Convertir hosts 2.3 a 2.4
- **Nuevas opciones en `hosts/<hostname>/variables.nix`:**
```nix
displayManager = "sddm";
tmuxEnable = false;
alacrittyEnable = false;
weztermEnable = false;
ghosttyEnable = false;
vscodeEnable = false;
helixEnable = false;
```
- **Pasos de migración:**
1. Copia la plantilla `hosts/default` a tu hostname
2. Copia `hardware.nix` desde el respaldo
3. `git add .`
4. Integra tus personalizaciones manualmente en el nuevo layout (no sobrescribas archivos 2.4)
---
### 3. ✅ Probar la Configuración
1. Verifica `flake.nix` (hostname y GPU). Si tienes `zcli update-host`, úsalo.
2. Ejecuta:
```bash
nix flake check
```
---
### 4. ⬆️ Ejecutar la Actualización
> ⚠️ **CRÍTICO:**
> - No uses `fr`, `fu` ni `zcli` para este paso final.
> - Podría provocar un crash de Hyprland al reiniciar el display manager.
1. Ejecuta desde `~/zaneyos`:
```bash
sudo nixos-rebuild boot --flake .#PROFILE
```
2. Reinicia.
---
### 🎉 ¡Bienvenido a ZaneyOS v2.4!

View file

@ -1,11 +1,54 @@
[English](zcli.md) | [Español](zcli.es.md)
# zcli
# Utilidad de Línea de Comandos ZaneyOS (zcli) - Versión 1.0.2
`zcli` es una herramienta de línea de comandos para gestionar ZaneyOS.
`zcli` es una herramienta práctica para realizar tareas comunes de mantenimiento en tu sistema ZaneyOS con un solo comando. A continuación, una guía de uso y comandos.
## Comandos
## Uso
- `zcli update`: Actualiza tu sistema.
- `zcli version`: Muestra la versión actual de ZaneyOS.
- `zcli help`: Muestra el mensaje de ayuda.
Ejecuta la utilidad con un comando específico:
`zcli`
Si no se proporciona comando, muestra la ayuda.
## Comandos Disponibles (resumen)
| Comando | Icono | Descripción | Ejemplo |
| ------------- | ----- | ------------------------------------------------------------------------------------------- | ------------------------------------ |
| cleanup | 🧹 | Elimina generaciones antiguas (todas o manteniendo N últimas) | `zcli cleanup` |
| diag | 🛠️ | Genera informe de diagnóstico en `~/diag.txt` | `zcli diag` |
| list-gens | 📋 | Lista generaciones de usuario y sistema | `zcli list-gens` |
| rebuild | 🔨 | Reconstruye NixOS (con comprobaciones de seguridad previas) | `zcli rebuild -v` |
| rebuild-boot | 🔄 | Reconstruye para el próximo arranque (más seguro para cambios grandes) | `zcli rebuild-boot` |
| trim | ✂️ | Ejecuta fstrim del sistema de archivos | `zcli trim` |
| update | 🔄 | Actualiza el flake y reconstruye | `zcli update` |
| update-host | 🏠 | Ajusta host y perfil en `flake.nix` (detección de GPU y validación) | `zcli update-host` |
| add-host | ➕ | Crea un nuevo host (detección de GPU, `hardware.nix`, integración git) | `zcli add-host mi-host amd` |
| del-host | ➖ | Elimina un host existente | `zcli del-host mi-host` |
| doom install | 🔥 | Instala Doom Emacs usando el script `get-doom` | `zcli doom install` |
| doom status | ✅ | Comprueba instalación y muestra versión | `zcli doom status` |
| doom remove | 🗑️ | Elimina Doom Emacs con confirmación | `zcli doom remove` |
| doom update | 🔄 | Actualiza paquetes/config de Doom (`doom sync`) | `zcli doom update` |
## Opciones Avanzadas (rebuild/update)
- `--dry, -n`: simulación (no ejecuta)
- `--ask, -a`: confirmación interactiva
- `--cores N`: limita CPU usada en compilación
- `--verbose, -v`: salida detallada
- `--no-nom`: deshabilita nix-output-monitor
### Ejemplos
```bash
zcli update --dry
zcli rebuild --ask --verbose
zcli rebuild --cores 2
zcli update --dry --verbose --cores 4
```
## Notas
- Usa `update-host`, `add-host` y `del-host` para gestionar hosts.
- Doom Emacs: `install`, `status`, `remove`, `update` para ciclo de vida.
- Si tienes problemas, genera `zcli diag` y revisa los logs del sistema.