[AI Router] Comprender Docker, Image, Container y Portainer con el ejemplo de AdGuard Home

Has instalado correctamente AdGuard Home. Ahora, vamos a usar este ejemplo para comprender rápidamente cómo funcionan Docker y Portainer en tu AI Board. Esto no trata solo de [cómo hacerlo], sino también de [por qué funciona de esta manera].

 

 

1. ¿Qué sucede cuando haces clic en Instalar para AdGuard Home?

    Cuando haces clic en el botón [Instalar] para AdGuard Home en tu AI Board, el sistema automáticamente:

  1. Verifica si la imagen de AdGuard Home ya existe localmente. Si no, la descarga desde Docker Hub.
  2. Utiliza la imagen para crear un nuevo contenedor, asigna recursos y le da un nombre (como adguardhome).
  3. Crea un volumen y lo monta en la ruta especificada del contenedor, asegurando que tus configuraciones y datos persistan incluso después de un reinicio.
  4. Configura la red y el mapeo de puertos para que puedas acceder a AdGuard Home en http://<IP del AI Board>:3000.
  5. Inicia el contenedor y monitoriza su estado.

    Todo esto ocurre automáticamente después de que hagas clic en [Instalar].

 

2. Visualizando AdGuard Home en Portainer

    Portainer es una herramienta de administración de Docker basada en la web que te permite gestionar fácilmente contenedores, imágenes y volúmenes desde tu navegador.

    Inicia sesión en Portainer: Puedes acceder a Portainer desde la interfaz de usuario del AI Board, o directamente mediante URL (normalmente https://<el nombre de host de tu AI Board>:9443)。

    Después de iniciar sesión, haz clic en el panel de control para entrar a la interfaz de administración.

 

    Página de contenedores:

  • Haz clic en [Contenedores] en el menú de la izquierda para ver todos los contenedores en ejecución. AdGuard Home normalmente se llama adguardhome.
  • Haz clic en el nombre del contenedor para ver su estado, registros y uso de recursos. También puedes iniciarlo, detenerlo o reiniciarlo aquí.

 

 

    Página de imágenes:

  • Haz clic en [Imágenes] para ver todas las imágenes descargadas, incluyendo AdGuard Home.

 

    Página de volúmenes:

  • Haz clic en [Volúmenes] para ver todo el almacenamiento persistente. Busca el volumen relacionado con AdGuard Home—ahí es donde se almacenan tus configuraciones y datos.

 

3. ¿Qué son Docker, Imagen, Contenedor y Portainer?

  • Docker: Una plataforma que te permite ejecutar aplicaciones en entornos aislados (contenedores), haciendo que el despliegue y la gestión del software sean sencillos y consistentes. Con Docker en AI Board, puedes instalar varias aplicaciones (como AdGuard Home, HomeAssistant) en tu router, cada una funcionando de manera independiente.
  • Docker Hub: Docker Hub es un repositorio de imágenes en línea donde puedes buscar y descargar imágenes listas para usar. Puedes instalarlas con unos pocos comandos o mediante Portainer.
  • Imagen: El plano de una aplicación, que contiene todo el código y las bibliotecas necesarias para ejecutarla. Las imágenes son estáticas e inalterables; solo cuando las inicias se convierten en contenedores. Puedes crear varios contenedores a partir de la misma imagen.
  • Contenedor: La instancia en ejecución de una imagen (un mini servidor). Cada contenedor tiene su propio entorno, configuración y recursos. Eliminar un contenedor no afecta la imagen, y siempre puedes recrearlo. Para datos persistentes, los contenedores usan volúmenes.
  • Volumen: Almacena datos que deben persistir (como configuraciones o bases de datos) incluso si el contenedor se elimina o se recrea.
  • Portainer: Una herramienta gráfica de gestión para Docker, que te permite ver, controlar y solucionar problemas de contenedores, imágenes y volúmenes a través de una interfaz web.

 

4. ¿Cómo se relacionan?

  • Descarga o crea una imagen ([plano])
  • Usa Docker para iniciar un contenedor ([mini servidor])
  • El contenedor utiliza un volumen ([almacén]) para guardar datos importantes
  • Portainer te ayuda a gestionar todo visualmente

 

5. Una analogía de la vida real

    Imagina que tienes una panadería

  • La imagen es tu receta de pastel, que lista todos los pasos e ingredientes.
  • El contenedor es un pastel que horneas a partir de la receta; puedes hornear muchos pasteles.
  • El volumen es como un cuaderno, donde guardas los ajustes especiales de cada pastel y las preferencias de los clientes, para no perderlos aunque hornees un pastel nuevo.
  • Docker es tu cocina, asegurando que cada pastel se hornee en su propia estación de trabajo, siguiendo el proceso estándar.
  • Portainer es el panel de control de tu panadería, mostrándote qué pasteles se están horneando, qué recetas tienes y dónde están guardadas tus notas.

 

6. Práctica

    Cuanto más uses Portainer, más rápido dominarás la flexibilidad de Docker. Aquí tienes algunos ejercicios sugeridos:

  • Ve a la página de Contenedores, selecciona adguardhome, haz clic en Eliminar para borrar el contenedor, luego usa Docker Compose YAML para crear uno nuevo. No te preocupes—recrear un contenedor es rápido. Inténtalo varias veces para familiarizarte con el proceso.

  • Ve a la página de Stack, crea una nueva Stack, pega el YAML de Docker Compose de AdGuard Home y despliega un nuevo contenedor.

  • Introduce adguardhome en el campo Nombre.

  • Pega el siguiente YAML y haz clic en Desplegar la stack.

 

versión: "3.8"
servicios:
   adguardhome:
        imagen: adguard/adguardhome:última
        nombre_del_contenedor: adguardhome
        reiniciar: a menos que-detenido
        modo_de_red: "anfitrión"
        entorno:
             # Definir el puerto predeterminado de la interfaz web
          - ADGUARD_HOME_DEFAULT_WEB_PORT=3000
        volúmenes:
          - adgh_work:/opt/adguardhome/work
          -adgh_conf:/opt/adguardhome/conf
          - /etc/hosts:/etc/hosts:ro
volúmenes:
   adgh_trabajo:
   adgh_conf:
  • Una vez terminado, verás el nuevo contenedor de AdGuard Home creado.

 

 

 

 

¿Cómo obtener la (Utilidad / Firmware)?

Puedes descargar los drivers, software, firmware y manuales de usuario más recientes en el Centro de Descargas de ASUS.

Si necesitas más información sobre el Centro de Descargas de ASUS, por favor consulta este enlace.