Portainer es una interfaz de usuario de administración ligera para Docker que simplifica el proceso de administración de contenedores Docker. Ofrece una interfaz web intuitiva para implementar, configurar y monitorear contenedores. Esta guía lo guía a través de la instalación y la configuración de Portainer en una Raspberry Pi, lo que le permite administrar contenedores Docker con facilidad.
Lo que necesitarás
- Frambuesa pi (Cualquier modelo con soporte de Docker, por ejemplo, PI 3, Pi 4)
- Raspberry Pi OS Instalado en su Raspberry Pi
- Conexión a Internet para descargar Portainer
- Estibador Instalado en su Raspberry Pi (Portainer requiere Docker para ejecutar)
Paso 1: Instale Docker en la Raspberry Pi
Si Docker aún no está instalado en su Raspberry Pi, siga estos pasos para instalarlo:
-
Actualizar la lista de paquetes:
-
Instale Docker usando el script oficial:
-
Después de la instalación, agregue el usuario actual al grupo Docker para permitir la ejecución de los comandos Docker sin
sudo
: -
Reinicie la Raspberry Pi para aplicar los cambios:
-
Verifique que Docker esté instalado correctamente:
Paso 2: Instalar Portainer
Ahora que Docker está instalado, puede instalar Portainer como un contenedor Docker.
-
Tire de la imagen de Portainer desde Docker Hub:
-
Crear y ejecutar un contenedor de Portainer:
Esto es lo que hace el comando:
-
-d
: Ejecute el contenedor en modo separado. -
-p 9000:9000
: Exponga la interfaz de usuario web en el puerto 9000. -
-p 9443:9443
: Exponga la interfaz de usuario web con HTTPS en el puerto 9443. -
--name portainer
: Establezca el nombre del contenedor como "Portainer". -
--restart always
: Reinicie automáticamente Portainer en el arranque o si el contenedor se bloquea. -
-v /var/run/docker.sock:/var/run/docker.sock
: Bind Mount Docker Socket para administrar contenedores Docker. -
-v portainer_data:/data
: Monte un volumen para persistir los datos de Portainer.
-
-
Espere a que inicie Portainer, luego abra su navegador web y vaya a:
http://<raspberry_pi_ip>:9000
Reemplazar
<raspberry_pi_ip>
con la dirección IP de su Raspberry Pi.
Paso 3: Configurar Portainer
Cuando accede por primera vez a la interfaz web de Portainer, se le pedirá que cree una cuenta de administrador.
-
Crear una cuenta de administrador:
- Establezca un nombre de usuario y contraseña para la cuenta de administración.
- Haga clic en "Crear usuario" para continuar.
-
Conéctese a Docker:
- Elegir Local Para administrar el entorno local de Docker en su Raspberry Pi.
- Hacer clic Conectar.
Paso 4: Uso de Portainer
Una vez conectado, será llevado al tablero de Portainer, donde puede comenzar a administrar sus contenedores Docker. Puede:
- Ver contenedores en ejecución: Monitoree el estado de todos los contenedores activos.
- Implementar nuevos contenedores: Cree nuevos contenedores Docker desde la interfaz Portainer.
- Administrar volúmenes y redes: Ver y configurar los volúmenes y redes Docker.
- Ver registros y estadísticas: Monitoree los registros y las estadísticas de los contenedores en ejecución.
Paso 5: Administración de Portainer
-
Acceder a Portainer de forma remota:
- Para acceder de forma segura a Portainer de forma remota, puede configurar SSL utilizando un proxy inverso (por ejemplo, NGINX o Traefik) o usar el puerto 9443 para HTTPS (habilitado por el
docker run
comando arriba).
- Para acceder de forma segura a Portainer de forma remota, puede configurar SSL utilizando un proxy inverso (por ejemplo, NGINX o Traefik) o usar el puerto 9443 para HTTPS (habilitado por el
-
Detener y reiniciar Portainer: Para detener Portainer, ejecute:
Para reiniciar Portainer, ejecute:
-
Eliminar Portainer: Si desea eliminar Portainer, deténgase y retire el contenedor:
Opcionalmente, también puede eliminar el volumen de Docker:
Solución de problemas
- Portainer no accesible: Asegúrese de que el firewall de su Raspberry Pi permita el acceso a los puertos 9000 y 9443. Si usa HTTPS, verifique que los certificados SSL se configuren correctamente.
- Docker Container Falling: Verifique los registros de contenedores en busca de errores:
- Sin acceso a Docker: Asegúrese de que su usuario sea parte del grupo Docker:
Conclusión
Portainer simplifica la administración de contenedores Docker en Raspberry Pi al proporcionar una interfaz web fácil de usar. Con solo unos pocos comandos, puede poner en funcionamiento con Docker y Portainer, lo que hace que sea más fácil administrar y monitorear sus contenedores. Ya sea que esté ejecutando sistemas de automatización de inicio, servidores web u otros servicios dockerizados, Portainer es una herramienta invaluable para administrar el entorno Docker de su Raspberry Pi.