Actualizaciones:

  • 2022-10-22: Se cambia el puerto 9000 por el 9443 ya que ahora Portainer CE utiliza HTTPS.
  • 2022-12-03: Se actualizan algunos enlaces a recursos que han cambiado su ubicación o ya no están disponibles.

Instalación

Portainer CE es una herramienta de código abierto que ayuda a crear, administrar y mantener entornos de contenedores sin la necesidad de conocer comandos o sintaxis complejas.

Portainer está formado por dos elementos, Portainer Server y Portainer Agent, que se ejecutan en un contenedor Docker ligero.

La instalación de Portainer CE en un entorno Docker es bastante sencilla usando el comando docker run:

docker run -d \
  -p 9443:9443 \
  --name=portainer-ce \
  --restart=unless-stopped \
  -v /etc/localtime:/etc/localtime:ro \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v ~/volumes/portainer-ce:/data \
  portainer/portainer-ce:latest

Nota: También será necesario exponer un servidor de túnel TCP a través del puerto 8000 (-p 8000:8000) si se planea utilizar las funciones de Edge Compute.

Configuración

Una vez en marcha, se puede acceder a Portainer a través del puerto 9443 (en este ejemplo https://192.168.1.180:9443) y realizar una configuración inicial básica:

  • Usuario administrador: admin
  • Contraseña: **********
  • No marcar la opción para recoger estadísticas anónimas
  • Crear el usuario
  • Conectar con el entorno local Docker

Nota: Portainer genera y utiliza un certificado SSL autofirmado para proteger el puerto 9443. Podemos proporcionar nuestro propio certificado SSL durante la instalación o a través de la interfaz de usuario una vez completada la instalación.

Una vez hecho ésto, se puede leer la documentación “Using Portainer” para conocer todo lo que puede hacer con esta aplicación:

Usando docker-compose

Otra alternativa para instalar Portainer es utilizar el comando docker-compose. Para ello se genera un fichero docker-compose.yml con el siguiente contenido:

version: '3'
services:
  portainer-ce:
    image: portainer/portainer-ce:latest
    container_name: portainer-ce
    volumes:
    - /etc/localtime:/etc/localtime:ro
    - /var/run/docker.sock:/var/run/docker.sock
    - ~/volumes/portainer-ce:/data
    ports:
    - 9443:9443
    restart: unless-stopped

Nota: En la configuración anterior se ha utilizado un Host Volume, es decir, un directorio de la máquina host donde quedará guardada la configuración de Portainer si se destruye el contenedor.

Para iniciar el contenedor, únicamente hay que ejecutar el comando docker-compose up -d.

Actualizar

Nota: Antes de actualizar Portainer, es recomendable descargar una copia de seguridad de la configuración accediendo a Settings → Backup Portainer → Download backup file.

Si ya se había instalado Portainer anteriormente, se puede actualizar de la siguiente manera:

cd ~/dockers/portainer-ce
docker stop portainer-ce
docker rm portainer-ce
docker rmi portainer/portainer-ce
docker-compose up -d

Soporte

Algunos comandos para gestionar la configuración del contenedor:

# Monitorizar los logs del contenedor en tiempo real
docker logs -f portainer-ce

Referencias