Saltar al pie de página
USANDO IRONSECUREDOC

Cómo instalar Portainer (Tutorial para desarrolladores)

¿Qué es Portainer ?

Portainer es una plataforma de código abierto y ligera que simplifica la gestión de aplicaciones en contenedores que se ejecutan en Docker, Kubernetes y otros entornos para la orquestación de contenedores. El objetivo principal de Portainer es proporcionar una interfaz gráfica para gestionar contenedores Docker y grupos Docker, haciéndolo fácil de usar y liberando al administrador del sistema o desarrollador de la complejidad de gestionar los contenedores a través de la línea de comandos. Los desarrolladores y administradores del sistema pueden lograr todo esto a través de un tablero basado en la web que monitorea, implementa y gestiona contenedores, redes, imágenes y volúmenes en Portainer.

Portainer apoya entornos de un solo nodo y multienodo, como Docker Swarm, clústeres Kubernetes y entornos Nomad. Sus funcionalidades incluyen la gestión del ciclo de vida de los contenedores (inicio/parada/eliminación), el monitoreo de recursos, el acceso a registros y el control de acceso basado en roles para manejar entornos multiusuario de forma fácil y segura. También proporciona integración nativa tanto para Docker Compose como para los manifiestos de Kubernetes para habilitar fácilmente el despliegue de aplicaciones de múltiples contenedores.

Tiene un valor real para los administradores que necesitan mayor visibilidad y control sobre su infraestructura, especialmente en un entorno de producción. Es fácil de adoptar entre nuevos usuarios y es popular para pequeños equipos y grandes empresas que requieren un método eficiente y simplificado de gestión de contenedores y orquestación de aplicaciones complejas.

Características de Portainer

Portainer proporciona características que hacen más fácil operar aplicaciones en contenedores. Algunas características significativas son las siguientes:

1. Interfaz web fácil de usar

La interfaz de usuario de Portainer ofrece un GUI basado en la web fácil de usar que asegura que todo lo relacionado con la gestión de un contenedor, red, volumen e imágenes se implemente con menos dependencia de la línea de comandos.

2. Soporte multiplataforma

Soporta múltiples plataformas:

  • Docker: Portainer gestiona un entorno de un solo host o un entorno Docker Swarm.
  • Kubernetes: Gestiona clústeres y cargas de trabajo de Kubernetes.
  • Nomad: Portainer ofrece capacidades de integración para el orquestador HashiCorp Nomad.

3. Gestión del ciclo de vida de los contenedores

Permite varias operaciones, como inicio, detención, reinicio, pausa y eliminación de un contenedor.

4. Gestión de imágenes

Extrae imágenes de registros y gestiona repositorios de imágenes locales. También elimina imágenes no utilizadas e integra con registros Docker privados.

5. Gestión de pilas

Permite la implementación y gestión de aplicaciones de múltiples contenedores utilizando Docker Compose o manifiestos de Kubernetes, también conocidos como gráficos Helm para Kubernetes.

6. Gestión de volumen y red

Simplifica la creación, gestión y eliminación de contenedores Docker, volúmenes y redes. Tienes control total sobre tus datos persistentes y configuraciones de red.

7. Control de acceso basado en roles (RBAC)

Controla el acceso y los permisos para diferentes usuarios en el entorno, proporcionando un control detallado sobre quién puede hacer qué.

8. Registros y monitoreo

Proporciona registros de contenedores en tiempo real y métricas de rendimiento, como el uso de CPU y memoria, para ayudar a monitorear y depurar.

9. Plantillas y catálogo de aplicaciones

Ofrece plantillas de aplicaciones predefinidas que simplifican el despliegue de servicios o aplicaciones comunes.

10. Autenticación externa

Soporta dos tipos de sistemas de autenticación, basados en LDAP y OAuth, que fortalecen la seguridad y proporcionan una integración sólida con entornos corporativos.

11. Copia de seguridad y restauración

Permite la capacidad de hacer copias de seguridad y restaurar la configuración y entornos de Portainer para garantizar un proceso de recuperación en caso de fallos.

12. Acceso a la API

Permite el control programático y la integración de herramientas externas a través de una API con todas las funciones.

Estas características hacen que Portainer sea excelente para los administradores de aplicaciones en contenedores que trabajan en entornos de desarrollo, pruebas o producción, adecuado tanto para principiantes como para expertos.

Instalar Portainer

Portainer consta de dos componentes principales: el Servidor Portainer y el Agente Portainer. Estos son contenedores Docker extremadamente ligeros que se ejecutan en un motor Docker. Aquí, te guiaremos a través de los pasos para instalar un contenedor del Servidor Portainer dentro de tu entorno de Windows con WSL y Docker Desktop ya instalados.

Requisitos

  • Tener Docker y la última versión de Docker Desktop instalado.
  • Acceso administrativo a la máquina para alojar tu instancia del Servidor Portainer.
  • WSL2 y una distribución de Linux instalada y activada. Asegúrate de que WSL2 esté instalado antes de instalar una distribución de Linux.
  • Por defecto, el Servidor Portainer expone la interfaz de usuario a través del puerto 9443 y un servidor de túnel TCP a través del puerto 8000. Este último es necesario solo si estás utilizando las características de Edge compute con agentes Edge.

Pasos para instalar Portainer

Para almacenar la base de datos en el Servidor Portainer, primero crea el volumen:

docker volume create portainer_data
docker volume create portainer_data
SHELL

Luego, usa PowerShell o el Símbolo del sistema con la CLI de Docker para ejecutar el siguiente comando para descargar e instalar, y luego crear el contenedor del Servidor Portainer.

docker run -d -p 8000:8000 -p 9443:9443 --name=portainer --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce:latest
docker run -d -p 8000:8000 -p 9443:9443 --name=portainer --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce:latest
SHELL

Ahora tienes el Servidor Portainer instalado. Puedes determinar si el contenedor del Servidor Portainer está en funcionamiento con este comando:

docker ps
docker ps
SHELL

Iniciar sesión en Portainer

Una vez que la instalación esté completa, accede a tu instancia del Servidor Portainer en un navegador web en https://localhost:9443. Reemplaza localhost con la dirección IP adecuada o FQDN si es necesario y ajusta el puerto si fue cambiado. Se te presentará la página de configuración inicial del Servidor Portainer.

El primer usuario será el administrador. Aunque 'admin' es el inicio de sesión predeterminado, puedes modificarlo. La contraseña debe cumplir con los parámetros especificados y tener una longitud mínima de 12 caracteres. En la página siguiente, ingresa la clave de licencia de la Edición Comunitaria de Portainer que recibiste, pégala en el cuadro correspondiente y luego presiona Enviar.

A continuación, el sistema te redirigirá al tablero de Portainer, donde puedes ver la lista de entornos disponibles en la máquina. Puedes conectarte a contenedores Docker existentes haciendo clic en el botón de conectar.

Haz clic en "Agregar Entornos" para gestionar entornos adicionales con esta instancia de Portainer. De lo contrario, selecciona "Comenzar" para empezar a utilizar Portainer.

¿Qué es IronsecureDoc ?

IronSecureDoc es una herramienta de seguridad para documentos, protegiendo archivos sensibles al proporcionar funciones de cifrado, redacción y firma digital. Permite a los usuarios proteger archivos PDF, asegurando que los datos personales y confidenciales permanezcan protegidos. Las características incluyen protección por contraseña, cumplimiento de estándares como PDF/A y certificación digital. Se utiliza principalmente en los campos legal, sanitario o financiero. El software es accesible como una API REST, integrado en diferentes flujos de trabajo y puede implementarse como un contenedor Docker para soluciones de seguridad escalables y amigables con la nube.

Características de IronSecureDoc

IronSecureDoc maneja la seguridad de PDF y la gestión de documentos de manera impresionante. Sus características incluyen cifrado, redacción y firma digital.

Cifrado: Proporciona cifrado de documentos PDF con cifrado de 128 o 256 bits y seguridad basada en contraseñas para asegurar la confidencialidad de los datos.

Redacción: Elimina datos confidenciales, como identificadores personales u otra información sensible, en cumplimiento con estándares y regulaciones de privacidad.

Firma Digital: Facilita la firma digital y la notarización de PDFs utilizando .pfx o .p12 para autenticar documentos.

Instalar y ejecutar IronsecureDoc

Usa este comando para descargar la imagen de Docker de IronSecureDoc desde el repositorio en una ventana de terminal abierta o Símbolo del sistema.

docker pull ironsoftwareofficial/ironsecuredoc
docker pull ironsoftwareofficial/ironsecuredoc
SHELL

Una vez descargada la imagen de Docker, ejecuta otro comando para iniciar el contenedor de IronSecureDoc:

docker container run --rm -p 8080:8080 -e IronSecureDoc_LicenseKey=<IRONSECUREDOC_LICENSE_KEY> -e ENVIRONMENT=Development -e HTTP_PORTS=8080 ironsoftwareofficial/ironsecuredoc:latest
docker container run --rm -p 8080:8080 -e IronSecureDoc_LicenseKey=<IRONSECUREDOC_LICENSE_KEY> -e ENVIRONMENT=Development -e HTTP_PORTS=8080 ironsoftwareofficial/ironsecuredoc:latest
SHELL

Reemplaza <IRONSECUREDOC_LICENSE_KEY> con tu clave de licencia real de IronSecureDoc.

Uso de IronSecureDoc con un contenedor Docker

Después de la instalación y lanzamiento en Docker, IronSecureDoc puede redactar, certificar y cifrar documentos utilizando su API REST. Consulta los endpoints de la API y la documentación: http://localhost:8080/swagger/index.html.

Aquí hay un ejemplo de cómo enviar un documento para cifrado utilizando una solicitud POST de cURL:

curl -X 'POST' \
  'http://localhost:8080/v1/document-services/pdfs/encrypt?user_password=demo' \
  -H 'accept: */*' \
  -H 'Content-Type: multipart/form-data' \
  -F 'pdf_file=@test.pdf;type=application/pdf'
curl -X 'POST' \
  'http://localhost:8080/v1/document-services/pdfs/encrypt?user_password=demo' \
  -H 'accept: */*' \
  -H 'Content-Type: multipart/form-data' \
  -F 'pdf_file=@test.pdf;type=application/pdf'
SHELL

Este comando envía el documento a IronSecureDoc, que aplica el cifrado especificado.

Conclusión

Portainer e IronSecureDoc son herramientas poderosas para la gestión de contenedores y la gestión segura de documentos, proporcionando un valor significativo en la era moderna de DevOps y TI.

Portainer proporciona una interfaz intuitiva y moderna que simplifica la implementación, monitoreo y escalado de aplicaciones en contenedores en Docker, Kubernetes y otras plataformas de contenedores. Sus extensas características, incluyendo RBAC, registros, gestión de pilas y soporte multiplataforma, lo hacen accesible tanto para pequeños equipos como para grandes corporaciones.

IronSecureDoc se centra en la firma, el cifrado y la seguridad de documentos sensibles y otros activos digitales en un entorno Docker. Busca mejorar la postura de seguridad de una organización, alineándose con los estándares de protección de datos y reduciendo el riesgo.

Estas dos tecnologías permiten a los usuarios gestionar contenedores con asegurada integridad y seguridad de documentos en tales entornos. Portainer e IronSecureDoc son, por lo tanto, cruciales en el paradigma contemporáneo de la nube y el uso de contenedores, gestionando aplicaciones a gran escala y asegurando datos esenciales. Haz clic en este enlace para aprender más sobre las licencias de IronSecureDoc y visita este enlace para obtener más información sobre los productos que ofrece Iron Software.

Preguntas Frecuentes

¿Cómo se instala Portainer en un entorno Windows con Docker Desktop?

Para instalar Portainer en un entorno Windows con Docker Desktop, asegúrese primero de tener instalados Docker y Docker Desktop. Cree un volumen de Docker para los datos de Portainer usando docker volume create portainer_data. Luego, ejecute el contenedor del servidor Portainer con docker run -d -p 8000:8000 -p 9443:9443 --name=portainer --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce:latest.

¿Cuál es el principal beneficio de usar Portainer para gestionar entornos Docker?

Portainer proporciona una interfaz web fácil de usar para gestionar entornos Docker, lo que simplifica la gestión de contenedores, redes, imágenes y volúmenes sin la necesidad de utilizar herramientas complejas de línea de comandos. Soporta entornos de nodo único y multinodo, mejorando la eficiencia operativa.

¿Cómo puede Portainer ayudar con la gestión de Kubernetes?

Portainer soporta entornos de Kubernetes, ofreciendo características como gestión del ciclo de vida de contenedores, gestión de imágenes y pilas, y monitoreo en tiempo real. Esto permite a desarrolladores y administradores de sistemas gestionar clústeres de Kubernetes de manera efectiva a través de una interfaz gráfica.

¿Cuáles son los requisitos previos para instalar Portainer?

Antes de instalar Portainer, asegúrese de tener Docker y Docker Desktop instalados en su sistema. Además, para entornos Windows, es necesario tener configurado WSL2 para soportar las instalaciones de Docker Desktop y Portainer.

¿Cómo puede acceder a la interfaz de Portainer después de la instalación?

Una vez instalado Portainer, puede acceder a su interfaz abriendo un navegador web y navegando a https://localhost:9443. Si es necesario, reemplace 'localhost' con la dirección IP o el nombre de dominio completamente cualificado (FQDN) apropiado.

¿Qué características ofrece Portainer para la gestión del ciclo de vida de contenedores?

Portainer ofrece características para la gestión del ciclo de vida de contenedores, incluyendo la creación, modificación y eliminación de contenedores. También proporciona herramientas para gestionar redes, volúmenes e imágenes de contenedores, todo a través de una interfaz web intuitiva.

¿Cómo mejora IronSecureDoc la seguridad de documentos en entornos en contenedores?

IronSecureDoc mejora la seguridad de documentos proporcionando características de cifrado, redacción y firma digital. Asegura que los documentos estén protegidos, manteniendo su confidencialidad y autenticidad, lo cual es crucial para el cumplimiento de estándares y regulaciones de privacidad en entornos en contenedores.

Curtis Chau
Escritor Técnico

Curtis Chau tiene una licenciatura en Ciencias de la Computación (Carleton University) y se especializa en el desarrollo front-end con experiencia en Node.js, TypeScript, JavaScript y React. Apasionado por crear interfaces de usuario intuitivas y estéticamente agradables, disfruta trabajando con frameworks modernos y creando manuales bien ...

Leer más