forked from escuela-comun/huerta-init
fix: readme
This commit is contained in:
73
README.md
73
README.md
@ -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.
|
||||
|
||||
Reference in New Issue
Block a user