Instalación de Portainer en Raspberry Pi

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:
```
sudo apt update
sudo apt upgrade -y
```
Instale Docker usando el script oficial:
```
curl -sSL https://get.docker.com | sh
```
Después de la instalación, agregue el usuario actual al grupo Docker para permitir la ejecución de los comandos Docker sin sudo:
```
sudo usermod -aG docker ${USER}
```
Reinicie la Raspberry Pi para aplicar los cambios:
```
sudo reboot
```
Verifique que Docker esté instalado correctamente:
```
docker --version
```

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:
```
docker pull portainer/portainer-ce
```
Crear y ejecutar un contenedor de Portainer:
```
docker volume create portainer_data
docker run -d -p 9000:9000 -p 9443:9443 --name portainer --restart always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce
```
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).
Detener y reiniciar Portainer: Para detener Portainer, ejecute:
```
docker stop portainer
```
Para reiniciar Portainer, ejecute:
```
docker restart portainer
```
Eliminar Portainer: Si desea eliminar Portainer, deténgase y retire el contenedor:
```
docker stop portainer
docker rm portainer
```
Opcionalmente, también puede eliminar el volumen de Docker:
```
docker volume rm portainer_data
```

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:
```
docker logs portainer
```
Sin acceso a Docker: Asegúrese de que su usuario sea parte del grupo Docker:
```
sudo usermod -aG docker ${USER}
sudo reboot
```

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.