Skip to content

Guía para Contribuidores (ES)

Jump to bottom
A Holt edited this page Jun 23, 2025 · 72 revisions

Este documento es una guía paso a paso sobre cómo instalar y conocer el software Internet-in-a-Box (IIAB). ¡Animamos a todos los posibles colaboradores a utilizar esta guía para probar IIAB!

Tequio es el trabajo colectivo que se hace en beneficio de la propia comunidad. -México

📑 Indice

  1. Antes de empezar
  2. Requerimientos
  3. Ejemplos para Empezar
    1. Instalar IIAB en una Raspberry Pi
    2. Instalar IIAB en una laptop o PC antigua
    3. Instalar IIAB en una Máquina Virtual
  4. Comprendiendo Ansible
  5. Compartir Pantalla de Bajo Ancho de Banda
  6. Reportar un Error
  7. Contribuye
  8. Muestra tu apoyo
  9. Agradecimientos

🥽 Antes de empezar

IIAB (Video introductorio) funciona en varios sistemas operativos GNU/Linux como Raspberry Pi OS, Ubuntu, Debian, Linux Mint, Trisquel - y posiblemente también en otras distribuciones Linux, ¡si inviertes el esfuerzo!

Puedes instalar IIAB en Raspberry Pi 3, 3 B+, 4, 400, 5 o en una laptop/PC x86_64. También es posible ejecutar la IIAB en una Raspberry Pi Zero W de $10 o en el Raspberry Pi Zero o la Raspberry Pi Zero 2 W de $15, o bien, si insertas una tarjeta microSD IIAB que funcione.

En hardware similar a PC (x86_64), consulte la sección de hardware de nuestra FAQ(Preguntas frecuentes) para conocer los requisitos de memoria, almacenamiento y red. También considere instalar IIAB en una VM (máquina virtual), por ejemplo, para fines de prueba.

Por favor, evita Docker, ya que nuestro aprovisionamiento de Ansible requiere acceso de bajo nivel al sistema operativo.

En todos los casos, consulta la FAQ.IIAB.IO y los videos tutoriales en el canal de YouTube de Internet-in-a-Box. Además, no te olvides de revisar nuestros próximos lanzamientos en GitHub.

Puedes instalar la última versión de IIAB con sólo una línea: https://download.iiab.io

O si tienes prisa, y tienes una Raspberry Pi a la mano, y no te importa una versión anterior del software, instala una IIAB directamente a una tarjeta SD (que se puede insertar inmediatamente en casi cualquier Raspberry Pi).

Por el contrario, si eres tradicionalista, puedes instalar IIAB paso a paso desde cero.

En cualquier caso: después de instalar el software IIAB, ten paciencia al descargar contenido a través de una conexión a Internet lenta, ¡ya que esto puede tardar varias horas!

🔨 Requerimientos

👷 Ejemplos para Empezar

Para ayudar a los nuevos colaboradores a empezar con IIAB, proporcionamos 3 ejemplos de rutas de instalación a continuación.

(Si es necesario, también son posibles otras plataformas.)

Instalar IIAB en una Raspberry Pi

  1. Instala el sistema operativo de Raspberry, 64-bit Raspberry Pi OS en una tarjeta microSD:
    1. SI TIENES UNA PC, LAPTOP O MAC:
      • Tu laptop, PC o Mac debe tener una ranura incorporada para tarjetas SD, o un lector de tarjetas USB externo (típicamente de $10).
        • Inserte una tarjeta microSD en blanco o nueva.
      • Instala Raspberry Pi Imager 1.8.5+ en tu computadora, después corre el programa.
      • Use las Personalización del SO (Ctrl-Shift-X o en Mac: Command + Shift + X) para preconfigurar su tarjeta microSD:
        1. Habilita SSH.
        2. Establece un nombre de usuario y contraseña.
        3. SI NO TIENE UN CABLE ETHERNET (para conectarse a Internet) PARA SU Raspberry Pi, entonces "Configure la red Wi-Fi" (ingrese un SSID y contraseña de Wi-Fi válidos).
      • Instale el sistema operativo Raspberry Pi OS de 64-bits en su tarjeta microSD:
        1. Click ELEGIR DISPOSITIVO para seleccionar la Raspberry Pi que vas a utilizar.
        2. Click ELEGIR SO (Sistema Operativo) para seleccionar cualquier versión de 64-bits de Raspberry Pi OS.
        3. Click ELEGIR ALMACENAMIENTO para seleccionar la tarjeta microSD donde se guardará la imagen del sistema.
        4. Click SIGUIENTE y, ¡confirmar! Escribir el sistema operativo en su tarjeta microSD tardará unos minutos.
    2. O USE UNA RASPBERRY PI:

      • Su Raspberry Pi DEBE estar conectada a un teclado, un mouse, una pantalla y a Internet a través de un cable Ethernet.

        • Actualiza el gestor de arranque EEPROM de su Raspberry Pi (especialmente si es anterior a 2024).
        • Inserte una tarjeta microSD en blanco o nueva en su Raspberry Pi.

      • Mantenga presionada la tecla SHIFT mientras enciende el Raspberry Pi. En unos 4 minutos, debería aparecer el programa Raspberry Pi Imager 1.8.5+ en la pantalla.

        • OPCIONALMENTE: Puede usar la Personalización del SO (Ctrl-Shift-X o en Mac: Command + Shift + X) para preconfigurar tu tarjeta microSD: (1) Habilite SSH (2) Establecer nombre de usuario y contraseña.

      • Instale el sistema operativo Raspberry Pi OS de 64-bits en su tarjeta microSD:

        1. Click ELEGIR DISPOSITIVO para seleccionar la Raspberry Pi que vas a utilizar.
        2. Click ELEGIR SO (Sistema Operativo) para seleccionar cualquier versión de 64-bits de Raspberry Pi OS.
        3. Click ELEGIR ALMACENAMIENTO para seleccionar la tarjeta microSD donde se guardará la imagen del sistema.
        4. Click SIGUIENTE y, ¡confirmar! Escribir el sistema operativo en su tarjeta microSD tardará unos minutos.

      • Reinicie para iniciar el sistema operativo y vaya al paso 4.

  2. Inserte la tarjeta microSD en el Raspberry Pi y enciéndelo.
  3. Conecta tu Raspberry Pi a Internet, preferiblemente usando un cable Ethernet, para evitar confusiones durante la creación del punto de acceso Wi-Fi interno de IIAB.
    • Si no es posible usar un cable Ethernet, utiliza Wi-Fi (para conectar tu Raspberry Pi a Internet).
    • Si tu Raspberry Pi es "headless", averigua su dirección IP (e.j. en la red de tu hogar) para poder conectarte a él mediante SSH. Por lo general, es 192.168.0.x — Utiliza la guía oficial de Raspberry Pi "Encuentra la dirección IP de tu Raspberry Pi [IIAB]". (También puedes consultar las instrucciones de Ubuntu para determinar la dirección IP de la Raspberry.)
  4. Abre una Terminal en el Raspberry Pi, usando una pantalla conectada o una conexión remota (e.j. ssh username@192.168.0.x), para ejecutar estos comandos:
    1. Asegúrate de estar conectado a Internet. Para verificar, ejecuta: ping mit.edu
    2. Ejecuta lo siguiente para instalar IIAB: curl iiab.io/install.txt | bash
    3. ¡Sigue las instrucciones en pantalla cuidadosamente! Lee "What services (IIAB apps) are suggested during installation?" si quieres saber más sobre (1) instalaciones de IIAB SMALL, (2) MEDIUM y (3) LARGE.
    4. La Raspberry Pi podría reiniciarse en los primeros minutos, después de aplicar actualizaciones del sistema y de seguridad.
    5. Ejecuta sudo iiab tantas veces como sea necesario, hasta que se complete. Puede tardar 15 minutos, o incluso una hora o más, dependiendo del CPU, el ancho de banda, el disco, la temperatura y cómo lo hayas configurado /etc/iiab/local_vars.yml
    6. Finalmente, cuando veas "INTERNET-IN-A-BOX (IIAB) SOFTWARE INSTALL IS COMPLETE", fotografía las instrucciones. Ver también: Encuentra la dirección IP de tu Raspberry Pi [IIAB]
    7. Reinicia tu IIAB (Raspberry Pi).
  5. Navegue a la dirección IP mencionada anteriormente de su IIAB (o intente http://box.lan). ¡Explora e instala contenido en su IIAB!

Instalar IIAB en una laptop o PC antigua

  1. La mayoría de las laptops o PC de la última década deberían funcionar (verifica que su CPU sea x86_64, también conocida como amd64).
  2. Instala el último Ubuntu Desktop, Ubuntu Server, Linux Mint, Debian (amd64) o Trisquel en la laptop o PC.
  3. Abre una Terminal en la laptop/PC para ejecutar estos comandos:
    1. Asegúrate de estar conectado a Internet. Para verificar, ejecuta: ping mit.edu
    2. Ejecuta lo siguiente para instalar IIAB: curl iiab.io/install.txt | bash
    3. ¡Sigue las instrucciones en pantalla cuidadosamente! Lee "What services (IIAB apps) are suggested during installation?" si quieres saber más sobre (1) instalaciones de IIAB SMALL, (2) MEDIUM y (3) LARGE.
    4. Tu laptop o PC podría reiniciarse en los primeros minutos, después de aplicar actualizaciones del sistema y de seguridad.
    5. Ejecuta sudo iiab tantas veces como sea necesario, hasta que se complete. Puede tardar 15 minutos, o incluso una hora o más, dependiendo del CPU, el ancho de banda, el disco y cómo lo hayas configurado /etc/iiab/local_vars.yml
    6. Finalmente, cuando veas "INTERNET-IN-A-BOX (IIAB) SOFTWARE INSTALL IS COMPLETE", fotografía las instrucciones. Ver también: Encuentra la dirección IP de tu Raspberry Pi [IIAB] (¡incluso si tu IIAB no es una Raspberry Pi!)
    7. Reinicia tu IIAB (laptop o PC).
  4. Navegue a la dirección IP mencionada anteriormente de su IIAB (o intente http://box.lan). ¡Explora e instala contenido en su IIAB!

Instalar IIAB en una Máquina Virtual

  1. Ambos métodos de VM (máquina virtual) funcionan bien en Linux, Windows Pro y Mac: (en Windows Home, prueba VirtualBox)
    • Instala Multipass para empezar rápidamente:
      • Crear un Servidor Ubuntu 24.04 VM:
        • En Linux: Configura una VM básica, ejecutando multipass launch -n box -c 2 -m 2G -d 25G O si quieres que tu VM también obtenga una dirección IP como 192.168.0.x de tu router doméstico, ten cuidado con canonical/multipass#2537 y ejecuta estos 2 comandos como root ANTES de crear o lanzar la VM: snap install lxd luego multipass set local.driver=lxd. Si es así, confirma que la interfaz de puerta de enlace de tu PC es enp1s0 ejecutando multipass networks, y finalmente crea la VM ejecutando: multipass launch -n box -c 2 -m 2G -d 25G --network enp1s0
        • En Windows Pro: Configura una VM básica, ejecutando multipass launch -n box -c 2 -m 2G -d 25G (conseguir que tu VM también tenga una dirección IP como 192.168.0.x desde tu router doméstico es complicado en Windows, pero si quieres intentarlo: ejecuta multipass networks y lee canonical/multipass#2500) EN CUALQUIER CASO: Mantén la VM llamada box en Windows, ¡para simplificar tu vida! ¿Por qué? A partir de 2025, Multipass todavía requiere que /etc/hostname (dentro de cualquier VM en Windows) no cambiar el nombre original de la VM (#255, #3346), de lo contrario, ¡la VM nunca podrá reiniciarse!
        • En Mac: Confirma que tu interfaz de puerta de enlace es en0 (e.j. ejecutando multipass networks) y si es así, crea la VM ejecutando multipass launch -n box -c 2 -m 2G -d 25G --network en0 (tu VM también debería obtener una dirección IP como 192.168.0.x de tu router doméstico).
      • Ejecuta multipass shell box para acceder a la VM que acabas de crear a través de la línea de comandos.
      • ¡Salta al Paso 2. a continuación!
    • O instala VirtualBox:
      • Descarga e instala una Máquina Virtual (VM) que contenga una versión muy reciente de Ubuntu, Debian, Mint, o Trisquel, e.j. desde el sitio web de Imágenes de Linux. O crea tu propia VM instalando de nuevo un sistema operativo apropiado, recordando:
        • Utiliza VirtualBox para configurar la Red de la VM > Adaptador 1 > Habilitar Adaptador de Red > Conectado a: Adaptador Puenteado, para que otros dispositivos en tu hogar u oficina puedan navegar por este IIAB (como paso final a continuación).
        • Utiliza VirtualBox para configurar el Sistema de la VM > Procesador > Procesador(es): 2 si deseas que tu VM se reinicie de manera más confiable.
        • En Mac: Puede que tengas que abrir Preferencias del Sistema > Seguridad y Privacidad > hacer clic en el candado para permitir la instalación de VirtualBox. Sigue las instrucciones en pantalla para actualizar los privilegios de la aplicación durante la instalación.
      • Utiliza VirtualBox para encender (iniciar) la VM.
  2. En la línea de comandos de la VM en ejecución (abre una Terminal si es necesario) ejecuta estos comandos:
    1. Asegúrate de estar en línea. Para verificar, ejecuta: ping mit.edu
    2. Ejecuta esto para instalar IIAB: curl iiab.io/install.txt | bash
    3. ¡Sigue las instrucciones en pantalla cuidadosamente! Lee "What services (IIAB apps) are suggested during installation?" si quieres saber más sobre (1) instalaciones de IIAB SMALL, (2) MEDIUM y (3) LARGE.
    4. Es posible que la VM se reinicie en los primeros minutos después de aplicar las actualizaciones del sistema y de seguridad.
    5. Ejecuta sudo iiab tantas veces como sea necesario, hasta que se complete. Puede tardar 15 minutos o más de una hora, dependiendo de la CPU/ancho de banda/disco y de cómo haya configurado /etc/iiab/local_vars.yml
    6. Finalmente, cuando vea "INTERNET-IN-A-BOX (IIAB) SOFTWARE INSTALL IS COMPLETE", fotografíe las instrucciones. Consulte también: Encuentre la dirección IP de su Raspberry Pi [IIAB] (¡incluso si tu IIAB no es una Raspberry Pi!)
    7. Reinicia tu IIAB (VM).
  3. Navegue a la dirección IP mencionada anteriormente de su IIAB (o intente http://box.lan). ¡Explora e instala contenido en su IIAB!

🕵️‍♀️ Comprendiendo Ansible

IIAB utiliza Ansible (ES) para instalar y configurar todos los paquetes de software. Ansible utiliza playbooks (a partir de ahora los llamaremos roles) como archivos de instrucciones legibles por humanos, en formato YAML. Un ejemplo de rol de IIAB es 1-prep (Etapa 1) aquí:

├── roles
│   ├── 1-prep
│   │   ├── defaults
│   │   │   └── main.yml (Variables de Rol, también se puede definir en: /opt/iiab/iiab/vars/default_vars.yml, y sobreescrito por /etc/iiab/local_vars.yml)
│   │   ├── README.adoc
│   │   ├── tasks
│   │   │   ├── main.yml (acciones [Módulos de Ansible] que instalan este rol)
│   │   │   └── ...
│   │   └── templates
│   │       ├── iiab.env.j2 (o cualquier archivo de texto, que utilice plantillas Jinja2 e.j. {% <variable> %}, para reemplazar los valores de las variables de Ansible)
│   │       └── ...
│   ├── 2-common
│   │   ├── README.adoc
│   │   ├── tasks
│   │   └── templates

Ansible instala IIAB en etapas, empezando por la inicialización (0-init), luego las etapas 1 a 9, y finalmente (¡a menos que le pidas que no lo haga!) configura la red:

Haz clic en las 10 Etapas y el rol de red de arriba para obtener descripciones de sus propósitos específicos.

En resumen, Ansible recopila información del sistema (utilizando facts) de Ansible, para establecer variables de Ansible, que guían el proceso de instalación de software de IIAB. La ejecución sigue una secuencia de pasos en cascada:

  1. El script bash ./iiab-install (en /opt/iiab/iiab) utiliza Ansible para ejecutar /opt/iiab/iiab/iiab-stages.yml

  2. iiab-stages.yml llama a 9+ etapas (estos son los directorios numerados anteriores, en /opt/iiab/iiab/roles) y luego el rol de red.Evita repetir las 9 etapas principales de instalación (en caso de problemas de Internet, etc.) utilizando un contador en ("STAGE") /etc/iiab/iiab.env (Aparte: la network el rol también se puede ejecutar más tarde usando ./iiab-network)

  3. Cada etapa tiene un <role>/tasks/main.yml para invocar todos los roles y tareas necesarios.

Por favor, consulte las páginas de Arquitectura de IIAB y Variables de IIAB para más detalles.

Por favor, también revise "¿Qué es Ansible y qué versión debería usar?" en las Preguntas Frecuentes.

Para conocer más detalles sobre cómo IIAB instala la última versión de Ansible, consulte: /opt/iiab/iiab/scripts/ansible

🧑‍💻 Compartir Pantalla de Bajo Ancho de Banda

¡La colaboración en vivo con países en vías de desarrollo a través de conexiones con bajo ancho de banda es posible!

Todos podrán escribir simultáneamente en la misma Terminal Linux (command-line interface).

Instrucciones:

  1. Invita personas a ssh tu Internet-in-a-Box (IIAB). i. Para simplificarlo, pide a cada persona iniciar sesión en la misma cuenta, e.j. username iiab-admin. ii. Puedes recordar a todos los que ya han iniciado sesión en tu IIAB, ejecutando:
    sudo wall "¡Hola a todos! Recuerden iniciar sesión como username iiab-admin"

  2. El comando screen debería estar ya instalado. Pero si no es así, ejecuta: sudo apt install screen

    • Más tarde podrías considerar las características más avanzadas de tmux y/o byobu.

  3. Ejecuta screen -ls para ver si alguien más ya ha iniciado una sesión de pantalla:

    • Si ves "There is a screen on:", entonces ejecuta screen -x para unirte a una sesión de pantalla preexistente.
    • Si NO ves "There is a screen on:", entonces eres la primera persona en llegar, así que ejecuta screen para iniciar una sesión de pantalla para todos.

  4. ¡Todos los que estén conectados ahora pueden escribir y ejecutar comandos juntos!

  5. Escribe Ctrl-a ? para obtener ayuda. Si deseas la compleción de tabulador durante futuras sesiones de pantalla, ejecuta: echo "defshell -bash" >> ~/.screenrc

  6. Si quieres terminar la sesión para todos, escribe: exit

  7. Opcional: consejos avanzados.

:bowtie: Reporta un Error

Por favor, publica informes de errores y solicitudes de funciones en GitHub aquí:

https://github.com/iiab/iiab/issues (Da clic en New issue)

🧑‍🔧 Contribuye

¡Tus contribuciones, informes de campo y solicitudes de funciones son BIENVENIDAS!

Consulta también "How can I help?" en FAQ.IIAB.IO y considera contactarnos directamente. ¡Gracias!

👐 Muestra tu apoyo

¡Dale una ⭐ (Sobre el URL https://github.com/iiab/iiab) si te gusta este proyecto!

Agradecimientos

Profundo agradecimiento a Arky quien inspiró y escribió la Guía para Contribuidores de IIAB original en 2017.

Clone this wiki locally