files/ssh | ||
group_vars | ||
roles | ||
tasks | ||
.gitignore | ||
.gitmodules | ||
abyayala.yml | ||
ansible.cfg | ||
deploy.yml | ||
hosts.local | ||
hosts.production | ||
README.md |
QUÉ | CHEM |
Es un programa para para mantener una infraestructura como código.
Por ahora, solo diremos que es un comando en la terminal.
Que mantiene un anillo de servicios interoperando. Pero en un solo comando. -- one ring to rule'm all...
Con
ansible-playbook
Y especificando un par de parámetros, que se detallan más abajo, se ejecutan todos los demás comandos necesarios para crear un nodo en la red llamada Abyaya.la
En realidad, a medida que se adentren en el juego, verán que hay un par de recetas más. Recetas, playbooks, script. Son todas infusiones que hacen bailar tods lxs enanites.
Hay un archivo en especial que define est despliegue de interfaces virtuales disponibles por URLs en que consiste abyayala.yml
Abyayala.yml
Es un archivo YAML (Yet Another Markup Lang., como una especie de XML) en donde se define declarativamente la infraestructura del Proxy Nginx conectado con un VPN (Red Autónoma Pirata)
La RAP tiene capacidad de DHCP en una red.comun para circumnavegar redes privativas que puedan tener NAT, no permitir Port Forwarding, aplicar Firewalls y todas esas chingaderas nasty
EL proxy tiene capacidad DE SSL/TLS con Let's Encrypt de la E.F.F. El certbot tiene capacidad wildcard *.subm.abyaya.la validando por registros DNS.
Cómo probarlo
En consecuencia, el resultado de esto debiera ser (sic)administrar una red de servidoras en una VPN comun, por ende la maquina nebe poder resolver su nombre por ej. su.comun y a otrx.comun como IPv4 en el rango 10.13.12.1/24 y pingearse, o al menos a abyayala.comun que es el server ?)
Además, debe existir el subdominio DNS **node.**abyaya.la en el cual cada node puede publicar sus servicios en internet. Estos son accesibles a través de SSL/DNS en un sub-sub-domain. Por ej. https://sitio.node.abyaya.la y convivir como vástagxs con una nube en https://nube.node.abyaya.la
Los servidores DNS los provee Sutty, infraestructura autonoma de Argentina quienes ademas cuentan con redundancia y mas.
P.S:
Lo que está resaltado así es código fuente
¿Sería dificil, mas no imposible, la realización de trabajos semejantes en la selva Amazónica?)
REQUISITOS DE INSTALACIÓN
Deben tener Ansible. Si tienen Python (sí, tienen), se puede instalar por pip
$ pip install ansible
También deben tener sus llaves públicas de SSH añadidas tanto al nodo como al servidor de destino.
Si despliegan a localhost es posible que necesiten añadir su llave de SSH a su propia máquina, para auto-conectarse por SSH (Sí, se puede).
DISPOSITIVOS DE DESARROLLO
En realidad recomendaríamos mantener en mente que son dos dispositivos, la torre de control (su laptop), que da órdenes a la otra node que está configurando.
En desarrollo se puede emular con máquinas virtuales a las cuales configura su laptop. O se puede invocar directamente sobre un juguete para animarlo de vida.
CÓMO SE USA | HOWTO |
DESPLIEGUE DE LA RAP
Esta se hace en dos partes, pues hay que configurarlo primero en el nodo de destino y después en el servidor del proxy.
RAP en el nodo
Para desplegar la RAP en nuestro nodo destino, utilizamos el script tasks/rap.yml especificando sus paráemtros en -e "..."
ansible-playbook --become tasks/rap.yml -e "nodo=chem host=rakiduam"
En donde:
- host: es el nodo a configurar, según su definición en el inventario de ansible
- nodo: es el nombre que le daremos, el cual debe coincidir con el que desplegamos en el proxy más arriba
En este ejemplo, intentamos convertir nuestro localhost en un nodo
ansible-playbook --become tasks/rap.yml -e "host=localhost nodo=chem" -i hosts.local
RAP en el proxy
El proxy también se define en el archivo abyayala.yml en el server_name: vpn En la lista de nodos mantenemos los nodos autorizados para conectarse a la RAP
- service_name: vpn
roles:
- rap
nodos:
- marmite
- chemka
Luego podemos volver a ejcutar el primer comando deploy de este manual. O si queremos ejecutar solamente la RAP utilizaremos el parámetro service, como se explica más arriba
ansible-playbook deploy.yml -e "host=abyayala alt=abyayala service=vpn" --skip-tags=installation,proxy,rap
En este ejemplo, estamos salteando la parte de instalación para mayor velocidad y el proxy pues solamente queremos actualizar la VPN. Además, estamos salteando un paso específico, porque no queremos pisar configuraciones locales de la RAP
DESPLIEGUE SIMULTANEO DEL PROXY CON HTTPS Y DEL DNS
Cada nodo debe tener una entrada en el archivo abyayala.yml de esta forma:
- service_name: chem
domains:
- 2012K.abyaya.la
nodo: ka.comun
ssl: yes
Donde
- service_name: es un nombre arbitrario
- domains: la unica entrada de domains es el subdominio principal
- nodo: es el hostname del nodo en la RAP
- ssl: habilita la conexión SSL/TLS en ese dominio y sus subdominios
- force_https: igual al parámetro anterior, pero fuerza la conexión segura (no permitiendo http plano)
Luego, ejecutamos el comando deploy especificando en -e "..." sus parámetros
ansible-playbook deploy.yml -e "alt=abyayala host=hetzner"
Los parámetros obligatorios son:
- alt: nombre de nuestro servidor autonomo, en este caso siempre es 'abyayala'
- host: nombre del servidor de destino en el archivo de inventario hosts.production
Los parámetros opcionales pueden ser:
- service: limita al despliegie a un servicio específico, en lugar de actualizar todos
También podemos utilizar parámetros de ansible, por ejemplo
ansible-playbook deploy.yml -e "alt=abyayala host=hetzner" --skip-tags=installation,proxy
Saltea dos partes del proceso, marcadas por tags. En este ejemplo, la instalación y la actualización de Nginx
DEPLOY LOCAL
Para desarrollo, podemos desplegar en nuestro localhost así
ansible-playbook --become deploy.yml -e "host=localhost alt=abyayala" -i hosts.local