docs(i18n): align Spanish translations with English originals (TESTING-UPGRADE, UPGRADE-2.3-to-2.4, ZaneyOS-Upgrade, zcli)
This commit is contained in:
parent
d6757fe4e1
commit
bf110107af
4 changed files with 534 additions and 56 deletions
|
|
@ -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.
|
||||
|
|
|
|||
|
|
@ -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.
|
||||
|
|
|
|||
|
|
@ -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!
|
||||
|
|
|
|||
55
zcli.es.md
55
zcli.es.md
|
|
@ -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.
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue