fix: readme

This commit is contained in:
f
2026-04-20 12:57:27 -03:00
parent ddc7ee9380
commit 5c386f4dd5

View File

@ -1,14 +1,13 @@
# huerta-init
# gallinero-init
Es el instalador de huertas para la Escuela Común. Se encarga de toda
la configuración post instalación, incluyendo:
Es el instalador de nodos del Gallinero. Se encarga de toda la
configuración post instalación, incluyendo:
* Cifrar el disco de datos (si existe)
* Crear el nodo en la red Común (hay que darlo de alta en el proxy
luego)
* Configurar `initramfs` para que podamos conectarnos por red a la
huerta sin necesidad de conectarle teclado y monitor ni estar
físicamente al lado de la huerta.
* Crear el nodo en la red autónoma pirata (rap)
* Configurar `initramfs` para que podamos conectarnos por red al
nodo sin necesidad de conectarle teclado y monitor ni estar
físicamente al lado del nodo.
* Instalar `abra` y hacer la configuración inicial de `traefik`.
# Pasos
@ -24,12 +23,12 @@ la configuración post instalación, incluyendo:
utilizado después. Preferimos usar `lvextend` luego que manipular
las opciones de particionado del instalador.
* ¡Usar un _hostname_ sin guiones en el nombre! Luego genera
incompatibilidades en la red Común y Coopcloud.
incompatibilidades en la rap y Coopcloud.
* Si no instalamos una llave SSH desde GitHub, este es el momento de
hacerlo:
```sh
ssh-copy-id usuarie@192.168.0.10 # IP de la huerta en la red local
ssh-copy-id usuarie@192.168.0.10 # IP de la nodo en la red local
```
* Ingresar por SSH al sistema:
@ -42,36 +41,35 @@ la configuración post instalación, incluyendo:
```sh
# Hacer esto una sola vez
git clone https://git.coopcloud.tech/escuela-comun/huerta-init.git
git clone https://git.coopcloud.tech/gallinero/gallinero-init.git
# Hacer esto cada vez que queramos correr un script
cd huerta-init
# Hacer esto para actualizar huerta-init
cd gallinero-init
# Hacer esto para actualizar gallinero-init
git pull
# Hacer la instalación base, se puede correr múltiples veces. Es
# posible que nos pida la contraseña de cifrado de disco varias veces.
sudo ./huerta-init.sh
sudo ./gallinero-init.sh
# Nos va a pedir que reiniciemos
```
* Luego de reiniciar y haber activado el nodo en la red Común,
* Luego de reiniciar y haber activado el nodo en la rap,
deberíamos poder conectarnos por SSH a su dirección:
```sh
# Ingresar a la huerta a través del proxy
ssh usuarie@huerta.abyaya.la -p 3000 # puerto asignado por el proxy
ssh usuarie@192.168.0.10
# Desbloquear el disco con la contraseña de cifrado
cryptroot-unlock
```
**Estos dos comandos son los que vamos a tener que correr cada vez que
se reinicie la huerta.**
se reinicie el nodo.**
* Luego, hacer la instalación de Coopcloud:
```sh
# Volver a ingresar
ssh usuarie@huerta.abyaya.la -p 3000 # puerto asignado por el proxy
cd huerta-init
ssh usuarie@192.168.0.10
cd gallinero-init
./abra-init.sh # sin sudo
exit # cerrar y volver a entrar
```
@ -79,44 +77,21 @@ la configuración post instalación, incluyendo:
* Terminar la instalación de Traefik:
```sh
ssh usuarie@huerta.abyaya.la -p 3000 # puerto asignado por el proxy
cd huerta-init
# Volver a ingresar
ssh usuarie@192.168.0.10
cd gallinero-init
./traefik-init.sh # sin sudo
```
* A partir de ahora podemos instalar aplicaciones ingresando por `ssh`
y usando `abra`.
* Cada vez que reinicie la huerta tendremos que usar `cryptroot-unlock`.
* Cada vez que reinicie el nodo tendremos que usar `cryptroot-unlock`.
# Errores comunes
## No puedo conectarme por SSH después de desbloquear la huerta
## No puedo conectarme por SSH después de desbloquear el nodo
Es posible que tarde unos minutos en terminar de iniciar y reconectar
a la huerta. Si después de 5 minutos no es posible ingresar a la huerta
al nodo. Si después de 5 minutos no es posible ingresar al nodo
or `ssh`, reportar el problema.
## No hay conexión a la huerta a través del proxy
* Chequear que el archivo `/tmp/comun.dot` en el proxy contenga el
nombre de la huerta.
* Chequear que la interfaz `comun` en la huerta tenga asignada una IP en
el rango `10.13.12.0/24`:
```sh
ip address show comun
```
* Chequear que `netplan` no esté gestionando la interfaz:
```sh
netplan status
```
Si dice que la interfaz `comun` está _unmanaged_, quiere decir que
tenemos que correr nuestro propio cliente dhcp.
Si la red empieza a funcionar con `dhcpcd comun`, por favor reportar
el error.