Capítulo 12. Uso de la API de las herramientas para contenedores
La nueva API de Podman 2.0 basada en REST sustituye a la antigua API remota de Podman que utilizaba la librería varlink. La nueva API funciona tanto en un entorno rootful como en uno sin root.
La API RESTful de Podman v2.0 consiste en la API Libpod que proporciona soporte para Podman, y la API compatible con Docker.
Con esta nueva API REST, puedes llamar a Podman desde plataformas como cURL, Postman, el cliente REST avanzado de Google y muchas otras.
12.1. Habilitación de la API de Podman mediante systemd en modo root
Este procedimiento muestra cómo hacer lo siguiente:
- Utiliza systemd para activar el socket de la API de Podman.
- Utilice un cliente Podman para realizar comandos básicos.
Requisitos previos
El paquete
podman-remote
está instalado.Copy to Clipboard Copied! Toggle word wrap Toggle overflow yum install podman-remote
# yum install podman-remote
Procedimiento
Configurar el archivo de unidad systemd para el socket Podman:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow cat /usr/lib/systemd/system/podman.socket [Unit] Description=Podman API Socket Documentation=man:podman-api(1) [Socket] ListenStream=%t/podman/podman.sock SocketMode=0660 [Install] WantedBy=sockets.target
# cat /usr/lib/systemd/system/podman.socket [Unit] Description=Podman API Socket Documentation=man:podman-api(1) [Socket] ListenStream=%t/podman/podman.sock SocketMode=0660 [Install] WantedBy=sockets.target
Recarga la configuración del gestor systemd:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow systemctl daemon-reload
# systemctl daemon-reload
Inicie el servicio inmediatamente:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow systemctl enable --now podman.socket
# systemctl enable --now podman.socket
Para habilitar el enlace a
var/lib/docker.sock
utilizando el paquetedocker-podman
:Copy to Clipboard Copied! Toggle word wrap Toggle overflow yum install podman-docker
# yum install podman-docker
Pasos de verificación
Muestra la información del sistema de Podman:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow podman-remote info
# podman-remote info
Verifique el enlace:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow ls -al /var/run/docker.sock
# ls -al /var/run/docker.sock lrwxrwxrwx. 1 root root 23 Nov 4 10:19 /var/run/docker.sock -> /run/podman/podman.sock
Recursos adicionales
- Para más información sobre la API de Podman 2.0, consulte la documentación de la API RESTful de Podman v2.0.
- Para más ejemplos sobre cómo utilizar la API de Podman 2. 0, consulte el artículo A First Look At Podman 2.0 API de Scott McCarty.
- Para ver más ejemplos de cómo utilizar la API de Podman 2.0, consulta el artículo Sneak peek: La nueva API REST de Podman, por Tom Sweeney.