Wiki de Sistemas Operativos - Contribuciones del usuario [es]

Contenedores

2025-12-17T12:21:40Z

Pneira: /* Ejercicio 9 */

En esta práctica aprenderemos a utilizar [https://es.wikipedia.org/wiki/Podman podman] para desplegar contenedores.

= Paso 1: Instalar podman =

Para instalar el paquete oficial:

<syntaxhighlight lang="bash">
apt install podman
</syntaxhighlight>

podman es un clon de '''docker''.

Si añade un usuario 'test' a su sistema con:

<syntaxhighlight lang="bash">
adduser test
</syntaxhighlight>

recuerde hacer:

<syntaxhighlight lang="bash">
loginctl enable-linger test
systemctl start --user dbus
</syntaxhighlight>

para evitar un warning que se muestra al ejecutar '''podman''' como usuario.

= Paso 2: Repositorio de imágenes de contenedores DockerHub =

Docker ofrece un servicio de nube denominado ''DockerHub'' que puede ser empleado como red social para compartir tus imágenes de Podman. En ''DockerHub'' existen además imágenes de contenedores preconfiguradas de software, muchas de ellas oficiales (ofrecidas por el propio fabricante del software) que se podrán emplear como base para construir nuevas imágenes adaptadas a nuestras necesidades.

Podremos realizar búsquedas en este repositorio ''DockerHub'' puedes emplear el siguiente comando:

<syntaxhighlight lang="bash">
podman search docker.io/library/hello-world
</syntaxhighlight>

Para descargarnos la imagen de ''hello-world'' podemos usar la orden ''pull'':

<syntaxhighlight lang="bash">
podman pull docker.io/library/hello-world
</syntaxhighlight>

También podemos publicar imágenes propias, esto require '''registro de usuario''' en la nube de ''DockerHub'', lo que '''no''' es obligatorio para la realización de esta práctica. Para subir una imagen, hay que validarse como usuario en la nube de ''DockerHub'':

<syntaxhighlight lang="bash">
podman login docker.io
</syntaxhighlight>

Tras introducir tu usuario y contraseña, puedes comenzar a publicar tus propias imágenes.

<syntaxhighlight lang="bash">
podman push docker.io/USUARIO/MI_IMAGEN
</syntaxhighlight>

Este paso es '''opcional''', sólo en caso de que se quieran subir imágenes de contenedores a la nube de docker.io.

= Paso 4: Comprobar imágenes en nuestra máquina =

Para ver las imágenes que tenemos en nuestra máquina, utilizaremos el comando:

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Inicialmente, no tenemos imágenes en almacenamiento, podemos descargarnos la imagen oficial de Debian 13 (Trixie):

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian
</syntaxhighlight>

Ahora si, ya debería de aparecernos la imagen ''debian''.

Comentar también que cada imagen puede tener varias etiquetas, por ejemplo, la imagen Debian 12 (Bookworm), cuando la hemos visto en el listado de imágenes, venía con el tag latest, que es el tag que se descarga por defecto, pero nosotros podemos especificar otro, por ejemplo:

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian:bookworm
</syntaxhighlight>

Para traernos la versión de la imagen de Debian 12 ''Bookworm''.

Ahora tendremos dos imágenes con diferente etiqueta, que serían como las diferentes versiones de cada imagen.

= Paso 5: Lanzar un contenedor =

Un contenedor no es más que una imagen de podman ejecutándose, sería similar a
una máquina virtual, aunque mucho más liviano.

Para crear un contenedor, utilizaremos una imagen, en este caso, la imagen
hello-world. Hacemos lo siguiente:

<syntaxhighlight lang="bash">
podman run hello-world
</syntaxhighlight>

Esto nos mostrará el siguiente mensaje si todo está correcto:

<syntaxhighlight lang="bash">
Hello from Docker!
This message shows that your installation appears to be working correctly.

To generate this message, Docker took the following steps:
1. The Docker client contacted the Docker daemon.
2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
(amd64)
3. The Docker daemon created a new container from that image which runs the
executable that produces the output you are currently reading.
4. The Docker daemon streamed that output to the Docker client, which sent it
to your terminal.

To try something more ambitious, you can run an Debian container with:
$ podman run -it debian bash

Share images, automate workflows, and more with a free Docker ID:
https://hub.docker.com/

For more examples and ideas, visit:
https://docs.docker.com/get-started/
</syntaxhighlight>

Al crear los contenedores utilizando el comando 'run', tenemos varias opciones:

* Lanzar una terminal en el contenedor en modo interactivo
* Lanzar en segundo plano y conectarnos posteriormente al contenedor

== Paso 5.1: Lanzar una terminal en el contenedor en modo interactivo (-ti) ==

Para este ejemplo vamos a utilizar otra imagen diferente, en este caso vamos a utilizar una imagen de debian.

Vamos a lanzar un contenedor y ejecutar una terminal en el que se va a ejecutar el programa '''bash''' que me ofrece un interprete de órdenes:

<syntaxhighlight lang="bash">
podman run -ti debian bash
</syntaxhighlight>

La opción ''-t'' indica que se crea un terminal en el contenedor. Y la opción ''-i'' indica que el contenedor se ejecuta en modo interactivo.

Al acceder al contenedor de ''debian'' nos aparece un ''hash'' en el prompt de la shell, que identifica a la instancia del contenedor (es valor es similar al que muestra la orden ''podman container ls'').

Para salir del contenedor, escribimos 'exit' o pulsamos ''CTRL + D''

== Paso 5.2 Lanzar en segundo plano (-d) ==

Otro ejemplo, con la imagen de Debian:

<syntaxhighlight lang="bash">
podman run -dti debian
</syntaxhighlight>

que muestra un hash que identifica de forma única el contenedor lanzado:

<syntaxhighlight lang="bash">
2ec1daae4676a4e84dc04fd91399c1dfe92119544ff12ee307991fe573d3db64
</syntaxhighlight>

Mediante el comando ''attach'' puedo entrar al contenedor:

<syntaxhighlight lang="bash">
podman attach 2ec1daae4676
</syntaxhighlight>

Para salir, pulsamos ''CTRL + P'' seguido de ''CTRL + Q''.

De manera similar, puedo lanzar en segundo plano la imagen de contenedor de ''hello-world'':

<syntaxhighlight lang="bash">
podman run -d hello-world
</syntaxhighlight>

Y consultar los logs:

<syntaxhighlight lang="bash">
podman logs b67fae3312bc321
</syntaxhighlight>

== Paso 5.3: Añadir variables de entorno a un contenedor ==

Utilizaremos la imagen anterior, y vamos a añadir una variable de entorno
llamada TEST que contenga el valor 'test'. A parte, también ejecutaremos la
terminal como antes, para comprobar con el comando echo, que la variable de
entorno está creada correctamente:

<syntaxhighlight lang="bash">
podman run -ti -e TEST=test debian bash
</syntaxhighlight>

Ahora, desde el contenedor podemos comprobar el valor de la variable de entorno ''$TEST''.

<syntaxhighlight lang="bash">
echo $TEST
test
</syntaxhighlight>

= Paso 6: Listar contenedores en ejecución =

Hemos estado haciendo pruebas y ejecutando contenedores en el paso anterior, vamos a ver donde se encuentran estos contenedores que hemos ejecutado, y después veremos algunas opciones más del comando run.

Tenemos dos opciones para ver los contenedores:

<syntaxhighlight lang="bash">
podman container ls -a
</syntaxhighlight>

o la versión corta:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Ambas hacen lo mismo, y debería de mostrarnos una salida similar a la siguiente:

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
e2bde5f5500c debian "bash" 6 minutes ago Exited (0) 2 seconds ago pensive_sammet
544ad27dbc3c debian "bash" 7 minutes ago Exited (0) 7 minutes ago serene_elgamal
</syntaxhighlight>

En la información veremos que el contenedor tiene el estado exited, eso quiere decir que no se está ejecutando y ya ha finalizado. Vamos a hacer una prueba para ver un contendor ejecutándose:

<syntaxhighlight lang="bash">
podman run -d debian sleep 30
</syntaxhighlight>

Con el comando sleep 30 esperamos 30 segundos hasta que termine el comando, asíque durante esos 30 segundos, el contenedor estará ejecutándose, veámoslo:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
eacceb27d52d debian "sleep 30" 12 seconds ago Up 11 seconds sharp_pasteur
</syntaxhighlight>

Vamos a ver alguna opciones más de la orden ''run''.

== Paso 6.1: Dar un nombre al contenedor (--name) ==

Por defecto, podman creará automáticamente un nombre como hemos visto en las salidas del comando ''podman ps -a''. Podemos establecer el nombre del contenedor que queramos con la opción ''--name'':

<syntaxhighlight lang="bash">
podman run -ti --name mi_debian debian
</syntaxhighlight>

== Paso 6.2: Eliminar contenedor cuando termine (--rm) ==

Vamos a mezclar todo lo visto anteriormente:

* Lanzar en segundo plano (-d)
* Ejecutar contenedor durante 30 segundos (sleep 30)
* Dar un nombre a la imagen (--name)
* Eliminar contenedor cuando termine (--rm)

<syntaxhighlight lang="bash">
podman run -d --rm --name bye-bye debian sleep 30
</syntaxhighlight>

Antes y una vez pasados los 30 segundos, podemos comprobar que el contenedor ha desaparecido.

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

NOTA: Si usa ''--rm'', los logs del contenedor dejarán de estar disponibles al terminar la ejecución del contenedor.

= Paso 7: Parar y eliminar contenedores =

Para parar contenedores podemos usar el ID o su nombre:

<syntaxhighlight lang="bash">
podman stop my_container
podman stop e4901956f108
podman ps -a
</syntaxhighlight>

Una vez hemos comprobado que han terminado su ejecución, podemos eliminar los ficheros resultantes de su ejecución:

<syntaxhighlight lang="bash">
podman container rm my_container
</syntaxhighlight>

Para borrar todos los contenedores ya finalizados

<syntaxhighlight lang="bash">
podman container prune
</syntaxhighlight>

= Paso 8: Conectarnos a un contenedor que se está ejecutando en segundo plano =

Vamos a ejecutar de nuevo un contenedor que no termine:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a conectarnos a este contenedor que está ejecutándose en segundo
plano:

<syntaxhighlight lang="bash">
podman attach mi-contenedor
</syntaxhighlight>

Veremos la orden bash ejecutándose, para terminar, hacemos un 'CTRL + C', y ahora, veremos que ha pasado con el contenedor:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Lo veremos parado, por que lo que hemos hecho ha sido conectarnos al contenedor
y parar el comando que se estaba ejecutando, así que ahora tenemos el contenedor
finalizado.

''Nota:'' Para salir del contenedor '''sin detenerlo''' hacemos 'CTRL + P' seguido 'CTRL + Q'

= Paso 9: Ejecutar un comando dentro de un contenedor en ejecución =

Vamos a ver otresta vez como ejecutar un comando en un contenedor que ya está
ejecutándose:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a ejecutar un comando en ese contenedor con el nombre ''mi-contenedor''.
El comando exec es similar al comando run, pero para ejecutar un comando dentro de un contenedor:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor ls
</syntaxhighlight>

Para redirigir la salida a un fichero en el anfitrión:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor ls > x.txt
</syntaxhighlight>

Para redirigir la salida a un fichero ''dentro'' del contenedor, hacemos:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor sh -c "ls > x.txt"
</syntaxhighlight>

También es posible ejecutar comandos con tuberías:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor sh -c "ls -la | grep ^d"
</syntaxhighlight>

= Paso 10: Persistencia en contenedores =

Al hacer ''exit'' y salir de un contenedor, se pierden todos los cambios que hemos realizado. Los

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-ejemplo debian bash
</syntaxhighlight>

Ahora, vamos a crear una carpeta en el contenedor y comprobar que esa carpeta existe:

<syntaxhighlight lang="bash">
podman exec mi-ejemplo mkdir test
podman exec mi-ejemplo ls
</syntaxhighlight>

Veremos que la carpeta existe, pero, ¿qué ocurre si para el contenedor?

<syntaxhighlight lang="bash">
podman container stop mi-ejemplo
</syntaxhighlight>

Y volvemos a lanzarlo:

<syntaxhighlight lang="bash">
podman container rm mi-ejemplo
podman run -d -ti --name mi-ejemplo debian bash
podman exec mi-ejemplo ls
</syntaxhighlight>

Podemos comprobar que la carpeta creada anteriormente, no existe.

¿Qué podemos hacer para mantener la modificaciones realizadas sobre un contenedor?

== Paso 10.1: Crear una imagen derivada de la imagen base ==

Es posible crear una imagen derivada, con modificaciones, a partir de una imagen existente mediante la orden '''commit'''.

Por ejemplo, si queremos una imagen ''debian'' que incluya el programa ''ping'' ya instalado, tendríamos que lanzar un contenedor a partir de la imagen ''debian'':

<syntaxhighlight lang="bash">
podman run -d -ti debian bash
</syntaxhighlight>

Suponiendo que el contenido está identificado con el ID 56ef5b312334

Instalamos el paquete ping:

<syntaxhighlight lang="bash">
podman exec 56ef5b312334 apt -y install ping
</syntaxhighlight>

Generamos la imagen derivada con el nombre ''debian-con-ping'':

<syntaxhighlight lang="bash">
podman commit 56ef5b312334 debian-con-ping
</syntaxhighlight>

Ya podemos para nuestro contendor:

<syntaxhighlight lang="bash">
podman stop 56ef5b312334
</syntaxhighlight>

Y lanzar un nuevo contenedor a partir de la imagen ''debian-con-ping'':

<syntaxhighlight lang="bash">
podman run -d -ti debian-con-ping bash
</syntaxhighlight>

== Paso 10.2: Mantener la persistencia mediante volúmen ==

Otra opción para mantener los datos es montar un volumen al ejecutar el contenedor.

Primero crearemos una carpeta que hará de volumen en nuestra máquina, que será la que luego montemos para podman:

<syntaxhighlight lang="bash">
mkdir /home/debian/volumen
</syntaxhighlight>

Ahora vamos a montar la carpeta al ejecutar el contenedor, lo hacemos con la
opción -v, la cual tiene 3 campos separados por ':':

# El volumen en nuestra máquina
# Donde se montará el volumen dentro del contenedor
# Opciones de mmontaje, por ejemplo rw (read and write) o ro (read only)

<syntaxhighlight lang="bash">
podman run --rm -ti -v /home/debian/volumen:/volumen:rw debian bash
mkdir /volumen/test
touch /volumen/test/file
exit
</syntaxhighlight>

Una vez nos salgamos del contenedor, podemos ver que en nuestra máquina están
los datos:

<syntaxhighlight lang="bash">
ls /home/debian/volumen/
ls /home/debian/volumen/test
</syntaxhighlight>

La próxima vez que ejecutemos un contenedor, si montamos ese volumen, los datos
estarán ahí, además esta forma tiene el beneficio de compartir datos entre
nuestra máquina y el contenedor de forma sencilla.

= Paso 11: Crear nuestra propia imagen de contenedor =

Para crear una imagen de un contenedor con una aplicación de Python hug, creamos en primer lugar la carpeta que contendrá los ficheros que nos permiten crear la imagen.

<syntaxhighlight lang="bash">
mkdir miapp
cd miapp
</syntaxhighlight>

Definimos un fichero ''Dockerfile'' para definir la imagen:

<syntaxhighlight lang="bash">
FROM debian

RUN apt -y update
RUN apt -y upgrade
RUN apt -y install python3-hug
RUN mkdir /app
COPY endpoint.py /app
WORKDIR /app
CMD hug -f endpoint.py
</syntaxhighlight>

Alternativamente, puedes crear un [[Creando imagen propia usando Ubuntu de base|Dockerfile empleando la imagen de Ubuntu]] como base en lugar de Alpine.

Y añadimos el fichero ''endpoint.py'' que emplea el framework Python hug con el contenido siguiente:

<syntaxhighlight lang="bash">
import hug

@hug.get('/welcome')
def welcome(username="unknown"):
""" Say welcome to username """
return "Welcome " + username
</syntaxhighlight>

Este fichero es un ejemplo de uso de Python hug. Si hacemos una petición a /welcome?username="LSO", esto nos devolverá el mensaje "Welcome LSO".

Una vez tengamos los dos ficheros creados en nuestra máquina virtual, podemos construir nuestra imagen:

<syntaxhighlight lang="bash">
podman build -t app:v1 -f Dockerfile
</syntaxhighlight>

* -t indica el nombre de la imagen, que pueden venir acompañados de una etiqueta (por ejemplo ''v1'') haciendo uso del separador '':''.
* -f indica el fichero dockerfile a utilizar para construir la imagen.

Esto construirá una imagen de contenedor basada en ''python:alpine'', en la cual hemos guardado nuestra pequeña aplicación y se va a ejecutar cuando ejecutemos un contenedor basado en esa imagen. Para comprobar que la imagen se ha creado correctamente, listamos las imagenes, y debería de aparecernos una imagen con nombre 'app' y tag 'v1':

Vamos a explicar para que sirve cada línea:

* FROM: en tiempo de construcción, indica la imagen de base que se va a emplear para generar nuestra imagen derivada.
* RUN: en tiempo de construcción, qué comandos hay que ejecutar para construir la imagen derivada.
* COPY: en tiempo de construcción, para copiar datos desde el host a la imagen derivada.
* WORKDIR: en tiempo de ejecución, para cambiar el directorio de trabajo (lo crea si no existe)
* CMD: en tiempo de ejecución, que comandos se invocan para lanzar la aplicación.

NOTA: El lenguaje de plantillas de Dockerfile mezcla comandos que se ejecutan en tiempo de construcción (''podman build'') y en tiempo de ejecución (''podman run'').

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen, y vamos a añadir una nueva
opción, -p 8001:8000. Esta opción hará que el puerto interno 8000 del contenedor
sea expuesto en el puerto 8001 de nuestra máquina:

<syntaxhighlight lang="bash">
podman run --name my-app --rm -d -p 8001:8000 app:v1
</syntaxhighlight>

''Nota:'' podman supone que la redirección de puerto es TCP, para una redirección de puertos UDP, puedes usar:

<syntaxhighlight lang="bash">
... -p 8001:8000/udp
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código. En nuestra
máquina haremos:

<syntaxhighlight lang="bash">
curl -X GET http://localhost:8001/welcome?username=LSO
</syntaxhighlight>

Comprobaremos que la salida del comando curl, es "Welcome LSO".

Antes de terminar, vamos a comprobar otro pequeño detalle que añadimos en
nuestra imagen, la variable de entorno USERNAME, vamos a comprobar que funciona:

<syntaxhighlight lang="bash">
podman exec -ti my-app ash
echo $USERNAME
</syntaxhighlight>

Funciona correctamente, pero al ejecutar el contenedor, podemos cambiar esta
variable de entorno como vimos en uno de los pasos anteriores:

<syntaxhighlight lang="bash">
podman run --rm -ti -e USERNAME=me app:v1 ash
echo $USERNAME
</syntaxhighlight>

Esto nos servirá para tener opciones por defecto y que el usuario pueda
cambiarlo a su antojo, como por ejemplo contraseñas u otros detalles.

== Paso 11.1: Depuración de problemas al crear nuestra imagen ==

Hay dos comandos que son particularmente útiles para averiguar por qué nuestra imagen no funciona:

* Consultar si el contenedor está ejecutándose:

<syntaxhighlight lang="bash">
podman container ls
</syntaxhighlight>

Que nos permite ver si el contenedor está activa y la redirección de puertos es correcta.

* Consultar los logs del contenedor:

<syntaxhighlight lang="bash">
podman logs 345fb5d21
</syntaxhighlight>

Esto nos permite saber qué está pasando dentro del contenedor, o qué pasó si éste dejo terminó su ejecución.

NOTA: Si usas la opción --rm al ejecutar tu contenedor, ¡los logs no estarán disponibles!

= Paso 12: Eliminar imágenes =

Para borrar una imagen, puede hacer:

<syntaxhighlight lang="bash">
podman image rm hello-world
</syntaxhighlight>

= Paso 13: Ejercicios =

== Ejercicio 1: Image derivada de Debian con el programa sl ==

Lance un contenedor a partir de una imagen de Debian, instale el programa sl, ejecute sl (desde fuera del contenedor) y detenga el contenedor.

== Ejercicio 2 ==

== Ejercicio 3: Variante de httpd ==

Construya una imagen ''httpd-hola-mundo'' a partir de la imagen ''httpd''. El fichero de index.html de la carpeta htdocs/ tiene que mostrar el mensaje "hola mundo".

<syntaxhighlight lang="bash">
podman pull httpd
</syntaxhighlight>

Edita el fichero Dockerfile:

<syntaxhighlight lang="bash">
nano Dockerfile
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
FROM httpd

COPY index.html htdocs/index.html
</syntaxhighlight>

Edita el fichero index.html:

<syntaxhighlight lang="bash">
nano index.html
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

Construye la imagen:

<syntaxhighlight lang="bash">
podman build -t mihttpd -f Dockerfile
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen:

<syntaxhighlight lang="bash">
podman run --name mihttpd -d -p 8080:80 mihttpd
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código:
<syntaxhighlight lang="bash">
curl -X GET http://localhost:8080
</syntaxhighlight>

Tiene que salir por pantalla esto:
<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

== Ejercicio 4: aplicación flask ==

Flask es un framework python para implementar webs. Cree una imagen "miapp-flask" a partir de la imagen de "python":

* Instale flask mediante: pip install flask
* Cree la carpeta "app"
* Establezca la variable FLASK_APP a "hello.py"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"

El fichero hello.py contiene un "hola mundo" para Flask:

<syntaxhighlight lang="python">
from flask import Flask
app = Flask(__name__)

@app.route("/")
def hello():
return "Hello World!"

if __name__ == "__main__":
app.run()
</syntaxhighlight>

Solución con alpine:

<syntaxhighlight lang="bash">
FROM python:alpine

RUN mkdir /app
RUN pip install flask
ENV FLASK_APP="app/hello.py"
COPY hello.py
WORKDIR /
CMD flask run --host=0.0.0.0
</syntaxhighlight>

Solución con Ubuntu:

<syntaxhighlight lang="bash">
FROM ubuntu:bionic

RUN apt-get update
RUN apt-get -y install python python-pip wget
RUN pip install Flask
ENV FLASK_APP="app/hello.py"
RUN mkdir /app
COPY hello.py /app
CMD flask run --host=0.0.0.0
</syntaxhighlight>

== Ejercicio 5: mysql ==

'''EN LA MÁQUINA VIRTUAL:'''

mkdir miapp
cd miapp
podman pull mysql
nano Dockerfile

<syntaxhighlight lang="bash">
FROM mysql
ENV MYSQL_ROOT_PASSWORD="lacontraseñaqueyoquiera"
RUN mkdir /app
WORKDIR /app

</syntaxhighlight>

CTRL+O , ENTER Y CTRL+X (para guardar Dockerfile y salir)

podman build -ti mrfdocker -f Dockerfile
podman run --name mymrf --rm -p 8001:3306 mrfdocker
docker images

'''EN LA TERMINAL DEL HOST:'''

''Instalación de mysql:''

apt install mysql-client-core-5.7
apt-get install mysql-server
service mysql start

''Para entrar:''

mysql -u root -p -P 8001

Una vez dentro de msql:

mysql> show databases;

''Para salir:''

exit

== Ejercicio 6: python pyramid ==

Pyramid es un framework python para implementar webs. Cree una imagen "miapp-pyramid":

* Emplee la imagen de debian como referencia, instale los paquetes python3 y python3-pyramid.
* Cree la carpeta "app"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"
* La aplicación se lanza con la orden: python3 hello.py
* Compruebe que funciona con curl, la ruta a la web es http://127.0.0.1:8000/hello, suponiendo que ha empleado el puerto 8000 para exponer el servicio.

El fichero hello.py contiene un "hola mundo" para Pyramid:

<syntaxhighlight lang="bash">
from wsgiref.simple_server import make_server
from pyramid.config import Configurator
from pyramid.response import Response

def hello_world(request):
print('Request inbound!')
return Response('Podman works with Pyramid!')

if __name__ == '__main__':
config = Configurator()
config.add_route('hello', '/')
config.add_view(hello_world, route_name='hello')
app = config.make_wsgi_app()
server = make_server('0.0.0.0', 6543, app)
server.serve_forever()
</syntaxhighlight>

Este programa recibe peticiones en el puerto 6543.

== Ejercicio 7 ==

Cree una imagen derivada de Ubuntu, instale el paquete apache2, php y libapache2-mod-php.
Active el módulo de php para apache2 mediante la orden:

<syntaxhighlight lang="bash">
a2enmod php
</syntaxhighlight>

Cree la carpeta /var/www/php.

Cree el fichero index.php

<syntaxhighlight lang="php">
<?php
Print "Hello, World!";
?>
</syntaxhighlight>

y copielo a /var/www/php/.

Cree el fichero 000-default.conf y copielo a /etc/apache2/sites-enabled/

Dicho fichero contiene.

<syntaxhighlight lang="bash">
<VirtualHost *:80>
DocumentRoot /var/www/php

<Directory /var/www/php/>
Options Indexes FollowSymLinks MultiViews
AllowOverride All
Order deny,allow
Allow from all
</Directory>

ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>
</syntaxhighlight>

Tiene que lanzar apache con la orden: apachectl -D FOREGROUND

Tras crear la imagen, láncela mapeando el puerto 8888 al 80, pruebe que puede acceder a http://127.0.0.1:8888/php/ mediante curl

Solución:

<syntaxhighlight lang="bash">
FROM ubuntu:latest

RUN apt-get update
RUN apt-get install -y tzdata
RUN apt-get install -y apache2
RUN apt-get install -y php
RUN apt-get install -y libapache2-mod-php
RUN a2enmod php7.2
COPY index.php /var/www/php
COPY 000-default.conf /etc/apache2/sites-enabled/
CMD apachectl -D FOREGROUND
</syntaxhighlight>

Y para lanzarlo:

podman run --name my-app --rm -d -p 8001:8000 app:v1

y para probarlo:

curl -X GET http://127.0.0.1:8888/php/

== Ejercicio 8 ==

Instale el paquete ''netcat-traditional'' en una imagen de contenedor de ''debian''. Lance la orden:

nc -u -l -p 8080

en el contenedor. Asegúrese de crear una redirección de puertos de 9999 desde el ''host'' al puerto 8080 en el contenedor.

Desde fuera del contenedor, pruebe a conectarse con:

nc -u 127.0.0.1 9999

Y escriba texto cualquiera.

Luego, consulte el log del contenedor para que ver que la instancia de netcat dentro del contenedor a recibido el texto que ha escrito.

Recuerde que es una redirección para UDP.

== Ejercicio 9 ==

Cree una imagen derivada de "debian" con un Dockerfile que incluya soporte de python y lance el siguiente código en Python:

<syntaxhighlight lang="python">
from http.server import BaseHTTPRequestHandler, HTTPServer
import time

hostName = "0.0.0.0"
serverPort = 8080

class MyServer(BaseHTTPRequestHandler):
def do_GET(self):
self.send_response(200)
self.send_header("Content-type", "text/html")
self.end_headers()
self.wfile.write(bytes("<html><head><title>Welcome!</title></head>", "utf-8"))
self.wfile.write(bytes("<body>", "utf-8"))
self.wfile.write(bytes("This is an example web server.", "utf-8"))
self.wfile.write(bytes("</body></html>", "utf-8"))

if __name__ == "__main__":
webServer = HTTPServer((hostName, serverPort), MyServer)
print("Server started http://%s:%s" % (hostName, serverPort))

try:
webServer.serve_forever()
except KeyboardInterrupt:
pass

webServer.server_close()
print("Server stopped.")
</syntaxhighlight>

Llame a su imagen "python-http-server". Lance una instancia de la imagen "python-http-server" mapeando el puerto 9999 al puerto 8888/tcp del contenedor. Compruebe con:

<syntaxhighlight lang="bash">
curl http://127.0.0.1:9999/
</syntaxhighlight>

que muestre la página HTML que ofrece el servidor, que debería ser:

<syntaxhighlight lang="bash">
<html><head><title>Welcome!</title></head><body>This is an example web server.</body></html>
</syntaxhighlight>

= Anexo =

* Cómo usar [[Podman compose]]

Contenedores

2025-12-17T12:21:14Z

Pneira: /* Ejercicio 8 */

En esta práctica aprenderemos a utilizar [https://es.wikipedia.org/wiki/Podman podman] para desplegar contenedores.

= Paso 1: Instalar podman =

Para instalar el paquete oficial:

<syntaxhighlight lang="bash">
apt install podman
</syntaxhighlight>

podman es un clon de '''docker''.

Si añade un usuario 'test' a su sistema con:

<syntaxhighlight lang="bash">
adduser test
</syntaxhighlight>

recuerde hacer:

<syntaxhighlight lang="bash">
loginctl enable-linger test
systemctl start --user dbus
</syntaxhighlight>

para evitar un warning que se muestra al ejecutar '''podman''' como usuario.

= Paso 2: Repositorio de imágenes de contenedores DockerHub =

Docker ofrece un servicio de nube denominado ''DockerHub'' que puede ser empleado como red social para compartir tus imágenes de Podman. En ''DockerHub'' existen además imágenes de contenedores preconfiguradas de software, muchas de ellas oficiales (ofrecidas por el propio fabricante del software) que se podrán emplear como base para construir nuevas imágenes adaptadas a nuestras necesidades.

Podremos realizar búsquedas en este repositorio ''DockerHub'' puedes emplear el siguiente comando:

<syntaxhighlight lang="bash">
podman search docker.io/library/hello-world
</syntaxhighlight>

Para descargarnos la imagen de ''hello-world'' podemos usar la orden ''pull'':

<syntaxhighlight lang="bash">
podman pull docker.io/library/hello-world
</syntaxhighlight>

También podemos publicar imágenes propias, esto require '''registro de usuario''' en la nube de ''DockerHub'', lo que '''no''' es obligatorio para la realización de esta práctica. Para subir una imagen, hay que validarse como usuario en la nube de ''DockerHub'':

<syntaxhighlight lang="bash">
podman login docker.io
</syntaxhighlight>

Tras introducir tu usuario y contraseña, puedes comenzar a publicar tus propias imágenes.

<syntaxhighlight lang="bash">
podman push docker.io/USUARIO/MI_IMAGEN
</syntaxhighlight>

Este paso es '''opcional''', sólo en caso de que se quieran subir imágenes de contenedores a la nube de docker.io.

= Paso 4: Comprobar imágenes en nuestra máquina =

Para ver las imágenes que tenemos en nuestra máquina, utilizaremos el comando:

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Inicialmente, no tenemos imágenes en almacenamiento, podemos descargarnos la imagen oficial de Debian 13 (Trixie):

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian
</syntaxhighlight>

Ahora si, ya debería de aparecernos la imagen ''debian''.

Comentar también que cada imagen puede tener varias etiquetas, por ejemplo, la imagen Debian 12 (Bookworm), cuando la hemos visto en el listado de imágenes, venía con el tag latest, que es el tag que se descarga por defecto, pero nosotros podemos especificar otro, por ejemplo:

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian:bookworm
</syntaxhighlight>

Para traernos la versión de la imagen de Debian 12 ''Bookworm''.

Ahora tendremos dos imágenes con diferente etiqueta, que serían como las diferentes versiones de cada imagen.

= Paso 5: Lanzar un contenedor =

Un contenedor no es más que una imagen de podman ejecutándose, sería similar a
una máquina virtual, aunque mucho más liviano.

Para crear un contenedor, utilizaremos una imagen, en este caso, la imagen
hello-world. Hacemos lo siguiente:

<syntaxhighlight lang="bash">
podman run hello-world
</syntaxhighlight>

Esto nos mostrará el siguiente mensaje si todo está correcto:

<syntaxhighlight lang="bash">
Hello from Docker!
This message shows that your installation appears to be working correctly.

To generate this message, Docker took the following steps:
1. The Docker client contacted the Docker daemon.
2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
(amd64)
3. The Docker daemon created a new container from that image which runs the
executable that produces the output you are currently reading.
4. The Docker daemon streamed that output to the Docker client, which sent it
to your terminal.

To try something more ambitious, you can run an Debian container with:
$ podman run -it debian bash

Share images, automate workflows, and more with a free Docker ID:
https://hub.docker.com/

For more examples and ideas, visit:
https://docs.docker.com/get-started/
</syntaxhighlight>

Al crear los contenedores utilizando el comando 'run', tenemos varias opciones:

* Lanzar una terminal en el contenedor en modo interactivo
* Lanzar en segundo plano y conectarnos posteriormente al contenedor

== Paso 5.1: Lanzar una terminal en el contenedor en modo interactivo (-ti) ==

Para este ejemplo vamos a utilizar otra imagen diferente, en este caso vamos a utilizar una imagen de debian.

Vamos a lanzar un contenedor y ejecutar una terminal en el que se va a ejecutar el programa '''bash''' que me ofrece un interprete de órdenes:

<syntaxhighlight lang="bash">
podman run -ti debian bash
</syntaxhighlight>

La opción ''-t'' indica que se crea un terminal en el contenedor. Y la opción ''-i'' indica que el contenedor se ejecuta en modo interactivo.

Al acceder al contenedor de ''debian'' nos aparece un ''hash'' en el prompt de la shell, que identifica a la instancia del contenedor (es valor es similar al que muestra la orden ''podman container ls'').

Para salir del contenedor, escribimos 'exit' o pulsamos ''CTRL + D''

== Paso 5.2 Lanzar en segundo plano (-d) ==

Otro ejemplo, con la imagen de Debian:

<syntaxhighlight lang="bash">
podman run -dti debian
</syntaxhighlight>

que muestra un hash que identifica de forma única el contenedor lanzado:

<syntaxhighlight lang="bash">
2ec1daae4676a4e84dc04fd91399c1dfe92119544ff12ee307991fe573d3db64
</syntaxhighlight>

Mediante el comando ''attach'' puedo entrar al contenedor:

<syntaxhighlight lang="bash">
podman attach 2ec1daae4676
</syntaxhighlight>

Para salir, pulsamos ''CTRL + P'' seguido de ''CTRL + Q''.

De manera similar, puedo lanzar en segundo plano la imagen de contenedor de ''hello-world'':

<syntaxhighlight lang="bash">
podman run -d hello-world
</syntaxhighlight>

Y consultar los logs:

<syntaxhighlight lang="bash">
podman logs b67fae3312bc321
</syntaxhighlight>

== Paso 5.3: Añadir variables de entorno a un contenedor ==

Utilizaremos la imagen anterior, y vamos a añadir una variable de entorno
llamada TEST que contenga el valor 'test'. A parte, también ejecutaremos la
terminal como antes, para comprobar con el comando echo, que la variable de
entorno está creada correctamente:

<syntaxhighlight lang="bash">
podman run -ti -e TEST=test debian bash
</syntaxhighlight>

Ahora, desde el contenedor podemos comprobar el valor de la variable de entorno ''$TEST''.

<syntaxhighlight lang="bash">
echo $TEST
test
</syntaxhighlight>

= Paso 6: Listar contenedores en ejecución =

Hemos estado haciendo pruebas y ejecutando contenedores en el paso anterior, vamos a ver donde se encuentran estos contenedores que hemos ejecutado, y después veremos algunas opciones más del comando run.

Tenemos dos opciones para ver los contenedores:

<syntaxhighlight lang="bash">
podman container ls -a
</syntaxhighlight>

o la versión corta:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Ambas hacen lo mismo, y debería de mostrarnos una salida similar a la siguiente:

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
e2bde5f5500c debian "bash" 6 minutes ago Exited (0) 2 seconds ago pensive_sammet
544ad27dbc3c debian "bash" 7 minutes ago Exited (0) 7 minutes ago serene_elgamal
</syntaxhighlight>

En la información veremos que el contenedor tiene el estado exited, eso quiere decir que no se está ejecutando y ya ha finalizado. Vamos a hacer una prueba para ver un contendor ejecutándose:

<syntaxhighlight lang="bash">
podman run -d debian sleep 30
</syntaxhighlight>

Con el comando sleep 30 esperamos 30 segundos hasta que termine el comando, asíque durante esos 30 segundos, el contenedor estará ejecutándose, veámoslo:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
eacceb27d52d debian "sleep 30" 12 seconds ago Up 11 seconds sharp_pasteur
</syntaxhighlight>

Vamos a ver alguna opciones más de la orden ''run''.

== Paso 6.1: Dar un nombre al contenedor (--name) ==

Por defecto, podman creará automáticamente un nombre como hemos visto en las salidas del comando ''podman ps -a''. Podemos establecer el nombre del contenedor que queramos con la opción ''--name'':

<syntaxhighlight lang="bash">
podman run -ti --name mi_debian debian
</syntaxhighlight>

== Paso 6.2: Eliminar contenedor cuando termine (--rm) ==

Vamos a mezclar todo lo visto anteriormente:

* Lanzar en segundo plano (-d)
* Ejecutar contenedor durante 30 segundos (sleep 30)
* Dar un nombre a la imagen (--name)
* Eliminar contenedor cuando termine (--rm)

<syntaxhighlight lang="bash">
podman run -d --rm --name bye-bye debian sleep 30
</syntaxhighlight>

Antes y una vez pasados los 30 segundos, podemos comprobar que el contenedor ha desaparecido.

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

NOTA: Si usa ''--rm'', los logs del contenedor dejarán de estar disponibles al terminar la ejecución del contenedor.

= Paso 7: Parar y eliminar contenedores =

Para parar contenedores podemos usar el ID o su nombre:

<syntaxhighlight lang="bash">
podman stop my_container
podman stop e4901956f108
podman ps -a
</syntaxhighlight>

Una vez hemos comprobado que han terminado su ejecución, podemos eliminar los ficheros resultantes de su ejecución:

<syntaxhighlight lang="bash">
podman container rm my_container
</syntaxhighlight>

Para borrar todos los contenedores ya finalizados

<syntaxhighlight lang="bash">
podman container prune
</syntaxhighlight>

= Paso 8: Conectarnos a un contenedor que se está ejecutando en segundo plano =

Vamos a ejecutar de nuevo un contenedor que no termine:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a conectarnos a este contenedor que está ejecutándose en segundo
plano:

<syntaxhighlight lang="bash">
podman attach mi-contenedor
</syntaxhighlight>

Veremos la orden bash ejecutándose, para terminar, hacemos un 'CTRL + C', y ahora, veremos que ha pasado con el contenedor:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Lo veremos parado, por que lo que hemos hecho ha sido conectarnos al contenedor
y parar el comando que se estaba ejecutando, así que ahora tenemos el contenedor
finalizado.

''Nota:'' Para salir del contenedor '''sin detenerlo''' hacemos 'CTRL + P' seguido 'CTRL + Q'

= Paso 9: Ejecutar un comando dentro de un contenedor en ejecución =

Vamos a ver otresta vez como ejecutar un comando en un contenedor que ya está
ejecutándose:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a ejecutar un comando en ese contenedor con el nombre ''mi-contenedor''.
El comando exec es similar al comando run, pero para ejecutar un comando dentro de un contenedor:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor ls
</syntaxhighlight>

Para redirigir la salida a un fichero en el anfitrión:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor ls > x.txt
</syntaxhighlight>

Para redirigir la salida a un fichero ''dentro'' del contenedor, hacemos:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor sh -c "ls > x.txt"
</syntaxhighlight>

También es posible ejecutar comandos con tuberías:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor sh -c "ls -la | grep ^d"
</syntaxhighlight>

= Paso 10: Persistencia en contenedores =

Al hacer ''exit'' y salir de un contenedor, se pierden todos los cambios que hemos realizado. Los

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-ejemplo debian bash
</syntaxhighlight>

Ahora, vamos a crear una carpeta en el contenedor y comprobar que esa carpeta existe:

<syntaxhighlight lang="bash">
podman exec mi-ejemplo mkdir test
podman exec mi-ejemplo ls
</syntaxhighlight>

Veremos que la carpeta existe, pero, ¿qué ocurre si para el contenedor?

<syntaxhighlight lang="bash">
podman container stop mi-ejemplo
</syntaxhighlight>

Y volvemos a lanzarlo:

<syntaxhighlight lang="bash">
podman container rm mi-ejemplo
podman run -d -ti --name mi-ejemplo debian bash
podman exec mi-ejemplo ls
</syntaxhighlight>

Podemos comprobar que la carpeta creada anteriormente, no existe.

¿Qué podemos hacer para mantener la modificaciones realizadas sobre un contenedor?

== Paso 10.1: Crear una imagen derivada de la imagen base ==

Es posible crear una imagen derivada, con modificaciones, a partir de una imagen existente mediante la orden '''commit'''.

Por ejemplo, si queremos una imagen ''debian'' que incluya el programa ''ping'' ya instalado, tendríamos que lanzar un contenedor a partir de la imagen ''debian'':

<syntaxhighlight lang="bash">
podman run -d -ti debian bash
</syntaxhighlight>

Suponiendo que el contenido está identificado con el ID 56ef5b312334

Instalamos el paquete ping:

<syntaxhighlight lang="bash">
podman exec 56ef5b312334 apt -y install ping
</syntaxhighlight>

Generamos la imagen derivada con el nombre ''debian-con-ping'':

<syntaxhighlight lang="bash">
podman commit 56ef5b312334 debian-con-ping
</syntaxhighlight>

Ya podemos para nuestro contendor:

<syntaxhighlight lang="bash">
podman stop 56ef5b312334
</syntaxhighlight>

Y lanzar un nuevo contenedor a partir de la imagen ''debian-con-ping'':

<syntaxhighlight lang="bash">
podman run -d -ti debian-con-ping bash
</syntaxhighlight>

== Paso 10.2: Mantener la persistencia mediante volúmen ==

Otra opción para mantener los datos es montar un volumen al ejecutar el contenedor.

Primero crearemos una carpeta que hará de volumen en nuestra máquina, que será la que luego montemos para podman:

<syntaxhighlight lang="bash">
mkdir /home/debian/volumen
</syntaxhighlight>

Ahora vamos a montar la carpeta al ejecutar el contenedor, lo hacemos con la
opción -v, la cual tiene 3 campos separados por ':':

# El volumen en nuestra máquina
# Donde se montará el volumen dentro del contenedor
# Opciones de mmontaje, por ejemplo rw (read and write) o ro (read only)

<syntaxhighlight lang="bash">
podman run --rm -ti -v /home/debian/volumen:/volumen:rw debian bash
mkdir /volumen/test
touch /volumen/test/file
exit
</syntaxhighlight>

Una vez nos salgamos del contenedor, podemos ver que en nuestra máquina están
los datos:

<syntaxhighlight lang="bash">
ls /home/debian/volumen/
ls /home/debian/volumen/test
</syntaxhighlight>

La próxima vez que ejecutemos un contenedor, si montamos ese volumen, los datos
estarán ahí, además esta forma tiene el beneficio de compartir datos entre
nuestra máquina y el contenedor de forma sencilla.

= Paso 11: Crear nuestra propia imagen de contenedor =

Para crear una imagen de un contenedor con una aplicación de Python hug, creamos en primer lugar la carpeta que contendrá los ficheros que nos permiten crear la imagen.

<syntaxhighlight lang="bash">
mkdir miapp
cd miapp
</syntaxhighlight>

Definimos un fichero ''Dockerfile'' para definir la imagen:

<syntaxhighlight lang="bash">
FROM debian

RUN apt -y update
RUN apt -y upgrade
RUN apt -y install python3-hug
RUN mkdir /app
COPY endpoint.py /app
WORKDIR /app
CMD hug -f endpoint.py
</syntaxhighlight>

Alternativamente, puedes crear un [[Creando imagen propia usando Ubuntu de base|Dockerfile empleando la imagen de Ubuntu]] como base en lugar de Alpine.

Y añadimos el fichero ''endpoint.py'' que emplea el framework Python hug con el contenido siguiente:

<syntaxhighlight lang="bash">
import hug

@hug.get('/welcome')
def welcome(username="unknown"):
""" Say welcome to username """
return "Welcome " + username
</syntaxhighlight>

Este fichero es un ejemplo de uso de Python hug. Si hacemos una petición a /welcome?username="LSO", esto nos devolverá el mensaje "Welcome LSO".

Una vez tengamos los dos ficheros creados en nuestra máquina virtual, podemos construir nuestra imagen:

<syntaxhighlight lang="bash">
podman build -t app:v1 -f Dockerfile
</syntaxhighlight>

* -t indica el nombre de la imagen, que pueden venir acompañados de una etiqueta (por ejemplo ''v1'') haciendo uso del separador '':''.
* -f indica el fichero dockerfile a utilizar para construir la imagen.

Esto construirá una imagen de contenedor basada en ''python:alpine'', en la cual hemos guardado nuestra pequeña aplicación y se va a ejecutar cuando ejecutemos un contenedor basado en esa imagen. Para comprobar que la imagen se ha creado correctamente, listamos las imagenes, y debería de aparecernos una imagen con nombre 'app' y tag 'v1':

Vamos a explicar para que sirve cada línea:

* FROM: en tiempo de construcción, indica la imagen de base que se va a emplear para generar nuestra imagen derivada.
* RUN: en tiempo de construcción, qué comandos hay que ejecutar para construir la imagen derivada.
* COPY: en tiempo de construcción, para copiar datos desde el host a la imagen derivada.
* WORKDIR: en tiempo de ejecución, para cambiar el directorio de trabajo (lo crea si no existe)
* CMD: en tiempo de ejecución, que comandos se invocan para lanzar la aplicación.

NOTA: El lenguaje de plantillas de Dockerfile mezcla comandos que se ejecutan en tiempo de construcción (''podman build'') y en tiempo de ejecución (''podman run'').

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen, y vamos a añadir una nueva
opción, -p 8001:8000. Esta opción hará que el puerto interno 8000 del contenedor
sea expuesto en el puerto 8001 de nuestra máquina:

<syntaxhighlight lang="bash">
podman run --name my-app --rm -d -p 8001:8000 app:v1
</syntaxhighlight>

''Nota:'' podman supone que la redirección de puerto es TCP, para una redirección de puertos UDP, puedes usar:

<syntaxhighlight lang="bash">
... -p 8001:8000/udp
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código. En nuestra
máquina haremos:

<syntaxhighlight lang="bash">
curl -X GET http://localhost:8001/welcome?username=LSO
</syntaxhighlight>

Comprobaremos que la salida del comando curl, es "Welcome LSO".

Antes de terminar, vamos a comprobar otro pequeño detalle que añadimos en
nuestra imagen, la variable de entorno USERNAME, vamos a comprobar que funciona:

<syntaxhighlight lang="bash">
podman exec -ti my-app ash
echo $USERNAME
</syntaxhighlight>

Funciona correctamente, pero al ejecutar el contenedor, podemos cambiar esta
variable de entorno como vimos en uno de los pasos anteriores:

<syntaxhighlight lang="bash">
podman run --rm -ti -e USERNAME=me app:v1 ash
echo $USERNAME
</syntaxhighlight>

Esto nos servirá para tener opciones por defecto y que el usuario pueda
cambiarlo a su antojo, como por ejemplo contraseñas u otros detalles.

== Paso 11.1: Depuración de problemas al crear nuestra imagen ==

Hay dos comandos que son particularmente útiles para averiguar por qué nuestra imagen no funciona:

* Consultar si el contenedor está ejecutándose:

<syntaxhighlight lang="bash">
podman container ls
</syntaxhighlight>

Que nos permite ver si el contenedor está activa y la redirección de puertos es correcta.

* Consultar los logs del contenedor:

<syntaxhighlight lang="bash">
podman logs 345fb5d21
</syntaxhighlight>

Esto nos permite saber qué está pasando dentro del contenedor, o qué pasó si éste dejo terminó su ejecución.

NOTA: Si usas la opción --rm al ejecutar tu contenedor, ¡los logs no estarán disponibles!

= Paso 12: Eliminar imágenes =

Para borrar una imagen, puede hacer:

<syntaxhighlight lang="bash">
podman image rm hello-world
</syntaxhighlight>

= Paso 13: Ejercicios =

== Ejercicio 1: Image derivada de Debian con el programa sl ==

Lance un contenedor a partir de una imagen de Debian, instale el programa sl, ejecute sl (desde fuera del contenedor) y detenga el contenedor.

== Ejercicio 2 ==

== Ejercicio 3: Variante de httpd ==

Construya una imagen ''httpd-hola-mundo'' a partir de la imagen ''httpd''. El fichero de index.html de la carpeta htdocs/ tiene que mostrar el mensaje "hola mundo".

<syntaxhighlight lang="bash">
podman pull httpd
</syntaxhighlight>

Edita el fichero Dockerfile:

<syntaxhighlight lang="bash">
nano Dockerfile
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
FROM httpd

COPY index.html htdocs/index.html
</syntaxhighlight>

Edita el fichero index.html:

<syntaxhighlight lang="bash">
nano index.html
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

Construye la imagen:

<syntaxhighlight lang="bash">
podman build -t mihttpd -f Dockerfile
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen:

<syntaxhighlight lang="bash">
podman run --name mihttpd -d -p 8080:80 mihttpd
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código:
<syntaxhighlight lang="bash">
curl -X GET http://localhost:8080
</syntaxhighlight>

Tiene que salir por pantalla esto:
<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

== Ejercicio 4: aplicación flask ==

Flask es un framework python para implementar webs. Cree una imagen "miapp-flask" a partir de la imagen de "python":

* Instale flask mediante: pip install flask
* Cree la carpeta "app"
* Establezca la variable FLASK_APP a "hello.py"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"

El fichero hello.py contiene un "hola mundo" para Flask:

<syntaxhighlight lang="python">
from flask import Flask
app = Flask(__name__)

@app.route("/")
def hello():
return "Hello World!"

if __name__ == "__main__":
app.run()
</syntaxhighlight>

Solución con alpine:

<syntaxhighlight lang="bash">
FROM python:alpine

RUN mkdir /app
RUN pip install flask
ENV FLASK_APP="app/hello.py"
COPY hello.py
WORKDIR /
CMD flask run --host=0.0.0.0
</syntaxhighlight>

Solución con Ubuntu:

<syntaxhighlight lang="bash">
FROM ubuntu:bionic

RUN apt-get update
RUN apt-get -y install python python-pip wget
RUN pip install Flask
ENV FLASK_APP="app/hello.py"
RUN mkdir /app
COPY hello.py /app
CMD flask run --host=0.0.0.0
</syntaxhighlight>

== Ejercicio 5: mysql ==

'''EN LA MÁQUINA VIRTUAL:'''

mkdir miapp
cd miapp
podman pull mysql
nano Dockerfile

<syntaxhighlight lang="bash">
FROM mysql
ENV MYSQL_ROOT_PASSWORD="lacontraseñaqueyoquiera"
RUN mkdir /app
WORKDIR /app

</syntaxhighlight>

CTRL+O , ENTER Y CTRL+X (para guardar Dockerfile y salir)

podman build -ti mrfdocker -f Dockerfile
podman run --name mymrf --rm -p 8001:3306 mrfdocker
docker images

'''EN LA TERMINAL DEL HOST:'''

''Instalación de mysql:''

apt install mysql-client-core-5.7
apt-get install mysql-server
service mysql start

''Para entrar:''

mysql -u root -p -P 8001

Una vez dentro de msql:

mysql> show databases;

''Para salir:''

exit

== Ejercicio 6: python pyramid ==

Pyramid es un framework python para implementar webs. Cree una imagen "miapp-pyramid":

* Emplee la imagen de debian como referencia, instale los paquetes python3 y python3-pyramid.
* Cree la carpeta "app"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"
* La aplicación se lanza con la orden: python3 hello.py
* Compruebe que funciona con curl, la ruta a la web es http://127.0.0.1:8000/hello, suponiendo que ha empleado el puerto 8000 para exponer el servicio.

El fichero hello.py contiene un "hola mundo" para Pyramid:

<syntaxhighlight lang="bash">
from wsgiref.simple_server import make_server
from pyramid.config import Configurator
from pyramid.response import Response

def hello_world(request):
print('Request inbound!')
return Response('Podman works with Pyramid!')

if __name__ == '__main__':
config = Configurator()
config.add_route('hello', '/')
config.add_view(hello_world, route_name='hello')
app = config.make_wsgi_app()
server = make_server('0.0.0.0', 6543, app)
server.serve_forever()
</syntaxhighlight>

Este programa recibe peticiones en el puerto 6543.

== Ejercicio 7 ==

Cree una imagen derivada de Ubuntu, instale el paquete apache2, php y libapache2-mod-php.
Active el módulo de php para apache2 mediante la orden:

<syntaxhighlight lang="bash">
a2enmod php
</syntaxhighlight>

Cree la carpeta /var/www/php.

Cree el fichero index.php

<syntaxhighlight lang="php">
<?php
Print "Hello, World!";
?>
</syntaxhighlight>

y copielo a /var/www/php/.

Cree el fichero 000-default.conf y copielo a /etc/apache2/sites-enabled/

Dicho fichero contiene.

<syntaxhighlight lang="bash">
<VirtualHost *:80>
DocumentRoot /var/www/php

<Directory /var/www/php/>
Options Indexes FollowSymLinks MultiViews
AllowOverride All
Order deny,allow
Allow from all
</Directory>

ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>
</syntaxhighlight>

Tiene que lanzar apache con la orden: apachectl -D FOREGROUND

Tras crear la imagen, láncela mapeando el puerto 8888 al 80, pruebe que puede acceder a http://127.0.0.1:8888/php/ mediante curl

Solución:

<syntaxhighlight lang="bash">
FROM ubuntu:latest

RUN apt-get update
RUN apt-get install -y tzdata
RUN apt-get install -y apache2
RUN apt-get install -y php
RUN apt-get install -y libapache2-mod-php
RUN a2enmod php7.2
COPY index.php /var/www/php
COPY 000-default.conf /etc/apache2/sites-enabled/
CMD apachectl -D FOREGROUND
</syntaxhighlight>

Y para lanzarlo:

podman run --name my-app --rm -d -p 8001:8000 app:v1

y para probarlo:

curl -X GET http://127.0.0.1:8888/php/

== Ejercicio 8 ==

Instale el paquete ''netcat-traditional'' en una imagen de contenedor de ''debian''. Lance la orden:

nc -u -l -p 8080

en el contenedor. Asegúrese de crear una redirección de puertos de 9999 desde el ''host'' al puerto 8080 en el contenedor.

Desde fuera del contenedor, pruebe a conectarse con:

nc -u 127.0.0.1 9999

Y escriba texto cualquiera.

Luego, consulte el log del contenedor para que ver que la instancia de netcat dentro del contenedor a recibido el texto que ha escrito.

Recuerde que es una redirección para UDP.

== Ejercicio 9 ==

Cree una imagen derivada de "ubuntu" con un Dockerfile que incluya soporte de python y lance el siguiente código en Python:

<syntaxhighlight lang="python">
from http.server import BaseHTTPRequestHandler, HTTPServer
import time

hostName = "0.0.0.0"
serverPort = 8080

class MyServer(BaseHTTPRequestHandler):
def do_GET(self):
self.send_response(200)
self.send_header("Content-type", "text/html")
self.end_headers()
self.wfile.write(bytes("<html><head><title>Welcome!</title></head>", "utf-8"))
self.wfile.write(bytes("<body>", "utf-8"))
self.wfile.write(bytes("This is an example web server.", "utf-8"))
self.wfile.write(bytes("</body></html>", "utf-8"))

if __name__ == "__main__":
webServer = HTTPServer((hostName, serverPort), MyServer)
print("Server started http://%s:%s" % (hostName, serverPort))

try:
webServer.serve_forever()
except KeyboardInterrupt:
pass

webServer.server_close()
print("Server stopped.")
</syntaxhighlight>

Llame a su imagen "python-http-server". Lance una instancia de la imagen "python-http-server" mapeando el puerto 9999 al puerto 8888/tcp del contenedor. Compruebe con:

<syntaxhighlight lang="bash">
curl http://127.0.0.1:9999/
</syntaxhighlight>

que muestre la página HTML que ofrece el servidor, que debería ser:

<syntaxhighlight lang="bash">
<html><head><title>Welcome!</title></head><body>This is an example web server.</body></html>
</syntaxhighlight>

= Anexo =

* Cómo usar [[Podman compose]]

Contenedores

2025-12-17T12:16:29Z

Pneira:

En esta práctica aprenderemos a utilizar [https://es.wikipedia.org/wiki/Podman podman] para desplegar contenedores.

= Paso 1: Instalar podman =

Para instalar el paquete oficial:

<syntaxhighlight lang="bash">
apt install podman
</syntaxhighlight>

podman es un clon de '''docker''.

Si añade un usuario 'test' a su sistema con:

<syntaxhighlight lang="bash">
adduser test
</syntaxhighlight>

recuerde hacer:

<syntaxhighlight lang="bash">
loginctl enable-linger test
systemctl start --user dbus
</syntaxhighlight>

para evitar un warning que se muestra al ejecutar '''podman''' como usuario.

= Paso 2: Repositorio de imágenes de contenedores DockerHub =

Docker ofrece un servicio de nube denominado ''DockerHub'' que puede ser empleado como red social para compartir tus imágenes de Podman. En ''DockerHub'' existen además imágenes de contenedores preconfiguradas de software, muchas de ellas oficiales (ofrecidas por el propio fabricante del software) que se podrán emplear como base para construir nuevas imágenes adaptadas a nuestras necesidades.

Podremos realizar búsquedas en este repositorio ''DockerHub'' puedes emplear el siguiente comando:

<syntaxhighlight lang="bash">
podman search docker.io/library/hello-world
</syntaxhighlight>

Para descargarnos la imagen de ''hello-world'' podemos usar la orden ''pull'':

<syntaxhighlight lang="bash">
podman pull docker.io/library/hello-world
</syntaxhighlight>

También podemos publicar imágenes propias, esto require '''registro de usuario''' en la nube de ''DockerHub'', lo que '''no''' es obligatorio para la realización de esta práctica. Para subir una imagen, hay que validarse como usuario en la nube de ''DockerHub'':

<syntaxhighlight lang="bash">
podman login docker.io
</syntaxhighlight>

Tras introducir tu usuario y contraseña, puedes comenzar a publicar tus propias imágenes.

<syntaxhighlight lang="bash">
podman push docker.io/USUARIO/MI_IMAGEN
</syntaxhighlight>

Este paso es '''opcional''', sólo en caso de que se quieran subir imágenes de contenedores a la nube de docker.io.

= Paso 4: Comprobar imágenes en nuestra máquina =

Para ver las imágenes que tenemos en nuestra máquina, utilizaremos el comando:

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Inicialmente, no tenemos imágenes en almacenamiento, podemos descargarnos la imagen oficial de Debian 13 (Trixie):

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian
</syntaxhighlight>

Ahora si, ya debería de aparecernos la imagen ''debian''.

Comentar también que cada imagen puede tener varias etiquetas, por ejemplo, la imagen Debian 12 (Bookworm), cuando la hemos visto en el listado de imágenes, venía con el tag latest, que es el tag que se descarga por defecto, pero nosotros podemos especificar otro, por ejemplo:

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian:bookworm
</syntaxhighlight>

Para traernos la versión de la imagen de Debian 12 ''Bookworm''.

Ahora tendremos dos imágenes con diferente etiqueta, que serían como las diferentes versiones de cada imagen.

= Paso 5: Lanzar un contenedor =

Un contenedor no es más que una imagen de podman ejecutándose, sería similar a
una máquina virtual, aunque mucho más liviano.

Para crear un contenedor, utilizaremos una imagen, en este caso, la imagen
hello-world. Hacemos lo siguiente:

<syntaxhighlight lang="bash">
podman run hello-world
</syntaxhighlight>

Esto nos mostrará el siguiente mensaje si todo está correcto:

<syntaxhighlight lang="bash">
Hello from Docker!
This message shows that your installation appears to be working correctly.

To generate this message, Docker took the following steps:
1. The Docker client contacted the Docker daemon.
2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
(amd64)
3. The Docker daemon created a new container from that image which runs the
executable that produces the output you are currently reading.
4. The Docker daemon streamed that output to the Docker client, which sent it
to your terminal.

To try something more ambitious, you can run an Debian container with:
$ podman run -it debian bash

Share images, automate workflows, and more with a free Docker ID:
https://hub.docker.com/

For more examples and ideas, visit:
https://docs.docker.com/get-started/
</syntaxhighlight>

Al crear los contenedores utilizando el comando 'run', tenemos varias opciones:

* Lanzar una terminal en el contenedor en modo interactivo
* Lanzar en segundo plano y conectarnos posteriormente al contenedor

== Paso 5.1: Lanzar una terminal en el contenedor en modo interactivo (-ti) ==

Para este ejemplo vamos a utilizar otra imagen diferente, en este caso vamos a utilizar una imagen de debian.

Vamos a lanzar un contenedor y ejecutar una terminal en el que se va a ejecutar el programa '''bash''' que me ofrece un interprete de órdenes:

<syntaxhighlight lang="bash">
podman run -ti debian bash
</syntaxhighlight>

La opción ''-t'' indica que se crea un terminal en el contenedor. Y la opción ''-i'' indica que el contenedor se ejecuta en modo interactivo.

Al acceder al contenedor de ''debian'' nos aparece un ''hash'' en el prompt de la shell, que identifica a la instancia del contenedor (es valor es similar al que muestra la orden ''podman container ls'').

Para salir del contenedor, escribimos 'exit' o pulsamos ''CTRL + D''

== Paso 5.2 Lanzar en segundo plano (-d) ==

Otro ejemplo, con la imagen de Debian:

<syntaxhighlight lang="bash">
podman run -dti debian
</syntaxhighlight>

que muestra un hash que identifica de forma única el contenedor lanzado:

<syntaxhighlight lang="bash">
2ec1daae4676a4e84dc04fd91399c1dfe92119544ff12ee307991fe573d3db64
</syntaxhighlight>

Mediante el comando ''attach'' puedo entrar al contenedor:

<syntaxhighlight lang="bash">
podman attach 2ec1daae4676
</syntaxhighlight>

Para salir, pulsamos ''CTRL + P'' seguido de ''CTRL + Q''.

De manera similar, puedo lanzar en segundo plano la imagen de contenedor de ''hello-world'':

<syntaxhighlight lang="bash">
podman run -d hello-world
</syntaxhighlight>

Y consultar los logs:

<syntaxhighlight lang="bash">
podman logs b67fae3312bc321
</syntaxhighlight>

== Paso 5.3: Añadir variables de entorno a un contenedor ==

Utilizaremos la imagen anterior, y vamos a añadir una variable de entorno
llamada TEST que contenga el valor 'test'. A parte, también ejecutaremos la
terminal como antes, para comprobar con el comando echo, que la variable de
entorno está creada correctamente:

<syntaxhighlight lang="bash">
podman run -ti -e TEST=test debian bash
</syntaxhighlight>

Ahora, desde el contenedor podemos comprobar el valor de la variable de entorno ''$TEST''.

<syntaxhighlight lang="bash">
echo $TEST
test
</syntaxhighlight>

= Paso 6: Listar contenedores en ejecución =

Hemos estado haciendo pruebas y ejecutando contenedores en el paso anterior, vamos a ver donde se encuentran estos contenedores que hemos ejecutado, y después veremos algunas opciones más del comando run.

Tenemos dos opciones para ver los contenedores:

<syntaxhighlight lang="bash">
podman container ls -a
</syntaxhighlight>

o la versión corta:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Ambas hacen lo mismo, y debería de mostrarnos una salida similar a la siguiente:

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
e2bde5f5500c debian "bash" 6 minutes ago Exited (0) 2 seconds ago pensive_sammet
544ad27dbc3c debian "bash" 7 minutes ago Exited (0) 7 minutes ago serene_elgamal
</syntaxhighlight>

En la información veremos que el contenedor tiene el estado exited, eso quiere decir que no se está ejecutando y ya ha finalizado. Vamos a hacer una prueba para ver un contendor ejecutándose:

<syntaxhighlight lang="bash">
podman run -d debian sleep 30
</syntaxhighlight>

Con el comando sleep 30 esperamos 30 segundos hasta que termine el comando, asíque durante esos 30 segundos, el contenedor estará ejecutándose, veámoslo:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
eacceb27d52d debian "sleep 30" 12 seconds ago Up 11 seconds sharp_pasteur
</syntaxhighlight>

Vamos a ver alguna opciones más de la orden ''run''.

== Paso 6.1: Dar un nombre al contenedor (--name) ==

Por defecto, podman creará automáticamente un nombre como hemos visto en las salidas del comando ''podman ps -a''. Podemos establecer el nombre del contenedor que queramos con la opción ''--name'':

<syntaxhighlight lang="bash">
podman run -ti --name mi_debian debian
</syntaxhighlight>

== Paso 6.2: Eliminar contenedor cuando termine (--rm) ==

Vamos a mezclar todo lo visto anteriormente:

* Lanzar en segundo plano (-d)
* Ejecutar contenedor durante 30 segundos (sleep 30)
* Dar un nombre a la imagen (--name)
* Eliminar contenedor cuando termine (--rm)

<syntaxhighlight lang="bash">
podman run -d --rm --name bye-bye debian sleep 30
</syntaxhighlight>

Antes y una vez pasados los 30 segundos, podemos comprobar que el contenedor ha desaparecido.

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

NOTA: Si usa ''--rm'', los logs del contenedor dejarán de estar disponibles al terminar la ejecución del contenedor.

= Paso 7: Parar y eliminar contenedores =

Para parar contenedores podemos usar el ID o su nombre:

<syntaxhighlight lang="bash">
podman stop my_container
podman stop e4901956f108
podman ps -a
</syntaxhighlight>

Una vez hemos comprobado que han terminado su ejecución, podemos eliminar los ficheros resultantes de su ejecución:

<syntaxhighlight lang="bash">
podman container rm my_container
</syntaxhighlight>

Para borrar todos los contenedores ya finalizados

<syntaxhighlight lang="bash">
podman container prune
</syntaxhighlight>

= Paso 8: Conectarnos a un contenedor que se está ejecutando en segundo plano =

Vamos a ejecutar de nuevo un contenedor que no termine:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a conectarnos a este contenedor que está ejecutándose en segundo
plano:

<syntaxhighlight lang="bash">
podman attach mi-contenedor
</syntaxhighlight>

Veremos la orden bash ejecutándose, para terminar, hacemos un 'CTRL + C', y ahora, veremos que ha pasado con el contenedor:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Lo veremos parado, por que lo que hemos hecho ha sido conectarnos al contenedor
y parar el comando que se estaba ejecutando, así que ahora tenemos el contenedor
finalizado.

''Nota:'' Para salir del contenedor '''sin detenerlo''' hacemos 'CTRL + P' seguido 'CTRL + Q'

= Paso 9: Ejecutar un comando dentro de un contenedor en ejecución =

Vamos a ver otresta vez como ejecutar un comando en un contenedor que ya está
ejecutándose:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a ejecutar un comando en ese contenedor con el nombre ''mi-contenedor''.
El comando exec es similar al comando run, pero para ejecutar un comando dentro de un contenedor:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor ls
</syntaxhighlight>

Para redirigir la salida a un fichero en el anfitrión:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor ls > x.txt
</syntaxhighlight>

Para redirigir la salida a un fichero ''dentro'' del contenedor, hacemos:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor sh -c "ls > x.txt"
</syntaxhighlight>

También es posible ejecutar comandos con tuberías:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor sh -c "ls -la | grep ^d"
</syntaxhighlight>

= Paso 10: Persistencia en contenedores =

Al hacer ''exit'' y salir de un contenedor, se pierden todos los cambios que hemos realizado. Los

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-ejemplo debian bash
</syntaxhighlight>

Ahora, vamos a crear una carpeta en el contenedor y comprobar que esa carpeta existe:

<syntaxhighlight lang="bash">
podman exec mi-ejemplo mkdir test
podman exec mi-ejemplo ls
</syntaxhighlight>

Veremos que la carpeta existe, pero, ¿qué ocurre si para el contenedor?

<syntaxhighlight lang="bash">
podman container stop mi-ejemplo
</syntaxhighlight>

Y volvemos a lanzarlo:

<syntaxhighlight lang="bash">
podman container rm mi-ejemplo
podman run -d -ti --name mi-ejemplo debian bash
podman exec mi-ejemplo ls
</syntaxhighlight>

Podemos comprobar que la carpeta creada anteriormente, no existe.

¿Qué podemos hacer para mantener la modificaciones realizadas sobre un contenedor?

== Paso 10.1: Crear una imagen derivada de la imagen base ==

Es posible crear una imagen derivada, con modificaciones, a partir de una imagen existente mediante la orden '''commit'''.

Por ejemplo, si queremos una imagen ''debian'' que incluya el programa ''ping'' ya instalado, tendríamos que lanzar un contenedor a partir de la imagen ''debian'':

<syntaxhighlight lang="bash">
podman run -d -ti debian bash
</syntaxhighlight>

Suponiendo que el contenido está identificado con el ID 56ef5b312334

Instalamos el paquete ping:

<syntaxhighlight lang="bash">
podman exec 56ef5b312334 apt -y install ping
</syntaxhighlight>

Generamos la imagen derivada con el nombre ''debian-con-ping'':

<syntaxhighlight lang="bash">
podman commit 56ef5b312334 debian-con-ping
</syntaxhighlight>

Ya podemos para nuestro contendor:

<syntaxhighlight lang="bash">
podman stop 56ef5b312334
</syntaxhighlight>

Y lanzar un nuevo contenedor a partir de la imagen ''debian-con-ping'':

<syntaxhighlight lang="bash">
podman run -d -ti debian-con-ping bash
</syntaxhighlight>

== Paso 10.2: Mantener la persistencia mediante volúmen ==

Otra opción para mantener los datos es montar un volumen al ejecutar el contenedor.

Primero crearemos una carpeta que hará de volumen en nuestra máquina, que será la que luego montemos para podman:

<syntaxhighlight lang="bash">
mkdir /home/debian/volumen
</syntaxhighlight>

Ahora vamos a montar la carpeta al ejecutar el contenedor, lo hacemos con la
opción -v, la cual tiene 3 campos separados por ':':

# El volumen en nuestra máquina
# Donde se montará el volumen dentro del contenedor
# Opciones de mmontaje, por ejemplo rw (read and write) o ro (read only)

<syntaxhighlight lang="bash">
podman run --rm -ti -v /home/debian/volumen:/volumen:rw debian bash
mkdir /volumen/test
touch /volumen/test/file
exit
</syntaxhighlight>

Una vez nos salgamos del contenedor, podemos ver que en nuestra máquina están
los datos:

<syntaxhighlight lang="bash">
ls /home/debian/volumen/
ls /home/debian/volumen/test
</syntaxhighlight>

La próxima vez que ejecutemos un contenedor, si montamos ese volumen, los datos
estarán ahí, además esta forma tiene el beneficio de compartir datos entre
nuestra máquina y el contenedor de forma sencilla.

= Paso 11: Crear nuestra propia imagen de contenedor =

Para crear una imagen de un contenedor con una aplicación de Python hug, creamos en primer lugar la carpeta que contendrá los ficheros que nos permiten crear la imagen.

<syntaxhighlight lang="bash">
mkdir miapp
cd miapp
</syntaxhighlight>

Definimos un fichero ''Dockerfile'' para definir la imagen:

<syntaxhighlight lang="bash">
FROM debian

RUN apt -y update
RUN apt -y upgrade
RUN apt -y install python3-hug
RUN mkdir /app
COPY endpoint.py /app
WORKDIR /app
CMD hug -f endpoint.py
</syntaxhighlight>

Alternativamente, puedes crear un [[Creando imagen propia usando Ubuntu de base|Dockerfile empleando la imagen de Ubuntu]] como base en lugar de Alpine.

Y añadimos el fichero ''endpoint.py'' que emplea el framework Python hug con el contenido siguiente:

<syntaxhighlight lang="bash">
import hug

@hug.get('/welcome')
def welcome(username="unknown"):
""" Say welcome to username """
return "Welcome " + username
</syntaxhighlight>

Este fichero es un ejemplo de uso de Python hug. Si hacemos una petición a /welcome?username="LSO", esto nos devolverá el mensaje "Welcome LSO".

Una vez tengamos los dos ficheros creados en nuestra máquina virtual, podemos construir nuestra imagen:

<syntaxhighlight lang="bash">
podman build -t app:v1 -f Dockerfile
</syntaxhighlight>

* -t indica el nombre de la imagen, que pueden venir acompañados de una etiqueta (por ejemplo ''v1'') haciendo uso del separador '':''.
* -f indica el fichero dockerfile a utilizar para construir la imagen.

Esto construirá una imagen de contenedor basada en ''python:alpine'', en la cual hemos guardado nuestra pequeña aplicación y se va a ejecutar cuando ejecutemos un contenedor basado en esa imagen. Para comprobar que la imagen se ha creado correctamente, listamos las imagenes, y debería de aparecernos una imagen con nombre 'app' y tag 'v1':

Vamos a explicar para que sirve cada línea:

* FROM: en tiempo de construcción, indica la imagen de base que se va a emplear para generar nuestra imagen derivada.
* RUN: en tiempo de construcción, qué comandos hay que ejecutar para construir la imagen derivada.
* COPY: en tiempo de construcción, para copiar datos desde el host a la imagen derivada.
* WORKDIR: en tiempo de ejecución, para cambiar el directorio de trabajo (lo crea si no existe)
* CMD: en tiempo de ejecución, que comandos se invocan para lanzar la aplicación.

NOTA: El lenguaje de plantillas de Dockerfile mezcla comandos que se ejecutan en tiempo de construcción (''podman build'') y en tiempo de ejecución (''podman run'').

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen, y vamos a añadir una nueva
opción, -p 8001:8000. Esta opción hará que el puerto interno 8000 del contenedor
sea expuesto en el puerto 8001 de nuestra máquina:

<syntaxhighlight lang="bash">
podman run --name my-app --rm -d -p 8001:8000 app:v1
</syntaxhighlight>

''Nota:'' podman supone que la redirección de puerto es TCP, para una redirección de puertos UDP, puedes usar:

<syntaxhighlight lang="bash">
... -p 8001:8000/udp
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código. En nuestra
máquina haremos:

<syntaxhighlight lang="bash">
curl -X GET http://localhost:8001/welcome?username=LSO
</syntaxhighlight>

Comprobaremos que la salida del comando curl, es "Welcome LSO".

Antes de terminar, vamos a comprobar otro pequeño detalle que añadimos en
nuestra imagen, la variable de entorno USERNAME, vamos a comprobar que funciona:

<syntaxhighlight lang="bash">
podman exec -ti my-app ash
echo $USERNAME
</syntaxhighlight>

Funciona correctamente, pero al ejecutar el contenedor, podemos cambiar esta
variable de entorno como vimos en uno de los pasos anteriores:

<syntaxhighlight lang="bash">
podman run --rm -ti -e USERNAME=me app:v1 ash
echo $USERNAME
</syntaxhighlight>

Esto nos servirá para tener opciones por defecto y que el usuario pueda
cambiarlo a su antojo, como por ejemplo contraseñas u otros detalles.

== Paso 11.1: Depuración de problemas al crear nuestra imagen ==

Hay dos comandos que son particularmente útiles para averiguar por qué nuestra imagen no funciona:

* Consultar si el contenedor está ejecutándose:

<syntaxhighlight lang="bash">
podman container ls
</syntaxhighlight>

Que nos permite ver si el contenedor está activa y la redirección de puertos es correcta.

* Consultar los logs del contenedor:

<syntaxhighlight lang="bash">
podman logs 345fb5d21
</syntaxhighlight>

Esto nos permite saber qué está pasando dentro del contenedor, o qué pasó si éste dejo terminó su ejecución.

NOTA: Si usas la opción --rm al ejecutar tu contenedor, ¡los logs no estarán disponibles!

= Paso 12: Eliminar imágenes =

Para borrar una imagen, puede hacer:

<syntaxhighlight lang="bash">
podman image rm hello-world
</syntaxhighlight>

= Paso 13: Ejercicios =

== Ejercicio 1: Image derivada de Debian con el programa sl ==

Lance un contenedor a partir de una imagen de Debian, instale el programa sl, ejecute sl (desde fuera del contenedor) y detenga el contenedor.

== Ejercicio 2 ==

== Ejercicio 3: Variante de httpd ==

Construya una imagen ''httpd-hola-mundo'' a partir de la imagen ''httpd''. El fichero de index.html de la carpeta htdocs/ tiene que mostrar el mensaje "hola mundo".

<syntaxhighlight lang="bash">
podman pull httpd
</syntaxhighlight>

Edita el fichero Dockerfile:

<syntaxhighlight lang="bash">
nano Dockerfile
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
FROM httpd

COPY index.html htdocs/index.html
</syntaxhighlight>

Edita el fichero index.html:

<syntaxhighlight lang="bash">
nano index.html
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

Construye la imagen:

<syntaxhighlight lang="bash">
podman build -t mihttpd -f Dockerfile
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen:

<syntaxhighlight lang="bash">
podman run --name mihttpd -d -p 8080:80 mihttpd
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código:
<syntaxhighlight lang="bash">
curl -X GET http://localhost:8080
</syntaxhighlight>

Tiene que salir por pantalla esto:
<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

== Ejercicio 4: aplicación flask ==

Flask es un framework python para implementar webs. Cree una imagen "miapp-flask" a partir de la imagen de "python":

* Instale flask mediante: pip install flask
* Cree la carpeta "app"
* Establezca la variable FLASK_APP a "hello.py"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"

El fichero hello.py contiene un "hola mundo" para Flask:

<syntaxhighlight lang="python">
from flask import Flask
app = Flask(__name__)

@app.route("/")
def hello():
return "Hello World!"

if __name__ == "__main__":
app.run()
</syntaxhighlight>

Solución con alpine:

<syntaxhighlight lang="bash">
FROM python:alpine

RUN mkdir /app
RUN pip install flask
ENV FLASK_APP="app/hello.py"
COPY hello.py
WORKDIR /
CMD flask run --host=0.0.0.0
</syntaxhighlight>

Solución con Ubuntu:

<syntaxhighlight lang="bash">
FROM ubuntu:bionic

RUN apt-get update
RUN apt-get -y install python python-pip wget
RUN pip install Flask
ENV FLASK_APP="app/hello.py"
RUN mkdir /app
COPY hello.py /app
CMD flask run --host=0.0.0.0
</syntaxhighlight>

== Ejercicio 5: mysql ==

'''EN LA MÁQUINA VIRTUAL:'''

mkdir miapp
cd miapp
podman pull mysql
nano Dockerfile

<syntaxhighlight lang="bash">
FROM mysql
ENV MYSQL_ROOT_PASSWORD="lacontraseñaqueyoquiera"
RUN mkdir /app
WORKDIR /app

</syntaxhighlight>

CTRL+O , ENTER Y CTRL+X (para guardar Dockerfile y salir)

podman build -ti mrfdocker -f Dockerfile
podman run --name mymrf --rm -p 8001:3306 mrfdocker
docker images

'''EN LA TERMINAL DEL HOST:'''

''Instalación de mysql:''

apt install mysql-client-core-5.7
apt-get install mysql-server
service mysql start

''Para entrar:''

mysql -u root -p -P 8001

Una vez dentro de msql:

mysql> show databases;

''Para salir:''

exit

== Ejercicio 6: python pyramid ==

Pyramid es un framework python para implementar webs. Cree una imagen "miapp-pyramid":

* Emplee la imagen de debian como referencia, instale los paquetes python3 y python3-pyramid.
* Cree la carpeta "app"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"
* La aplicación se lanza con la orden: python3 hello.py
* Compruebe que funciona con curl, la ruta a la web es http://127.0.0.1:8000/hello, suponiendo que ha empleado el puerto 8000 para exponer el servicio.

El fichero hello.py contiene un "hola mundo" para Pyramid:

<syntaxhighlight lang="bash">
from wsgiref.simple_server import make_server
from pyramid.config import Configurator
from pyramid.response import Response

def hello_world(request):
print('Request inbound!')
return Response('Podman works with Pyramid!')

if __name__ == '__main__':
config = Configurator()
config.add_route('hello', '/')
config.add_view(hello_world, route_name='hello')
app = config.make_wsgi_app()
server = make_server('0.0.0.0', 6543, app)
server.serve_forever()
</syntaxhighlight>

Este programa recibe peticiones en el puerto 6543.

== Ejercicio 7 ==

Cree una imagen derivada de Ubuntu, instale el paquete apache2, php y libapache2-mod-php.
Active el módulo de php para apache2 mediante la orden:

<syntaxhighlight lang="bash">
a2enmod php
</syntaxhighlight>

Cree la carpeta /var/www/php.

Cree el fichero index.php

<syntaxhighlight lang="php">
<?php
Print "Hello, World!";
?>
</syntaxhighlight>

y copielo a /var/www/php/.

Cree el fichero 000-default.conf y copielo a /etc/apache2/sites-enabled/

Dicho fichero contiene.

<syntaxhighlight lang="bash">
<VirtualHost *:80>
DocumentRoot /var/www/php

<Directory /var/www/php/>
Options Indexes FollowSymLinks MultiViews
AllowOverride All
Order deny,allow
Allow from all
</Directory>

ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>
</syntaxhighlight>

Tiene que lanzar apache con la orden: apachectl -D FOREGROUND

Tras crear la imagen, láncela mapeando el puerto 8888 al 80, pruebe que puede acceder a http://127.0.0.1:8888/php/ mediante curl

Solución:

<syntaxhighlight lang="bash">
FROM ubuntu:latest

RUN apt-get update
RUN apt-get install -y tzdata
RUN apt-get install -y apache2
RUN apt-get install -y php
RUN apt-get install -y libapache2-mod-php
RUN a2enmod php7.2
COPY index.php /var/www/php
COPY 000-default.conf /etc/apache2/sites-enabled/
CMD apachectl -D FOREGROUND
</syntaxhighlight>

Y para lanzarlo:

podman run --name my-app --rm -d -p 8001:8000 app:v1

y para probarlo:

curl -X GET http://127.0.0.1:8888/php/

== Ejercicio 8 ==

Instale el paquete ''netcat-traditional'' en una imagen de contenedor de ''ubuntu''. Lance la orden:

nc -u -l -p 8080

en el contenedor. Asegúrese de crear una redirección de puertos de 9999 desde el ''host'' al puerto 8080 en el contenedor.

Desde fuera del contenedor, pruebe a conectarse con:

nc -u 127.0.0.1 9999

== Ejercicio 9 ==

Cree una imagen derivada de "ubuntu" con un Dockerfile que incluya soporte de python y lance el siguiente código en Python:

<syntaxhighlight lang="python">
from http.server import BaseHTTPRequestHandler, HTTPServer
import time

hostName = "0.0.0.0"
serverPort = 8080

class MyServer(BaseHTTPRequestHandler):
def do_GET(self):
self.send_response(200)
self.send_header("Content-type", "text/html")
self.end_headers()
self.wfile.write(bytes("<html><head><title>Welcome!</title></head>", "utf-8"))
self.wfile.write(bytes("<body>", "utf-8"))
self.wfile.write(bytes("This is an example web server.", "utf-8"))
self.wfile.write(bytes("</body></html>", "utf-8"))

if __name__ == "__main__":
webServer = HTTPServer((hostName, serverPort), MyServer)
print("Server started http://%s:%s" % (hostName, serverPort))

try:
webServer.serve_forever()
except KeyboardInterrupt:
pass

webServer.server_close()
print("Server stopped.")
</syntaxhighlight>

Llame a su imagen "python-http-server". Lance una instancia de la imagen "python-http-server" mapeando el puerto 9999 al puerto 8888/tcp del contenedor. Compruebe con:

<syntaxhighlight lang="bash">
curl http://127.0.0.1:9999/
</syntaxhighlight>

que muestre la página HTML que ofrece el servidor, que debería ser:

<syntaxhighlight lang="bash">
<html><head><title>Welcome!</title></head><body>This is an example web server.</body></html>
</syntaxhighlight>

= Anexo =

* Cómo usar [[Podman compose]]

Contenedores

2025-12-17T12:14:00Z

Pneira: /* Paso 6.2: Eliminar contenedor cuando termine (--rm) */

En esta práctica aprenderemos a utilizar [https://es.wikipedia.org/wiki/Podman podman] para desplegar contenedores.

= Paso 1: Instalar podman =

Para instalar el paquete oficial:

<syntaxhighlight lang="bash">
apt install podman
</syntaxhighlight>

podman es un clon de '''docker''.

Si añade un usuario 'test' a su sistema con:

<syntaxhighlight lang="bash">
adduser test
</syntaxhighlight>

recuerde hacer:

<syntaxhighlight lang="bash">
loginctl enable-linger test
systemctl start --user dbus
</syntaxhighlight>

para evitar un warning que se muestra al ejecutar '''podman''' como usuario.

= Paso 2: Repositorio de imágenes de contenedores DockerHub =

Docker ofrece un servicio de nube denominado ''DockerHub'' que puede ser empleado como red social para compartir tus imágenes de Podman. En ''DockerHub'' existen además imágenes de contenedores preconfiguradas de software, muchas de ellas oficiales (ofrecidas por el propio fabricante del software) que se podrán emplear como base para construir nuevas imágenes adaptadas a nuestras necesidades.

Podremos realizar búsquedas en este repositorio ''DockerHub'' puedes emplear el siguiente comando:

<syntaxhighlight lang="bash">
podman search docker.io/library/hello-world
</syntaxhighlight>

Para descargarnos la imagen de ''hello-world'' podemos usar la orden ''pull'':

<syntaxhighlight lang="bash">
podman pull docker.io/library/hello-world
</syntaxhighlight>

También podemos publicar imágenes propias, esto require '''registro de usuario''' en la nube de ''DockerHub'', lo que '''no''' es obligatorio para la realización de esta práctica. Para subir una imagen, hay que validarse como usuario en la nube de ''DockerHub'':

<syntaxhighlight lang="bash">
podman login docker.io
</syntaxhighlight>

Tras introducir tu usuario y contraseña, puedes comenzar a publicar tus propias imágenes.

<syntaxhighlight lang="bash">
podman push docker.io/USUARIO/MI_IMAGEN
</syntaxhighlight>

Este paso es '''opcional''', sólo en caso de que se quieran subir imágenes de contenedores a la nube de docker.io.

= Paso 4: Comprobar imágenes en nuestra máquina =

Para ver las imágenes que tenemos en nuestra máquina, utilizaremos el comando:

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Inicialmente, no tenemos imágenes en almacenamiento, podemos descargarnos la imagen oficial de Debian 13 (Trixie):

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian
</syntaxhighlight>

Ahora si, ya debería de aparecernos la imagen ''debian''.

Comentar también que cada imagen puede tener varias etiquetas, por ejemplo, la imagen Debian 12 (Bookworm), cuando la hemos visto en el listado de imágenes, venía con el tag latest, que es el tag que se descarga por defecto, pero nosotros podemos especificar otro, por ejemplo:

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian:bookworm
</syntaxhighlight>

Para traernos la versión de la imagen de Debian 12 ''Bookworm''.

Ahora tendremos dos imágenes con diferente etiqueta, que serían como las diferentes versiones de cada imagen.

= Paso 5: Lanzar un contenedor =

Un contenedor no es más que una imagen de podman ejecutándose, sería similar a
una máquina virtual, aunque mucho más liviano.

Para crear un contenedor, utilizaremos una imagen, en este caso, la imagen
hello-world. Hacemos lo siguiente:

<syntaxhighlight lang="bash">
podman run hello-world
</syntaxhighlight>

Esto nos mostrará el siguiente mensaje si todo está correcto:

<syntaxhighlight lang="bash">
Hello from Docker!
This message shows that your installation appears to be working correctly.

To generate this message, Docker took the following steps:
1. The Docker client contacted the Docker daemon.
2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
(amd64)
3. The Docker daemon created a new container from that image which runs the
executable that produces the output you are currently reading.
4. The Docker daemon streamed that output to the Docker client, which sent it
to your terminal.

To try something more ambitious, you can run an Debian container with:
$ podman run -it debian bash

Share images, automate workflows, and more with a free Docker ID:
https://hub.docker.com/

For more examples and ideas, visit:
https://docs.docker.com/get-started/
</syntaxhighlight>

Al crear los contenedores utilizando el comando 'run', tenemos varias opciones:

* Lanzar una terminal en el contenedor en modo interactivo
* Lanzar en segundo plano y conectarnos posteriormente al contenedor

== Paso 5.1: Lanzar una terminal en el contenedor en modo interactivo (-ti) ==

Para este ejemplo vamos a utilizar otra imagen diferente, en este caso vamos a utilizar una imagen de debian.

Vamos a lanzar un contenedor y ejecutar una terminal en el que se va a ejecutar el programa '''bash''' que me ofrece un interprete de órdenes:

<syntaxhighlight lang="bash">
podman run -ti debian bash
</syntaxhighlight>

La opción ''-t'' indica que se crea un terminal en el contenedor. Y la opción ''-i'' indica que el contenedor se ejecuta en modo interactivo.

Al acceder al contenedor de ''debian'' nos aparece un ''hash'' en el prompt de la shell, que identifica a la instancia del contenedor (es valor es similar al que muestra la orden ''podman container ls'').

Para salir del contenedor, escribimos 'exit' o pulsamos ''CTRL + D''

== Paso 5.2 Lanzar en segundo plano (-d) ==

Otro ejemplo, con la imagen de Debian:

<syntaxhighlight lang="bash">
podman run -dti debian
</syntaxhighlight>

que muestra un hash que identifica de forma única el contenedor lanzado:

<syntaxhighlight lang="bash">
2ec1daae4676a4e84dc04fd91399c1dfe92119544ff12ee307991fe573d3db64
</syntaxhighlight>

Mediante el comando ''attach'' puedo entrar al contenedor:

<syntaxhighlight lang="bash">
podman attach 2ec1daae4676
</syntaxhighlight>

Para salir, pulsamos ''CTRL + P'' seguido de ''CTRL + Q''.

De manera similar, puedo lanzar en segundo plano la imagen de contenedor de ''hello-world'':

<syntaxhighlight lang="bash">
podman run -d hello-world
</syntaxhighlight>

Y consultar los logs:

<syntaxhighlight lang="bash">
podman logs b67fae3312bc321
</syntaxhighlight>

== Paso 5.3: Añadir variables de entorno a un contenedor ==

Utilizaremos la imagen anterior, y vamos a añadir una variable de entorno
llamada TEST que contenga el valor 'test'. A parte, también ejecutaremos la
terminal como antes, para comprobar con el comando echo, que la variable de
entorno está creada correctamente:

<syntaxhighlight lang="bash">
podman run -ti -e TEST=test debian bash
</syntaxhighlight>

Ahora, desde el contenedor podemos comprobar el valor de la variable de entorno ''$TEST''.

<syntaxhighlight lang="bash">
echo $TEST
test
</syntaxhighlight>

= Paso 6: Listar contenedores en ejecución =

Hemos estado haciendo pruebas y ejecutando contenedores en el paso anterior, vamos a ver donde se encuentran estos contenedores que hemos ejecutado, y después veremos algunas opciones más del comando run.

Tenemos dos opciones para ver los contenedores:

<syntaxhighlight lang="bash">
podman container ls -a
</syntaxhighlight>

o la versión corta:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Ambas hacen lo mismo, y debería de mostrarnos una salida similar a la siguiente:

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
e2bde5f5500c debian "bash" 6 minutes ago Exited (0) 2 seconds ago pensive_sammet
544ad27dbc3c debian "bash" 7 minutes ago Exited (0) 7 minutes ago serene_elgamal
</syntaxhighlight>

En la información veremos que el contenedor tiene el estado exited, eso quiere decir que no se está ejecutando y ya ha finalizado. Vamos a hacer una prueba para ver un contendor ejecutándose:

<syntaxhighlight lang="bash">
podman run -d debian sleep 30
</syntaxhighlight>

Con el comando sleep 30 esperamos 30 segundos hasta que termine el comando, asíque durante esos 30 segundos, el contenedor estará ejecutándose, veámoslo:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
eacceb27d52d debian "sleep 30" 12 seconds ago Up 11 seconds sharp_pasteur
</syntaxhighlight>

Vamos a ver alguna opciones más de la orden ''run''.

== Paso 6.1: Dar un nombre al contenedor (--name) ==

Por defecto, podman creará automáticamente un nombre como hemos visto en las salidas del comando ''podman ps -a''. Podemos establecer el nombre del contenedor que queramos con la opción ''--name'':

<syntaxhighlight lang="bash">
podman run -ti --name mi_debian debian
</syntaxhighlight>

== Paso 6.2: Eliminar contenedor cuando termine (--rm) ==

Vamos a mezclar todo lo visto anteriormente:

* Lanzar en segundo plano (-d)
* Ejecutar contenedor durante 30 segundos (sleep 30)
* Dar un nombre a la imagen (--name)
* Eliminar contenedor cuando termine (--rm)

<syntaxhighlight lang="bash">
podman run -d --rm --name bye-bye debian sleep 30
</syntaxhighlight>

Antes y una vez pasados los 30 segundos, podemos comprobar que el contenedor ha desaparecido.

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

NOTA: Si usa ''--rm'', los logs del contenedor dejarán de estar disponibles al terminar la ejecución del contenedor.

= Paso 7: Parar y eliminar contenedores =

Para parar contenedores podemos usar el ID o su nombre:

<syntaxhighlight lang="bash">
podman stop my_container
podman stop e4901956f108
podman ps -a
</syntaxhighlight>

Una vez hemos comprobado que han terminado su ejecución, podemos eliminar los ficheros resultantes de su ejecución:

<syntaxhighlight lang="bash">
podman container rm my_container
</syntaxhighlight>

Para borrar todos los contenedores ya finalizados

<syntaxhighlight lang="bash">
podman container prune
</syntaxhighlight>

= Paso 8: Conectarnos a un contenedor que se está ejecutando en segundo plano =

Vamos a ejecutar de nuevo un contenedor que no termine:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a conectarnos a este contenedor que está ejecutándose en segundo
plano:

<syntaxhighlight lang="bash">
podman attach mi-contenedor
</syntaxhighlight>

Veremos la orden bash ejecutándose, para terminar, hacemos un 'CTRL + C', y ahora, veremos que ha pasado con el contenedor:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Lo veremos parado, por que lo que hemos hecho ha sido conectarnos al contenedor
y parar el comando que se estaba ejecutando, así que ahora tenemos el contenedor
finalizado.

''Nota:'' Para salir del contenedor '''sin detenerlo''' hacemos 'CTRL + P' seguido 'CTRL + Q'

= Paso 9: Ejecutar un comando dentro de un contenedor en ejecución =

Vamos a ver otresta vez como ejecutar un comando en un contenedor que ya está
ejecutándose:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a ejecutar un comando en ese contenedor con el nombre ''mi-contenedor''.
El comando exec es similar al comando run, pero para ejecutar un comando dentro de un contenedor:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor ls
</syntaxhighlight>

Para redirigir la salida a un fichero en el anfitrión:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor ls > x.txt
</syntaxhighlight>

Para redirigir la salida a un fichero ''dentro'' del contenedor, hacemos:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor sh -c "ls > x.txt"
</syntaxhighlight>

También es posible ejecutar comandos con tuberías:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor sh -c "ls -la | grep ^d"
</syntaxhighlight>

= Paso 10: Persistencia en contenedores =

Al hacer ''exit'' y salir de un contenedor, se pierden todos los cambios que hemos realizado. Los

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-ejemplo debian bash
</syntaxhighlight>

Ahora, vamos a crear una carpeta en el contenedor y comprobar que esa carpeta existe:

<syntaxhighlight lang="bash">
podman exec mi-ejemplo mkdir test
podman exec mi-ejemplo ls
</syntaxhighlight>

Veremos que la carpeta existe, pero, ¿qué ocurre si para el contenedor?

<syntaxhighlight lang="bash">
podman container stop mi-ejemplo
</syntaxhighlight>

Y volvemos a lanzarlo:

<syntaxhighlight lang="bash">
podman container rm mi-ejemplo
podman run -d -ti --name mi-ejemplo debian bash
podman exec mi-ejemplo ls
</syntaxhighlight>

Podemos comprobar que la carpeta creada anteriormente, no existe.

¿Qué podemos hacer para mantener la modificaciones realizadas sobre un contenedor?

== Paso 10.1: Crear una imagen derivada de la imagen base ==

Es posible crear una imagen derivada, con modificaciones, a partir de una imagen existente mediante la orden '''commit'''.

Por ejemplo, si queremos una imagen ''debian'' que incluya el programa ''ping'' ya instalado, tendríamos que lanzar un contenedor a partir de la imagen ''ubuntu'':

<syntaxhighlight lang="bash">
podman run -d -ti debian bash
</syntaxhighlight>

Suponiendo que el contenido está identificado con el ID 56ef5b312334

Instalamos el paquete ping:

<syntaxhighlight lang="bash">
podman exec 56ef5b312334 apt -y install ping
</syntaxhighlight>

Generamos la imagen derivada con el nombre ''ubuntu-con-ping'':

<syntaxhighlight lang="bash">
podman commit 56ef5b312334 ubuntu-con-ping
</syntaxhighlight>

Ya podemos para nuestro contendor:

<syntaxhighlight lang="bash">
podman stop 56ef5b312334
</syntaxhighlight>

Y lanzar un nuevo contenedor a partir de la imagen ''debian-con-ping'':

<syntaxhighlight lang="bash">
podman run -d -ti debian-con-ping bash
</syntaxhighlight>

== Paso 10.2: Mantener la persistencia mediante volúmen ==

Otra opción para mantener los datos es montar un volumen al ejecutar el contenedor.

Primero crearemos una carpeta que hará de volumen en nuestra máquina, que será la que luego montemos para podman:

<syntaxhighlight lang="bash">
mkdir /home/debian/volumen
</syntaxhighlight>

Ahora vamos a montar la carpeta al ejecutar el contenedor, lo hacemos con la
opción -v, la cual tiene 3 campos separados por ':':

# El volumen en nuestra máquina
# Donde se montará el volumen dentro del contenedor
# Opciones de mmontaje, por ejemplo rw (read and write) o ro (read only)

<syntaxhighlight lang="bash">
podman run --rm -ti -v /home/debian/volumen:/volumen:rw debian bash
mkdir /volumen/test
touch /volumen/test/file
exit
</syntaxhighlight>

Una vez nos salgamos del contenedor, podemos ver que en nuestra máquina están
los datos:

<syntaxhighlight lang="bash">
ls /home/ubuntu/volumen/
ls /home/ubuntu/volumen/test
</syntaxhighlight>

La próxima vez que ejecutemos un contenedor, si montamos ese volumen, los datos
estarán ahí, además esta forma tiene el beneficio de compartir datos entre
nuestra máquina y el contenedor de forma sencilla.

= Paso 11: Crear nuestra propia imagen de contenedor =

Para crear una imagen de un contenedor con una aplicación de Python hug, creamos en primer lugar la carpeta que contendrá los ficheros que nos permiten crear la imagen.

<syntaxhighlight lang="bash">
mkdir miapp
cd miapp
</syntaxhighlight>

Definimos un fichero ''Dockerfile'' para definir la imagen:

<syntaxhighlight lang="bash">
FROM debian

RUN apt -y update
RUN apt -y upgrade
RUN apt -y install python3-hug
RUN mkdir /app
COPY endpoint.py /app
WORKDIR /app
CMD hug -f endpoint.py
</syntaxhighlight>

Alternativamente, puedes crear un [[Creando imagen propia usando Ubuntu de base|Dockerfile empleando la imagen de Ubuntu]] como base en lugar de Alpine.

Y añadimos el fichero ''endpoint.py'' que emplea el framework Python hug con el contenido siguiente:

<syntaxhighlight lang="bash">
import hug

@hug.get('/welcome')
def welcome(username="unknown"):
""" Say welcome to username """
return "Welcome " + username
</syntaxhighlight>

Este fichero es un ejemplo de uso de Python hug. Si hacemos una petición a /welcome?username="LSO", esto nos devolverá el mensaje "Welcome LSO".

Una vez tengamos los dos ficheros creados en nuestra máquina virtual, podemos construir nuestra imagen:

<syntaxhighlight lang="bash">
podman build -t app:v1 -f Dockerfile
</syntaxhighlight>

* -t indica el nombre de la imagen, que pueden venir acompañados de una etiqueta (por ejemplo ''v1'') haciendo uso del separador '':''.
* -f indica el fichero dockerfile a utilizar para construir la imagen.

Esto construirá una imagen de contenedor basada en ''python:alpine'', en la cual hemos guardado nuestra pequeña aplicación y se va a ejecutar cuando ejecutemos un contenedor basado en esa imagen. Para comprobar que la imagen se ha creado correctamente, listamos las imagenes, y debería de aparecernos una imagen con nombre 'app' y tag 'v1':

Vamos a explicar para que sirve cada línea:

* FROM: en tiempo de construcción, indica la imagen de base que se va a emplear para generar nuestra imagen derivada.
* RUN: en tiempo de construcción, qué comandos hay que ejecutar para construir la imagen derivada.
* COPY: en tiempo de construcción, para copiar datos desde el host a la imagen derivada.
* WORKDIR: en tiempo de ejecución, para cambiar el directorio de trabajo (lo crea si no existe)
* CMD: en tiempo de ejecución, que comandos se invocan para lanzar la aplicación.

NOTA: El lenguaje de plantillas de Dockerfile mezcla comandos que se ejecutan en tiempo de construcción (''podman build'') y en tiempo de ejecución (''podman run'').

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen, y vamos a añadir una nueva
opción, -p 8001:8000. Esta opción hará que el puerto interno 8000 del contenedor
sea expuesto en el puerto 8001 de nuestra máquina:

<syntaxhighlight lang="bash">
podman run --name my-app --rm -d -p 8001:8000 app:v1
</syntaxhighlight>

''Nota:'' podman supone que la redirección de puerto es TCP, para una redirección de puertos UDP, puedes usar:

<syntaxhighlight lang="bash">
... -p 8001:8000/udp
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código. En nuestra
máquina haremos:

<syntaxhighlight lang="bash">
curl -X GET http://localhost:8001/welcome?username=LSO
</syntaxhighlight>

Comprobaremos que la salida del comando curl, es "Welcome LSO".

Antes de terminar, vamos a comprobar otro pequeño detalle que añadimos en
nuestra imagen, la variable de entorno USERNAME, vamos a comprobar que funciona:

<syntaxhighlight lang="bash">
podman exec -ti my-app ash
echo $USERNAME
</syntaxhighlight>

Funciona correctamente, pero al ejecutar el contenedor, podemos cambiar esta
variable de entorno como vimos en uno de los pasos anteriores:

<syntaxhighlight lang="bash">
podman run --rm -ti -e USERNAME=me app:v1 ash
echo $USERNAME
</syntaxhighlight>

Esto nos servirá para tener opciones por defecto y que el usuario pueda
cambiarlo a su antojo, como por ejemplo contraseñas u otros detalles.

== Paso 11.1: Depuración de problemas al crear nuestra imagen ==

Hay dos comandos que son particularmente útiles para averiguar por qué nuestra imagen no funciona:

* Consultar si el contenedor está ejecutándose:

<syntaxhighlight lang="bash">
podman container ls
</syntaxhighlight>

Que nos permite ver si el contenedor está activa y la redirección de puertos es correcta.

* Consultar los logs del contenedor:

<syntaxhighlight lang="bash">
podman logs 345fb5d21
</syntaxhighlight>

Esto nos permite saber qué está pasando dentro del contenedor, o qué pasó si éste dejo terminó su ejecución.

NOTA: Si usas la opción --rm al ejecutar tu contenedor, ¡los logs no estarán disponibles!

= Paso 12: Eliminar imágenes =

Para borrar una imagen, puede hacer:

<syntaxhighlight lang="bash">
podman image rm hello-world
</syntaxhighlight>

= Paso 13: Ejercicios =

== Ejercicio 1: Image derivada de Debian con el programa sl ==

Lance un contenedor a partir de una imagen de Debian, instale el programa sl, ejecute sl (desde fuera del contenedor) y detenga el contenedor.

== Ejercicio 2 ==

== Ejercicio 3: Variante de httpd ==

Construya una imagen ''httpd-hola-mundo'' a partir de la imagen ''httpd''. El fichero de index.html de la carpeta htdocs/ tiene que mostrar el mensaje "hola mundo".

<syntaxhighlight lang="bash">
podman pull httpd
</syntaxhighlight>

Edita el fichero Dockerfile:

<syntaxhighlight lang="bash">
nano Dockerfile
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
FROM httpd

COPY index.html htdocs/index.html
</syntaxhighlight>

Edita el fichero index.html:

<syntaxhighlight lang="bash">
nano index.html
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

Construye la imagen:

<syntaxhighlight lang="bash">
podman build -t mihttpd -f Dockerfile
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen:

<syntaxhighlight lang="bash">
podman run --name mihttpd -d -p 8080:80 mihttpd
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código:
<syntaxhighlight lang="bash">
curl -X GET http://localhost:8080
</syntaxhighlight>

Tiene que salir por pantalla esto:
<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

== Ejercicio 4: aplicación flask ==

Flask es un framework python para implementar webs. Cree una imagen "miapp-flask" a partir de la imagen de "python":

* Instale flask mediante: pip install flask
* Cree la carpeta "app"
* Establezca la variable FLASK_APP a "hello.py"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"

El fichero hello.py contiene un "hola mundo" para Flask:

<syntaxhighlight lang="python">
from flask import Flask
app = Flask(__name__)

@app.route("/")
def hello():
return "Hello World!"

if __name__ == "__main__":
app.run()
</syntaxhighlight>

Solución con alpine:

<syntaxhighlight lang="bash">
FROM python:alpine

RUN mkdir /app
RUN pip install flask
ENV FLASK_APP="app/hello.py"
COPY hello.py
WORKDIR /
CMD flask run --host=0.0.0.0
</syntaxhighlight>

Solución con Ubuntu:

<syntaxhighlight lang="bash">
FROM ubuntu:bionic

RUN apt-get update
RUN apt-get -y install python python-pip wget
RUN pip install Flask
ENV FLASK_APP="app/hello.py"
RUN mkdir /app
COPY hello.py /app
CMD flask run --host=0.0.0.0
</syntaxhighlight>

== Ejercicio 5: mysql ==

'''EN LA MÁQUINA VIRTUAL:'''

mkdir miapp
cd miapp
podman pull mysql
nano Dockerfile

<syntaxhighlight lang="bash">
FROM mysql
ENV MYSQL_ROOT_PASSWORD="lacontraseñaqueyoquiera"
RUN mkdir /app
WORKDIR /app

</syntaxhighlight>

CTRL+O , ENTER Y CTRL+X (para guardar Dockerfile y salir)

podman build -ti mrfdocker -f Dockerfile
podman run --name mymrf --rm -p 8001:3306 mrfdocker
docker images

'''EN LA TERMINAL DEL HOST:'''

''Instalación de mysql:''

apt install mysql-client-core-5.7
apt-get install mysql-server
service mysql start

''Para entrar:''

mysql -u root -p -P 8001

Una vez dentro de msql:

mysql> show databases;

''Para salir:''

exit

== Ejercicio 6: python pyramid ==

Pyramid es un framework python para implementar webs. Cree una imagen "miapp-pyramid":

* Emplee la imagen de debian como referencia, instale los paquetes python3 y python3-pyramid.
* Cree la carpeta "app"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"
* La aplicación se lanza con la orden: python3 hello.py
* Compruebe que funciona con curl, la ruta a la web es http://127.0.0.1:8000/hello, suponiendo que ha empleado el puerto 8000 para exponer el servicio.

El fichero hello.py contiene un "hola mundo" para Pyramid:

<syntaxhighlight lang="bash">
from wsgiref.simple_server import make_server
from pyramid.config import Configurator
from pyramid.response import Response

def hello_world(request):
print('Request inbound!')
return Response('Podman works with Pyramid!')

if __name__ == '__main__':
config = Configurator()
config.add_route('hello', '/')
config.add_view(hello_world, route_name='hello')
app = config.make_wsgi_app()
server = make_server('0.0.0.0', 6543, app)
server.serve_forever()
</syntaxhighlight>

Este programa recibe peticiones en el puerto 6543.

== Ejercicio 7 ==

Cree una imagen derivada de Ubuntu, instale el paquete apache2, php y libapache2-mod-php.
Active el módulo de php para apache2 mediante la orden:

<syntaxhighlight lang="bash">
a2enmod php
</syntaxhighlight>

Cree la carpeta /var/www/php.

Cree el fichero index.php

<syntaxhighlight lang="php">
<?php
Print "Hello, World!";
?>
</syntaxhighlight>

y copielo a /var/www/php/.

Cree el fichero 000-default.conf y copielo a /etc/apache2/sites-enabled/

Dicho fichero contiene.

<syntaxhighlight lang="bash">
<VirtualHost *:80>
DocumentRoot /var/www/php

<Directory /var/www/php/>
Options Indexes FollowSymLinks MultiViews
AllowOverride All
Order deny,allow
Allow from all
</Directory>

ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>
</syntaxhighlight>

Tiene que lanzar apache con la orden: apachectl -D FOREGROUND

Tras crear la imagen, láncela mapeando el puerto 8888 al 80, pruebe que puede acceder a http://127.0.0.1:8888/php/ mediante curl

Solución:

<syntaxhighlight lang="bash">
FROM ubuntu:latest

RUN apt-get update
RUN apt-get install -y tzdata
RUN apt-get install -y apache2
RUN apt-get install -y php
RUN apt-get install -y libapache2-mod-php
RUN a2enmod php7.2
COPY index.php /var/www/php
COPY 000-default.conf /etc/apache2/sites-enabled/
CMD apachectl -D FOREGROUND
</syntaxhighlight>

Y para lanzarlo:

podman run --name my-app --rm -d -p 8001:8000 app:v1

y para probarlo:

curl -X GET http://127.0.0.1:8888/php/

== Ejercicio 8 ==

Instale el paquete ''netcat-traditional'' en una imagen de contenedor de ''ubuntu''. Lance la orden:

nc -u -l -p 8080

en el contenedor. Asegúrese de crear una redirección de puertos de 9999 desde el ''host'' al puerto 8080 en el contenedor.

Desde fuera del contenedor, pruebe a conectarse con:

nc -u 127.0.0.1 9999

== Ejercicio 9 ==

Cree una imagen derivada de "ubuntu" con un Dockerfile que incluya soporte de python y lance el siguiente código en Python:

<syntaxhighlight lang="python">
from http.server import BaseHTTPRequestHandler, HTTPServer
import time

hostName = "0.0.0.0"
serverPort = 8080

class MyServer(BaseHTTPRequestHandler):
def do_GET(self):
self.send_response(200)
self.send_header("Content-type", "text/html")
self.end_headers()
self.wfile.write(bytes("<html><head><title>Welcome!</title></head>", "utf-8"))
self.wfile.write(bytes("<body>", "utf-8"))
self.wfile.write(bytes("This is an example web server.", "utf-8"))
self.wfile.write(bytes("</body></html>", "utf-8"))

if __name__ == "__main__":
webServer = HTTPServer((hostName, serverPort), MyServer)
print("Server started http://%s:%s" % (hostName, serverPort))

try:
webServer.serve_forever()
except KeyboardInterrupt:
pass

webServer.server_close()
print("Server stopped.")
</syntaxhighlight>

Llame a su imagen "python-http-server". Lance una instancia de la imagen "python-http-server" mapeando el puerto 9999 al puerto 8888/tcp del contenedor. Compruebe con:

<syntaxhighlight lang="bash">
curl http://127.0.0.1:9999/
</syntaxhighlight>

que muestre la página HTML que ofrece el servidor, que debería ser:

<syntaxhighlight lang="bash">
<html><head><title>Welcome!</title></head><body>This is an example web server.</body></html>
</syntaxhighlight>

= Anexo =

* Cómo usar [[Podman compose]]

Contenedores

2025-12-17T12:11:25Z

Pneira: /* Paso 11: Crear nuestra propia imagen de contenedor */

En esta práctica aprenderemos a utilizar [https://es.wikipedia.org/wiki/Podman podman] para desplegar contenedores.

= Paso 1: Instalar podman =

Para instalar el paquete oficial:

<syntaxhighlight lang="bash">
apt install podman
</syntaxhighlight>

podman es un clon de '''docker''.

Si añade un usuario 'test' a su sistema con:

<syntaxhighlight lang="bash">
adduser test
</syntaxhighlight>

recuerde hacer:

<syntaxhighlight lang="bash">
loginctl enable-linger test
systemctl start --user dbus
</syntaxhighlight>

para evitar un warning que se muestra al ejecutar '''podman''' como usuario.

= Paso 2: Repositorio de imágenes de contenedores DockerHub =

Docker ofrece un servicio de nube denominado ''DockerHub'' que puede ser empleado como red social para compartir tus imágenes de Podman. En ''DockerHub'' existen además imágenes de contenedores preconfiguradas de software, muchas de ellas oficiales (ofrecidas por el propio fabricante del software) que se podrán emplear como base para construir nuevas imágenes adaptadas a nuestras necesidades.

Podremos realizar búsquedas en este repositorio ''DockerHub'' puedes emplear el siguiente comando:

<syntaxhighlight lang="bash">
podman search docker.io/library/hello-world
</syntaxhighlight>

Para descargarnos la imagen de ''hello-world'' podemos usar la orden ''pull'':

<syntaxhighlight lang="bash">
podman pull docker.io/library/hello-world
</syntaxhighlight>

También podemos publicar imágenes propias, esto require '''registro de usuario''' en la nube de ''DockerHub'', lo que '''no''' es obligatorio para la realización de esta práctica. Para subir una imagen, hay que validarse como usuario en la nube de ''DockerHub'':

<syntaxhighlight lang="bash">
podman login docker.io
</syntaxhighlight>

Tras introducir tu usuario y contraseña, puedes comenzar a publicar tus propias imágenes.

<syntaxhighlight lang="bash">
podman push docker.io/USUARIO/MI_IMAGEN
</syntaxhighlight>

Este paso es '''opcional''', sólo en caso de que se quieran subir imágenes de contenedores a la nube de docker.io.

= Paso 4: Comprobar imágenes en nuestra máquina =

Para ver las imágenes que tenemos en nuestra máquina, utilizaremos el comando:

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Inicialmente, no tenemos imágenes en almacenamiento, podemos descargarnos la imagen oficial de Debian 13 (Trixie):

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian
</syntaxhighlight>

Ahora si, ya debería de aparecernos la imagen ''debian''.

Comentar también que cada imagen puede tener varias etiquetas, por ejemplo, la imagen Debian 12 (Bookworm), cuando la hemos visto en el listado de imágenes, venía con el tag latest, que es el tag que se descarga por defecto, pero nosotros podemos especificar otro, por ejemplo:

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian:bookworm
</syntaxhighlight>

Para traernos la versión de la imagen de Debian 12 ''Bookworm''.

Ahora tendremos dos imágenes con diferente etiqueta, que serían como las diferentes versiones de cada imagen.

= Paso 5: Lanzar un contenedor =

Un contenedor no es más que una imagen de podman ejecutándose, sería similar a
una máquina virtual, aunque mucho más liviano.

Para crear un contenedor, utilizaremos una imagen, en este caso, la imagen
hello-world. Hacemos lo siguiente:

<syntaxhighlight lang="bash">
podman run hello-world
</syntaxhighlight>

Esto nos mostrará el siguiente mensaje si todo está correcto:

<syntaxhighlight lang="bash">
Hello from Docker!
This message shows that your installation appears to be working correctly.

To generate this message, Docker took the following steps:
1. The Docker client contacted the Docker daemon.
2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
(amd64)
3. The Docker daemon created a new container from that image which runs the
executable that produces the output you are currently reading.
4. The Docker daemon streamed that output to the Docker client, which sent it
to your terminal.

To try something more ambitious, you can run an Debian container with:
$ podman run -it debian bash

Share images, automate workflows, and more with a free Docker ID:
https://hub.docker.com/

For more examples and ideas, visit:
https://docs.docker.com/get-started/
</syntaxhighlight>

Al crear los contenedores utilizando el comando 'run', tenemos varias opciones:

* Lanzar una terminal en el contenedor en modo interactivo
* Lanzar en segundo plano y conectarnos posteriormente al contenedor

== Paso 5.1: Lanzar una terminal en el contenedor en modo interactivo (-ti) ==

Para este ejemplo vamos a utilizar otra imagen diferente, en este caso vamos a utilizar una imagen de debian.

Vamos a lanzar un contenedor y ejecutar una terminal en el que se va a ejecutar el programa '''bash''' que me ofrece un interprete de órdenes:

<syntaxhighlight lang="bash">
podman run -ti debian bash
</syntaxhighlight>

La opción ''-t'' indica que se crea un terminal en el contenedor. Y la opción ''-i'' indica que el contenedor se ejecuta en modo interactivo.

Al acceder al contenedor de ''debian'' nos aparece un ''hash'' en el prompt de la shell, que identifica a la instancia del contenedor (es valor es similar al que muestra la orden ''podman container ls'').

Para salir del contenedor, escribimos 'exit' o pulsamos ''CTRL + D''

== Paso 5.2 Lanzar en segundo plano (-d) ==

Otro ejemplo, con la imagen de Debian:

<syntaxhighlight lang="bash">
podman run -dti debian
</syntaxhighlight>

que muestra un hash que identifica de forma única el contenedor lanzado:

<syntaxhighlight lang="bash">
2ec1daae4676a4e84dc04fd91399c1dfe92119544ff12ee307991fe573d3db64
</syntaxhighlight>

Mediante el comando ''attach'' puedo entrar al contenedor:

<syntaxhighlight lang="bash">
podman attach 2ec1daae4676
</syntaxhighlight>

Para salir, pulsamos ''CTRL + P'' seguido de ''CTRL + Q''.

De manera similar, puedo lanzar en segundo plano la imagen de contenedor de ''hello-world'':

<syntaxhighlight lang="bash">
podman run -d hello-world
</syntaxhighlight>

Y consultar los logs:

<syntaxhighlight lang="bash">
podman logs b67fae3312bc321
</syntaxhighlight>

== Paso 5.3: Añadir variables de entorno a un contenedor ==

Utilizaremos la imagen anterior, y vamos a añadir una variable de entorno
llamada TEST que contenga el valor 'test'. A parte, también ejecutaremos la
terminal como antes, para comprobar con el comando echo, que la variable de
entorno está creada correctamente:

<syntaxhighlight lang="bash">
podman run -ti -e TEST=test debian bash
</syntaxhighlight>

Ahora, desde el contenedor podemos comprobar el valor de la variable de entorno ''$TEST''.

<syntaxhighlight lang="bash">
echo $TEST
test
</syntaxhighlight>

= Paso 6: Listar contenedores en ejecución =

Hemos estado haciendo pruebas y ejecutando contenedores en el paso anterior, vamos a ver donde se encuentran estos contenedores que hemos ejecutado, y después veremos algunas opciones más del comando run.

Tenemos dos opciones para ver los contenedores:

<syntaxhighlight lang="bash">
podman container ls -a
</syntaxhighlight>

o la versión corta:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Ambas hacen lo mismo, y debería de mostrarnos una salida similar a la siguiente:

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
e2bde5f5500c debian "bash" 6 minutes ago Exited (0) 2 seconds ago pensive_sammet
544ad27dbc3c debian "bash" 7 minutes ago Exited (0) 7 minutes ago serene_elgamal
</syntaxhighlight>

En la información veremos que el contenedor tiene el estado exited, eso quiere decir que no se está ejecutando y ya ha finalizado. Vamos a hacer una prueba para ver un contendor ejecutándose:

<syntaxhighlight lang="bash">
podman run -d debian sleep 30
</syntaxhighlight>

Con el comando sleep 30 esperamos 30 segundos hasta que termine el comando, asíque durante esos 30 segundos, el contenedor estará ejecutándose, veámoslo:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
eacceb27d52d debian "sleep 30" 12 seconds ago Up 11 seconds sharp_pasteur
</syntaxhighlight>

Vamos a ver alguna opciones más de la orden ''run''.

== Paso 6.1: Dar un nombre al contenedor (--name) ==

Por defecto, podman creará automáticamente un nombre como hemos visto en las salidas del comando ''podman ps -a''. Podemos establecer el nombre del contenedor que queramos con la opción ''--name'':

<syntaxhighlight lang="bash">
podman run -ti --name mi_debian debian
</syntaxhighlight>

== Paso 6.2: Eliminar contenedor cuando termine (--rm) ==

Vamos a mezclar todo lo visto anteriormente:

* Lanzar en segundo plano (-d)
* Ejecutar contenedor durante 30 segundos (sleep 30)
* Dar un nombre a la imagen (--name)
* Eliminar contenedor cuando termine (--rm)

<syntaxhighlight lang="bash">
podman run -d --rm --name bye-bye debian sleep 30
</syntaxhighlight>

Antes y una vez pasados los 30 segundos, podemos comprobar que el contenedor ha desaparecido.

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

= Paso 7: Parar y eliminar contenedores =

Para parar contenedores podemos usar el ID o su nombre:

<syntaxhighlight lang="bash">
podman stop my_container
podman stop e4901956f108
podman ps -a
</syntaxhighlight>

Una vez hemos comprobado que han terminado su ejecución, podemos eliminar los ficheros resultantes de su ejecución:

<syntaxhighlight lang="bash">
podman container rm my_container
</syntaxhighlight>

Para borrar todos los contenedores ya finalizados

<syntaxhighlight lang="bash">
podman container prune
</syntaxhighlight>

= Paso 8: Conectarnos a un contenedor que se está ejecutando en segundo plano =

Vamos a ejecutar de nuevo un contenedor que no termine:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a conectarnos a este contenedor que está ejecutándose en segundo
plano:

<syntaxhighlight lang="bash">
podman attach mi-contenedor
</syntaxhighlight>

Veremos la orden bash ejecutándose, para terminar, hacemos un 'CTRL + C', y ahora, veremos que ha pasado con el contenedor:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Lo veremos parado, por que lo que hemos hecho ha sido conectarnos al contenedor
y parar el comando que se estaba ejecutando, así que ahora tenemos el contenedor
finalizado.

''Nota:'' Para salir del contenedor '''sin detenerlo''' hacemos 'CTRL + P' seguido 'CTRL + Q'

= Paso 9: Ejecutar un comando dentro de un contenedor en ejecución =

Vamos a ver otresta vez como ejecutar un comando en un contenedor que ya está
ejecutándose:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a ejecutar un comando en ese contenedor con el nombre ''mi-contenedor''.
El comando exec es similar al comando run, pero para ejecutar un comando dentro de un contenedor:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor ls
</syntaxhighlight>

Para redirigir la salida a un fichero en el anfitrión:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor ls > x.txt
</syntaxhighlight>

Para redirigir la salida a un fichero ''dentro'' del contenedor, hacemos:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor sh -c "ls > x.txt"
</syntaxhighlight>

También es posible ejecutar comandos con tuberías:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor sh -c "ls -la | grep ^d"
</syntaxhighlight>

= Paso 10: Persistencia en contenedores =

Al hacer ''exit'' y salir de un contenedor, se pierden todos los cambios que hemos realizado. Los

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-ejemplo debian bash
</syntaxhighlight>

Ahora, vamos a crear una carpeta en el contenedor y comprobar que esa carpeta existe:

<syntaxhighlight lang="bash">
podman exec mi-ejemplo mkdir test
podman exec mi-ejemplo ls
</syntaxhighlight>

Veremos que la carpeta existe, pero, ¿qué ocurre si para el contenedor?

<syntaxhighlight lang="bash">
podman container stop mi-ejemplo
</syntaxhighlight>

Y volvemos a lanzarlo:

<syntaxhighlight lang="bash">
podman container rm mi-ejemplo
podman run -d -ti --name mi-ejemplo debian bash
podman exec mi-ejemplo ls
</syntaxhighlight>

Podemos comprobar que la carpeta creada anteriormente, no existe.

¿Qué podemos hacer para mantener la modificaciones realizadas sobre un contenedor?

== Paso 10.1: Crear una imagen derivada de la imagen base ==

Es posible crear una imagen derivada, con modificaciones, a partir de una imagen existente mediante la orden '''commit'''.

Por ejemplo, si queremos una imagen ''debian'' que incluya el programa ''ping'' ya instalado, tendríamos que lanzar un contenedor a partir de la imagen ''ubuntu'':

<syntaxhighlight lang="bash">
podman run -d -ti debian bash
</syntaxhighlight>

Suponiendo que el contenido está identificado con el ID 56ef5b312334

Instalamos el paquete ping:

<syntaxhighlight lang="bash">
podman exec 56ef5b312334 apt -y install ping
</syntaxhighlight>

Generamos la imagen derivada con el nombre ''ubuntu-con-ping'':

<syntaxhighlight lang="bash">
podman commit 56ef5b312334 ubuntu-con-ping
</syntaxhighlight>

Ya podemos para nuestro contendor:

<syntaxhighlight lang="bash">
podman stop 56ef5b312334
</syntaxhighlight>

Y lanzar un nuevo contenedor a partir de la imagen ''debian-con-ping'':

<syntaxhighlight lang="bash">
podman run -d -ti debian-con-ping bash
</syntaxhighlight>

== Paso 10.2: Mantener la persistencia mediante volúmen ==

Otra opción para mantener los datos es montar un volumen al ejecutar el contenedor.

Primero crearemos una carpeta que hará de volumen en nuestra máquina, que será la que luego montemos para podman:

<syntaxhighlight lang="bash">
mkdir /home/debian/volumen
</syntaxhighlight>

Ahora vamos a montar la carpeta al ejecutar el contenedor, lo hacemos con la
opción -v, la cual tiene 3 campos separados por ':':

# El volumen en nuestra máquina
# Donde se montará el volumen dentro del contenedor
# Opciones de mmontaje, por ejemplo rw (read and write) o ro (read only)

<syntaxhighlight lang="bash">
podman run --rm -ti -v /home/debian/volumen:/volumen:rw debian bash
mkdir /volumen/test
touch /volumen/test/file
exit
</syntaxhighlight>

Una vez nos salgamos del contenedor, podemos ver que en nuestra máquina están
los datos:

<syntaxhighlight lang="bash">
ls /home/ubuntu/volumen/
ls /home/ubuntu/volumen/test
</syntaxhighlight>

La próxima vez que ejecutemos un contenedor, si montamos ese volumen, los datos
estarán ahí, además esta forma tiene el beneficio de compartir datos entre
nuestra máquina y el contenedor de forma sencilla.

= Paso 11: Crear nuestra propia imagen de contenedor =

Para crear una imagen de un contenedor con una aplicación de Python hug, creamos en primer lugar la carpeta que contendrá los ficheros que nos permiten crear la imagen.

<syntaxhighlight lang="bash">
mkdir miapp
cd miapp
</syntaxhighlight>

Definimos un fichero ''Dockerfile'' para definir la imagen:

<syntaxhighlight lang="bash">
FROM debian

RUN apt -y update
RUN apt -y upgrade
RUN apt -y install python3-hug
RUN mkdir /app
COPY endpoint.py /app
WORKDIR /app
CMD hug -f endpoint.py
</syntaxhighlight>

Alternativamente, puedes crear un [[Creando imagen propia usando Ubuntu de base|Dockerfile empleando la imagen de Ubuntu]] como base en lugar de Alpine.

Y añadimos el fichero ''endpoint.py'' que emplea el framework Python hug con el contenido siguiente:

<syntaxhighlight lang="bash">
import hug

@hug.get('/welcome')
def welcome(username="unknown"):
""" Say welcome to username """
return "Welcome " + username
</syntaxhighlight>

Este fichero es un ejemplo de uso de Python hug. Si hacemos una petición a /welcome?username="LSO", esto nos devolverá el mensaje "Welcome LSO".

Una vez tengamos los dos ficheros creados en nuestra máquina virtual, podemos construir nuestra imagen:

<syntaxhighlight lang="bash">
podman build -t app:v1 -f Dockerfile
</syntaxhighlight>

* -t indica el nombre de la imagen, que pueden venir acompañados de una etiqueta (por ejemplo ''v1'') haciendo uso del separador '':''.
* -f indica el fichero dockerfile a utilizar para construir la imagen.

Esto construirá una imagen de contenedor basada en ''python:alpine'', en la cual hemos guardado nuestra pequeña aplicación y se va a ejecutar cuando ejecutemos un contenedor basado en esa imagen. Para comprobar que la imagen se ha creado correctamente, listamos las imagenes, y debería de aparecernos una imagen con nombre 'app' y tag 'v1':

Vamos a explicar para que sirve cada línea:

* FROM: en tiempo de construcción, indica la imagen de base que se va a emplear para generar nuestra imagen derivada.
* RUN: en tiempo de construcción, qué comandos hay que ejecutar para construir la imagen derivada.
* COPY: en tiempo de construcción, para copiar datos desde el host a la imagen derivada.
* WORKDIR: en tiempo de ejecución, para cambiar el directorio de trabajo (lo crea si no existe)
* CMD: en tiempo de ejecución, que comandos se invocan para lanzar la aplicación.

NOTA: El lenguaje de plantillas de Dockerfile mezcla comandos que se ejecutan en tiempo de construcción (''podman build'') y en tiempo de ejecución (''podman run'').

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen, y vamos a añadir una nueva
opción, -p 8001:8000. Esta opción hará que el puerto interno 8000 del contenedor
sea expuesto en el puerto 8001 de nuestra máquina:

<syntaxhighlight lang="bash">
podman run --name my-app --rm -d -p 8001:8000 app:v1
</syntaxhighlight>

''Nota:'' podman supone que la redirección de puerto es TCP, para una redirección de puertos UDP, puedes usar:

<syntaxhighlight lang="bash">
... -p 8001:8000/udp
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código. En nuestra
máquina haremos:

<syntaxhighlight lang="bash">
curl -X GET http://localhost:8001/welcome?username=LSO
</syntaxhighlight>

Comprobaremos que la salida del comando curl, es "Welcome LSO".

Antes de terminar, vamos a comprobar otro pequeño detalle que añadimos en
nuestra imagen, la variable de entorno USERNAME, vamos a comprobar que funciona:

<syntaxhighlight lang="bash">
podman exec -ti my-app ash
echo $USERNAME
</syntaxhighlight>

Funciona correctamente, pero al ejecutar el contenedor, podemos cambiar esta
variable de entorno como vimos en uno de los pasos anteriores:

<syntaxhighlight lang="bash">
podman run --rm -ti -e USERNAME=me app:v1 ash
echo $USERNAME
</syntaxhighlight>

Esto nos servirá para tener opciones por defecto y que el usuario pueda
cambiarlo a su antojo, como por ejemplo contraseñas u otros detalles.

== Paso 11.1: Depuración de problemas al crear nuestra imagen ==

Hay dos comandos que son particularmente útiles para averiguar por qué nuestra imagen no funciona:

* Consultar si el contenedor está ejecutándose:

<syntaxhighlight lang="bash">
podman container ls
</syntaxhighlight>

Que nos permite ver si el contenedor está activa y la redirección de puertos es correcta.

* Consultar los logs del contenedor:

<syntaxhighlight lang="bash">
podman logs 345fb5d21
</syntaxhighlight>

Esto nos permite saber qué está pasando dentro del contenedor, o qué pasó si éste dejo terminó su ejecución.

NOTA: Si usas la opción --rm al ejecutar tu contenedor, ¡los logs no estarán disponibles!

= Paso 12: Eliminar imágenes =

Para borrar una imagen, puede hacer:

<syntaxhighlight lang="bash">
podman image rm hello-world
</syntaxhighlight>

= Paso 13: Ejercicios =

== Ejercicio 1: Image derivada de Debian con el programa sl ==

Lance un contenedor a partir de una imagen de Debian, instale el programa sl, ejecute sl (desde fuera del contenedor) y detenga el contenedor.

== Ejercicio 2 ==

== Ejercicio 3: Variante de httpd ==

Construya una imagen ''httpd-hola-mundo'' a partir de la imagen ''httpd''. El fichero de index.html de la carpeta htdocs/ tiene que mostrar el mensaje "hola mundo".

<syntaxhighlight lang="bash">
podman pull httpd
</syntaxhighlight>

Edita el fichero Dockerfile:

<syntaxhighlight lang="bash">
nano Dockerfile
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
FROM httpd

COPY index.html htdocs/index.html
</syntaxhighlight>

Edita el fichero index.html:

<syntaxhighlight lang="bash">
nano index.html
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

Construye la imagen:

<syntaxhighlight lang="bash">
podman build -t mihttpd -f Dockerfile
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen:

<syntaxhighlight lang="bash">
podman run --name mihttpd -d -p 8080:80 mihttpd
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código:
<syntaxhighlight lang="bash">
curl -X GET http://localhost:8080
</syntaxhighlight>

Tiene que salir por pantalla esto:
<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

== Ejercicio 4: aplicación flask ==

Flask es un framework python para implementar webs. Cree una imagen "miapp-flask" a partir de la imagen de "python":

* Instale flask mediante: pip install flask
* Cree la carpeta "app"
* Establezca la variable FLASK_APP a "hello.py"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"

El fichero hello.py contiene un "hola mundo" para Flask:

<syntaxhighlight lang="python">
from flask import Flask
app = Flask(__name__)

@app.route("/")
def hello():
return "Hello World!"

if __name__ == "__main__":
app.run()
</syntaxhighlight>

Solución con alpine:

<syntaxhighlight lang="bash">
FROM python:alpine

RUN mkdir /app
RUN pip install flask
ENV FLASK_APP="app/hello.py"
COPY hello.py
WORKDIR /
CMD flask run --host=0.0.0.0
</syntaxhighlight>

Solución con Ubuntu:

<syntaxhighlight lang="bash">
FROM ubuntu:bionic

RUN apt-get update
RUN apt-get -y install python python-pip wget
RUN pip install Flask
ENV FLASK_APP="app/hello.py"
RUN mkdir /app
COPY hello.py /app
CMD flask run --host=0.0.0.0
</syntaxhighlight>

== Ejercicio 5: mysql ==

'''EN LA MÁQUINA VIRTUAL:'''

mkdir miapp
cd miapp
podman pull mysql
nano Dockerfile

<syntaxhighlight lang="bash">
FROM mysql
ENV MYSQL_ROOT_PASSWORD="lacontraseñaqueyoquiera"
RUN mkdir /app
WORKDIR /app

</syntaxhighlight>

CTRL+O , ENTER Y CTRL+X (para guardar Dockerfile y salir)

podman build -ti mrfdocker -f Dockerfile
podman run --name mymrf --rm -p 8001:3306 mrfdocker
docker images

'''EN LA TERMINAL DEL HOST:'''

''Instalación de mysql:''

apt install mysql-client-core-5.7
apt-get install mysql-server
service mysql start

''Para entrar:''

mysql -u root -p -P 8001

Una vez dentro de msql:

mysql> show databases;

''Para salir:''

exit

== Ejercicio 6: python pyramid ==

Pyramid es un framework python para implementar webs. Cree una imagen "miapp-pyramid":

* Emplee la imagen de debian como referencia, instale los paquetes python3 y python3-pyramid.
* Cree la carpeta "app"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"
* La aplicación se lanza con la orden: python3 hello.py
* Compruebe que funciona con curl, la ruta a la web es http://127.0.0.1:8000/hello, suponiendo que ha empleado el puerto 8000 para exponer el servicio.

El fichero hello.py contiene un "hola mundo" para Pyramid:

<syntaxhighlight lang="bash">
from wsgiref.simple_server import make_server
from pyramid.config import Configurator
from pyramid.response import Response

def hello_world(request):
print('Request inbound!')
return Response('Podman works with Pyramid!')

if __name__ == '__main__':
config = Configurator()
config.add_route('hello', '/')
config.add_view(hello_world, route_name='hello')
app = config.make_wsgi_app()
server = make_server('0.0.0.0', 6543, app)
server.serve_forever()
</syntaxhighlight>

Este programa recibe peticiones en el puerto 6543.

== Ejercicio 7 ==

Cree una imagen derivada de Ubuntu, instale el paquete apache2, php y libapache2-mod-php.
Active el módulo de php para apache2 mediante la orden:

<syntaxhighlight lang="bash">
a2enmod php
</syntaxhighlight>

Cree la carpeta /var/www/php.

Cree el fichero index.php

<syntaxhighlight lang="php">
<?php
Print "Hello, World!";
?>
</syntaxhighlight>

y copielo a /var/www/php/.

Cree el fichero 000-default.conf y copielo a /etc/apache2/sites-enabled/

Dicho fichero contiene.

<syntaxhighlight lang="bash">
<VirtualHost *:80>
DocumentRoot /var/www/php

<Directory /var/www/php/>
Options Indexes FollowSymLinks MultiViews
AllowOverride All
Order deny,allow
Allow from all
</Directory>

ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>
</syntaxhighlight>

Tiene que lanzar apache con la orden: apachectl -D FOREGROUND

Tras crear la imagen, láncela mapeando el puerto 8888 al 80, pruebe que puede acceder a http://127.0.0.1:8888/php/ mediante curl

Solución:

<syntaxhighlight lang="bash">
FROM ubuntu:latest

RUN apt-get update
RUN apt-get install -y tzdata
RUN apt-get install -y apache2
RUN apt-get install -y php
RUN apt-get install -y libapache2-mod-php
RUN a2enmod php7.2
COPY index.php /var/www/php
COPY 000-default.conf /etc/apache2/sites-enabled/
CMD apachectl -D FOREGROUND
</syntaxhighlight>

Y para lanzarlo:

podman run --name my-app --rm -d -p 8001:8000 app:v1

y para probarlo:

curl -X GET http://127.0.0.1:8888/php/

== Ejercicio 8 ==

Instale el paquete ''netcat-traditional'' en una imagen de contenedor de ''ubuntu''. Lance la orden:

nc -u -l -p 8080

en el contenedor. Asegúrese de crear una redirección de puertos de 9999 desde el ''host'' al puerto 8080 en el contenedor.

Desde fuera del contenedor, pruebe a conectarse con:

nc -u 127.0.0.1 9999

== Ejercicio 9 ==

Cree una imagen derivada de "ubuntu" con un Dockerfile que incluya soporte de python y lance el siguiente código en Python:

<syntaxhighlight lang="python">
from http.server import BaseHTTPRequestHandler, HTTPServer
import time

hostName = "0.0.0.0"
serverPort = 8080

class MyServer(BaseHTTPRequestHandler):
def do_GET(self):
self.send_response(200)
self.send_header("Content-type", "text/html")
self.end_headers()
self.wfile.write(bytes("<html><head><title>Welcome!</title></head>", "utf-8"))
self.wfile.write(bytes("<body>", "utf-8"))
self.wfile.write(bytes("This is an example web server.", "utf-8"))
self.wfile.write(bytes("</body></html>", "utf-8"))

if __name__ == "__main__":
webServer = HTTPServer((hostName, serverPort), MyServer)
print("Server started http://%s:%s" % (hostName, serverPort))

try:
webServer.serve_forever()
except KeyboardInterrupt:
pass

webServer.server_close()
print("Server stopped.")
</syntaxhighlight>

Llame a su imagen "python-http-server". Lance una instancia de la imagen "python-http-server" mapeando el puerto 9999 al puerto 8888/tcp del contenedor. Compruebe con:

<syntaxhighlight lang="bash">
curl http://127.0.0.1:9999/
</syntaxhighlight>

que muestre la página HTML que ofrece el servidor, que debería ser:

<syntaxhighlight lang="bash">
<html><head><title>Welcome!</title></head><body>This is an example web server.</body></html>
</syntaxhighlight>

= Anexo =

* Cómo usar [[Podman compose]]

Contenedores

2025-12-17T12:08:41Z

Pneira: /* Paso 11: Crear nuestra propia imagen de contenedor */

En esta práctica aprenderemos a utilizar [https://es.wikipedia.org/wiki/Podman podman] para desplegar contenedores.

= Paso 1: Instalar podman =

Para instalar el paquete oficial:

<syntaxhighlight lang="bash">
apt install podman
</syntaxhighlight>

podman es un clon de '''docker''.

Si añade un usuario 'test' a su sistema con:

<syntaxhighlight lang="bash">
adduser test
</syntaxhighlight>

recuerde hacer:

<syntaxhighlight lang="bash">
loginctl enable-linger test
systemctl start --user dbus
</syntaxhighlight>

para evitar un warning que se muestra al ejecutar '''podman''' como usuario.

= Paso 2: Repositorio de imágenes de contenedores DockerHub =

Docker ofrece un servicio de nube denominado ''DockerHub'' que puede ser empleado como red social para compartir tus imágenes de Podman. En ''DockerHub'' existen además imágenes de contenedores preconfiguradas de software, muchas de ellas oficiales (ofrecidas por el propio fabricante del software) que se podrán emplear como base para construir nuevas imágenes adaptadas a nuestras necesidades.

Podremos realizar búsquedas en este repositorio ''DockerHub'' puedes emplear el siguiente comando:

<syntaxhighlight lang="bash">
podman search docker.io/library/hello-world
</syntaxhighlight>

Para descargarnos la imagen de ''hello-world'' podemos usar la orden ''pull'':

<syntaxhighlight lang="bash">
podman pull docker.io/library/hello-world
</syntaxhighlight>

También podemos publicar imágenes propias, esto require '''registro de usuario''' en la nube de ''DockerHub'', lo que '''no''' es obligatorio para la realización de esta práctica. Para subir una imagen, hay que validarse como usuario en la nube de ''DockerHub'':

<syntaxhighlight lang="bash">
podman login docker.io
</syntaxhighlight>

Tras introducir tu usuario y contraseña, puedes comenzar a publicar tus propias imágenes.

<syntaxhighlight lang="bash">
podman push docker.io/USUARIO/MI_IMAGEN
</syntaxhighlight>

Este paso es '''opcional''', sólo en caso de que se quieran subir imágenes de contenedores a la nube de docker.io.

= Paso 4: Comprobar imágenes en nuestra máquina =

Para ver las imágenes que tenemos en nuestra máquina, utilizaremos el comando:

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Inicialmente, no tenemos imágenes en almacenamiento, podemos descargarnos la imagen oficial de Debian 13 (Trixie):

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian
</syntaxhighlight>

Ahora si, ya debería de aparecernos la imagen ''debian''.

Comentar también que cada imagen puede tener varias etiquetas, por ejemplo, la imagen Debian 12 (Bookworm), cuando la hemos visto en el listado de imágenes, venía con el tag latest, que es el tag que se descarga por defecto, pero nosotros podemos especificar otro, por ejemplo:

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian:bookworm
</syntaxhighlight>

Para traernos la versión de la imagen de Debian 12 ''Bookworm''.

Ahora tendremos dos imágenes con diferente etiqueta, que serían como las diferentes versiones de cada imagen.

= Paso 5: Lanzar un contenedor =

Un contenedor no es más que una imagen de podman ejecutándose, sería similar a
una máquina virtual, aunque mucho más liviano.

Para crear un contenedor, utilizaremos una imagen, en este caso, la imagen
hello-world. Hacemos lo siguiente:

<syntaxhighlight lang="bash">
podman run hello-world
</syntaxhighlight>

Esto nos mostrará el siguiente mensaje si todo está correcto:

<syntaxhighlight lang="bash">
Hello from Docker!
This message shows that your installation appears to be working correctly.

To generate this message, Docker took the following steps:
1. The Docker client contacted the Docker daemon.
2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
(amd64)
3. The Docker daemon created a new container from that image which runs the
executable that produces the output you are currently reading.
4. The Docker daemon streamed that output to the Docker client, which sent it
to your terminal.

To try something more ambitious, you can run an Debian container with:
$ podman run -it debian bash

Share images, automate workflows, and more with a free Docker ID:
https://hub.docker.com/

For more examples and ideas, visit:
https://docs.docker.com/get-started/
</syntaxhighlight>

Al crear los contenedores utilizando el comando 'run', tenemos varias opciones:

* Lanzar una terminal en el contenedor en modo interactivo
* Lanzar en segundo plano y conectarnos posteriormente al contenedor

== Paso 5.1: Lanzar una terminal en el contenedor en modo interactivo (-ti) ==

Para este ejemplo vamos a utilizar otra imagen diferente, en este caso vamos a utilizar una imagen de debian.

Vamos a lanzar un contenedor y ejecutar una terminal en el que se va a ejecutar el programa '''bash''' que me ofrece un interprete de órdenes:

<syntaxhighlight lang="bash">
podman run -ti debian bash
</syntaxhighlight>

La opción ''-t'' indica que se crea un terminal en el contenedor. Y la opción ''-i'' indica que el contenedor se ejecuta en modo interactivo.

Al acceder al contenedor de ''debian'' nos aparece un ''hash'' en el prompt de la shell, que identifica a la instancia del contenedor (es valor es similar al que muestra la orden ''podman container ls'').

Para salir del contenedor, escribimos 'exit' o pulsamos ''CTRL + D''

== Paso 5.2 Lanzar en segundo plano (-d) ==

Otro ejemplo, con la imagen de Debian:

<syntaxhighlight lang="bash">
podman run -dti debian
</syntaxhighlight>

que muestra un hash que identifica de forma única el contenedor lanzado:

<syntaxhighlight lang="bash">
2ec1daae4676a4e84dc04fd91399c1dfe92119544ff12ee307991fe573d3db64
</syntaxhighlight>

Mediante el comando ''attach'' puedo entrar al contenedor:

<syntaxhighlight lang="bash">
podman attach 2ec1daae4676
</syntaxhighlight>

Para salir, pulsamos ''CTRL + P'' seguido de ''CTRL + Q''.

De manera similar, puedo lanzar en segundo plano la imagen de contenedor de ''hello-world'':

<syntaxhighlight lang="bash">
podman run -d hello-world
</syntaxhighlight>

Y consultar los logs:

<syntaxhighlight lang="bash">
podman logs b67fae3312bc321
</syntaxhighlight>

== Paso 5.3: Añadir variables de entorno a un contenedor ==

Utilizaremos la imagen anterior, y vamos a añadir una variable de entorno
llamada TEST que contenga el valor 'test'. A parte, también ejecutaremos la
terminal como antes, para comprobar con el comando echo, que la variable de
entorno está creada correctamente:

<syntaxhighlight lang="bash">
podman run -ti -e TEST=test debian bash
</syntaxhighlight>

Ahora, desde el contenedor podemos comprobar el valor de la variable de entorno ''$TEST''.

<syntaxhighlight lang="bash">
echo $TEST
test
</syntaxhighlight>

= Paso 6: Listar contenedores en ejecución =

Hemos estado haciendo pruebas y ejecutando contenedores en el paso anterior, vamos a ver donde se encuentran estos contenedores que hemos ejecutado, y después veremos algunas opciones más del comando run.

Tenemos dos opciones para ver los contenedores:

<syntaxhighlight lang="bash">
podman container ls -a
</syntaxhighlight>

o la versión corta:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Ambas hacen lo mismo, y debería de mostrarnos una salida similar a la siguiente:

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
e2bde5f5500c debian "bash" 6 minutes ago Exited (0) 2 seconds ago pensive_sammet
544ad27dbc3c debian "bash" 7 minutes ago Exited (0) 7 minutes ago serene_elgamal
</syntaxhighlight>

En la información veremos que el contenedor tiene el estado exited, eso quiere decir que no se está ejecutando y ya ha finalizado. Vamos a hacer una prueba para ver un contendor ejecutándose:

<syntaxhighlight lang="bash">
podman run -d debian sleep 30
</syntaxhighlight>

Con el comando sleep 30 esperamos 30 segundos hasta que termine el comando, asíque durante esos 30 segundos, el contenedor estará ejecutándose, veámoslo:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
eacceb27d52d debian "sleep 30" 12 seconds ago Up 11 seconds sharp_pasteur
</syntaxhighlight>

Vamos a ver alguna opciones más de la orden ''run''.

== Paso 6.1: Dar un nombre al contenedor (--name) ==

Por defecto, podman creará automáticamente un nombre como hemos visto en las salidas del comando ''podman ps -a''. Podemos establecer el nombre del contenedor que queramos con la opción ''--name'':

<syntaxhighlight lang="bash">
podman run -ti --name mi_debian debian
</syntaxhighlight>

== Paso 6.2: Eliminar contenedor cuando termine (--rm) ==

Vamos a mezclar todo lo visto anteriormente:

* Lanzar en segundo plano (-d)
* Ejecutar contenedor durante 30 segundos (sleep 30)
* Dar un nombre a la imagen (--name)
* Eliminar contenedor cuando termine (--rm)

<syntaxhighlight lang="bash">
podman run -d --rm --name bye-bye debian sleep 30
</syntaxhighlight>

Antes y una vez pasados los 30 segundos, podemos comprobar que el contenedor ha desaparecido.

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

= Paso 7: Parar y eliminar contenedores =

Para parar contenedores podemos usar el ID o su nombre:

<syntaxhighlight lang="bash">
podman stop my_container
podman stop e4901956f108
podman ps -a
</syntaxhighlight>

Una vez hemos comprobado que han terminado su ejecución, podemos eliminar los ficheros resultantes de su ejecución:

<syntaxhighlight lang="bash">
podman container rm my_container
</syntaxhighlight>

Para borrar todos los contenedores ya finalizados

<syntaxhighlight lang="bash">
podman container prune
</syntaxhighlight>

= Paso 8: Conectarnos a un contenedor que se está ejecutando en segundo plano =

Vamos a ejecutar de nuevo un contenedor que no termine:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a conectarnos a este contenedor que está ejecutándose en segundo
plano:

<syntaxhighlight lang="bash">
podman attach mi-contenedor
</syntaxhighlight>

Veremos la orden bash ejecutándose, para terminar, hacemos un 'CTRL + C', y ahora, veremos que ha pasado con el contenedor:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Lo veremos parado, por que lo que hemos hecho ha sido conectarnos al contenedor
y parar el comando que se estaba ejecutando, así que ahora tenemos el contenedor
finalizado.

''Nota:'' Para salir del contenedor '''sin detenerlo''' hacemos 'CTRL + P' seguido 'CTRL + Q'

= Paso 9: Ejecutar un comando dentro de un contenedor en ejecución =

Vamos a ver otresta vez como ejecutar un comando en un contenedor que ya está
ejecutándose:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a ejecutar un comando en ese contenedor con el nombre ''mi-contenedor''.
El comando exec es similar al comando run, pero para ejecutar un comando dentro de un contenedor:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor ls
</syntaxhighlight>

Para redirigir la salida a un fichero en el anfitrión:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor ls > x.txt
</syntaxhighlight>

Para redirigir la salida a un fichero ''dentro'' del contenedor, hacemos:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor sh -c "ls > x.txt"
</syntaxhighlight>

También es posible ejecutar comandos con tuberías:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor sh -c "ls -la | grep ^d"
</syntaxhighlight>

= Paso 10: Persistencia en contenedores =

Al hacer ''exit'' y salir de un contenedor, se pierden todos los cambios que hemos realizado. Los

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-ejemplo debian bash
</syntaxhighlight>

Ahora, vamos a crear una carpeta en el contenedor y comprobar que esa carpeta existe:

<syntaxhighlight lang="bash">
podman exec mi-ejemplo mkdir test
podman exec mi-ejemplo ls
</syntaxhighlight>

Veremos que la carpeta existe, pero, ¿qué ocurre si para el contenedor?

<syntaxhighlight lang="bash">
podman container stop mi-ejemplo
</syntaxhighlight>

Y volvemos a lanzarlo:

<syntaxhighlight lang="bash">
podman container rm mi-ejemplo
podman run -d -ti --name mi-ejemplo debian bash
podman exec mi-ejemplo ls
</syntaxhighlight>

Podemos comprobar que la carpeta creada anteriormente, no existe.

¿Qué podemos hacer para mantener la modificaciones realizadas sobre un contenedor?

== Paso 10.1: Crear una imagen derivada de la imagen base ==

Es posible crear una imagen derivada, con modificaciones, a partir de una imagen existente mediante la orden '''commit'''.

Por ejemplo, si queremos una imagen ''debian'' que incluya el programa ''ping'' ya instalado, tendríamos que lanzar un contenedor a partir de la imagen ''ubuntu'':

<syntaxhighlight lang="bash">
podman run -d -ti debian bash
</syntaxhighlight>

Suponiendo que el contenido está identificado con el ID 56ef5b312334

Instalamos el paquete ping:

<syntaxhighlight lang="bash">
podman exec 56ef5b312334 apt -y install ping
</syntaxhighlight>

Generamos la imagen derivada con el nombre ''ubuntu-con-ping'':

<syntaxhighlight lang="bash">
podman commit 56ef5b312334 ubuntu-con-ping
</syntaxhighlight>

Ya podemos para nuestro contendor:

<syntaxhighlight lang="bash">
podman stop 56ef5b312334
</syntaxhighlight>

Y lanzar un nuevo contenedor a partir de la imagen ''debian-con-ping'':

<syntaxhighlight lang="bash">
podman run -d -ti debian-con-ping bash
</syntaxhighlight>

== Paso 10.2: Mantener la persistencia mediante volúmen ==

Otra opción para mantener los datos es montar un volumen al ejecutar el contenedor.

Primero crearemos una carpeta que hará de volumen en nuestra máquina, que será la que luego montemos para podman:

<syntaxhighlight lang="bash">
mkdir /home/debian/volumen
</syntaxhighlight>

Ahora vamos a montar la carpeta al ejecutar el contenedor, lo hacemos con la
opción -v, la cual tiene 3 campos separados por ':':

# El volumen en nuestra máquina
# Donde se montará el volumen dentro del contenedor
# Opciones de mmontaje, por ejemplo rw (read and write) o ro (read only)

<syntaxhighlight lang="bash">
podman run --rm -ti -v /home/debian/volumen:/volumen:rw debian bash
mkdir /volumen/test
touch /volumen/test/file
exit
</syntaxhighlight>

Una vez nos salgamos del contenedor, podemos ver que en nuestra máquina están
los datos:

<syntaxhighlight lang="bash">
ls /home/ubuntu/volumen/
ls /home/ubuntu/volumen/test
</syntaxhighlight>

La próxima vez que ejecutemos un contenedor, si montamos ese volumen, los datos
estarán ahí, además esta forma tiene el beneficio de compartir datos entre
nuestra máquina y el contenedor de forma sencilla.

= Paso 11: Crear nuestra propia imagen de contenedor =

Para crear una imagen de un contenedor con una aplicación de Python hug, creamos en primer lugar la carpeta que contendrá los ficheros que nos permiten crear la imagen.

<syntaxhighlight lang="bash">
mkdir miapp
cd miapp
</syntaxhighlight>

Definimos un fichero ''Dockerfile'' para definir la imagen:

<syntaxhighlight lang="bash">
FROM debian

RUN apt -y update
RUN apt -y upgrade
RUN apt -y install python3-hug
RUN mkdir /app
COPY endpoint.py /app
WORKDIR /app
CMD hug -f endpoint.py
</syntaxhighlight>

Alternativamente, puedes crear un [[Creando imagen propia usando Ubuntu de base|Dockerfile empleando la imagen de Ubuntu]] como base en lugar de Alpine.

Y añadimos el fichero ''endpoint.py'' que emplea el framework Python hug con el contenido siguiente:

<syntaxhighlight lang="bash">
import hug

@hug.get('/welcome')
def welcome(username="unknown"):
""" Say welcome to username """
return "Welcome " + username
</syntaxhighlight>

Este fichero es un ejemplo de uso de Python hug. Si hacemos una petición a /welcome?username="LSO", esto nos devolverá el mensaje "Welcome LSO".

Una vez tengamos los dos ficheros creados en nuestra máquina virtual, podemos construir nuestra imagen:

<syntaxhighlight lang="bash">
podman build -t app:v1 -f Dockerfile
</syntaxhighlight>

Vamos a explicar para que sirve cada línea:

* FROM: en tiempo de construcción, indica la imagen de base que se va a emplear para generar nuestra imagen derivada.
* RUN: en tiempo de construcción, qué comandos hay que ejecutar para construir la imagen derivada.
* COPY: en tiempo de construcción, para copiar datos desde el host a la imagen derivada.
* WORKDIR: en tiempo de ejecución, para cambiar el directorio de trabajo (lo crea si no existe)
* CMD: en tiempo de ejecución, que comandos se invocan para lanzar la aplicación.

NOTA: El lenguaje de plantillas de Dockerfile mezcla comandos que se ejecutan en tiempo de construcción (''podman build'') y en tiempo de ejecución (''podman run'').

Esto construirá una imagen podman basada en python:alpine, en la cual hemos
guardado nuestra pequeña aplicación y se va a ejecutar cuando ejecutemos un
contenedor basado en esa imagen. Para comprobar que la imagen se ha creado
correctamente, listamos las imagenes, y debería de aparecernos una imagen con
nombre 'app' y tag 'v1':

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen, y vamos a añadir una nueva
opción, -p 8001:8000. Esta opción hará que el puerto interno 8000 del contenedor
sea expuesto en el puerto 8001 de nuestra máquina:

<syntaxhighlight lang="bash">
podman run --name my-app --rm -d -p 8001:8000 app:v1
</syntaxhighlight>

''Nota:'' podman supone que la redirección de puerto es TCP, para una redirección de puertos UDP, puedes usar:

<syntaxhighlight lang="bash">
... -p 8001:8000/udp
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código. En nuestra
máquina haremos:

<syntaxhighlight lang="bash">
curl -X GET http://localhost:8001/welcome?username=LSO
</syntaxhighlight>

Comprobaremos que la salida del comando curl, es "Welcome LSO".

Antes de terminar, vamos a comprobar otro pequeño detalle que añadimos en
nuestra imagen, la variable de entorno USERNAME, vamos a comprobar que funciona:

<syntaxhighlight lang="bash">
podman exec -ti my-app ash
echo $USERNAME
</syntaxhighlight>

Funciona correctamente, pero al ejecutar el contenedor, podemos cambiar esta
variable de entorno como vimos en uno de los pasos anteriores:

<syntaxhighlight lang="bash">
podman run --rm -ti -e USERNAME=me app:v1 ash
echo $USERNAME
</syntaxhighlight>

Esto nos servirá para tener opciones por defecto y que el usuario pueda
cambiarlo a su antojo, como por ejemplo contraseñas u otros detalles.

== Paso 11.1: Depuración de problemas al crear nuestra imagen ==

Hay dos comandos que son particularmente útiles para averiguar por qué nuestra imagen no funciona:

* Consultar si el contenedor está ejecutándose:

<syntaxhighlight lang="bash">
podman container ls
</syntaxhighlight>

Que nos permite ver si el contenedor está activa y la redirección de puertos es correcta.

* Consultar los logs del contenedor:

<syntaxhighlight lang="bash">
podman logs 345fb5d21
</syntaxhighlight>

Esto nos permite saber qué está pasando dentro del contenedor, o qué pasó si éste dejo terminó su ejecución.

NOTA: Si usas la opción --rm al ejecutar tu contenedor, ¡los logs no estarán disponibles!

= Paso 12: Eliminar imágenes =

Para borrar una imagen, puede hacer:

<syntaxhighlight lang="bash">
podman image rm hello-world
</syntaxhighlight>

= Paso 13: Ejercicios =

== Ejercicio 1: Image derivada de Debian con el programa sl ==

Lance un contenedor a partir de una imagen de Debian, instale el programa sl, ejecute sl (desde fuera del contenedor) y detenga el contenedor.

== Ejercicio 2 ==

== Ejercicio 3: Variante de httpd ==

Construya una imagen ''httpd-hola-mundo'' a partir de la imagen ''httpd''. El fichero de index.html de la carpeta htdocs/ tiene que mostrar el mensaje "hola mundo".

<syntaxhighlight lang="bash">
podman pull httpd
</syntaxhighlight>

Edita el fichero Dockerfile:

<syntaxhighlight lang="bash">
nano Dockerfile
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
FROM httpd

COPY index.html htdocs/index.html
</syntaxhighlight>

Edita el fichero index.html:

<syntaxhighlight lang="bash">
nano index.html
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

Construye la imagen:

<syntaxhighlight lang="bash">
podman build -t mihttpd -f Dockerfile
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen:

<syntaxhighlight lang="bash">
podman run --name mihttpd -d -p 8080:80 mihttpd
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código:
<syntaxhighlight lang="bash">
curl -X GET http://localhost:8080
</syntaxhighlight>

Tiene que salir por pantalla esto:
<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

== Ejercicio 4: aplicación flask ==

Flask es un framework python para implementar webs. Cree una imagen "miapp-flask" a partir de la imagen de "python":

* Instale flask mediante: pip install flask
* Cree la carpeta "app"
* Establezca la variable FLASK_APP a "hello.py"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"

El fichero hello.py contiene un "hola mundo" para Flask:

<syntaxhighlight lang="python">
from flask import Flask
app = Flask(__name__)

@app.route("/")
def hello():
return "Hello World!"

if __name__ == "__main__":
app.run()
</syntaxhighlight>

Solución con alpine:

<syntaxhighlight lang="bash">
FROM python:alpine

RUN mkdir /app
RUN pip install flask
ENV FLASK_APP="app/hello.py"
COPY hello.py
WORKDIR /
CMD flask run --host=0.0.0.0
</syntaxhighlight>

Solución con Ubuntu:

<syntaxhighlight lang="bash">
FROM ubuntu:bionic

RUN apt-get update
RUN apt-get -y install python python-pip wget
RUN pip install Flask
ENV FLASK_APP="app/hello.py"
RUN mkdir /app
COPY hello.py /app
CMD flask run --host=0.0.0.0
</syntaxhighlight>

== Ejercicio 5: mysql ==

'''EN LA MÁQUINA VIRTUAL:'''

mkdir miapp
cd miapp
podman pull mysql
nano Dockerfile

<syntaxhighlight lang="bash">
FROM mysql
ENV MYSQL_ROOT_PASSWORD="lacontraseñaqueyoquiera"
RUN mkdir /app
WORKDIR /app

</syntaxhighlight>

CTRL+O , ENTER Y CTRL+X (para guardar Dockerfile y salir)

podman build -ti mrfdocker -f Dockerfile
podman run --name mymrf --rm -p 8001:3306 mrfdocker
docker images

'''EN LA TERMINAL DEL HOST:'''

''Instalación de mysql:''

apt install mysql-client-core-5.7
apt-get install mysql-server
service mysql start

''Para entrar:''

mysql -u root -p -P 8001

Una vez dentro de msql:

mysql> show databases;

''Para salir:''

exit

== Ejercicio 6: python pyramid ==

Pyramid es un framework python para implementar webs. Cree una imagen "miapp-pyramid":

* Emplee la imagen de debian como referencia, instale los paquetes python3 y python3-pyramid.
* Cree la carpeta "app"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"
* La aplicación se lanza con la orden: python3 hello.py
* Compruebe que funciona con curl, la ruta a la web es http://127.0.0.1:8000/hello, suponiendo que ha empleado el puerto 8000 para exponer el servicio.

El fichero hello.py contiene un "hola mundo" para Pyramid:

<syntaxhighlight lang="bash">
from wsgiref.simple_server import make_server
from pyramid.config import Configurator
from pyramid.response import Response

def hello_world(request):
print('Request inbound!')
return Response('Podman works with Pyramid!')

if __name__ == '__main__':
config = Configurator()
config.add_route('hello', '/')
config.add_view(hello_world, route_name='hello')
app = config.make_wsgi_app()
server = make_server('0.0.0.0', 6543, app)
server.serve_forever()
</syntaxhighlight>

Este programa recibe peticiones en el puerto 6543.

== Ejercicio 7 ==

Cree una imagen derivada de Ubuntu, instale el paquete apache2, php y libapache2-mod-php.
Active el módulo de php para apache2 mediante la orden:

<syntaxhighlight lang="bash">
a2enmod php
</syntaxhighlight>

Cree la carpeta /var/www/php.

Cree el fichero index.php

<syntaxhighlight lang="php">
<?php
Print "Hello, World!";
?>
</syntaxhighlight>

y copielo a /var/www/php/.

Cree el fichero 000-default.conf y copielo a /etc/apache2/sites-enabled/

Dicho fichero contiene.

<syntaxhighlight lang="bash">
<VirtualHost *:80>
DocumentRoot /var/www/php

<Directory /var/www/php/>
Options Indexes FollowSymLinks MultiViews
AllowOverride All
Order deny,allow
Allow from all
</Directory>

ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>
</syntaxhighlight>

Tiene que lanzar apache con la orden: apachectl -D FOREGROUND

Tras crear la imagen, láncela mapeando el puerto 8888 al 80, pruebe que puede acceder a http://127.0.0.1:8888/php/ mediante curl

Solución:

<syntaxhighlight lang="bash">
FROM ubuntu:latest

RUN apt-get update
RUN apt-get install -y tzdata
RUN apt-get install -y apache2
RUN apt-get install -y php
RUN apt-get install -y libapache2-mod-php
RUN a2enmod php7.2
COPY index.php /var/www/php
COPY 000-default.conf /etc/apache2/sites-enabled/
CMD apachectl -D FOREGROUND
</syntaxhighlight>

Y para lanzarlo:

podman run --name my-app --rm -d -p 8001:8000 app:v1

y para probarlo:

curl -X GET http://127.0.0.1:8888/php/

== Ejercicio 8 ==

Instale el paquete ''netcat-traditional'' en una imagen de contenedor de ''ubuntu''. Lance la orden:

nc -u -l -p 8080

en el contenedor. Asegúrese de crear una redirección de puertos de 9999 desde el ''host'' al puerto 8080 en el contenedor.

Desde fuera del contenedor, pruebe a conectarse con:

nc -u 127.0.0.1 9999

== Ejercicio 9 ==

Cree una imagen derivada de "ubuntu" con un Dockerfile que incluya soporte de python y lance el siguiente código en Python:

<syntaxhighlight lang="python">
from http.server import BaseHTTPRequestHandler, HTTPServer
import time

hostName = "0.0.0.0"
serverPort = 8080

class MyServer(BaseHTTPRequestHandler):
def do_GET(self):
self.send_response(200)
self.send_header("Content-type", "text/html")
self.end_headers()
self.wfile.write(bytes("<html><head><title>Welcome!</title></head>", "utf-8"))
self.wfile.write(bytes("<body>", "utf-8"))
self.wfile.write(bytes("This is an example web server.", "utf-8"))
self.wfile.write(bytes("</body></html>", "utf-8"))

if __name__ == "__main__":
webServer = HTTPServer((hostName, serverPort), MyServer)
print("Server started http://%s:%s" % (hostName, serverPort))

try:
webServer.serve_forever()
except KeyboardInterrupt:
pass

webServer.server_close()
print("Server stopped.")
</syntaxhighlight>

Llame a su imagen "python-http-server". Lance una instancia de la imagen "python-http-server" mapeando el puerto 9999 al puerto 8888/tcp del contenedor. Compruebe con:

<syntaxhighlight lang="bash">
curl http://127.0.0.1:9999/
</syntaxhighlight>

que muestre la página HTML que ofrece el servidor, que debería ser:

<syntaxhighlight lang="bash">
<html><head><title>Welcome!</title></head><body>This is an example web server.</body></html>
</syntaxhighlight>

= Anexo =

* Cómo usar [[Podman compose]]

Contenedores

2025-12-17T11:55:16Z

Pneira: /* Paso 11: Crear nuestra propia imagen de contenedor */

En esta práctica aprenderemos a utilizar [https://es.wikipedia.org/wiki/Podman podman] para desplegar contenedores.

= Paso 1: Instalar podman =

Para instalar el paquete oficial:

<syntaxhighlight lang="bash">
apt install podman
</syntaxhighlight>

podman es un clon de '''docker''.

Si añade un usuario 'test' a su sistema con:

<syntaxhighlight lang="bash">
adduser test
</syntaxhighlight>

recuerde hacer:

<syntaxhighlight lang="bash">
loginctl enable-linger test
systemctl start --user dbus
</syntaxhighlight>

para evitar un warning que se muestra al ejecutar '''podman''' como usuario.

= Paso 2: Repositorio de imágenes de contenedores DockerHub =

Docker ofrece un servicio de nube denominado ''DockerHub'' que puede ser empleado como red social para compartir tus imágenes de Podman. En ''DockerHub'' existen además imágenes de contenedores preconfiguradas de software, muchas de ellas oficiales (ofrecidas por el propio fabricante del software) que se podrán emplear como base para construir nuevas imágenes adaptadas a nuestras necesidades.

Podremos realizar búsquedas en este repositorio ''DockerHub'' puedes emplear el siguiente comando:

<syntaxhighlight lang="bash">
podman search docker.io/library/hello-world
</syntaxhighlight>

Para descargarnos la imagen de ''hello-world'' podemos usar la orden ''pull'':

<syntaxhighlight lang="bash">
podman pull docker.io/library/hello-world
</syntaxhighlight>

También podemos publicar imágenes propias, esto require '''registro de usuario''' en la nube de ''DockerHub'', lo que '''no''' es obligatorio para la realización de esta práctica. Para subir una imagen, hay que validarse como usuario en la nube de ''DockerHub'':

<syntaxhighlight lang="bash">
podman login docker.io
</syntaxhighlight>

Tras introducir tu usuario y contraseña, puedes comenzar a publicar tus propias imágenes.

<syntaxhighlight lang="bash">
podman push docker.io/USUARIO/MI_IMAGEN
</syntaxhighlight>

Este paso es '''opcional''', sólo en caso de que se quieran subir imágenes de contenedores a la nube de docker.io.

= Paso 4: Comprobar imágenes en nuestra máquina =

Para ver las imágenes que tenemos en nuestra máquina, utilizaremos el comando:

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Inicialmente, no tenemos imágenes en almacenamiento, podemos descargarnos la imagen oficial de Debian 13 (Trixie):

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian
</syntaxhighlight>

Ahora si, ya debería de aparecernos la imagen ''debian''.

Comentar también que cada imagen puede tener varias etiquetas, por ejemplo, la imagen Debian 12 (Bookworm), cuando la hemos visto en el listado de imágenes, venía con el tag latest, que es el tag que se descarga por defecto, pero nosotros podemos especificar otro, por ejemplo:

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian:bookworm
</syntaxhighlight>

Para traernos la versión de la imagen de Debian 12 ''Bookworm''.

Ahora tendremos dos imágenes con diferente etiqueta, que serían como las diferentes versiones de cada imagen.

= Paso 5: Lanzar un contenedor =

Un contenedor no es más que una imagen de podman ejecutándose, sería similar a
una máquina virtual, aunque mucho más liviano.

Para crear un contenedor, utilizaremos una imagen, en este caso, la imagen
hello-world. Hacemos lo siguiente:

<syntaxhighlight lang="bash">
podman run hello-world
</syntaxhighlight>

Esto nos mostrará el siguiente mensaje si todo está correcto:

<syntaxhighlight lang="bash">
Hello from Docker!
This message shows that your installation appears to be working correctly.

To generate this message, Docker took the following steps:
1. The Docker client contacted the Docker daemon.
2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
(amd64)
3. The Docker daemon created a new container from that image which runs the
executable that produces the output you are currently reading.
4. The Docker daemon streamed that output to the Docker client, which sent it
to your terminal.

To try something more ambitious, you can run an Debian container with:
$ podman run -it debian bash

Share images, automate workflows, and more with a free Docker ID:
https://hub.docker.com/

For more examples and ideas, visit:
https://docs.docker.com/get-started/
</syntaxhighlight>

Al crear los contenedores utilizando el comando 'run', tenemos varias opciones:

* Lanzar una terminal en el contenedor en modo interactivo
* Lanzar en segundo plano y conectarnos posteriormente al contenedor

== Paso 5.1: Lanzar una terminal en el contenedor en modo interactivo (-ti) ==

Para este ejemplo vamos a utilizar otra imagen diferente, en este caso vamos a utilizar una imagen de debian.

Vamos a lanzar un contenedor y ejecutar una terminal en el que se va a ejecutar el programa '''bash''' que me ofrece un interprete de órdenes:

<syntaxhighlight lang="bash">
podman run -ti debian bash
</syntaxhighlight>

La opción ''-t'' indica que se crea un terminal en el contenedor. Y la opción ''-i'' indica que el contenedor se ejecuta en modo interactivo.

Al acceder al contenedor de ''debian'' nos aparece un ''hash'' en el prompt de la shell, que identifica a la instancia del contenedor (es valor es similar al que muestra la orden ''podman container ls'').

Para salir del contenedor, escribimos 'exit' o pulsamos ''CTRL + D''

== Paso 5.2 Lanzar en segundo plano (-d) ==

Otro ejemplo, con la imagen de Debian:

<syntaxhighlight lang="bash">
podman run -dti debian
</syntaxhighlight>

que muestra un hash que identifica de forma única el contenedor lanzado:

<syntaxhighlight lang="bash">
2ec1daae4676a4e84dc04fd91399c1dfe92119544ff12ee307991fe573d3db64
</syntaxhighlight>

Mediante el comando ''attach'' puedo entrar al contenedor:

<syntaxhighlight lang="bash">
podman attach 2ec1daae4676
</syntaxhighlight>

Para salir, pulsamos ''CTRL + P'' seguido de ''CTRL + Q''.

De manera similar, puedo lanzar en segundo plano la imagen de contenedor de ''hello-world'':

<syntaxhighlight lang="bash">
podman run -d hello-world
</syntaxhighlight>

Y consultar los logs:

<syntaxhighlight lang="bash">
podman logs b67fae3312bc321
</syntaxhighlight>

== Paso 5.3: Añadir variables de entorno a un contenedor ==

Utilizaremos la imagen anterior, y vamos a añadir una variable de entorno
llamada TEST que contenga el valor 'test'. A parte, también ejecutaremos la
terminal como antes, para comprobar con el comando echo, que la variable de
entorno está creada correctamente:

<syntaxhighlight lang="bash">
podman run -ti -e TEST=test debian bash
</syntaxhighlight>

Ahora, desde el contenedor podemos comprobar el valor de la variable de entorno ''$TEST''.

<syntaxhighlight lang="bash">
echo $TEST
test
</syntaxhighlight>

= Paso 6: Listar contenedores en ejecución =

Hemos estado haciendo pruebas y ejecutando contenedores en el paso anterior, vamos a ver donde se encuentran estos contenedores que hemos ejecutado, y después veremos algunas opciones más del comando run.

Tenemos dos opciones para ver los contenedores:

<syntaxhighlight lang="bash">
podman container ls -a
</syntaxhighlight>

o la versión corta:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Ambas hacen lo mismo, y debería de mostrarnos una salida similar a la siguiente:

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
e2bde5f5500c debian "bash" 6 minutes ago Exited (0) 2 seconds ago pensive_sammet
544ad27dbc3c debian "bash" 7 minutes ago Exited (0) 7 minutes ago serene_elgamal
</syntaxhighlight>

En la información veremos que el contenedor tiene el estado exited, eso quiere decir que no se está ejecutando y ya ha finalizado. Vamos a hacer una prueba para ver un contendor ejecutándose:

<syntaxhighlight lang="bash">
podman run -d debian sleep 30
</syntaxhighlight>

Con el comando sleep 30 esperamos 30 segundos hasta que termine el comando, asíque durante esos 30 segundos, el contenedor estará ejecutándose, veámoslo:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
eacceb27d52d debian "sleep 30" 12 seconds ago Up 11 seconds sharp_pasteur
</syntaxhighlight>

Vamos a ver alguna opciones más de la orden ''run''.

== Paso 6.1: Dar un nombre al contenedor (--name) ==

Por defecto, podman creará automáticamente un nombre como hemos visto en las salidas del comando ''podman ps -a''. Podemos establecer el nombre del contenedor que queramos con la opción ''--name'':

<syntaxhighlight lang="bash">
podman run -ti --name mi_debian debian
</syntaxhighlight>

== Paso 6.2: Eliminar contenedor cuando termine (--rm) ==

Vamos a mezclar todo lo visto anteriormente:

* Lanzar en segundo plano (-d)
* Ejecutar contenedor durante 30 segundos (sleep 30)
* Dar un nombre a la imagen (--name)
* Eliminar contenedor cuando termine (--rm)

<syntaxhighlight lang="bash">
podman run -d --rm --name bye-bye debian sleep 30
</syntaxhighlight>

Antes y una vez pasados los 30 segundos, podemos comprobar que el contenedor ha desaparecido.

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

= Paso 7: Parar y eliminar contenedores =

Para parar contenedores podemos usar el ID o su nombre:

<syntaxhighlight lang="bash">
podman stop my_container
podman stop e4901956f108
podman ps -a
</syntaxhighlight>

Una vez hemos comprobado que han terminado su ejecución, podemos eliminar los ficheros resultantes de su ejecución:

<syntaxhighlight lang="bash">
podman container rm my_container
</syntaxhighlight>

Para borrar todos los contenedores ya finalizados

<syntaxhighlight lang="bash">
podman container prune
</syntaxhighlight>

= Paso 8: Conectarnos a un contenedor que se está ejecutando en segundo plano =

Vamos a ejecutar de nuevo un contenedor que no termine:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a conectarnos a este contenedor que está ejecutándose en segundo
plano:

<syntaxhighlight lang="bash">
podman attach mi-contenedor
</syntaxhighlight>

Veremos la orden bash ejecutándose, para terminar, hacemos un 'CTRL + C', y ahora, veremos que ha pasado con el contenedor:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Lo veremos parado, por que lo que hemos hecho ha sido conectarnos al contenedor
y parar el comando que se estaba ejecutando, así que ahora tenemos el contenedor
finalizado.

''Nota:'' Para salir del contenedor '''sin detenerlo''' hacemos 'CTRL + P' seguido 'CTRL + Q'

= Paso 9: Ejecutar un comando dentro de un contenedor en ejecución =

Vamos a ver otresta vez como ejecutar un comando en un contenedor que ya está
ejecutándose:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a ejecutar un comando en ese contenedor con el nombre ''mi-contenedor''.
El comando exec es similar al comando run, pero para ejecutar un comando dentro de un contenedor:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor ls
</syntaxhighlight>

Para redirigir la salida a un fichero en el anfitrión:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor ls > x.txt
</syntaxhighlight>

Para redirigir la salida a un fichero ''dentro'' del contenedor, hacemos:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor sh -c "ls > x.txt"
</syntaxhighlight>

También es posible ejecutar comandos con tuberías:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor sh -c "ls -la | grep ^d"
</syntaxhighlight>

= Paso 10: Persistencia en contenedores =

Al hacer ''exit'' y salir de un contenedor, se pierden todos los cambios que hemos realizado. Los

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-ejemplo debian bash
</syntaxhighlight>

Ahora, vamos a crear una carpeta en el contenedor y comprobar que esa carpeta existe:

<syntaxhighlight lang="bash">
podman exec mi-ejemplo mkdir test
podman exec mi-ejemplo ls
</syntaxhighlight>

Veremos que la carpeta existe, pero, ¿qué ocurre si para el contenedor?

<syntaxhighlight lang="bash">
podman container stop mi-ejemplo
</syntaxhighlight>

Y volvemos a lanzarlo:

<syntaxhighlight lang="bash">
podman container rm mi-ejemplo
podman run -d -ti --name mi-ejemplo debian bash
podman exec mi-ejemplo ls
</syntaxhighlight>

Podemos comprobar que la carpeta creada anteriormente, no existe.

¿Qué podemos hacer para mantener la modificaciones realizadas sobre un contenedor?

== Paso 10.1: Crear una imagen derivada de la imagen base ==

Es posible crear una imagen derivada, con modificaciones, a partir de una imagen existente mediante la orden '''commit'''.

Por ejemplo, si queremos una imagen ''debian'' que incluya el programa ''ping'' ya instalado, tendríamos que lanzar un contenedor a partir de la imagen ''ubuntu'':

<syntaxhighlight lang="bash">
podman run -d -ti debian bash
</syntaxhighlight>

Suponiendo que el contenido está identificado con el ID 56ef5b312334

Instalamos el paquete ping:

<syntaxhighlight lang="bash">
podman exec 56ef5b312334 apt -y install ping
</syntaxhighlight>

Generamos la imagen derivada con el nombre ''ubuntu-con-ping'':

<syntaxhighlight lang="bash">
podman commit 56ef5b312334 ubuntu-con-ping
</syntaxhighlight>

Ya podemos para nuestro contendor:

<syntaxhighlight lang="bash">
podman stop 56ef5b312334
</syntaxhighlight>

Y lanzar un nuevo contenedor a partir de la imagen ''debian-con-ping'':

<syntaxhighlight lang="bash">
podman run -d -ti debian-con-ping bash
</syntaxhighlight>

== Paso 10.2: Mantener la persistencia mediante volúmen ==

Otra opción para mantener los datos es montar un volumen al ejecutar el contenedor.

Primero crearemos una carpeta que hará de volumen en nuestra máquina, que será la que luego montemos para podman:

<syntaxhighlight lang="bash">
mkdir /home/debian/volumen
</syntaxhighlight>

Ahora vamos a montar la carpeta al ejecutar el contenedor, lo hacemos con la
opción -v, la cual tiene 3 campos separados por ':':

# El volumen en nuestra máquina
# Donde se montará el volumen dentro del contenedor
# Opciones de mmontaje, por ejemplo rw (read and write) o ro (read only)

<syntaxhighlight lang="bash">
podman run --rm -ti -v /home/debian/volumen:/volumen:rw debian bash
mkdir /volumen/test
touch /volumen/test/file
exit
</syntaxhighlight>

Una vez nos salgamos del contenedor, podemos ver que en nuestra máquina están
los datos:

<syntaxhighlight lang="bash">
ls /home/ubuntu/volumen/
ls /home/ubuntu/volumen/test
</syntaxhighlight>

La próxima vez que ejecutemos un contenedor, si montamos ese volumen, los datos
estarán ahí, además esta forma tiene el beneficio de compartir datos entre
nuestra máquina y el contenedor de forma sencilla.

= Paso 11: Crear nuestra propia imagen de contenedor =

Para crear una imagen de un contenedor con una aplicación de Python hug, creamos en primer lugar la carpeta que contendrá los ficheros que nos permiten crear la imagen.

<syntaxhighlight lang="bash">
mkdir miapp
cd miapp
</syntaxhighlight>

Definimos un fichero ''Dockerfile'' para definir la imagen:

<syntaxhighlight lang="bash">
FROM debian

RUN apt -y update
RUN apt -y upgrade
RUN apt -y install python3-hug
RUN mkdir /app
COPY endpoint.py /app
WORKDIR /app
CMD hug -f endpoint.py
</syntaxhighlight>

Alternativamente, puedes crear un [[Creando imagen propia usando Ubuntu de base|Dockerfile empleando la imagen de Ubuntu]] como base en lugar de Alpine.

Y añadimos el fichero ''endpoint.py'' que emplea el framework Python hug con el contenido siguiente:

<syntaxhighlight lang="bash">
import hug

@hug.get('/welcome')
def welcome(username="unknown"):
""" Say welcome to username """
return "Welcome " + username
</syntaxhighlight>

Este fichero es un ejemplo de uso de Python hug. Si hacemos una petición a /welcome?username="LSO", esto nos devolverá el mensaje "Welcome LSO".

Una vez tengamos los dos ficheros creados en nuestra máquina virtual, podemos construir nuestra imagen:

<syntaxhighlight lang="bash">
podman build -t app:v1 -f Dockerfile
</syntaxhighlight>

Vamos a explicar para que sirve cada línea:

* FROM: en tiempo de construcción, servirá para basarnos en una imagen existente, en este caso, una imagen de python alpine, que contiene python y no ocupa mucho espacio
* RUN: en tiempo de construcción de la imagen (con ''podman build'') qué comandos hay que ejecutar para construir la imagen derivada.
* COPY: en tiempo de construcción, para copiar datos desde nuestra máquina a la imagen
* WORKDIR: en tiempo de ejecución, para cambiar el directorio de trabajo (lo crea si no existe)
* CMD: en tiempo de ejecución, que comandos se invocan para lanzar la aplicación.

NOTA: El lenguaje de plantillas de Dockerfile mezcla comandos que se ejecutan en tiempo de construcción y en tiempo de ejecución.

Esto construirá una imagen podman basada en python:alpine, en la cual hemos
guardado nuestra pequeña aplicación y se va a ejecutar cuando ejecutemos un
contenedor basado en esa imagen. Para comprobar que la imagen se ha creado
correctamente, listamos las imagenes, y debería de aparecernos una imagen con
nombre 'app' y tag 'v1':

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen, y vamos a añadir una nueva
opción, -p 8001:8000. Esta opción hará que el puerto interno 8000 del contenedor
sea expuesto en el puerto 8001 de nuestra máquina:

<syntaxhighlight lang="bash">
podman run --name my-app --rm -d -p 8001:8000 app:v1
</syntaxhighlight>

''Nota:'' podman supone que la redirección de puerto es TCP, para una redirección de puertos UDP, puedes usar:

<syntaxhighlight lang="bash">
... -p 8001:8000/udp
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código. En nuestra
máquina haremos:

<syntaxhighlight lang="bash">
curl -X GET http://localhost:8001/welcome?username=LSO
</syntaxhighlight>

Comprobaremos que la salida del comando curl, es "Welcome LSO".

Antes de terminar, vamos a comprobar otro pequeño detalle que añadimos en
nuestra imagen, la variable de entorno USERNAME, vamos a comprobar que funciona:

<syntaxhighlight lang="bash">
podman exec -ti my-app ash
echo $USERNAME
</syntaxhighlight>

Funciona correctamente, pero al ejecutar el contenedor, podemos cambiar esta
variable de entorno como vimos en uno de los pasos anteriores:

<syntaxhighlight lang="bash">
podman run --rm -ti -e USERNAME=me app:v1 ash
echo $USERNAME
</syntaxhighlight>

Esto nos servirá para tener opciones por defecto y que el usuario pueda
cambiarlo a su antojo, como por ejemplo contraseñas u otros detalles.

== Paso 11.1: Depuración de problemas al crear nuestra imagen ==

Hay dos comandos que son particularmente útiles para averiguar por qué nuestra imagen no funciona:

* Consultar si el contenedor está ejecutándose:

<syntaxhighlight lang="bash">
podman container ls
</syntaxhighlight>

Que nos permite ver si el contenedor está activa y la redirección de puertos es correcta.

* Consultar los logs del contenedor:

<syntaxhighlight lang="bash">
podman logs 345fb5d21
</syntaxhighlight>

Esto nos permite saber qué está pasando dentro del contenedor, o qué pasó si éste dejo terminó su ejecución.

NOTA: Si usas la opción --rm al ejecutar tu contenedor, ¡los logs no estarán disponibles!

= Paso 12: Eliminar imágenes =

Para borrar una imagen, puede hacer:

<syntaxhighlight lang="bash">
podman image rm hello-world
</syntaxhighlight>

= Paso 13: Ejercicios =

== Ejercicio 1: Image derivada de Debian con el programa sl ==

Lance un contenedor a partir de una imagen de Debian, instale el programa sl, ejecute sl (desde fuera del contenedor) y detenga el contenedor.

== Ejercicio 2 ==

== Ejercicio 3: Variante de httpd ==

Construya una imagen ''httpd-hola-mundo'' a partir de la imagen ''httpd''. El fichero de index.html de la carpeta htdocs/ tiene que mostrar el mensaje "hola mundo".

<syntaxhighlight lang="bash">
podman pull httpd
</syntaxhighlight>

Edita el fichero Dockerfile:

<syntaxhighlight lang="bash">
nano Dockerfile
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
FROM httpd

COPY index.html htdocs/index.html
</syntaxhighlight>

Edita el fichero index.html:

<syntaxhighlight lang="bash">
nano index.html
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

Construye la imagen:

<syntaxhighlight lang="bash">
podman build -t mihttpd -f Dockerfile
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen:

<syntaxhighlight lang="bash">
podman run --name mihttpd -d -p 8080:80 mihttpd
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código:
<syntaxhighlight lang="bash">
curl -X GET http://localhost:8080
</syntaxhighlight>

Tiene que salir por pantalla esto:
<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

== Ejercicio 4: aplicación flask ==

Flask es un framework python para implementar webs. Cree una imagen "miapp-flask" a partir de la imagen de "python":

* Instale flask mediante: pip install flask
* Cree la carpeta "app"
* Establezca la variable FLASK_APP a "hello.py"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"

El fichero hello.py contiene un "hola mundo" para Flask:

<syntaxhighlight lang="python">
from flask import Flask
app = Flask(__name__)

@app.route("/")
def hello():
return "Hello World!"

if __name__ == "__main__":
app.run()
</syntaxhighlight>

Solución con alpine:

<syntaxhighlight lang="bash">
FROM python:alpine

RUN mkdir /app
RUN pip install flask
ENV FLASK_APP="app/hello.py"
COPY hello.py
WORKDIR /
CMD flask run --host=0.0.0.0
</syntaxhighlight>

Solución con Ubuntu:

<syntaxhighlight lang="bash">
FROM ubuntu:bionic

RUN apt-get update
RUN apt-get -y install python python-pip wget
RUN pip install Flask
ENV FLASK_APP="app/hello.py"
RUN mkdir /app
COPY hello.py /app
CMD flask run --host=0.0.0.0
</syntaxhighlight>

== Ejercicio 5: mysql ==

'''EN LA MÁQUINA VIRTUAL:'''

mkdir miapp
cd miapp
podman pull mysql
nano Dockerfile

<syntaxhighlight lang="bash">
FROM mysql
ENV MYSQL_ROOT_PASSWORD="lacontraseñaqueyoquiera"
RUN mkdir /app
WORKDIR /app

</syntaxhighlight>

CTRL+O , ENTER Y CTRL+X (para guardar Dockerfile y salir)

podman build -ti mrfdocker -f Dockerfile
podman run --name mymrf --rm -p 8001:3306 mrfdocker
docker images

'''EN LA TERMINAL DEL HOST:'''

''Instalación de mysql:''

apt install mysql-client-core-5.7
apt-get install mysql-server
service mysql start

''Para entrar:''

mysql -u root -p -P 8001

Una vez dentro de msql:

mysql> show databases;

''Para salir:''

exit

== Ejercicio 6: python pyramid ==

Pyramid es un framework python para implementar webs. Cree una imagen "miapp-pyramid":

* Emplee la imagen de debian como referencia, instale los paquetes python3 y python3-pyramid.
* Cree la carpeta "app"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"
* La aplicación se lanza con la orden: python3 hello.py
* Compruebe que funciona con curl, la ruta a la web es http://127.0.0.1:8000/hello, suponiendo que ha empleado el puerto 8000 para exponer el servicio.

El fichero hello.py contiene un "hola mundo" para Pyramid:

<syntaxhighlight lang="bash">
from wsgiref.simple_server import make_server
from pyramid.config import Configurator
from pyramid.response import Response

def hello_world(request):
print('Request inbound!')
return Response('Podman works with Pyramid!')

if __name__ == '__main__':
config = Configurator()
config.add_route('hello', '/')
config.add_view(hello_world, route_name='hello')
app = config.make_wsgi_app()
server = make_server('0.0.0.0', 6543, app)
server.serve_forever()
</syntaxhighlight>

Este programa recibe peticiones en el puerto 6543.

== Ejercicio 7 ==

Cree una imagen derivada de Ubuntu, instale el paquete apache2, php y libapache2-mod-php.
Active el módulo de php para apache2 mediante la orden:

<syntaxhighlight lang="bash">
a2enmod php
</syntaxhighlight>

Cree la carpeta /var/www/php.

Cree el fichero index.php

<syntaxhighlight lang="php">
<?php
Print "Hello, World!";
?>
</syntaxhighlight>

y copielo a /var/www/php/.

Cree el fichero 000-default.conf y copielo a /etc/apache2/sites-enabled/

Dicho fichero contiene.

<syntaxhighlight lang="bash">
<VirtualHost *:80>
DocumentRoot /var/www/php

<Directory /var/www/php/>
Options Indexes FollowSymLinks MultiViews
AllowOverride All
Order deny,allow
Allow from all
</Directory>

ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>
</syntaxhighlight>

Tiene que lanzar apache con la orden: apachectl -D FOREGROUND

Tras crear la imagen, láncela mapeando el puerto 8888 al 80, pruebe que puede acceder a http://127.0.0.1:8888/php/ mediante curl

Solución:

<syntaxhighlight lang="bash">
FROM ubuntu:latest

RUN apt-get update
RUN apt-get install -y tzdata
RUN apt-get install -y apache2
RUN apt-get install -y php
RUN apt-get install -y libapache2-mod-php
RUN a2enmod php7.2
COPY index.php /var/www/php
COPY 000-default.conf /etc/apache2/sites-enabled/
CMD apachectl -D FOREGROUND
</syntaxhighlight>

Y para lanzarlo:

podman run --name my-app --rm -d -p 8001:8000 app:v1

y para probarlo:

curl -X GET http://127.0.0.1:8888/php/

== Ejercicio 8 ==

Instale el paquete ''netcat-traditional'' en una imagen de contenedor de ''ubuntu''. Lance la orden:

nc -u -l -p 8080

en el contenedor. Asegúrese de crear una redirección de puertos de 9999 desde el ''host'' al puerto 8080 en el contenedor.

Desde fuera del contenedor, pruebe a conectarse con:

nc -u 127.0.0.1 9999

== Ejercicio 9 ==

Cree una imagen derivada de "ubuntu" con un Dockerfile que incluya soporte de python y lance el siguiente código en Python:

<syntaxhighlight lang="python">
from http.server import BaseHTTPRequestHandler, HTTPServer
import time

hostName = "0.0.0.0"
serverPort = 8080

class MyServer(BaseHTTPRequestHandler):
def do_GET(self):
self.send_response(200)
self.send_header("Content-type", "text/html")
self.end_headers()
self.wfile.write(bytes("<html><head><title>Welcome!</title></head>", "utf-8"))
self.wfile.write(bytes("<body>", "utf-8"))
self.wfile.write(bytes("This is an example web server.", "utf-8"))
self.wfile.write(bytes("</body></html>", "utf-8"))

if __name__ == "__main__":
webServer = HTTPServer((hostName, serverPort), MyServer)
print("Server started http://%s:%s" % (hostName, serverPort))

try:
webServer.serve_forever()
except KeyboardInterrupt:
pass

webServer.server_close()
print("Server stopped.")
</syntaxhighlight>

Llame a su imagen "python-http-server". Lance una instancia de la imagen "python-http-server" mapeando el puerto 9999 al puerto 8888/tcp del contenedor. Compruebe con:

<syntaxhighlight lang="bash">
curl http://127.0.0.1:9999/
</syntaxhighlight>

que muestre la página HTML que ofrece el servidor, que debería ser:

<syntaxhighlight lang="bash">
<html><head><title>Welcome!</title></head><body>This is an example web server.</body></html>
</syntaxhighlight>

= Anexo =

* Cómo usar [[Podman compose]]

Contenedores

2025-12-17T11:48:41Z

Pneira: /* Paso 11: Crear nuestra propia imagen de contenedor */

En esta práctica aprenderemos a utilizar [https://es.wikipedia.org/wiki/Podman podman] para desplegar contenedores.

= Paso 1: Instalar podman =

Para instalar el paquete oficial:

<syntaxhighlight lang="bash">
apt install podman
</syntaxhighlight>

podman es un clon de '''docker''.

Si añade un usuario 'test' a su sistema con:

<syntaxhighlight lang="bash">
adduser test
</syntaxhighlight>

recuerde hacer:

<syntaxhighlight lang="bash">
loginctl enable-linger test
systemctl start --user dbus
</syntaxhighlight>

para evitar un warning que se muestra al ejecutar '''podman''' como usuario.

= Paso 2: Repositorio de imágenes de contenedores DockerHub =

Docker ofrece un servicio de nube denominado ''DockerHub'' que puede ser empleado como red social para compartir tus imágenes de Podman. En ''DockerHub'' existen además imágenes de contenedores preconfiguradas de software, muchas de ellas oficiales (ofrecidas por el propio fabricante del software) que se podrán emplear como base para construir nuevas imágenes adaptadas a nuestras necesidades.

Podremos realizar búsquedas en este repositorio ''DockerHub'' puedes emplear el siguiente comando:

<syntaxhighlight lang="bash">
podman search docker.io/library/hello-world
</syntaxhighlight>

Para descargarnos la imagen de ''hello-world'' podemos usar la orden ''pull'':

<syntaxhighlight lang="bash">
podman pull docker.io/library/hello-world
</syntaxhighlight>

También podemos publicar imágenes propias, esto require '''registro de usuario''' en la nube de ''DockerHub'', lo que '''no''' es obligatorio para la realización de esta práctica. Para subir una imagen, hay que validarse como usuario en la nube de ''DockerHub'':

<syntaxhighlight lang="bash">
podman login docker.io
</syntaxhighlight>

Tras introducir tu usuario y contraseña, puedes comenzar a publicar tus propias imágenes.

<syntaxhighlight lang="bash">
podman push docker.io/USUARIO/MI_IMAGEN
</syntaxhighlight>

Este paso es '''opcional''', sólo en caso de que se quieran subir imágenes de contenedores a la nube de docker.io.

= Paso 4: Comprobar imágenes en nuestra máquina =

Para ver las imágenes que tenemos en nuestra máquina, utilizaremos el comando:

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Inicialmente, no tenemos imágenes en almacenamiento, podemos descargarnos la imagen oficial de Debian 13 (Trixie):

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian
</syntaxhighlight>

Ahora si, ya debería de aparecernos la imagen ''debian''.

Comentar también que cada imagen puede tener varias etiquetas, por ejemplo, la imagen Debian 12 (Bookworm), cuando la hemos visto en el listado de imágenes, venía con el tag latest, que es el tag que se descarga por defecto, pero nosotros podemos especificar otro, por ejemplo:

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian:bookworm
</syntaxhighlight>

Para traernos la versión de la imagen de Debian 12 ''Bookworm''.

Ahora tendremos dos imágenes con diferente etiqueta, que serían como las diferentes versiones de cada imagen.

= Paso 5: Lanzar un contenedor =

Un contenedor no es más que una imagen de podman ejecutándose, sería similar a
una máquina virtual, aunque mucho más liviano.

Para crear un contenedor, utilizaremos una imagen, en este caso, la imagen
hello-world. Hacemos lo siguiente:

<syntaxhighlight lang="bash">
podman run hello-world
</syntaxhighlight>

Esto nos mostrará el siguiente mensaje si todo está correcto:

<syntaxhighlight lang="bash">
Hello from Docker!
This message shows that your installation appears to be working correctly.

To generate this message, Docker took the following steps:
1. The Docker client contacted the Docker daemon.
2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
(amd64)
3. The Docker daemon created a new container from that image which runs the
executable that produces the output you are currently reading.
4. The Docker daemon streamed that output to the Docker client, which sent it
to your terminal.

To try something more ambitious, you can run an Debian container with:
$ podman run -it debian bash

Share images, automate workflows, and more with a free Docker ID:
https://hub.docker.com/

For more examples and ideas, visit:
https://docs.docker.com/get-started/
</syntaxhighlight>

Al crear los contenedores utilizando el comando 'run', tenemos varias opciones:

* Lanzar una terminal en el contenedor en modo interactivo
* Lanzar en segundo plano y conectarnos posteriormente al contenedor

== Paso 5.1: Lanzar una terminal en el contenedor en modo interactivo (-ti) ==

Para este ejemplo vamos a utilizar otra imagen diferente, en este caso vamos a utilizar una imagen de debian.

Vamos a lanzar un contenedor y ejecutar una terminal en el que se va a ejecutar el programa '''bash''' que me ofrece un interprete de órdenes:

<syntaxhighlight lang="bash">
podman run -ti debian bash
</syntaxhighlight>

La opción ''-t'' indica que se crea un terminal en el contenedor. Y la opción ''-i'' indica que el contenedor se ejecuta en modo interactivo.

Al acceder al contenedor de ''debian'' nos aparece un ''hash'' en el prompt de la shell, que identifica a la instancia del contenedor (es valor es similar al que muestra la orden ''podman container ls'').

Para salir del contenedor, escribimos 'exit' o pulsamos ''CTRL + D''

== Paso 5.2 Lanzar en segundo plano (-d) ==

Otro ejemplo, con la imagen de Debian:

<syntaxhighlight lang="bash">
podman run -dti debian
</syntaxhighlight>

que muestra un hash que identifica de forma única el contenedor lanzado:

<syntaxhighlight lang="bash">
2ec1daae4676a4e84dc04fd91399c1dfe92119544ff12ee307991fe573d3db64
</syntaxhighlight>

Mediante el comando ''attach'' puedo entrar al contenedor:

<syntaxhighlight lang="bash">
podman attach 2ec1daae4676
</syntaxhighlight>

Para salir, pulsamos ''CTRL + P'' seguido de ''CTRL + Q''.

De manera similar, puedo lanzar en segundo plano la imagen de contenedor de ''hello-world'':

<syntaxhighlight lang="bash">
podman run -d hello-world
</syntaxhighlight>

Y consultar los logs:

<syntaxhighlight lang="bash">
podman logs b67fae3312bc321
</syntaxhighlight>

== Paso 5.3: Añadir variables de entorno a un contenedor ==

Utilizaremos la imagen anterior, y vamos a añadir una variable de entorno
llamada TEST que contenga el valor 'test'. A parte, también ejecutaremos la
terminal como antes, para comprobar con el comando echo, que la variable de
entorno está creada correctamente:

<syntaxhighlight lang="bash">
podman run -ti -e TEST=test debian bash
</syntaxhighlight>

Ahora, desde el contenedor podemos comprobar el valor de la variable de entorno ''$TEST''.

<syntaxhighlight lang="bash">
echo $TEST
test
</syntaxhighlight>

= Paso 6: Listar contenedores en ejecución =

Hemos estado haciendo pruebas y ejecutando contenedores en el paso anterior, vamos a ver donde se encuentran estos contenedores que hemos ejecutado, y después veremos algunas opciones más del comando run.

Tenemos dos opciones para ver los contenedores:

<syntaxhighlight lang="bash">
podman container ls -a
</syntaxhighlight>

o la versión corta:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Ambas hacen lo mismo, y debería de mostrarnos una salida similar a la siguiente:

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
e2bde5f5500c debian "bash" 6 minutes ago Exited (0) 2 seconds ago pensive_sammet
544ad27dbc3c debian "bash" 7 minutes ago Exited (0) 7 minutes ago serene_elgamal
</syntaxhighlight>

En la información veremos que el contenedor tiene el estado exited, eso quiere decir que no se está ejecutando y ya ha finalizado. Vamos a hacer una prueba para ver un contendor ejecutándose:

<syntaxhighlight lang="bash">
podman run -d debian sleep 30
</syntaxhighlight>

Con el comando sleep 30 esperamos 30 segundos hasta que termine el comando, asíque durante esos 30 segundos, el contenedor estará ejecutándose, veámoslo:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
eacceb27d52d debian "sleep 30" 12 seconds ago Up 11 seconds sharp_pasteur
</syntaxhighlight>

Vamos a ver alguna opciones más de la orden ''run''.

== Paso 6.1: Dar un nombre al contenedor (--name) ==

Por defecto, podman creará automáticamente un nombre como hemos visto en las salidas del comando ''podman ps -a''. Podemos establecer el nombre del contenedor que queramos con la opción ''--name'':

<syntaxhighlight lang="bash">
podman run -ti --name mi_debian debian
</syntaxhighlight>

== Paso 6.2: Eliminar contenedor cuando termine (--rm) ==

Vamos a mezclar todo lo visto anteriormente:

* Lanzar en segundo plano (-d)
* Ejecutar contenedor durante 30 segundos (sleep 30)
* Dar un nombre a la imagen (--name)
* Eliminar contenedor cuando termine (--rm)

<syntaxhighlight lang="bash">
podman run -d --rm --name bye-bye debian sleep 30
</syntaxhighlight>

Antes y una vez pasados los 30 segundos, podemos comprobar que el contenedor ha desaparecido.

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

= Paso 7: Parar y eliminar contenedores =

Para parar contenedores podemos usar el ID o su nombre:

<syntaxhighlight lang="bash">
podman stop my_container
podman stop e4901956f108
podman ps -a
</syntaxhighlight>

Una vez hemos comprobado que han terminado su ejecución, podemos eliminar los ficheros resultantes de su ejecución:

<syntaxhighlight lang="bash">
podman container rm my_container
</syntaxhighlight>

Para borrar todos los contenedores ya finalizados

<syntaxhighlight lang="bash">
podman container prune
</syntaxhighlight>

= Paso 8: Conectarnos a un contenedor que se está ejecutando en segundo plano =

Vamos a ejecutar de nuevo un contenedor que no termine:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a conectarnos a este contenedor que está ejecutándose en segundo
plano:

<syntaxhighlight lang="bash">
podman attach mi-contenedor
</syntaxhighlight>

Veremos la orden bash ejecutándose, para terminar, hacemos un 'CTRL + C', y ahora, veremos que ha pasado con el contenedor:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Lo veremos parado, por que lo que hemos hecho ha sido conectarnos al contenedor
y parar el comando que se estaba ejecutando, así que ahora tenemos el contenedor
finalizado.

''Nota:'' Para salir del contenedor '''sin detenerlo''' hacemos 'CTRL + P' seguido 'CTRL + Q'

= Paso 9: Ejecutar un comando dentro de un contenedor en ejecución =

Vamos a ver otresta vez como ejecutar un comando en un contenedor que ya está
ejecutándose:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a ejecutar un comando en ese contenedor con el nombre ''mi-contenedor''.
El comando exec es similar al comando run, pero para ejecutar un comando dentro de un contenedor:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor ls
</syntaxhighlight>

Para redirigir la salida a un fichero en el anfitrión:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor ls > x.txt
</syntaxhighlight>

Para redirigir la salida a un fichero ''dentro'' del contenedor, hacemos:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor sh -c "ls > x.txt"
</syntaxhighlight>

También es posible ejecutar comandos con tuberías:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor sh -c "ls -la | grep ^d"
</syntaxhighlight>

= Paso 10: Persistencia en contenedores =

Al hacer ''exit'' y salir de un contenedor, se pierden todos los cambios que hemos realizado. Los

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-ejemplo debian bash
</syntaxhighlight>

Ahora, vamos a crear una carpeta en el contenedor y comprobar que esa carpeta existe:

<syntaxhighlight lang="bash">
podman exec mi-ejemplo mkdir test
podman exec mi-ejemplo ls
</syntaxhighlight>

Veremos que la carpeta existe, pero, ¿qué ocurre si para el contenedor?

<syntaxhighlight lang="bash">
podman container stop mi-ejemplo
</syntaxhighlight>

Y volvemos a lanzarlo:

<syntaxhighlight lang="bash">
podman container rm mi-ejemplo
podman run -d -ti --name mi-ejemplo debian bash
podman exec mi-ejemplo ls
</syntaxhighlight>

Podemos comprobar que la carpeta creada anteriormente, no existe.

¿Qué podemos hacer para mantener la modificaciones realizadas sobre un contenedor?

== Paso 10.1: Crear una imagen derivada de la imagen base ==

Es posible crear una imagen derivada, con modificaciones, a partir de una imagen existente mediante la orden '''commit'''.

Por ejemplo, si queremos una imagen ''debian'' que incluya el programa ''ping'' ya instalado, tendríamos que lanzar un contenedor a partir de la imagen ''ubuntu'':

<syntaxhighlight lang="bash">
podman run -d -ti debian bash
</syntaxhighlight>

Suponiendo que el contenido está identificado con el ID 56ef5b312334

Instalamos el paquete ping:

<syntaxhighlight lang="bash">
podman exec 56ef5b312334 apt -y install ping
</syntaxhighlight>

Generamos la imagen derivada con el nombre ''ubuntu-con-ping'':

<syntaxhighlight lang="bash">
podman commit 56ef5b312334 ubuntu-con-ping
</syntaxhighlight>

Ya podemos para nuestro contendor:

<syntaxhighlight lang="bash">
podman stop 56ef5b312334
</syntaxhighlight>

Y lanzar un nuevo contenedor a partir de la imagen ''debian-con-ping'':

<syntaxhighlight lang="bash">
podman run -d -ti debian-con-ping bash
</syntaxhighlight>

== Paso 10.2: Mantener la persistencia mediante volúmen ==

Otra opción para mantener los datos es montar un volumen al ejecutar el contenedor.

Primero crearemos una carpeta que hará de volumen en nuestra máquina, que será la que luego montemos para podman:

<syntaxhighlight lang="bash">
mkdir /home/debian/volumen
</syntaxhighlight>

Ahora vamos a montar la carpeta al ejecutar el contenedor, lo hacemos con la
opción -v, la cual tiene 3 campos separados por ':':

# El volumen en nuestra máquina
# Donde se montará el volumen dentro del contenedor
# Opciones de mmontaje, por ejemplo rw (read and write) o ro (read only)

<syntaxhighlight lang="bash">
podman run --rm -ti -v /home/debian/volumen:/volumen:rw debian bash
mkdir /volumen/test
touch /volumen/test/file
exit
</syntaxhighlight>

Una vez nos salgamos del contenedor, podemos ver que en nuestra máquina están
los datos:

<syntaxhighlight lang="bash">
ls /home/ubuntu/volumen/
ls /home/ubuntu/volumen/test
</syntaxhighlight>

La próxima vez que ejecutemos un contenedor, si montamos ese volumen, los datos
estarán ahí, además esta forma tiene el beneficio de compartir datos entre
nuestra máquina y el contenedor de forma sencilla.

= Paso 11: Crear nuestra propia imagen de contenedor =

Para crear una imagen de un contenedor con una aplicación de Python hug, creamos en primer lugar la carpeta que contendrá los ficheros que nos permiten crear la imagen.

<syntaxhighlight lang="bash">
mkdir miapp
cd miapp
</syntaxhighlight>

Definimos un fichero ''Dockerfile'' para definir la imagen:

<syntaxhighlight lang="bash">
FROM debian

RUN apt -y update
RUN apt -y upgrade
RUN apt -y install python3-hug
RUN mkdir /app
COPY endpoint.py /app
WORKDIR /app
CMD hug -f endpoint.py
</syntaxhighlight>

Alternativamente, puedes crear un [[Creando imagen propia usando Ubuntu de base|Dockerfile empleando la imagen de Ubuntu]] como base en lugar de Alpine.

Y añadimos el fichero ''endpoint.py'' que emplea el framework Python hug con el contenido siguiente:

<syntaxhighlight lang="bash">
import hug

@hug.get('/welcome')
def welcome(username="unknown"):
""" Say welcome to username """
return "Welcome " + username
</syntaxhighlight>

Este fichero es un ejemplo de uso de Python hug. Si hacemos una petición a /welcome?username="LSO", esto nos devolverá el mensaje "Welcome LSO".

Una vez tengamos los dos ficheros creados en nuestra máquina virtual, podemos construir nuestra imagen:

<syntaxhighlight lang="bash">
podman build -t app:v1 -f Dockerfile
</syntaxhighlight>

Vamos a explicar para que sirve cada línea:

* FROM: servirá para basarnos en una imagen existente, en este caso, una imagen de python alpine, que contiene python y no ocupa mucho espacio
* ENV: para crear variables de entorno
* RUN: para ejecutar comandos, ya sea para crear una carpeta, instalar dependencias o cualquier otra opción que necesitemos
* COPY: para copiar datos desde nuestra máquina a la imagen
* WORKDIR: para cambiar el directorio de trabajo (lo crea si no existe)
* CMD: este comando será ejecutado por defecto al iniciar un contenedor a partir de esta imagen

Esto construirá una imagen podman basada en python:alpine, en la cual hemos
guardado nuestra pequeña aplicación y se va a ejecutar cuando ejecutemos un
contenedor basado en esa imagen. Para comprobar que la imagen se ha creado
correctamente, listamos las imagenes, y debería de aparecernos una imagen con
nombre 'app' y tag 'v1':

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen, y vamos a añadir una nueva
opción, -p 8001:8000. Esta opción hará que el puerto interno 8000 del contenedor
sea expuesto en el puerto 8001 de nuestra máquina:

<syntaxhighlight lang="bash">
podman run --name my-app --rm -d -p 8001:8000 app:v1
</syntaxhighlight>

''Nota:'' podman supone que la redirección de puerto es TCP, para una redirección de puertos UDP, puedes usar:

<syntaxhighlight lang="bash">
... -p 8001:8000/udp
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código. En nuestra
máquina haremos:

<syntaxhighlight lang="bash">
curl -X GET http://localhost:8001/welcome?username=LSO
</syntaxhighlight>

Comprobaremos que la salida del comando curl, es "Welcome LSO".

Antes de terminar, vamos a comprobar otro pequeño detalle que añadimos en
nuestra imagen, la variable de entorno USERNAME, vamos a comprobar que funciona:

<syntaxhighlight lang="bash">
podman exec -ti my-app ash
echo $USERNAME
</syntaxhighlight>

Funciona correctamente, pero al ejecutar el contenedor, podemos cambiar esta
variable de entorno como vimos en uno de los pasos anteriores:

<syntaxhighlight lang="bash">
podman run --rm -ti -e USERNAME=me app:v1 ash
echo $USERNAME
</syntaxhighlight>

Esto nos servirá para tener opciones por defecto y que el usuario pueda
cambiarlo a su antojo, como por ejemplo contraseñas u otros detalles.

== Paso 11.1: Depuración de problemas al crear nuestra imagen ==

Hay dos comandos que son particularmente útiles para averiguar por qué nuestra imagen no funciona:

* Consultar si el contenedor está ejecutándose:

<syntaxhighlight lang="bash">
podman container ls
</syntaxhighlight>

Que nos permite ver si el contenedor está activa y la redirección de puertos es correcta.

* Consultar los logs del contenedor:

<syntaxhighlight lang="bash">
podman logs 345fb5d21
</syntaxhighlight>

Esto nos permite saber qué está pasando dentro del contenedor, o qué pasó si éste dejo terminó su ejecución.

NOTA: Si usas la opción --rm al ejecutar tu contenedor, ¡los logs no estarán disponibles!

= Paso 12: Eliminar imágenes =

Para borrar una imagen, puede hacer:

<syntaxhighlight lang="bash">
podman image rm hello-world
</syntaxhighlight>

= Paso 13: Ejercicios =

== Ejercicio 1: Image derivada de Debian con el programa sl ==

Lance un contenedor a partir de una imagen de Debian, instale el programa sl, ejecute sl (desde fuera del contenedor) y detenga el contenedor.

== Ejercicio 2 ==

== Ejercicio 3: Variante de httpd ==

Construya una imagen ''httpd-hola-mundo'' a partir de la imagen ''httpd''. El fichero de index.html de la carpeta htdocs/ tiene que mostrar el mensaje "hola mundo".

<syntaxhighlight lang="bash">
podman pull httpd
</syntaxhighlight>

Edita el fichero Dockerfile:

<syntaxhighlight lang="bash">
nano Dockerfile
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
FROM httpd

COPY index.html htdocs/index.html
</syntaxhighlight>

Edita el fichero index.html:

<syntaxhighlight lang="bash">
nano index.html
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

Construye la imagen:

<syntaxhighlight lang="bash">
podman build -t mihttpd -f Dockerfile
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen:

<syntaxhighlight lang="bash">
podman run --name mihttpd -d -p 8080:80 mihttpd
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código:
<syntaxhighlight lang="bash">
curl -X GET http://localhost:8080
</syntaxhighlight>

Tiene que salir por pantalla esto:
<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

== Ejercicio 4: aplicación flask ==

Flask es un framework python para implementar webs. Cree una imagen "miapp-flask" a partir de la imagen de "python":

* Instale flask mediante: pip install flask
* Cree la carpeta "app"
* Establezca la variable FLASK_APP a "hello.py"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"

El fichero hello.py contiene un "hola mundo" para Flask:

<syntaxhighlight lang="python">
from flask import Flask
app = Flask(__name__)

@app.route("/")
def hello():
return "Hello World!"

if __name__ == "__main__":
app.run()
</syntaxhighlight>

Solución con alpine:

<syntaxhighlight lang="bash">
FROM python:alpine

RUN mkdir /app
RUN pip install flask
ENV FLASK_APP="app/hello.py"
COPY hello.py
WORKDIR /
CMD flask run --host=0.0.0.0
</syntaxhighlight>

Solución con Ubuntu:

<syntaxhighlight lang="bash">
FROM ubuntu:bionic

RUN apt-get update
RUN apt-get -y install python python-pip wget
RUN pip install Flask
ENV FLASK_APP="app/hello.py"
RUN mkdir /app
COPY hello.py /app
CMD flask run --host=0.0.0.0
</syntaxhighlight>

== Ejercicio 5: mysql ==

'''EN LA MÁQUINA VIRTUAL:'''

mkdir miapp
cd miapp
podman pull mysql
nano Dockerfile

<syntaxhighlight lang="bash">
FROM mysql
ENV MYSQL_ROOT_PASSWORD="lacontraseñaqueyoquiera"
RUN mkdir /app
WORKDIR /app

</syntaxhighlight>

CTRL+O , ENTER Y CTRL+X (para guardar Dockerfile y salir)

podman build -ti mrfdocker -f Dockerfile
podman run --name mymrf --rm -p 8001:3306 mrfdocker
docker images

'''EN LA TERMINAL DEL HOST:'''

''Instalación de mysql:''

apt install mysql-client-core-5.7
apt-get install mysql-server
service mysql start

''Para entrar:''

mysql -u root -p -P 8001

Una vez dentro de msql:

mysql> show databases;

''Para salir:''

exit

== Ejercicio 6: python pyramid ==

Pyramid es un framework python para implementar webs. Cree una imagen "miapp-pyramid":

* Emplee la imagen de debian como referencia, instale los paquetes python3 y python3-pyramid.
* Cree la carpeta "app"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"
* La aplicación se lanza con la orden: python3 hello.py
* Compruebe que funciona con curl, la ruta a la web es http://127.0.0.1:8000/hello, suponiendo que ha empleado el puerto 8000 para exponer el servicio.

El fichero hello.py contiene un "hola mundo" para Pyramid:

<syntaxhighlight lang="bash">
from wsgiref.simple_server import make_server
from pyramid.config import Configurator
from pyramid.response import Response

def hello_world(request):
print('Request inbound!')
return Response('Podman works with Pyramid!')

if __name__ == '__main__':
config = Configurator()
config.add_route('hello', '/')
config.add_view(hello_world, route_name='hello')
app = config.make_wsgi_app()
server = make_server('0.0.0.0', 6543, app)
server.serve_forever()
</syntaxhighlight>

Este programa recibe peticiones en el puerto 6543.

== Ejercicio 7 ==

Cree una imagen derivada de Ubuntu, instale el paquete apache2, php y libapache2-mod-php.
Active el módulo de php para apache2 mediante la orden:

<syntaxhighlight lang="bash">
a2enmod php
</syntaxhighlight>

Cree la carpeta /var/www/php.

Cree el fichero index.php

<syntaxhighlight lang="php">
<?php
Print "Hello, World!";
?>
</syntaxhighlight>

y copielo a /var/www/php/.

Cree el fichero 000-default.conf y copielo a /etc/apache2/sites-enabled/

Dicho fichero contiene.

<syntaxhighlight lang="bash">
<VirtualHost *:80>
DocumentRoot /var/www/php

<Directory /var/www/php/>
Options Indexes FollowSymLinks MultiViews
AllowOverride All
Order deny,allow
Allow from all
</Directory>

ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>
</syntaxhighlight>

Tiene que lanzar apache con la orden: apachectl -D FOREGROUND

Tras crear la imagen, láncela mapeando el puerto 8888 al 80, pruebe que puede acceder a http://127.0.0.1:8888/php/ mediante curl

Solución:

<syntaxhighlight lang="bash">
FROM ubuntu:latest

RUN apt-get update
RUN apt-get install -y tzdata
RUN apt-get install -y apache2
RUN apt-get install -y php
RUN apt-get install -y libapache2-mod-php
RUN a2enmod php7.2
COPY index.php /var/www/php
COPY 000-default.conf /etc/apache2/sites-enabled/
CMD apachectl -D FOREGROUND
</syntaxhighlight>

Y para lanzarlo:

podman run --name my-app --rm -d -p 8001:8000 app:v1

y para probarlo:

curl -X GET http://127.0.0.1:8888/php/

== Ejercicio 8 ==

Instale el paquete ''netcat-traditional'' en una imagen de contenedor de ''ubuntu''. Lance la orden:

nc -u -l -p 8080

en el contenedor. Asegúrese de crear una redirección de puertos de 9999 desde el ''host'' al puerto 8080 en el contenedor.

Desde fuera del contenedor, pruebe a conectarse con:

nc -u 127.0.0.1 9999

== Ejercicio 9 ==

Cree una imagen derivada de "ubuntu" con un Dockerfile que incluya soporte de python y lance el siguiente código en Python:

<syntaxhighlight lang="python">
from http.server import BaseHTTPRequestHandler, HTTPServer
import time

hostName = "0.0.0.0"
serverPort = 8080

class MyServer(BaseHTTPRequestHandler):
def do_GET(self):
self.send_response(200)
self.send_header("Content-type", "text/html")
self.end_headers()
self.wfile.write(bytes("<html><head><title>Welcome!</title></head>", "utf-8"))
self.wfile.write(bytes("<body>", "utf-8"))
self.wfile.write(bytes("This is an example web server.", "utf-8"))
self.wfile.write(bytes("</body></html>", "utf-8"))

if __name__ == "__main__":
webServer = HTTPServer((hostName, serverPort), MyServer)
print("Server started http://%s:%s" % (hostName, serverPort))

try:
webServer.serve_forever()
except KeyboardInterrupt:
pass

webServer.server_close()
print("Server stopped.")
</syntaxhighlight>

Llame a su imagen "python-http-server". Lance una instancia de la imagen "python-http-server" mapeando el puerto 9999 al puerto 8888/tcp del contenedor. Compruebe con:

<syntaxhighlight lang="bash">
curl http://127.0.0.1:9999/
</syntaxhighlight>

que muestre la página HTML que ofrece el servidor, que debería ser:

<syntaxhighlight lang="bash">
<html><head><title>Welcome!</title></head><body>This is an example web server.</body></html>
</syntaxhighlight>

= Anexo =

* Cómo usar [[Podman compose]]

Administración básica

2025-12-17T11:36:35Z

Pneira: /* su y sudo */

Para realizar esta práctica utilizaremos una de las máquinas virtuales que generamos mediante libvirt.

En esta práctica aprenderemos a utilizar el interprete de ordenes (también conocido como ''[https://www.traficantes.net/sites/default/files/pdfs/En%20el%20principio%20fue...-TdS.pdf línea de comandos]'') y a aprender nociones básicas de administración de sistemas Linux.

= Paso 0: Breve introducción al sistema Linux =

== Estructura básica del sistema de archivos ==

En un sistema Linux, todas las carpetas y ficheros en el sistema de fichero pende de la carpeta raíz que se representa con la /.

/
├── bin
├── usr
│ ├── local
│ ├── bin
│ └── ...
├── dev
│ ├── sda
│ ├── sda1
│ └── ...
├── home
│ ├── practica
│ │ ├── tema1.pdf
│ │ ├── boletin1.pdf
│ │ └── ...
│ ├── profesor
│ └── ...
└── etc
├── firefox
├── libvirt
├── ...
└── ...

Como puedes observar, el sistema de fichero emplea una estructura de árbol.

== Nociones básicas ==

·Aplicaciones con nombres compuestos: usar guion entre palabras

·Nombres con espacios en blanco: Escribir entre comillas dobles

·Espacios en blanco para separar ordenes (ej: instalar varios paquetes )

·Formato general de una orden: comando [-opciones] [argumentos]

·'''IMPORTANTE''': Diferencia entre mayúsculas y minúsculas

== Carpetas . y .. ==

Toda carpeta en un sistema Linux dispone de dos pseudocarpetas, la '''.''' y la '''..'':

* La pseudocarpeta '''..''' hace referencia a la carpeta padre que contiene a esta carpeta.
* La pseudocarpeta '''.''' hace referencia a la carpeta actual, es por tanto una autoreferencia.

En el caso de la carpeta raíz, la pseudocarpeta '''.''' y '''..''' hacen referencia a la propia carpeta raíz, se trata, por tanto de una excepción.

== Directorio de trabajo actual y la orden cd ==

Cada interprete de ordenes dispone de una ''carpeta de trabajo actual'' ('''c'''urrent '''w''orking '''d''irectory, en inglés). La carpeta de trabajo actual se puede modificar con la orden '''cd''' ('''c'''hange '''d'''irectory, en inglés).

Por ejemplo:

<syntaxhighlight lang="bash">
$ cd ..
</syntaxhighlight>

Nos situaría en la carpeta padre, empleando una ruta relativa.

Si volvemos a escribir desde /home " cd .. " nos lleva a '''/$'''

Para situarnos en el raíz, podemos emplear una ruta absoluta:

<syntaxhighlight lang="bash">
$ cd /
</syntaxhighlight>

En caso de que queramos volver a la carpeta de usuario, bastaría con invocar a '''cd''' sin más o ''' cd ~ '''

<syntaxhighlight lang="bash">
$ cd
</syntaxhighlight>

'''MUY IMPORTANTE''': No es lo mismo cd.. que ''' cd .. ''', es necesario el espacio después del cd.

== Rutas absolutas, rutas relativas ==

Para hacer referencia a un fichero o una carpeta se usan ruta absolutas o rutas relativas.

Las rutas absolutas siempre empieza por /, de manera que toman como punto de referencia la carpeta raíz (/). Por ejemplo, una ruta absoluta a la carpeta '''prueba''' que está almacenada en la carpeta del usuario '''ubuntu''' es '/home/ubuntu/prueba/'.

Las ruta relativa toma como referencia la carpeta de trabajo actual. Para averiguar la carpeta de trabajo actual disponemos de la orden '''pwd'''.

<syntaxhighlight lang="bash">
$ pwd
/home/ubuntu
</syntaxhighlight>

En base a la carpeta de trabajo actual, empleando la pseudocarpeta '''..''', se puede construir rutas relativas. Por ejemplo, para referenciar un fichero '''fichero.txt''' en la carpeta temporal, podemos emplear la ruta relativa '''../../tmp/fichero.txt'''.

Aunque probablemente sea más cómodo emplear una ruta absoluta en este caso, que sería '''/tmp/fichero.txt'''.

== Intérprete de órdenes ==

El intérprete de órdenes es un lanzador de aplicaciones textual que emplea el teclado como dispositivo de entrada de datos. Mediante el teclado, se escribe el nombre del programa que se quiere lanzar y al pulsa la tecla ''intro'' el intérprete de ordenes ejecutara dicho programa. Por defecto, el intérprete de ordenes que emplea Ubuntu por defecto es '''bash'''.

== man: ver la página de manual de una orden ==

La orden '''man''' te será útil para ver las páginas de manual.

Su estructura básica es:

<syntaxhighlight lang="bash">
man <comando>
</syntaxhighlight>

Aunque también se utiliza con la opción ''' -a ''' de All, que también muestra las entradas comenzadas por '''.''':

<syntaxhighlight lang="bash">
man -a <comando>
</syntaxhighlight>

Este programa toma como entrada el nombre de la orden de la que quieres consultar su página de manual, por ejemplo:

<syntaxhighlight lang="bash">
man ls
</syntaxhighlight>

Nos da información del manual de la orden '''ls'''.

Para salir de la página de manual, pulsa la tecla '''q''' (la primera letra de la palabra '''quit''', en inglés).

quit = salir

Normalmente, los programas ofrecen opciones de ayuda, como '''--help'''.

<syntaxhighlight lang="bash">
man --help
</syntaxhighlight>

También se puede emplear la versión compacta a la hora de especificar opciones.

<syntaxhighlight lang="bash">
man -h
</syntaxhighlight>

En general, todas las ordenes suelen ofrecer una opción de ayuda.

= Paso 1: Operaciones básicas con el sistema de ficheros =

== ls ==

Lista los ficheros y carpetas. Si no se especifica nada, muestra los ficheros y carpetas que contiene la carpeta de trabajo actual.

<syntaxhighlight lang="bash">
ls
</syntaxhighlight>

Si se especifica una ruta, muestra las carpetas y ficheros contenidos en dicha ruta, por ejemplo:

<syntaxhighlight lang="bash">
$ ls /
bin boot data dev etc home initrd.img initrd.img.old lib lib64 lost+found media mnt opt proc root run sbin snap srv sys tmp usr var vmlinuz vmlinuz.old
</syntaxhighlight>

Al emplear '''/''' como ruta absoluta, muestra el contenido de la carpeta raíz.

Las opciones más usadas de este programa suelen ser:

* -a: muestra los ficheros y carpetas ''ocultos''. En Linux, cualquier fichero o carpeta cuyo nombre empiece por . se considera ''oculto''. Esto incluye también en el listado las pseudocarpetas . y ..

* -l: se muestra en lista y aporta datos como la fecha de última modificación, propietario, grupo, tamaño en bytes y nombre:

<syntaxhighlight lang="bash">
$ ls -a

. .. .bash_history .bash_logout .bashrc .profile .ssh
</syntaxhighlight>

Ambas opciones se puede combinar:

<syntaxhighlight lang="bash">
$ ls -la /

total 92
drwxr-xr-x 24 root root 4096 Aug 28 09:50 .
drwxr-xr-x 24 root root 4096 Aug 28 09:50 ..
drwxr-xr-x 2 root root 4096 Aug 22 12:37 bin
drwxr-xr-x 4 root root 4096 Aug 22 12:37 boot
drwx------ 3 root root 4096 Aug 28 09:50 data
drwxr-xr-x 18 root root 3780 Aug 28 09:46 dev
[...]

</syntaxhighlight>

Otras opciones útiles son:

* -s : muestra el tamaño en bloques de cada archivo

* -t : aporta el día y la hora de modificación

* -R : lista también las subcarpetas

* --color : muestra el contenido coloreado

Los '''permisos''' se emplean en base a tres capacidades:

* Lectura, que se codifica con '''r''' (read, en inglés).
* Escritura, que se codifica con '''w''' (write, en inglés).
* Ejecutación, que se codifica con '''x''' (execute, en inglés).

La primera columna muestra los permisos que codifican:

* Tipo de entrada: '''d''' indica ''directorio'' (''carpeta'').
* Permisos del propietario, primera terna de rwx
* Permisos del grupo, segunda terna de rwx
* Permisos para el resto del mundo, tercera terna de rwx.

A continuación, aparecen el propietario y el grupo, seguidos de la fecha de última modificación y el nombre del fichero o carpeta.

La ayuda ( help ) en ls solo funciona con ''' ls --help ''' no con ls -h

== mkdir ==

Crea un nuevo directorio.

<syntaxhighlight lang="bash">
$ mkdir test
</syntaxhighlight>

Crea una carpeta test en el directorio actual.

Comprobemos que se ha creado bien:

<syntaxhighlight lang="bash">
$ ls
test
</syntaxhighlight>

Con la opción '''-p''', permite crear sucesivas carpetas anidadas de una sola vez, por ejemplo:

<syntaxhighlight lang="bash">
$ mkdir -p a/b/c
</syntaxhighlight>

Que crea la siguiente estructura de carpetas.

a
└── b
└── c

== touch (y dd) ==

Crea un nuevo fichero vacío (sin contenido) con el nombre que especifiquemos.

<syntaxhighlight lang="bash">
$ touch file.txt
</syntaxhighlight>

Comprobamos que el fichero se ha creado correctamente.

<syntaxhighlight lang="bash">
$ ls
file.txt
</syntaxhighlight>

NOTA: Hay otra herramienta que permite crear ficheros, como:

<syntaxhighlight lang="bash">
$ dd if=/dev/zero of=fichero bs=1M count=100
</syntaxhighlight>

para crear un fichero relleno de ceros de 100 Mbytes.

En realidad ''dd'' se puede usar para volcar datos de ficheros imágenes a unidades y viceversa, pero ese caso de uso no se explora en la asignatura.

== cp ==

Copia un fichero o directorio.

<syntaxhighlight lang="bash">
$ cp file.txt file_copy.txt
</syntaxhighlight>

Para copiar una carpeta y su contenido tenemos que usar la opción -r (recursivo).

<syntaxhighlight lang="bash">
$ cp -r test test_copy
</syntaxhighlight>

* Comprobamos el resultado con la orden '''ls'''.

* Si nos encontramos en la carpeta destino, la estructura sería la siguiente:

<syntaxhighlight lang="bash">
$ cp <nombre ruta origen> <nombre archivo>
</syntaxhighlight>

== mv ==

Mueve fichero o directorio.

Por ejemplo, para mover un directorio ''carpeta1'' a otro lugar

<syntaxhighlight lang="bash">
mv carpeta1 /tmp
</syntaxhighlight>

NOTA: si el destino es una carpeta y existe, mueve el origen dentro de la carpeta de destino.

También se puede usar para renombrar:

<syntaxhighlight lang="bash">
mv carpeta1 carpeta2
</syntaxhighlight>

En este caso, renombra ''carpeta1'' a ''carpeta2''.

También se puede usar con fichero, para renombrar:

<syntaxhighlight lang="bash">
mv test_copy test_copy2
</syntaxhighlight>

y también para mover:

<syntaxhighlight lang="bash">
mv test_copy2 /tmp
</syntaxhighlight>

== rm ==

* Borra un fichero o carpeta vacía:
<syntaxhighlight lang="bash">
rm fichero.txt
</syntaxhighlight>

* Para borrar una carpeta no vacía y su contenido:
<syntaxhighlight lang="bash">
rm -r carpeta123
</syntaxhighlight>

* Para borrar todo el contenido de la carpeta actual

<syntaxhighlight lang="bash">
rm -r *
</syntaxhighlight>

* EJERCICIOS:

# Crear la siguiente estructura dentro del directorio /tmp (usar los comandos mkdir, touch y cp):

/tmp
├── carpeta1
├── carpeta2
│ ├── fichero1.txt
│ └── fichero2.md
└── carpeta3
 ├── fichero1.txt
 └── fichero2.md

# Basándonos en el ejercicio anterior, cambiar la estructura a la siguiente (usar comandos mv y rm):

/tmp
└── carpeta
 ├── fichero1.txt
└── fichero2.md

= Paso 2: Impresión por pantalla y redirección de salida =

== echo ==

Sirve para imprimir una línea de texto por pantalla o variables de entorno. Además, nos permite escribir en ficheros.

<syntaxhighlight lang="bash">
echo "hola mundo"
</syntaxhighlight>

* Opciones:
-n elimina salto de línea

Una variable de entorno es una variable editada con algún valor, por defecto existen algunas creadas, como por ejemplo la variable HOME, que contiene el directorio del usuario:

<syntaxhighlight lang="bash">
echo $HOME
</syntaxhighlight>

Aprovecharemos y crearemos una variable nosotros:

<syntaxhighlight lang="bash">
ME="my name"
</syntaxhighlight>

Comprobamos:

<syntaxhighlight lang="bash">
echo $ME
</syntaxhighlight>

== Redirección de salida ==

> y >> sirve para redirigir una salida. Por ejemplo, utilizando el comando echo,
podemos enviar un texto dentro de un fichero:

<syntaxhighlight lang="bash">
echo "Esto es una prueba" > file.txt
</syntaxhighlight>

La diferencia entre > y >> es que > sobrescribe lo que haya en el fichero y
añade el contenido, y >> no sobrescribe, solo añade el nuevo contenido.

Hagamos la prueba:

<syntaxhighlight lang="bash">
echo "Esto es una prueba" > file.txt
echo "Esto es una prueba2" > file.txt
echo "Esto es una prueba" >> file2.txt
echo "Esto es una prueba2" >> file2.txt
</syntaxhighlight>

En cualquier caso, si el fichero no existe, se crea.

= Paso 3: Manejo de ficheros y carpetas avanzado =

== cat ==

* Muestra el contenido de un fichero:

<syntaxhighlight lang="bash">
cat fichero.txt
</syntaxhighlight>

* Crea un fichero:

<syntaxhighlight lang="bash">
cat > otrofichero.txt
</syntaxhighlight>

Para guardar el contenido, pulsa CTRL + D para indicar "final de fichero".

* Añadir más lineas al fichero:

<syntaxhighlight lang="bash">
cat >> otrofichero.txt
</syntaxhighlight>

* Concatenar ficheros

<syntaxhighlight lang="bash">
cat fichero1.txt fichero2.txt
</syntaxhighlight>

* Concatenar ficheros y guardar en otro fichero

<syntaxhighlight lang="bash">
cat fichero1.txt fichero2.txt > fichero3.txt
</syntaxhighlight>

== less ==

Sirve para ver el contenido de un fichero, permite navegar arriba y abajo.

Se sale pulsando la tecla ''q''.

<syntaxhighlight lang="bash">
less fichero.txt
</syntaxhighlight>

Útil cuando el fichero tiene contenido mayor a lo que se puede mostrar en pantalla.

== grep ==

Sirve para localizar coincidencias de un cierto patrón en ficheros y muestra la coincidencia, en caso de encontrarla, por pantalla.

<syntaxhighlight lang="bash">
grep <opción> <patrón> <archivos donde buscar>
</syntaxhighlight>
Por ejemplo, para buscar el patrón ''prueba'' en el fichero ''fichero.txt''.

<syntaxhighlight lang="bash">
$ grep -n prueba fichero.txt
1:Esto es una prueba
</syntaxhighlight>

* Principales opciones del comando:

-c : Escribe el número de líneas encontradas.

-i : No distingue entre mayúsculas y minúsculas.

-l : Muestra los nombres de los ficheros que contienen los caracteres buscados.

-n : Cada línea es precedida por su número en el fichero.

-s : No se muestran los mensajes que indican que no se puede abrir un fichero.

-v : Muestra sólo las líneas que no cumplen la condición.

== wc ==

Sirve para contar el número de palabras, caracteres, líneas o bytes que contiene un fichero.

Las opciones más utilizadas son:

* -l: muestra el número de líneas que contiene el fichero.
* -w: muestra el número de palabras.
* -m: muestra el número de caracteres
* -c: muestra el número de bytes

Probemos y contemos todo en el fichero file2.txt:

<syntaxhighlight lang="bash">
wc -l file2.txt
wc -w file2.txt
wc -m file2.txt
wc -c file2.txt
</syntaxhighlight>

Podemos contar más de un fichero a la vez:

<syntaxhighlight lang="bash">
wc -l file.txt file2.txt
</syntaxhighlight>

Nos mostrará el conteo de cada fichero y el total.

== sort ==

Ordenar las líneas de un fichero de manera alfanumérica

<syntaxhighlight lang="bash">
sort file.txt
</syntaxhighlight>

== find ==

Para buscar ficheros podemos usar la orden ''find''.

Por ejemplo, para buscar el fichero ''python3'' en todo el árbol de directorio (desde el raíz) podemos usar la orden:

<syntaxhighlight lang="bash">
find / -name python3
</syntaxhighlight>

Podemos restringir la búsqueda a ficheros con ''-type f''

<syntaxhighlight lang="bash">
find / -type f -name python3
</syntaxhighlight>

o para directorios con ''-type d''

Se puede usar también para buscar directorios.

Por ejemplo, para buscar todos los directorios contenidos en x123:

<syntaxhighlight lang="bash">
find / -type d -name x123
</syntaxhighlight>

Además, se puede combinar con ''-exec'' para ejecutar otra orden usando cada una de las coincidencias.

Por ejemplo, para hacer un ''ls -l'' para cada fichero terminado en ''.txt'' en el directorio actual:

<syntaxhighlight lang="bash">
find . -type f -name *.txt -exec ls -l {} \;
</syntaxhighlight>

En este caso ''{}'' es un ''placeholder'', es decir, se reemplaza por cada coincidencia que ''find'' encuentra cuando se invoca a la orden que se ha especificado por medio de ''-exec''.

NOTA: ''-exec'' necesita \; como terminador.

Puede también buscar cambios recientes en una carpeta, por ejemplo, los ficheros modificados hace 60 minutos:

<syntaxhighlight lang="bash">
find . -type f -amin -60
</syntaxhighlight>

== Tubería (|) ==

En Linux, está la entrada y salida estándar:

* La salida estándar es la pantalla, la salida estándar se usa para mostrar los resultados.
* La entrada estándar, que sirve para obtener datos, se trata del teclado.

NOTA: Además, está la salida estándar de errores, que también es la pantalla, pero que tiene prioridad sobre lo mostrado en la salida estándar.

En general, las órdenes que empleamos:

* Usan la salida estándar para mostrar el resultado de su ejecución.
* Usan la entrada estándar para leer datos, siempre que el usuario no haya especificado un fichero.

Por ejemplo, al hacer:

<syntaxhighlight lang="bash">
grep "prueba"
</syntaxhighlight>

la orden ''grep'' espera a que el usuario introduzca los datos por teclado para encontrar una coincidencia del patrón ''prueba''.

Este comportamiento es útil para el mecanismo de tuberías que describimos a continuación.

Una tubería nos servirá para conectar la salida estándar de un comando en la entrada estándar de otro.

<syntaxhighlight lang="bash">
cat file2.txt | grep prueba
grep -nr prueba file2.txt | wc -l
</syntaxhighlight>

En este ejemplo, cat muestra el contenido de file2.txt por la y esta salida se la
pasamos al comando grep, el cual busca las líneas que contengan prueba.

En el segundo, buscamos todas las líneas que contengan la palabra prueba, y esta
salida se la pasamos al comando wc, el cual cuenta las líneas de la salida del
comando grep.

== Redirecciones ==

Vamos a ver unos conceptos antes de seguir:

* Entrada estándar: representa los datos que necesita una aplicación para funcionar, como por ejemplo un archivo de datos o información ingresada desde la terminal y es representado en la terminal como el tipo 0.
* Salida estándar: es la vía que utilizan las aplicaciones para mostrarte información, allí podemos ver el progreso o simplemente los mensajes que la aplicación quiera darte en determinado momento y es representado en la terminal como el tipo 1.
* Error estándar: es la forma en que los programas te informan sobre los problemas que pueden encontrarse al momento de la ejecución y es representado en la terminal como el tipo 2.

Las redirecciones nos sirven para mover la información de un tipo a otro.

Ya vimos previamente el uso de > y >>, y también el |, veamos algunas más:

* comando < fichero: Toma la entrada de fichero
* comando 2> fichero: Envía la salida de error de comando a fichero
* comando 2>&1: Envía la salida de error a la salida estándar
* comando &> fichero: Envía la salida estándar y de error a fichero; equivale a comando > fichero 2>&1

== curl ==

Puede usar la utilidad ''curl'' para descargar ficheros.

<syntaxhighlight lang="bash">
curl https://ash-speed.hetzner.com/100MB.bin -o 100MB.bin
</syntaxhighlight>

También se puede usar la orden ''wget''.

== tar ==

Para comprimir una carpeta:

<syntaxhighlight lang="bash">
tar cvzf fichero.tar.gz carpeta1
</syntaxhighlight>

Para descomprimirla:

<syntaxhighlight lang="bash">
tar xvf fichero.tar.gz
</syntaxhighlight>

== file ==

Sirve para comprobar el tipo de fichero:

<syntaxhighlight lang="bash">
file f1.txt
</syntaxhighlight>

que muestra:

<syntaxhighlight lang="bash">
f1.txt: ASCII file
</syntaxhighlight>

cuando es un fichero de texto.

<syntaxhighlight lang="bash">
file fichero.tar.gz
</syntaxhighlight>

que muestra:

<syntaxhighlight lang="bash">
fichero.tar.gz: gzip compressed data, from Unix, original size modulo 2^32 20480
</syntaxhighlight>

En general, sirve para saber de qué tipo de fichero se trata.

= Paso 4: Usuarios y grupos =

== whoami ==

Sirve para obtener el usuario actual.

<syntaxhighlight lang="bash">
whoami
</syntaxhighlight>

Lo más seguro es que nos aparezca ubuntu.

== who ==

Es para saber quien está ahora mismo en la máquina conectado.

<syntaxhighlight lang="bash">
who
</syntaxhighlight>

Seguramente solo estemos nosotros:

<syntaxhighlight lang="bash">
root pts/0 2019-08-28 13:51 (192.168.122.1)
</syntaxhighlight>

''pts/0'' es el terminal desde el que está el usuario ''root''.

== su y sudo ==

su (substitute user): sirve para cambiar de usuario. Por ejemplo:

<syntaxhighlight lang="bash">
su - root
</syntaxhighlight>

Aquí nos pedirá la contraseña del usuario al que queramos cambiar.

sudo (super user do): no todas las distribuciones lo integran, porque es menos
seguro que su, este comando nos permite ejecutar un comando siendo otro usuario,
por defecto, si no le damos usuario, lo hará con el usuario root. Si sudo nos
pide contraseña, nos pide la contraseña del usuario, ya que el usuario es que el
tiene permisos para usar sudo o no.

<syntaxhighlight lang="bash">
sudo ls -a /root
</syntaxhighlight>

Si tuviéramos por ejemplo un usuario 'practica' y quisíeramos ejecutar un
comando en su nombre:

<syntaxhighlight lang="bash">
sudo -u practica ls
</syntaxhighlight>

Como root puedo añadir usuarios para que puedan hacer sudo así:

<syntaxhighlight lang="bash">
adduser usuario sudo
</syntaxhighlight>

Esto hace que el usuario ''usuario'' pueda hacer sudo

== adduser ==

Para añadir un usuario ''practica'':

<syntaxhighlight lang="bash">
sudo adduser practica
</syntaxhighlight>

== passwd ==

Sirve para modificar la contraseña de un usuario, por ejemplo, vamos a modificar
la contraseña del usuario que hemos creado previamente:

<syntaxhighlight lang="bash">
sudo passwd practica
</syntaxhighlight>

Nos preguntará dos veces la contraseña, y ya la tendremos actualizadas. Vamos
ahora a probar ahora el comando su para cambiar de usuario:

<syntaxhighlight lang="bash">
su practica
whoami
</syntaxhighlight>

Veremos que hemos cambiado de usuario, para cerrar este usuario, escribimos
'exit' o pulsamos 'CTLR + D'

== deluser y userdel ==

Ambos sirven para borrar un usuario, similar a adduser y useradd, userdel es el
comando y deluser el script.

Vamos a borrar el usuario que hemos creado, incluyendo el borrado de su /home
(opción -r):

<syntaxhighlight lang="bash">
userdel -r practica
</syntaxhighlight>

Comprobemos que ya no tenemos usuario ni /home:

<syntaxhighlight lang="bash">
ls /home
sudo -u practica whoami
</syntaxhighlight>

== addgroup y groupadd ==

Ambos sirven para crear un grupo. Los grupos sirven para agrupar a los usuarios
y que estos tengan unos mismos permisos. Por ejemplo, cuando instalamos algunas
herramientas como por ejemplo docker, este crea el grupo docker automáticamente
para que fácilmente podamos añadir a un usuario al grupo, y este tenga los
permisos para trabajar con dicha herramienta.

Vamos a crear un nuevo grupo, vamos a llamarle invitado:

<syntaxhighlight lang="bash">
sudo groupadd invitado
</syntaxhighlight>

== usermod y groups ==

usermod es utilizado para asignar un grupo a un usuario.

groups es utilizado para ver los grupos a los que pertenece un usuario.

Vamos a añadir a un usuario practica, lo vamos a añadir al grupo invitado y
veremos los grupos a los que pertenece:

<syntaxhighlight lang="bash">
sudo useradd -m practica
sudo usermod -G invitado practica
groups practica
</syntaxhighlight>

Veremos que el usuario práctica pertenece al grupo invitado.

== delgroup y groupdel ==

Ambos sirven para eliminar un grupo. Vamos a eliminar el grupo que hemos creado
anteriormente:

<syntaxhighlight lang="bash">
sudo groupdel invitado
</syntaxhighlight>

Podemos observar ahora que el usuario practica no pertenece al grupo invitado:

<syntaxhighlight lang="bash">
groups practica
</syntaxhighlight>

= Paso 5: Permisos =

== Nomenclatura rwx y numérica ==

Si hacemos un ls -l, la primera cadena que nos aparece son los permisos del
fichero (-rwxrw-r--), podemos dividirlo en 4 elementos:

- (rwx) (rw-) (r--)
| | | |
type owner group others

* type: el tipo de fichero, pudiendo ser d (directorio), l (enlace simbólico), - (fichero normal)
* owner: permisos de propietario
* group: permisos de grupo
* others: permisos para los demás usuarios

Significado de los permisos:

* r: permisos de lectura
* w: permisos de escritura
* x: permisos de ejecución

Por último, existe un modo abreviado para estos permisos que se utiliza con
números.

rwx
001 en binario es 1 en decimal. Permisos de ejecución
010 en binario es 2 en decimal. Permisos de escritura
100 en binario es 4 en decimal. Permisos de lectura

La suma de los permisos, nos da el valor numérico. Veamos un ejemplo:
rwx rw- r--
110 110 100
6 6 4

'''Ojo''': ¡No emplee nunca los permisos 777 (rwxrwxrwx) cuando tenga problemas con los permisos!

== chmod ==

Permite cambiar los permisos de acceso a un fichero o directorio. Podemos dar
permisos de dos formas diferentes.

=== modo carácter ===

Veamos primero unos detalles:

Clases de usuario:

* owner (u)
* group (g)
* others (o)
* all (a)

Modificador:

* añadir (+)
* eliminar (-)
* sobrescribir (=)

Para dar permisos tendríamos que seleccionar la clase de usuario el modificador
y los permisos, veamos un ejemplo:

<syntaxhighlight lang="bash">
chmod u+x file # añadimos permisos de ejecución al usuario
chmod go-w file # quitamos permisos de escritura al grupo y a otros usuarios
chmod u=rwx,go=r file # Al usuario le damos todos los permisos, y al grupo y otros solo le damos permisos de lectura
</syntaxhighlight>

=== Modo octal ===

Con el modo octacl, es como si siempre utilizáramos el modificar sobrescribir,
pongamos algunos ejemplos:

<syntaxhighlight lang="bash">
chmod 644 file # Al usuario le damos permiso de lectura y escritura al usuario, y al grupo y otros solo le damos permisos de lectura
chmod 600 file # solo el propietario tiene permisos de lectura y escritura
</syntaxhighlight>

=== Ejemplos ===

Vamos a ver como funciona el tema de permisos con unos ejemplos. Vamos a crear
un fichero pruebas y le vamos a quitar los permisos de escritura a nuestro
usuario, y le vamos a dar permisos de escritura a otros:

<syntaxhighlight lang="bash">
touch pruebas
ls -l pruebas # de esta forma veremos que por defecto los permisos son rw-rw-r--
chmod u-w,o+w pruebas
ls -l pruebas # ahora los permisos deberían ser -w-rw-rw-
</syntaxhighlight>

Una vez dado los permisos, veamos que con nuestro usuario podemos leer pero no
escribir:

<syntaxhighlight lang="bash">
cat pruebas
echo "probando" > pruebas
exit
</syntaxhighlight>

Y ahora vamos a ver que el usuario pruebas, puede leer y escribir:

<syntaxhighlight lang="bash">
su practica
cat pruebas
echo "probando" > pruebas
</syntaxhighlight>

== chown ==

Permite cambiar el propietario de un fichero o directorio.

Vamos por ejemplo a pasarle ahora el fichero pruebas al usuario practica:

<syntaxhighlight lang="bash">
sudo chown practica pruebas
ls -l pruebas
</syntaxhighlight>

Veremos que el usuario actual ahora es pruebas, aunque vemos que el ls muestra
lo siguiente:

<syntaxhighlight lang="bash">
-r--rw-rw- 1 practica ubuntu 9 Aug 29 09:34 pruebas
</syntaxhighlight>

Hay que comentar un detalle, y es que los ficheros y directorios tienen asignado
un usuario y un grupo, por defecto se utiliza el mismo usuario como grupo
cuando creamos un nuevo fichero o directorio. Si queremos que cuando cambiemos
el propietario, cambiar tambien el grupo del fichero, podemos hacerlo de la
siguiente forma:

<syntaxhighlight lang="bash">
sudo chown practica:practica pruebas
</syntaxhighlight>

Una vez hecho esto, vamos ahora a probar que los permisos siguen funcionando
como antes, ahora con el usuario ubuntu, deberíamos de poder leer y escribir en
el fichero pruebas, y con el usuario practica, solo leer, esto es así por que
ahora el propitario es practica:

<syntaxhighlight lang="bash">
# Pruebas usuario ubuntu
cat pruebas
echo test >> pruebas
# Pruebas usuario practica
su practica
cat pruebas
echo "probando" > pruebas
exit
</syntaxhighlight>

= Paso 6: Procesos =

== ps ==

Sirve para ver que procesos están ejecutándose en el sistema, veamos un ejemplo:

<syntaxhighlight lang="bash">
ps aux # con la opción aux mostraremos todos los procesos del sistema
</syntaxhighlight>

Cada línea es un proceso, y cada proceso muestra su PID, usuario, cantidad de
memoria y cpu utilizada, comando y otros detalles.

<syntaxhighlight lang="bash">
man kill & # añadir el & al final de un comando hace que este se ejecute en segundo plano, por lo que se quedará abierto
</syntaxhighlight>

La salida de este comando nos mostrará el PID que tiene ese proceso que acabamos
de ejecutar, vamos a comprobarlo:

<syntaxhighlight lang="bash">
ps aux | grep "man kill"
</syntaxhighlight>

Veremos que el PID coincide.

== kill ==

Este comando nos servirá para matar un proceso. kill se utiliza seguido de una
señal para enviar al proceso seguido de uno o varios PID. para ver las señales
disponibles, podemos listarlas:

<syntaxhighlight lang="bash">
kill -l
</syntaxhighlight>

Las más utilizadas suele ser SIGTERM y SIGKILL, la primera intenta terminar el
proceso de forma poco abrupta, y la segunda suele utilizarse cuando el proceso
no atiende a esta primera señal. Vamos ahora a terminar el proceso que creamos
antes, si no recordamos el PID, busquémoslo de nuevo:

<syntaxhighlight lang="bash">
ps aux | grep "man kill"
</syntaxhighlight>

Enviamos señal para terminar el proceso y comprobamos que ha terminado:

<syntaxhighlight lang="bash">
kill -SIGTERM 8470
ps aux | grep "man kill"
</syntaxhighlight>

También podemos notar que en el listado de señales, hay unos números, podemos
utilizar esos números en vez de las palabras, por ejemplo:

<syntaxhighlight lang="bash">
man kill &
kill -15 PID_COMANDO_PREVIO
</syntaxhighlight>

Comprobamos que el proceso ha terminado correctamente:

<syntaxhighlight lang="bash">
ps aux | grep "man kill"
</syntaxhighlight>

= Paso 7: Estado CPU, RAM y Disco =

== top ==

Este comando nos servirá para ver el listado de procesos y el estado de la CPU y
memoria.

Probemos el comando y observemos detalladamente la salida:

<syntaxhighlight lang="bash">
top
</syntaxhighlight>

Para salir, pulsamos q.

== df y du ==

df (disk free) y du (disk usage). Ambas son utilidades para mostrar el uso de
los discos.

Con df mostraremos la información del espacio en cada dispositivo montado:

<syntaxhighlight lang="bash">
df
</syntaxhighlight>

Estos comandos que nos muestran el tamaño de los ficheros, casi siempre tienen
una opción para mostrarlo en un formato más legible (-h)

<syntaxhighlight lang="bash">
df -h
</syntaxhighlight>

Mucho mejor.

Ahora veamos el comando du, el cual nos mostrará el tamaño de un fichero o
directorio y sus subdirectorios, no olvidemos el -h:

<syntaxhighlight lang="bash">
du -h /home/ubuntu
du -h /home/ubuntu/pruebas
</syntaxhighlight>

Si solo quisíeramos saber el total de una carpeta y nos nos interesan sus
subcarpetas, podemos utilizar la opción -s:

<syntaxhighlight lang="bash">
du -sh /home/ubuntu
</syntaxhighlight>

== free ==

Sirve para ver el estado de la memoria, como siempre, opción -h:

<syntaxhighlight lang="bash">
free -h
</syntaxhighlight>

== lsblk ==

Nos muestra la información de todos los dispositivos de bloques (discos duros,
pendrivers, CD_ROM, SSD, ...).

<syntaxhighlight lang="bash">
lsblk
</syntaxhighlight>

En la siguiente práctica se utilizará más a fondo este comando, ya que
trabajaremos con dispositivos.

= Paso 8: Gestión de paquetes de software y repositorios =

Los sistemas Linux incluyen, además de las herramientas básicas del sistema operativo, repositorios de software que puede ser opcionalmente instalados por el administrador del sistema. Los fabricantes de las distribuciones de Linux incluyen paquetes de software listos para ser instalados que se integran con el sistema.

Un paquete incluye el software necesario para que una cierta aplicación funcione correctamente, así como sus paquetes de dependencia.

En Ubuntu, la herramienta de gestión de paquetes de software y repositorios se llama '''apt'''.

=== Listado de repositorios de paquetes de software ===

En Ubuntu el listado de repositorios se encuentra en el fichero /etc/apt/sources.list. Podemos comprobar que repositorios tenemos añadido:

<syntaxhighlight lang="bash">
cat /etc/apt/sources.list
</syntaxhighlight>

=== Actualización del listado de paquetes de software ===

Para actualizar el listado de paquetes utilizaremos el comando:

<syntaxhighlight lang="bash">
sudo apt update
</syntaxhighlight>

=== Instalación un nuevo paquete ===

Para instalar un nuevo paquete, utilizaremos la orden install, por ejemplo, vamos a instalar tree, similar al ls pero muestra el arbol de directorios:

<syntaxhighlight lang="bash">
sudo apt install tree
</syntaxhighlight>

=== Desinstalación de un paquete ===

Usaremos la orden purge o la orden remove, purge nos lo eliminad todo, y remove mantiene la configuración en el caso de que el paquete la tuviese. Vamos a eliminar el paquete instalado previamente:

<syntaxhighlight lang="bash">
sudo apt purge tree
</syntaxhighlight>

= Paso 9: Administración remota con ssh =

''ssh'' (Secure SHell) permite administrar de manera remota un sistema desde el intérprete de órdenes. Para poder acceder a la máquina virtual por medio de ''[[ssh]]'', hay que instalar el paquete ''openssh-server''.

sudo apt-get install openssh-server

Una vez instalado, tenemos que consultar la dirección IP de la máquina virtual

ip address

Desde el hipervisor podemos acceder por ''ssh'' a la máquina virtual con la orden:

ssh usuario@ip

Siendo ''usuario'' el nombre de usuario con el que accedes a la máquina virtual y la dirección ''ip'' que nos muestra la orden ''ip address''.

Por ejemplo, si el usuario seleccionado es ''ubuntu'' y la IP es 192.168.122.123, entonces la invocación a ''ssh'' es la siguiente:

ssh ubuntu@192.168.122.123

En caso de que en la maquina virtual no esté instalado openssh-server, puede que la conexión sea rechazada:
ssh: connect to host 192.168.122.123 port 22: Connection refused

Para resolver el problema es necesario instalar OpenSSH client en la maquina virtual

sudo apt install openssh-client

Y a continuación se instala OpenSSH server

sudo apt install openssh-server

En la imagen de Ubuntu Cloud el servicio de ssh viene instalado por defecto, sin embargo no está activo. Para activarlo hay que crear las claves SSH del servidor:

# ssh-keygen -A

además, hay que editar el fichero /etc/sshd/sshd_config para establecer:

PasswordAuthentication yes

pues está por defecto a ''no''.

y luego lanzar el servicio:

# systemctl enable ssh
# systemctl start ssh

La orden ''enable'' hace que el servicio se lance la próxima vez que arranque el sistema. La orden lanza el servicio inmediatamente.

Puedes comprobar que el servicio está lanzado con:

# ss -lt

donde -l muestra los procesos escuchando (listen) en un puerto y -t se refiere a TCP.

La autenticación por ssh mediante usuario y contraseña es un mecanismo susceptible a ataques de diccionario de fuerza bruta. Es más conveniente utilizar ''2-factor authentication'' tales como claves SSH pública y privada.

Para activar autenticación mediante ''2-factor authentication'' tengo que generar el par de claves público y privado:

ssh-key

tienes que establecer una contraseña para proteger la clave privada.

Una vez creadas, tengo que instalar la clave pública en el servidor:

ssh-copy-id usuario@192.168.122.133

A partir de este momento puedes acceder por SSH mediante 2-factor authentication basado en clave pública SSH.

ssh usuario@192.168.122.133

que te solicita la contraseña que protege tu clave pública.

= Ejercicios =

# Cree un fichero vacio llamado 123.txt
# Añada al fichero las siguientes tres lineas:

Hola mundo
Probando 1 2 3
Adios

# Añada una linea más al fichero con el siguiente contenido:

Prueba

# Renombre el fichero 123.txt a 456.txt
# Haga una copia del fichero 456.txt al fichero 789.txt
# Cree la carpeta xyz
# Mueva el fichero 789.txt a la carpeta xyz
# Mueva el fichero 456.txt al temporal
# Borre el fichero 456.txt
# Compruebe si el fichero 789.txt contiene la palabra “mundo”
# Borre la carpeta xyz y su contenido
# Liste el contenido de la carpeta temporal mostrando los permisos asociados a los ficheros y carpetas, almacene el resultado en el fichero temporal.txt
# Cree la carpeta ‘x’ y dentro de ella, la carpeta ‘y’
# Mueva el fichero temporal.txt dentro de la carpeta ‘y’
# Cuente el número de ficheros y directorios en la carpeta tmp
# Muestre el espacio disponible en el raíz del sistema
# Para el fichero temporal.txt, establezca permisos de sólo lectura para el propietario
# Lance 'gedit' desde un terminal, obtenga el PID de dicho proceso y acabe con su ejecución

Administración básica

2025-12-16T17:25:14Z

Pneira: /* touch */

Para realizar esta práctica utilizaremos una de las máquinas virtuales que generamos mediante libvirt.

En esta práctica aprenderemos a utilizar el interprete de ordenes (también conocido como ''[https://www.traficantes.net/sites/default/files/pdfs/En%20el%20principio%20fue...-TdS.pdf línea de comandos]'') y a aprender nociones básicas de administración de sistemas Linux.

= Paso 0: Breve introducción al sistema Linux =

== Estructura básica del sistema de archivos ==

En un sistema Linux, todas las carpetas y ficheros en el sistema de fichero pende de la carpeta raíz que se representa con la /.

/
├── bin
├── usr
│ ├── local
│ ├── bin
│ └── ...
├── dev
│ ├── sda
│ ├── sda1
│ └── ...
├── home
│ ├── practica
│ │ ├── tema1.pdf
│ │ ├── boletin1.pdf
│ │ └── ...
│ ├── profesor
│ └── ...
└── etc
├── firefox
├── libvirt
├── ...
└── ...

Como puedes observar, el sistema de fichero emplea una estructura de árbol.

== Nociones básicas ==

·Aplicaciones con nombres compuestos: usar guion entre palabras

·Nombres con espacios en blanco: Escribir entre comillas dobles

·Espacios en blanco para separar ordenes (ej: instalar varios paquetes )

·Formato general de una orden: comando [-opciones] [argumentos]

·'''IMPORTANTE''': Diferencia entre mayúsculas y minúsculas

== Carpetas . y .. ==

Toda carpeta en un sistema Linux dispone de dos pseudocarpetas, la '''.''' y la '''..'':

* La pseudocarpeta '''..''' hace referencia a la carpeta padre que contiene a esta carpeta.
* La pseudocarpeta '''.''' hace referencia a la carpeta actual, es por tanto una autoreferencia.

En el caso de la carpeta raíz, la pseudocarpeta '''.''' y '''..''' hacen referencia a la propia carpeta raíz, se trata, por tanto de una excepción.

== Directorio de trabajo actual y la orden cd ==

Cada interprete de ordenes dispone de una ''carpeta de trabajo actual'' ('''c'''urrent '''w''orking '''d''irectory, en inglés). La carpeta de trabajo actual se puede modificar con la orden '''cd''' ('''c'''hange '''d'''irectory, en inglés).

Por ejemplo:

<syntaxhighlight lang="bash">
$ cd ..
</syntaxhighlight>

Nos situaría en la carpeta padre, empleando una ruta relativa.

Si volvemos a escribir desde /home " cd .. " nos lleva a '''/$'''

Para situarnos en el raíz, podemos emplear una ruta absoluta:

<syntaxhighlight lang="bash">
$ cd /
</syntaxhighlight>

En caso de que queramos volver a la carpeta de usuario, bastaría con invocar a '''cd''' sin más o ''' cd ~ '''

<syntaxhighlight lang="bash">
$ cd
</syntaxhighlight>

'''MUY IMPORTANTE''': No es lo mismo cd.. que ''' cd .. ''', es necesario el espacio después del cd.

== Rutas absolutas, rutas relativas ==

Para hacer referencia a un fichero o una carpeta se usan ruta absolutas o rutas relativas.

Las rutas absolutas siempre empieza por /, de manera que toman como punto de referencia la carpeta raíz (/). Por ejemplo, una ruta absoluta a la carpeta '''prueba''' que está almacenada en la carpeta del usuario '''ubuntu''' es '/home/ubuntu/prueba/'.

Las ruta relativa toma como referencia la carpeta de trabajo actual. Para averiguar la carpeta de trabajo actual disponemos de la orden '''pwd'''.

<syntaxhighlight lang="bash">
$ pwd
/home/ubuntu
</syntaxhighlight>

En base a la carpeta de trabajo actual, empleando la pseudocarpeta '''..''', se puede construir rutas relativas. Por ejemplo, para referenciar un fichero '''fichero.txt''' en la carpeta temporal, podemos emplear la ruta relativa '''../../tmp/fichero.txt'''.

Aunque probablemente sea más cómodo emplear una ruta absoluta en este caso, que sería '''/tmp/fichero.txt'''.

== Intérprete de órdenes ==

El intérprete de órdenes es un lanzador de aplicaciones textual que emplea el teclado como dispositivo de entrada de datos. Mediante el teclado, se escribe el nombre del programa que se quiere lanzar y al pulsa la tecla ''intro'' el intérprete de ordenes ejecutara dicho programa. Por defecto, el intérprete de ordenes que emplea Ubuntu por defecto es '''bash'''.

== man: ver la página de manual de una orden ==

La orden '''man''' te será útil para ver las páginas de manual.

Su estructura básica es:

<syntaxhighlight lang="bash">
man <comando>
</syntaxhighlight>

Aunque también se utiliza con la opción ''' -a ''' de All, que también muestra las entradas comenzadas por '''.''':

<syntaxhighlight lang="bash">
man -a <comando>
</syntaxhighlight>

Este programa toma como entrada el nombre de la orden de la que quieres consultar su página de manual, por ejemplo:

<syntaxhighlight lang="bash">
man ls
</syntaxhighlight>

Nos da información del manual de la orden '''ls'''.

Para salir de la página de manual, pulsa la tecla '''q''' (la primera letra de la palabra '''quit''', en inglés).

quit = salir

Normalmente, los programas ofrecen opciones de ayuda, como '''--help'''.

<syntaxhighlight lang="bash">
man --help
</syntaxhighlight>

También se puede emplear la versión compacta a la hora de especificar opciones.

<syntaxhighlight lang="bash">
man -h
</syntaxhighlight>

En general, todas las ordenes suelen ofrecer una opción de ayuda.

= Paso 1: Operaciones básicas con el sistema de ficheros =

== ls ==

Lista los ficheros y carpetas. Si no se especifica nada, muestra los ficheros y carpetas que contiene la carpeta de trabajo actual.

<syntaxhighlight lang="bash">
ls
</syntaxhighlight>

Si se especifica una ruta, muestra las carpetas y ficheros contenidos en dicha ruta, por ejemplo:

<syntaxhighlight lang="bash">
$ ls /
bin boot data dev etc home initrd.img initrd.img.old lib lib64 lost+found media mnt opt proc root run sbin snap srv sys tmp usr var vmlinuz vmlinuz.old
</syntaxhighlight>

Al emplear '''/''' como ruta absoluta, muestra el contenido de la carpeta raíz.

Las opciones más usadas de este programa suelen ser:

* -a: muestra los ficheros y carpetas ''ocultos''. En Linux, cualquier fichero o carpeta cuyo nombre empiece por . se considera ''oculto''. Esto incluye también en el listado las pseudocarpetas . y ..

* -l: se muestra en lista y aporta datos como la fecha de última modificación, propietario, grupo, tamaño en bytes y nombre:

<syntaxhighlight lang="bash">
$ ls -a

. .. .bash_history .bash_logout .bashrc .profile .ssh
</syntaxhighlight>

Ambas opciones se puede combinar:

<syntaxhighlight lang="bash">
$ ls -la /

total 92
drwxr-xr-x 24 root root 4096 Aug 28 09:50 .
drwxr-xr-x 24 root root 4096 Aug 28 09:50 ..
drwxr-xr-x 2 root root 4096 Aug 22 12:37 bin
drwxr-xr-x 4 root root 4096 Aug 22 12:37 boot
drwx------ 3 root root 4096 Aug 28 09:50 data
drwxr-xr-x 18 root root 3780 Aug 28 09:46 dev
[...]

</syntaxhighlight>

Otras opciones útiles son:

* -s : muestra el tamaño en bloques de cada archivo

* -t : aporta el día y la hora de modificación

* -R : lista también las subcarpetas

* --color : muestra el contenido coloreado

Los '''permisos''' se emplean en base a tres capacidades:

* Lectura, que se codifica con '''r''' (read, en inglés).
* Escritura, que se codifica con '''w''' (write, en inglés).
* Ejecutación, que se codifica con '''x''' (execute, en inglés).

La primera columna muestra los permisos que codifican:

* Tipo de entrada: '''d''' indica ''directorio'' (''carpeta'').
* Permisos del propietario, primera terna de rwx
* Permisos del grupo, segunda terna de rwx
* Permisos para el resto del mundo, tercera terna de rwx.

A continuación, aparecen el propietario y el grupo, seguidos de la fecha de última modificación y el nombre del fichero o carpeta.

La ayuda ( help ) en ls solo funciona con ''' ls --help ''' no con ls -h

== mkdir ==

Crea un nuevo directorio.

<syntaxhighlight lang="bash">
$ mkdir test
</syntaxhighlight>

Crea una carpeta test en el directorio actual.

Comprobemos que se ha creado bien:

<syntaxhighlight lang="bash">
$ ls
test
</syntaxhighlight>

Con la opción '''-p''', permite crear sucesivas carpetas anidadas de una sola vez, por ejemplo:

<syntaxhighlight lang="bash">
$ mkdir -p a/b/c
</syntaxhighlight>

Que crea la siguiente estructura de carpetas.

a
└── b
└── c

== touch (y dd) ==

Crea un nuevo fichero vacío (sin contenido) con el nombre que especifiquemos.

<syntaxhighlight lang="bash">
$ touch file.txt
</syntaxhighlight>

Comprobamos que el fichero se ha creado correctamente.

<syntaxhighlight lang="bash">
$ ls
file.txt
</syntaxhighlight>

NOTA: Hay otra herramienta que permite crear ficheros, como:

<syntaxhighlight lang="bash">
$ dd if=/dev/zero of=fichero bs=1M count=100
</syntaxhighlight>

para crear un fichero relleno de ceros de 100 Mbytes.

En realidad ''dd'' se puede usar para volcar datos de ficheros imágenes a unidades y viceversa, pero ese caso de uso no se explora en la asignatura.

== cp ==

Copia un fichero o directorio.

<syntaxhighlight lang="bash">
$ cp file.txt file_copy.txt
</syntaxhighlight>

Para copiar una carpeta y su contenido tenemos que usar la opción -r (recursivo).

<syntaxhighlight lang="bash">
$ cp -r test test_copy
</syntaxhighlight>

* Comprobamos el resultado con la orden '''ls'''.

* Si nos encontramos en la carpeta destino, la estructura sería la siguiente:

<syntaxhighlight lang="bash">
$ cp <nombre ruta origen> <nombre archivo>
</syntaxhighlight>

== mv ==

Mueve fichero o directorio.

Por ejemplo, para mover un directorio ''carpeta1'' a otro lugar

<syntaxhighlight lang="bash">
mv carpeta1 /tmp
</syntaxhighlight>

NOTA: si el destino es una carpeta y existe, mueve el origen dentro de la carpeta de destino.

También se puede usar para renombrar:

<syntaxhighlight lang="bash">
mv carpeta1 carpeta2
</syntaxhighlight>

En este caso, renombra ''carpeta1'' a ''carpeta2''.

También se puede usar con fichero, para renombrar:

<syntaxhighlight lang="bash">
mv test_copy test_copy2
</syntaxhighlight>

y también para mover:

<syntaxhighlight lang="bash">
mv test_copy2 /tmp
</syntaxhighlight>

== rm ==

* Borra un fichero o carpeta vacía:
<syntaxhighlight lang="bash">
rm fichero.txt
</syntaxhighlight>

* Para borrar una carpeta no vacía y su contenido:
<syntaxhighlight lang="bash">
rm -r carpeta123
</syntaxhighlight>

* Para borrar todo el contenido de la carpeta actual

<syntaxhighlight lang="bash">
rm -r *
</syntaxhighlight>

* EJERCICIOS:

# Crear la siguiente estructura dentro del directorio /tmp (usar los comandos mkdir, touch y cp):

/tmp
├── carpeta1
├── carpeta2
│ ├── fichero1.txt
│ └── fichero2.md
└── carpeta3
 ├── fichero1.txt
 └── fichero2.md

# Basándonos en el ejercicio anterior, cambiar la estructura a la siguiente (usar comandos mv y rm):

/tmp
└── carpeta
 ├── fichero1.txt
└── fichero2.md

= Paso 2: Impresión por pantalla y redirección de salida =

== echo ==

Sirve para imprimir una línea de texto por pantalla o variables de entorno. Además, nos permite escribir en ficheros.

<syntaxhighlight lang="bash">
echo "hola mundo"
</syntaxhighlight>

* Opciones:
-n elimina salto de línea

Una variable de entorno es una variable editada con algún valor, por defecto existen algunas creadas, como por ejemplo la variable HOME, que contiene el directorio del usuario:

<syntaxhighlight lang="bash">
echo $HOME
</syntaxhighlight>

Aprovecharemos y crearemos una variable nosotros:

<syntaxhighlight lang="bash">
ME="my name"
</syntaxhighlight>

Comprobamos:

<syntaxhighlight lang="bash">
echo $ME
</syntaxhighlight>

== Redirección de salida ==

> y >> sirve para redirigir una salida. Por ejemplo, utilizando el comando echo,
podemos enviar un texto dentro de un fichero:

<syntaxhighlight lang="bash">
echo "Esto es una prueba" > file.txt
</syntaxhighlight>

La diferencia entre > y >> es que > sobrescribe lo que haya en el fichero y
añade el contenido, y >> no sobrescribe, solo añade el nuevo contenido.

Hagamos la prueba:

<syntaxhighlight lang="bash">
echo "Esto es una prueba" > file.txt
echo "Esto es una prueba2" > file.txt
echo "Esto es una prueba" >> file2.txt
echo "Esto es una prueba2" >> file2.txt
</syntaxhighlight>

En cualquier caso, si el fichero no existe, se crea.

= Paso 3: Manejo de ficheros y carpetas avanzado =

== cat ==

* Muestra el contenido de un fichero:

<syntaxhighlight lang="bash">
cat fichero.txt
</syntaxhighlight>

* Crea un fichero:

<syntaxhighlight lang="bash">
cat > otrofichero.txt
</syntaxhighlight>

Para guardar el contenido, pulsa CTRL + D para indicar "final de fichero".

* Añadir más lineas al fichero:

<syntaxhighlight lang="bash">
cat >> otrofichero.txt
</syntaxhighlight>

* Concatenar ficheros

<syntaxhighlight lang="bash">
cat fichero1.txt fichero2.txt
</syntaxhighlight>

* Concatenar ficheros y guardar en otro fichero

<syntaxhighlight lang="bash">
cat fichero1.txt fichero2.txt > fichero3.txt
</syntaxhighlight>

== less ==

Sirve para ver el contenido de un fichero, permite navegar arriba y abajo.

Se sale pulsando la tecla ''q''.

<syntaxhighlight lang="bash">
less fichero.txt
</syntaxhighlight>

Útil cuando el fichero tiene contenido mayor a lo que se puede mostrar en pantalla.

== grep ==

Sirve para localizar coincidencias de un cierto patrón en ficheros y muestra la coincidencia, en caso de encontrarla, por pantalla.

<syntaxhighlight lang="bash">
grep <opción> <patrón> <archivos donde buscar>
</syntaxhighlight>
Por ejemplo, para buscar el patrón ''prueba'' en el fichero ''fichero.txt''.

<syntaxhighlight lang="bash">
$ grep -n prueba fichero.txt
1:Esto es una prueba
</syntaxhighlight>

* Principales opciones del comando:

-c : Escribe el número de líneas encontradas.

-i : No distingue entre mayúsculas y minúsculas.

-l : Muestra los nombres de los ficheros que contienen los caracteres buscados.

-n : Cada línea es precedida por su número en el fichero.

-s : No se muestran los mensajes que indican que no se puede abrir un fichero.

-v : Muestra sólo las líneas que no cumplen la condición.

== wc ==

Sirve para contar el número de palabras, caracteres, líneas o bytes que contiene un fichero.

Las opciones más utilizadas son:

* -l: muestra el número de líneas que contiene el fichero.
* -w: muestra el número de palabras.
* -m: muestra el número de caracteres
* -c: muestra el número de bytes

Probemos y contemos todo en el fichero file2.txt:

<syntaxhighlight lang="bash">
wc -l file2.txt
wc -w file2.txt
wc -m file2.txt
wc -c file2.txt
</syntaxhighlight>

Podemos contar más de un fichero a la vez:

<syntaxhighlight lang="bash">
wc -l file.txt file2.txt
</syntaxhighlight>

Nos mostrará el conteo de cada fichero y el total.

== sort ==

Ordenar las líneas de un fichero de manera alfanumérica

<syntaxhighlight lang="bash">
sort file.txt
</syntaxhighlight>

== find ==

Para buscar ficheros podemos usar la orden ''find''.

Por ejemplo, para buscar el fichero ''python3'' en todo el árbol de directorio (desde el raíz) podemos usar la orden:

<syntaxhighlight lang="bash">
find / -name python3
</syntaxhighlight>

Podemos restringir la búsqueda a ficheros con ''-type f''

<syntaxhighlight lang="bash">
find / -type f -name python3
</syntaxhighlight>

o para directorios con ''-type d''

Se puede usar también para buscar directorios.

Por ejemplo, para buscar todos los directorios contenidos en x123:

<syntaxhighlight lang="bash">
find / -type d -name x123
</syntaxhighlight>

Además, se puede combinar con ''-exec'' para ejecutar otra orden usando cada una de las coincidencias.

Por ejemplo, para hacer un ''ls -l'' para cada fichero terminado en ''.txt'' en el directorio actual:

<syntaxhighlight lang="bash">
find . -type f -name *.txt -exec ls -l {} \;
</syntaxhighlight>

En este caso ''{}'' es un ''placeholder'', es decir, se reemplaza por cada coincidencia que ''find'' encuentra cuando se invoca a la orden que se ha especificado por medio de ''-exec''.

NOTA: ''-exec'' necesita \; como terminador.

Puede también buscar cambios recientes en una carpeta, por ejemplo, los ficheros modificados hace 60 minutos:

<syntaxhighlight lang="bash">
find . -type f -amin -60
</syntaxhighlight>

== Tubería (|) ==

En Linux, está la entrada y salida estándar:

* La salida estándar es la pantalla, la salida estándar se usa para mostrar los resultados.
* La entrada estándar, que sirve para obtener datos, se trata del teclado.

NOTA: Además, está la salida estándar de errores, que también es la pantalla, pero que tiene prioridad sobre lo mostrado en la salida estándar.

En general, las órdenes que empleamos:

* Usan la salida estándar para mostrar el resultado de su ejecución.
* Usan la entrada estándar para leer datos, siempre que el usuario no haya especificado un fichero.

Por ejemplo, al hacer:

<syntaxhighlight lang="bash">
grep "prueba"
</syntaxhighlight>

la orden ''grep'' espera a que el usuario introduzca los datos por teclado para encontrar una coincidencia del patrón ''prueba''.

Este comportamiento es útil para el mecanismo de tuberías que describimos a continuación.

Una tubería nos servirá para conectar la salida estándar de un comando en la entrada estándar de otro.

<syntaxhighlight lang="bash">
cat file2.txt | grep prueba
grep -nr prueba file2.txt | wc -l
</syntaxhighlight>

En este ejemplo, cat muestra el contenido de file2.txt por la y esta salida se la
pasamos al comando grep, el cual busca las líneas que contengan prueba.

En el segundo, buscamos todas las líneas que contengan la palabra prueba, y esta
salida se la pasamos al comando wc, el cual cuenta las líneas de la salida del
comando grep.

== Redirecciones ==

Vamos a ver unos conceptos antes de seguir:

* Entrada estándar: representa los datos que necesita una aplicación para funcionar, como por ejemplo un archivo de datos o información ingresada desde la terminal y es representado en la terminal como el tipo 0.
* Salida estándar: es la vía que utilizan las aplicaciones para mostrarte información, allí podemos ver el progreso o simplemente los mensajes que la aplicación quiera darte en determinado momento y es representado en la terminal como el tipo 1.
* Error estándar: es la forma en que los programas te informan sobre los problemas que pueden encontrarse al momento de la ejecución y es representado en la terminal como el tipo 2.

Las redirecciones nos sirven para mover la información de un tipo a otro.

Ya vimos previamente el uso de > y >>, y también el |, veamos algunas más:

* comando < fichero: Toma la entrada de fichero
* comando 2> fichero: Envía la salida de error de comando a fichero
* comando 2>&1: Envía la salida de error a la salida estándar
* comando &> fichero: Envía la salida estándar y de error a fichero; equivale a comando > fichero 2>&1

== curl ==

Puede usar la utilidad ''curl'' para descargar ficheros.

<syntaxhighlight lang="bash">
curl https://ash-speed.hetzner.com/100MB.bin -o 100MB.bin
</syntaxhighlight>

También se puede usar la orden ''wget''.

== tar ==

Para comprimir una carpeta:

<syntaxhighlight lang="bash">
tar cvzf fichero.tar.gz carpeta1
</syntaxhighlight>

Para descomprimirla:

<syntaxhighlight lang="bash">
tar xvf fichero.tar.gz
</syntaxhighlight>

== file ==

Sirve para comprobar el tipo de fichero:

<syntaxhighlight lang="bash">
file f1.txt
</syntaxhighlight>

que muestra:

<syntaxhighlight lang="bash">
f1.txt: ASCII file
</syntaxhighlight>

cuando es un fichero de texto.

<syntaxhighlight lang="bash">
file fichero.tar.gz
</syntaxhighlight>

que muestra:

<syntaxhighlight lang="bash">
fichero.tar.gz: gzip compressed data, from Unix, original size modulo 2^32 20480
</syntaxhighlight>

En general, sirve para saber de qué tipo de fichero se trata.

= Paso 4: Usuarios y grupos =

== whoami ==

Sirve para obtener el usuario actual.

<syntaxhighlight lang="bash">
whoami
</syntaxhighlight>

Lo más seguro es que nos aparezca ubuntu.

== who ==

Es para saber quien está ahora mismo en la máquina conectado.

<syntaxhighlight lang="bash">
who
</syntaxhighlight>

Seguramente solo estemos nosotros:

<syntaxhighlight lang="bash">
root pts/0 2019-08-28 13:51 (192.168.122.1)
</syntaxhighlight>

''pts/0'' es el terminal desde el que está el usuario ''root''.

== su y sudo ==

su (substitute user): sirve para cambiar de usuario. Por ejemplo:

<syntaxhighlight lang="bash">
su root
</syntaxhighlight>

Aquí nos pedirá la contraseña del usuario al que queramos cambiar.

sudo (super user do): no todas las distribuciones lo integran, porque es menos
seguro que su, este comando nos permite ejecutar un comando siendo otro usuario,
por defecto, si no le damos usuario, lo hará con el usuario root. Si sudo nos
pide contraseña, nos pide la contraseña del usuario, ya que el usuario es que el
tiene permisos para usar sudo o no.

<syntaxhighlight lang="bash">
sudo ls -a /root
</syntaxhighlight>

Si tuviéramos por ejemplo un usuario 'practica' y quisíeramos ejecutar un
comando en su nombre:

<syntaxhighlight lang="bash">
sudo -u practica ls
</syntaxhighlight>

Como root puedo añadir usuarios para que puedan hacer sudo así:

<syntaxhighlight lang="bash">
adduser usuario sudo
</syntaxhighlight>

Esto hace que el usuario ''usuario'' pueda hacer sudo

== adduser ==

Para añadir un usuario ''practica'':

<syntaxhighlight lang="bash">
sudo adduser practica
</syntaxhighlight>

== passwd ==

Sirve para modificar la contraseña de un usuario, por ejemplo, vamos a modificar
la contraseña del usuario que hemos creado previamente:

<syntaxhighlight lang="bash">
sudo passwd practica
</syntaxhighlight>

Nos preguntará dos veces la contraseña, y ya la tendremos actualizadas. Vamos
ahora a probar ahora el comando su para cambiar de usuario:

<syntaxhighlight lang="bash">
su practica
whoami
</syntaxhighlight>

Veremos que hemos cambiado de usuario, para cerrar este usuario, escribimos
'exit' o pulsamos 'CTLR + D'

== deluser y userdel ==

Ambos sirven para borrar un usuario, similar a adduser y useradd, userdel es el
comando y deluser el script.

Vamos a borrar el usuario que hemos creado, incluyendo el borrado de su /home
(opción -r):

<syntaxhighlight lang="bash">
userdel -r practica
</syntaxhighlight>

Comprobemos que ya no tenemos usuario ni /home:

<syntaxhighlight lang="bash">
ls /home
sudo -u practica whoami
</syntaxhighlight>

== addgroup y groupadd ==

Ambos sirven para crear un grupo. Los grupos sirven para agrupar a los usuarios
y que estos tengan unos mismos permisos. Por ejemplo, cuando instalamos algunas
herramientas como por ejemplo docker, este crea el grupo docker automáticamente
para que fácilmente podamos añadir a un usuario al grupo, y este tenga los
permisos para trabajar con dicha herramienta.

Vamos a crear un nuevo grupo, vamos a llamarle invitado:

<syntaxhighlight lang="bash">
sudo groupadd invitado
</syntaxhighlight>

== usermod y groups ==

usermod es utilizado para asignar un grupo a un usuario.

groups es utilizado para ver los grupos a los que pertenece un usuario.

Vamos a añadir a un usuario practica, lo vamos a añadir al grupo invitado y
veremos los grupos a los que pertenece:

<syntaxhighlight lang="bash">
sudo useradd -m practica
sudo usermod -G invitado practica
groups practica
</syntaxhighlight>

Veremos que el usuario práctica pertenece al grupo invitado.

== delgroup y groupdel ==

Ambos sirven para eliminar un grupo. Vamos a eliminar el grupo que hemos creado
anteriormente:

<syntaxhighlight lang="bash">
sudo groupdel invitado
</syntaxhighlight>

Podemos observar ahora que el usuario practica no pertenece al grupo invitado:

<syntaxhighlight lang="bash">
groups practica
</syntaxhighlight>

= Paso 5: Permisos =

== Nomenclatura rwx y numérica ==

Si hacemos un ls -l, la primera cadena que nos aparece son los permisos del
fichero (-rwxrw-r--), podemos dividirlo en 4 elementos:

- (rwx) (rw-) (r--)
| | | |
type owner group others

* type: el tipo de fichero, pudiendo ser d (directorio), l (enlace simbólico), - (fichero normal)
* owner: permisos de propietario
* group: permisos de grupo
* others: permisos para los demás usuarios

Significado de los permisos:

* r: permisos de lectura
* w: permisos de escritura
* x: permisos de ejecución

Por último, existe un modo abreviado para estos permisos que se utiliza con
números.

rwx
001 en binario es 1 en decimal. Permisos de ejecución
010 en binario es 2 en decimal. Permisos de escritura
100 en binario es 4 en decimal. Permisos de lectura

La suma de los permisos, nos da el valor numérico. Veamos un ejemplo:
rwx rw- r--
110 110 100
6 6 4

'''Ojo''': ¡No emplee nunca los permisos 777 (rwxrwxrwx) cuando tenga problemas con los permisos!

== chmod ==

Permite cambiar los permisos de acceso a un fichero o directorio. Podemos dar
permisos de dos formas diferentes.

=== modo carácter ===

Veamos primero unos detalles:

Clases de usuario:

* owner (u)
* group (g)
* others (o)
* all (a)

Modificador:

* añadir (+)
* eliminar (-)
* sobrescribir (=)

Para dar permisos tendríamos que seleccionar la clase de usuario el modificador
y los permisos, veamos un ejemplo:

<syntaxhighlight lang="bash">
chmod u+x file # añadimos permisos de ejecución al usuario
chmod go-w file # quitamos permisos de escritura al grupo y a otros usuarios
chmod u=rwx,go=r file # Al usuario le damos todos los permisos, y al grupo y otros solo le damos permisos de lectura
</syntaxhighlight>

=== Modo octal ===

Con el modo octacl, es como si siempre utilizáramos el modificar sobrescribir,
pongamos algunos ejemplos:

<syntaxhighlight lang="bash">
chmod 644 file # Al usuario le damos permiso de lectura y escritura al usuario, y al grupo y otros solo le damos permisos de lectura
chmod 600 file # solo el propietario tiene permisos de lectura y escritura
</syntaxhighlight>

=== Ejemplos ===

Vamos a ver como funciona el tema de permisos con unos ejemplos. Vamos a crear
un fichero pruebas y le vamos a quitar los permisos de escritura a nuestro
usuario, y le vamos a dar permisos de escritura a otros:

<syntaxhighlight lang="bash">
touch pruebas
ls -l pruebas # de esta forma veremos que por defecto los permisos son rw-rw-r--
chmod u-w,o+w pruebas
ls -l pruebas # ahora los permisos deberían ser -w-rw-rw-
</syntaxhighlight>

Una vez dado los permisos, veamos que con nuestro usuario podemos leer pero no
escribir:

<syntaxhighlight lang="bash">
cat pruebas
echo "probando" > pruebas
exit
</syntaxhighlight>

Y ahora vamos a ver que el usuario pruebas, puede leer y escribir:

<syntaxhighlight lang="bash">
su practica
cat pruebas
echo "probando" > pruebas
</syntaxhighlight>

== chown ==

Permite cambiar el propietario de un fichero o directorio.

Vamos por ejemplo a pasarle ahora el fichero pruebas al usuario practica:

<syntaxhighlight lang="bash">
sudo chown practica pruebas
ls -l pruebas
</syntaxhighlight>

Veremos que el usuario actual ahora es pruebas, aunque vemos que el ls muestra
lo siguiente:

<syntaxhighlight lang="bash">
-r--rw-rw- 1 practica ubuntu 9 Aug 29 09:34 pruebas
</syntaxhighlight>

Hay que comentar un detalle, y es que los ficheros y directorios tienen asignado
un usuario y un grupo, por defecto se utiliza el mismo usuario como grupo
cuando creamos un nuevo fichero o directorio. Si queremos que cuando cambiemos
el propietario, cambiar tambien el grupo del fichero, podemos hacerlo de la
siguiente forma:

<syntaxhighlight lang="bash">
sudo chown practica:practica pruebas
</syntaxhighlight>

Una vez hecho esto, vamos ahora a probar que los permisos siguen funcionando
como antes, ahora con el usuario ubuntu, deberíamos de poder leer y escribir en
el fichero pruebas, y con el usuario practica, solo leer, esto es así por que
ahora el propitario es practica:

<syntaxhighlight lang="bash">
# Pruebas usuario ubuntu
cat pruebas
echo test >> pruebas
# Pruebas usuario practica
su practica
cat pruebas
echo "probando" > pruebas
exit
</syntaxhighlight>

= Paso 6: Procesos =

== ps ==

Sirve para ver que procesos están ejecutándose en el sistema, veamos un ejemplo:

<syntaxhighlight lang="bash">
ps aux # con la opción aux mostraremos todos los procesos del sistema
</syntaxhighlight>

Cada línea es un proceso, y cada proceso muestra su PID, usuario, cantidad de
memoria y cpu utilizada, comando y otros detalles.

<syntaxhighlight lang="bash">
man kill & # añadir el & al final de un comando hace que este se ejecute en segundo plano, por lo que se quedará abierto
</syntaxhighlight>

La salida de este comando nos mostrará el PID que tiene ese proceso que acabamos
de ejecutar, vamos a comprobarlo:

<syntaxhighlight lang="bash">
ps aux | grep "man kill"
</syntaxhighlight>

Veremos que el PID coincide.

== kill ==

Este comando nos servirá para matar un proceso. kill se utiliza seguido de una
señal para enviar al proceso seguido de uno o varios PID. para ver las señales
disponibles, podemos listarlas:

<syntaxhighlight lang="bash">
kill -l
</syntaxhighlight>

Las más utilizadas suele ser SIGTERM y SIGKILL, la primera intenta terminar el
proceso de forma poco abrupta, y la segunda suele utilizarse cuando el proceso
no atiende a esta primera señal. Vamos ahora a terminar el proceso que creamos
antes, si no recordamos el PID, busquémoslo de nuevo:

<syntaxhighlight lang="bash">
ps aux | grep "man kill"
</syntaxhighlight>

Enviamos señal para terminar el proceso y comprobamos que ha terminado:

<syntaxhighlight lang="bash">
kill -SIGTERM 8470
ps aux | grep "man kill"
</syntaxhighlight>

También podemos notar que en el listado de señales, hay unos números, podemos
utilizar esos números en vez de las palabras, por ejemplo:

<syntaxhighlight lang="bash">
man kill &
kill -15 PID_COMANDO_PREVIO
</syntaxhighlight>

Comprobamos que el proceso ha terminado correctamente:

<syntaxhighlight lang="bash">
ps aux | grep "man kill"
</syntaxhighlight>

= Paso 7: Estado CPU, RAM y Disco =

== top ==

Este comando nos servirá para ver el listado de procesos y el estado de la CPU y
memoria.

Probemos el comando y observemos detalladamente la salida:

<syntaxhighlight lang="bash">
top
</syntaxhighlight>

Para salir, pulsamos q.

== df y du ==

df (disk free) y du (disk usage). Ambas son utilidades para mostrar el uso de
los discos.

Con df mostraremos la información del espacio en cada dispositivo montado:

<syntaxhighlight lang="bash">
df
</syntaxhighlight>

Estos comandos que nos muestran el tamaño de los ficheros, casi siempre tienen
una opción para mostrarlo en un formato más legible (-h)

<syntaxhighlight lang="bash">
df -h
</syntaxhighlight>

Mucho mejor.

Ahora veamos el comando du, el cual nos mostrará el tamaño de un fichero o
directorio y sus subdirectorios, no olvidemos el -h:

<syntaxhighlight lang="bash">
du -h /home/ubuntu
du -h /home/ubuntu/pruebas
</syntaxhighlight>

Si solo quisíeramos saber el total de una carpeta y nos nos interesan sus
subcarpetas, podemos utilizar la opción -s:

<syntaxhighlight lang="bash">
du -sh /home/ubuntu
</syntaxhighlight>

== free ==

Sirve para ver el estado de la memoria, como siempre, opción -h:

<syntaxhighlight lang="bash">
free -h
</syntaxhighlight>

== lsblk ==

Nos muestra la información de todos los dispositivos de bloques (discos duros,
pendrivers, CD_ROM, SSD, ...).

<syntaxhighlight lang="bash">
lsblk
</syntaxhighlight>

En la siguiente práctica se utilizará más a fondo este comando, ya que
trabajaremos con dispositivos.

= Paso 8: Gestión de paquetes de software y repositorios =

Los sistemas Linux incluyen, además de las herramientas básicas del sistema operativo, repositorios de software que puede ser opcionalmente instalados por el administrador del sistema. Los fabricantes de las distribuciones de Linux incluyen paquetes de software listos para ser instalados que se integran con el sistema.

Un paquete incluye el software necesario para que una cierta aplicación funcione correctamente, así como sus paquetes de dependencia.

En Ubuntu, la herramienta de gestión de paquetes de software y repositorios se llama '''apt'''.

=== Listado de repositorios de paquetes de software ===

En Ubuntu el listado de repositorios se encuentra en el fichero /etc/apt/sources.list. Podemos comprobar que repositorios tenemos añadido:

<syntaxhighlight lang="bash">
cat /etc/apt/sources.list
</syntaxhighlight>

=== Actualización del listado de paquetes de software ===

Para actualizar el listado de paquetes utilizaremos el comando:

<syntaxhighlight lang="bash">
sudo apt update
</syntaxhighlight>

=== Instalación un nuevo paquete ===

Para instalar un nuevo paquete, utilizaremos la orden install, por ejemplo, vamos a instalar tree, similar al ls pero muestra el arbol de directorios:

<syntaxhighlight lang="bash">
sudo apt install tree
</syntaxhighlight>

=== Desinstalación de un paquete ===

Usaremos la orden purge o la orden remove, purge nos lo eliminad todo, y remove mantiene la configuración en el caso de que el paquete la tuviese. Vamos a eliminar el paquete instalado previamente:

<syntaxhighlight lang="bash">
sudo apt purge tree
</syntaxhighlight>

= Paso 9: Administración remota con ssh =

''ssh'' (Secure SHell) permite administrar de manera remota un sistema desde el intérprete de órdenes. Para poder acceder a la máquina virtual por medio de ''[[ssh]]'', hay que instalar el paquete ''openssh-server''.

sudo apt-get install openssh-server

Una vez instalado, tenemos que consultar la dirección IP de la máquina virtual

ip address

Desde el hipervisor podemos acceder por ''ssh'' a la máquina virtual con la orden:

ssh usuario@ip

Siendo ''usuario'' el nombre de usuario con el que accedes a la máquina virtual y la dirección ''ip'' que nos muestra la orden ''ip address''.

Por ejemplo, si el usuario seleccionado es ''ubuntu'' y la IP es 192.168.122.123, entonces la invocación a ''ssh'' es la siguiente:

ssh ubuntu@192.168.122.123

En caso de que en la maquina virtual no esté instalado openssh-server, puede que la conexión sea rechazada:
ssh: connect to host 192.168.122.123 port 22: Connection refused

Para resolver el problema es necesario instalar OpenSSH client en la maquina virtual

sudo apt install openssh-client

Y a continuación se instala OpenSSH server

sudo apt install openssh-server

En la imagen de Ubuntu Cloud el servicio de ssh viene instalado por defecto, sin embargo no está activo. Para activarlo hay que crear las claves SSH del servidor:

# ssh-keygen -A

además, hay que editar el fichero /etc/sshd/sshd_config para establecer:

PasswordAuthentication yes

pues está por defecto a ''no''.

y luego lanzar el servicio:

# systemctl enable ssh
# systemctl start ssh

La orden ''enable'' hace que el servicio se lance la próxima vez que arranque el sistema. La orden lanza el servicio inmediatamente.

Puedes comprobar que el servicio está lanzado con:

# ss -lt

donde -l muestra los procesos escuchando (listen) en un puerto y -t se refiere a TCP.

La autenticación por ssh mediante usuario y contraseña es un mecanismo susceptible a ataques de diccionario de fuerza bruta. Es más conveniente utilizar ''2-factor authentication'' tales como claves SSH pública y privada.

Para activar autenticación mediante ''2-factor authentication'' tengo que generar el par de claves público y privado:

ssh-key

tienes que establecer una contraseña para proteger la clave privada.

Una vez creadas, tengo que instalar la clave pública en el servidor:

ssh-copy-id usuario@192.168.122.133

A partir de este momento puedes acceder por SSH mediante 2-factor authentication basado en clave pública SSH.

ssh usuario@192.168.122.133

que te solicita la contraseña que protege tu clave pública.

= Ejercicios =

# Cree un fichero vacio llamado 123.txt
# Añada al fichero las siguientes tres lineas:

Hola mundo
Probando 1 2 3
Adios

# Añada una linea más al fichero con el siguiente contenido:

Prueba

# Renombre el fichero 123.txt a 456.txt
# Haga una copia del fichero 456.txt al fichero 789.txt
# Cree la carpeta xyz
# Mueva el fichero 789.txt a la carpeta xyz
# Mueva el fichero 456.txt al temporal
# Borre el fichero 456.txt
# Compruebe si el fichero 789.txt contiene la palabra “mundo”
# Borre la carpeta xyz y su contenido
# Liste el contenido de la carpeta temporal mostrando los permisos asociados a los ficheros y carpetas, almacene el resultado en el fichero temporal.txt
# Cree la carpeta ‘x’ y dentro de ella, la carpeta ‘y’
# Mueva el fichero temporal.txt dentro de la carpeta ‘y’
# Cuente el número de ficheros y directorios en la carpeta tmp
# Muestre el espacio disponible en el raíz del sistema
# Para el fichero temporal.txt, establezca permisos de sólo lectura para el propietario
# Lance 'gedit' desde un terminal, obtenga el PID de dicho proceso y acabe con su ejecución

Contenedores

2025-12-16T13:37:31Z

Pneira: /* Paso 11: Crear nuestra propia imagen de contenedor */

En esta práctica aprenderemos a utilizar [https://es.wikipedia.org/wiki/Podman podman] para desplegar contenedores.

= Paso 1: Instalar podman =

Para instalar el paquete oficial:

<syntaxhighlight lang="bash">
apt install podman
</syntaxhighlight>

podman es un clon de '''docker''.

Si añade un usuario 'test' a su sistema con:

<syntaxhighlight lang="bash">
adduser test
</syntaxhighlight>

recuerde hacer:

<syntaxhighlight lang="bash">
loginctl enable-linger test
systemctl start --user dbus
</syntaxhighlight>

para evitar un warning que se muestra al ejecutar '''podman''' como usuario.

= Paso 2: Repositorio de imágenes de contenedores DockerHub =

Docker ofrece un servicio de nube denominado ''DockerHub'' que puede ser empleado como red social para compartir tus imágenes de Podman. En ''DockerHub'' existen además imágenes de contenedores preconfiguradas de software, muchas de ellas oficiales (ofrecidas por el propio fabricante del software) que se podrán emplear como base para construir nuevas imágenes adaptadas a nuestras necesidades.

Podremos realizar búsquedas en este repositorio ''DockerHub'' puedes emplear el siguiente comando:

<syntaxhighlight lang="bash">
podman search docker.io/library/hello-world
</syntaxhighlight>

Para descargarnos la imagen de ''hello-world'' podemos usar la orden ''pull'':

<syntaxhighlight lang="bash">
podman pull docker.io/library/hello-world
</syntaxhighlight>

También podemos publicar imágenes propias, esto require '''registro de usuario''' en la nube de ''DockerHub'', lo que '''no''' es obligatorio para la realización de esta práctica. Para subir una imagen, hay que validarse como usuario en la nube de ''DockerHub'':

<syntaxhighlight lang="bash">
podman login docker.io
</syntaxhighlight>

Tras introducir tu usuario y contraseña, puedes comenzar a publicar tus propias imágenes.

<syntaxhighlight lang="bash">
podman push docker.io/USUARIO/MI_IMAGEN
</syntaxhighlight>

Este paso es '''opcional''', sólo en caso de que se quieran subir imágenes de contenedores a la nube de docker.io.

= Paso 4: Comprobar imágenes en nuestra máquina =

Para ver las imágenes que tenemos en nuestra máquina, utilizaremos el comando:

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Inicialmente, no tenemos imágenes en almacenamiento, podemos descargarnos la imagen oficial de Debian 13 (Trixie):

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian
</syntaxhighlight>

Ahora si, ya debería de aparecernos la imagen ''debian''.

Comentar también que cada imagen puede tener varias etiquetas, por ejemplo, la imagen Debian 12 (Bookworm), cuando la hemos visto en el listado de imágenes, venía con el tag latest, que es el tag que se descarga por defecto, pero nosotros podemos especificar otro, por ejemplo:

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian:bookworm
</syntaxhighlight>

Para traernos la versión de la imagen de Debian 12 ''Bookworm''.

Ahora tendremos dos imágenes con diferente etiqueta, que serían como las diferentes versiones de cada imagen.

= Paso 5: Lanzar un contenedor =

Un contenedor no es más que una imagen de podman ejecutándose, sería similar a
una máquina virtual, aunque mucho más liviano.

Para crear un contenedor, utilizaremos una imagen, en este caso, la imagen
hello-world. Hacemos lo siguiente:

<syntaxhighlight lang="bash">
podman run hello-world
</syntaxhighlight>

Esto nos mostrará el siguiente mensaje si todo está correcto:

<syntaxhighlight lang="bash">
Hello from Docker!
This message shows that your installation appears to be working correctly.

To generate this message, Docker took the following steps:
1. The Docker client contacted the Docker daemon.
2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
(amd64)
3. The Docker daemon created a new container from that image which runs the
executable that produces the output you are currently reading.
4. The Docker daemon streamed that output to the Docker client, which sent it
to your terminal.

To try something more ambitious, you can run an Debian container with:
$ podman run -it debian bash

Share images, automate workflows, and more with a free Docker ID:
https://hub.docker.com/

For more examples and ideas, visit:
https://docs.docker.com/get-started/
</syntaxhighlight>

Al crear los contenedores utilizando el comando 'run', tenemos varias opciones:

* Lanzar una terminal en el contenedor en modo interactivo
* Lanzar en segundo plano y conectarnos posteriormente al contenedor

== Paso 5.1: Lanzar una terminal en el contenedor en modo interactivo (-ti) ==

Para este ejemplo vamos a utilizar otra imagen diferente, en este caso vamos a utilizar una imagen de debian.

Vamos a lanzar un contenedor y ejecutar una terminal en el que se va a ejecutar el programa '''bash''' que me ofrece un interprete de órdenes:

<syntaxhighlight lang="bash">
podman run -ti debian bash
</syntaxhighlight>

La opción ''-t'' indica que se crea un terminal en el contenedor. Y la opción ''-i'' indica que el contenedor se ejecuta en modo interactivo.

Al acceder al contenedor de ''debian'' nos aparece un ''hash'' en el prompt de la shell, que identifica a la instancia del contenedor (es valor es similar al que muestra la orden ''podman container ls'').

Para salir del contenedor, escribimos 'exit' o pulsamos ''CTRL + D''

== Paso 5.2 Lanzar en segundo plano (-d) ==

Otro ejemplo, con la imagen de Debian:

<syntaxhighlight lang="bash">
podman run -dti debian
</syntaxhighlight>

que muestra un hash que identifica de forma única el contenedor lanzado:

<syntaxhighlight lang="bash">
2ec1daae4676a4e84dc04fd91399c1dfe92119544ff12ee307991fe573d3db64
</syntaxhighlight>

Mediante el comando ''attach'' puedo entrar al contenedor:

<syntaxhighlight lang="bash">
podman attach 2ec1daae4676
</syntaxhighlight>

Para salir, pulsamos ''CTRL + P'' seguido de ''CTRL + Q''.

De manera similar, puedo lanzar en segundo plano la imagen de contenedor de ''hello-world'':

<syntaxhighlight lang="bash">
podman run -d hello-world
</syntaxhighlight>

Y consultar los logs:

<syntaxhighlight lang="bash">
podman logs b67fae3312bc321
</syntaxhighlight>

== Paso 5.3: Añadir variables de entorno a un contenedor ==

Utilizaremos la imagen anterior, y vamos a añadir una variable de entorno
llamada TEST que contenga el valor 'test'. A parte, también ejecutaremos la
terminal como antes, para comprobar con el comando echo, que la variable de
entorno está creada correctamente:

<syntaxhighlight lang="bash">
podman run -ti -e TEST=test debian bash
</syntaxhighlight>

Ahora, desde el contenedor podemos comprobar el valor de la variable de entorno ''$TEST''.

<syntaxhighlight lang="bash">
echo $TEST
test
</syntaxhighlight>

= Paso 6: Listar contenedores en ejecución =

Hemos estado haciendo pruebas y ejecutando contenedores en el paso anterior, vamos a ver donde se encuentran estos contenedores que hemos ejecutado, y después veremos algunas opciones más del comando run.

Tenemos dos opciones para ver los contenedores:

<syntaxhighlight lang="bash">
podman container ls -a
</syntaxhighlight>

o la versión corta:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Ambas hacen lo mismo, y debería de mostrarnos una salida similar a la siguiente:

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
e2bde5f5500c debian "bash" 6 minutes ago Exited (0) 2 seconds ago pensive_sammet
544ad27dbc3c debian "bash" 7 minutes ago Exited (0) 7 minutes ago serene_elgamal
</syntaxhighlight>

En la información veremos que el contenedor tiene el estado exited, eso quiere decir que no se está ejecutando y ya ha finalizado. Vamos a hacer una prueba para ver un contendor ejecutándose:

<syntaxhighlight lang="bash">
podman run -d debian sleep 30
</syntaxhighlight>

Con el comando sleep 30 esperamos 30 segundos hasta que termine el comando, asíque durante esos 30 segundos, el contenedor estará ejecutándose, veámoslo:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
eacceb27d52d debian "sleep 30" 12 seconds ago Up 11 seconds sharp_pasteur
</syntaxhighlight>

Vamos a ver alguna opciones más de la orden ''run''.

== Paso 6.1: Dar un nombre al contenedor (--name) ==

Por defecto, podman creará automáticamente un nombre como hemos visto en las salidas del comando ''podman ps -a''. Podemos establecer el nombre del contenedor que queramos con la opción ''--name'':

<syntaxhighlight lang="bash">
podman run -ti --name mi_debian debian
</syntaxhighlight>

== Paso 6.2: Eliminar contenedor cuando termine (--rm) ==

Vamos a mezclar todo lo visto anteriormente:

* Lanzar en segundo plano (-d)
* Ejecutar contenedor durante 30 segundos (sleep 30)
* Dar un nombre a la imagen (--name)
* Eliminar contenedor cuando termine (--rm)

<syntaxhighlight lang="bash">
podman run -d --rm --name bye-bye debian sleep 30
</syntaxhighlight>

Antes y una vez pasados los 30 segundos, podemos comprobar que el contenedor ha desaparecido.

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

= Paso 7: Parar y eliminar contenedores =

Para parar contenedores podemos usar el ID o su nombre:

<syntaxhighlight lang="bash">
podman stop my_container
podman stop e4901956f108
podman ps -a
</syntaxhighlight>

Una vez hemos comprobado que han terminado su ejecución, podemos eliminar los ficheros resultantes de su ejecución:

<syntaxhighlight lang="bash">
podman container rm my_container
</syntaxhighlight>

Para borrar todos los contenedores ya finalizados

<syntaxhighlight lang="bash">
podman container prune
</syntaxhighlight>

= Paso 8: Conectarnos a un contenedor que se está ejecutando en segundo plano =

Vamos a ejecutar de nuevo un contenedor que no termine:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a conectarnos a este contenedor que está ejecutándose en segundo
plano:

<syntaxhighlight lang="bash">
podman attach mi-contenedor
</syntaxhighlight>

Veremos la orden bash ejecutándose, para terminar, hacemos un 'CTRL + C', y ahora, veremos que ha pasado con el contenedor:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Lo veremos parado, por que lo que hemos hecho ha sido conectarnos al contenedor
y parar el comando que se estaba ejecutando, así que ahora tenemos el contenedor
finalizado.

''Nota:'' Para salir del contenedor '''sin detenerlo''' hacemos 'CTRL + P' seguido 'CTRL + Q'

= Paso 9: Ejecutar un comando dentro de un contenedor en ejecución =

Vamos a ver otresta vez como ejecutar un comando en un contenedor que ya está
ejecutándose:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a ejecutar un comando en ese contenedor con el nombre ''mi-contenedor''.
El comando exec es similar al comando run, pero para ejecutar un comando dentro de un contenedor:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor ls
</syntaxhighlight>

Para redirigir la salida a un fichero en el anfitrión:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor ls > x.txt
</syntaxhighlight>

Para redirigir la salida a un fichero ''dentro'' del contenedor, hacemos:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor sh -c "ls > x.txt"
</syntaxhighlight>

También es posible ejecutar comandos con tuberías:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor sh -c "ls -la | grep ^d"
</syntaxhighlight>

= Paso 10: Persistencia en contenedores =

Al hacer ''exit'' y salir de un contenedor, se pierden todos los cambios que hemos realizado. Los

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-ejemplo debian bash
</syntaxhighlight>

Ahora, vamos a crear una carpeta en el contenedor y comprobar que esa carpeta existe:

<syntaxhighlight lang="bash">
podman exec mi-ejemplo mkdir test
podman exec mi-ejemplo ls
</syntaxhighlight>

Veremos que la carpeta existe, pero, ¿qué ocurre si para el contenedor?

<syntaxhighlight lang="bash">
podman container stop mi-ejemplo
</syntaxhighlight>

Y volvemos a lanzarlo:

<syntaxhighlight lang="bash">
podman container rm mi-ejemplo
podman run -d -ti --name mi-ejemplo debian bash
podman exec mi-ejemplo ls
</syntaxhighlight>

Podemos comprobar que la carpeta creada anteriormente, no existe.

¿Qué podemos hacer para mantener la modificaciones realizadas sobre un contenedor?

== Paso 10.1: Crear una imagen derivada de la imagen base ==

Es posible crear una imagen derivada, con modificaciones, a partir de una imagen existente mediante la orden '''commit'''.

Por ejemplo, si queremos una imagen ''debian'' que incluya el programa ''ping'' ya instalado, tendríamos que lanzar un contenedor a partir de la imagen ''ubuntu'':

<syntaxhighlight lang="bash">
podman run -d -ti debian bash
</syntaxhighlight>

Suponiendo que el contenido está identificado con el ID 56ef5b312334

Instalamos el paquete ping:

<syntaxhighlight lang="bash">
podman exec 56ef5b312334 apt -y install ping
</syntaxhighlight>

Generamos la imagen derivada con el nombre ''ubuntu-con-ping'':

<syntaxhighlight lang="bash">
podman commit 56ef5b312334 ubuntu-con-ping
</syntaxhighlight>

Ya podemos para nuestro contendor:

<syntaxhighlight lang="bash">
podman stop 56ef5b312334
</syntaxhighlight>

Y lanzar un nuevo contenedor a partir de la imagen ''debian-con-ping'':

<syntaxhighlight lang="bash">
podman run -d -ti debian-con-ping bash
</syntaxhighlight>

== Paso 10.2: Mantener la persistencia mediante volúmen ==

Otra opción para mantener los datos es montar un volumen al ejecutar el contenedor.

Primero crearemos una carpeta que hará de volumen en nuestra máquina, que será la que luego montemos para podman:

<syntaxhighlight lang="bash">
mkdir /home/debian/volumen
</syntaxhighlight>

Ahora vamos a montar la carpeta al ejecutar el contenedor, lo hacemos con la
opción -v, la cual tiene 3 campos separados por ':':

# El volumen en nuestra máquina
# Donde se montará el volumen dentro del contenedor
# Opciones de mmontaje, por ejemplo rw (read and write) o ro (read only)

<syntaxhighlight lang="bash">
podman run --rm -ti -v /home/debian/volumen:/volumen:rw debian bash
mkdir /volumen/test
touch /volumen/test/file
exit
</syntaxhighlight>

Una vez nos salgamos del contenedor, podemos ver que en nuestra máquina están
los datos:

<syntaxhighlight lang="bash">
ls /home/ubuntu/volumen/
ls /home/ubuntu/volumen/test
</syntaxhighlight>

La próxima vez que ejecutemos un contenedor, si montamos ese volumen, los datos
estarán ahí, además esta forma tiene el beneficio de compartir datos entre
nuestra máquina y el contenedor de forma sencilla.

= Paso 11: Crear nuestra propia imagen de contenedor =

Para crear una imagen de un contenedor con una aplicación de Python hug, creamos en primer lugar la carpeta que contendrá los ficheros que nos permiten crear la imagen.

<syntaxhighlight lang="bash">
mkdir miapp
cd miapp
</syntaxhighlight>

Definimos un fichero ''Dockerfile'' para definir la imagen:

<syntaxhighlight lang="bash">
FROM debian

RUN apt -y update
RUN apt -y upgrade
RUN apt -y install python3-hug
RUN mkdir /app
COPY endpoint.py /app
WORKDIR /app
CMD hug -f endpoint.py
</syntaxhighlight>

Alternativamente, puedes crear un [[Creando imagen propia usando Ubuntu de base|Dockerfile empleando la imagen de Ubuntu]] como base en lugar de Alpine.

Y añadimos el fichero ''endpoint.py'' que emplea el framework Python hug con el contenido siguiente:

<syntaxhighlight lang="bash">
import hug

@hug.get('/welcome')
def welcome(username="unknown"):
""" Say welcome to username """
return "Welcome " + username
</syntaxhighlight>

Este fichero es un ejemplo de uso de Python hug. Si hacemos una petición a /welcome?username="LSO", esto nos devolverá el mensaje "Welcome LSO".

Una vez tengamos los dos ficheros creados en nuestra máquina virtual, podemos construir nuestra imagen:

<syntaxhighlight lang="bash">
podman build -t app:v1 -f Dockerfile
</syntaxhighlight>

Vamos a explicar para que sirve cada línea:

* FROM: servirá para basarnos en una imagen existente, en este caso, una imagen de python alpine, que contiene python y no ocupa mucho espacio
* ENV: para crear variables de entorno
* RUN: para ejecutar comandos, ya sea para crear una carpeta, instalar dependencias o cualquier otra opción que necesitemos
* COPY: para copiar datos desde nuestra máquina a la imagen
* WORKDIR: para cambiar el directorio de trabajo (lo crea si no existe)
* CMD: este comando será ejecutado por defecto al iniciar un contenedor a partir de esta imagen

Esto construirá una imagen podman basada en python:alpine, en la cual hemos
guardado nuestra pequeña aplicación y se va a ejecutar cuando ejecutemos un
contenedor basado en esa imagen. Para comprobar que la imagen se ha creado
correctamente, listamos las imagenes, y debería de aparecernos una imagen con
nombre 'app' y tag 'v1':

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen, y vamos a añadir una nueva
opción, -p 8001:8000. Esta opción hará que el puerto interno 8000 del contenedor
sea expuesto en el puerto 8001 de nuestra máquina:

<syntaxhighlight lang="bash">
podman run --name my-app --rm -d -p 8001:8000 app:v1
</syntaxhighlight>

''Nota:'' podman supone que la redirección de puerto es TCP, para una redirección de puertos UDP, puedes usar:

<syntaxhighlight lang="bash">
... -p 8001:8000/udp
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código. En nuestra
máquina haremos:

<syntaxhighlight lang="bash">
curl -X GET http://localhost:8001/welcome?username=LSO
</syntaxhighlight>

Comprobaremos que la salida del comando curl, es "Welcome LSO".

Antes de terminar, vamos a comprobar otro pequeño detalle que añadimos en
nuestra imagen, la variable de entorno USERNAME, vamos a comprobar que funciona:

<syntaxhighlight lang="bash">
podman exec -ti my-app ash
echo $USERNAME
</syntaxhighlight>

Funciona correctamente, pero al ejecutar el contenedor, podemos cambiar esta
variable de entorno como vimos en uno de los pasos anteriores:

<syntaxhighlight lang="bash">
podman run --rm -ti -e USERNAME=me app:v1 ash
echo $USERNAME
</syntaxhighlight>

Esto nos servirá para tener opciones por defecto y que el usuario pueda
cambiarlo a su antojo, como por ejemplo contraseñas u otros detalles.

= Paso 12: Eliminar imágenes =

Para borrar una imagen, puede hacer:

<syntaxhighlight lang="bash">
podman image rm hello-world
</syntaxhighlight>

= Paso 13: Ejercicios =

== Ejercicio 1: Image derivada de Debian con el programa sl ==

Lance un contenedor a partir de una imagen de Debian, instale el programa sl, ejecute sl (desde fuera del contenedor) y detenga el contenedor.

== Ejercicio 2 ==

== Ejercicio 3: Variante de httpd ==

Construya una imagen ''httpd-hola-mundo'' a partir de la imagen ''httpd''. El fichero de index.html de la carpeta htdocs/ tiene que mostrar el mensaje "hola mundo".

<syntaxhighlight lang="bash">
podman pull httpd
</syntaxhighlight>

Edita el fichero Dockerfile:

<syntaxhighlight lang="bash">
nano Dockerfile
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
FROM httpd

COPY index.html htdocs/index.html
</syntaxhighlight>

Edita el fichero index.html:

<syntaxhighlight lang="bash">
nano index.html
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

Construye la imagen:

<syntaxhighlight lang="bash">
podman build -t mihttpd -f Dockerfile
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen:

<syntaxhighlight lang="bash">
podman run --name mihttpd -d -p 8080:80 mihttpd
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código:
<syntaxhighlight lang="bash">
curl -X GET http://localhost:8080
</syntaxhighlight>

Tiene que salir por pantalla esto:
<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

== Ejercicio 4: aplicación flask ==

Flask es un framework python para implementar webs. Cree una imagen "miapp-flask" a partir de la imagen de "python":

* Instale flask mediante: pip install flask
* Cree la carpeta "app"
* Establezca la variable FLASK_APP a "hello.py"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"

El fichero hello.py contiene un "hola mundo" para Flask:

<syntaxhighlight lang="python">
from flask import Flask
app = Flask(__name__)

@app.route("/")
def hello():
return "Hello World!"

if __name__ == "__main__":
app.run()
</syntaxhighlight>

Solución con alpine:

<syntaxhighlight lang="bash">
FROM python:alpine

RUN mkdir /app
RUN pip install flask
ENV FLASK_APP="app/hello.py"
COPY hello.py
WORKDIR /
CMD flask run --host=0.0.0.0
</syntaxhighlight>

Solución con Ubuntu:

<syntaxhighlight lang="bash">
FROM ubuntu:bionic

RUN apt-get update
RUN apt-get -y install python python-pip wget
RUN pip install Flask
ENV FLASK_APP="app/hello.py"
RUN mkdir /app
COPY hello.py /app
CMD flask run --host=0.0.0.0
</syntaxhighlight>

== Ejercicio 5: mysql ==

'''EN LA MÁQUINA VIRTUAL:'''

mkdir miapp
cd miapp
podman pull mysql
nano Dockerfile

<syntaxhighlight lang="bash">
FROM mysql
ENV MYSQL_ROOT_PASSWORD="lacontraseñaqueyoquiera"
RUN mkdir /app
WORKDIR /app

</syntaxhighlight>

CTRL+O , ENTER Y CTRL+X (para guardar Dockerfile y salir)

podman build -ti mrfdocker -f Dockerfile
podman run --name mymrf --rm -p 8001:3306 mrfdocker
docker images

'''EN LA TERMINAL DEL HOST:'''

''Instalación de mysql:''

apt install mysql-client-core-5.7
apt-get install mysql-server
service mysql start

''Para entrar:''

mysql -u root -p -P 8001

Una vez dentro de msql:

mysql> show databases;

''Para salir:''

exit

== Ejercicio 6: python pyramid ==

Pyramid es un framework python para implementar webs. Cree una imagen "miapp-pyramid":

* Emplee la imagen de debian como referencia, instale los paquetes python3 y python3-pyramid.
* Cree la carpeta "app"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"
* La aplicación se lanza con la orden: python3 hello.py
* Compruebe que funciona con curl, la ruta a la web es http://127.0.0.1:8000/hello, suponiendo que ha empleado el puerto 8000 para exponer el servicio.

El fichero hello.py contiene un "hola mundo" para Pyramid:

<syntaxhighlight lang="bash">
from wsgiref.simple_server import make_server
from pyramid.config import Configurator
from pyramid.response import Response

def hello_world(request):
print('Request inbound!')
return Response('Podman works with Pyramid!')

if __name__ == '__main__':
config = Configurator()
config.add_route('hello', '/')
config.add_view(hello_world, route_name='hello')
app = config.make_wsgi_app()
server = make_server('0.0.0.0', 6543, app)
server.serve_forever()
</syntaxhighlight>

Este programa recibe peticiones en el puerto 6543.

== Ejercicio 7 ==

Cree una imagen derivada de Ubuntu, instale el paquete apache2, php y libapache2-mod-php.
Active el módulo de php para apache2 mediante la orden:

<syntaxhighlight lang="bash">
a2enmod php
</syntaxhighlight>

Cree la carpeta /var/www/php.

Cree el fichero index.php

<syntaxhighlight lang="php">
<?php
Print "Hello, World!";
?>
</syntaxhighlight>

y copielo a /var/www/php/.

Cree el fichero 000-default.conf y copielo a /etc/apache2/sites-enabled/

Dicho fichero contiene.

<syntaxhighlight lang="bash">
<VirtualHost *:80>
DocumentRoot /var/www/php

<Directory /var/www/php/>
Options Indexes FollowSymLinks MultiViews
AllowOverride All
Order deny,allow
Allow from all
</Directory>

ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>
</syntaxhighlight>

Tiene que lanzar apache con la orden: apachectl -D FOREGROUND

Tras crear la imagen, láncela mapeando el puerto 8888 al 80, pruebe que puede acceder a http://127.0.0.1:8888/php/ mediante curl

Solución:

<syntaxhighlight lang="bash">
FROM ubuntu:latest

RUN apt-get update
RUN apt-get install -y tzdata
RUN apt-get install -y apache2
RUN apt-get install -y php
RUN apt-get install -y libapache2-mod-php
RUN a2enmod php7.2
COPY index.php /var/www/php
COPY 000-default.conf /etc/apache2/sites-enabled/
CMD apachectl -D FOREGROUND
</syntaxhighlight>

Y para lanzarlo:

podman run --name my-app --rm -d -p 8001:8000 app:v1

y para probarlo:

curl -X GET http://127.0.0.1:8888/php/

== Ejercicio 8 ==

Instale el paquete ''netcat-traditional'' en una imagen de contenedor de ''ubuntu''. Lance la orden:

nc -u -l -p 8080

en el contenedor. Asegúrese de crear una redirección de puertos de 9999 desde el ''host'' al puerto 8080 en el contenedor.

Desde fuera del contenedor, pruebe a conectarse con:

nc -u 127.0.0.1 9999

== Ejercicio 9 ==

Cree una imagen derivada de "ubuntu" con un Dockerfile que incluya soporte de python y lance el siguiente código en Python:

<syntaxhighlight lang="python">
from http.server import BaseHTTPRequestHandler, HTTPServer
import time

hostName = "0.0.0.0"
serverPort = 8080

class MyServer(BaseHTTPRequestHandler):
def do_GET(self):
self.send_response(200)
self.send_header("Content-type", "text/html")
self.end_headers()
self.wfile.write(bytes("<html><head><title>Welcome!</title></head>", "utf-8"))
self.wfile.write(bytes("<body>", "utf-8"))
self.wfile.write(bytes("This is an example web server.", "utf-8"))
self.wfile.write(bytes("</body></html>", "utf-8"))

if __name__ == "__main__":
webServer = HTTPServer((hostName, serverPort), MyServer)
print("Server started http://%s:%s" % (hostName, serverPort))

try:
webServer.serve_forever()
except KeyboardInterrupt:
pass

webServer.server_close()
print("Server stopped.")
</syntaxhighlight>

Llame a su imagen "python-http-server". Lance una instancia de la imagen "python-http-server" mapeando el puerto 9999 al puerto 8888/tcp del contenedor. Compruebe con:

<syntaxhighlight lang="bash">
curl http://127.0.0.1:9999/
</syntaxhighlight>

que muestre la página HTML que ofrece el servidor, que debería ser:

<syntaxhighlight lang="bash">
<html><head><title>Welcome!</title></head><body>This is an example web server.</body></html>
</syntaxhighlight>

= Anexo =

* Cómo usar [[Podman compose]]

Contenedores

2025-12-16T13:29:06Z

Pneira:

En esta práctica aprenderemos a utilizar [https://es.wikipedia.org/wiki/Podman podman] para desplegar contenedores.

= Paso 1: Instalar podman =

Para instalar el paquete oficial:

<syntaxhighlight lang="bash">
apt install podman
</syntaxhighlight>

podman es un clon de '''docker''.

Si añade un usuario 'test' a su sistema con:

<syntaxhighlight lang="bash">
adduser test
</syntaxhighlight>

recuerde hacer:

<syntaxhighlight lang="bash">
loginctl enable-linger test
systemctl start --user dbus
</syntaxhighlight>

para evitar un warning que se muestra al ejecutar '''podman''' como usuario.

= Paso 2: Repositorio de imágenes de contenedores DockerHub =

Docker ofrece un servicio de nube denominado ''DockerHub'' que puede ser empleado como red social para compartir tus imágenes de Podman. En ''DockerHub'' existen además imágenes de contenedores preconfiguradas de software, muchas de ellas oficiales (ofrecidas por el propio fabricante del software) que se podrán emplear como base para construir nuevas imágenes adaptadas a nuestras necesidades.

Podremos realizar búsquedas en este repositorio ''DockerHub'' puedes emplear el siguiente comando:

<syntaxhighlight lang="bash">
podman search docker.io/library/hello-world
</syntaxhighlight>

Para descargarnos la imagen de ''hello-world'' podemos usar la orden ''pull'':

<syntaxhighlight lang="bash">
podman pull docker.io/library/hello-world
</syntaxhighlight>

También podemos publicar imágenes propias, esto require '''registro de usuario''' en la nube de ''DockerHub'', lo que '''no''' es obligatorio para la realización de esta práctica. Para subir una imagen, hay que validarse como usuario en la nube de ''DockerHub'':

<syntaxhighlight lang="bash">
podman login docker.io
</syntaxhighlight>

Tras introducir tu usuario y contraseña, puedes comenzar a publicar tus propias imágenes.

<syntaxhighlight lang="bash">
podman push docker.io/USUARIO/MI_IMAGEN
</syntaxhighlight>

Este paso es '''opcional''', sólo en caso de que se quieran subir imágenes de contenedores a la nube de docker.io.

= Paso 4: Comprobar imágenes en nuestra máquina =

Para ver las imágenes que tenemos en nuestra máquina, utilizaremos el comando:

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Inicialmente, no tenemos imágenes en almacenamiento, podemos descargarnos la imagen oficial de Debian 13 (Trixie):

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian
</syntaxhighlight>

Ahora si, ya debería de aparecernos la imagen ''debian''.

Comentar también que cada imagen puede tener varias etiquetas, por ejemplo, la imagen Debian 12 (Bookworm), cuando la hemos visto en el listado de imágenes, venía con el tag latest, que es el tag que se descarga por defecto, pero nosotros podemos especificar otro, por ejemplo:

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian:bookworm
</syntaxhighlight>

Para traernos la versión de la imagen de Debian 12 ''Bookworm''.

Ahora tendremos dos imágenes con diferente etiqueta, que serían como las diferentes versiones de cada imagen.

= Paso 5: Lanzar un contenedor =

Un contenedor no es más que una imagen de podman ejecutándose, sería similar a
una máquina virtual, aunque mucho más liviano.

Para crear un contenedor, utilizaremos una imagen, en este caso, la imagen
hello-world. Hacemos lo siguiente:

<syntaxhighlight lang="bash">
podman run hello-world
</syntaxhighlight>

Esto nos mostrará el siguiente mensaje si todo está correcto:

<syntaxhighlight lang="bash">
Hello from Docker!
This message shows that your installation appears to be working correctly.

To generate this message, Docker took the following steps:
1. The Docker client contacted the Docker daemon.
2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
(amd64)
3. The Docker daemon created a new container from that image which runs the
executable that produces the output you are currently reading.
4. The Docker daemon streamed that output to the Docker client, which sent it
to your terminal.

To try something more ambitious, you can run an Debian container with:
$ podman run -it debian bash

Share images, automate workflows, and more with a free Docker ID:
https://hub.docker.com/

For more examples and ideas, visit:
https://docs.docker.com/get-started/
</syntaxhighlight>

Al crear los contenedores utilizando el comando 'run', tenemos varias opciones:

* Lanzar una terminal en el contenedor en modo interactivo
* Lanzar en segundo plano y conectarnos posteriormente al contenedor

== Paso 5.1: Lanzar una terminal en el contenedor en modo interactivo (-ti) ==

Para este ejemplo vamos a utilizar otra imagen diferente, en este caso vamos a utilizar una imagen de debian.

Vamos a lanzar un contenedor y ejecutar una terminal en el que se va a ejecutar el programa '''bash''' que me ofrece un interprete de órdenes:

<syntaxhighlight lang="bash">
podman run -ti debian bash
</syntaxhighlight>

La opción ''-t'' indica que se crea un terminal en el contenedor. Y la opción ''-i'' indica que el contenedor se ejecuta en modo interactivo.

Al acceder al contenedor de ''debian'' nos aparece un ''hash'' en el prompt de la shell, que identifica a la instancia del contenedor (es valor es similar al que muestra la orden ''podman container ls'').

Para salir del contenedor, escribimos 'exit' o pulsamos ''CTRL + D''

== Paso 5.2 Lanzar en segundo plano (-d) ==

Otro ejemplo, con la imagen de Debian:

<syntaxhighlight lang="bash">
podman run -dti debian
</syntaxhighlight>

que muestra un hash que identifica de forma única el contenedor lanzado:

<syntaxhighlight lang="bash">
2ec1daae4676a4e84dc04fd91399c1dfe92119544ff12ee307991fe573d3db64
</syntaxhighlight>

Mediante el comando ''attach'' puedo entrar al contenedor:

<syntaxhighlight lang="bash">
podman attach 2ec1daae4676
</syntaxhighlight>

Para salir, pulsamos ''CTRL + P'' seguido de ''CTRL + Q''.

De manera similar, puedo lanzar en segundo plano la imagen de contenedor de ''hello-world'':

<syntaxhighlight lang="bash">
podman run -d hello-world
</syntaxhighlight>

Y consultar los logs:

<syntaxhighlight lang="bash">
podman logs b67fae3312bc321
</syntaxhighlight>

== Paso 5.3: Añadir variables de entorno a un contenedor ==

Utilizaremos la imagen anterior, y vamos a añadir una variable de entorno
llamada TEST que contenga el valor 'test'. A parte, también ejecutaremos la
terminal como antes, para comprobar con el comando echo, que la variable de
entorno está creada correctamente:

<syntaxhighlight lang="bash">
podman run -ti -e TEST=test debian bash
</syntaxhighlight>

Ahora, desde el contenedor podemos comprobar el valor de la variable de entorno ''$TEST''.

<syntaxhighlight lang="bash">
echo $TEST
test
</syntaxhighlight>

= Paso 6: Listar contenedores en ejecución =

Hemos estado haciendo pruebas y ejecutando contenedores en el paso anterior, vamos a ver donde se encuentran estos contenedores que hemos ejecutado, y después veremos algunas opciones más del comando run.

Tenemos dos opciones para ver los contenedores:

<syntaxhighlight lang="bash">
podman container ls -a
</syntaxhighlight>

o la versión corta:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Ambas hacen lo mismo, y debería de mostrarnos una salida similar a la siguiente:

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
e2bde5f5500c debian "bash" 6 minutes ago Exited (0) 2 seconds ago pensive_sammet
544ad27dbc3c debian "bash" 7 minutes ago Exited (0) 7 minutes ago serene_elgamal
</syntaxhighlight>

En la información veremos que el contenedor tiene el estado exited, eso quiere decir que no se está ejecutando y ya ha finalizado. Vamos a hacer una prueba para ver un contendor ejecutándose:

<syntaxhighlight lang="bash">
podman run -d debian sleep 30
</syntaxhighlight>

Con el comando sleep 30 esperamos 30 segundos hasta que termine el comando, asíque durante esos 30 segundos, el contenedor estará ejecutándose, veámoslo:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
eacceb27d52d debian "sleep 30" 12 seconds ago Up 11 seconds sharp_pasteur
</syntaxhighlight>

Vamos a ver alguna opciones más de la orden ''run''.

== Paso 6.1: Dar un nombre al contenedor (--name) ==

Por defecto, podman creará automáticamente un nombre como hemos visto en las salidas del comando ''podman ps -a''. Podemos establecer el nombre del contenedor que queramos con la opción ''--name'':

<syntaxhighlight lang="bash">
podman run -ti --name mi_debian debian
</syntaxhighlight>

== Paso 6.2: Eliminar contenedor cuando termine (--rm) ==

Vamos a mezclar todo lo visto anteriormente:

* Lanzar en segundo plano (-d)
* Ejecutar contenedor durante 30 segundos (sleep 30)
* Dar un nombre a la imagen (--name)
* Eliminar contenedor cuando termine (--rm)

<syntaxhighlight lang="bash">
podman run -d --rm --name bye-bye debian sleep 30
</syntaxhighlight>

Antes y una vez pasados los 30 segundos, podemos comprobar que el contenedor ha desaparecido.

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

= Paso 7: Parar y eliminar contenedores =

Para parar contenedores podemos usar el ID o su nombre:

<syntaxhighlight lang="bash">
podman stop my_container
podman stop e4901956f108
podman ps -a
</syntaxhighlight>

Una vez hemos comprobado que han terminado su ejecución, podemos eliminar los ficheros resultantes de su ejecución:

<syntaxhighlight lang="bash">
podman container rm my_container
</syntaxhighlight>

Para borrar todos los contenedores ya finalizados

<syntaxhighlight lang="bash">
podman container prune
</syntaxhighlight>

= Paso 8: Conectarnos a un contenedor que se está ejecutando en segundo plano =

Vamos a ejecutar de nuevo un contenedor que no termine:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a conectarnos a este contenedor que está ejecutándose en segundo
plano:

<syntaxhighlight lang="bash">
podman attach mi-contenedor
</syntaxhighlight>

Veremos la orden bash ejecutándose, para terminar, hacemos un 'CTRL + C', y ahora, veremos que ha pasado con el contenedor:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Lo veremos parado, por que lo que hemos hecho ha sido conectarnos al contenedor
y parar el comando que se estaba ejecutando, así que ahora tenemos el contenedor
finalizado.

''Nota:'' Para salir del contenedor '''sin detenerlo''' hacemos 'CTRL + P' seguido 'CTRL + Q'

= Paso 9: Ejecutar un comando dentro de un contenedor en ejecución =

Vamos a ver otresta vez como ejecutar un comando en un contenedor que ya está
ejecutándose:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a ejecutar un comando en ese contenedor con el nombre ''mi-contenedor''.
El comando exec es similar al comando run, pero para ejecutar un comando dentro de un contenedor:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor ls
</syntaxhighlight>

Para redirigir la salida a un fichero en el anfitrión:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor ls > x.txt
</syntaxhighlight>

Para redirigir la salida a un fichero ''dentro'' del contenedor, hacemos:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor sh -c "ls > x.txt"
</syntaxhighlight>

También es posible ejecutar comandos con tuberías:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor sh -c "ls -la | grep ^d"
</syntaxhighlight>

= Paso 10: Persistencia en contenedores =

Al hacer ''exit'' y salir de un contenedor, se pierden todos los cambios que hemos realizado. Los

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-ejemplo debian bash
</syntaxhighlight>

Ahora, vamos a crear una carpeta en el contenedor y comprobar que esa carpeta existe:

<syntaxhighlight lang="bash">
podman exec mi-ejemplo mkdir test
podman exec mi-ejemplo ls
</syntaxhighlight>

Veremos que la carpeta existe, pero, ¿qué ocurre si para el contenedor?

<syntaxhighlight lang="bash">
podman container stop mi-ejemplo
</syntaxhighlight>

Y volvemos a lanzarlo:

<syntaxhighlight lang="bash">
podman container rm mi-ejemplo
podman run -d -ti --name mi-ejemplo debian bash
podman exec mi-ejemplo ls
</syntaxhighlight>

Podemos comprobar que la carpeta creada anteriormente, no existe.

¿Qué podemos hacer para mantener la modificaciones realizadas sobre un contenedor?

== Paso 10.1: Crear una imagen derivada de la imagen base ==

Es posible crear una imagen derivada, con modificaciones, a partir de una imagen existente mediante la orden '''commit'''.

Por ejemplo, si queremos una imagen ''debian'' que incluya el programa ''ping'' ya instalado, tendríamos que lanzar un contenedor a partir de la imagen ''ubuntu'':

<syntaxhighlight lang="bash">
podman run -d -ti debian bash
</syntaxhighlight>

Suponiendo que el contenido está identificado con el ID 56ef5b312334

Instalamos el paquete ping:

<syntaxhighlight lang="bash">
podman exec 56ef5b312334 apt -y install ping
</syntaxhighlight>

Generamos la imagen derivada con el nombre ''ubuntu-con-ping'':

<syntaxhighlight lang="bash">
podman commit 56ef5b312334 ubuntu-con-ping
</syntaxhighlight>

Ya podemos para nuestro contendor:

<syntaxhighlight lang="bash">
podman stop 56ef5b312334
</syntaxhighlight>

Y lanzar un nuevo contenedor a partir de la imagen ''debian-con-ping'':

<syntaxhighlight lang="bash">
podman run -d -ti debian-con-ping bash
</syntaxhighlight>

== Paso 10.2: Mantener la persistencia mediante volúmen ==

Otra opción para mantener los datos es montar un volumen al ejecutar el contenedor.

Primero crearemos una carpeta que hará de volumen en nuestra máquina, que será la que luego montemos para podman:

<syntaxhighlight lang="bash">
mkdir /home/debian/volumen
</syntaxhighlight>

Ahora vamos a montar la carpeta al ejecutar el contenedor, lo hacemos con la
opción -v, la cual tiene 3 campos separados por ':':

# El volumen en nuestra máquina
# Donde se montará el volumen dentro del contenedor
# Opciones de mmontaje, por ejemplo rw (read and write) o ro (read only)

<syntaxhighlight lang="bash">
podman run --rm -ti -v /home/debian/volumen:/volumen:rw debian bash
mkdir /volumen/test
touch /volumen/test/file
exit
</syntaxhighlight>

Una vez nos salgamos del contenedor, podemos ver que en nuestra máquina están
los datos:

<syntaxhighlight lang="bash">
ls /home/ubuntu/volumen/
ls /home/ubuntu/volumen/test
</syntaxhighlight>

La próxima vez que ejecutemos un contenedor, si montamos ese volumen, los datos
estarán ahí, además esta forma tiene el beneficio de compartir datos entre
nuestra máquina y el contenedor de forma sencilla.

= Paso 11: Crear nuestra propia imagen de contenedor =

Para crear una imagen de un contenedor con una aplicación de Python hug, creamos en primer lugar la carpeta que contendrá los ficheros que nos permiten crear la imagen.

<syntaxhighlight lang="bash">
mkdir miapp
cd miapp
</syntaxhighlight>

Definimos un fichero ''Dockerfile'' para definir la imagen:

<syntaxhighlight lang="bash">
FROM ubuntu

RUN apt -y update
RUN apt -y upgrade
RUN apt -y install python3-hug
RUN mkdir /app
COPY endpoint.py /app
WORKDIR /app
CMD hug -f endpoint.py
</syntaxhighlight>

Alternativamente, puedes crear un [[Creando imagen propia usando Ubuntu de base|Dockerfile empleando la imagen de Ubuntu]] como base en lugar de Alpine.

Y añadimos el fichero ''endpoint.py'' que emplea el framework Python hug con el contenido siguiente:

<syntaxhighlight lang="bash">
import hug

@hug.get('/welcome')
def welcome(username="unknown"):
""" Say welcome to username """
return "Welcome " + username
</syntaxhighlight>

Este fichero es un ejemplo de uso de Python hug. Si hacemos una petición a /welcome?username="LSO", esto nos devolverá el mensaje "Welcome LSO".

Una vez tengamos los dos ficheros creados en nuestra máquina virtual, podemos construir nuestra imagen:

<syntaxhighlight lang="bash">
podman build -t app:v1 -f Dockerfile
</syntaxhighlight>

Vamos a explicar para que sirve cada línea:

* FROM: servirá para basarnos en una imagen existente, en este caso, una imagen de python alpine, que contiene python y no ocupa mucho espacio
* ENV: para crear variables de entorno
* RUN: para ejecutar comandos, ya sea para crear una carpeta, instalar dependencias o cualquier otra opción que necesitemos
* COPY: para copiar datos desde nuestra máquina a la imagen
* WORKDIR: para cambiar el directorio de trabajo (lo crea si no existe)
* CMD: este comando será ejecutado por defecto al iniciar un contenedor a partir de esta imagen

Esto construirá una imagen podman basada en python:alpine, en la cual hemos
guardado nuestra pequeña aplicación y se va a ejecutar cuando ejecutemos un
contenedor basado en esa imagen. Para comprobar que la imagen se ha creado
correctamente, listamos las imagenes, y debería de aparecernos una imagen con
nombre 'app' y tag 'v1':

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen, y vamos a añadir una nueva
opción, -p 8001:8000. Esta opción hará que el puerto interno 8000 del contenedor
sea expuesto en el puerto 8001 de nuestra máquina:

<syntaxhighlight lang="bash">
podman run --name my-app --rm -d -p 8001:8000 app:v1
</syntaxhighlight>

''Nota:'' podman supone que la redirección de puerto es TCP, para una redirección de puertos UDP, puedes usar:

<syntaxhighlight lang="bash">
... -p 8001:8000/udp
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código. En nuestra
máquina haremos:

<syntaxhighlight lang="bash">
curl -X GET http://localhost:8001/welcome?username=LSO
</syntaxhighlight>

Comprobaremos que la salida del comando curl, es "Welcome LSO".

Antes de terminar, vamos a comprobar otro pequeño detalle que añadimos en
nuestra imagen, la variable de entorno USERNAME, vamos a comprobar que funciona:

<syntaxhighlight lang="bash">
podman exec -ti my-app ash
echo $USERNAME
</syntaxhighlight>

Funciona correctamente, pero al ejecutar el contenedor, podemos cambiar esta
variable de entorno como vimos en uno de los pasos anteriores:

<syntaxhighlight lang="bash">
podman run --rm -ti -e USERNAME=me app:v1 ash
echo $USERNAME
</syntaxhighlight>

Esto nos servirá para tener opciones por defecto y que el usuario pueda
cambiarlo a su antojo, como por ejemplo contraseñas u otros detalles.

= Paso 12: Eliminar imágenes =

Para borrar una imagen, puede hacer:

<syntaxhighlight lang="bash">
podman image rm hello-world
</syntaxhighlight>

= Paso 13: Ejercicios =

== Ejercicio 1: Image derivada de Debian con el programa sl ==

Lance un contenedor a partir de una imagen de Debian, instale el programa sl, ejecute sl (desde fuera del contenedor) y detenga el contenedor.

== Ejercicio 2 ==

== Ejercicio 3: Variante de httpd ==

Construya una imagen ''httpd-hola-mundo'' a partir de la imagen ''httpd''. El fichero de index.html de la carpeta htdocs/ tiene que mostrar el mensaje "hola mundo".

<syntaxhighlight lang="bash">
podman pull httpd
</syntaxhighlight>

Edita el fichero Dockerfile:

<syntaxhighlight lang="bash">
nano Dockerfile
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
FROM httpd

COPY index.html htdocs/index.html
</syntaxhighlight>

Edita el fichero index.html:

<syntaxhighlight lang="bash">
nano index.html
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

Construye la imagen:

<syntaxhighlight lang="bash">
podman build -t mihttpd -f Dockerfile
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen:

<syntaxhighlight lang="bash">
podman run --name mihttpd -d -p 8080:80 mihttpd
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código:
<syntaxhighlight lang="bash">
curl -X GET http://localhost:8080
</syntaxhighlight>

Tiene que salir por pantalla esto:
<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

== Ejercicio 4: aplicación flask ==

Flask es un framework python para implementar webs. Cree una imagen "miapp-flask" a partir de la imagen de "python":

* Instale flask mediante: pip install flask
* Cree la carpeta "app"
* Establezca la variable FLASK_APP a "hello.py"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"

El fichero hello.py contiene un "hola mundo" para Flask:

<syntaxhighlight lang="python">
from flask import Flask
app = Flask(__name__)

@app.route("/")
def hello():
return "Hello World!"

if __name__ == "__main__":
app.run()
</syntaxhighlight>

Solución con alpine:

<syntaxhighlight lang="bash">
FROM python:alpine

RUN mkdir /app
RUN pip install flask
ENV FLASK_APP="app/hello.py"
COPY hello.py
WORKDIR /
CMD flask run --host=0.0.0.0
</syntaxhighlight>

Solución con Ubuntu:

<syntaxhighlight lang="bash">
FROM ubuntu:bionic

RUN apt-get update
RUN apt-get -y install python python-pip wget
RUN pip install Flask
ENV FLASK_APP="app/hello.py"
RUN mkdir /app
COPY hello.py /app
CMD flask run --host=0.0.0.0
</syntaxhighlight>

== Ejercicio 5: mysql ==

'''EN LA MÁQUINA VIRTUAL:'''

mkdir miapp
cd miapp
podman pull mysql
nano Dockerfile

<syntaxhighlight lang="bash">
FROM mysql
ENV MYSQL_ROOT_PASSWORD="lacontraseñaqueyoquiera"
RUN mkdir /app
WORKDIR /app

</syntaxhighlight>

CTRL+O , ENTER Y CTRL+X (para guardar Dockerfile y salir)

podman build -ti mrfdocker -f Dockerfile
podman run --name mymrf --rm -p 8001:3306 mrfdocker
docker images

'''EN LA TERMINAL DEL HOST:'''

''Instalación de mysql:''

apt install mysql-client-core-5.7
apt-get install mysql-server
service mysql start

''Para entrar:''

mysql -u root -p -P 8001

Una vez dentro de msql:

mysql> show databases;

''Para salir:''

exit

== Ejercicio 6: python pyramid ==

Pyramid es un framework python para implementar webs. Cree una imagen "miapp-pyramid":

* Emplee la imagen de debian como referencia, instale los paquetes python3 y python3-pyramid.
* Cree la carpeta "app"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"
* La aplicación se lanza con la orden: python3 hello.py
* Compruebe que funciona con curl, la ruta a la web es http://127.0.0.1:8000/hello, suponiendo que ha empleado el puerto 8000 para exponer el servicio.

El fichero hello.py contiene un "hola mundo" para Pyramid:

<syntaxhighlight lang="bash">
from wsgiref.simple_server import make_server
from pyramid.config import Configurator
from pyramid.response import Response

def hello_world(request):
print('Request inbound!')
return Response('Podman works with Pyramid!')

if __name__ == '__main__':
config = Configurator()
config.add_route('hello', '/')
config.add_view(hello_world, route_name='hello')
app = config.make_wsgi_app()
server = make_server('0.0.0.0', 6543, app)
server.serve_forever()
</syntaxhighlight>

Este programa recibe peticiones en el puerto 6543.

== Ejercicio 7 ==

Cree una imagen derivada de Ubuntu, instale el paquete apache2, php y libapache2-mod-php.
Active el módulo de php para apache2 mediante la orden:

<syntaxhighlight lang="bash">
a2enmod php
</syntaxhighlight>

Cree la carpeta /var/www/php.

Cree el fichero index.php

<syntaxhighlight lang="php">
<?php
Print "Hello, World!";
?>
</syntaxhighlight>

y copielo a /var/www/php/.

Cree el fichero 000-default.conf y copielo a /etc/apache2/sites-enabled/

Dicho fichero contiene.

<syntaxhighlight lang="bash">
<VirtualHost *:80>
DocumentRoot /var/www/php

<Directory /var/www/php/>
Options Indexes FollowSymLinks MultiViews
AllowOverride All
Order deny,allow
Allow from all
</Directory>

ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>
</syntaxhighlight>

Tiene que lanzar apache con la orden: apachectl -D FOREGROUND

Tras crear la imagen, láncela mapeando el puerto 8888 al 80, pruebe que puede acceder a http://127.0.0.1:8888/php/ mediante curl

Solución:

<syntaxhighlight lang="bash">
FROM ubuntu:latest

RUN apt-get update
RUN apt-get install -y tzdata
RUN apt-get install -y apache2
RUN apt-get install -y php
RUN apt-get install -y libapache2-mod-php
RUN a2enmod php7.2
COPY index.php /var/www/php
COPY 000-default.conf /etc/apache2/sites-enabled/
CMD apachectl -D FOREGROUND
</syntaxhighlight>

Y para lanzarlo:

podman run --name my-app --rm -d -p 8001:8000 app:v1

y para probarlo:

curl -X GET http://127.0.0.1:8888/php/

== Ejercicio 8 ==

Instale el paquete ''netcat-traditional'' en una imagen de contenedor de ''ubuntu''. Lance la orden:

nc -u -l -p 8080

en el contenedor. Asegúrese de crear una redirección de puertos de 9999 desde el ''host'' al puerto 8080 en el contenedor.

Desde fuera del contenedor, pruebe a conectarse con:

nc -u 127.0.0.1 9999

== Ejercicio 9 ==

Cree una imagen derivada de "ubuntu" con un Dockerfile que incluya soporte de python y lance el siguiente código en Python:

<syntaxhighlight lang="python">
from http.server import BaseHTTPRequestHandler, HTTPServer
import time

hostName = "0.0.0.0"
serverPort = 8080

class MyServer(BaseHTTPRequestHandler):
def do_GET(self):
self.send_response(200)
self.send_header("Content-type", "text/html")
self.end_headers()
self.wfile.write(bytes("<html><head><title>Welcome!</title></head>", "utf-8"))
self.wfile.write(bytes("<body>", "utf-8"))
self.wfile.write(bytes("This is an example web server.", "utf-8"))
self.wfile.write(bytes("</body></html>", "utf-8"))

if __name__ == "__main__":
webServer = HTTPServer((hostName, serverPort), MyServer)
print("Server started http://%s:%s" % (hostName, serverPort))

try:
webServer.serve_forever()
except KeyboardInterrupt:
pass

webServer.server_close()
print("Server stopped.")
</syntaxhighlight>

Llame a su imagen "python-http-server". Lance una instancia de la imagen "python-http-server" mapeando el puerto 9999 al puerto 8888/tcp del contenedor. Compruebe con:

<syntaxhighlight lang="bash">
curl http://127.0.0.1:9999/
</syntaxhighlight>

que muestre la página HTML que ofrece el servidor, que debería ser:

<syntaxhighlight lang="bash">
<html><head><title>Welcome!</title></head><body>This is an example web server.</body></html>
</syntaxhighlight>

= Anexo =

* Cómo usar [[Podman compose]]

Podman compose

2025-12-16T13:14:41Z

Pneira: Página creada con «= Varios podman a la vez (podman-compose) = Cuando queremos ejecutar varios contenedores a la vez y que estén conectados entre ellos fácilmente, utilizaremos podman-comp...»

= Varios podman a la vez (podman-compose) =

Cuando queremos ejecutar varios contenedores a la vez y que estén conectados
entre ellos fácilmente, utilizaremos podman-compose, donde con un fichero de
configuración simple en yaml, tendremos toda la configuración de lo que vamos a
ejecutar.

Primero vamos a instalar podman-compose:

<syntaxhighlight lang="bash">
sudo apt install podman-compose
</syntaxhighlight>

Ahora veamos un pequeño ejemplo donde explicaremos todos los detalles para crear
un podman-compose, en este caso, el nombre por defecto de los ficheros suele ser
podman-compose.yml, y el contenido será similar a:

<syntaxhighlight lang="bash">
version: '3'

services:
web:
container_name: web
restart: always
build:
context: .
ports:
- "8000:8000"
volumes:
- /home/ubuntu/volume:/volumen:rw
environment:
USERNAME: test
web2:
container_name: web2
build:
dockerfile: Dockerfile
context: .
depends_on:
- web
command: touch web2
web3:
container_name: web3
restart: on-failure
image: pstauffer/curl
depends_on:
- web
command: curl -X GET web:8000/welcome?username=web3
</syntaxhighlight>

En el podman-compose definimos diferentes servicios a ejecutar, en nuestro caso
hemos iniciado tres servicios diferentes, web, web2 y web3:

El primer servicio, web:

* container_name: para darle un nombre por defecto al contenedor cuando se cree
* restart: pueden ser:
** "no": si la máquina termina, no se vuelve a iniciar (opción por defecto)
** always: siempre que el contenedor termine, intenta iniciarse de nuevo
** on-failure: solo intenta reiniciarse si el contenedor termina con fallo
** unless-stopped: solo reinicia el contenedor si el usuario es el que lo termina
* Utilizará el fichero Dockerfile creado en el paso 11 para generar la imagen a usar.
* Expondrá el puerto 8000 del contenedor en el 8000 de nuestra máquina
* Montará un volumen, se hace de forma similar a la línea de comandos
* Creará una variable de entorno

El segundo servicio, web2:

* Utilizará el fichero Dockerfile también, la diferencia entre este y el primer servicio, es que si el nombre del Dockerfile cambia, tendremos que hacerlo de esta segunda forma, la primera por defecto solo buscará el fichero Dockerfile
* depends_on hará que para ejecutar este servicio, su dependencia tenga ya que estar iniciada
* Ejecutaremos un comando el cual sustituirá al comando de la imagen

El tercer servicio, web3:

* Utilizará la imagen ostauffer/curl que es un imagen mínima que contiene el comando curl
* restart: en este caso, hasta que el comando no se ejecute correctamente, se seguirá reiniciando el contenedor
* depends_on igual que el servicio 2, dependerá del servicio 1
* Ejecutaremos un comando para llamar desde el servicio 3 al servicio 1

== Paso 13.1: Construir podman-compose ==

En el caso de existir servicios que tengan Dockerfiles, esto hará que se construyan previamente, como hacer un podman build de cada uno de los servicios que contenga un Dockerfile:

<syntaxhighlight lang="bash">
podman-compose build
</syntaxhighlight>

Con esto se generarán las imágenes necesarias para ejecutar todos los servicios.

== Paso 13.2: Iniciar podman-compose ==

Para iniciar todos los servicios, ejecutaremos:

<syntaxhighlight lang="bash">
podman-compose up -d
</syntaxhighlight>

Después de esto podremos ver el logs de todos los servicios:

<syntaxhighlight lang="bash">
podman-compose logs -f
</syntaxhighlight>

Aquí veremos que el servicio 3 ha conseguido llamar correctamente al servicio 1.

Ahora veremos como podman-compose ha creado los contenedores:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

La salida será similar a la siguiente:

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
219a4118244c pstauffer/curl "curl -X GET web:800…" 6 seconds ago Exited (0) 3 seconds ago web3
c97e894cb3ae ubuntu_web2 "touch web2" 6 seconds ago Exited (0) 4 seconds ago web2
f35d034204fc ubuntu_web "/bin/sh -c 'hug -f …" 6 seconds ago Up 5 seconds 0.0.0.0:8000->8000/tcp web
</syntaxhighlight>

Aquí vemos varios detalles:

* El nombre que le hemos dado en el podman-compose ha funcionado correctamente
* Vemos que los comandos son los correctos también
* web2 está parado por que la política de reinicio es apagar cuando se termine de ejecutar un comando
* web 3 está parado por que el comando ha terminado con un salida correcta

Vamos a comprobar ahora que en el servicio web está todo correcto:

<syntaxhighlight lang="bash">
podman exec -ti web ash
echo $USERNAME
ls /volumen
exit
</syntaxhighlight>

Podemos comprobar que tanto cambiar la variable de entorno como crear un
volumen ha funcionado correctamente.

== Paso 13.3: Parar podman-compose ==

Para parar todos los servicios:

<syntaxhighlight lang="bash">
podman-compose down
</syntaxhighlight>

Comprobamos:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Vemos que han desaparecido todos los contenedores.

Contenedores

2025-12-16T13:14:15Z

Pneira: /* Anexo */

En esta práctica aprenderemos a utilizar [https://es.wikipedia.org/wiki/Podman podman] para desplegar contenedores.

= Paso 1: Instalar podman =

Para instalar el paquete oficial:

<syntaxhighlight lang="bash">
apt install podman
</syntaxhighlight>

podman es un clon de '''docker''.

Si añade un usuario 'test' a su sistema con:

<syntaxhighlight lang="bash">
adduser test
</syntaxhighlight>

recuerde hacer:

<syntaxhighlight lang="bash">
loginctl enable-linger test
systemctl start --user dbus
</syntaxhighlight>

para evitar un warning que se muestra al ejecutar '''podman''' como usuario.

= Paso 2: Repositorio de imágenes de contenedores DockerHub =

Docker ofrece un servicio de nube denominado ''DockerHub'' que puede ser empleado como red social para compartir tus imágenes de Podman. En ''DockerHub'' existen además imágenes de contenedores preconfiguradas de software, muchas de ellas oficiales (ofrecidas por el propio fabricante del software) que se podrán emplear como base para construir nuevas imágenes adaptadas a nuestras necesidades.

Podremos realizar búsquedas en este repositorio ''DockerHub'' puedes emplear el siguiente comando:

<syntaxhighlight lang="bash">
podman search docker.io/library/hello-world
</syntaxhighlight>

Para descargarnos la imagen de ''hello-world'' podemos usar la orden ''pull'':

<syntaxhighlight lang="bash">
podman pull docker.io/library/hello-world
</syntaxhighlight>

También podemos publicar imágenes propias, esto require '''registro de usuario''' en la nube de ''DockerHub'', lo que '''no''' es obligatorio para la realización de esta práctica. Para subir una imagen, hay que validarse como usuario en la nube de ''DockerHub'':

<syntaxhighlight lang="bash">
podman login docker.io
</syntaxhighlight>

Tras introducir tu usuario y contraseña, puedes comenzar a publicar tus propias imágenes.

<syntaxhighlight lang="bash">
podman push docker.io/USUARIO/MI_IMAGEN
</syntaxhighlight>

Este paso es '''opcional''', sólo en caso de que se quieran subir imágenes de contenedores a la nube de docker.io.

= Paso 4: Comprobar imágenes en nuestra máquina =

Para ver las imágenes que tenemos en nuestra máquina, utilizaremos el comando:

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Inicialmente, no tenemos imágenes en almacenamiento, podemos descargarnos la imagen oficial de Debian 13 (Trixie):

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian
</syntaxhighlight>

Ahora si, ya debería de aparecernos la imagen ''debian''.

Comentar también que cada imagen puede tener varias etiquetas, por ejemplo, la imagen Debian 12 (Bookworm), cuando la hemos visto en el listado de imágenes, venía con el tag latest, que es el tag que se descarga por defecto, pero nosotros podemos especificar otro, por ejemplo:

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian:bookworm
</syntaxhighlight>

Para traernos la versión de la imagen de Debian 12 ''Bookworm''.

Ahora tendremos dos imágenes con diferente etiqueta, que serían como las diferentes versiones de cada imagen.

= Paso 5: Lanzar un contenedor =

Un contenedor no es más que una imagen de podman ejecutándose, sería similar a
una máquina virtual, aunque mucho más liviano.

Para crear un contenedor, utilizaremos una imagen, en este caso, la imagen
hello-world. Hacemos lo siguiente:

<syntaxhighlight lang="bash">
podman run hello-world
</syntaxhighlight>

Esto nos mostrará el siguiente mensaje si todo está correcto:

<syntaxhighlight lang="bash">
Hello from Docker!
This message shows that your installation appears to be working correctly.

To generate this message, Docker took the following steps:
1. The Docker client contacted the Docker daemon.
2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
(amd64)
3. The Docker daemon created a new container from that image which runs the
executable that produces the output you are currently reading.
4. The Docker daemon streamed that output to the Docker client, which sent it
to your terminal.

To try something more ambitious, you can run an Debian container with:
$ podman run -it debian bash

Share images, automate workflows, and more with a free Docker ID:
https://hub.docker.com/

For more examples and ideas, visit:
https://docs.docker.com/get-started/
</syntaxhighlight>

Al crear los contenedores utilizando el comando 'run', tenemos varias opciones:

* Lanzar una terminal en el contenedor en modo interactivo
* Lanzar en segundo plano y conectarnos posteriormente al contenedor

== Paso 5.1: Lanzar una terminal en el contenedor en modo interactivo (-ti) ==

Para este ejemplo vamos a utilizar otra imagen diferente, en este caso vamos a utilizar una imagen de debian.

Vamos a lanzar un contenedor y ejecutar una terminal en el que se va a ejecutar el programa '''bash''' que me ofrece un interprete de órdenes:

<syntaxhighlight lang="bash">
podman run -ti debian bash
</syntaxhighlight>

La opción ''-t'' indica que se crea un terminal en el contenedor. Y la opción ''-i'' indica que el contenedor se ejecuta en modo interactivo.

Al acceder al contenedor de ''debian'' nos aparece un ''hash'' en el prompt de la shell, que identifica a la instancia del contenedor (es valor es similar al que muestra la orden ''podman container ls'').

Para salir del contenedor, escribimos 'exit' o pulsamos ''CTRL + D''

== Paso 5.2 Lanzar en segundo plano (-d) ==

Otro ejemplo, con la imagen de Debian:

<syntaxhighlight lang="bash">
podman run -dti debian
</syntaxhighlight>

que muestra un hash que identifica de forma única el contenedor lanzado:

<syntaxhighlight lang="bash">
2ec1daae4676a4e84dc04fd91399c1dfe92119544ff12ee307991fe573d3db64
</syntaxhighlight>

Mediante el comando ''attach'' puedo entrar al contenedor:

<syntaxhighlight lang="bash">
podman attach 2ec1daae4676
</syntaxhighlight>

Para salir, pulsamos ''CTRL + P'' seguido de ''CTRL + Q''.

De manera similar, puedo lanzar en segundo plano la imagen de contenedor de ''hello-world'':

<syntaxhighlight lang="bash">
podman run -d hello-world
</syntaxhighlight>

Y consultar los logs:

<syntaxhighlight lang="bash">
podman logs b67fae3312bc321
</syntaxhighlight>

== Paso 5.3: Añadir variables de entorno a un contenedor ==

Utilizaremos la imagen anterior, y vamos a añadir una variable de entorno
llamada TEST que contenga el valor 'test'. A parte, también ejecutaremos la
terminal como antes, para comprobar con el comando echo, que la variable de
entorno está creada correctamente:

<syntaxhighlight lang="bash">
podman run -ti -e TEST=test debian bash
</syntaxhighlight>

Ahora, desde el contenedor podemos comprobar el valor de la variable de entorno ''$TEST''.

<syntaxhighlight lang="bash">
echo $TEST
test
</syntaxhighlight>

= Paso 6: Listar contenedores en ejecución =

Hemos estado haciendo pruebas y ejecutando contenedores en el paso anterior, vamos a ver donde se encuentran estos contenedores que hemos ejecutado, y después veremos algunas opciones más del comando run.

Tenemos dos opciones para ver los contenedores:

<syntaxhighlight lang="bash">
podman container ls -a
</syntaxhighlight>

o la versión corta:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Ambas hacen lo mismo, y debería de mostrarnos una salida similar a la siguiente:

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
e2bde5f5500c debian "bash" 6 minutes ago Exited (0) 2 seconds ago pensive_sammet
544ad27dbc3c debian "bash" 7 minutes ago Exited (0) 7 minutes ago serene_elgamal
</syntaxhighlight>

En la información veremos que el contenedor tiene el estado exited, eso quiere decir que no se está ejecutando y ya ha finalizado. Vamos a hacer una prueba para ver un contendor ejecutándose:

<syntaxhighlight lang="bash">
podman run -d debian sleep 30
</syntaxhighlight>

Con el comando sleep 30 esperamos 30 segundos hasta que termine el comando, asíque durante esos 30 segundos, el contenedor estará ejecutándose, veámoslo:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
eacceb27d52d debian "sleep 30" 12 seconds ago Up 11 seconds sharp_pasteur
</syntaxhighlight>

Vamos a ver alguna opciones más de la orden ''run''.

== Paso 6.1: Dar un nombre al contenedor (--name) ==

Por defecto, podman creará automáticamente un nombre como hemos visto en las salidas del comando ''podman ps -a''. Podemos establecer el nombre del contenedor que queramos con la opción ''--name'':

<syntaxhighlight lang="bash">
podman run -ti --name mi_debian debian
</syntaxhighlight>

== Paso 6.2: Eliminar contenedor cuando termine (--rm) ==

Vamos a mezclar todo lo visto anteriormente:

* Lanzar en segundo plano (-d)
* Ejecutar contenedor durante 30 segundos (sleep 30)
* Dar un nombre a la imagen (--name)
* Eliminar contenedor cuando termine (--rm)

<syntaxhighlight lang="bash">
podman run -d --rm --name bye-bye debian sleep 30
</syntaxhighlight>

Antes y una vez pasados los 30 segundos, podemos comprobar que el contenedor ha desaparecido.

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

= Paso 7: Parar y eliminar contenedores =

Para parar contenedores podemos usar el ID o su nombre:

<syntaxhighlight lang="bash">
podman stop my_container
podman stop e4901956f108
podman ps -a
</syntaxhighlight>

Una vez hemos comprobado que han terminado su ejecución, podemos eliminar los ficheros resultantes de su ejecución:

<syntaxhighlight lang="bash">
podman container rm my_container
</syntaxhighlight>

Para borrar todos los contenedores ya finalizados

<syntaxhighlight lang="bash">
podman container prune
</syntaxhighlight>

= Paso 8: Conectarnos a un contenedor que se está ejecutando en segundo plano =

Vamos a ejecutar de nuevo un contenedor que no termine:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a conectarnos a este contenedor que está ejecutándose en segundo
plano:

<syntaxhighlight lang="bash">
podman attach mi-contenedor
</syntaxhighlight>

Veremos la orden bash ejecutándose, para terminar, hacemos un 'CTRL + C', y ahora, veremos que ha pasado con el contenedor:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Lo veremos parado, por que lo que hemos hecho ha sido conectarnos al contenedor
y parar el comando que se estaba ejecutando, así que ahora tenemos el contenedor
finalizado.

''Nota:'' Para salir del contenedor '''sin detenerlo''' hacemos 'CTRL + P' seguido 'CTRL + Q'

= Paso 9: Ejecutar un comando dentro de un contenedor en ejecución =

Vamos a ver otresta vez como ejecutar un comando en un contenedor que ya está
ejecutándose:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a ejecutar un comando en ese contenedor con el nombre ''mi-contenedor''.
El comando exec es similar al comando run, pero para ejecutar un comando dentro de un contenedor:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor ls
</syntaxhighlight>

Para redirigir la salida a un fichero en el anfitrión:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor ls > x.txt
</syntaxhighlight>

Para redirigir la salida a un fichero ''dentro'' del contenedor, hacemos:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor sh -c "ls > x.txt"
</syntaxhighlight>

También es posible ejecutar comandos con tuberías:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor sh -c "ls -la | grep ^d"
</syntaxhighlight>

= Paso 10: Persistencia en contenedores =

Al hacer ''exit'' y salir de un contenedor, se pierden todos los cambios que hemos realizado. Los

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-ejemplo debian bash
</syntaxhighlight>

Ahora, vamos a crear una carpeta en el contenedor y comprobar que esa carpeta existe:

<syntaxhighlight lang="bash">
podman exec mi-ejemplo mkdir test
podman exec mi-ejemplo ls
</syntaxhighlight>

Veremos que la carpeta existe, pero, ¿qué ocurre si para el contenedor?

<syntaxhighlight lang="bash">
podman container stop mi-ejemplo
</syntaxhighlight>

Y volvemos a lanzarlo:

<syntaxhighlight lang="bash">
podman container rm mi-ejemplo
podman run -d -ti --name mi-ejemplo debian bash
podman exec mi-ejemplo ls
</syntaxhighlight>

Podemos comprobar que la carpeta creada anteriormente, no existe.

¿Qué podemos hacer para mantener la modificaciones realizadas sobre un contenedor?

== Paso 10.1: Crear una imagen derivada de la imagen base ==

Es posible crear una imagen derivada, con modificaciones, a partir de una imagen existente mediante la orden '''commit'''.

Por ejemplo, si queremos una imagen ''debian'' que incluya el programa ''ping'' ya instalado, tendríamos que lanzar un contenedor a partir de la imagen ''ubuntu'':

<syntaxhighlight lang="bash">
podman run -d -ti debian bash
</syntaxhighlight>

Suponiendo que el contenido está identificado con el ID 56ef5b312334

Instalamos el paquete ping:

<syntaxhighlight lang="bash">
podman exec 56ef5b312334 apt -y install ping
</syntaxhighlight>

Generamos la imagen derivada con el nombre ''ubuntu-con-ping'':

<syntaxhighlight lang="bash">
podman commit 56ef5b312334 ubuntu-con-ping
</syntaxhighlight>

Ya podemos para nuestro contendor:

<syntaxhighlight lang="bash">
podman stop 56ef5b312334
</syntaxhighlight>

Y lanzar un nuevo contenedor a partir de la imagen ''debian-con-ping'':

<syntaxhighlight lang="bash">
podman run -d -ti debian-con-ping bash
</syntaxhighlight>

== Paso 10.2: Mantener la persistencia mediante volúmen ==

Otra opción para mantener los datos es montar un volumen al ejecutar el contenedor.

Primero crearemos una carpeta que hará de volumen en nuestra máquina, que será la que luego montemos para podman:

<syntaxhighlight lang="bash">
mkdir /home/debian/volumen
</syntaxhighlight>

Ahora vamos a montar la carpeta al ejecutar el contenedor, lo hacemos con la
opción -v, la cual tiene 3 campos separados por ':':

# El volumen en nuestra máquina
# Donde se montará el volumen dentro del contenedor
# Opciones de mmontaje, por ejemplo rw (read and write) o ro (read only)

<syntaxhighlight lang="bash">
podman run --rm -ti -v /home/debian/volumen:/volumen:rw debian bash
mkdir /volumen/test
touch /volumen/test/file
exit
</syntaxhighlight>

Una vez nos salgamos del contenedor, podemos ver que en nuestra máquina están
los datos:

<syntaxhighlight lang="bash">
ls /home/ubuntu/volumen/
ls /home/ubuntu/volumen/test
</syntaxhighlight>

La próxima vez que ejecutemos un contenedor, si montamos ese volumen, los datos
estarán ahí, además esta forma tiene el beneficio de compartir datos entre
nuestra máquina y el contenedor de forma sencilla.

= Paso 11: Crear nuestra propia imagen de contenedor =

Para crear una imagen de un contenedor con una aplicación de Python hug, creamos en primer lugar la carpeta que contendrá los ficheros que nos permiten crear la imagen.

<syntaxhighlight lang="bash">
mkdir miapp
cd miapp
</syntaxhighlight>

Definimos un fichero ''Dockerfile'' para definir la imagen:

<syntaxhighlight lang="bash">
FROM ubuntu

RUN apt -y update
RUN apt -y upgrade
RUN apt -y install python3-hug
RUN mkdir /app
COPY endpoint.py /app
WORKDIR /app
CMD hug -f endpoint.py
</syntaxhighlight>

Alternativamente, puedes crear un [[Creando imagen propia usando Ubuntu de base|Dockerfile empleando la imagen de Ubuntu]] como base en lugar de Alpine.

Y añadimos el fichero ''endpoint.py'' que emplea el framework Python hug con el contenido siguiente:

<syntaxhighlight lang="bash">
import hug

@hug.get('/welcome')
def welcome(username="unknown"):
""" Say welcome to username """
return "Welcome " + username
</syntaxhighlight>

Este fichero es un ejemplo de uso de Python hug. Si hacemos una petición a /welcome?username="LSO", esto nos devolverá el mensaje "Welcome LSO".

Una vez tengamos los dos ficheros creados en nuestra máquina virtual, podemos construir nuestra imagen:

<syntaxhighlight lang="bash">
podman build -t app:v1 -f Dockerfile .
</syntaxhighlight>

Vamos a explicar para que sirve cada línea:

* FROM: servirá para basarnos en una imagen existente, en este caso, una imagen de python alpine, que contiene python y no ocupa mucho espacio
* ENV: para crear variables de entorno
* RUN: para ejecutar comandos, ya sea para crear una carpeta, instalar dependencias o cualquier otra opción que necesitemos
* COPY: para copiar datos desde nuestra máquina a la imagen
* WORKDIR: para cambiar el directorio de trabajo (lo crea si no existe)
* CMD: este comando será ejecutado por defecto al iniciar un contenedor a partir de esta imagen

Esto construirá una imagen podman basada en python:alpine, en la cual hemos
guardado nuestra pequeña aplicación y se va a ejecutar cuando ejecutemos un
contenedor basado en esa imagen. Para comprobar que la imagen se ha creado
correctamente, listamos las imagenes, y debería de aparecernos una imagen con
nombre 'app' y tag 'v1':

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen, y vamos a añadir una nueva
opción, -p 8001:8000. Esta opción hará que el puerto interno 8000 del contenedor
sea expuesto en el puerto 8001 de nuestra máquina:

<syntaxhighlight lang="bash">
podman run --name my-app --rm -d -p 8001:8000 app:v1
</syntaxhighlight>

''Nota:'' podman supone que la redirección de puerto es TCP, para una redirección de puertos UDP, puedes usar:

<syntaxhighlight lang="bash">
... -p 8001:8000/udp
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código. En nuestra
máquina haremos:

<syntaxhighlight lang="bash">
curl -X GET http://localhost:8001/welcome?username=LSO
</syntaxhighlight>

Comprobaremos que la salida del comando curl, es "Welcome LSO".

Antes de terminar, vamos a comprobar otro pequeño detalle que añadimos en
nuestra imagen, la variable de entorno USERNAME, vamos a comprobar que funciona:

<syntaxhighlight lang="bash">
podman exec -ti my-app ash
echo $USERNAME
</syntaxhighlight>

Funciona correctamente, pero al ejecutar el contenedor, podemos cambiar esta
variable de entorno como vimos en uno de los pasos anteriores:

<syntaxhighlight lang="bash">
podman run --rm -ti -e USERNAME=me app:v1 ash
echo $USERNAME
</syntaxhighlight>

Esto nos servirá para tener opciones por defecto y que el usuario pueda
cambiarlo a su antojo, como por ejemplo contraseñas u otros detalles.

= Paso 12: Eliminar imágenes =

Para borrar una imagen, puede hacer:

<syntaxhighlight lang="bash">
podman image rm hello-world
</syntaxhighlight>

= Paso 13: Ejercicios =

== Ejercicio 1: Image derivada de Debian con el programa sl ==

Lance un contenedor a partir de una imagen de Debian, instale el programa sl, ejecute sl (desde fuera del contenedor) y detenga el contenedor.

== Ejercicio 2 ==

== Ejercicio 3: Variante de httpd ==

Construya una imagen ''httpd-hola-mundo'' a partir de la imagen ''httpd''. El fichero de index.html de la carpeta htdocs/ tiene que mostrar el mensaje "hola mundo".

<syntaxhighlight lang="bash">
podman pull httpd
</syntaxhighlight>

Edita el fichero Dockerfile:

<syntaxhighlight lang="bash">
nano Dockerfile
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
FROM httpd

COPY index.html htdocs/index.html
</syntaxhighlight>

Edita el fichero index.html:

<syntaxhighlight lang="bash">
nano index.html
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

Construye la imagen:

<syntaxhighlight lang="bash">
podman build -t mihttpd -f Dockerfile .
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen:

<syntaxhighlight lang="bash">
podman run --name mihttpd -d -p 8080:80 mihttpd
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código:
<syntaxhighlight lang="bash">
curl -X GET http://localhost:8080
</syntaxhighlight>

Tiene que salir por pantalla esto:
<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

== Ejercicio 4: aplicación flask ==

Flask es un framework python para implementar webs. Cree una imagen "miapp-flask" a partir de la imagen de "python":

* Instale flask mediante: pip install flask
* Cree la carpeta "app"
* Establezca la variable FLASK_APP a "hello.py"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"

El fichero hello.py contiene un "hola mundo" para Flask:

<syntaxhighlight lang="python">
from flask import Flask
app = Flask(__name__)

@app.route("/")
def hello():
return "Hello World!"

if __name__ == "__main__":
app.run()
</syntaxhighlight>

Solución con alpine:

<syntaxhighlight lang="bash">
FROM python:alpine

RUN mkdir /app
RUN pip install flask
ENV FLASK_APP="app/hello.py"
COPY hello.py
WORKDIR /
CMD flask run --host=0.0.0.0
</syntaxhighlight>

Solución con Ubuntu:

<syntaxhighlight lang="bash">
FROM ubuntu:bionic

RUN apt-get update
RUN apt-get -y install python python-pip wget
RUN pip install Flask
ENV FLASK_APP="app/hello.py"
RUN mkdir /app
COPY hello.py /app
CMD flask run --host=0.0.0.0
</syntaxhighlight>

== Ejercicio 5: mysql ==

'''EN LA MÁQUINA VIRTUAL:'''

mkdir miapp
cd miapp
podman pull mysql
nano Dockerfile

<syntaxhighlight lang="bash">
FROM mysql
ENV MYSQL_ROOT_PASSWORD="lacontraseñaqueyoquiera"
RUN mkdir /app
WORKDIR /app

</syntaxhighlight>

CTRL+O , ENTER Y CTRL+X (para guardar Dockerfile y salir)

podman build -ti mrfdocker -f Dockerfile .
podman run --name mymrf --rm -p 8001:3306 mrfdocker
docker images

'''EN LA TERMINAL DEL HOST:'''

''Instalación de mysql:''

apt install mysql-client-core-5.7
apt-get install mysql-server
service mysql start

''Para entrar:''

mysql -u root -p -P 8001

Una vez dentro de msql:

mysql> show databases;

''Para salir:''

exit

== Ejercicio 6: python pyramid ==

Pyramid es un framework python para implementar webs. Cree una imagen "miapp-pyramid":

* Emplee la imagen de debian como referencia, instale los paquetes python3 y python3-pyramid.
* Cree la carpeta "app"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"
* La aplicación se lanza con la orden: python hello.py
* Compruebe que funciona con curl, la ruta a la web es http://127.0.0.1:8000/hello, suponiendo que ha empleado el puerto 8000 para exponer el servicio.

El fichero hello.py contiene un "hola mundo" para Pyramid:

<syntaxhighlight lang="bash">
from wsgiref.simple_server import make_server
from pyramid.config import Configurator
from pyramid.response import Response

def hello_world(request):
print('Request inbound!')
return Response('Podman works with Pyramid!')

if __name__ == '__main__':
config = Configurator()
config.add_route('hello', '/')
config.add_view(hello_world, route_name='hello')
app = config.make_wsgi_app()
server = make_server('0.0.0.0', 6543, app)
server.serve_forever()
</syntaxhighlight>

Este programa recibe peticiones en el puerto 6543.

== Ejercicio 7 ==

Cree una imagen derivada de Ubuntu, instale el paquete apache2, php y libapache2-mod-php.
Active el módulo de php para apache2 mediante la orden:

<syntaxhighlight lang="bash">
a2enmod php
</syntaxhighlight>

Cree la carpeta /var/www/php.

Cree el fichero index.php

<syntaxhighlight lang="php">
<?php
Print "Hello, World!";
?>
</syntaxhighlight>

y copielo a /var/www/php/.

Cree el fichero 000-default.conf y copielo a /etc/apache2/sites-enabled/

Dicho fichero contiene.

<syntaxhighlight lang="bash">
<VirtualHost *:80>
DocumentRoot /var/www/php

<Directory /var/www/php/>
Options Indexes FollowSymLinks MultiViews
AllowOverride All
Order deny,allow
Allow from all
</Directory>

ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>
</syntaxhighlight>

Tiene que lanzar apache con la orden: apachectl -D FOREGROUND

Tras crear la imagen, láncela mapeando el puerto 8888 al 80, pruebe que puede acceder a http://127.0.0.1:8888/php/ mediante curl

Solución:

<syntaxhighlight lang="bash">
FROM ubuntu:latest

RUN apt-get update
RUN apt-get install -y tzdata
RUN apt-get install -y apache2
RUN apt-get install -y php
RUN apt-get install -y libapache2-mod-php
RUN a2enmod php7.2
COPY index.php /var/www/php
COPY 000-default.conf /etc/apache2/sites-enabled/
CMD apachectl -D FOREGROUND
</syntaxhighlight>

Y para lanzarlo:

podman run --name my-app --rm -d -p 8001:8000 app:v1

y para probarlo:

curl -X GET http://127.0.0.1:8888/php/

== Ejercicio 8 ==

Instale el paquete ''netcat-traditional'' en una imagen de contenedor de ''ubuntu''. Lance la orden:

nc -u -l -p 8080

en el contenedor. Asegúrese de crear una redirección de puertos de 9999 desde el ''host'' al puerto 8080 en el contenedor.

Desde fuera del contenedor, pruebe a conectarse con:

nc -u 127.0.0.1 9999

== Ejercicio 9 ==

Cree una imagen derivada de "ubuntu" con un Dockerfile que incluya soporte de python y lance el siguiente código en Python:

<syntaxhighlight lang="python">
from http.server import BaseHTTPRequestHandler, HTTPServer
import time

hostName = "0.0.0.0"
serverPort = 8080

class MyServer(BaseHTTPRequestHandler):
def do_GET(self):
self.send_response(200)
self.send_header("Content-type", "text/html")
self.end_headers()
self.wfile.write(bytes("<html><head><title>Welcome!</title></head>", "utf-8"))
self.wfile.write(bytes("<body>", "utf-8"))
self.wfile.write(bytes("This is an example web server.", "utf-8"))
self.wfile.write(bytes("</body></html>", "utf-8"))

if __name__ == "__main__":
webServer = HTTPServer((hostName, serverPort), MyServer)
print("Server started http://%s:%s" % (hostName, serverPort))

try:
webServer.serve_forever()
except KeyboardInterrupt:
pass

webServer.server_close()
print("Server stopped.")
</syntaxhighlight>

Llame a su imagen "python-http-server". Lance una instancia de la imagen "python-http-server" mapeando el puerto 9999 al puerto 8888/tcp del contenedor. Compruebe con:

<syntaxhighlight lang="bash">
curl http://127.0.0.1:9999/
</syntaxhighlight>

que muestre la página HTML que ofrece el servidor, que debería ser:

<syntaxhighlight lang="bash">
<html><head><title>Welcome!</title></head><body>This is an example web server.</body></html>
</syntaxhighlight>

= Anexo =

* Cómo usar [[Podman compose]]

Contenedores

2025-12-16T13:13:56Z

Pneira:

En esta práctica aprenderemos a utilizar [https://es.wikipedia.org/wiki/Podman podman] para desplegar contenedores.

= Paso 1: Instalar podman =

Para instalar el paquete oficial:

<syntaxhighlight lang="bash">
apt install podman
</syntaxhighlight>

podman es un clon de '''docker''.

Si añade un usuario 'test' a su sistema con:

<syntaxhighlight lang="bash">
adduser test
</syntaxhighlight>

recuerde hacer:

<syntaxhighlight lang="bash">
loginctl enable-linger test
systemctl start --user dbus
</syntaxhighlight>

para evitar un warning que se muestra al ejecutar '''podman''' como usuario.

= Paso 2: Repositorio de imágenes de contenedores DockerHub =

Docker ofrece un servicio de nube denominado ''DockerHub'' que puede ser empleado como red social para compartir tus imágenes de Podman. En ''DockerHub'' existen además imágenes de contenedores preconfiguradas de software, muchas de ellas oficiales (ofrecidas por el propio fabricante del software) que se podrán emplear como base para construir nuevas imágenes adaptadas a nuestras necesidades.

Podremos realizar búsquedas en este repositorio ''DockerHub'' puedes emplear el siguiente comando:

<syntaxhighlight lang="bash">
podman search docker.io/library/hello-world
</syntaxhighlight>

Para descargarnos la imagen de ''hello-world'' podemos usar la orden ''pull'':

<syntaxhighlight lang="bash">
podman pull docker.io/library/hello-world
</syntaxhighlight>

También podemos publicar imágenes propias, esto require '''registro de usuario''' en la nube de ''DockerHub'', lo que '''no''' es obligatorio para la realización de esta práctica. Para subir una imagen, hay que validarse como usuario en la nube de ''DockerHub'':

<syntaxhighlight lang="bash">
podman login docker.io
</syntaxhighlight>

Tras introducir tu usuario y contraseña, puedes comenzar a publicar tus propias imágenes.

<syntaxhighlight lang="bash">
podman push docker.io/USUARIO/MI_IMAGEN
</syntaxhighlight>

Este paso es '''opcional''', sólo en caso de que se quieran subir imágenes de contenedores a la nube de docker.io.

= Paso 4: Comprobar imágenes en nuestra máquina =

Para ver las imágenes que tenemos en nuestra máquina, utilizaremos el comando:

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Inicialmente, no tenemos imágenes en almacenamiento, podemos descargarnos la imagen oficial de Debian 13 (Trixie):

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian
</syntaxhighlight>

Ahora si, ya debería de aparecernos la imagen ''debian''.

Comentar también que cada imagen puede tener varias etiquetas, por ejemplo, la imagen Debian 12 (Bookworm), cuando la hemos visto en el listado de imágenes, venía con el tag latest, que es el tag que se descarga por defecto, pero nosotros podemos especificar otro, por ejemplo:

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian:bookworm
</syntaxhighlight>

Para traernos la versión de la imagen de Debian 12 ''Bookworm''.

Ahora tendremos dos imágenes con diferente etiqueta, que serían como las diferentes versiones de cada imagen.

= Paso 5: Lanzar un contenedor =

Un contenedor no es más que una imagen de podman ejecutándose, sería similar a
una máquina virtual, aunque mucho más liviano.

Para crear un contenedor, utilizaremos una imagen, en este caso, la imagen
hello-world. Hacemos lo siguiente:

<syntaxhighlight lang="bash">
podman run hello-world
</syntaxhighlight>

Esto nos mostrará el siguiente mensaje si todo está correcto:

<syntaxhighlight lang="bash">
Hello from Docker!
This message shows that your installation appears to be working correctly.

To generate this message, Docker took the following steps:
1. The Docker client contacted the Docker daemon.
2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
(amd64)
3. The Docker daemon created a new container from that image which runs the
executable that produces the output you are currently reading.
4. The Docker daemon streamed that output to the Docker client, which sent it
to your terminal.

To try something more ambitious, you can run an Debian container with:
$ podman run -it debian bash

Share images, automate workflows, and more with a free Docker ID:
https://hub.docker.com/

For more examples and ideas, visit:
https://docs.docker.com/get-started/
</syntaxhighlight>

Al crear los contenedores utilizando el comando 'run', tenemos varias opciones:

* Lanzar una terminal en el contenedor en modo interactivo
* Lanzar en segundo plano y conectarnos posteriormente al contenedor

== Paso 5.1: Lanzar una terminal en el contenedor en modo interactivo (-ti) ==

Para este ejemplo vamos a utilizar otra imagen diferente, en este caso vamos a utilizar una imagen de debian.

Vamos a lanzar un contenedor y ejecutar una terminal en el que se va a ejecutar el programa '''bash''' que me ofrece un interprete de órdenes:

<syntaxhighlight lang="bash">
podman run -ti debian bash
</syntaxhighlight>

La opción ''-t'' indica que se crea un terminal en el contenedor. Y la opción ''-i'' indica que el contenedor se ejecuta en modo interactivo.

Al acceder al contenedor de ''debian'' nos aparece un ''hash'' en el prompt de la shell, que identifica a la instancia del contenedor (es valor es similar al que muestra la orden ''podman container ls'').

Para salir del contenedor, escribimos 'exit' o pulsamos ''CTRL + D''

== Paso 5.2 Lanzar en segundo plano (-d) ==

Otro ejemplo, con la imagen de Debian:

<syntaxhighlight lang="bash">
podman run -dti debian
</syntaxhighlight>

que muestra un hash que identifica de forma única el contenedor lanzado:

<syntaxhighlight lang="bash">
2ec1daae4676a4e84dc04fd91399c1dfe92119544ff12ee307991fe573d3db64
</syntaxhighlight>

Mediante el comando ''attach'' puedo entrar al contenedor:

<syntaxhighlight lang="bash">
podman attach 2ec1daae4676
</syntaxhighlight>

Para salir, pulsamos ''CTRL + P'' seguido de ''CTRL + Q''.

De manera similar, puedo lanzar en segundo plano la imagen de contenedor de ''hello-world'':

<syntaxhighlight lang="bash">
podman run -d hello-world
</syntaxhighlight>

Y consultar los logs:

<syntaxhighlight lang="bash">
podman logs b67fae3312bc321
</syntaxhighlight>

== Paso 5.3: Añadir variables de entorno a un contenedor ==

Utilizaremos la imagen anterior, y vamos a añadir una variable de entorno
llamada TEST que contenga el valor 'test'. A parte, también ejecutaremos la
terminal como antes, para comprobar con el comando echo, que la variable de
entorno está creada correctamente:

<syntaxhighlight lang="bash">
podman run -ti -e TEST=test debian bash
</syntaxhighlight>

Ahora, desde el contenedor podemos comprobar el valor de la variable de entorno ''$TEST''.

<syntaxhighlight lang="bash">
echo $TEST
test
</syntaxhighlight>

= Paso 6: Listar contenedores en ejecución =

Hemos estado haciendo pruebas y ejecutando contenedores en el paso anterior, vamos a ver donde se encuentran estos contenedores que hemos ejecutado, y después veremos algunas opciones más del comando run.

Tenemos dos opciones para ver los contenedores:

<syntaxhighlight lang="bash">
podman container ls -a
</syntaxhighlight>

o la versión corta:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Ambas hacen lo mismo, y debería de mostrarnos una salida similar a la siguiente:

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
e2bde5f5500c debian "bash" 6 minutes ago Exited (0) 2 seconds ago pensive_sammet
544ad27dbc3c debian "bash" 7 minutes ago Exited (0) 7 minutes ago serene_elgamal
</syntaxhighlight>

En la información veremos que el contenedor tiene el estado exited, eso quiere decir que no se está ejecutando y ya ha finalizado. Vamos a hacer una prueba para ver un contendor ejecutándose:

<syntaxhighlight lang="bash">
podman run -d debian sleep 30
</syntaxhighlight>

Con el comando sleep 30 esperamos 30 segundos hasta que termine el comando, asíque durante esos 30 segundos, el contenedor estará ejecutándose, veámoslo:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
eacceb27d52d debian "sleep 30" 12 seconds ago Up 11 seconds sharp_pasteur
</syntaxhighlight>

Vamos a ver alguna opciones más de la orden ''run''.

== Paso 6.1: Dar un nombre al contenedor (--name) ==

Por defecto, podman creará automáticamente un nombre como hemos visto en las salidas del comando ''podman ps -a''. Podemos establecer el nombre del contenedor que queramos con la opción ''--name'':

<syntaxhighlight lang="bash">
podman run -ti --name mi_debian debian
</syntaxhighlight>

== Paso 6.2: Eliminar contenedor cuando termine (--rm) ==

Vamos a mezclar todo lo visto anteriormente:

* Lanzar en segundo plano (-d)
* Ejecutar contenedor durante 30 segundos (sleep 30)
* Dar un nombre a la imagen (--name)
* Eliminar contenedor cuando termine (--rm)

<syntaxhighlight lang="bash">
podman run -d --rm --name bye-bye debian sleep 30
</syntaxhighlight>

Antes y una vez pasados los 30 segundos, podemos comprobar que el contenedor ha desaparecido.

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

= Paso 7: Parar y eliminar contenedores =

Para parar contenedores podemos usar el ID o su nombre:

<syntaxhighlight lang="bash">
podman stop my_container
podman stop e4901956f108
podman ps -a
</syntaxhighlight>

Una vez hemos comprobado que han terminado su ejecución, podemos eliminar los ficheros resultantes de su ejecución:

<syntaxhighlight lang="bash">
podman container rm my_container
</syntaxhighlight>

Para borrar todos los contenedores ya finalizados

<syntaxhighlight lang="bash">
podman container prune
</syntaxhighlight>

= Paso 8: Conectarnos a un contenedor que se está ejecutando en segundo plano =

Vamos a ejecutar de nuevo un contenedor que no termine:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a conectarnos a este contenedor que está ejecutándose en segundo
plano:

<syntaxhighlight lang="bash">
podman attach mi-contenedor
</syntaxhighlight>

Veremos la orden bash ejecutándose, para terminar, hacemos un 'CTRL + C', y ahora, veremos que ha pasado con el contenedor:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Lo veremos parado, por que lo que hemos hecho ha sido conectarnos al contenedor
y parar el comando que se estaba ejecutando, así que ahora tenemos el contenedor
finalizado.

''Nota:'' Para salir del contenedor '''sin detenerlo''' hacemos 'CTRL + P' seguido 'CTRL + Q'

= Paso 9: Ejecutar un comando dentro de un contenedor en ejecución =

Vamos a ver otresta vez como ejecutar un comando en un contenedor que ya está
ejecutándose:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a ejecutar un comando en ese contenedor con el nombre ''mi-contenedor''.
El comando exec es similar al comando run, pero para ejecutar un comando dentro de un contenedor:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor ls
</syntaxhighlight>

Para redirigir la salida a un fichero en el anfitrión:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor ls > x.txt
</syntaxhighlight>

Para redirigir la salida a un fichero ''dentro'' del contenedor, hacemos:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor sh -c "ls > x.txt"
</syntaxhighlight>

También es posible ejecutar comandos con tuberías:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor sh -c "ls -la | grep ^d"
</syntaxhighlight>

= Paso 10: Persistencia en contenedores =

Al hacer ''exit'' y salir de un contenedor, se pierden todos los cambios que hemos realizado. Los

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-ejemplo debian bash
</syntaxhighlight>

Ahora, vamos a crear una carpeta en el contenedor y comprobar que esa carpeta existe:

<syntaxhighlight lang="bash">
podman exec mi-ejemplo mkdir test
podman exec mi-ejemplo ls
</syntaxhighlight>

Veremos que la carpeta existe, pero, ¿qué ocurre si para el contenedor?

<syntaxhighlight lang="bash">
podman container stop mi-ejemplo
</syntaxhighlight>

Y volvemos a lanzarlo:

<syntaxhighlight lang="bash">
podman container rm mi-ejemplo
podman run -d -ti --name mi-ejemplo debian bash
podman exec mi-ejemplo ls
</syntaxhighlight>

Podemos comprobar que la carpeta creada anteriormente, no existe.

¿Qué podemos hacer para mantener la modificaciones realizadas sobre un contenedor?

== Paso 10.1: Crear una imagen derivada de la imagen base ==

Es posible crear una imagen derivada, con modificaciones, a partir de una imagen existente mediante la orden '''commit'''.

Por ejemplo, si queremos una imagen ''debian'' que incluya el programa ''ping'' ya instalado, tendríamos que lanzar un contenedor a partir de la imagen ''ubuntu'':

<syntaxhighlight lang="bash">
podman run -d -ti debian bash
</syntaxhighlight>

Suponiendo que el contenido está identificado con el ID 56ef5b312334

Instalamos el paquete ping:

<syntaxhighlight lang="bash">
podman exec 56ef5b312334 apt -y install ping
</syntaxhighlight>

Generamos la imagen derivada con el nombre ''ubuntu-con-ping'':

<syntaxhighlight lang="bash">
podman commit 56ef5b312334 ubuntu-con-ping
</syntaxhighlight>

Ya podemos para nuestro contendor:

<syntaxhighlight lang="bash">
podman stop 56ef5b312334
</syntaxhighlight>

Y lanzar un nuevo contenedor a partir de la imagen ''debian-con-ping'':

<syntaxhighlight lang="bash">
podman run -d -ti debian-con-ping bash
</syntaxhighlight>

== Paso 10.2: Mantener la persistencia mediante volúmen ==

Otra opción para mantener los datos es montar un volumen al ejecutar el contenedor.

Primero crearemos una carpeta que hará de volumen en nuestra máquina, que será la que luego montemos para podman:

<syntaxhighlight lang="bash">
mkdir /home/debian/volumen
</syntaxhighlight>

Ahora vamos a montar la carpeta al ejecutar el contenedor, lo hacemos con la
opción -v, la cual tiene 3 campos separados por ':':

# El volumen en nuestra máquina
# Donde se montará el volumen dentro del contenedor
# Opciones de mmontaje, por ejemplo rw (read and write) o ro (read only)

<syntaxhighlight lang="bash">
podman run --rm -ti -v /home/debian/volumen:/volumen:rw debian bash
mkdir /volumen/test
touch /volumen/test/file
exit
</syntaxhighlight>

Una vez nos salgamos del contenedor, podemos ver que en nuestra máquina están
los datos:

<syntaxhighlight lang="bash">
ls /home/ubuntu/volumen/
ls /home/ubuntu/volumen/test
</syntaxhighlight>

La próxima vez que ejecutemos un contenedor, si montamos ese volumen, los datos
estarán ahí, además esta forma tiene el beneficio de compartir datos entre
nuestra máquina y el contenedor de forma sencilla.

= Paso 11: Crear nuestra propia imagen de contenedor =

Para crear una imagen de un contenedor con una aplicación de Python hug, creamos en primer lugar la carpeta que contendrá los ficheros que nos permiten crear la imagen.

<syntaxhighlight lang="bash">
mkdir miapp
cd miapp
</syntaxhighlight>

Definimos un fichero ''Dockerfile'' para definir la imagen:

<syntaxhighlight lang="bash">
FROM ubuntu

RUN apt -y update
RUN apt -y upgrade
RUN apt -y install python3-hug
RUN mkdir /app
COPY endpoint.py /app
WORKDIR /app
CMD hug -f endpoint.py
</syntaxhighlight>

Alternativamente, puedes crear un [[Creando imagen propia usando Ubuntu de base|Dockerfile empleando la imagen de Ubuntu]] como base en lugar de Alpine.

Y añadimos el fichero ''endpoint.py'' que emplea el framework Python hug con el contenido siguiente:

<syntaxhighlight lang="bash">
import hug

@hug.get('/welcome')
def welcome(username="unknown"):
""" Say welcome to username """
return "Welcome " + username
</syntaxhighlight>

Este fichero es un ejemplo de uso de Python hug. Si hacemos una petición a /welcome?username="LSO", esto nos devolverá el mensaje "Welcome LSO".

Una vez tengamos los dos ficheros creados en nuestra máquina virtual, podemos construir nuestra imagen:

<syntaxhighlight lang="bash">
podman build -t app:v1 -f Dockerfile .
</syntaxhighlight>

Vamos a explicar para que sirve cada línea:

* FROM: servirá para basarnos en una imagen existente, en este caso, una imagen de python alpine, que contiene python y no ocupa mucho espacio
* ENV: para crear variables de entorno
* RUN: para ejecutar comandos, ya sea para crear una carpeta, instalar dependencias o cualquier otra opción que necesitemos
* COPY: para copiar datos desde nuestra máquina a la imagen
* WORKDIR: para cambiar el directorio de trabajo (lo crea si no existe)
* CMD: este comando será ejecutado por defecto al iniciar un contenedor a partir de esta imagen

Esto construirá una imagen podman basada en python:alpine, en la cual hemos
guardado nuestra pequeña aplicación y se va a ejecutar cuando ejecutemos un
contenedor basado en esa imagen. Para comprobar que la imagen se ha creado
correctamente, listamos las imagenes, y debería de aparecernos una imagen con
nombre 'app' y tag 'v1':

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen, y vamos a añadir una nueva
opción, -p 8001:8000. Esta opción hará que el puerto interno 8000 del contenedor
sea expuesto en el puerto 8001 de nuestra máquina:

<syntaxhighlight lang="bash">
podman run --name my-app --rm -d -p 8001:8000 app:v1
</syntaxhighlight>

''Nota:'' podman supone que la redirección de puerto es TCP, para una redirección de puertos UDP, puedes usar:

<syntaxhighlight lang="bash">
... -p 8001:8000/udp
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código. En nuestra
máquina haremos:

<syntaxhighlight lang="bash">
curl -X GET http://localhost:8001/welcome?username=LSO
</syntaxhighlight>

Comprobaremos que la salida del comando curl, es "Welcome LSO".

Antes de terminar, vamos a comprobar otro pequeño detalle que añadimos en
nuestra imagen, la variable de entorno USERNAME, vamos a comprobar que funciona:

<syntaxhighlight lang="bash">
podman exec -ti my-app ash
echo $USERNAME
</syntaxhighlight>

Funciona correctamente, pero al ejecutar el contenedor, podemos cambiar esta
variable de entorno como vimos en uno de los pasos anteriores:

<syntaxhighlight lang="bash">
podman run --rm -ti -e USERNAME=me app:v1 ash
echo $USERNAME
</syntaxhighlight>

Esto nos servirá para tener opciones por defecto y que el usuario pueda
cambiarlo a su antojo, como por ejemplo contraseñas u otros detalles.

= Paso 12: Eliminar imágenes =

Para borrar una imagen, puede hacer:

<syntaxhighlight lang="bash">
podman image rm hello-world
</syntaxhighlight>

= Paso 13: Ejercicios =

== Ejercicio 1: Image derivada de Debian con el programa sl ==

Lance un contenedor a partir de una imagen de Debian, instale el programa sl, ejecute sl (desde fuera del contenedor) y detenga el contenedor.

== Ejercicio 2 ==

== Ejercicio 3: Variante de httpd ==

Construya una imagen ''httpd-hola-mundo'' a partir de la imagen ''httpd''. El fichero de index.html de la carpeta htdocs/ tiene que mostrar el mensaje "hola mundo".

<syntaxhighlight lang="bash">
podman pull httpd
</syntaxhighlight>

Edita el fichero Dockerfile:

<syntaxhighlight lang="bash">
nano Dockerfile
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
FROM httpd

COPY index.html htdocs/index.html
</syntaxhighlight>

Edita el fichero index.html:

<syntaxhighlight lang="bash">
nano index.html
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

Construye la imagen:

<syntaxhighlight lang="bash">
podman build -t mihttpd -f Dockerfile .
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen:

<syntaxhighlight lang="bash">
podman run --name mihttpd -d -p 8080:80 mihttpd
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código:
<syntaxhighlight lang="bash">
curl -X GET http://localhost:8080
</syntaxhighlight>

Tiene que salir por pantalla esto:
<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

== Ejercicio 4: aplicación flask ==

Flask es un framework python para implementar webs. Cree una imagen "miapp-flask" a partir de la imagen de "python":

* Instale flask mediante: pip install flask
* Cree la carpeta "app"
* Establezca la variable FLASK_APP a "hello.py"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"

El fichero hello.py contiene un "hola mundo" para Flask:

<syntaxhighlight lang="python">
from flask import Flask
app = Flask(__name__)

@app.route("/")
def hello():
return "Hello World!"

if __name__ == "__main__":
app.run()
</syntaxhighlight>

Solución con alpine:

<syntaxhighlight lang="bash">
FROM python:alpine

RUN mkdir /app
RUN pip install flask
ENV FLASK_APP="app/hello.py"
COPY hello.py
WORKDIR /
CMD flask run --host=0.0.0.0
</syntaxhighlight>

Solución con Ubuntu:

<syntaxhighlight lang="bash">
FROM ubuntu:bionic

RUN apt-get update
RUN apt-get -y install python python-pip wget
RUN pip install Flask
ENV FLASK_APP="app/hello.py"
RUN mkdir /app
COPY hello.py /app
CMD flask run --host=0.0.0.0
</syntaxhighlight>

== Ejercicio 5: mysql ==

'''EN LA MÁQUINA VIRTUAL:'''

mkdir miapp
cd miapp
podman pull mysql
nano Dockerfile

<syntaxhighlight lang="bash">
FROM mysql
ENV MYSQL_ROOT_PASSWORD="lacontraseñaqueyoquiera"
RUN mkdir /app
WORKDIR /app

</syntaxhighlight>

CTRL+O , ENTER Y CTRL+X (para guardar Dockerfile y salir)

podman build -ti mrfdocker -f Dockerfile .
podman run --name mymrf --rm -p 8001:3306 mrfdocker
docker images

'''EN LA TERMINAL DEL HOST:'''

''Instalación de mysql:''

apt install mysql-client-core-5.7
apt-get install mysql-server
service mysql start

''Para entrar:''

mysql -u root -p -P 8001

Una vez dentro de msql:

mysql> show databases;

''Para salir:''

exit

== Ejercicio 6: python pyramid ==

Pyramid es un framework python para implementar webs. Cree una imagen "miapp-pyramid":

* Emplee la imagen de debian como referencia, instale los paquetes python3 y python3-pyramid.
* Cree la carpeta "app"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"
* La aplicación se lanza con la orden: python hello.py
* Compruebe que funciona con curl, la ruta a la web es http://127.0.0.1:8000/hello, suponiendo que ha empleado el puerto 8000 para exponer el servicio.

El fichero hello.py contiene un "hola mundo" para Pyramid:

<syntaxhighlight lang="bash">
from wsgiref.simple_server import make_server
from pyramid.config import Configurator
from pyramid.response import Response

def hello_world(request):
print('Request inbound!')
return Response('Podman works with Pyramid!')

if __name__ == '__main__':
config = Configurator()
config.add_route('hello', '/')
config.add_view(hello_world, route_name='hello')
app = config.make_wsgi_app()
server = make_server('0.0.0.0', 6543, app)
server.serve_forever()
</syntaxhighlight>

Este programa recibe peticiones en el puerto 6543.

== Ejercicio 7 ==

Cree una imagen derivada de Ubuntu, instale el paquete apache2, php y libapache2-mod-php.
Active el módulo de php para apache2 mediante la orden:

<syntaxhighlight lang="bash">
a2enmod php
</syntaxhighlight>

Cree la carpeta /var/www/php.

Cree el fichero index.php

<syntaxhighlight lang="php">
<?php
Print "Hello, World!";
?>
</syntaxhighlight>

y copielo a /var/www/php/.

Cree el fichero 000-default.conf y copielo a /etc/apache2/sites-enabled/

Dicho fichero contiene.

<syntaxhighlight lang="bash">
<VirtualHost *:80>
DocumentRoot /var/www/php

<Directory /var/www/php/>
Options Indexes FollowSymLinks MultiViews
AllowOverride All
Order deny,allow
Allow from all
</Directory>

ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>
</syntaxhighlight>

Tiene que lanzar apache con la orden: apachectl -D FOREGROUND

Tras crear la imagen, láncela mapeando el puerto 8888 al 80, pruebe que puede acceder a http://127.0.0.1:8888/php/ mediante curl

Solución:

<syntaxhighlight lang="bash">
FROM ubuntu:latest

RUN apt-get update
RUN apt-get install -y tzdata
RUN apt-get install -y apache2
RUN apt-get install -y php
RUN apt-get install -y libapache2-mod-php
RUN a2enmod php7.2
COPY index.php /var/www/php
COPY 000-default.conf /etc/apache2/sites-enabled/
CMD apachectl -D FOREGROUND
</syntaxhighlight>

Y para lanzarlo:

podman run --name my-app --rm -d -p 8001:8000 app:v1

y para probarlo:

curl -X GET http://127.0.0.1:8888/php/

== Ejercicio 8 ==

Instale el paquete ''netcat-traditional'' en una imagen de contenedor de ''ubuntu''. Lance la orden:

nc -u -l -p 8080

en el contenedor. Asegúrese de crear una redirección de puertos de 9999 desde el ''host'' al puerto 8080 en el contenedor.

Desde fuera del contenedor, pruebe a conectarse con:

nc -u 127.0.0.1 9999

== Ejercicio 9 ==

Cree una imagen derivada de "ubuntu" con un Dockerfile que incluya soporte de python y lance el siguiente código en Python:

<syntaxhighlight lang="python">
from http.server import BaseHTTPRequestHandler, HTTPServer
import time

hostName = "0.0.0.0"
serverPort = 8080

class MyServer(BaseHTTPRequestHandler):
def do_GET(self):
self.send_response(200)
self.send_header("Content-type", "text/html")
self.end_headers()
self.wfile.write(bytes("<html><head><title>Welcome!</title></head>", "utf-8"))
self.wfile.write(bytes("<body>", "utf-8"))
self.wfile.write(bytes("This is an example web server.", "utf-8"))
self.wfile.write(bytes("</body></html>", "utf-8"))

if __name__ == "__main__":
webServer = HTTPServer((hostName, serverPort), MyServer)
print("Server started http://%s:%s" % (hostName, serverPort))

try:
webServer.serve_forever()
except KeyboardInterrupt:
pass

webServer.server_close()
print("Server stopped.")
</syntaxhighlight>

Llame a su imagen "python-http-server". Lance una instancia de la imagen "python-http-server" mapeando el puerto 9999 al puerto 8888/tcp del contenedor. Compruebe con:

<syntaxhighlight lang="bash">
curl http://127.0.0.1:9999/
</syntaxhighlight>

que muestre la página HTML que ofrece el servidor, que debería ser:

<syntaxhighlight lang="bash">
<html><head><title>Welcome!</title></head><body>This is an example web server.</body></html>
</syntaxhighlight>

== Anexo ==

* Cómo usar [[Podman compose]]

Virtualización con libvirt

2025-12-15T23:55:22Z

Pneira: /* Paso 3: Creación de máquina virtual */

Para la realización de esta práctica necesitará de una imagen de Debian Cloud que descargaremos de https://cloud.debian.org

En esta práctica se empleará la imagen descargada de la web Debian Cloud y se hará uso de la herramienta '''virt-customize''' para configurarla.

A continuación, utilizaremos la imagen de Debian ya configurada para ser importada al software de virtualización '''libvirt'''.

= Paso 1: Descarga de la imagen Cloud =

Entramos en http://cloud.debian.org/images/cloud/ y descargamos la imagen de Debian 13.

Puedes descargarla directamente con la orden ''wget'':

<syntaxhighlight lang="bash">
wget https://cloud.debian.org/images/cloud/trixie/latest/debian-13-generic-amd64.qcow2
</syntaxhighlight>

si comenzó a descargar verás una salida similar a esta:

<syntaxhighlight lang="bash">
-2019-08-06 12:26:26-- https://cloud.debian.org/images/cloud/trixie/latest/debian-13-generic-amd64.qcow2
Resolviendo cloud.debian.org (cloud.debian.org)... 91.189.88.89, 2001:67c:1560:8001::8001
Conectando con cloud.debian.org (cloud.debian.org)[91.189.88.89]:443... conectado.
Petición HTTP enviada, esperando respuesta... 200 OK
Longitud: 343474176 (328M) [application/octet-stream]
Grabando a: “debian-13-generic-amd64.qcow2”

debian-13-generic-amd64.qcow2. 0%[ ] 2,21M 472KB/s eta 14m 6s
</syntaxhighlight>

Espera hasta que la imagen esté descargada al 100%.

La imagen de Debian cloud viene con 2 GBytes de espacio por defecto, puedes ampliar el tamaño con la siguiente orden antes de usarla en la máquina virtual:

<syntaxhighlight lang="bash">
qemu-img resize debian-13-generic-amd64.qcow2 +8G
</syntaxhighlight>

Esto aumenta en 8 Gbytes la imagen, por tanto, quedas con una unidad virtual de almacenamiento de 10 GBytes.

= Paso 2: Configuración de la imagen cloud con virt-customize =

La orden ''virt-customize'' permite establecer la contraseña del usuario administrador de la imagen que hemos descargado.

<syntaxhighlight lang="bash">
virt-customize -a debian-13-generic-amd64.qcow2 --root-password password:coolpass --hostname servidor
</syntaxhighlight>

El ejemplo anterior muestra cómo configurar la imagen descargada para que disponga del usuario ''root'', y en este caso, la contraseña es ''coolpass''.

= Paso 3: Creación de máquina virtual =

Para crear una máquina virtual con libvirt, tienes que hacer uso de ''virt-install'':

<syntaxhighlight lang="bash">
virt-install --name mi-mv --memory 1024 --disk path=/home/usuario/debian-13-generic-amd64.qcow2 --network network=default --os-variant generic --import
</syntaxhighlight>

En la orden anterior:

* Se crea una máquina virtual denominada ''mi-mv''
* La memoria de la máquina virtual es de 1 GByte (1024 Mbytes)
* El ''--disk path'' indica la ruta a la imagen Cloud
* Se usa la configuración de red por defecto.
* Se especifica que la variante de sistema operativo genérico
* Se indica que se trata de una importación de una imagen con un sistema operativo ya instalado mediante ''--import''
* Por defecto emplea 1 CPU virtual, lo que es suficiente. Opcionalmente, puede indicar ''--vcpus=NUM'' donde NUM es el número de CPUs para su máquina virtual.

'''Recuerde modificar el nombre de la máquina virtual ''mi-mv'' y actualizar la ruta a la imagen Cloud que ha descargado en el paso anterior'''.

Tras invocar este lo cual le aparecerá la pantalla de la máquina virtual en una ventana, puede salir de la pantalla al pulsar sobre "File -> Quit".

= Paso 4: Acceso y gestión de la máquina virtual =

El comando ''virt-install'' lanza inicialmente el programa ''virt-viewer'' siempre que haya iniciado la sesión mediante ''ssh'' con la opción -X.

Para volver acceder al teclado y pantalla de la máquina virtual en cualquier momento mediante el siguiente programa:

<syntaxhighlight lang="bash">
virt-viewer mi-mv &
</syntaxhighlight>

NOTA: Si observa un mensaje de error que indica "Cannot open display" significa que no ha iniciado sesión con ''ssh -X''.

Para parar la máquina virtual:

<syntaxhighlight lang="bash">
virsh shutdown mi-mv
</syntaxhighlight>

Para listar las máquinas virtuales existentes y comprobar su estado:

<syntaxhighlight lang="bash">
virsh list --all
</syntaxhighlight>

Puede usar ''grep'' para localizar su máquina virtual y mostrar el estado en el que está.

<syntaxhighlight lang="bash">
virsh list --all | grep mi-mv
</syntaxhighlight>

Para lanzar una máquina virtual apagada, puede usar:

<syntaxhighlight lang="bash">
virsh start mi-mv
</syntaxhighlight>

Si necesita borrar una máquina virtual completamente (previamente apagada), puede hacerlo con:

<syntaxhighlight lang="bash">
virsh undefine mi-mv
</syntaxhighlight>

tras los cual ya no aparecerá en el listado de ''virsh list --all''.

= Paso 5: Ampliación de tamaño de la imagen Cloud =

En el Paso 1 se amplió la unidad virtual de almacenamiento a 10 Gbytes mediante ''qemu-img''.

En '''Debian 12''' hay que hacer un paso más para completar la ampliación, desde '''dentro de la máquina virtual''', hay que extender la partición para que ocupe todo el tamaño de la unidad virtual de almacenamiento:

<syntaxhighlight lang="bash">
growpart /dev/sda 1
</syntaxhighlight>

Tras esto, hay que extender el sistema de ficheros que está en dicha partición:

<syntaxhighlight lang="bash">
resize2fs /dev/sda1
</syntaxhighlight>

Con esto puedes comprobar que el sistema de ficheros es de 10 Gbytes, con la utilidad ''df'':

<syntaxhighlight lang="bash">
df -h
</syntaxhighlight>

NOTA: En Debian 13 este paso no es necesario.

= Paso 6: Configuración del teclado en la imagen Cloud =

Por defecto, la imagen cloud viene con el teclado en inglés americano.

Puedes cambiarlo con la siguiente orden:

<syntaxhighlight lang="bash">
apt install kbd
</syntaxhighlight>

Y seleccione "Other", después busque "Spanish". En general, deje lo preseleccionado para opciones que no entienda, solo cambien el idioma.

Si se equivoca en la selección de los menús, lo puede solucionar de esta manera:

<syntaxhighlight lang="bash">
dpkg-reconfigure keyboard-configuration
service keyboard-setup restart
</syntaxhighlight>

= Paso 7: Configuración de la red en libvirt =

Antes de ver los detalles de red, vamos a hacer una pequeña diferencia entre las dos ventanas que tenemos abiertas, virt-manager principal y virt-manager máquina virtual ejecutándose. En la primera tendremos las configuraciones generales y en la segunda tendremos las configuraciones de una máquina virtual concreta, en nuestro caso, la configuración de la máquina virtual.

Con esto, veremos dos formas de saber la IP de nuestra máquina virtual:

# En la ventana de nuestra máquina virtual, vamos a cambiar la vista y ver los detalles de nuestra máquina. ''Vista --> Detalles''. Aquí tenemos toda la configuración de nuestra máquina, pero solo vamos a centrarnos en la Interfaz de red virtual, que es donde podremos ver cual es pa IP que tiene asiganada nuestra máquina y cual es la fuente de red que se está utilizando. [[Archivo:virt-manager-nic.png|thumb|Interfaz de red virtual.]]
# La otra opción es utilizando comandos, podemos utilizar ''ip address'' en la consola de nuestra máquina virtual.

<syntaxhighlight lang="bash">
# ip address
1: lo: <LOOPBACK,UP,LOWER_UP> mtu 65536 qdisc noqueue state UNKNOWN group default qlen 1000
link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00
inet 127.0.0.1/8 scope host lo
valid_lft forever preferred_lft forever
inet6 ::1/128 scope host
valid_lft forever preferred_lft forever
2: ens3: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc pfifo_fast state UP group default qlen 1000
link/ether 3d:f0:ee:49:aa:22 brd ff:ff:ff:ff:ff:ff
inet 192.168.100.168/24 brd 192.168.2.255 scope global eth0
valid_lft forever preferred_lft forever
inet6 fe80::3e97:eff:fe39:dd20/64 scope link
valid_lft forever preferred_lft forever
</syntaxhighlight>

Que nos permite comprobar que estamos utilizando la dirección IP 192.168.100.168.

Si la interfaz no muestra una dirección IP, puedes forzar la obtención de una dirección IP desde la máquina virtual para la interfaz ''ens3'' con la orden:

<syntaxhighlight lang="bash">
dhcpcd ens3
</syntaxhighlight>

NOTA: Si usa la imagen cloud de Debian 12, entonces tiene que usar ''dhclient'' en lugar de ''dhcpcd'':

<syntaxhighlight lang="bash">
dhclient ens3
</syntaxhighlight>

Vamos a comprobar ahora desde un terminal en el anfitrión que alcanzamos a nuestra máquina virtual.

<syntaxhighlight lang="bash">
ping 9.9.9.9
</syntaxhighlight>

Deberíamos de ver una salida similar a la siguiente:

<syntaxhighlight lang="bash">
PING 192.168.100.168 (192.168.100.168) 56(84) bytes of data.
64 bytes from 192.168.100.168: icmp_seq=1 ttl=64 time=0.397 ms
64 bytes from 192.168.100.168: icmp_seq=2 ttl=64 time=0.409 ms
64 bytes from 192.168.100.168: icmp_seq=3 ttl=64 time=0.321 ms
</syntaxhighlight>

Puede pararlo con ctrl-C.

Compruebe también que la resolución de nombre funciona adecuadamente, mediante:

<syntaxhighlight lang="bash">
ping www.us.es
</syntaxhighligh>

Si hubiere algún problema de conectividad la salida sería de este tipo:

<syntaxhighlight lang="bash">
PING 192.168.100.168 (192.168.100.168) 56(84) bytes of data.
From 192.168.100.1 icmp_seq=1 Destination Host Unreachable
From 192.168.100.1 icmp_seq=2 Destination Host Unreachable
From 192.168.100.1 icmp_seq=3 Destination Host Unreachable
</syntaxhighlight>

En dicho caso, puedes forzar la obtención de una dirección IP con la orden:

<syntaxhighlight lang="bash">
dhcpcd ens3
</syntaxhighlight>

Esto quiere decir que la configuración de red es incorrecta, o quizás que la dirección IP de tu máquina virtual no es 192.168.100.168 :-).

Esta configuración de red es efímera, en el siguiente reinicio de la máquina virtual tendrá que invocar a ''dhcpcd''.

Para realizar la configuración de manera permanente, puede configurar ''netplan'' para que la máquina virtual obtenga IP por DHCP automáticamente en tiempo de arranque con la siguiente configuración en ''/etc/netplan/ens3.yaml''.

<syntaxhighlight lang="bash">
network:
version: 2
renderer: networkd
ethernets:
ens3:
dhcp4: true
</syntaxhighlight>

Para evitar un mensaje de ''WARNING'', asegúrese de que el fichero tiene los permisos adecuados:

<syntaxhighlight lang="bash">
chmod 600 /etc/netplan/ens3.yaml
</syntaxhighlight>

tras crear este fichero, puedes aplicar los cambios con:

<syntaxhighlight lang="bash">
netplan apply
</syntaxhighlight>

Dispones de más información suplementaria sobre la [[configuración de red en libvirt]].

= Paso 8: Activación del servicio de ssh =

Para configurar el servicio de ssh en su máquina virtual, pare su máquina virtual:

<syntaxhighlight lang="bash">
virsh shutdown mi-mv
</syntaxhighlight>

Genere un par de claves pública y privada desde su cuenta del servidor de la asignatura:

<syntaxhighlight lang="bash">
ssh-keygen
</syntaxhighlight>

Para consultar la clave pública generada:

<syntaxhighlight lang="bash">
cat ~/.ssh/id_rsa.pub
</syntaxhighlight>

Configure de nuevo la imagen cloud con ''virt-customize'' haciendo uso de la opción ''--ssh-inject'':

<syntaxhighlight lang="bash">
virt-customize -a debian-13-generic-amd64.qcow2 --root-password password:coolpass --ssh-inject root:string:"ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEAr8IhH+eH3FAq+gKqPvDazeU5QOGMty3NJlP1Oqt6XZkZvJsEXAMPLEkeyFa2IJfjL9SlQXs1vxB7ivj4AGz4sWkvgNvP1OFHHyGkEw== user@example.com"
</syntaxhighlight>

donde la cadena entre comillas que comienza por ''ssh-rsa'' se trata del contenido de su fichero ''.ssh/id_rsa.pub''.

Ahora, volvemos a lanzar la máquina virtual:

<syntaxhighlight lang="bash">
virsh start mi-mv
</syntaxhighlight>

Accedemos a ella mediante ''virt-viewer'':

<syntaxhighlight lang="bash">
virt-viewer mi-mv
</syntaxhighlight>

'''Desde dentro de la máquina virtual''', creamos las claves pública y privadas del servidor:

<syntaxhighlight lang="bash">
ssh-keygen -A
</syntaxhighlight>

Tras esto, puede activar el servicio de ''ssh'':

<syntaxhighlight lang="bash">
systemctl enable --now ssh
</syntaxhighlight>

Puede comprobar el estado del servicio mediante:

<syntaxhighlight lang="bash">
systemctl status ssh
</syntaxhighlight>

Para comprobar que funciona correctamente, desde la sesión ssh del servidor de la asignatura:

<syntaxhighlight lang="bash">
ssh root@10.141.28.25
</syntaxhighlight>

Donde tiene que reemplazar ''10.141.28.25'' por la IP de su máquina virtual.

= Paso 9: Clonado de máquinas virtuales =

Vamos a reutilizar la configuración y la máquina virtual creada, para crear varias iguales. Empecemos:

# Apagamos la máquina virtual si la tenemos encendida, para que nos permita hacer un clonado. ''Máquina virtual --> Apagar --> Apagar''
# En la ventana principal, pulsar botón derecho encima de la máquina virtual que queramos clonar, y pulsar ''Clonar ...''
# En la ventana que nos aparece, por defecto seleccionará la misma red y creará una MAC diferente para la nueva máquina y clonará la imagen que usamos de almacenamiento. Le damos un nuevo nombre a nuestra máquina, y pulsamos en ''Clonar''.
# Repetimos este paso hasta que tengamos toda las máquinas virtuales deseadas, en nuestro caso, solo crearemos una para probar los detalles de red.

Ahora arrancaremos la máquina original y la clonada, y vamos a comprobar que ambas están en la misma red y que pueden verse entre ellas. Como comentamos en el paso anterior, comprobaremos la IP de la máquina virtual original y de la clonada, y haremos ping desde dentro de las máquinas para comprobar que se ven.

Es posible clonar una máquina virtual desde el intérprete de órdenes:

<syntaxhighlight lang="bash">
virt-clone --original mi-mv --name mi-mv-clone --auto-clone
</syntaxhighlight>

Ejemplo:

* Máquina original tiene IP 192.168.100.168
* Máquina clonada tiene IP 192.168.100.169
* Desde la máquina original haremos un ping 192.168.100.169
* Desde la máquina clonada haremos un ping 192.168.100.168
* Desde ambas máquinas, comprobaremos que la puerta de enlace es la misma, haciendo un ''ip route''.
* Desde la máquina host, deberíamos de obtener ping hacía las dos máquinas

= Paso 10: Instantáneas de máquinas virtuales =

Las instantáneas nos permiten almacenar una captura del estado de la ejecución de una máquina virtual en un cierto instante tiempo que podremos restaurar cuando sea necesario. Las instantáneas te serán útiles si tienes trabajo a medio hacer en la máquina virtual, de manera que quieras guardar lo que has hecho para restaurarlo posteriormente.

Para crear una instantánea, accedemos a la máquina virtual en ejecución, podemos hacerlo con:

<syntaxhighlight lang="bash">
virsh snapshot-create-as --domain mimv --name snapshot-mimv-131125 --description "mi snapshot de prueba"
</syntaxhighlight>

La creación de instantáneas toma algo de tiempo, sé paciente.

Puedes listar los snapshots disponibles para una máquina virtual en:

<syntaxhighlight lang="bash">
virsh snapshot-list mimv
</syntaxhighlight>

Puedes resturar un snapshot mediante:

<syntaxhighlight lang="bash">
virsh snapshot-revert mimv snapshot-mimv-131125
</syntaxhighlight>

Puedes almacenar tantas instantáneas como quieras. El nombre ''Captura de pantalla'' es una traducción poco afortunada del inglés ''snapshot'' que se refiere al término ''instantánea''.

= Material complementario =

Además, existe [[material complementario sobre libvirt]] que no es parte del contenido del examen pero que podría ser de su interés.

Virtualización con libvirt

2025-12-15T23:54:12Z

Pneira: /* Paso 3: Creación de máquina virtual */

Para la realización de esta práctica necesitará de una imagen de Debian Cloud que descargaremos de https://cloud.debian.org

En esta práctica se empleará la imagen descargada de la web Debian Cloud y se hará uso de la herramienta '''virt-customize''' para configurarla.

A continuación, utilizaremos la imagen de Debian ya configurada para ser importada al software de virtualización '''libvirt'''.

= Paso 1: Descarga de la imagen Cloud =

Entramos en http://cloud.debian.org/images/cloud/ y descargamos la imagen de Debian 13.

Puedes descargarla directamente con la orden ''wget'':

<syntaxhighlight lang="bash">
wget https://cloud.debian.org/images/cloud/trixie/latest/debian-13-generic-amd64.qcow2
</syntaxhighlight>

si comenzó a descargar verás una salida similar a esta:

<syntaxhighlight lang="bash">
-2019-08-06 12:26:26-- https://cloud.debian.org/images/cloud/trixie/latest/debian-13-generic-amd64.qcow2
Resolviendo cloud.debian.org (cloud.debian.org)... 91.189.88.89, 2001:67c:1560:8001::8001
Conectando con cloud.debian.org (cloud.debian.org)[91.189.88.89]:443... conectado.
Petición HTTP enviada, esperando respuesta... 200 OK
Longitud: 343474176 (328M) [application/octet-stream]
Grabando a: “debian-13-generic-amd64.qcow2”

debian-13-generic-amd64.qcow2. 0%[ ] 2,21M 472KB/s eta 14m 6s
</syntaxhighlight>

Espera hasta que la imagen esté descargada al 100%.

La imagen de Debian cloud viene con 2 GBytes de espacio por defecto, puedes ampliar el tamaño con la siguiente orden antes de usarla en la máquina virtual:

<syntaxhighlight lang="bash">
qemu-img resize debian-13-generic-amd64.qcow2 +8G
</syntaxhighlight>

Esto aumenta en 8 Gbytes la imagen, por tanto, quedas con una unidad virtual de almacenamiento de 10 GBytes.

= Paso 2: Configuración de la imagen cloud con virt-customize =

La orden ''virt-customize'' permite establecer la contraseña del usuario administrador de la imagen que hemos descargado.

<syntaxhighlight lang="bash">
virt-customize -a debian-13-generic-amd64.qcow2 --root-password password:coolpass --hostname servidor
</syntaxhighlight>

El ejemplo anterior muestra cómo configurar la imagen descargada para que disponga del usuario ''root'', y en este caso, la contraseña es ''coolpass''.

= Paso 3: Creación de máquina virtual =

Para crear una máquina virtual con libvirt, tienes que hacer uso de ''virt-install'':

<syntaxhighlight lang="bash">
virt-install --name mi-mv --memory 1024 --disk path=/home/usuario/debian-13-generic-amd64.qcow2 --network network=default --os-variant generic --import
</syntaxhighlight>

En la orden anterior:

* Se crea una máquina virtual denominada ''mi-mv''
* La memoria de la máquina virtual es de 1 GByte (1024 Mbytes)
* El ''--disk path'' indica la ruta a la imagen Cloud
* Se usa la configuración de red por defecto.
* Se especifica que la variante de sistema operativo genérico
* Se indica que se trata de una importación de una imagen con un sistema operativo ya instalado mediante ''--import''
* Opcionalmente, puede indicar ''--vcpus=NUM'' donde NUM es el número de CPUs para su máquina virtual.

'''Recuerde modificar el nombre de la máquina virtual ''mi-mv'' y actualizar la ruta a la imagen Cloud que ha descargado en el paso anterior'''.

Tras invocar este lo cual le aparecerá la pantalla de la máquina virtual en una ventana, puede salir de la pantalla al pulsar sobre "File -> Quit".

= Paso 4: Acceso y gestión de la máquina virtual =

El comando ''virt-install'' lanza inicialmente el programa ''virt-viewer'' siempre que haya iniciado la sesión mediante ''ssh'' con la opción -X.

Para volver acceder al teclado y pantalla de la máquina virtual en cualquier momento mediante el siguiente programa:

<syntaxhighlight lang="bash">
virt-viewer mi-mv &
</syntaxhighlight>

NOTA: Si observa un mensaje de error que indica "Cannot open display" significa que no ha iniciado sesión con ''ssh -X''.

Para parar la máquina virtual:

<syntaxhighlight lang="bash">
virsh shutdown mi-mv
</syntaxhighlight>

Para listar las máquinas virtuales existentes y comprobar su estado:

<syntaxhighlight lang="bash">
virsh list --all
</syntaxhighlight>

Puede usar ''grep'' para localizar su máquina virtual y mostrar el estado en el que está.

<syntaxhighlight lang="bash">
virsh list --all | grep mi-mv
</syntaxhighlight>

Para lanzar una máquina virtual apagada, puede usar:

<syntaxhighlight lang="bash">
virsh start mi-mv
</syntaxhighlight>

Si necesita borrar una máquina virtual completamente (previamente apagada), puede hacerlo con:

<syntaxhighlight lang="bash">
virsh undefine mi-mv
</syntaxhighlight>

tras los cual ya no aparecerá en el listado de ''virsh list --all''.

= Paso 5: Ampliación de tamaño de la imagen Cloud =

En el Paso 1 se amplió la unidad virtual de almacenamiento a 10 Gbytes mediante ''qemu-img''.

En '''Debian 12''' hay que hacer un paso más para completar la ampliación, desde '''dentro de la máquina virtual''', hay que extender la partición para que ocupe todo el tamaño de la unidad virtual de almacenamiento:

<syntaxhighlight lang="bash">
growpart /dev/sda 1
</syntaxhighlight>

Tras esto, hay que extender el sistema de ficheros que está en dicha partición:

<syntaxhighlight lang="bash">
resize2fs /dev/sda1
</syntaxhighlight>

Con esto puedes comprobar que el sistema de ficheros es de 10 Gbytes, con la utilidad ''df'':

<syntaxhighlight lang="bash">
df -h
</syntaxhighlight>

NOTA: En Debian 13 este paso no es necesario.

= Paso 6: Configuración del teclado en la imagen Cloud =

Por defecto, la imagen cloud viene con el teclado en inglés americano.

Puedes cambiarlo con la siguiente orden:

<syntaxhighlight lang="bash">
apt install kbd
</syntaxhighlight>

Y seleccione "Other", después busque "Spanish". En general, deje lo preseleccionado para opciones que no entienda, solo cambien el idioma.

Si se equivoca en la selección de los menús, lo puede solucionar de esta manera:

<syntaxhighlight lang="bash">
dpkg-reconfigure keyboard-configuration
service keyboard-setup restart
</syntaxhighlight>

= Paso 7: Configuración de la red en libvirt =

Antes de ver los detalles de red, vamos a hacer una pequeña diferencia entre las dos ventanas que tenemos abiertas, virt-manager principal y virt-manager máquina virtual ejecutándose. En la primera tendremos las configuraciones generales y en la segunda tendremos las configuraciones de una máquina virtual concreta, en nuestro caso, la configuración de la máquina virtual.

Con esto, veremos dos formas de saber la IP de nuestra máquina virtual:

# En la ventana de nuestra máquina virtual, vamos a cambiar la vista y ver los detalles de nuestra máquina. ''Vista --> Detalles''. Aquí tenemos toda la configuración de nuestra máquina, pero solo vamos a centrarnos en la Interfaz de red virtual, que es donde podremos ver cual es pa IP que tiene asiganada nuestra máquina y cual es la fuente de red que se está utilizando. [[Archivo:virt-manager-nic.png|thumb|Interfaz de red virtual.]]
# La otra opción es utilizando comandos, podemos utilizar ''ip address'' en la consola de nuestra máquina virtual.

<syntaxhighlight lang="bash">
# ip address
1: lo: <LOOPBACK,UP,LOWER_UP> mtu 65536 qdisc noqueue state UNKNOWN group default qlen 1000
link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00
inet 127.0.0.1/8 scope host lo
valid_lft forever preferred_lft forever
inet6 ::1/128 scope host
valid_lft forever preferred_lft forever
2: ens3: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc pfifo_fast state UP group default qlen 1000
link/ether 3d:f0:ee:49:aa:22 brd ff:ff:ff:ff:ff:ff
inet 192.168.100.168/24 brd 192.168.2.255 scope global eth0
valid_lft forever preferred_lft forever
inet6 fe80::3e97:eff:fe39:dd20/64 scope link
valid_lft forever preferred_lft forever
</syntaxhighlight>

Que nos permite comprobar que estamos utilizando la dirección IP 192.168.100.168.

Si la interfaz no muestra una dirección IP, puedes forzar la obtención de una dirección IP desde la máquina virtual para la interfaz ''ens3'' con la orden:

<syntaxhighlight lang="bash">
dhcpcd ens3
</syntaxhighlight>

NOTA: Si usa la imagen cloud de Debian 12, entonces tiene que usar ''dhclient'' en lugar de ''dhcpcd'':

<syntaxhighlight lang="bash">
dhclient ens3
</syntaxhighlight>

Vamos a comprobar ahora desde un terminal en el anfitrión que alcanzamos a nuestra máquina virtual.

<syntaxhighlight lang="bash">
ping 9.9.9.9
</syntaxhighlight>

Deberíamos de ver una salida similar a la siguiente:

<syntaxhighlight lang="bash">
PING 192.168.100.168 (192.168.100.168) 56(84) bytes of data.
64 bytes from 192.168.100.168: icmp_seq=1 ttl=64 time=0.397 ms
64 bytes from 192.168.100.168: icmp_seq=2 ttl=64 time=0.409 ms
64 bytes from 192.168.100.168: icmp_seq=3 ttl=64 time=0.321 ms
</syntaxhighlight>

Puede pararlo con ctrl-C.

Compruebe también que la resolución de nombre funciona adecuadamente, mediante:

<syntaxhighlight lang="bash">
ping www.us.es
</syntaxhighligh>

Si hubiere algún problema de conectividad la salida sería de este tipo:

<syntaxhighlight lang="bash">
PING 192.168.100.168 (192.168.100.168) 56(84) bytes of data.
From 192.168.100.1 icmp_seq=1 Destination Host Unreachable
From 192.168.100.1 icmp_seq=2 Destination Host Unreachable
From 192.168.100.1 icmp_seq=3 Destination Host Unreachable
</syntaxhighlight>

En dicho caso, puedes forzar la obtención de una dirección IP con la orden:

<syntaxhighlight lang="bash">
dhcpcd ens3
</syntaxhighlight>

Esto quiere decir que la configuración de red es incorrecta, o quizás que la dirección IP de tu máquina virtual no es 192.168.100.168 :-).

Esta configuración de red es efímera, en el siguiente reinicio de la máquina virtual tendrá que invocar a ''dhcpcd''.

Para realizar la configuración de manera permanente, puede configurar ''netplan'' para que la máquina virtual obtenga IP por DHCP automáticamente en tiempo de arranque con la siguiente configuración en ''/etc/netplan/ens3.yaml''.

<syntaxhighlight lang="bash">
network:
version: 2
renderer: networkd
ethernets:
ens3:
dhcp4: true
</syntaxhighlight>

Para evitar un mensaje de ''WARNING'', asegúrese de que el fichero tiene los permisos adecuados:

<syntaxhighlight lang="bash">
chmod 600 /etc/netplan/ens3.yaml
</syntaxhighlight>

tras crear este fichero, puedes aplicar los cambios con:

<syntaxhighlight lang="bash">
netplan apply
</syntaxhighlight>

Dispones de más información suplementaria sobre la [[configuración de red en libvirt]].

= Paso 8: Activación del servicio de ssh =

Para configurar el servicio de ssh en su máquina virtual, pare su máquina virtual:

<syntaxhighlight lang="bash">
virsh shutdown mi-mv
</syntaxhighlight>

Genere un par de claves pública y privada desde su cuenta del servidor de la asignatura:

<syntaxhighlight lang="bash">
ssh-keygen
</syntaxhighlight>

Para consultar la clave pública generada:

<syntaxhighlight lang="bash">
cat ~/.ssh/id_rsa.pub
</syntaxhighlight>

Configure de nuevo la imagen cloud con ''virt-customize'' haciendo uso de la opción ''--ssh-inject'':

<syntaxhighlight lang="bash">
virt-customize -a debian-13-generic-amd64.qcow2 --root-password password:coolpass --ssh-inject root:string:"ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEAr8IhH+eH3FAq+gKqPvDazeU5QOGMty3NJlP1Oqt6XZkZvJsEXAMPLEkeyFa2IJfjL9SlQXs1vxB7ivj4AGz4sWkvgNvP1OFHHyGkEw== user@example.com"
</syntaxhighlight>

donde la cadena entre comillas que comienza por ''ssh-rsa'' se trata del contenido de su fichero ''.ssh/id_rsa.pub''.

Ahora, volvemos a lanzar la máquina virtual:

<syntaxhighlight lang="bash">
virsh start mi-mv
</syntaxhighlight>

Accedemos a ella mediante ''virt-viewer'':

<syntaxhighlight lang="bash">
virt-viewer mi-mv
</syntaxhighlight>

'''Desde dentro de la máquina virtual''', creamos las claves pública y privadas del servidor:

<syntaxhighlight lang="bash">
ssh-keygen -A
</syntaxhighlight>

Tras esto, puede activar el servicio de ''ssh'':

<syntaxhighlight lang="bash">
systemctl enable --now ssh
</syntaxhighlight>

Puede comprobar el estado del servicio mediante:

<syntaxhighlight lang="bash">
systemctl status ssh
</syntaxhighlight>

Para comprobar que funciona correctamente, desde la sesión ssh del servidor de la asignatura:

<syntaxhighlight lang="bash">
ssh root@10.141.28.25
</syntaxhighlight>

Donde tiene que reemplazar ''10.141.28.25'' por la IP de su máquina virtual.

= Paso 9: Clonado de máquinas virtuales =

Vamos a reutilizar la configuración y la máquina virtual creada, para crear varias iguales. Empecemos:

# Apagamos la máquina virtual si la tenemos encendida, para que nos permita hacer un clonado. ''Máquina virtual --> Apagar --> Apagar''
# En la ventana principal, pulsar botón derecho encima de la máquina virtual que queramos clonar, y pulsar ''Clonar ...''
# En la ventana que nos aparece, por defecto seleccionará la misma red y creará una MAC diferente para la nueva máquina y clonará la imagen que usamos de almacenamiento. Le damos un nuevo nombre a nuestra máquina, y pulsamos en ''Clonar''.
# Repetimos este paso hasta que tengamos toda las máquinas virtuales deseadas, en nuestro caso, solo crearemos una para probar los detalles de red.

Ahora arrancaremos la máquina original y la clonada, y vamos a comprobar que ambas están en la misma red y que pueden verse entre ellas. Como comentamos en el paso anterior, comprobaremos la IP de la máquina virtual original y de la clonada, y haremos ping desde dentro de las máquinas para comprobar que se ven.

Es posible clonar una máquina virtual desde el intérprete de órdenes:

<syntaxhighlight lang="bash">
virt-clone --original mi-mv --name mi-mv-clone --auto-clone
</syntaxhighlight>

Ejemplo:

* Máquina original tiene IP 192.168.100.168
* Máquina clonada tiene IP 192.168.100.169
* Desde la máquina original haremos un ping 192.168.100.169
* Desde la máquina clonada haremos un ping 192.168.100.168
* Desde ambas máquinas, comprobaremos que la puerta de enlace es la misma, haciendo un ''ip route''.
* Desde la máquina host, deberíamos de obtener ping hacía las dos máquinas

= Paso 10: Instantáneas de máquinas virtuales =

Las instantáneas nos permiten almacenar una captura del estado de la ejecución de una máquina virtual en un cierto instante tiempo que podremos restaurar cuando sea necesario. Las instantáneas te serán útiles si tienes trabajo a medio hacer en la máquina virtual, de manera que quieras guardar lo que has hecho para restaurarlo posteriormente.

Para crear una instantánea, accedemos a la máquina virtual en ejecución, podemos hacerlo con:

<syntaxhighlight lang="bash">
virsh snapshot-create-as --domain mimv --name snapshot-mimv-131125 --description "mi snapshot de prueba"
</syntaxhighlight>

La creación de instantáneas toma algo de tiempo, sé paciente.

Puedes listar los snapshots disponibles para una máquina virtual en:

<syntaxhighlight lang="bash">
virsh snapshot-list mimv
</syntaxhighlight>

Puedes resturar un snapshot mediante:

<syntaxhighlight lang="bash">
virsh snapshot-revert mimv snapshot-mimv-131125
</syntaxhighlight>

Puedes almacenar tantas instantáneas como quieras. El nombre ''Captura de pantalla'' es una traducción poco afortunada del inglés ''snapshot'' que se refiere al término ''instantánea''.

= Material complementario =

Además, existe [[material complementario sobre libvirt]] que no es parte del contenido del examen pero que podría ser de su interés.

Virtualización con libvirt

2025-12-15T23:53:55Z

Pneira: /* Paso 3: Creación de máquina virtual */

Para la realización de esta práctica necesitará de una imagen de Debian Cloud que descargaremos de https://cloud.debian.org

En esta práctica se empleará la imagen descargada de la web Debian Cloud y se hará uso de la herramienta '''virt-customize''' para configurarla.

A continuación, utilizaremos la imagen de Debian ya configurada para ser importada al software de virtualización '''libvirt'''.

= Paso 1: Descarga de la imagen Cloud =

Entramos en http://cloud.debian.org/images/cloud/ y descargamos la imagen de Debian 13.

Puedes descargarla directamente con la orden ''wget'':

<syntaxhighlight lang="bash">
wget https://cloud.debian.org/images/cloud/trixie/latest/debian-13-generic-amd64.qcow2
</syntaxhighlight>

si comenzó a descargar verás una salida similar a esta:

<syntaxhighlight lang="bash">
-2019-08-06 12:26:26-- https://cloud.debian.org/images/cloud/trixie/latest/debian-13-generic-amd64.qcow2
Resolviendo cloud.debian.org (cloud.debian.org)... 91.189.88.89, 2001:67c:1560:8001::8001
Conectando con cloud.debian.org (cloud.debian.org)[91.189.88.89]:443... conectado.
Petición HTTP enviada, esperando respuesta... 200 OK
Longitud: 343474176 (328M) [application/octet-stream]
Grabando a: “debian-13-generic-amd64.qcow2”

debian-13-generic-amd64.qcow2. 0%[ ] 2,21M 472KB/s eta 14m 6s
</syntaxhighlight>

Espera hasta que la imagen esté descargada al 100%.

La imagen de Debian cloud viene con 2 GBytes de espacio por defecto, puedes ampliar el tamaño con la siguiente orden antes de usarla en la máquina virtual:

<syntaxhighlight lang="bash">
qemu-img resize debian-13-generic-amd64.qcow2 +8G
</syntaxhighlight>

Esto aumenta en 8 Gbytes la imagen, por tanto, quedas con una unidad virtual de almacenamiento de 10 GBytes.

= Paso 2: Configuración de la imagen cloud con virt-customize =

La orden ''virt-customize'' permite establecer la contraseña del usuario administrador de la imagen que hemos descargado.

<syntaxhighlight lang="bash">
virt-customize -a debian-13-generic-amd64.qcow2 --root-password password:coolpass --hostname servidor
</syntaxhighlight>

El ejemplo anterior muestra cómo configurar la imagen descargada para que disponga del usuario ''root'', y en este caso, la contraseña es ''coolpass''.

= Paso 3: Creación de máquina virtual =

Para crear una máquina virtual con libvirt, tienes que hacer uso de ''virt-install'':

<syntaxhighlight lang="bash">
virt-install --name mi-mv --memory 1024 --disk path=/home/usuario/debian-13-generic-amd64.qcow2 --network network=default --os-variant generic --import
</syntaxhighlight>

En la orden anterior:

* Se crea una máquina virtual denominada ''mi-mv''
* La memoria de la máquina virtual es de 2 GBytes (2048 Mbytes)
* El ''--disk path'' indica la ruta a la imagen Cloud
* Se usa la configuración de red por defecto.
* Se especifica que la variante de sistema operativo genérico
* Se indica que se trata de una importación de una imagen con un sistema operativo ya instalado mediante ''--import''
* Opcionalmente, puede indicar ''--vcpus=NUM'' donde NUM es el número de CPUs para su máquina virtual.

'''Recuerde modificar el nombre de la máquina virtual ''mi-mv'' y actualizar la ruta a la imagen Cloud que ha descargado en el paso anterior'''.

Tras invocar este lo cual le aparecerá la pantalla de la máquina virtual en una ventana, puede salir de la pantalla al pulsar sobre "File -> Quit".

= Paso 4: Acceso y gestión de la máquina virtual =

El comando ''virt-install'' lanza inicialmente el programa ''virt-viewer'' siempre que haya iniciado la sesión mediante ''ssh'' con la opción -X.

Para volver acceder al teclado y pantalla de la máquina virtual en cualquier momento mediante el siguiente programa:

<syntaxhighlight lang="bash">
virt-viewer mi-mv &
</syntaxhighlight>

NOTA: Si observa un mensaje de error que indica "Cannot open display" significa que no ha iniciado sesión con ''ssh -X''.

Para parar la máquina virtual:

<syntaxhighlight lang="bash">
virsh shutdown mi-mv
</syntaxhighlight>

Para listar las máquinas virtuales existentes y comprobar su estado:

<syntaxhighlight lang="bash">
virsh list --all
</syntaxhighlight>

Puede usar ''grep'' para localizar su máquina virtual y mostrar el estado en el que está.

<syntaxhighlight lang="bash">
virsh list --all | grep mi-mv
</syntaxhighlight>

Para lanzar una máquina virtual apagada, puede usar:

<syntaxhighlight lang="bash">
virsh start mi-mv
</syntaxhighlight>

Si necesita borrar una máquina virtual completamente (previamente apagada), puede hacerlo con:

<syntaxhighlight lang="bash">
virsh undefine mi-mv
</syntaxhighlight>

tras los cual ya no aparecerá en el listado de ''virsh list --all''.

= Paso 5: Ampliación de tamaño de la imagen Cloud =

En el Paso 1 se amplió la unidad virtual de almacenamiento a 10 Gbytes mediante ''qemu-img''.

En '''Debian 12''' hay que hacer un paso más para completar la ampliación, desde '''dentro de la máquina virtual''', hay que extender la partición para que ocupe todo el tamaño de la unidad virtual de almacenamiento:

<syntaxhighlight lang="bash">
growpart /dev/sda 1
</syntaxhighlight>

Tras esto, hay que extender el sistema de ficheros que está en dicha partición:

<syntaxhighlight lang="bash">
resize2fs /dev/sda1
</syntaxhighlight>

Con esto puedes comprobar que el sistema de ficheros es de 10 Gbytes, con la utilidad ''df'':

<syntaxhighlight lang="bash">
df -h
</syntaxhighlight>

NOTA: En Debian 13 este paso no es necesario.

= Paso 6: Configuración del teclado en la imagen Cloud =

Por defecto, la imagen cloud viene con el teclado en inglés americano.

Puedes cambiarlo con la siguiente orden:

<syntaxhighlight lang="bash">
apt install kbd
</syntaxhighlight>

Y seleccione "Other", después busque "Spanish". En general, deje lo preseleccionado para opciones que no entienda, solo cambien el idioma.

Si se equivoca en la selección de los menús, lo puede solucionar de esta manera:

<syntaxhighlight lang="bash">
dpkg-reconfigure keyboard-configuration
service keyboard-setup restart
</syntaxhighlight>

= Paso 7: Configuración de la red en libvirt =

Antes de ver los detalles de red, vamos a hacer una pequeña diferencia entre las dos ventanas que tenemos abiertas, virt-manager principal y virt-manager máquina virtual ejecutándose. En la primera tendremos las configuraciones generales y en la segunda tendremos las configuraciones de una máquina virtual concreta, en nuestro caso, la configuración de la máquina virtual.

Con esto, veremos dos formas de saber la IP de nuestra máquina virtual:

# En la ventana de nuestra máquina virtual, vamos a cambiar la vista y ver los detalles de nuestra máquina. ''Vista --> Detalles''. Aquí tenemos toda la configuración de nuestra máquina, pero solo vamos a centrarnos en la Interfaz de red virtual, que es donde podremos ver cual es pa IP que tiene asiganada nuestra máquina y cual es la fuente de red que se está utilizando. [[Archivo:virt-manager-nic.png|thumb|Interfaz de red virtual.]]
# La otra opción es utilizando comandos, podemos utilizar ''ip address'' en la consola de nuestra máquina virtual.

<syntaxhighlight lang="bash">
# ip address
1: lo: <LOOPBACK,UP,LOWER_UP> mtu 65536 qdisc noqueue state UNKNOWN group default qlen 1000
link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00
inet 127.0.0.1/8 scope host lo
valid_lft forever preferred_lft forever
inet6 ::1/128 scope host
valid_lft forever preferred_lft forever
2: ens3: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc pfifo_fast state UP group default qlen 1000
link/ether 3d:f0:ee:49:aa:22 brd ff:ff:ff:ff:ff:ff
inet 192.168.100.168/24 brd 192.168.2.255 scope global eth0
valid_lft forever preferred_lft forever
inet6 fe80::3e97:eff:fe39:dd20/64 scope link
valid_lft forever preferred_lft forever
</syntaxhighlight>

Que nos permite comprobar que estamos utilizando la dirección IP 192.168.100.168.

Si la interfaz no muestra una dirección IP, puedes forzar la obtención de una dirección IP desde la máquina virtual para la interfaz ''ens3'' con la orden:

<syntaxhighlight lang="bash">
dhcpcd ens3
</syntaxhighlight>

NOTA: Si usa la imagen cloud de Debian 12, entonces tiene que usar ''dhclient'' en lugar de ''dhcpcd'':

<syntaxhighlight lang="bash">
dhclient ens3
</syntaxhighlight>

Vamos a comprobar ahora desde un terminal en el anfitrión que alcanzamos a nuestra máquina virtual.

<syntaxhighlight lang="bash">
ping 9.9.9.9
</syntaxhighlight>

Deberíamos de ver una salida similar a la siguiente:

<syntaxhighlight lang="bash">
PING 192.168.100.168 (192.168.100.168) 56(84) bytes of data.
64 bytes from 192.168.100.168: icmp_seq=1 ttl=64 time=0.397 ms
64 bytes from 192.168.100.168: icmp_seq=2 ttl=64 time=0.409 ms
64 bytes from 192.168.100.168: icmp_seq=3 ttl=64 time=0.321 ms
</syntaxhighlight>

Puede pararlo con ctrl-C.

Compruebe también que la resolución de nombre funciona adecuadamente, mediante:

<syntaxhighlight lang="bash">
ping www.us.es
</syntaxhighligh>

Si hubiere algún problema de conectividad la salida sería de este tipo:

<syntaxhighlight lang="bash">
PING 192.168.100.168 (192.168.100.168) 56(84) bytes of data.
From 192.168.100.1 icmp_seq=1 Destination Host Unreachable
From 192.168.100.1 icmp_seq=2 Destination Host Unreachable
From 192.168.100.1 icmp_seq=3 Destination Host Unreachable
</syntaxhighlight>

En dicho caso, puedes forzar la obtención de una dirección IP con la orden:

<syntaxhighlight lang="bash">
dhcpcd ens3
</syntaxhighlight>

Esto quiere decir que la configuración de red es incorrecta, o quizás que la dirección IP de tu máquina virtual no es 192.168.100.168 :-).

Esta configuración de red es efímera, en el siguiente reinicio de la máquina virtual tendrá que invocar a ''dhcpcd''.

Para realizar la configuración de manera permanente, puede configurar ''netplan'' para que la máquina virtual obtenga IP por DHCP automáticamente en tiempo de arranque con la siguiente configuración en ''/etc/netplan/ens3.yaml''.

<syntaxhighlight lang="bash">
network:
version: 2
renderer: networkd
ethernets:
ens3:
dhcp4: true
</syntaxhighlight>

Para evitar un mensaje de ''WARNING'', asegúrese de que el fichero tiene los permisos adecuados:

<syntaxhighlight lang="bash">
chmod 600 /etc/netplan/ens3.yaml
</syntaxhighlight>

tras crear este fichero, puedes aplicar los cambios con:

<syntaxhighlight lang="bash">
netplan apply
</syntaxhighlight>

Dispones de más información suplementaria sobre la [[configuración de red en libvirt]].

= Paso 8: Activación del servicio de ssh =

Para configurar el servicio de ssh en su máquina virtual, pare su máquina virtual:

<syntaxhighlight lang="bash">
virsh shutdown mi-mv
</syntaxhighlight>

Genere un par de claves pública y privada desde su cuenta del servidor de la asignatura:

<syntaxhighlight lang="bash">
ssh-keygen
</syntaxhighlight>

Para consultar la clave pública generada:

<syntaxhighlight lang="bash">
cat ~/.ssh/id_rsa.pub
</syntaxhighlight>

Configure de nuevo la imagen cloud con ''virt-customize'' haciendo uso de la opción ''--ssh-inject'':

<syntaxhighlight lang="bash">
virt-customize -a debian-13-generic-amd64.qcow2 --root-password password:coolpass --ssh-inject root:string:"ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEAr8IhH+eH3FAq+gKqPvDazeU5QOGMty3NJlP1Oqt6XZkZvJsEXAMPLEkeyFa2IJfjL9SlQXs1vxB7ivj4AGz4sWkvgNvP1OFHHyGkEw== user@example.com"
</syntaxhighlight>

donde la cadena entre comillas que comienza por ''ssh-rsa'' se trata del contenido de su fichero ''.ssh/id_rsa.pub''.

Ahora, volvemos a lanzar la máquina virtual:

<syntaxhighlight lang="bash">
virsh start mi-mv
</syntaxhighlight>

Accedemos a ella mediante ''virt-viewer'':

<syntaxhighlight lang="bash">
virt-viewer mi-mv
</syntaxhighlight>

'''Desde dentro de la máquina virtual''', creamos las claves pública y privadas del servidor:

<syntaxhighlight lang="bash">
ssh-keygen -A
</syntaxhighlight>

Tras esto, puede activar el servicio de ''ssh'':

<syntaxhighlight lang="bash">
systemctl enable --now ssh
</syntaxhighlight>

Puede comprobar el estado del servicio mediante:

<syntaxhighlight lang="bash">
systemctl status ssh
</syntaxhighlight>

Para comprobar que funciona correctamente, desde la sesión ssh del servidor de la asignatura:

<syntaxhighlight lang="bash">
ssh root@10.141.28.25
</syntaxhighlight>

Donde tiene que reemplazar ''10.141.28.25'' por la IP de su máquina virtual.

= Paso 9: Clonado de máquinas virtuales =

Vamos a reutilizar la configuración y la máquina virtual creada, para crear varias iguales. Empecemos:

# Apagamos la máquina virtual si la tenemos encendida, para que nos permita hacer un clonado. ''Máquina virtual --> Apagar --> Apagar''
# En la ventana principal, pulsar botón derecho encima de la máquina virtual que queramos clonar, y pulsar ''Clonar ...''
# En la ventana que nos aparece, por defecto seleccionará la misma red y creará una MAC diferente para la nueva máquina y clonará la imagen que usamos de almacenamiento. Le damos un nuevo nombre a nuestra máquina, y pulsamos en ''Clonar''.
# Repetimos este paso hasta que tengamos toda las máquinas virtuales deseadas, en nuestro caso, solo crearemos una para probar los detalles de red.

Ahora arrancaremos la máquina original y la clonada, y vamos a comprobar que ambas están en la misma red y que pueden verse entre ellas. Como comentamos en el paso anterior, comprobaremos la IP de la máquina virtual original y de la clonada, y haremos ping desde dentro de las máquinas para comprobar que se ven.

Es posible clonar una máquina virtual desde el intérprete de órdenes:

<syntaxhighlight lang="bash">
virt-clone --original mi-mv --name mi-mv-clone --auto-clone
</syntaxhighlight>

Ejemplo:

* Máquina original tiene IP 192.168.100.168
* Máquina clonada tiene IP 192.168.100.169
* Desde la máquina original haremos un ping 192.168.100.169
* Desde la máquina clonada haremos un ping 192.168.100.168
* Desde ambas máquinas, comprobaremos que la puerta de enlace es la misma, haciendo un ''ip route''.
* Desde la máquina host, deberíamos de obtener ping hacía las dos máquinas

= Paso 10: Instantáneas de máquinas virtuales =

Las instantáneas nos permiten almacenar una captura del estado de la ejecución de una máquina virtual en un cierto instante tiempo que podremos restaurar cuando sea necesario. Las instantáneas te serán útiles si tienes trabajo a medio hacer en la máquina virtual, de manera que quieras guardar lo que has hecho para restaurarlo posteriormente.

Para crear una instantánea, accedemos a la máquina virtual en ejecución, podemos hacerlo con:

<syntaxhighlight lang="bash">
virsh snapshot-create-as --domain mimv --name snapshot-mimv-131125 --description "mi snapshot de prueba"
</syntaxhighlight>

La creación de instantáneas toma algo de tiempo, sé paciente.

Puedes listar los snapshots disponibles para una máquina virtual en:

<syntaxhighlight lang="bash">
virsh snapshot-list mimv
</syntaxhighlight>

Puedes resturar un snapshot mediante:

<syntaxhighlight lang="bash">
virsh snapshot-revert mimv snapshot-mimv-131125
</syntaxhighlight>

Puedes almacenar tantas instantáneas como quieras. El nombre ''Captura de pantalla'' es una traducción poco afortunada del inglés ''snapshot'' que se refiere al término ''instantánea''.

= Material complementario =

Además, existe [[material complementario sobre libvirt]] que no es parte del contenido del examen pero que podría ser de su interés.

Administración básica

2025-12-15T23:45:46Z

Pneira: /* adduser y useradd */

Para realizar esta práctica utilizaremos una de las máquinas virtuales que generamos mediante libvirt.

En esta práctica aprenderemos a utilizar el interprete de ordenes (también conocido como ''[https://www.traficantes.net/sites/default/files/pdfs/En%20el%20principio%20fue...-TdS.pdf línea de comandos]'') y a aprender nociones básicas de administración de sistemas Linux.

= Paso 0: Breve introducción al sistema Linux =

== Estructura básica del sistema de archivos ==

En un sistema Linux, todas las carpetas y ficheros en el sistema de fichero pende de la carpeta raíz que se representa con la /.

/
├── bin
├── usr
│ ├── local
│ ├── bin
│ └── ...
├── dev
│ ├── sda
│ ├── sda1
│ └── ...
├── home
│ ├── practica
│ │ ├── tema1.pdf
│ │ ├── boletin1.pdf
│ │ └── ...
│ ├── profesor
│ └── ...
└── etc
├── firefox
├── libvirt
├── ...
└── ...

Como puedes observar, el sistema de fichero emplea una estructura de árbol.

== Nociones básicas ==

·Aplicaciones con nombres compuestos: usar guion entre palabras

·Nombres con espacios en blanco: Escribir entre comillas dobles

·Espacios en blanco para separar ordenes (ej: instalar varios paquetes )

·Formato general de una orden: comando [-opciones] [argumentos]

·'''IMPORTANTE''': Diferencia entre mayúsculas y minúsculas

== Carpetas . y .. ==

Toda carpeta en un sistema Linux dispone de dos pseudocarpetas, la '''.''' y la '''..'':

* La pseudocarpeta '''..''' hace referencia a la carpeta padre que contiene a esta carpeta.
* La pseudocarpeta '''.''' hace referencia a la carpeta actual, es por tanto una autoreferencia.

En el caso de la carpeta raíz, la pseudocarpeta '''.''' y '''..''' hacen referencia a la propia carpeta raíz, se trata, por tanto de una excepción.

== Directorio de trabajo actual y la orden cd ==

Cada interprete de ordenes dispone de una ''carpeta de trabajo actual'' ('''c'''urrent '''w''orking '''d''irectory, en inglés). La carpeta de trabajo actual se puede modificar con la orden '''cd''' ('''c'''hange '''d'''irectory, en inglés).

Por ejemplo:

<syntaxhighlight lang="bash">
$ cd ..
</syntaxhighlight>

Nos situaría en la carpeta padre, empleando una ruta relativa.

Si volvemos a escribir desde /home " cd .. " nos lleva a '''/$'''

Para situarnos en el raíz, podemos emplear una ruta absoluta:

<syntaxhighlight lang="bash">
$ cd /
</syntaxhighlight>

En caso de que queramos volver a la carpeta de usuario, bastaría con invocar a '''cd''' sin más o ''' cd ~ '''

<syntaxhighlight lang="bash">
$ cd
</syntaxhighlight>

'''MUY IMPORTANTE''': No es lo mismo cd.. que ''' cd .. ''', es necesario el espacio después del cd.

== Rutas absolutas, rutas relativas ==

Para hacer referencia a un fichero o una carpeta se usan ruta absolutas o rutas relativas.

Las rutas absolutas siempre empieza por /, de manera que toman como punto de referencia la carpeta raíz (/). Por ejemplo, una ruta absoluta a la carpeta '''prueba''' que está almacenada en la carpeta del usuario '''ubuntu''' es '/home/ubuntu/prueba/'.

Las ruta relativa toma como referencia la carpeta de trabajo actual. Para averiguar la carpeta de trabajo actual disponemos de la orden '''pwd'''.

<syntaxhighlight lang="bash">
$ pwd
/home/ubuntu
</syntaxhighlight>

En base a la carpeta de trabajo actual, empleando la pseudocarpeta '''..''', se puede construir rutas relativas. Por ejemplo, para referenciar un fichero '''fichero.txt''' en la carpeta temporal, podemos emplear la ruta relativa '''../../tmp/fichero.txt'''.

Aunque probablemente sea más cómodo emplear una ruta absoluta en este caso, que sería '''/tmp/fichero.txt'''.

== Intérprete de órdenes ==

El intérprete de órdenes es un lanzador de aplicaciones textual que emplea el teclado como dispositivo de entrada de datos. Mediante el teclado, se escribe el nombre del programa que se quiere lanzar y al pulsa la tecla ''intro'' el intérprete de ordenes ejecutara dicho programa. Por defecto, el intérprete de ordenes que emplea Ubuntu por defecto es '''bash'''.

== man: ver la página de manual de una orden ==

La orden '''man''' te será útil para ver las páginas de manual.

Su estructura básica es:

<syntaxhighlight lang="bash">
man <comando>
</syntaxhighlight>

Aunque también se utiliza con la opción ''' -a ''' de All, que también muestra las entradas comenzadas por '''.''':

<syntaxhighlight lang="bash">
man -a <comando>
</syntaxhighlight>

Este programa toma como entrada el nombre de la orden de la que quieres consultar su página de manual, por ejemplo:

<syntaxhighlight lang="bash">
man ls
</syntaxhighlight>

Nos da información del manual de la orden '''ls'''.

Para salir de la página de manual, pulsa la tecla '''q''' (la primera letra de la palabra '''quit''', en inglés).

quit = salir

Normalmente, los programas ofrecen opciones de ayuda, como '''--help'''.

<syntaxhighlight lang="bash">
man --help
</syntaxhighlight>

También se puede emplear la versión compacta a la hora de especificar opciones.

<syntaxhighlight lang="bash">
man -h
</syntaxhighlight>

En general, todas las ordenes suelen ofrecer una opción de ayuda.

= Paso 1: Operaciones básicas con el sistema de ficheros =

== ls ==

Lista los ficheros y carpetas. Si no se especifica nada, muestra los ficheros y carpetas que contiene la carpeta de trabajo actual.

<syntaxhighlight lang="bash">
ls
</syntaxhighlight>

Si se especifica una ruta, muestra las carpetas y ficheros contenidos en dicha ruta, por ejemplo:

<syntaxhighlight lang="bash">
$ ls /
bin boot data dev etc home initrd.img initrd.img.old lib lib64 lost+found media mnt opt proc root run sbin snap srv sys tmp usr var vmlinuz vmlinuz.old
</syntaxhighlight>

Al emplear '''/''' como ruta absoluta, muestra el contenido de la carpeta raíz.

Las opciones más usadas de este programa suelen ser:

* -a: muestra los ficheros y carpetas ''ocultos''. En Linux, cualquier fichero o carpeta cuyo nombre empiece por . se considera ''oculto''. Esto incluye también en el listado las pseudocarpetas . y ..

* -l: se muestra en lista y aporta datos como la fecha de última modificación, propietario, grupo, tamaño en bytes y nombre:

<syntaxhighlight lang="bash">
$ ls -a

. .. .bash_history .bash_logout .bashrc .profile .ssh
</syntaxhighlight>

Ambas opciones se puede combinar:

<syntaxhighlight lang="bash">
$ ls -la /

total 92
drwxr-xr-x 24 root root 4096 Aug 28 09:50 .
drwxr-xr-x 24 root root 4096 Aug 28 09:50 ..
drwxr-xr-x 2 root root 4096 Aug 22 12:37 bin
drwxr-xr-x 4 root root 4096 Aug 22 12:37 boot
drwx------ 3 root root 4096 Aug 28 09:50 data
drwxr-xr-x 18 root root 3780 Aug 28 09:46 dev
[...]

</syntaxhighlight>

Otras opciones útiles son:

* -s : muestra el tamaño en bloques de cada archivo

* -t : aporta el día y la hora de modificación

* -R : lista también las subcarpetas

* --color : muestra el contenido coloreado

Los '''permisos''' se emplean en base a tres capacidades:

* Lectura, que se codifica con '''r''' (read, en inglés).
* Escritura, que se codifica con '''w''' (write, en inglés).
* Ejecutación, que se codifica con '''x''' (execute, en inglés).

La primera columna muestra los permisos que codifican:

* Tipo de entrada: '''d''' indica ''directorio'' (''carpeta'').
* Permisos del propietario, primera terna de rwx
* Permisos del grupo, segunda terna de rwx
* Permisos para el resto del mundo, tercera terna de rwx.

A continuación, aparecen el propietario y el grupo, seguidos de la fecha de última modificación y el nombre del fichero o carpeta.

La ayuda ( help ) en ls solo funciona con ''' ls --help ''' no con ls -h

== mkdir ==

Crea un nuevo directorio.

<syntaxhighlight lang="bash">
$ mkdir test
</syntaxhighlight>

Crea una carpeta test en el directorio actual.

Comprobemos que se ha creado bien:

<syntaxhighlight lang="bash">
$ ls
test
</syntaxhighlight>

Con la opción '''-p''', permite crear sucesivas carpetas anidadas de una sola vez, por ejemplo:

<syntaxhighlight lang="bash">
$ mkdir -p a/b/c
</syntaxhighlight>

Que crea la siguiente estructura de carpetas.

a
└── b
└── c

== touch ==

Crea un nuevo fichero vacío (sin contenido) con el nombre que especifiquemos.

<syntaxhighlight lang="bash">
$ touch file.txt
</syntaxhighlight>

Comprobamos que el fichero se ha creado correctamente.

<syntaxhighlight lang="bash">
$ ls
file.txt
</syntaxhighlight>

== cp ==

Copia un fichero o directorio.

<syntaxhighlight lang="bash">
$ cp file.txt file_copy.txt
</syntaxhighlight>

Para copiar una carpeta y su contenido tenemos que usar la opción -r (recursivo).

<syntaxhighlight lang="bash">
$ cp -r test test_copy
</syntaxhighlight>

* Comprobamos el resultado con la orden '''ls'''.

* Si nos encontramos en la carpeta destino, la estructura sería la siguiente:

<syntaxhighlight lang="bash">
$ cp <nombre ruta origen> <nombre archivo>
</syntaxhighlight>

== mv ==

Mueve fichero o directorio.

Por ejemplo, para mover un directorio ''carpeta1'' a otro lugar

<syntaxhighlight lang="bash">
mv carpeta1 /tmp
</syntaxhighlight>

NOTA: si el destino es una carpeta y existe, mueve el origen dentro de la carpeta de destino.

También se puede usar para renombrar:

<syntaxhighlight lang="bash">
mv carpeta1 carpeta2
</syntaxhighlight>

En este caso, renombra ''carpeta1'' a ''carpeta2''.

También se puede usar con fichero, para renombrar:

<syntaxhighlight lang="bash">
mv test_copy test_copy2
</syntaxhighlight>

y también para mover:

<syntaxhighlight lang="bash">
mv test_copy2 /tmp
</syntaxhighlight>

== rm ==

* Borra un fichero o carpeta vacía:
<syntaxhighlight lang="bash">
rm fichero.txt
</syntaxhighlight>

* Para borrar una carpeta no vacía y su contenido:
<syntaxhighlight lang="bash">
rm -r carpeta123
</syntaxhighlight>

* Para borrar todo el contenido de la carpeta actual

<syntaxhighlight lang="bash">
rm -r *
</syntaxhighlight>

* EJERCICIOS:

# Crear la siguiente estructura dentro del directorio /tmp (usar los comandos mkdir, touch y cp):

/tmp
├── carpeta1
├── carpeta2
│ ├── fichero1.txt
│ └── fichero2.md
└── carpeta3
 ├── fichero1.txt
 └── fichero2.md

# Basándonos en el ejercicio anterior, cambiar la estructura a la siguiente (usar comandos mv y rm):

/tmp
└── carpeta
 ├── fichero1.txt
└── fichero2.md

= Paso 2: Impresión por pantalla y redirección de salida =

== echo ==

Sirve para imprimir una línea de texto por pantalla o variables de entorno. Además, nos permite escribir en ficheros.

<syntaxhighlight lang="bash">
echo "hola mundo"
</syntaxhighlight>

* Opciones:
-n elimina salto de línea

Una variable de entorno es una variable editada con algún valor, por defecto existen algunas creadas, como por ejemplo la variable HOME, que contiene el directorio del usuario:

<syntaxhighlight lang="bash">
echo $HOME
</syntaxhighlight>

Aprovecharemos y crearemos una variable nosotros:

<syntaxhighlight lang="bash">
ME="my name"
</syntaxhighlight>

Comprobamos:

<syntaxhighlight lang="bash">
echo $ME
</syntaxhighlight>

== Redirección de salida ==

> y >> sirve para redirigir una salida. Por ejemplo, utilizando el comando echo,
podemos enviar un texto dentro de un fichero:

<syntaxhighlight lang="bash">
echo "Esto es una prueba" > file.txt
</syntaxhighlight>

La diferencia entre > y >> es que > sobrescribe lo que haya en el fichero y
añade el contenido, y >> no sobrescribe, solo añade el nuevo contenido.

Hagamos la prueba:

<syntaxhighlight lang="bash">
echo "Esto es una prueba" > file.txt
echo "Esto es una prueba2" > file.txt
echo "Esto es una prueba" >> file2.txt
echo "Esto es una prueba2" >> file2.txt
</syntaxhighlight>

En cualquier caso, si el fichero no existe, se crea.

= Paso 3: Manejo de ficheros y carpetas avanzado =

== cat ==

* Muestra el contenido de un fichero:

<syntaxhighlight lang="bash">
cat fichero.txt
</syntaxhighlight>

* Crea un fichero:

<syntaxhighlight lang="bash">
cat > otrofichero.txt
</syntaxhighlight>

Para guardar el contenido, pulsa CTRL + D para indicar "final de fichero".

* Añadir más lineas al fichero:

<syntaxhighlight lang="bash">
cat >> otrofichero.txt
</syntaxhighlight>

* Concatenar ficheros

<syntaxhighlight lang="bash">
cat fichero1.txt fichero2.txt
</syntaxhighlight>

* Concatenar ficheros y guardar en otro fichero

<syntaxhighlight lang="bash">
cat fichero1.txt fichero2.txt > fichero3.txt
</syntaxhighlight>

== less ==

Sirve para ver el contenido de un fichero, permite navegar arriba y abajo.

Se sale pulsando la tecla ''q''.

<syntaxhighlight lang="bash">
less fichero.txt
</syntaxhighlight>

Útil cuando el fichero tiene contenido mayor a lo que se puede mostrar en pantalla.

== grep ==

Sirve para localizar coincidencias de un cierto patrón en ficheros y muestra la coincidencia, en caso de encontrarla, por pantalla.

<syntaxhighlight lang="bash">
grep <opción> <patrón> <archivos donde buscar>
</syntaxhighlight>
Por ejemplo, para buscar el patrón ''prueba'' en el fichero ''fichero.txt''.

<syntaxhighlight lang="bash">
$ grep -n prueba fichero.txt
1:Esto es una prueba
</syntaxhighlight>

* Principales opciones del comando:

-c : Escribe el número de líneas encontradas.

-i : No distingue entre mayúsculas y minúsculas.

-l : Muestra los nombres de los ficheros que contienen los caracteres buscados.

-n : Cada línea es precedida por su número en el fichero.

-s : No se muestran los mensajes que indican que no se puede abrir un fichero.

-v : Muestra sólo las líneas que no cumplen la condición.

== wc ==

Sirve para contar el número de palabras, caracteres, líneas o bytes que contiene un fichero.

Las opciones más utilizadas son:

* -l: muestra el número de líneas que contiene el fichero.
* -w: muestra el número de palabras.
* -m: muestra el número de caracteres
* -c: muestra el número de bytes

Probemos y contemos todo en el fichero file2.txt:

<syntaxhighlight lang="bash">
wc -l file2.txt
wc -w file2.txt
wc -m file2.txt
wc -c file2.txt
</syntaxhighlight>

Podemos contar más de un fichero a la vez:

<syntaxhighlight lang="bash">
wc -l file.txt file2.txt
</syntaxhighlight>

Nos mostrará el conteo de cada fichero y el total.

== sort ==

Ordenar las líneas de un fichero de manera alfanumérica

<syntaxhighlight lang="bash">
sort file.txt
</syntaxhighlight>

== find ==

Para buscar ficheros podemos usar la orden ''find''.

Por ejemplo, para buscar el fichero ''python3'' en todo el árbol de directorio (desde el raíz) podemos usar la orden:

<syntaxhighlight lang="bash">
find / -name python3
</syntaxhighlight>

Podemos restringir la búsqueda a ficheros con ''-type f''

<syntaxhighlight lang="bash">
find / -type f -name python3
</syntaxhighlight>

o para directorios con ''-type d''

Se puede usar también para buscar directorios.

Por ejemplo, para buscar todos los directorios contenidos en x123:

<syntaxhighlight lang="bash">
find / -type d -name x123
</syntaxhighlight>

Además, se puede combinar con ''-exec'' para ejecutar otra orden usando cada una de las coincidencias.

Por ejemplo, para hacer un ''ls -l'' para cada fichero terminado en ''.txt'' en el directorio actual:

<syntaxhighlight lang="bash">
find . -type f -name *.txt -exec ls -l {} \;
</syntaxhighlight>

En este caso ''{}'' es un ''placeholder'', es decir, se reemplaza por cada coincidencia que ''find'' encuentra cuando se invoca a la orden que se ha especificado por medio de ''-exec''.

NOTA: ''-exec'' necesita \; como terminador.

Puede también buscar cambios recientes en una carpeta, por ejemplo, los ficheros modificados hace 60 minutos:

<syntaxhighlight lang="bash">
find . -type f -amin -60
</syntaxhighlight>

== Tubería (|) ==

En Linux, está la entrada y salida estándar:

* La salida estándar es la pantalla, la salida estándar se usa para mostrar los resultados.
* La entrada estándar, que sirve para obtener datos, se trata del teclado.

NOTA: Además, está la salida estándar de errores, que también es la pantalla, pero que tiene prioridad sobre lo mostrado en la salida estándar.

En general, las órdenes que empleamos:

* Usan la salida estándar para mostrar el resultado de su ejecución.
* Usan la entrada estándar para leer datos, siempre que el usuario no haya especificado un fichero.

Por ejemplo, al hacer:

<syntaxhighlight lang="bash">
grep "prueba"
</syntaxhighlight>

la orden ''grep'' espera a que el usuario introduzca los datos por teclado para encontrar una coincidencia del patrón ''prueba''.

Este comportamiento es útil para el mecanismo de tuberías que describimos a continuación.

Una tubería nos servirá para conectar la salida estándar de un comando en la entrada estándar de otro.

<syntaxhighlight lang="bash">
cat file2.txt | grep prueba
grep -nr prueba file2.txt | wc -l
</syntaxhighlight>

En este ejemplo, cat muestra el contenido de file2.txt por la y esta salida se la
pasamos al comando grep, el cual busca las líneas que contengan prueba.

En el segundo, buscamos todas las líneas que contengan la palabra prueba, y esta
salida se la pasamos al comando wc, el cual cuenta las líneas de la salida del
comando grep.

== Redirecciones ==

Vamos a ver unos conceptos antes de seguir:

* Entrada estándar: representa los datos que necesita una aplicación para funcionar, como por ejemplo un archivo de datos o información ingresada desde la terminal y es representado en la terminal como el tipo 0.
* Salida estándar: es la vía que utilizan las aplicaciones para mostrarte información, allí podemos ver el progreso o simplemente los mensajes que la aplicación quiera darte en determinado momento y es representado en la terminal como el tipo 1.
* Error estándar: es la forma en que los programas te informan sobre los problemas que pueden encontrarse al momento de la ejecución y es representado en la terminal como el tipo 2.

Las redirecciones nos sirven para mover la información de un tipo a otro.

Ya vimos previamente el uso de > y >>, y también el |, veamos algunas más:

* comando < fichero: Toma la entrada de fichero
* comando 2> fichero: Envía la salida de error de comando a fichero
* comando 2>&1: Envía la salida de error a la salida estándar
* comando &> fichero: Envía la salida estándar y de error a fichero; equivale a comando > fichero 2>&1

== curl ==

Puede usar la utilidad ''curl'' para descargar ficheros.

<syntaxhighlight lang="bash">
curl https://ash-speed.hetzner.com/100MB.bin -o 100MB.bin
</syntaxhighlight>

También se puede usar la orden ''wget''.

== tar ==

Para comprimir una carpeta:

<syntaxhighlight lang="bash">
tar cvzf fichero.tar.gz carpeta1
</syntaxhighlight>

Para descomprimirla:

<syntaxhighlight lang="bash">
tar xvf fichero.tar.gz
</syntaxhighlight>

== file ==

Sirve para comprobar el tipo de fichero:

<syntaxhighlight lang="bash">
file f1.txt
</syntaxhighlight>

que muestra:

<syntaxhighlight lang="bash">
f1.txt: ASCII file
</syntaxhighlight>

cuando es un fichero de texto.

<syntaxhighlight lang="bash">
file fichero.tar.gz
</syntaxhighlight>

que muestra:

<syntaxhighlight lang="bash">
fichero.tar.gz: gzip compressed data, from Unix, original size modulo 2^32 20480
</syntaxhighlight>

En general, sirve para saber de qué tipo de fichero se trata.

= Paso 4: Usuarios y grupos =

== whoami ==

Sirve para obtener el usuario actual.

<syntaxhighlight lang="bash">
whoami
</syntaxhighlight>

Lo más seguro es que nos aparezca ubuntu.

== who ==

Es para saber quien está ahora mismo en la máquina conectado.

<syntaxhighlight lang="bash">
who
</syntaxhighlight>

Seguramente solo estemos nosotros:

<syntaxhighlight lang="bash">
root pts/0 2019-08-28 13:51 (192.168.122.1)
</syntaxhighlight>

''pts/0'' es el terminal desde el que está el usuario ''root''.

== su y sudo ==

su (substitute user): sirve para cambiar de usuario. Por ejemplo:

<syntaxhighlight lang="bash">
su root
</syntaxhighlight>

Aquí nos pedirá la contraseña del usuario al que queramos cambiar.

sudo (super user do): no todas las distribuciones lo integran, porque es menos
seguro que su, este comando nos permite ejecutar un comando siendo otro usuario,
por defecto, si no le damos usuario, lo hará con el usuario root. Si sudo nos
pide contraseña, nos pide la contraseña del usuario, ya que el usuario es que el
tiene permisos para usar sudo o no.

<syntaxhighlight lang="bash">
sudo ls -a /root
</syntaxhighlight>

Si tuviéramos por ejemplo un usuario 'practica' y quisíeramos ejecutar un
comando en su nombre:

<syntaxhighlight lang="bash">
sudo -u practica ls
</syntaxhighlight>

Como root puedo añadir usuarios para que puedan hacer sudo así:

<syntaxhighlight lang="bash">
adduser usuario sudo
</syntaxhighlight>

Esto hace que el usuario ''usuario'' pueda hacer sudo

== adduser ==

Para añadir un usuario ''practica'':

<syntaxhighlight lang="bash">
sudo adduser practica
</syntaxhighlight>

== passwd ==

Sirve para modificar la contraseña de un usuario, por ejemplo, vamos a modificar
la contraseña del usuario que hemos creado previamente:

<syntaxhighlight lang="bash">
sudo passwd practica
</syntaxhighlight>

Nos preguntará dos veces la contraseña, y ya la tendremos actualizadas. Vamos
ahora a probar ahora el comando su para cambiar de usuario:

<syntaxhighlight lang="bash">
su practica
whoami
</syntaxhighlight>

Veremos que hemos cambiado de usuario, para cerrar este usuario, escribimos
'exit' o pulsamos 'CTLR + D'

== deluser y userdel ==

Ambos sirven para borrar un usuario, similar a adduser y useradd, userdel es el
comando y deluser el script.

Vamos a borrar el usuario que hemos creado, incluyendo el borrado de su /home
(opción -r):

<syntaxhighlight lang="bash">
userdel -r practica
</syntaxhighlight>

Comprobemos que ya no tenemos usuario ni /home:

<syntaxhighlight lang="bash">
ls /home
sudo -u practica whoami
</syntaxhighlight>

== addgroup y groupadd ==

Ambos sirven para crear un grupo. Los grupos sirven para agrupar a los usuarios
y que estos tengan unos mismos permisos. Por ejemplo, cuando instalamos algunas
herramientas como por ejemplo docker, este crea el grupo docker automáticamente
para que fácilmente podamos añadir a un usuario al grupo, y este tenga los
permisos para trabajar con dicha herramienta.

Vamos a crear un nuevo grupo, vamos a llamarle invitado:

<syntaxhighlight lang="bash">
sudo groupadd invitado
</syntaxhighlight>

== usermod y groups ==

usermod es utilizado para asignar un grupo a un usuario.

groups es utilizado para ver los grupos a los que pertenece un usuario.

Vamos a añadir a un usuario practica, lo vamos a añadir al grupo invitado y
veremos los grupos a los que pertenece:

<syntaxhighlight lang="bash">
sudo useradd -m practica
sudo usermod -G invitado practica
groups practica
</syntaxhighlight>

Veremos que el usuario práctica pertenece al grupo invitado.

== delgroup y groupdel ==

Ambos sirven para eliminar un grupo. Vamos a eliminar el grupo que hemos creado
anteriormente:

<syntaxhighlight lang="bash">
sudo groupdel invitado
</syntaxhighlight>

Podemos observar ahora que el usuario practica no pertenece al grupo invitado:

<syntaxhighlight lang="bash">
groups practica
</syntaxhighlight>

= Paso 5: Permisos =

== Nomenclatura rwx y numérica ==

Si hacemos un ls -l, la primera cadena que nos aparece son los permisos del
fichero (-rwxrw-r--), podemos dividirlo en 4 elementos:

- (rwx) (rw-) (r--)
| | | |
type owner group others

* type: el tipo de fichero, pudiendo ser d (directorio), l (enlace simbólico), - (fichero normal)
* owner: permisos de propietario
* group: permisos de grupo
* others: permisos para los demás usuarios

Significado de los permisos:

* r: permisos de lectura
* w: permisos de escritura
* x: permisos de ejecución

Por último, existe un modo abreviado para estos permisos que se utiliza con
números.

rwx
001 en binario es 1 en decimal. Permisos de ejecución
010 en binario es 2 en decimal. Permisos de escritura
100 en binario es 4 en decimal. Permisos de lectura

La suma de los permisos, nos da el valor numérico. Veamos un ejemplo:
rwx rw- r--
110 110 100
6 6 4

'''Ojo''': ¡No emplee nunca los permisos 777 (rwxrwxrwx) cuando tenga problemas con los permisos!

== chmod ==

Permite cambiar los permisos de acceso a un fichero o directorio. Podemos dar
permisos de dos formas diferentes.

=== modo carácter ===

Veamos primero unos detalles:

Clases de usuario:

* owner (u)
* group (g)
* others (o)
* all (a)

Modificador:

* añadir (+)
* eliminar (-)
* sobrescribir (=)

Para dar permisos tendríamos que seleccionar la clase de usuario el modificador
y los permisos, veamos un ejemplo:

<syntaxhighlight lang="bash">
chmod u+x file # añadimos permisos de ejecución al usuario
chmod go-w file # quitamos permisos de escritura al grupo y a otros usuarios
chmod u=rwx,go=r file # Al usuario le damos todos los permisos, y al grupo y otros solo le damos permisos de lectura
</syntaxhighlight>

=== Modo octal ===

Con el modo octacl, es como si siempre utilizáramos el modificar sobrescribir,
pongamos algunos ejemplos:

<syntaxhighlight lang="bash">
chmod 644 file # Al usuario le damos permiso de lectura y escritura al usuario, y al grupo y otros solo le damos permisos de lectura
chmod 600 file # solo el propietario tiene permisos de lectura y escritura
</syntaxhighlight>

=== Ejemplos ===

Vamos a ver como funciona el tema de permisos con unos ejemplos. Vamos a crear
un fichero pruebas y le vamos a quitar los permisos de escritura a nuestro
usuario, y le vamos a dar permisos de escritura a otros:

<syntaxhighlight lang="bash">
touch pruebas
ls -l pruebas # de esta forma veremos que por defecto los permisos son rw-rw-r--
chmod u-w,o+w pruebas
ls -l pruebas # ahora los permisos deberían ser -w-rw-rw-
</syntaxhighlight>

Una vez dado los permisos, veamos que con nuestro usuario podemos leer pero no
escribir:

<syntaxhighlight lang="bash">
cat pruebas
echo "probando" > pruebas
exit
</syntaxhighlight>

Y ahora vamos a ver que el usuario pruebas, puede leer y escribir:

<syntaxhighlight lang="bash">
su practica
cat pruebas
echo "probando" > pruebas
</syntaxhighlight>

== chown ==

Permite cambiar el propietario de un fichero o directorio.

Vamos por ejemplo a pasarle ahora el fichero pruebas al usuario practica:

<syntaxhighlight lang="bash">
sudo chown practica pruebas
ls -l pruebas
</syntaxhighlight>

Veremos que el usuario actual ahora es pruebas, aunque vemos que el ls muestra
lo siguiente:

<syntaxhighlight lang="bash">
-r--rw-rw- 1 practica ubuntu 9 Aug 29 09:34 pruebas
</syntaxhighlight>

Hay que comentar un detalle, y es que los ficheros y directorios tienen asignado
un usuario y un grupo, por defecto se utiliza el mismo usuario como grupo
cuando creamos un nuevo fichero o directorio. Si queremos que cuando cambiemos
el propietario, cambiar tambien el grupo del fichero, podemos hacerlo de la
siguiente forma:

<syntaxhighlight lang="bash">
sudo chown practica:practica pruebas
</syntaxhighlight>

Una vez hecho esto, vamos ahora a probar que los permisos siguen funcionando
como antes, ahora con el usuario ubuntu, deberíamos de poder leer y escribir en
el fichero pruebas, y con el usuario practica, solo leer, esto es así por que
ahora el propitario es practica:

<syntaxhighlight lang="bash">
# Pruebas usuario ubuntu
cat pruebas
echo test >> pruebas
# Pruebas usuario practica
su practica
cat pruebas
echo "probando" > pruebas
exit
</syntaxhighlight>

= Paso 6: Procesos =

== ps ==

Sirve para ver que procesos están ejecutándose en el sistema, veamos un ejemplo:

<syntaxhighlight lang="bash">
ps aux # con la opción aux mostraremos todos los procesos del sistema
</syntaxhighlight>

Cada línea es un proceso, y cada proceso muestra su PID, usuario, cantidad de
memoria y cpu utilizada, comando y otros detalles.

<syntaxhighlight lang="bash">
man kill & # añadir el & al final de un comando hace que este se ejecute en segundo plano, por lo que se quedará abierto
</syntaxhighlight>

La salida de este comando nos mostrará el PID que tiene ese proceso que acabamos
de ejecutar, vamos a comprobarlo:

<syntaxhighlight lang="bash">
ps aux | grep "man kill"
</syntaxhighlight>

Veremos que el PID coincide.

== kill ==

Este comando nos servirá para matar un proceso. kill se utiliza seguido de una
señal para enviar al proceso seguido de uno o varios PID. para ver las señales
disponibles, podemos listarlas:

<syntaxhighlight lang="bash">
kill -l
</syntaxhighlight>

Las más utilizadas suele ser SIGTERM y SIGKILL, la primera intenta terminar el
proceso de forma poco abrupta, y la segunda suele utilizarse cuando el proceso
no atiende a esta primera señal. Vamos ahora a terminar el proceso que creamos
antes, si no recordamos el PID, busquémoslo de nuevo:

<syntaxhighlight lang="bash">
ps aux | grep "man kill"
</syntaxhighlight>

Enviamos señal para terminar el proceso y comprobamos que ha terminado:

<syntaxhighlight lang="bash">
kill -SIGTERM 8470
ps aux | grep "man kill"
</syntaxhighlight>

También podemos notar que en el listado de señales, hay unos números, podemos
utilizar esos números en vez de las palabras, por ejemplo:

<syntaxhighlight lang="bash">
man kill &
kill -15 PID_COMANDO_PREVIO
</syntaxhighlight>

Comprobamos que el proceso ha terminado correctamente:

<syntaxhighlight lang="bash">
ps aux | grep "man kill"
</syntaxhighlight>

= Paso 7: Estado CPU, RAM y Disco =

== top ==

Este comando nos servirá para ver el listado de procesos y el estado de la CPU y
memoria.

Probemos el comando y observemos detalladamente la salida:

<syntaxhighlight lang="bash">
top
</syntaxhighlight>

Para salir, pulsamos q.

== df y du ==

df (disk free) y du (disk usage). Ambas son utilidades para mostrar el uso de
los discos.

Con df mostraremos la información del espacio en cada dispositivo montado:

<syntaxhighlight lang="bash">
df
</syntaxhighlight>

Estos comandos que nos muestran el tamaño de los ficheros, casi siempre tienen
una opción para mostrarlo en un formato más legible (-h)

<syntaxhighlight lang="bash">
df -h
</syntaxhighlight>

Mucho mejor.

Ahora veamos el comando du, el cual nos mostrará el tamaño de un fichero o
directorio y sus subdirectorios, no olvidemos el -h:

<syntaxhighlight lang="bash">
du -h /home/ubuntu
du -h /home/ubuntu/pruebas
</syntaxhighlight>

Si solo quisíeramos saber el total de una carpeta y nos nos interesan sus
subcarpetas, podemos utilizar la opción -s:

<syntaxhighlight lang="bash">
du -sh /home/ubuntu
</syntaxhighlight>

== free ==

Sirve para ver el estado de la memoria, como siempre, opción -h:

<syntaxhighlight lang="bash">
free -h
</syntaxhighlight>

== lsblk ==

Nos muestra la información de todos los dispositivos de bloques (discos duros,
pendrivers, CD_ROM, SSD, ...).

<syntaxhighlight lang="bash">
lsblk
</syntaxhighlight>

En la siguiente práctica se utilizará más a fondo este comando, ya que
trabajaremos con dispositivos.

= Paso 8: Gestión de paquetes de software y repositorios =

Los sistemas Linux incluyen, además de las herramientas básicas del sistema operativo, repositorios de software que puede ser opcionalmente instalados por el administrador del sistema. Los fabricantes de las distribuciones de Linux incluyen paquetes de software listos para ser instalados que se integran con el sistema.

Un paquete incluye el software necesario para que una cierta aplicación funcione correctamente, así como sus paquetes de dependencia.

En Ubuntu, la herramienta de gestión de paquetes de software y repositorios se llama '''apt'''.

=== Listado de repositorios de paquetes de software ===

En Ubuntu el listado de repositorios se encuentra en el fichero /etc/apt/sources.list. Podemos comprobar que repositorios tenemos añadido:

<syntaxhighlight lang="bash">
cat /etc/apt/sources.list
</syntaxhighlight>

=== Actualización del listado de paquetes de software ===

Para actualizar el listado de paquetes utilizaremos el comando:

<syntaxhighlight lang="bash">
sudo apt update
</syntaxhighlight>

=== Instalación un nuevo paquete ===

Para instalar un nuevo paquete, utilizaremos la orden install, por ejemplo, vamos a instalar tree, similar al ls pero muestra el arbol de directorios:

<syntaxhighlight lang="bash">
sudo apt install tree
</syntaxhighlight>

=== Desinstalación de un paquete ===

Usaremos la orden purge o la orden remove, purge nos lo eliminad todo, y remove mantiene la configuración en el caso de que el paquete la tuviese. Vamos a eliminar el paquete instalado previamente:

<syntaxhighlight lang="bash">
sudo apt purge tree
</syntaxhighlight>

= Paso 9: Administración remota con ssh =

''ssh'' (Secure SHell) permite administrar de manera remota un sistema desde el intérprete de órdenes. Para poder acceder a la máquina virtual por medio de ''[[ssh]]'', hay que instalar el paquete ''openssh-server''.

sudo apt-get install openssh-server

Una vez instalado, tenemos que consultar la dirección IP de la máquina virtual

ip address

Desde el hipervisor podemos acceder por ''ssh'' a la máquina virtual con la orden:

ssh usuario@ip

Siendo ''usuario'' el nombre de usuario con el que accedes a la máquina virtual y la dirección ''ip'' que nos muestra la orden ''ip address''.

Por ejemplo, si el usuario seleccionado es ''ubuntu'' y la IP es 192.168.122.123, entonces la invocación a ''ssh'' es la siguiente:

ssh ubuntu@192.168.122.123

En caso de que en la maquina virtual no esté instalado openssh-server, puede que la conexión sea rechazada:
ssh: connect to host 192.168.122.123 port 22: Connection refused

Para resolver el problema es necesario instalar OpenSSH client en la maquina virtual

sudo apt install openssh-client

Y a continuación se instala OpenSSH server

sudo apt install openssh-server

En la imagen de Ubuntu Cloud el servicio de ssh viene instalado por defecto, sin embargo no está activo. Para activarlo hay que crear las claves SSH del servidor:

# ssh-keygen -A

además, hay que editar el fichero /etc/sshd/sshd_config para establecer:

PasswordAuthentication yes

pues está por defecto a ''no''.

y luego lanzar el servicio:

# systemctl enable ssh
# systemctl start ssh

La orden ''enable'' hace que el servicio se lance la próxima vez que arranque el sistema. La orden lanza el servicio inmediatamente.

Puedes comprobar que el servicio está lanzado con:

# ss -lt

donde -l muestra los procesos escuchando (listen) en un puerto y -t se refiere a TCP.

La autenticación por ssh mediante usuario y contraseña es un mecanismo susceptible a ataques de diccionario de fuerza bruta. Es más conveniente utilizar ''2-factor authentication'' tales como claves SSH pública y privada.

Para activar autenticación mediante ''2-factor authentication'' tengo que generar el par de claves público y privado:

ssh-key

tienes que establecer una contraseña para proteger la clave privada.

Una vez creadas, tengo que instalar la clave pública en el servidor:

ssh-copy-id usuario@192.168.122.133

A partir de este momento puedes acceder por SSH mediante 2-factor authentication basado en clave pública SSH.

ssh usuario@192.168.122.133

que te solicita la contraseña que protege tu clave pública.

= Ejercicios =

# Cree un fichero vacio llamado 123.txt
# Añada al fichero las siguientes tres lineas:

Hola mundo
Probando 1 2 3
Adios

# Añada una linea más al fichero con el siguiente contenido:

Prueba

# Renombre el fichero 123.txt a 456.txt
# Haga una copia del fichero 456.txt al fichero 789.txt
# Cree la carpeta xyz
# Mueva el fichero 789.txt a la carpeta xyz
# Mueva el fichero 456.txt al temporal
# Borre el fichero 456.txt
# Compruebe si el fichero 789.txt contiene la palabra “mundo”
# Borre la carpeta xyz y su contenido
# Liste el contenido de la carpeta temporal mostrando los permisos asociados a los ficheros y carpetas, almacene el resultado en el fichero temporal.txt
# Cree la carpeta ‘x’ y dentro de ella, la carpeta ‘y’
# Mueva el fichero temporal.txt dentro de la carpeta ‘y’
# Cuente el número de ficheros y directorios en la carpeta tmp
# Muestre el espacio disponible en el raíz del sistema
# Para el fichero temporal.txt, establezca permisos de sólo lectura para el propietario
# Lance 'gedit' desde un terminal, obtenga el PID de dicho proceso y acabe con su ejecución

Contenedores

2025-12-15T12:38:17Z

Pneira: /* Paso 2: Repositorio de imágenes de contenedores DockerHub */

En esta práctica aprenderemos a utilizar [https://es.wikipedia.org/wiki/Podman podman] para desplegar contenedores.

= Paso 1: Instalar podman =

Para instalar el paquete oficial:

<syntaxhighlight lang="bash">
apt install podman
</syntaxhighlight>

podman es un clon de '''docker''.

Si añade un usuario 'test' a su sistema con:

<syntaxhighlight lang="bash">
adduser test
</syntaxhighlight>

recuerde hacer:

<syntaxhighlight lang="bash">
loginctl enable-linger test
systemctl start --user dbus
</syntaxhighlight>

para evitar un warning que se muestra al ejecutar '''podman''' como usuario.

= Paso 2: Repositorio de imágenes de contenedores DockerHub =

Docker ofrece un servicio de nube denominado ''DockerHub'' que puede ser empleado como red social para compartir tus imágenes de Podman. En ''DockerHub'' existen además imágenes de contenedores preconfiguradas de software, muchas de ellas oficiales (ofrecidas por el propio fabricante del software) que se podrán emplear como base para construir nuevas imágenes adaptadas a nuestras necesidades.

Podremos realizar búsquedas en este repositorio ''DockerHub'' puedes emplear el siguiente comando:

<syntaxhighlight lang="bash">
podman search docker.io/library/hello-world
</syntaxhighlight>

Para descargarnos la imagen de ''hello-world'' podemos usar la orden ''pull'':

<syntaxhighlight lang="bash">
podman pull docker.io/library/hello-world
</syntaxhighlight>

También podemos publicar imágenes propias, esto require '''registro de usuario''' en la nube de ''DockerHub'', lo que '''no''' es obligatorio para la realización de esta práctica. Para subir una imagen, hay que validarse como usuario en la nube de ''DockerHub'':

<syntaxhighlight lang="bash">
podman login docker.io
</syntaxhighlight>

Tras introducir tu usuario y contraseña, puedes comenzar a publicar tus propias imágenes.

<syntaxhighlight lang="bash">
podman push docker.io/USUARIO/MI_IMAGEN
</syntaxhighlight>

Este paso es '''opcional''', sólo en caso de que se quieran subir imágenes de contenedores a la nube de docker.io.

= Paso 4: Comprobar imágenes en nuestra máquina =

Para ver las imágenes que tenemos en nuestra máquina, utilizaremos el comando:

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Inicialmente, no tenemos imágenes en almacenamiento, podemos descargarnos la imagen oficial de Debian 13 (Trixie):

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian
</syntaxhighlight>

Ahora si, ya debería de aparecernos la imagen ''debian''.

Comentar también que cada imagen puede tener varias etiquetas, por ejemplo, la imagen Debian 12 (Bookworm), cuando la hemos visto en el listado de imágenes, venía con el tag latest, que es el tag que se descarga por defecto, pero nosotros podemos especificar otro, por ejemplo:

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian:bookworm
</syntaxhighlight>

Para traernos la versión de la imagen de Debian 12 ''Bookworm''.

Ahora tendremos dos imágenes con diferente etiqueta, que serían como las diferentes versiones de cada imagen.

= Paso 5: Lanzar un contenedor =

Un contenedor no es más que una imagen de podman ejecutándose, sería similar a
una máquina virtual, aunque mucho más liviano.

Para crear un contenedor, utilizaremos una imagen, en este caso, la imagen
hello-world. Hacemos lo siguiente:

<syntaxhighlight lang="bash">
podman run hello-world
</syntaxhighlight>

Esto nos mostrará el siguiente mensaje si todo está correcto:

<syntaxhighlight lang="bash">
Hello from Docker!
This message shows that your installation appears to be working correctly.

To generate this message, Docker took the following steps:
1. The Docker client contacted the Docker daemon.
2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
(amd64)
3. The Docker daemon created a new container from that image which runs the
executable that produces the output you are currently reading.
4. The Docker daemon streamed that output to the Docker client, which sent it
to your terminal.

To try something more ambitious, you can run an Debian container with:
$ podman run -it debian bash

Share images, automate workflows, and more with a free Docker ID:
https://hub.docker.com/

For more examples and ideas, visit:
https://docs.docker.com/get-started/
</syntaxhighlight>

Al crear los contenedores utilizando el comando 'run', tenemos varias opciones:

* Lanzar una terminal en el contenedor en modo interactivo
* Lanzar en segundo plano y conectarnos posteriormente al contenedor

== Paso 5.1: Lanzar una terminal en el contenedor en modo interactivo (-ti) ==

Para este ejemplo vamos a utilizar otra imagen diferente, en este caso vamos a utilizar una imagen de debian.

Vamos a lanzar un contenedor y ejecutar una terminal en el que se va a ejecutar el programa '''bash''' que me ofrece un interprete de órdenes:

<syntaxhighlight lang="bash">
podman run -ti debian bash
</syntaxhighlight>

La opción ''-t'' indica que se crea un terminal en el contenedor. Y la opción ''-i'' indica que el contenedor se ejecuta en modo interactivo.

Al acceder al contenedor de ''debian'' nos aparece un ''hash'' en el prompt de la shell, que identifica a la instancia del contenedor (es valor es similar al que muestra la orden ''podman container ls'').

Para salir del contenedor, escribimos 'exit' o pulsamos ''CTRL + D''

== Paso 5.2 Lanzar en segundo plano (-d) ==

Otro ejemplo, con la imagen de Debian:

<syntaxhighlight lang="bash">
podman run -dti debian
</syntaxhighlight>

que muestra un hash que identifica de forma única el contenedor lanzado:

<syntaxhighlight lang="bash">
2ec1daae4676a4e84dc04fd91399c1dfe92119544ff12ee307991fe573d3db64
</syntaxhighlight>

Mediante el comando ''attach'' puedo entrar al contenedor:

<syntaxhighlight lang="bash">
podman attach 2ec1daae4676
</syntaxhighlight>

Para salir, pulsamos ''CTRL + P'' seguido de ''CTRL + Q''.

De manera similar, puedo lanzar en segundo plano la imagen de contenedor de ''hello-world'':

<syntaxhighlight lang="bash">
podman run -d hello-world
</syntaxhighlight>

Y consultar los logs:

<syntaxhighlight lang="bash">
podman logs b67fae3312bc321
</syntaxhighlight>

== Paso 5.3: Añadir variables de entorno a un contenedor ==

Utilizaremos la imagen anterior, y vamos a añadir una variable de entorno
llamada TEST que contenga el valor 'test'. A parte, también ejecutaremos la
terminal como antes, para comprobar con el comando echo, que la variable de
entorno está creada correctamente:

<syntaxhighlight lang="bash">
podman run -ti -e TEST=test debian bash
</syntaxhighlight>

Ahora, desde el contenedor podemos comprobar el valor de la variable de entorno ''$TEST''.

<syntaxhighlight lang="bash">
echo $TEST
test
</syntaxhighlight>

= Paso 6: Listar contenedores en ejecución =

Hemos estado haciendo pruebas y ejecutando contenedores en el paso anterior, vamos a ver donde se encuentran estos contenedores que hemos ejecutado, y después veremos algunas opciones más del comando run.

Tenemos dos opciones para ver los contenedores:

<syntaxhighlight lang="bash">
podman container ls -a
</syntaxhighlight>

o la versión corta:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Ambas hacen lo mismo, y debería de mostrarnos una salida similar a la siguiente:

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
e2bde5f5500c debian "bash" 6 minutes ago Exited (0) 2 seconds ago pensive_sammet
544ad27dbc3c debian "bash" 7 minutes ago Exited (0) 7 minutes ago serene_elgamal
</syntaxhighlight>

En la información veremos que el contenedor tiene el estado exited, eso quiere decir que no se está ejecutando y ya ha finalizado. Vamos a hacer una prueba para ver un contendor ejecutándose:

<syntaxhighlight lang="bash">
podman run -d debian sleep 30
</syntaxhighlight>

Con el comando sleep 30 esperamos 30 segundos hasta que termine el comando, asíque durante esos 30 segundos, el contenedor estará ejecutándose, veámoslo:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
eacceb27d52d debian "sleep 30" 12 seconds ago Up 11 seconds sharp_pasteur
</syntaxhighlight>

Vamos a ver alguna opciones más de la orden ''run''.

== Paso 6.1: Dar un nombre al contenedor (--name) ==

Por defecto, podman creará automáticamente un nombre como hemos visto en las salidas del comando ''podman ps -a''. Podemos establecer el nombre del contenedor que queramos con la opción ''--name'':

<syntaxhighlight lang="bash">
podman run -ti --name mi_debian debian
</syntaxhighlight>

== Paso 6.2: Eliminar contenedor cuando termine (--rm) ==

Vamos a mezclar todo lo visto anteriormente:

* Lanzar en segundo plano (-d)
* Ejecutar contenedor durante 30 segundos (sleep 30)
* Dar un nombre a la imagen (--name)
* Eliminar contenedor cuando termine (--rm)

<syntaxhighlight lang="bash">
podman run -d --rm --name bye-bye debian sleep 30
</syntaxhighlight>

Antes y una vez pasados los 30 segundos, podemos comprobar que el contenedor ha desaparecido.

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

= Paso 7: Parar y eliminar contenedores =

Para parar contenedores podemos usar el ID o su nombre:

<syntaxhighlight lang="bash">
podman stop my_container
podman stop e4901956f108
podman ps -a
</syntaxhighlight>

Una vez hemos comprobado que han terminado su ejecución, podemos eliminar los ficheros resultantes de su ejecución:

<syntaxhighlight lang="bash">
podman container rm my_container
</syntaxhighlight>

Para borrar todos los contenedores ya finalizados

<syntaxhighlight lang="bash">
podman container prune
</syntaxhighlight>

= Paso 8: Conectarnos a un contenedor que se está ejecutando en segundo plano =

Vamos a ejecutar de nuevo un contenedor que no termine:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a conectarnos a este contenedor que está ejecutándose en segundo
plano:

<syntaxhighlight lang="bash">
podman attach mi-contenedor
</syntaxhighlight>

Veremos la orden bash ejecutándose, para terminar, hacemos un 'CTRL + C', y ahora, veremos que ha pasado con el contenedor:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Lo veremos parado, por que lo que hemos hecho ha sido conectarnos al contenedor
y parar el comando que se estaba ejecutando, así que ahora tenemos el contenedor
finalizado.

''Nota:'' Para salir del contenedor '''sin detenerlo''' hacemos 'CTRL + P' seguido 'CTRL + Q'

= Paso 9: Ejecutar un comando dentro de un contenedor en ejecución =

Vamos a ver otresta vez como ejecutar un comando en un contenedor que ya está
ejecutándose:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a ejecutar un comando en ese contenedor con el nombre ''mi-contenedor''.
El comando exec es similar al comando run, pero para ejecutar un comando dentro de un contenedor:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor ls
</syntaxhighlight>

Para redirigir la salida a un fichero en el anfitrión:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor ls > x.txt
</syntaxhighlight>

Para redirigir la salida a un fichero ''dentro'' del contenedor, hacemos:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor sh -c "ls > x.txt"
</syntaxhighlight>

También es posible ejecutar comandos con tuberías:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor sh -c "ls -la | grep ^d"
</syntaxhighlight>

= Paso 10: Persistencia en contenedores =

Al hacer ''exit'' y salir de un contenedor, se pierden todos los cambios que hemos realizado. Los

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-ejemplo debian bash
</syntaxhighlight>

Ahora, vamos a crear una carpeta en el contenedor y comprobar que esa carpeta existe:

<syntaxhighlight lang="bash">
podman exec mi-ejemplo mkdir test
podman exec mi-ejemplo ls
</syntaxhighlight>

Veremos que la carpeta existe, pero, ¿qué ocurre si para el contenedor?

<syntaxhighlight lang="bash">
podman container stop mi-ejemplo
</syntaxhighlight>

Y volvemos a lanzarlo:

<syntaxhighlight lang="bash">
podman container rm mi-ejemplo
podman run -d -ti --name mi-ejemplo debian bash
podman exec mi-ejemplo ls
</syntaxhighlight>

Podemos comprobar que la carpeta creada anteriormente, no existe.

¿Qué podemos hacer para mantener la modificaciones realizadas sobre un contenedor?

== Paso 10.1: Crear una imagen derivada de la imagen base ==

Es posible crear una imagen derivada, con modificaciones, a partir de una imagen existente mediante la orden '''commit'''.

Por ejemplo, si queremos una imagen ''debian'' que incluya el programa ''ping'' ya instalado, tendríamos que lanzar un contenedor a partir de la imagen ''ubuntu'':

<syntaxhighlight lang="bash">
podman run -d -ti debian bash
</syntaxhighlight>

Suponiendo que el contenido está identificado con el ID 56ef5b312334

Instalamos el paquete ping:

<syntaxhighlight lang="bash">
podman exec 56ef5b312334 apt -y install ping
</syntaxhighlight>

Generamos la imagen derivada con el nombre ''ubuntu-con-ping'':

<syntaxhighlight lang="bash">
podman commit 56ef5b312334 ubuntu-con-ping
</syntaxhighlight>

Ya podemos para nuestro contendor:

<syntaxhighlight lang="bash">
podman stop 56ef5b312334
</syntaxhighlight>

Y lanzar un nuevo contenedor a partir de la imagen ''debian-con-ping'':

<syntaxhighlight lang="bash">
podman run -d -ti debian-con-ping bash
</syntaxhighlight>

== Paso 10.2: Mantener la persistencia mediante volúmen ==

Otra opción para mantener los datos es montar un volumen al ejecutar el contenedor.

Primero crearemos una carpeta que hará de volumen en nuestra máquina, que será la que luego montemos para podman:

<syntaxhighlight lang="bash">
mkdir /home/debian/volumen
</syntaxhighlight>

Ahora vamos a montar la carpeta al ejecutar el contenedor, lo hacemos con la
opción -v, la cual tiene 3 campos separados por ':':

# El volumen en nuestra máquina
# Donde se montará el volumen dentro del contenedor
# Opciones de mmontaje, por ejemplo rw (read and write) o ro (read only)

<syntaxhighlight lang="bash">
podman run --rm -ti -v /home/debian/volumen:/volumen:rw debian bash
mkdir /volumen/test
touch /volumen/test/file
exit
</syntaxhighlight>

Una vez nos salgamos del contenedor, podemos ver que en nuestra máquina están
los datos:

<syntaxhighlight lang="bash">
ls /home/ubuntu/volumen/
ls /home/ubuntu/volumen/test
</syntaxhighlight>

La próxima vez que ejecutemos un contenedor, si montamos ese volumen, los datos
estarán ahí, además esta forma tiene el beneficio de compartir datos entre
nuestra máquina y el contenedor de forma sencilla.

= Paso 11: Crear nuestra propia imagen de contenedor =

Para crear una imagen de un contenedor con una aplicación de Python hug, creamos en primer lugar la carpeta que contendrá los ficheros que nos permiten crear la imagen.

<syntaxhighlight lang="bash">
mkdir miapp
cd miapp
</syntaxhighlight>

Definimos un fichero ''Dockerfile'' para definir la imagen:

<syntaxhighlight lang="bash">
FROM ubuntu

RUN apt -y update
RUN apt -y upgrade
RUN apt -y install python3-hug
RUN mkdir /app
COPY endpoint.py /app
WORKDIR /app
CMD hug -f endpoint.py
</syntaxhighlight>

Alternativamente, puedes crear un [[Creando imagen propia usando Ubuntu de base|Dockerfile empleando la imagen de Ubuntu]] como base en lugar de Alpine.

Y añadimos el fichero ''endpoint.py'' que emplea el framework Python hug con el contenido siguiente:

<syntaxhighlight lang="bash">
import hug

@hug.get('/welcome')
def welcome(username="unknown"):
""" Say welcome to username """
return "Welcome " + username
</syntaxhighlight>

Este fichero es un ejemplo de uso de Python hug. Si hacemos una petición a /welcome?username="LSO", esto nos devolverá el mensaje "Welcome LSO".

Una vez tengamos los dos ficheros creados en nuestra máquina virtual, podemos construir nuestra imagen:

<syntaxhighlight lang="bash">
podman build -t app:v1 -f Dockerfile .
</syntaxhighlight>

Vamos a explicar para que sirve cada línea:

* FROM: servirá para basarnos en una imagen existente, en este caso, una imagen de python alpine, que contiene python y no ocupa mucho espacio
* ENV: para crear variables de entorno
* RUN: para ejecutar comandos, ya sea para crear una carpeta, instalar dependencias o cualquier otra opción que necesitemos
* COPY: para copiar datos desde nuestra máquina a la imagen
* WORKDIR: para cambiar el directorio de trabajo (lo crea si no existe)
* CMD: este comando será ejecutado por defecto al iniciar un contenedor a partir de esta imagen

Esto construirá una imagen podman basada en python:alpine, en la cual hemos
guardado nuestra pequeña aplicación y se va a ejecutar cuando ejecutemos un
contenedor basado en esa imagen. Para comprobar que la imagen se ha creado
correctamente, listamos las imagenes, y debería de aparecernos una imagen con
nombre 'app' y tag 'v1':

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen, y vamos a añadir una nueva
opción, -p 8001:8000. Esta opción hará que el puerto interno 8000 del contenedor
sea expuesto en el puerto 8001 de nuestra máquina:

<syntaxhighlight lang="bash">
podman run --name my-app --rm -d -p 8001:8000 app:v1
</syntaxhighlight>

''Nota:'' podman supone que la redirección de puerto es TCP, para una redirección de puertos UDP, puedes usar:

<syntaxhighlight lang="bash">
... -p 8001:8000/udp
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código. En nuestra
máquina haremos:

<syntaxhighlight lang="bash">
curl -X GET http://localhost:8001/welcome?username=LSO
</syntaxhighlight>

Comprobaremos que la salida del comando curl, es "Welcome LSO".

Antes de terminar, vamos a comprobar otro pequeño detalle que añadimos en
nuestra imagen, la variable de entorno USERNAME, vamos a comprobar que funciona:

<syntaxhighlight lang="bash">
podman exec -ti my-app ash
echo $USERNAME
</syntaxhighlight>

Funciona correctamente, pero al ejecutar el contenedor, podemos cambiar esta
variable de entorno como vimos en uno de los pasos anteriores:

<syntaxhighlight lang="bash">
podman run --rm -ti -e USERNAME=me app:v1 ash
echo $USERNAME
</syntaxhighlight>

Esto nos servirá para tener opciones por defecto y que el usuario pueda
cambiarlo a su antojo, como por ejemplo contraseñas u otros detalles.

= Paso 12: Eliminar imágenes =

Para borrar una imagen, puede hacer:

<syntaxhighlight lang="bash">
podman image rm hello-world
</syntaxhighlight>

= Paso 13: Varios podman a la vez (podman-compose) =

Antes de comenzar, vamos a parar todos los contenedores que tengamos abiertos,
para dejar el entorno de podman limpio, que nos vendrá bien para esta parte.

Cuando queremos ejecutar varios contenedores a la vez y que estén conectados
entre ellos fácilmente, utilizaremos podman-compose, donde con un fichero de
configuración simple en yaml, tendremos toda la configuración de lo que vamos a
ejecutar.

Primero vamos a instalar podman-compose:

<syntaxhighlight lang="bash">
sudo apt install podman-compose
</syntaxhighlight>

Ahora veamos un pequeño ejemplo donde explicaremos todos los detalles para crear
un podman-compose, en este caso, el nombre por defecto de los ficheros suele ser
podman-compose.yml, y el contenido será similar a:

<syntaxhighlight lang="bash">
version: '3'

services:
web:
container_name: web
restart: always
build:
context: .
ports:
- "8000:8000"
volumes:
- /home/ubuntu/volume:/volumen:rw
environment:
USERNAME: test
web2:
container_name: web2
build:
dockerfile: Dockerfile
context: .
depends_on:
- web
command: touch web2
web3:
container_name: web3
restart: on-failure
image: pstauffer/curl
depends_on:
- web
command: curl -X GET web:8000/welcome?username=web3
</syntaxhighlight>

En el podman-compose definimos diferentes servicios a ejecutar, en nuestro caso
hemos iniciado tres servicios diferentes, web, web2 y web3:

El primer servicio, web:

* container_name: para darle un nombre por defecto al contenedor cuando se cree
* restart: pueden ser:
** "no": si la máquina termina, no se vuelve a iniciar (opción por defecto)
** always: siempre que el contenedor termine, intenta iniciarse de nuevo
** on-failure: solo intenta reiniciarse si el contenedor termina con fallo
** unless-stopped: solo reinicia el contenedor si el usuario es el que lo termina
* Utilizará el fichero Dockerfile creado en el paso 11 para generar la imagen a usar.
* Expondrá el puerto 8000 del contenedor en el 8000 de nuestra máquina
* Montará un volumen, se hace de forma similar a la línea de comandos
* Creará una variable de entorno

El segundo servicio, web2:

* Utilizará el fichero Dockerfile también, la diferencia entre este y el primer servicio, es que si el nombre del Dockerfile cambia, tendremos que hacerlo de esta segunda forma, la primera por defecto solo buscará el fichero Dockerfile
* depends_on hará que para ejecutar este servicio, su dependencia tenga ya que estar iniciada
* Ejecutaremos un comando el cual sustituirá al comando de la imagen

El tercer servicio, web3:

* Utilizará la imagen ostauffer/curl que es un imagen mínima que contiene el comando curl
* restart: en este caso, hasta que el comando no se ejecute correctamente, se seguirá reiniciando el contenedor
* depends_on igual que el servicio 2, dependerá del servicio 1
* Ejecutaremos un comando para llamar desde el servicio 3 al servicio 1

== Paso 13.1: Construir podman-compose ==

En el caso de existir servicios que tengan Dockerfiles, esto hará que se construyan previamente, como hacer un podman build de cada uno de los servicios que contenga un Dockerfile:

<syntaxhighlight lang="bash">
podman-compose build
</syntaxhighlight>

Con esto se generarán las imágenes necesarias para ejecutar todos los servicios.

== Paso 13.2: Iniciar podman-compose ==

Para iniciar todos los servicios, ejecutaremos:

<syntaxhighlight lang="bash">
podman-compose up -d
</syntaxhighlight>

Después de esto podremos ver el logs de todos los servicios:

<syntaxhighlight lang="bash">
podman-compose logs -f
</syntaxhighlight>

Aquí veremos que el servicio 3 ha conseguido llamar correctamente al servicio 1.

Ahora veremos como podman-compose ha creado los contenedores:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

La salida será similar a la siguiente:

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
219a4118244c pstauffer/curl "curl -X GET web:800…" 6 seconds ago Exited (0) 3 seconds ago web3
c97e894cb3ae ubuntu_web2 "touch web2" 6 seconds ago Exited (0) 4 seconds ago web2
f35d034204fc ubuntu_web "/bin/sh -c 'hug -f …" 6 seconds ago Up 5 seconds 0.0.0.0:8000->8000/tcp web
</syntaxhighlight>

Aquí vemos varios detalles:

* El nombre que le hemos dado en el podman-compose ha funcionado correctamente
* Vemos que los comandos son los correctos también
* web2 está parado por que la política de reinicio es apagar cuando se termine de ejecutar un comando
* web 3 está parado por que el comando ha terminado con un salida correcta

Vamos a comprobar ahora que en el servicio web está todo correcto:

<syntaxhighlight lang="bash">
podman exec -ti web ash
echo $USERNAME
ls /volumen
exit
</syntaxhighlight>

Podemos comprobar que tanto cambiar la variable de entorno como crear un
volumen ha funcionado correctamente.

== Paso 13.3: Parar podman-compose ==

Para parar todos los servicios:

<syntaxhighlight lang="bash">
podman-compose down
</syntaxhighlight>

Comprobamos:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Vemos que han desaparecido todos los contenedores.

= Paso 14: Ejercicios =

== Ejercicio 1: Image derivada de Debian con el programa sl ==

Lance un contenedor a partir de una imagen de Debian, instale el programa sl, ejecute sl (desde fuera del contenedor) y detenga el contenedor.

== Ejercicio 2 ==

== Ejercicio 3: Variante de httpd ==

Construya una imagen ''httpd-hola-mundo'' a partir de la imagen ''httpd''. El fichero de index.html de la carpeta htdocs/ tiene que mostrar el mensaje "hola mundo".

<syntaxhighlight lang="bash">
podman pull httpd
</syntaxhighlight>

Edita el fichero Dockerfile:

<syntaxhighlight lang="bash">
nano Dockerfile
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
FROM httpd

COPY index.html htdocs/index.html
</syntaxhighlight>

Edita el fichero index.html:

<syntaxhighlight lang="bash">
nano index.html
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

Construye la imagen:

<syntaxhighlight lang="bash">
podman build -t mihttpd -f Dockerfile .
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen:

<syntaxhighlight lang="bash">
podman run --name mihttpd -d -p 8080:80 mihttpd
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código:
<syntaxhighlight lang="bash">
curl -X GET http://localhost:8080
</syntaxhighlight>

Tiene que salir por pantalla esto:
<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

== Ejercicio 4: aplicación flask ==

Flask es un framework python para implementar webs. Cree una imagen "miapp-flask" a partir de la imagen de "python":

* Instale flask mediante: pip install flask
* Cree la carpeta "app"
* Establezca la variable FLASK_APP a "hello.py"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"

El fichero hello.py contiene un "hola mundo" para Flask:

<syntaxhighlight lang="python">
from flask import Flask
app = Flask(__name__)

@app.route("/")
def hello():
return "Hello World!"

if __name__ == "__main__":
app.run()
</syntaxhighlight>

Solución con alpine:

<syntaxhighlight lang="bash">
FROM python:alpine

RUN mkdir /app
RUN pip install flask
ENV FLASK_APP="app/hello.py"
COPY hello.py
WORKDIR /
CMD flask run --host=0.0.0.0
</syntaxhighlight>

Solución con Ubuntu:

<syntaxhighlight lang="bash">
FROM ubuntu:bionic

RUN apt-get update
RUN apt-get -y install python python-pip wget
RUN pip install Flask
ENV FLASK_APP="app/hello.py"
RUN mkdir /app
COPY hello.py /app
CMD flask run --host=0.0.0.0
</syntaxhighlight>

== Ejercicio 5: mysql ==

'''EN LA MÁQUINA VIRTUAL:'''

mkdir miapp
cd miapp
podman pull mysql
nano Dockerfile

<syntaxhighlight lang="bash">
FROM mysql
ENV MYSQL_ROOT_PASSWORD="lacontraseñaqueyoquiera"
RUN mkdir /app
WORKDIR /app

</syntaxhighlight>

CTRL+O , ENTER Y CTRL+X (para guardar Dockerfile y salir)

podman build -ti mrfdocker -f Dockerfile .
podman run --name mymrf --rm -p 8001:3306 mrfdocker
docker images

'''EN LA TERMINAL DEL HOST:'''

''Instalación de mysql:''

apt install mysql-client-core-5.7
apt-get install mysql-server
service mysql start

''Para entrar:''

mysql -u root -p -P 8001

Una vez dentro de msql:

mysql> show databases;

''Para salir:''

exit

== Ejercicio 6: python pyramid ==

Pyramid es un framework python para implementar webs. Cree una imagen "miapp-pyramid":

* Emplee la imagen de debian como referencia, instale los paquetes python3 y python3-pyramid.
* Cree la carpeta "app"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"
* La aplicación se lanza con la orden: python hello.py
* Compruebe que funciona con curl, la ruta a la web es http://127.0.0.1:8000/hello, suponiendo que ha empleado el puerto 8000 para exponer el servicio.

El fichero hello.py contiene un "hola mundo" para Pyramid:

<syntaxhighlight lang="bash">
from wsgiref.simple_server import make_server
from pyramid.config import Configurator
from pyramid.response import Response

def hello_world(request):
print('Request inbound!')
return Response('Podman works with Pyramid!')

if __name__ == '__main__':
config = Configurator()
config.add_route('hello', '/')
config.add_view(hello_world, route_name='hello')
app = config.make_wsgi_app()
server = make_server('0.0.0.0', 6543, app)
server.serve_forever()
</syntaxhighlight>

Este programa recibe peticiones en el puerto 6543.

== Ejercicio 7 ==

Cree una imagen derivada de Ubuntu, instale el paquete apache2, php y libapache2-mod-php.
Active el módulo de php para apache2 mediante la orden:

<syntaxhighlight lang="bash">
a2enmod php
</syntaxhighlight>

Cree la carpeta /var/www/php.

Cree el fichero index.php

<syntaxhighlight lang="php">
<?php
Print "Hello, World!";
?>
</syntaxhighlight>

y copielo a /var/www/php/.

Cree el fichero 000-default.conf y copielo a /etc/apache2/sites-enabled/

Dicho fichero contiene.

<syntaxhighlight lang="bash">
<VirtualHost *:80>
DocumentRoot /var/www/php

<Directory /var/www/php/>
Options Indexes FollowSymLinks MultiViews
AllowOverride All
Order deny,allow
Allow from all
</Directory>

ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>
</syntaxhighlight>

Tiene que lanzar apache con la orden: apachectl -D FOREGROUND

Tras crear la imagen, láncela mapeando el puerto 8888 al 80, pruebe que puede acceder a http://127.0.0.1:8888/php/ mediante curl

Solución:

<syntaxhighlight lang="bash">
FROM ubuntu:latest

RUN apt-get update
RUN apt-get install -y tzdata
RUN apt-get install -y apache2
RUN apt-get install -y php
RUN apt-get install -y libapache2-mod-php
RUN a2enmod php7.2
COPY index.php /var/www/php
COPY 000-default.conf /etc/apache2/sites-enabled/
CMD apachectl -D FOREGROUND
</syntaxhighlight>

Y para lanzarlo:

podman run --name my-app --rm -d -p 8001:8000 app:v1

y para probarlo:

curl -X GET http://127.0.0.1:8888/php/

== Ejercicio 8 ==

Instale el paquete ''netcat-traditional'' en una imagen de contenedor de ''ubuntu''. Lance la orden:

nc -u -l -p 8080

en el contenedor. Asegúrese de crear una redirección de puertos de 9999 desde el ''host'' al puerto 8080 en el contenedor.

Desde fuera del contenedor, pruebe a conectarse con:

nc -u 127.0.0.1 9999

== Ejercicio 9 ==

Cree una imagen derivada de "ubuntu" con un Dockerfile que incluya soporte de python y lance el siguiente código en Python:

<syntaxhighlight lang="python">
from http.server import BaseHTTPRequestHandler, HTTPServer
import time

hostName = "0.0.0.0"
serverPort = 8080

class MyServer(BaseHTTPRequestHandler):
def do_GET(self):
self.send_response(200)
self.send_header("Content-type", "text/html")
self.end_headers()
self.wfile.write(bytes("<html><head><title>Welcome!</title></head>", "utf-8"))
self.wfile.write(bytes("<body>", "utf-8"))
self.wfile.write(bytes("This is an example web server.", "utf-8"))
self.wfile.write(bytes("</body></html>", "utf-8"))

if __name__ == "__main__":
webServer = HTTPServer((hostName, serverPort), MyServer)
print("Server started http://%s:%s" % (hostName, serverPort))

try:
webServer.serve_forever()
except KeyboardInterrupt:
pass

webServer.server_close()
print("Server stopped.")
</syntaxhighlight>

Llame a su imagen "python-http-server". Lance una instancia de la imagen "python-http-server" mapeando el puerto 9999 al puerto 8888/tcp del contenedor. Compruebe con:

<syntaxhighlight lang="bash">
curl http://127.0.0.1:9999/
</syntaxhighlight>

que muestre la página HTML que ofrece el servidor, que debería ser:

<syntaxhighlight lang="bash">
<html><head><title>Welcome!</title></head><body>This is an example web server.</body></html>
</syntaxhighlight>

Contenedores

2025-12-15T12:36:47Z

Pneira: /* Paso 11: Crear nuestra propia imagen de contenedor */

En esta práctica aprenderemos a utilizar [https://es.wikipedia.org/wiki/Podman podman] para desplegar contenedores.

= Paso 1: Instalar podman =

Para instalar el paquete oficial:

<syntaxhighlight lang="bash">
apt install podman
</syntaxhighlight>

podman es un clon de '''docker''.

Si añade un usuario 'test' a su sistema con:

<syntaxhighlight lang="bash">
adduser test
</syntaxhighlight>

recuerde hacer:

<syntaxhighlight lang="bash">
loginctl enable-linger test
systemctl start --user dbus
</syntaxhighlight>

para evitar un warning que se muestra al ejecutar '''podman''' como usuario.

= Paso 2: Repositorio de imágenes de contenedores DockerHub =

Docker ofrece un servicio de nube denominado ''DockerHub'' que puede ser empleado como red social para compartir tus imágenes de Podman. En ''DockerHub'' existen además imágenes de contenedores preconfiguradas de software, muchas de ellas oficiales (ofrecidas por el propio fabricante del software) que se podrán emplear como base para construir nuevas imágenes adaptadas a nuestras necesidades.

Podremos realizar búsquedas en este repositorio ''DockerHub'' puedes emplear el siguiente comando:

<syntaxhighlight lang="bash">
podman search docker.io/library/hello-world
</syntaxhighlight>

Para descargarnos la imagen de ''hello-world'' podemos usar la orden ''pull'':

<syntaxhighlight lang="bash">
podman pull docker.io/library/hello-world
</syntaxhighlight>

También podemos publicar imágenes propias, esto require '''registro de usuario''' en la nube de ''DockerHub'', lo que '''no''' es obligatorio para la realización de esta práctica. Para subir una imagen, hay que validarse como usuario en la nube de ''DockerHub'':

<syntaxhighlight lang="bash">
podman login
</syntaxhighlight>

Tras introducir tu usuario y contraseña, puedes comenzar a publicar tus propias imágenes.

<syntaxhighlight lang="bash">
podman push MI_IMAGEN
</syntaxhighlight>

Este paso es '''opcional''', sólo en caso de que se quieran subir imágenes de contenedores a la nube de docker.io.

= Paso 4: Comprobar imágenes en nuestra máquina =

Para ver las imágenes que tenemos en nuestra máquina, utilizaremos el comando:

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Inicialmente, no tenemos imágenes en almacenamiento, podemos descargarnos la imagen oficial de Debian 13 (Trixie):

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian
</syntaxhighlight>

Ahora si, ya debería de aparecernos la imagen ''debian''.

Comentar también que cada imagen puede tener varias etiquetas, por ejemplo, la imagen Debian 12 (Bookworm), cuando la hemos visto en el listado de imágenes, venía con el tag latest, que es el tag que se descarga por defecto, pero nosotros podemos especificar otro, por ejemplo:

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian:bookworm
</syntaxhighlight>

Para traernos la versión de la imagen de Debian 12 ''Bookworm''.

Ahora tendremos dos imágenes con diferente etiqueta, que serían como las diferentes versiones de cada imagen.

= Paso 5: Lanzar un contenedor =

Un contenedor no es más que una imagen de podman ejecutándose, sería similar a
una máquina virtual, aunque mucho más liviano.

Para crear un contenedor, utilizaremos una imagen, en este caso, la imagen
hello-world. Hacemos lo siguiente:

<syntaxhighlight lang="bash">
podman run hello-world
</syntaxhighlight>

Esto nos mostrará el siguiente mensaje si todo está correcto:

<syntaxhighlight lang="bash">
Hello from Docker!
This message shows that your installation appears to be working correctly.

To generate this message, Docker took the following steps:
1. The Docker client contacted the Docker daemon.
2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
(amd64)
3. The Docker daemon created a new container from that image which runs the
executable that produces the output you are currently reading.
4. The Docker daemon streamed that output to the Docker client, which sent it
to your terminal.

To try something more ambitious, you can run an Debian container with:
$ podman run -it debian bash

Share images, automate workflows, and more with a free Docker ID:
https://hub.docker.com/

For more examples and ideas, visit:
https://docs.docker.com/get-started/
</syntaxhighlight>

Al crear los contenedores utilizando el comando 'run', tenemos varias opciones:

* Lanzar una terminal en el contenedor en modo interactivo
* Lanzar en segundo plano y conectarnos posteriormente al contenedor

== Paso 5.1: Lanzar una terminal en el contenedor en modo interactivo (-ti) ==

Para este ejemplo vamos a utilizar otra imagen diferente, en este caso vamos a utilizar una imagen de debian.

Vamos a lanzar un contenedor y ejecutar una terminal en el que se va a ejecutar el programa '''bash''' que me ofrece un interprete de órdenes:

<syntaxhighlight lang="bash">
podman run -ti debian bash
</syntaxhighlight>

La opción ''-t'' indica que se crea un terminal en el contenedor. Y la opción ''-i'' indica que el contenedor se ejecuta en modo interactivo.

Al acceder al contenedor de ''debian'' nos aparece un ''hash'' en el prompt de la shell, que identifica a la instancia del contenedor (es valor es similar al que muestra la orden ''podman container ls'').

Para salir del contenedor, escribimos 'exit' o pulsamos ''CTRL + D''

== Paso 5.2 Lanzar en segundo plano (-d) ==

Otro ejemplo, con la imagen de Debian:

<syntaxhighlight lang="bash">
podman run -dti debian
</syntaxhighlight>

que muestra un hash que identifica de forma única el contenedor lanzado:

<syntaxhighlight lang="bash">
2ec1daae4676a4e84dc04fd91399c1dfe92119544ff12ee307991fe573d3db64
</syntaxhighlight>

Mediante el comando ''attach'' puedo entrar al contenedor:

<syntaxhighlight lang="bash">
podman attach 2ec1daae4676
</syntaxhighlight>

Para salir, pulsamos ''CTRL + P'' seguido de ''CTRL + Q''.

De manera similar, puedo lanzar en segundo plano la imagen de contenedor de ''hello-world'':

<syntaxhighlight lang="bash">
podman run -d hello-world
</syntaxhighlight>

Y consultar los logs:

<syntaxhighlight lang="bash">
podman logs b67fae3312bc321
</syntaxhighlight>

== Paso 5.3: Añadir variables de entorno a un contenedor ==

Utilizaremos la imagen anterior, y vamos a añadir una variable de entorno
llamada TEST que contenga el valor 'test'. A parte, también ejecutaremos la
terminal como antes, para comprobar con el comando echo, que la variable de
entorno está creada correctamente:

<syntaxhighlight lang="bash">
podman run -ti -e TEST=test debian bash
</syntaxhighlight>

Ahora, desde el contenedor podemos comprobar el valor de la variable de entorno ''$TEST''.

<syntaxhighlight lang="bash">
echo $TEST
test
</syntaxhighlight>

= Paso 6: Listar contenedores en ejecución =

Hemos estado haciendo pruebas y ejecutando contenedores en el paso anterior, vamos a ver donde se encuentran estos contenedores que hemos ejecutado, y después veremos algunas opciones más del comando run.

Tenemos dos opciones para ver los contenedores:

<syntaxhighlight lang="bash">
podman container ls -a
</syntaxhighlight>

o la versión corta:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Ambas hacen lo mismo, y debería de mostrarnos una salida similar a la siguiente:

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
e2bde5f5500c debian "bash" 6 minutes ago Exited (0) 2 seconds ago pensive_sammet
544ad27dbc3c debian "bash" 7 minutes ago Exited (0) 7 minutes ago serene_elgamal
</syntaxhighlight>

En la información veremos que el contenedor tiene el estado exited, eso quiere decir que no se está ejecutando y ya ha finalizado. Vamos a hacer una prueba para ver un contendor ejecutándose:

<syntaxhighlight lang="bash">
podman run -d debian sleep 30
</syntaxhighlight>

Con el comando sleep 30 esperamos 30 segundos hasta que termine el comando, asíque durante esos 30 segundos, el contenedor estará ejecutándose, veámoslo:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
eacceb27d52d debian "sleep 30" 12 seconds ago Up 11 seconds sharp_pasteur
</syntaxhighlight>

Vamos a ver alguna opciones más de la orden ''run''.

== Paso 6.1: Dar un nombre al contenedor (--name) ==

Por defecto, podman creará automáticamente un nombre como hemos visto en las salidas del comando ''podman ps -a''. Podemos establecer el nombre del contenedor que queramos con la opción ''--name'':

<syntaxhighlight lang="bash">
podman run -ti --name mi_debian debian
</syntaxhighlight>

== Paso 6.2: Eliminar contenedor cuando termine (--rm) ==

Vamos a mezclar todo lo visto anteriormente:

* Lanzar en segundo plano (-d)
* Ejecutar contenedor durante 30 segundos (sleep 30)
* Dar un nombre a la imagen (--name)
* Eliminar contenedor cuando termine (--rm)

<syntaxhighlight lang="bash">
podman run -d --rm --name bye-bye debian sleep 30
</syntaxhighlight>

Antes y una vez pasados los 30 segundos, podemos comprobar que el contenedor ha desaparecido.

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

= Paso 7: Parar y eliminar contenedores =

Para parar contenedores podemos usar el ID o su nombre:

<syntaxhighlight lang="bash">
podman stop my_container
podman stop e4901956f108
podman ps -a
</syntaxhighlight>

Una vez hemos comprobado que han terminado su ejecución, podemos eliminar los ficheros resultantes de su ejecución:

<syntaxhighlight lang="bash">
podman container rm my_container
</syntaxhighlight>

Para borrar todos los contenedores ya finalizados

<syntaxhighlight lang="bash">
podman container prune
</syntaxhighlight>

= Paso 8: Conectarnos a un contenedor que se está ejecutando en segundo plano =

Vamos a ejecutar de nuevo un contenedor que no termine:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a conectarnos a este contenedor que está ejecutándose en segundo
plano:

<syntaxhighlight lang="bash">
podman attach mi-contenedor
</syntaxhighlight>

Veremos la orden bash ejecutándose, para terminar, hacemos un 'CTRL + C', y ahora, veremos que ha pasado con el contenedor:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Lo veremos parado, por que lo que hemos hecho ha sido conectarnos al contenedor
y parar el comando que se estaba ejecutando, así que ahora tenemos el contenedor
finalizado.

''Nota:'' Para salir del contenedor '''sin detenerlo''' hacemos 'CTRL + P' seguido 'CTRL + Q'

= Paso 9: Ejecutar un comando dentro de un contenedor en ejecución =

Vamos a ver otresta vez como ejecutar un comando en un contenedor que ya está
ejecutándose:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a ejecutar un comando en ese contenedor con el nombre ''mi-contenedor''.
El comando exec es similar al comando run, pero para ejecutar un comando dentro de un contenedor:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor ls
</syntaxhighlight>

Para redirigir la salida a un fichero en el anfitrión:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor ls > x.txt
</syntaxhighlight>

Para redirigir la salida a un fichero ''dentro'' del contenedor, hacemos:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor sh -c "ls > x.txt"
</syntaxhighlight>

También es posible ejecutar comandos con tuberías:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor sh -c "ls -la | grep ^d"
</syntaxhighlight>

= Paso 10: Persistencia en contenedores =

Al hacer ''exit'' y salir de un contenedor, se pierden todos los cambios que hemos realizado. Los

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-ejemplo debian bash
</syntaxhighlight>

Ahora, vamos a crear una carpeta en el contenedor y comprobar que esa carpeta existe:

<syntaxhighlight lang="bash">
podman exec mi-ejemplo mkdir test
podman exec mi-ejemplo ls
</syntaxhighlight>

Veremos que la carpeta existe, pero, ¿qué ocurre si para el contenedor?

<syntaxhighlight lang="bash">
podman container stop mi-ejemplo
</syntaxhighlight>

Y volvemos a lanzarlo:

<syntaxhighlight lang="bash">
podman container rm mi-ejemplo
podman run -d -ti --name mi-ejemplo debian bash
podman exec mi-ejemplo ls
</syntaxhighlight>

Podemos comprobar que la carpeta creada anteriormente, no existe.

¿Qué podemos hacer para mantener la modificaciones realizadas sobre un contenedor?

== Paso 10.1: Crear una imagen derivada de la imagen base ==

Es posible crear una imagen derivada, con modificaciones, a partir de una imagen existente mediante la orden '''commit'''.

Por ejemplo, si queremos una imagen ''debian'' que incluya el programa ''ping'' ya instalado, tendríamos que lanzar un contenedor a partir de la imagen ''ubuntu'':

<syntaxhighlight lang="bash">
podman run -d -ti debian bash
</syntaxhighlight>

Suponiendo que el contenido está identificado con el ID 56ef5b312334

Instalamos el paquete ping:

<syntaxhighlight lang="bash">
podman exec 56ef5b312334 apt -y install ping
</syntaxhighlight>

Generamos la imagen derivada con el nombre ''ubuntu-con-ping'':

<syntaxhighlight lang="bash">
podman commit 56ef5b312334 ubuntu-con-ping
</syntaxhighlight>

Ya podemos para nuestro contendor:

<syntaxhighlight lang="bash">
podman stop 56ef5b312334
</syntaxhighlight>

Y lanzar un nuevo contenedor a partir de la imagen ''debian-con-ping'':

<syntaxhighlight lang="bash">
podman run -d -ti debian-con-ping bash
</syntaxhighlight>

== Paso 10.2: Mantener la persistencia mediante volúmen ==

Otra opción para mantener los datos es montar un volumen al ejecutar el contenedor.

Primero crearemos una carpeta que hará de volumen en nuestra máquina, que será la que luego montemos para podman:

<syntaxhighlight lang="bash">
mkdir /home/debian/volumen
</syntaxhighlight>

Ahora vamos a montar la carpeta al ejecutar el contenedor, lo hacemos con la
opción -v, la cual tiene 3 campos separados por ':':

# El volumen en nuestra máquina
# Donde se montará el volumen dentro del contenedor
# Opciones de mmontaje, por ejemplo rw (read and write) o ro (read only)

<syntaxhighlight lang="bash">
podman run --rm -ti -v /home/debian/volumen:/volumen:rw debian bash
mkdir /volumen/test
touch /volumen/test/file
exit
</syntaxhighlight>

Una vez nos salgamos del contenedor, podemos ver que en nuestra máquina están
los datos:

<syntaxhighlight lang="bash">
ls /home/ubuntu/volumen/
ls /home/ubuntu/volumen/test
</syntaxhighlight>

La próxima vez que ejecutemos un contenedor, si montamos ese volumen, los datos
estarán ahí, además esta forma tiene el beneficio de compartir datos entre
nuestra máquina y el contenedor de forma sencilla.

= Paso 11: Crear nuestra propia imagen de contenedor =

Para crear una imagen de un contenedor con una aplicación de Python hug, creamos en primer lugar la carpeta que contendrá los ficheros que nos permiten crear la imagen.

<syntaxhighlight lang="bash">
mkdir miapp
cd miapp
</syntaxhighlight>

Definimos un fichero ''Dockerfile'' para definir la imagen:

<syntaxhighlight lang="bash">
FROM ubuntu

RUN apt -y update
RUN apt -y upgrade
RUN apt -y install python3-hug
RUN mkdir /app
COPY endpoint.py /app
WORKDIR /app
CMD hug -f endpoint.py
</syntaxhighlight>

Alternativamente, puedes crear un [[Creando imagen propia usando Ubuntu de base|Dockerfile empleando la imagen de Ubuntu]] como base en lugar de Alpine.

Y añadimos el fichero ''endpoint.py'' que emplea el framework Python hug con el contenido siguiente:

<syntaxhighlight lang="bash">
import hug

@hug.get('/welcome')
def welcome(username="unknown"):
""" Say welcome to username """
return "Welcome " + username
</syntaxhighlight>

Este fichero es un ejemplo de uso de Python hug. Si hacemos una petición a /welcome?username="LSO", esto nos devolverá el mensaje "Welcome LSO".

Una vez tengamos los dos ficheros creados en nuestra máquina virtual, podemos construir nuestra imagen:

<syntaxhighlight lang="bash">
podman build -t app:v1 -f Dockerfile .
</syntaxhighlight>

Vamos a explicar para que sirve cada línea:

* FROM: servirá para basarnos en una imagen existente, en este caso, una imagen de python alpine, que contiene python y no ocupa mucho espacio
* ENV: para crear variables de entorno
* RUN: para ejecutar comandos, ya sea para crear una carpeta, instalar dependencias o cualquier otra opción que necesitemos
* COPY: para copiar datos desde nuestra máquina a la imagen
* WORKDIR: para cambiar el directorio de trabajo (lo crea si no existe)
* CMD: este comando será ejecutado por defecto al iniciar un contenedor a partir de esta imagen

Esto construirá una imagen podman basada en python:alpine, en la cual hemos
guardado nuestra pequeña aplicación y se va a ejecutar cuando ejecutemos un
contenedor basado en esa imagen. Para comprobar que la imagen se ha creado
correctamente, listamos las imagenes, y debería de aparecernos una imagen con
nombre 'app' y tag 'v1':

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen, y vamos a añadir una nueva
opción, -p 8001:8000. Esta opción hará que el puerto interno 8000 del contenedor
sea expuesto en el puerto 8001 de nuestra máquina:

<syntaxhighlight lang="bash">
podman run --name my-app --rm -d -p 8001:8000 app:v1
</syntaxhighlight>

''Nota:'' podman supone que la redirección de puerto es TCP, para una redirección de puertos UDP, puedes usar:

<syntaxhighlight lang="bash">
... -p 8001:8000/udp
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código. En nuestra
máquina haremos:

<syntaxhighlight lang="bash">
curl -X GET http://localhost:8001/welcome?username=LSO
</syntaxhighlight>

Comprobaremos que la salida del comando curl, es "Welcome LSO".

Antes de terminar, vamos a comprobar otro pequeño detalle que añadimos en
nuestra imagen, la variable de entorno USERNAME, vamos a comprobar que funciona:

<syntaxhighlight lang="bash">
podman exec -ti my-app ash
echo $USERNAME
</syntaxhighlight>

Funciona correctamente, pero al ejecutar el contenedor, podemos cambiar esta
variable de entorno como vimos en uno de los pasos anteriores:

<syntaxhighlight lang="bash">
podman run --rm -ti -e USERNAME=me app:v1 ash
echo $USERNAME
</syntaxhighlight>

Esto nos servirá para tener opciones por defecto y que el usuario pueda
cambiarlo a su antojo, como por ejemplo contraseñas u otros detalles.

= Paso 12: Eliminar imágenes =

Para borrar una imagen, puede hacer:

<syntaxhighlight lang="bash">
podman image rm hello-world
</syntaxhighlight>

= Paso 13: Varios podman a la vez (podman-compose) =

Antes de comenzar, vamos a parar todos los contenedores que tengamos abiertos,
para dejar el entorno de podman limpio, que nos vendrá bien para esta parte.

Cuando queremos ejecutar varios contenedores a la vez y que estén conectados
entre ellos fácilmente, utilizaremos podman-compose, donde con un fichero de
configuración simple en yaml, tendremos toda la configuración de lo que vamos a
ejecutar.

Primero vamos a instalar podman-compose:

<syntaxhighlight lang="bash">
sudo apt install podman-compose
</syntaxhighlight>

Ahora veamos un pequeño ejemplo donde explicaremos todos los detalles para crear
un podman-compose, en este caso, el nombre por defecto de los ficheros suele ser
podman-compose.yml, y el contenido será similar a:

<syntaxhighlight lang="bash">
version: '3'

services:
web:
container_name: web
restart: always
build:
context: .
ports:
- "8000:8000"
volumes:
- /home/ubuntu/volume:/volumen:rw
environment:
USERNAME: test
web2:
container_name: web2
build:
dockerfile: Dockerfile
context: .
depends_on:
- web
command: touch web2
web3:
container_name: web3
restart: on-failure
image: pstauffer/curl
depends_on:
- web
command: curl -X GET web:8000/welcome?username=web3
</syntaxhighlight>

En el podman-compose definimos diferentes servicios a ejecutar, en nuestro caso
hemos iniciado tres servicios diferentes, web, web2 y web3:

El primer servicio, web:

* container_name: para darle un nombre por defecto al contenedor cuando se cree
* restart: pueden ser:
** "no": si la máquina termina, no se vuelve a iniciar (opción por defecto)
** always: siempre que el contenedor termine, intenta iniciarse de nuevo
** on-failure: solo intenta reiniciarse si el contenedor termina con fallo
** unless-stopped: solo reinicia el contenedor si el usuario es el que lo termina
* Utilizará el fichero Dockerfile creado en el paso 11 para generar la imagen a usar.
* Expondrá el puerto 8000 del contenedor en el 8000 de nuestra máquina
* Montará un volumen, se hace de forma similar a la línea de comandos
* Creará una variable de entorno

El segundo servicio, web2:

* Utilizará el fichero Dockerfile también, la diferencia entre este y el primer servicio, es que si el nombre del Dockerfile cambia, tendremos que hacerlo de esta segunda forma, la primera por defecto solo buscará el fichero Dockerfile
* depends_on hará que para ejecutar este servicio, su dependencia tenga ya que estar iniciada
* Ejecutaremos un comando el cual sustituirá al comando de la imagen

El tercer servicio, web3:

* Utilizará la imagen ostauffer/curl que es un imagen mínima que contiene el comando curl
* restart: en este caso, hasta que el comando no se ejecute correctamente, se seguirá reiniciando el contenedor
* depends_on igual que el servicio 2, dependerá del servicio 1
* Ejecutaremos un comando para llamar desde el servicio 3 al servicio 1

== Paso 13.1: Construir podman-compose ==

En el caso de existir servicios que tengan Dockerfiles, esto hará que se construyan previamente, como hacer un podman build de cada uno de los servicios que contenga un Dockerfile:

<syntaxhighlight lang="bash">
podman-compose build
</syntaxhighlight>

Con esto se generarán las imágenes necesarias para ejecutar todos los servicios.

== Paso 13.2: Iniciar podman-compose ==

Para iniciar todos los servicios, ejecutaremos:

<syntaxhighlight lang="bash">
podman-compose up -d
</syntaxhighlight>

Después de esto podremos ver el logs de todos los servicios:

<syntaxhighlight lang="bash">
podman-compose logs -f
</syntaxhighlight>

Aquí veremos que el servicio 3 ha conseguido llamar correctamente al servicio 1.

Ahora veremos como podman-compose ha creado los contenedores:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

La salida será similar a la siguiente:

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
219a4118244c pstauffer/curl "curl -X GET web:800…" 6 seconds ago Exited (0) 3 seconds ago web3
c97e894cb3ae ubuntu_web2 "touch web2" 6 seconds ago Exited (0) 4 seconds ago web2
f35d034204fc ubuntu_web "/bin/sh -c 'hug -f …" 6 seconds ago Up 5 seconds 0.0.0.0:8000->8000/tcp web
</syntaxhighlight>

Aquí vemos varios detalles:

* El nombre que le hemos dado en el podman-compose ha funcionado correctamente
* Vemos que los comandos son los correctos también
* web2 está parado por que la política de reinicio es apagar cuando se termine de ejecutar un comando
* web 3 está parado por que el comando ha terminado con un salida correcta

Vamos a comprobar ahora que en el servicio web está todo correcto:

<syntaxhighlight lang="bash">
podman exec -ti web ash
echo $USERNAME
ls /volumen
exit
</syntaxhighlight>

Podemos comprobar que tanto cambiar la variable de entorno como crear un
volumen ha funcionado correctamente.

== Paso 13.3: Parar podman-compose ==

Para parar todos los servicios:

<syntaxhighlight lang="bash">
podman-compose down
</syntaxhighlight>

Comprobamos:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Vemos que han desaparecido todos los contenedores.

= Paso 14: Ejercicios =

== Ejercicio 1: Image derivada de Debian con el programa sl ==

Lance un contenedor a partir de una imagen de Debian, instale el programa sl, ejecute sl (desde fuera del contenedor) y detenga el contenedor.

== Ejercicio 2 ==

== Ejercicio 3: Variante de httpd ==

Construya una imagen ''httpd-hola-mundo'' a partir de la imagen ''httpd''. El fichero de index.html de la carpeta htdocs/ tiene que mostrar el mensaje "hola mundo".

<syntaxhighlight lang="bash">
podman pull httpd
</syntaxhighlight>

Edita el fichero Dockerfile:

<syntaxhighlight lang="bash">
nano Dockerfile
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
FROM httpd

COPY index.html htdocs/index.html
</syntaxhighlight>

Edita el fichero index.html:

<syntaxhighlight lang="bash">
nano index.html
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

Construye la imagen:

<syntaxhighlight lang="bash">
podman build -t mihttpd -f Dockerfile .
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen:

<syntaxhighlight lang="bash">
podman run --name mihttpd -d -p 8080:80 mihttpd
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código:
<syntaxhighlight lang="bash">
curl -X GET http://localhost:8080
</syntaxhighlight>

Tiene que salir por pantalla esto:
<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

== Ejercicio 4: aplicación flask ==

Flask es un framework python para implementar webs. Cree una imagen "miapp-flask" a partir de la imagen de "python":

* Instale flask mediante: pip install flask
* Cree la carpeta "app"
* Establezca la variable FLASK_APP a "hello.py"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"

El fichero hello.py contiene un "hola mundo" para Flask:

<syntaxhighlight lang="python">
from flask import Flask
app = Flask(__name__)

@app.route("/")
def hello():
return "Hello World!"

if __name__ == "__main__":
app.run()
</syntaxhighlight>

Solución con alpine:

<syntaxhighlight lang="bash">
FROM python:alpine

RUN mkdir /app
RUN pip install flask
ENV FLASK_APP="app/hello.py"
COPY hello.py
WORKDIR /
CMD flask run --host=0.0.0.0
</syntaxhighlight>

Solución con Ubuntu:

<syntaxhighlight lang="bash">
FROM ubuntu:bionic

RUN apt-get update
RUN apt-get -y install python python-pip wget
RUN pip install Flask
ENV FLASK_APP="app/hello.py"
RUN mkdir /app
COPY hello.py /app
CMD flask run --host=0.0.0.0
</syntaxhighlight>

== Ejercicio 5: mysql ==

'''EN LA MÁQUINA VIRTUAL:'''

mkdir miapp
cd miapp
podman pull mysql
nano Dockerfile

<syntaxhighlight lang="bash">
FROM mysql
ENV MYSQL_ROOT_PASSWORD="lacontraseñaqueyoquiera"
RUN mkdir /app
WORKDIR /app

</syntaxhighlight>

CTRL+O , ENTER Y CTRL+X (para guardar Dockerfile y salir)

podman build -ti mrfdocker -f Dockerfile .
podman run --name mymrf --rm -p 8001:3306 mrfdocker
docker images

'''EN LA TERMINAL DEL HOST:'''

''Instalación de mysql:''

apt install mysql-client-core-5.7
apt-get install mysql-server
service mysql start

''Para entrar:''

mysql -u root -p -P 8001

Una vez dentro de msql:

mysql> show databases;

''Para salir:''

exit

== Ejercicio 6: python pyramid ==

Pyramid es un framework python para implementar webs. Cree una imagen "miapp-pyramid":

* Emplee la imagen de debian como referencia, instale los paquetes python3 y python3-pyramid.
* Cree la carpeta "app"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"
* La aplicación se lanza con la orden: python hello.py
* Compruebe que funciona con curl, la ruta a la web es http://127.0.0.1:8000/hello, suponiendo que ha empleado el puerto 8000 para exponer el servicio.

El fichero hello.py contiene un "hola mundo" para Pyramid:

<syntaxhighlight lang="bash">
from wsgiref.simple_server import make_server
from pyramid.config import Configurator
from pyramid.response import Response

def hello_world(request):
print('Request inbound!')
return Response('Podman works with Pyramid!')

if __name__ == '__main__':
config = Configurator()
config.add_route('hello', '/')
config.add_view(hello_world, route_name='hello')
app = config.make_wsgi_app()
server = make_server('0.0.0.0', 6543, app)
server.serve_forever()
</syntaxhighlight>

Este programa recibe peticiones en el puerto 6543.

== Ejercicio 7 ==

Cree una imagen derivada de Ubuntu, instale el paquete apache2, php y libapache2-mod-php.
Active el módulo de php para apache2 mediante la orden:

<syntaxhighlight lang="bash">
a2enmod php
</syntaxhighlight>

Cree la carpeta /var/www/php.

Cree el fichero index.php

<syntaxhighlight lang="php">
<?php
Print "Hello, World!";
?>
</syntaxhighlight>

y copielo a /var/www/php/.

Cree el fichero 000-default.conf y copielo a /etc/apache2/sites-enabled/

Dicho fichero contiene.

<syntaxhighlight lang="bash">
<VirtualHost *:80>
DocumentRoot /var/www/php

<Directory /var/www/php/>
Options Indexes FollowSymLinks MultiViews
AllowOverride All
Order deny,allow
Allow from all
</Directory>

ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>
</syntaxhighlight>

Tiene que lanzar apache con la orden: apachectl -D FOREGROUND

Tras crear la imagen, láncela mapeando el puerto 8888 al 80, pruebe que puede acceder a http://127.0.0.1:8888/php/ mediante curl

Solución:

<syntaxhighlight lang="bash">
FROM ubuntu:latest

RUN apt-get update
RUN apt-get install -y tzdata
RUN apt-get install -y apache2
RUN apt-get install -y php
RUN apt-get install -y libapache2-mod-php
RUN a2enmod php7.2
COPY index.php /var/www/php
COPY 000-default.conf /etc/apache2/sites-enabled/
CMD apachectl -D FOREGROUND
</syntaxhighlight>

Y para lanzarlo:

podman run --name my-app --rm -d -p 8001:8000 app:v1

y para probarlo:

curl -X GET http://127.0.0.1:8888/php/

== Ejercicio 8 ==

Instale el paquete ''netcat-traditional'' en una imagen de contenedor de ''ubuntu''. Lance la orden:

nc -u -l -p 8080

en el contenedor. Asegúrese de crear una redirección de puertos de 9999 desde el ''host'' al puerto 8080 en el contenedor.

Desde fuera del contenedor, pruebe a conectarse con:

nc -u 127.0.0.1 9999

== Ejercicio 9 ==

Cree una imagen derivada de "ubuntu" con un Dockerfile que incluya soporte de python y lance el siguiente código en Python:

<syntaxhighlight lang="python">
from http.server import BaseHTTPRequestHandler, HTTPServer
import time

hostName = "0.0.0.0"
serverPort = 8080

class MyServer(BaseHTTPRequestHandler):
def do_GET(self):
self.send_response(200)
self.send_header("Content-type", "text/html")
self.end_headers()
self.wfile.write(bytes("<html><head><title>Welcome!</title></head>", "utf-8"))
self.wfile.write(bytes("<body>", "utf-8"))
self.wfile.write(bytes("This is an example web server.", "utf-8"))
self.wfile.write(bytes("</body></html>", "utf-8"))

if __name__ == "__main__":
webServer = HTTPServer((hostName, serverPort), MyServer)
print("Server started http://%s:%s" % (hostName, serverPort))

try:
webServer.serve_forever()
except KeyboardInterrupt:
pass

webServer.server_close()
print("Server stopped.")
</syntaxhighlight>

Llame a su imagen "python-http-server". Lance una instancia de la imagen "python-http-server" mapeando el puerto 9999 al puerto 8888/tcp del contenedor. Compruebe con:

<syntaxhighlight lang="bash">
curl http://127.0.0.1:9999/
</syntaxhighlight>

que muestre la página HTML que ofrece el servidor, que debería ser:

<syntaxhighlight lang="bash">
<html><head><title>Welcome!</title></head><body>This is an example web server.</body></html>
</syntaxhighlight>

Sistemas de archivos

2025-12-15T12:32:55Z

Pneira: /* Paso 8.3: Gestionar el almacenamiento */

= Paso 1: Añadir un disco a la máquina virtual =

Vamos a usar cualquier máquina virtual de debian cloud que hayamos usado
previamente y vamos a añadir dos discos virtuales para hacer pruebas.

# Abrimos la ventana de la máquina virtual a usar
# Nos movemos a Vista -> Detalles, y le damos al botón de 'Agregar hardware'
# Seleccionamos Almacenamiento, le damos un tamaño de 5GB y en el tipo de dispositivo seleccionamos 'dispositivo de disco'. Con estas opciones, pulsamos Finalizar., y ya tendremos nuestro disco creado.
# Repetir el paso anterior y crear otro disco de 4GB

Para crear un nuevo disco virtual desde el intérprete de órdenes:

<syntaxhighlight lang="bash">
qemu-img create -f qcow2 mi-disco.img 20G
</syntaxhighlight>

Para adjuntar este disco a una máquina virtual existente:

<syntaxhighlight lang="bash">
virsh attach-disk mi-mv /home/usuario/mi-disco.img vdb --cache none --subdriver qcow2 --config
</syntaxhighlight>

Esto va a adjuntar el disco virtual creando anteriormente a la máquina virtual cuyo nombre es ''mi-mv'' haciendo uso del driver paravirtualizado ''VirtIO''.

Ojo: ''virsh attach-disk'' requiere una ruta absoluta al disco virtual.

Posible errores:

* La máquina virtual a la que se quiere adjuntar el nuevo disco no existe

<syntaxhighlight lang="bash">
error: failed to get domain 'mi-mv'
</syntaxhighlight>

Consulte el listado de máquinas virtuales existentes con ''virsh''.

* El identificador del disco virtual ya existe:

<syntaxhighlight lang="bash">
error: Failed to attach disk
error: XML error: target 'vdb' duplicated for disk sources ...
</syntaxhighlight>

En este caso, indica que ''vdb'' ya está en uso para un disco virtual existente, por lo que debe emplear otro identificador tal como ''vdc'', ''vdd'', etc.

Para ver los discos virtuales de una máquina virtual:

<syntaxhighlight lang="bash">
virsh domblklist mi-mv
</syntaxhighlight>

que muestra una salida similar a:

<syntaxhighlight lang="bash">
Target Source
----------------------------------------------
hda /home/usuario/debian-cloud.img
vda /home/usuario/mi-disco.img
</syntaxhighlight>

Para eliminar un discho de la máquina virtual:

<syntaxhighlight lang="bash">
virsh detach-disk mi-mv vda --config
</syntaxhighlight>

= Paso 2: Ver discos en Linux =

Volvamos a la vista consola (Vista -> Consola) y arranquemos la máquina (Máquina virtual -> Ejecutar).

Para comprobar los discos añadidos en el paso 1 vamos a utilizar el comando '''lsblk''', el cual nos mostrará una salida similar a la siguiente:

<syntaxhighlight lang="bash">
NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT
sr0 11:0 1 1024M 0 rom
vda 252:0 0 2.2G 0 disk
├─vda1 252:1 0 2.1G 0 part /
├─vda14 252:14 0 4M 0 part
└─vda15 252:15 0 106M 0 part /boot/efi
vdb 252:16 0 20G 0 disk
</syntaxhighlight>

Aqui vemos que tenemos 3 discos:

* vda: el actual de la imagen cloud que añadimos al crear la máquina
* vdb: el disco que añadimos en el paso 1 de 5GB
* vdc: el disco que añadimos en el paso 1 de 4GB

También vemos que el disco vda tiene 3 particiones: vda1, vda14 y vda15

= Paso 3: Creación de particiones en Linux =

Vamos a utilizar ahora nuestro disco añadido de 20GB, en el paso anterior deberiamos de haber identificado cual es, en mi caso /dev/vdb, aseguraros cual es el vuestro y comenzaremos a particionar el disco:

<syntaxhighlight lang="bash">
fdisk /dev/vdb
</syntaxhighlight>

Desde fdisk, se pueden realizar las siguientes acciones:

* '''p''': Imprimir la tabla de particiones actual. Para un disco nuevo, la tabla de particiones está vacía y el tipo de particionado es DOS.
* '''t''': Establecer tipo de partición.
* '''g''': Cambia el tipo de particionado al esquema GPT.
* '''n''': Crear nueva partición, que solicita: El número de partición (si pulsamos intro, asigna una automáticamente), el comienzo de la partición (pulsando intro, la añade al final de lo que hay) y finalmente el tamaño de la particion (si pulsamos intro, se usa todo el espacio disponible en el disco para la partición).
* '''d''': Borrar partición.
* '''w''': Escribe la tabla de particiones a disco.

Tras crear una partición, con '''lsblk''' podemos comprobar que se ha realizado la operación correctamente.

<syntaxhighlight lang="bash">
NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT
sr0 11:0 1 1024M 0 rom
vda 252:0 0 2.2G 0 disk
├─vda1 252:1 0 2.1G 0 part /
├─vda14 252:14 0 4M 0 part
└─vda15 252:15 0 106M 0 part /boot/efi
vdb 252:16 0 20G 0 disk
└─vdb1 252:17 0 20G 0 part
</syntaxhighlight>

= Paso 4: Crear un sistema de archivos =

Tras la creación de la partición, vamos a crear un sistema de ficheros '''ext4'''.

<syntaxhighlight lang="bash">
mkfs -t ext4 /dev/vda1
</syntaxhighlight>

Una vez hecho esto, vamos a comprobar que se han aplicado bien los cambios:

<syntaxhighlight lang="bash">
file -s /dev/vda1
</syntaxhighlight>

Hay otros sistemas de ficheros, como ''fat''.

= Paso 5: Montar y desmontar sistema de ficheros =

Tras haber creado en los pasos anteriores unas particiones y formatearlas, vamos a pasar ahora a montarlas para poderles dar uso.

<syntaxhighlight lang="bash">
mount /dev/vda1 /mnt
</syntaxhighlight>

tras esto, podemos comprobar que ha sido montada, mediante:

<syntaxhighlight lang="bash">
mount | grep vda1
</syntaxhighlight>

Podemos probar a crear un fichero en el nuevo sistema de ficheros que hemos montado:

<syntaxhighlight lang="bash">
touch /mnt/fichero.txt
</syntaxhighlight>

y comprobar que existe.

<syntaxhighlight lang="bash">
ls -la /mnt
</syntaxhighlight>

Para desmontar el sistema de fichero, tenemos que hacer:

<syntaxhighlight lang="bash">
umount /mnt
</syntaxhighlight>

== Paso 5.1: Montar persistente modificando /etc/fstab ==

Hay un fichero de configuración del sistema /etc/fstab (fstab viene de '''f'''ile '''s'''ystem '''tab'''le) que indica la configuración de montaje en tiempo de arranque de la máquina virtual.

Podemos consultar su contenido con:

<syntaxhighlight lang="bash">
cat /etc/fstab
</syntaxhighlight>

Cada fila contiene un montaje de una partición, la cual contiene:

* Identificación de la partición: PARTUUID de la partición.
* Punto de montaje: donde se montará el dispositivo
* Sistema de archivos: ext4, fat.
* Opciones: aquí pondremos las diferentes opciones de montaje, como por ejemplo montar para solo lectura, dar permisos a un usuario para utilizar la partición, etc. Hay que tener en cuenta que cada sistema tiene sus opciones.
* backup: si está a cero, no haremos backup
* chequeo: si está a cero no se hace chequeo al arrancar el sistema operativo.

Para obtener el PARTUUID de la partición, hay que ejecutar:

<syntaxhighlight lang="bash">
blkid /dev/vda1
</syntaxhighlight>

que va a mostrar la etique PARTUUID.

Ahora abrimos /etc/fstab y añadimos esta línea:

<syntaxhighlight lang="bash">
PARTUUID=de50c6a1-b332-40b7-98b5-878cbd30d94e /mnt ext4 rw,user,exec 0 0
</syntaxhighlight>

Para montar todos los sistemas de ficheros en /etc/fstab, podemos hacer:

<syntaxhighlight lang="bash">
mount -a
</syntaxhighlight>

Podemos comprobar que está montado.

<syntaxhighlight lang="bash">
lsblk
</syntaxhighlight>

= Paso 6: Gestión volúmenes (Logic Volume Manager, LVM) =

Logic Volume Manager (LVM) es una capa de software que permite crear volúmenes lógicos y mapearlos de manera sencilla sobre dispositivos físicos.

La instalación de LVM es sencilla mediante la orden:

apt-get install lvm2

La gestión de LVM se basa en tres conceptos básicos:

* Volúmenes físicos (PV): Representa una unidad de almacenamiento que aprovisiona espacio de almacenamiento para el volumen lógico que vamos a crear.
* Grupo volumen (VG): Representa un almacén de espacio para LVM. Un VG estará compuesto por varios PV, pudiendo tener tantos VG como sean necesarios.
* Volumen lógico (LV): Representan unidades lógicas creadas a partir de VG creado previamente. Se podrán crear tantos LV como sean necesarios para un VG. La creación de un LVM genera un archivo especial en /dev, con la forma /dev/nombre_del_grupo/nombre_volumne_logico. El mapeo de espacio desde un LV hasta un PV es configurable pudiendo ser: Lineal, RAID, Cache, ...

== Paso 6.1: Creación de volumen físico LVM (PV) ==

Para listar las unidades de almacenamiento disponibles en el sistema, empleamos la siguiente orden:

lsblk

Para crear un volumen físico en la unidad /dev/vdb, empleamos la orden:

pvcreate /dev/vdb

Recuerde que la unidad /dev/vdb tiene que estar en desuso.

Para ver los volúmenes físicos existentes, empleamos la orden:

pvscan

Para obtener más información:

pvdisplay

Para eliminar un PV, por ejemplo /dev/vdb:

pvremove /dev/vdb

Si reporta error indicando que está en uso, mueve el contenido del volumen que quieres borrar a otro de los volúmenes físicos que forman parte del grupo:

pvmove /dev/vdb /dev/vdc

y prueba a borrarlo de nuevo.

O simplemente:

pvmove /dev/vdb

si quieres que LVM2 vuelva el contenido a donde estime oportuno.

Recuerde que la orden ''lsblk'' ofrece información acerca del uso de los volúmenes físicos.

== Paso 6.2: Creación de grupo de volumenes LVM (VG) ==

Para crear un grupo, empleamos el comando vgcreate:

vgcreate vg_prueba /dev/vdb /dev/vdc

Esto añade al grupo 'vg_prueba' los volúmenes vdb y vdc, haciendo que la capacidad del grupo sea la capacidad agregada de los PV añadidos.

Para eliminar un grupo vgremove:

vgremove vg_prueba

Para extender un grupo creado (por ejemplo, vg_prueba) con más PV (por ejemplo /dev/vde) usamos el comando vgextend:

vgextend vg_prueba /dev/vde

Para reducir la capacidad de un grupo creado (por ejemplo, vg_prueba) basta con usar el comando vgreduce indicando la unidad (PV) a quitar, por ejemplo /dev/vde:

vgreduce vg_prueba /dev/vde

Para mostrar todos los grupos de volumenes existentes

vgscan

== Paso 6.3: Creación de volumen lógico (LV) ==

Para crear un volúmen lógico, empleamos la orden:

lvcreate --name volumen1 --size 100MB vg_prueba

Opcionalmente, es posible crear también un volumen restringiendo los volúmenes físicos empleados disponible en el grupo, por ejemplo, indicando que solo se puede usar el volumen físico /dev/vdb y /dev/vdc:

lvcreate --name volumen1 --size 100MB /dev/vdb /dev/vdc

A partir de este momento hay una unidad que se presenta como ''/dev/mapper/vg_prueba-volumen1''.

Podemos ahora formatear el volumen lógico:

mkfs.ext4 /dev/vg_prueba/volumen1

y montarlo para almacenar información:

mount /dev/vg_prueba/volumen1 /mnt

Puedes extender un volumen lógico en 1 Gbyte de más:

lvextend --size +1GB /dev/vg_prueba/volumen1

Para ext4, justo después tienes que redimensionar el sistema de ficheros:

resize2fs /dev/vg_prueba/volumen1

Aunque también puedes extender el tamaño del volumen y el sistema de ficheros mediante:

lvextend --size +1GB /dev/vg_prueba/volumen1 --resizefs

Puedes comprobar con:

df -h

que el sistema de ficheros en ''volumen1'' ocupa ahora todo el volumen lógico.

Reducir el tamaño de un volumen lógico es un poco más complicado, ¡podrían perder datos si no se realiza correctamente!

Primero, desmontamos el volumen:

umount /mnt/volumen1

reducir el tamaño del sistema de ficheros, comprobamos la integridad del sistema de ficheros:

e2fsck -f /dev/vg_prueba/volumen1

Y lo redimensionamos (reducimos de tamaño):

resize2fs /dev/vg_prueba/volumen1 500M

Ahora ya, por último lugar, puedes reducir el tamaño del volumen:

lvreduce --size 500M /dev/vg_prueba/volumen1

Para comprobar que hay ido todo bien, vuelve a redimensionar el sistema de ficheros para que ocupe todo el espacio disponible.

resize2fs /dev/vg_prueba/volumen1

Y puedes volver a montar el sistema de ficheros:

mount /dev/vg_prueba/volumen1 /mnt/volumen1

con

df -h

para comprar el nuevo tamaño disponible de sólo 500 MBytes.

Es posible borrar un volumen lógico:

lvremove /dev/vg_prueba/volumen1

asegúrate que no está montando, de lo contrario esta órden reportará que el volumen está en uso.

== Paso 6.4: Montaje persistente del volúmen lógico con /etc/fstab ==

Recuerde usar el '''UUID'' para referirse al volumen lógico desde /etc/fstab:

blkid /dev/vg_prueba/volumen1

que en /etc/fstab resulta en:

UUID=bb50c6a1-b332-40b7-98b5-878cbd30d94e /mnt ext4 rw,user,exec 0 0

= Paso 7: Creación de volumen lógico con RAID =

Para crear un RAID 0 de 20 GBytes.

lvcreate --type raid0 --stripes 2 --size 20G --name mi_raid0 vg_prueba

Para comprobar el estado del raid (mira el % que indica el nivel de sincronía):

lvs -a

Para comprobar los volúmenes que forman parte del RAID:

lsblk

* -o indica el formato de salida del estado, al poner +devices añade información sobre los volúmenes físicos empleados en el RAID.

* --stripes indica cuantos discos (del grupo de volúmenes) se usan activamente en la distribución de los datos.

En un RAID 0 con stripe 2 (el mínimo para poder hacerlo), sería:

Disco 1 Disco 2
A1 B1 C1 A2 B2 C2

Recuerde que RAID 1 hace ''mirroring'', por lo que no se hace striping, pero requiere como mínimo dos discos:

Disco 1 Disco 2
A B C A B C

Para crear un RAID 1+0, se necesitan 4 volúmenes físicos como mínimo previamente para crear un RAID 1+0, pues combina ambos RAID.

lvcreate --type raid10 --mirrors 1 --stripes 2 --size 20G --name raid0 vg_prueba

Para RAID 1+0, la cuenta de discos necesario es:

stripes * (mirrors + 1) = 2 * (1 + 1) = 4 discos.

Para reemplazar un volumen físico del RAID por otro, puede hacer:

lvconvert --replace /dev/vda vg_prueba/raid0 /dev/vdb

o, de manera síncrona:

pvmove /dev/vda /dev/vdb

Hay un artículo [https://en.wikipedia.org/wiki/Standard_RAID_levels Wikipedia] que describe los niveles de RAID de manera muy detallada.

'''NOTA''': Es mejor gestionar [[RAID con mdadm]] y luego combinarlo con lvm para la gestión de volúmenes, pero el material oficial de la asignatura prefiere usar lvm.

= Paso 8: GlusterFS =

GlusterFS es un sistema de archivos cliente-servidor de almacenamiento en red escalable. También puede consultar [https://docs.gluster.org/en/latest/Administrator-Guide/ official documentation] para más detalles.

Algunos conceptos:

* Nodo: máquina que proporciona espacio de almacenamiento.
* Pool: Un conjunto de nodos.
* Cliente: máquina en la que se monta un volumen

y con respecto al almacenamiento:

* Brick: Unidad mínima de almacenamiento (dada por un sistema de archivos exportado por un nodo). En cada nodo se define un brick.
* Volumen: unidad lógica compuesta por bricks de uno o varios nodos.

== Paso 8.1: Instalar el servidor GlusterFS ==

Para instalar Glusterfs:

<syntaxhighlight lang="bash">
apt install glusterfs-server
systemctl enable --now glusterd
systemctl start glusterd
systemctl status glusterd
</syntaxhighlight>

Puedes consultar los logs en: /var/log/glusterfs/glusterd.log

Puedes comprobar que el servicio está activo verificado que el puerto TCP/24007 está activo:

<syntaxhighlight lang="bash">
ss -ltn
</syntaxhighlight>

La orden ''ss'' muestra con esta opción los servicios TCP (-t) que están escuchando (-l, de ''listen'') y usando la notación numérica (-n).

Si vamos a construir un pool con dos nodos, tenemos que editar /etc/hostname y /etc/hosts de lo contrario tendremos problemas al crear un pool.

'''Si clonas una máquina virtual tras la instalación de los paquetes''', tienes que volver a crear el identificador único del nodo tal [https://wenhan.blog/post/glusterfs-failed-to-probe-a-cloned-peer/ aquí].

=== Paso 8.1.1. Editar /etc/hostname ===

Gluster requiere nombres únicos para identificar a las máquinas que forman parte del pool:

<syntaxhighlight lang="bash">
nano /etc/hostname
</syntaxhighlight>

Y pones ''server1''.

Tras esto, hay que reiniciar el sistema para que el cambio de nombre surta efecto.

Para la segunda máquina, pones ''server2''. Y así sucesivamente.

'''Es fundamental que todas las máquinas del pool tengan nombres únicos, de lo contrario gluster no va a funcionar'''.

=== Paso 8.1.2. Editar el /etc/hosts ===

Suponiendo que el nodo 2 tiene la dirección IP 192.168.122.75 y el nodo 1 tiene la IP 192.168.122.175, hay que editar /etc/hosts con:

<syntaxhighlight lang="bash">
127.0.0.1 localhost
192.168.122.175 server1
192.168.122.75 server2
</syntaxhighlight>

'''en todas las máquinas que formen parte del pool'''.

== Paso 8.2: Gestionar el pool de servidores ==

Para añadir el nodo 1 y al 2 al mismo pool, desde el nodo 2 hay que invocar:

<syntaxhighlight lang="bash">
gluster peer probe server1
</syntaxhighlight>

Ahora tienes que comprobar la lista de nodos del clúster en el ''pool'':

<syntaxhighlight lang="bash">
gluster pool list
</syntaxhighlight>

que muestra desde el nodo 1 lo siguiente:

<syntaxhighlight lang="bash">
UUID Hostname State
ca4b43a2-aa4b43a2-bb3422cc-a4540010 server2 Connected
ba4bbba2-bb4bbba2-cc3422cc-aaabff67 localhost Connected
</syntaxhighlight>

Comprobar el estado de los nodos:

<syntaxhighlight lang="bash">
gluster peer status
</syntaxhighlight>

que muestra:

<syntaxhighlight lang="bash">
Number of peers: 1

Hostname: server2
Uuid: ca4b43a2-aa4b43a2-bb3422cc-a45400S10
State: Peer in Cluster (Connected)
</syntaxhighlight>

Es posible borrar un nodo mediante la siguiente orden:

<syntaxhighlight lang="bash">
gluster peer detach server2
</syntaxhighlight>

== Paso 8.3: Gestionar el almacenamiento ==

En ambos nodos cree una carpeta:

<syntaxhighlight lang="bash">
mkdir -p /data/myvol1/brick1
</syntaxhighlight>

En '''uno''' de los nodos, puede crear el volumen:

<syntaxhighlight lang="bash">
gluster volume create myvol1 replica 2 server1:/data/myvol1/brick1 server2:/data/myvol1/brick1
</syntaxhighlight>

'''Nota''': Si la carpeta está en el raíz, entonces hay que añadir ''force'' al final de la orden anterior.

Y para iniciar el volumen:

<syntaxhighlight lang="bash">
gluster volume start myvol1
</syntaxhighlight>

Para listar los volúmenes existentes:

<syntaxhighlight lang="bash">
gluster volume list
</syntaxhighlight>

Puede comprobar la información y el estado del volumen:

<syntaxhighlight lang="bash">
gluster volume info
gluster volume status
</syntaxhighlight>

Además, cada nuevo volumen de glusterfs abre un puerto TCP que se puede observar con:

<syntaxhighlight lang="bash">
ss -ltnp
</syntaxhighlight>

La opción ''-p'' muestra el proceso asociado a dicho puerto, se puede observar que es un proceso de ''glusterfsd''. Esta información sobre los puertos TCP asociados al volumen también aparece en la información de''status'':

<syntaxhighlight lang="bash">
gluster volume status
</syntaxhighlight>

Puede extender también un volumen existente con:

<syntaxhighlight lang="bash">
mkdir -p /data/myvol1/brick2
gluster volume add-brick myvol1 server1:/data/myvol1/brick2
</syntaxhighlight>

En caso de necesitar borrar un volumen de red, puedes invocar:

<syntaxhighlight lang="bash">
gluster volume stop myvol1
gluster volume delete myvol1
</syntaxhighlight>

parando el volumen en primer lugar para luego borrarlo.

== Paso 8.4: Cliente GlusterFS ==

Primero instala el paquete de cliente de GlusterFS.

<syntaxhighlight lang="bash">
apt install glusterfs-client
</syntaxhighlight>

Desde el cliente, puede montar el volumen con:

<syntaxhighlight lang="bash">
mount -t glusterfs server1:/myvol1 /mnt
</syntaxhighlight>

= Anexo =

* [[RAID con mdadm]]

Sistemas de archivos

2025-12-15T12:23:09Z

Pneira: /* Paso 6.1: Creación de volumen físico LVM (PV) */

= Paso 1: Añadir un disco a la máquina virtual =

Vamos a usar cualquier máquina virtual de debian cloud que hayamos usado
previamente y vamos a añadir dos discos virtuales para hacer pruebas.

# Abrimos la ventana de la máquina virtual a usar
# Nos movemos a Vista -> Detalles, y le damos al botón de 'Agregar hardware'
# Seleccionamos Almacenamiento, le damos un tamaño de 5GB y en el tipo de dispositivo seleccionamos 'dispositivo de disco'. Con estas opciones, pulsamos Finalizar., y ya tendremos nuestro disco creado.
# Repetir el paso anterior y crear otro disco de 4GB

Para crear un nuevo disco virtual desde el intérprete de órdenes:

<syntaxhighlight lang="bash">
qemu-img create -f qcow2 mi-disco.img 20G
</syntaxhighlight>

Para adjuntar este disco a una máquina virtual existente:

<syntaxhighlight lang="bash">
virsh attach-disk mi-mv /home/usuario/mi-disco.img vdb --cache none --subdriver qcow2 --config
</syntaxhighlight>

Esto va a adjuntar el disco virtual creando anteriormente a la máquina virtual cuyo nombre es ''mi-mv'' haciendo uso del driver paravirtualizado ''VirtIO''.

Ojo: ''virsh attach-disk'' requiere una ruta absoluta al disco virtual.

Posible errores:

* La máquina virtual a la que se quiere adjuntar el nuevo disco no existe

<syntaxhighlight lang="bash">
error: failed to get domain 'mi-mv'
</syntaxhighlight>

Consulte el listado de máquinas virtuales existentes con ''virsh''.

* El identificador del disco virtual ya existe:

<syntaxhighlight lang="bash">
error: Failed to attach disk
error: XML error: target 'vdb' duplicated for disk sources ...
</syntaxhighlight>

En este caso, indica que ''vdb'' ya está en uso para un disco virtual existente, por lo que debe emplear otro identificador tal como ''vdc'', ''vdd'', etc.

Para ver los discos virtuales de una máquina virtual:

<syntaxhighlight lang="bash">
virsh domblklist mi-mv
</syntaxhighlight>

que muestra una salida similar a:

<syntaxhighlight lang="bash">
Target Source
----------------------------------------------
hda /home/usuario/debian-cloud.img
vda /home/usuario/mi-disco.img
</syntaxhighlight>

Para eliminar un discho de la máquina virtual:

<syntaxhighlight lang="bash">
virsh detach-disk mi-mv vda --config
</syntaxhighlight>

= Paso 2: Ver discos en Linux =

Volvamos a la vista consola (Vista -> Consola) y arranquemos la máquina (Máquina virtual -> Ejecutar).

Para comprobar los discos añadidos en el paso 1 vamos a utilizar el comando '''lsblk''', el cual nos mostrará una salida similar a la siguiente:

<syntaxhighlight lang="bash">
NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT
sr0 11:0 1 1024M 0 rom
vda 252:0 0 2.2G 0 disk
├─vda1 252:1 0 2.1G 0 part /
├─vda14 252:14 0 4M 0 part
└─vda15 252:15 0 106M 0 part /boot/efi
vdb 252:16 0 20G 0 disk
</syntaxhighlight>

Aqui vemos que tenemos 3 discos:

* vda: el actual de la imagen cloud que añadimos al crear la máquina
* vdb: el disco que añadimos en el paso 1 de 5GB
* vdc: el disco que añadimos en el paso 1 de 4GB

También vemos que el disco vda tiene 3 particiones: vda1, vda14 y vda15

= Paso 3: Creación de particiones en Linux =

Vamos a utilizar ahora nuestro disco añadido de 20GB, en el paso anterior deberiamos de haber identificado cual es, en mi caso /dev/vdb, aseguraros cual es el vuestro y comenzaremos a particionar el disco:

<syntaxhighlight lang="bash">
fdisk /dev/vdb
</syntaxhighlight>

Desde fdisk, se pueden realizar las siguientes acciones:

* '''p''': Imprimir la tabla de particiones actual. Para un disco nuevo, la tabla de particiones está vacía y el tipo de particionado es DOS.
* '''t''': Establecer tipo de partición.
* '''g''': Cambia el tipo de particionado al esquema GPT.
* '''n''': Crear nueva partición, que solicita: El número de partición (si pulsamos intro, asigna una automáticamente), el comienzo de la partición (pulsando intro, la añade al final de lo que hay) y finalmente el tamaño de la particion (si pulsamos intro, se usa todo el espacio disponible en el disco para la partición).
* '''d''': Borrar partición.
* '''w''': Escribe la tabla de particiones a disco.

Tras crear una partición, con '''lsblk''' podemos comprobar que se ha realizado la operación correctamente.

<syntaxhighlight lang="bash">
NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT
sr0 11:0 1 1024M 0 rom
vda 252:0 0 2.2G 0 disk
├─vda1 252:1 0 2.1G 0 part /
├─vda14 252:14 0 4M 0 part
└─vda15 252:15 0 106M 0 part /boot/efi
vdb 252:16 0 20G 0 disk
└─vdb1 252:17 0 20G 0 part
</syntaxhighlight>

= Paso 4: Crear un sistema de archivos =

Tras la creación de la partición, vamos a crear un sistema de ficheros '''ext4'''.

<syntaxhighlight lang="bash">
mkfs -t ext4 /dev/vda1
</syntaxhighlight>

Una vez hecho esto, vamos a comprobar que se han aplicado bien los cambios:

<syntaxhighlight lang="bash">
file -s /dev/vda1
</syntaxhighlight>

Hay otros sistemas de ficheros, como ''fat''.

= Paso 5: Montar y desmontar sistema de ficheros =

Tras haber creado en los pasos anteriores unas particiones y formatearlas, vamos a pasar ahora a montarlas para poderles dar uso.

<syntaxhighlight lang="bash">
mount /dev/vda1 /mnt
</syntaxhighlight>

tras esto, podemos comprobar que ha sido montada, mediante:

<syntaxhighlight lang="bash">
mount | grep vda1
</syntaxhighlight>

Podemos probar a crear un fichero en el nuevo sistema de ficheros que hemos montado:

<syntaxhighlight lang="bash">
touch /mnt/fichero.txt
</syntaxhighlight>

y comprobar que existe.

<syntaxhighlight lang="bash">
ls -la /mnt
</syntaxhighlight>

Para desmontar el sistema de fichero, tenemos que hacer:

<syntaxhighlight lang="bash">
umount /mnt
</syntaxhighlight>

== Paso 5.1: Montar persistente modificando /etc/fstab ==

Hay un fichero de configuración del sistema /etc/fstab (fstab viene de '''f'''ile '''s'''ystem '''tab'''le) que indica la configuración de montaje en tiempo de arranque de la máquina virtual.

Podemos consultar su contenido con:

<syntaxhighlight lang="bash">
cat /etc/fstab
</syntaxhighlight>

Cada fila contiene un montaje de una partición, la cual contiene:

* Identificación de la partición: PARTUUID de la partición.
* Punto de montaje: donde se montará el dispositivo
* Sistema de archivos: ext4, fat.
* Opciones: aquí pondremos las diferentes opciones de montaje, como por ejemplo montar para solo lectura, dar permisos a un usuario para utilizar la partición, etc. Hay que tener en cuenta que cada sistema tiene sus opciones.
* backup: si está a cero, no haremos backup
* chequeo: si está a cero no se hace chequeo al arrancar el sistema operativo.

Para obtener el PARTUUID de la partición, hay que ejecutar:

<syntaxhighlight lang="bash">
blkid /dev/vda1
</syntaxhighlight>

que va a mostrar la etique PARTUUID.

Ahora abrimos /etc/fstab y añadimos esta línea:

<syntaxhighlight lang="bash">
PARTUUID=de50c6a1-b332-40b7-98b5-878cbd30d94e /mnt ext4 rw,user,exec 0 0
</syntaxhighlight>

Para montar todos los sistemas de ficheros en /etc/fstab, podemos hacer:

<syntaxhighlight lang="bash">
mount -a
</syntaxhighlight>

Podemos comprobar que está montado.

<syntaxhighlight lang="bash">
lsblk
</syntaxhighlight>

= Paso 6: Gestión volúmenes (Logic Volume Manager, LVM) =

Logic Volume Manager (LVM) es una capa de software que permite crear volúmenes lógicos y mapearlos de manera sencilla sobre dispositivos físicos.

La instalación de LVM es sencilla mediante la orden:

apt-get install lvm2

La gestión de LVM se basa en tres conceptos básicos:

* Volúmenes físicos (PV): Representa una unidad de almacenamiento que aprovisiona espacio de almacenamiento para el volumen lógico que vamos a crear.
* Grupo volumen (VG): Representa un almacén de espacio para LVM. Un VG estará compuesto por varios PV, pudiendo tener tantos VG como sean necesarios.
* Volumen lógico (LV): Representan unidades lógicas creadas a partir de VG creado previamente. Se podrán crear tantos LV como sean necesarios para un VG. La creación de un LVM genera un archivo especial en /dev, con la forma /dev/nombre_del_grupo/nombre_volumne_logico. El mapeo de espacio desde un LV hasta un PV es configurable pudiendo ser: Lineal, RAID, Cache, ...

== Paso 6.1: Creación de volumen físico LVM (PV) ==

Para listar las unidades de almacenamiento disponibles en el sistema, empleamos la siguiente orden:

lsblk

Para crear un volumen físico en la unidad /dev/vdb, empleamos la orden:

pvcreate /dev/vdb

Recuerde que la unidad /dev/vdb tiene que estar en desuso.

Para ver los volúmenes físicos existentes, empleamos la orden:

pvscan

Para obtener más información:

pvdisplay

Para eliminar un PV, por ejemplo /dev/vdb:

pvremove /dev/vdb

Si reporta error indicando que está en uso, mueve el contenido del volumen que quieres borrar a otro de los volúmenes físicos que forman parte del grupo:

pvmove /dev/vdb /dev/vdc

y prueba a borrarlo de nuevo.

O simplemente:

pvmove /dev/vdb

si quieres que LVM2 vuelva el contenido a donde estime oportuno.

Recuerde que la orden ''lsblk'' ofrece información acerca del uso de los volúmenes físicos.

== Paso 6.2: Creación de grupo de volumenes LVM (VG) ==

Para crear un grupo, empleamos el comando vgcreate:

vgcreate vg_prueba /dev/vdb /dev/vdc

Esto añade al grupo 'vg_prueba' los volúmenes vdb y vdc, haciendo que la capacidad del grupo sea la capacidad agregada de los PV añadidos.

Para eliminar un grupo vgremove:

vgremove vg_prueba

Para extender un grupo creado (por ejemplo, vg_prueba) con más PV (por ejemplo /dev/vde) usamos el comando vgextend:

vgextend vg_prueba /dev/vde

Para reducir la capacidad de un grupo creado (por ejemplo, vg_prueba) basta con usar el comando vgreduce indicando la unidad (PV) a quitar, por ejemplo /dev/vde:

vgreduce vg_prueba /dev/vde

Para mostrar todos los grupos de volumenes existentes

vgscan

== Paso 6.3: Creación de volumen lógico (LV) ==

Para crear un volúmen lógico, empleamos la orden:

lvcreate --name volumen1 --size 100MB vg_prueba

Opcionalmente, es posible crear también un volumen restringiendo los volúmenes físicos empleados disponible en el grupo, por ejemplo, indicando que solo se puede usar el volumen físico /dev/vdb y /dev/vdc:

lvcreate --name volumen1 --size 100MB /dev/vdb /dev/vdc

A partir de este momento hay una unidad que se presenta como ''/dev/mapper/vg_prueba-volumen1''.

Podemos ahora formatear el volumen lógico:

mkfs.ext4 /dev/vg_prueba/volumen1

y montarlo para almacenar información:

mount /dev/vg_prueba/volumen1 /mnt

Puedes extender un volumen lógico en 1 Gbyte de más:

lvextend --size +1GB /dev/vg_prueba/volumen1

Para ext4, justo después tienes que redimensionar el sistema de ficheros:

resize2fs /dev/vg_prueba/volumen1

Aunque también puedes extender el tamaño del volumen y el sistema de ficheros mediante:

lvextend --size +1GB /dev/vg_prueba/volumen1 --resizefs

Puedes comprobar con:

df -h

que el sistema de ficheros en ''volumen1'' ocupa ahora todo el volumen lógico.

Reducir el tamaño de un volumen lógico es un poco más complicado, ¡podrían perder datos si no se realiza correctamente!

Primero, desmontamos el volumen:

umount /mnt/volumen1

reducir el tamaño del sistema de ficheros, comprobamos la integridad del sistema de ficheros:

e2fsck -f /dev/vg_prueba/volumen1

Y lo redimensionamos (reducimos de tamaño):

resize2fs /dev/vg_prueba/volumen1 500M

Ahora ya, por último lugar, puedes reducir el tamaño del volumen:

lvreduce --size 500M /dev/vg_prueba/volumen1

Para comprobar que hay ido todo bien, vuelve a redimensionar el sistema de ficheros para que ocupe todo el espacio disponible.

resize2fs /dev/vg_prueba/volumen1

Y puedes volver a montar el sistema de ficheros:

mount /dev/vg_prueba/volumen1 /mnt/volumen1

con

df -h

para comprar el nuevo tamaño disponible de sólo 500 MBytes.

Es posible borrar un volumen lógico:

lvremove /dev/vg_prueba/volumen1

asegúrate que no está montando, de lo contrario esta órden reportará que el volumen está en uso.

== Paso 6.4: Montaje persistente del volúmen lógico con /etc/fstab ==

Recuerde usar el '''UUID'' para referirse al volumen lógico desde /etc/fstab:

blkid /dev/vg_prueba/volumen1

que en /etc/fstab resulta en:

UUID=bb50c6a1-b332-40b7-98b5-878cbd30d94e /mnt ext4 rw,user,exec 0 0

= Paso 7: Creación de volumen lógico con RAID =

Para crear un RAID 0 de 20 GBytes.

lvcreate --type raid0 --stripes 2 --size 20G --name mi_raid0 vg_prueba

Para comprobar el estado del raid (mira el % que indica el nivel de sincronía):

lvs -a

Para comprobar los volúmenes que forman parte del RAID:

lsblk

* -o indica el formato de salida del estado, al poner +devices añade información sobre los volúmenes físicos empleados en el RAID.

* --stripes indica cuantos discos (del grupo de volúmenes) se usan activamente en la distribución de los datos.

En un RAID 0 con stripe 2 (el mínimo para poder hacerlo), sería:

Disco 1 Disco 2
A1 B1 C1 A2 B2 C2

Recuerde que RAID 1 hace ''mirroring'', por lo que no se hace striping, pero requiere como mínimo dos discos:

Disco 1 Disco 2
A B C A B C

Para crear un RAID 1+0, se necesitan 4 volúmenes físicos como mínimo previamente para crear un RAID 1+0, pues combina ambos RAID.

lvcreate --type raid10 --mirrors 1 --stripes 2 --size 20G --name raid0 vg_prueba

Para RAID 1+0, la cuenta de discos necesario es:

stripes * (mirrors + 1) = 2 * (1 + 1) = 4 discos.

Para reemplazar un volumen físico del RAID por otro, puede hacer:

lvconvert --replace /dev/vda vg_prueba/raid0 /dev/vdb

o, de manera síncrona:

pvmove /dev/vda /dev/vdb

Hay un artículo [https://en.wikipedia.org/wiki/Standard_RAID_levels Wikipedia] que describe los niveles de RAID de manera muy detallada.

'''NOTA''': Es mejor gestionar [[RAID con mdadm]] y luego combinarlo con lvm para la gestión de volúmenes, pero el material oficial de la asignatura prefiere usar lvm.

= Paso 8: GlusterFS =

GlusterFS es un sistema de archivos cliente-servidor de almacenamiento en red escalable. También puede consultar [https://docs.gluster.org/en/latest/Administrator-Guide/ official documentation] para más detalles.

Algunos conceptos:

* Nodo: máquina que proporciona espacio de almacenamiento.
* Pool: Un conjunto de nodos.
* Cliente: máquina en la que se monta un volumen

y con respecto al almacenamiento:

* Brick: Unidad mínima de almacenamiento (dada por un sistema de archivos exportado por un nodo). En cada nodo se define un brick.
* Volumen: unidad lógica compuesta por bricks de uno o varios nodos.

== Paso 8.1: Instalar el servidor GlusterFS ==

Para instalar Glusterfs:

<syntaxhighlight lang="bash">
apt install glusterfs-server
systemctl enable --now glusterd
systemctl start glusterd
systemctl status glusterd
</syntaxhighlight>

Puedes consultar los logs en: /var/log/glusterfs/glusterd.log

Puedes comprobar que el servicio está activo verificado que el puerto TCP/24007 está activo:

<syntaxhighlight lang="bash">
ss -ltn
</syntaxhighlight>

La orden ''ss'' muestra con esta opción los servicios TCP (-t) que están escuchando (-l, de ''listen'') y usando la notación numérica (-n).

Si vamos a construir un pool con dos nodos, tenemos que editar /etc/hostname y /etc/hosts de lo contrario tendremos problemas al crear un pool.

'''Si clonas una máquina virtual tras la instalación de los paquetes''', tienes que volver a crear el identificador único del nodo tal [https://wenhan.blog/post/glusterfs-failed-to-probe-a-cloned-peer/ aquí].

=== Paso 8.1.1. Editar /etc/hostname ===

Gluster requiere nombres únicos para identificar a las máquinas que forman parte del pool:

<syntaxhighlight lang="bash">
nano /etc/hostname
</syntaxhighlight>

Y pones ''server1''.

Tras esto, hay que reiniciar el sistema para que el cambio de nombre surta efecto.

Para la segunda máquina, pones ''server2''. Y así sucesivamente.

'''Es fundamental que todas las máquinas del pool tengan nombres únicos, de lo contrario gluster no va a funcionar'''.

=== Paso 8.1.2. Editar el /etc/hosts ===

Suponiendo que el nodo 2 tiene la dirección IP 192.168.122.75 y el nodo 1 tiene la IP 192.168.122.175, hay que editar /etc/hosts con:

<syntaxhighlight lang="bash">
127.0.0.1 localhost
192.168.122.175 server1
192.168.122.75 server2
</syntaxhighlight>

'''en todas las máquinas que formen parte del pool'''.

== Paso 8.2: Gestionar el pool de servidores ==

Para añadir el nodo 1 y al 2 al mismo pool, desde el nodo 2 hay que invocar:

<syntaxhighlight lang="bash">
gluster peer probe server1
</syntaxhighlight>

Ahora tienes que comprobar la lista de nodos del clúster en el ''pool'':

<syntaxhighlight lang="bash">
gluster pool list
</syntaxhighlight>

que muestra desde el nodo 1 lo siguiente:

<syntaxhighlight lang="bash">
UUID Hostname State
ca4b43a2-aa4b43a2-bb3422cc-a4540010 server2 Connected
ba4bbba2-bb4bbba2-cc3422cc-aaabff67 localhost Connected
</syntaxhighlight>

Comprobar el estado de los nodos:

<syntaxhighlight lang="bash">
gluster peer status
</syntaxhighlight>

que muestra:

<syntaxhighlight lang="bash">
Number of peers: 1

Hostname: server2
Uuid: ca4b43a2-aa4b43a2-bb3422cc-a45400S10
State: Peer in Cluster (Connected)
</syntaxhighlight>

Es posible borrar un nodo mediante la siguiente orden:

<syntaxhighlight lang="bash">
gluster peer detach server2
</syntaxhighlight>

== Paso 8.3: Gestionar el almacenamiento ==

En ambos nodos cree una carpeta:

<syntaxhighlight lang="bash">
mkdir -p /data/myvol1/brick1
</syntaxhighlight>

En '''uno''' de los nodos, puede crear el volumen:

<syntaxhighlight lang="bash">
gluster volume create myvol1 replica 2 server1:/data/myvol1/brick1 server2:/data/myvol1/brick1
</syntaxhighlight>

'''Nota''': Si la carpeta está en el raíz, entonces hay que añadir ''force'' al final de la orden anterior.

Y para iniciar el volumen:

<syntaxhighlight lang="bash">
gluster volume start myvol1
</syntaxhighlight>

Para listar los volúmenes existentes:

<syntaxhighlight lang="bash">
gluster volume list
</syntaxhighlight>

Puede comprobar la información y el estado del volumen:

<syntaxhighlight lang="bash">
gluster volume info
gluster volume status
</syntaxhighlight>

Además, cada nuevo volumen de glusterfs abre un puerto TCP que se puede observar con:

<syntaxhighlight lang="bash">
ss -ltnp
</syntaxhighlight>

La opción ''-p'' muestra el proceso asociado a dicho puerto, se puede observar que es un proceso de ''glusterfsd''. Esta información sobre los puertos TCP asociados al volumen también aparece en la información de''status'':

<syntaxhighlight lang="bash">
gluster volume status
</syntaxhighlight>

En caso de necesitar borrar un volumen de red, puedes invocar:

<syntaxhighlight lang="bash">
gluster volume stop myvol1
gluster volume delete myvol1
</syntaxhighlight>

parando el volumen en primer lugar para luego borrarlo.

== Paso 8.4: Cliente GlusterFS ==

Primero instala el paquete de cliente de GlusterFS.

<syntaxhighlight lang="bash">
apt install glusterfs-client
</syntaxhighlight>

Desde el cliente, puede montar el volumen con:

<syntaxhighlight lang="bash">
mount -t glusterfs server1:/myvol1 /mnt
</syntaxhighlight>

= Anexo =

* [[RAID con mdadm]]

Sistemas de archivos

2025-12-15T12:22:22Z

Pneira: /* Paso 6.1: Creación de volumen físico LVM (PV) */

= Paso 1: Añadir un disco a la máquina virtual =

Vamos a usar cualquier máquina virtual de debian cloud que hayamos usado
previamente y vamos a añadir dos discos virtuales para hacer pruebas.

# Abrimos la ventana de la máquina virtual a usar
# Nos movemos a Vista -> Detalles, y le damos al botón de 'Agregar hardware'
# Seleccionamos Almacenamiento, le damos un tamaño de 5GB y en el tipo de dispositivo seleccionamos 'dispositivo de disco'. Con estas opciones, pulsamos Finalizar., y ya tendremos nuestro disco creado.
# Repetir el paso anterior y crear otro disco de 4GB

Para crear un nuevo disco virtual desde el intérprete de órdenes:

<syntaxhighlight lang="bash">
qemu-img create -f qcow2 mi-disco.img 20G
</syntaxhighlight>

Para adjuntar este disco a una máquina virtual existente:

<syntaxhighlight lang="bash">
virsh attach-disk mi-mv /home/usuario/mi-disco.img vdb --cache none --subdriver qcow2 --config
</syntaxhighlight>

Esto va a adjuntar el disco virtual creando anteriormente a la máquina virtual cuyo nombre es ''mi-mv'' haciendo uso del driver paravirtualizado ''VirtIO''.

Ojo: ''virsh attach-disk'' requiere una ruta absoluta al disco virtual.

Posible errores:

* La máquina virtual a la que se quiere adjuntar el nuevo disco no existe

<syntaxhighlight lang="bash">
error: failed to get domain 'mi-mv'
</syntaxhighlight>

Consulte el listado de máquinas virtuales existentes con ''virsh''.

* El identificador del disco virtual ya existe:

<syntaxhighlight lang="bash">
error: Failed to attach disk
error: XML error: target 'vdb' duplicated for disk sources ...
</syntaxhighlight>

En este caso, indica que ''vdb'' ya está en uso para un disco virtual existente, por lo que debe emplear otro identificador tal como ''vdc'', ''vdd'', etc.

Para ver los discos virtuales de una máquina virtual:

<syntaxhighlight lang="bash">
virsh domblklist mi-mv
</syntaxhighlight>

que muestra una salida similar a:

<syntaxhighlight lang="bash">
Target Source
----------------------------------------------
hda /home/usuario/debian-cloud.img
vda /home/usuario/mi-disco.img
</syntaxhighlight>

Para eliminar un discho de la máquina virtual:

<syntaxhighlight lang="bash">
virsh detach-disk mi-mv vda --config
</syntaxhighlight>

= Paso 2: Ver discos en Linux =

Volvamos a la vista consola (Vista -> Consola) y arranquemos la máquina (Máquina virtual -> Ejecutar).

Para comprobar los discos añadidos en el paso 1 vamos a utilizar el comando '''lsblk''', el cual nos mostrará una salida similar a la siguiente:

<syntaxhighlight lang="bash">
NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT
sr0 11:0 1 1024M 0 rom
vda 252:0 0 2.2G 0 disk
├─vda1 252:1 0 2.1G 0 part /
├─vda14 252:14 0 4M 0 part
└─vda15 252:15 0 106M 0 part /boot/efi
vdb 252:16 0 20G 0 disk
</syntaxhighlight>

Aqui vemos que tenemos 3 discos:

* vda: el actual de la imagen cloud que añadimos al crear la máquina
* vdb: el disco que añadimos en el paso 1 de 5GB
* vdc: el disco que añadimos en el paso 1 de 4GB

También vemos que el disco vda tiene 3 particiones: vda1, vda14 y vda15

= Paso 3: Creación de particiones en Linux =

Vamos a utilizar ahora nuestro disco añadido de 20GB, en el paso anterior deberiamos de haber identificado cual es, en mi caso /dev/vdb, aseguraros cual es el vuestro y comenzaremos a particionar el disco:

<syntaxhighlight lang="bash">
fdisk /dev/vdb
</syntaxhighlight>

Desde fdisk, se pueden realizar las siguientes acciones:

* '''p''': Imprimir la tabla de particiones actual. Para un disco nuevo, la tabla de particiones está vacía y el tipo de particionado es DOS.
* '''t''': Establecer tipo de partición.
* '''g''': Cambia el tipo de particionado al esquema GPT.
* '''n''': Crear nueva partición, que solicita: El número de partición (si pulsamos intro, asigna una automáticamente), el comienzo de la partición (pulsando intro, la añade al final de lo que hay) y finalmente el tamaño de la particion (si pulsamos intro, se usa todo el espacio disponible en el disco para la partición).
* '''d''': Borrar partición.
* '''w''': Escribe la tabla de particiones a disco.

Tras crear una partición, con '''lsblk''' podemos comprobar que se ha realizado la operación correctamente.

<syntaxhighlight lang="bash">
NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT
sr0 11:0 1 1024M 0 rom
vda 252:0 0 2.2G 0 disk
├─vda1 252:1 0 2.1G 0 part /
├─vda14 252:14 0 4M 0 part
└─vda15 252:15 0 106M 0 part /boot/efi
vdb 252:16 0 20G 0 disk
└─vdb1 252:17 0 20G 0 part
</syntaxhighlight>

= Paso 4: Crear un sistema de archivos =

Tras la creación de la partición, vamos a crear un sistema de ficheros '''ext4'''.

<syntaxhighlight lang="bash">
mkfs -t ext4 /dev/vda1
</syntaxhighlight>

Una vez hecho esto, vamos a comprobar que se han aplicado bien los cambios:

<syntaxhighlight lang="bash">
file -s /dev/vda1
</syntaxhighlight>

Hay otros sistemas de ficheros, como ''fat''.

= Paso 5: Montar y desmontar sistema de ficheros =

Tras haber creado en los pasos anteriores unas particiones y formatearlas, vamos a pasar ahora a montarlas para poderles dar uso.

<syntaxhighlight lang="bash">
mount /dev/vda1 /mnt
</syntaxhighlight>

tras esto, podemos comprobar que ha sido montada, mediante:

<syntaxhighlight lang="bash">
mount | grep vda1
</syntaxhighlight>

Podemos probar a crear un fichero en el nuevo sistema de ficheros que hemos montado:

<syntaxhighlight lang="bash">
touch /mnt/fichero.txt
</syntaxhighlight>

y comprobar que existe.

<syntaxhighlight lang="bash">
ls -la /mnt
</syntaxhighlight>

Para desmontar el sistema de fichero, tenemos que hacer:

<syntaxhighlight lang="bash">
umount /mnt
</syntaxhighlight>

== Paso 5.1: Montar persistente modificando /etc/fstab ==

Hay un fichero de configuración del sistema /etc/fstab (fstab viene de '''f'''ile '''s'''ystem '''tab'''le) que indica la configuración de montaje en tiempo de arranque de la máquina virtual.

Podemos consultar su contenido con:

<syntaxhighlight lang="bash">
cat /etc/fstab
</syntaxhighlight>

Cada fila contiene un montaje de una partición, la cual contiene:

* Identificación de la partición: PARTUUID de la partición.
* Punto de montaje: donde se montará el dispositivo
* Sistema de archivos: ext4, fat.
* Opciones: aquí pondremos las diferentes opciones de montaje, como por ejemplo montar para solo lectura, dar permisos a un usuario para utilizar la partición, etc. Hay que tener en cuenta que cada sistema tiene sus opciones.
* backup: si está a cero, no haremos backup
* chequeo: si está a cero no se hace chequeo al arrancar el sistema operativo.

Para obtener el PARTUUID de la partición, hay que ejecutar:

<syntaxhighlight lang="bash">
blkid /dev/vda1
</syntaxhighlight>

que va a mostrar la etique PARTUUID.

Ahora abrimos /etc/fstab y añadimos esta línea:

<syntaxhighlight lang="bash">
PARTUUID=de50c6a1-b332-40b7-98b5-878cbd30d94e /mnt ext4 rw,user,exec 0 0
</syntaxhighlight>

Para montar todos los sistemas de ficheros en /etc/fstab, podemos hacer:

<syntaxhighlight lang="bash">
mount -a
</syntaxhighlight>

Podemos comprobar que está montado.

<syntaxhighlight lang="bash">
lsblk
</syntaxhighlight>

= Paso 6: Gestión volúmenes (Logic Volume Manager, LVM) =

Logic Volume Manager (LVM) es una capa de software que permite crear volúmenes lógicos y mapearlos de manera sencilla sobre dispositivos físicos.

La instalación de LVM es sencilla mediante la orden:

apt-get install lvm2

La gestión de LVM se basa en tres conceptos básicos:

* Volúmenes físicos (PV): Representa una unidad de almacenamiento que aprovisiona espacio de almacenamiento para el volumen lógico que vamos a crear.
* Grupo volumen (VG): Representa un almacén de espacio para LVM. Un VG estará compuesto por varios PV, pudiendo tener tantos VG como sean necesarios.
* Volumen lógico (LV): Representan unidades lógicas creadas a partir de VG creado previamente. Se podrán crear tantos LV como sean necesarios para un VG. La creación de un LVM genera un archivo especial en /dev, con la forma /dev/nombre_del_grupo/nombre_volumne_logico. El mapeo de espacio desde un LV hasta un PV es configurable pudiendo ser: Lineal, RAID, Cache, ...

== Paso 6.1: Creación de volumen físico LVM (PV) ==

Para listar las unidades de almacenamiento disponibles en el sistema, empleamos la siguiente orden:

lsblk

Para crear un volumen físico en la unidad /dev/vdb, empleamos la orden:

pvcreate /dev/vdb

Recuerde que la unidad /dev/vdb tiene que estar en desuso.

Para ver los volúmenes físicos existentes, empleamos la orden:

pvscan

Para obtener más información:

pvdisplay

Para eliminar un PV, por ejemplo /dev/vdb:

pvremove /dev/vdb

Si reporta error indicando que está en uso, mueve el contenido del volumen que quieres borrar a otro de los volúmenes físicos que forman parte del grupo:

pvmove /dev/vdb /dev/vdc

y prueba a borrarlo de nuevo. La orden ''lsblk'' ofrece información acerca del uso de los volúmenes físicos.

O simplemente:

pvmove /dev/vdb

si quieres que LVM2 vuelva el contenido a donde estime oportuno.

== Paso 6.2: Creación de grupo de volumenes LVM (VG) ==

Para crear un grupo, empleamos el comando vgcreate:

vgcreate vg_prueba /dev/vdb /dev/vdc

Esto añade al grupo 'vg_prueba' los volúmenes vdb y vdc, haciendo que la capacidad del grupo sea la capacidad agregada de los PV añadidos.

Para eliminar un grupo vgremove:

vgremove vg_prueba

Para extender un grupo creado (por ejemplo, vg_prueba) con más PV (por ejemplo /dev/vde) usamos el comando vgextend:

vgextend vg_prueba /dev/vde

Para reducir la capacidad de un grupo creado (por ejemplo, vg_prueba) basta con usar el comando vgreduce indicando la unidad (PV) a quitar, por ejemplo /dev/vde:

vgreduce vg_prueba /dev/vde

Para mostrar todos los grupos de volumenes existentes

vgscan

== Paso 6.3: Creación de volumen lógico (LV) ==

Para crear un volúmen lógico, empleamos la orden:

lvcreate --name volumen1 --size 100MB vg_prueba

Opcionalmente, es posible crear también un volumen restringiendo los volúmenes físicos empleados disponible en el grupo, por ejemplo, indicando que solo se puede usar el volumen físico /dev/vdb y /dev/vdc:

lvcreate --name volumen1 --size 100MB /dev/vdb /dev/vdc

A partir de este momento hay una unidad que se presenta como ''/dev/mapper/vg_prueba-volumen1''.

Podemos ahora formatear el volumen lógico:

mkfs.ext4 /dev/vg_prueba/volumen1

y montarlo para almacenar información:

mount /dev/vg_prueba/volumen1 /mnt

Puedes extender un volumen lógico en 1 Gbyte de más:

lvextend --size +1GB /dev/vg_prueba/volumen1

Para ext4, justo después tienes que redimensionar el sistema de ficheros:

resize2fs /dev/vg_prueba/volumen1

Aunque también puedes extender el tamaño del volumen y el sistema de ficheros mediante:

lvextend --size +1GB /dev/vg_prueba/volumen1 --resizefs

Puedes comprobar con:

df -h

que el sistema de ficheros en ''volumen1'' ocupa ahora todo el volumen lógico.

Reducir el tamaño de un volumen lógico es un poco más complicado, ¡podrían perder datos si no se realiza correctamente!

Primero, desmontamos el volumen:

umount /mnt/volumen1

reducir el tamaño del sistema de ficheros, comprobamos la integridad del sistema de ficheros:

e2fsck -f /dev/vg_prueba/volumen1

Y lo redimensionamos (reducimos de tamaño):

resize2fs /dev/vg_prueba/volumen1 500M

Ahora ya, por último lugar, puedes reducir el tamaño del volumen:

lvreduce --size 500M /dev/vg_prueba/volumen1

Para comprobar que hay ido todo bien, vuelve a redimensionar el sistema de ficheros para que ocupe todo el espacio disponible.

resize2fs /dev/vg_prueba/volumen1

Y puedes volver a montar el sistema de ficheros:

mount /dev/vg_prueba/volumen1 /mnt/volumen1

con

df -h

para comprar el nuevo tamaño disponible de sólo 500 MBytes.

Es posible borrar un volumen lógico:

lvremove /dev/vg_prueba/volumen1

asegúrate que no está montando, de lo contrario esta órden reportará que el volumen está en uso.

== Paso 6.4: Montaje persistente del volúmen lógico con /etc/fstab ==

Recuerde usar el '''UUID'' para referirse al volumen lógico desde /etc/fstab:

blkid /dev/vg_prueba/volumen1

que en /etc/fstab resulta en:

UUID=bb50c6a1-b332-40b7-98b5-878cbd30d94e /mnt ext4 rw,user,exec 0 0

= Paso 7: Creación de volumen lógico con RAID =

Para crear un RAID 0 de 20 GBytes.

lvcreate --type raid0 --stripes 2 --size 20G --name mi_raid0 vg_prueba

Para comprobar el estado del raid (mira el % que indica el nivel de sincronía):

lvs -a

Para comprobar los volúmenes que forman parte del RAID:

lsblk

* -o indica el formato de salida del estado, al poner +devices añade información sobre los volúmenes físicos empleados en el RAID.

* --stripes indica cuantos discos (del grupo de volúmenes) se usan activamente en la distribución de los datos.

En un RAID 0 con stripe 2 (el mínimo para poder hacerlo), sería:

Disco 1 Disco 2
A1 B1 C1 A2 B2 C2

Recuerde que RAID 1 hace ''mirroring'', por lo que no se hace striping, pero requiere como mínimo dos discos:

Disco 1 Disco 2
A B C A B C

Para crear un RAID 1+0, se necesitan 4 volúmenes físicos como mínimo previamente para crear un RAID 1+0, pues combina ambos RAID.

lvcreate --type raid10 --mirrors 1 --stripes 2 --size 20G --name raid0 vg_prueba

Para RAID 1+0, la cuenta de discos necesario es:

stripes * (mirrors + 1) = 2 * (1 + 1) = 4 discos.

Para reemplazar un volumen físico del RAID por otro, puede hacer:

lvconvert --replace /dev/vda vg_prueba/raid0 /dev/vdb

o, de manera síncrona:

pvmove /dev/vda /dev/vdb

Hay un artículo [https://en.wikipedia.org/wiki/Standard_RAID_levels Wikipedia] que describe los niveles de RAID de manera muy detallada.

'''NOTA''': Es mejor gestionar [[RAID con mdadm]] y luego combinarlo con lvm para la gestión de volúmenes, pero el material oficial de la asignatura prefiere usar lvm.

= Paso 8: GlusterFS =

GlusterFS es un sistema de archivos cliente-servidor de almacenamiento en red escalable. También puede consultar [https://docs.gluster.org/en/latest/Administrator-Guide/ official documentation] para más detalles.

Algunos conceptos:

* Nodo: máquina que proporciona espacio de almacenamiento.
* Pool: Un conjunto de nodos.
* Cliente: máquina en la que se monta un volumen

y con respecto al almacenamiento:

* Brick: Unidad mínima de almacenamiento (dada por un sistema de archivos exportado por un nodo). En cada nodo se define un brick.
* Volumen: unidad lógica compuesta por bricks de uno o varios nodos.

== Paso 8.1: Instalar el servidor GlusterFS ==

Para instalar Glusterfs:

<syntaxhighlight lang="bash">
apt install glusterfs-server
systemctl enable --now glusterd
systemctl start glusterd
systemctl status glusterd
</syntaxhighlight>

Puedes consultar los logs en: /var/log/glusterfs/glusterd.log

Puedes comprobar que el servicio está activo verificado que el puerto TCP/24007 está activo:

<syntaxhighlight lang="bash">
ss -ltn
</syntaxhighlight>

La orden ''ss'' muestra con esta opción los servicios TCP (-t) que están escuchando (-l, de ''listen'') y usando la notación numérica (-n).

Si vamos a construir un pool con dos nodos, tenemos que editar /etc/hostname y /etc/hosts de lo contrario tendremos problemas al crear un pool.

'''Si clonas una máquina virtual tras la instalación de los paquetes''', tienes que volver a crear el identificador único del nodo tal [https://wenhan.blog/post/glusterfs-failed-to-probe-a-cloned-peer/ aquí].

=== Paso 8.1.1. Editar /etc/hostname ===

Gluster requiere nombres únicos para identificar a las máquinas que forman parte del pool:

<syntaxhighlight lang="bash">
nano /etc/hostname
</syntaxhighlight>

Y pones ''server1''.

Tras esto, hay que reiniciar el sistema para que el cambio de nombre surta efecto.

Para la segunda máquina, pones ''server2''. Y así sucesivamente.

'''Es fundamental que todas las máquinas del pool tengan nombres únicos, de lo contrario gluster no va a funcionar'''.

=== Paso 8.1.2. Editar el /etc/hosts ===

Suponiendo que el nodo 2 tiene la dirección IP 192.168.122.75 y el nodo 1 tiene la IP 192.168.122.175, hay que editar /etc/hosts con:

<syntaxhighlight lang="bash">
127.0.0.1 localhost
192.168.122.175 server1
192.168.122.75 server2
</syntaxhighlight>

'''en todas las máquinas que formen parte del pool'''.

== Paso 8.2: Gestionar el pool de servidores ==

Para añadir el nodo 1 y al 2 al mismo pool, desde el nodo 2 hay que invocar:

<syntaxhighlight lang="bash">
gluster peer probe server1
</syntaxhighlight>

Ahora tienes que comprobar la lista de nodos del clúster en el ''pool'':

<syntaxhighlight lang="bash">
gluster pool list
</syntaxhighlight>

que muestra desde el nodo 1 lo siguiente:

<syntaxhighlight lang="bash">
UUID Hostname State
ca4b43a2-aa4b43a2-bb3422cc-a4540010 server2 Connected
ba4bbba2-bb4bbba2-cc3422cc-aaabff67 localhost Connected
</syntaxhighlight>

Comprobar el estado de los nodos:

<syntaxhighlight lang="bash">
gluster peer status
</syntaxhighlight>

que muestra:

<syntaxhighlight lang="bash">
Number of peers: 1

Hostname: server2
Uuid: ca4b43a2-aa4b43a2-bb3422cc-a45400S10
State: Peer in Cluster (Connected)
</syntaxhighlight>

Es posible borrar un nodo mediante la siguiente orden:

<syntaxhighlight lang="bash">
gluster peer detach server2
</syntaxhighlight>

== Paso 8.3: Gestionar el almacenamiento ==

En ambos nodos cree una carpeta:

<syntaxhighlight lang="bash">
mkdir -p /data/myvol1/brick1
</syntaxhighlight>

En '''uno''' de los nodos, puede crear el volumen:

<syntaxhighlight lang="bash">
gluster volume create myvol1 replica 2 server1:/data/myvol1/brick1 server2:/data/myvol1/brick1
</syntaxhighlight>

'''Nota''': Si la carpeta está en el raíz, entonces hay que añadir ''force'' al final de la orden anterior.

Y para iniciar el volumen:

<syntaxhighlight lang="bash">
gluster volume start myvol1
</syntaxhighlight>

Para listar los volúmenes existentes:

<syntaxhighlight lang="bash">
gluster volume list
</syntaxhighlight>

Puede comprobar la información y el estado del volumen:

<syntaxhighlight lang="bash">
gluster volume info
gluster volume status
</syntaxhighlight>

Además, cada nuevo volumen de glusterfs abre un puerto TCP que se puede observar con:

<syntaxhighlight lang="bash">
ss -ltnp
</syntaxhighlight>

La opción ''-p'' muestra el proceso asociado a dicho puerto, se puede observar que es un proceso de ''glusterfsd''. Esta información sobre los puertos TCP asociados al volumen también aparece en la información de''status'':

<syntaxhighlight lang="bash">
gluster volume status
</syntaxhighlight>

En caso de necesitar borrar un volumen de red, puedes invocar:

<syntaxhighlight lang="bash">
gluster volume stop myvol1
gluster volume delete myvol1
</syntaxhighlight>

parando el volumen en primer lugar para luego borrarlo.

== Paso 8.4: Cliente GlusterFS ==

Primero instala el paquete de cliente de GlusterFS.

<syntaxhighlight lang="bash">
apt install glusterfs-client
</syntaxhighlight>

Desde el cliente, puede montar el volumen con:

<syntaxhighlight lang="bash">
mount -t glusterfs server1:/myvol1 /mnt
</syntaxhighlight>

= Anexo =

* [[RAID con mdadm]]

Sistemas de archivos

2025-12-15T12:14:15Z

Pneira: /* Paso 6.3: Creación de volumen lógico (LV) */

= Paso 1: Añadir un disco a la máquina virtual =

Vamos a usar cualquier máquina virtual de debian cloud que hayamos usado
previamente y vamos a añadir dos discos virtuales para hacer pruebas.

# Abrimos la ventana de la máquina virtual a usar
# Nos movemos a Vista -> Detalles, y le damos al botón de 'Agregar hardware'
# Seleccionamos Almacenamiento, le damos un tamaño de 5GB y en el tipo de dispositivo seleccionamos 'dispositivo de disco'. Con estas opciones, pulsamos Finalizar., y ya tendremos nuestro disco creado.
# Repetir el paso anterior y crear otro disco de 4GB

Para crear un nuevo disco virtual desde el intérprete de órdenes:

<syntaxhighlight lang="bash">
qemu-img create -f qcow2 mi-disco.img 20G
</syntaxhighlight>

Para adjuntar este disco a una máquina virtual existente:

<syntaxhighlight lang="bash">
virsh attach-disk mi-mv /home/usuario/mi-disco.img vdb --cache none --subdriver qcow2 --config
</syntaxhighlight>

Esto va a adjuntar el disco virtual creando anteriormente a la máquina virtual cuyo nombre es ''mi-mv'' haciendo uso del driver paravirtualizado ''VirtIO''.

Ojo: ''virsh attach-disk'' requiere una ruta absoluta al disco virtual.

Posible errores:

* La máquina virtual a la que se quiere adjuntar el nuevo disco no existe

<syntaxhighlight lang="bash">
error: failed to get domain 'mi-mv'
</syntaxhighlight>

Consulte el listado de máquinas virtuales existentes con ''virsh''.

* El identificador del disco virtual ya existe:

<syntaxhighlight lang="bash">
error: Failed to attach disk
error: XML error: target 'vdb' duplicated for disk sources ...
</syntaxhighlight>

En este caso, indica que ''vdb'' ya está en uso para un disco virtual existente, por lo que debe emplear otro identificador tal como ''vdc'', ''vdd'', etc.

Para ver los discos virtuales de una máquina virtual:

<syntaxhighlight lang="bash">
virsh domblklist mi-mv
</syntaxhighlight>

que muestra una salida similar a:

<syntaxhighlight lang="bash">
Target Source
----------------------------------------------
hda /home/usuario/debian-cloud.img
vda /home/usuario/mi-disco.img
</syntaxhighlight>

Para eliminar un discho de la máquina virtual:

<syntaxhighlight lang="bash">
virsh detach-disk mi-mv vda --config
</syntaxhighlight>

= Paso 2: Ver discos en Linux =

Volvamos a la vista consola (Vista -> Consola) y arranquemos la máquina (Máquina virtual -> Ejecutar).

Para comprobar los discos añadidos en el paso 1 vamos a utilizar el comando '''lsblk''', el cual nos mostrará una salida similar a la siguiente:

<syntaxhighlight lang="bash">
NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT
sr0 11:0 1 1024M 0 rom
vda 252:0 0 2.2G 0 disk
├─vda1 252:1 0 2.1G 0 part /
├─vda14 252:14 0 4M 0 part
└─vda15 252:15 0 106M 0 part /boot/efi
vdb 252:16 0 20G 0 disk
</syntaxhighlight>

Aqui vemos que tenemos 3 discos:

* vda: el actual de la imagen cloud que añadimos al crear la máquina
* vdb: el disco que añadimos en el paso 1 de 5GB
* vdc: el disco que añadimos en el paso 1 de 4GB

También vemos que el disco vda tiene 3 particiones: vda1, vda14 y vda15

= Paso 3: Creación de particiones en Linux =

Vamos a utilizar ahora nuestro disco añadido de 20GB, en el paso anterior deberiamos de haber identificado cual es, en mi caso /dev/vdb, aseguraros cual es el vuestro y comenzaremos a particionar el disco:

<syntaxhighlight lang="bash">
fdisk /dev/vdb
</syntaxhighlight>

Desde fdisk, se pueden realizar las siguientes acciones:

* '''p''': Imprimir la tabla de particiones actual. Para un disco nuevo, la tabla de particiones está vacía y el tipo de particionado es DOS.
* '''t''': Establecer tipo de partición.
* '''g''': Cambia el tipo de particionado al esquema GPT.
* '''n''': Crear nueva partición, que solicita: El número de partición (si pulsamos intro, asigna una automáticamente), el comienzo de la partición (pulsando intro, la añade al final de lo que hay) y finalmente el tamaño de la particion (si pulsamos intro, se usa todo el espacio disponible en el disco para la partición).
* '''d''': Borrar partición.
* '''w''': Escribe la tabla de particiones a disco.

Tras crear una partición, con '''lsblk''' podemos comprobar que se ha realizado la operación correctamente.

<syntaxhighlight lang="bash">
NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT
sr0 11:0 1 1024M 0 rom
vda 252:0 0 2.2G 0 disk
├─vda1 252:1 0 2.1G 0 part /
├─vda14 252:14 0 4M 0 part
└─vda15 252:15 0 106M 0 part /boot/efi
vdb 252:16 0 20G 0 disk
└─vdb1 252:17 0 20G 0 part
</syntaxhighlight>

= Paso 4: Crear un sistema de archivos =

Tras la creación de la partición, vamos a crear un sistema de ficheros '''ext4'''.

<syntaxhighlight lang="bash">
mkfs -t ext4 /dev/vda1
</syntaxhighlight>

Una vez hecho esto, vamos a comprobar que se han aplicado bien los cambios:

<syntaxhighlight lang="bash">
file -s /dev/vda1
</syntaxhighlight>

Hay otros sistemas de ficheros, como ''fat''.

= Paso 5: Montar y desmontar sistema de ficheros =

Tras haber creado en los pasos anteriores unas particiones y formatearlas, vamos a pasar ahora a montarlas para poderles dar uso.

<syntaxhighlight lang="bash">
mount /dev/vda1 /mnt
</syntaxhighlight>

tras esto, podemos comprobar que ha sido montada, mediante:

<syntaxhighlight lang="bash">
mount | grep vda1
</syntaxhighlight>

Podemos probar a crear un fichero en el nuevo sistema de ficheros que hemos montado:

<syntaxhighlight lang="bash">
touch /mnt/fichero.txt
</syntaxhighlight>

y comprobar que existe.

<syntaxhighlight lang="bash">
ls -la /mnt
</syntaxhighlight>

Para desmontar el sistema de fichero, tenemos que hacer:

<syntaxhighlight lang="bash">
umount /mnt
</syntaxhighlight>

== Paso 5.1: Montar persistente modificando /etc/fstab ==

Hay un fichero de configuración del sistema /etc/fstab (fstab viene de '''f'''ile '''s'''ystem '''tab'''le) que indica la configuración de montaje en tiempo de arranque de la máquina virtual.

Podemos consultar su contenido con:

<syntaxhighlight lang="bash">
cat /etc/fstab
</syntaxhighlight>

Cada fila contiene un montaje de una partición, la cual contiene:

* Identificación de la partición: PARTUUID de la partición.
* Punto de montaje: donde se montará el dispositivo
* Sistema de archivos: ext4, fat.
* Opciones: aquí pondremos las diferentes opciones de montaje, como por ejemplo montar para solo lectura, dar permisos a un usuario para utilizar la partición, etc. Hay que tener en cuenta que cada sistema tiene sus opciones.
* backup: si está a cero, no haremos backup
* chequeo: si está a cero no se hace chequeo al arrancar el sistema operativo.

Para obtener el PARTUUID de la partición, hay que ejecutar:

<syntaxhighlight lang="bash">
blkid /dev/vda1
</syntaxhighlight>

que va a mostrar la etique PARTUUID.

Ahora abrimos /etc/fstab y añadimos esta línea:

<syntaxhighlight lang="bash">
PARTUUID=de50c6a1-b332-40b7-98b5-878cbd30d94e /mnt ext4 rw,user,exec 0 0
</syntaxhighlight>

Para montar todos los sistemas de ficheros en /etc/fstab, podemos hacer:

<syntaxhighlight lang="bash">
mount -a
</syntaxhighlight>

Podemos comprobar que está montado.

<syntaxhighlight lang="bash">
lsblk
</syntaxhighlight>

= Paso 6: Gestión volúmenes (Logic Volume Manager, LVM) =

Logic Volume Manager (LVM) es una capa de software que permite crear volúmenes lógicos y mapearlos de manera sencilla sobre dispositivos físicos.

La instalación de LVM es sencilla mediante la orden:

apt-get install lvm2

La gestión de LVM se basa en tres conceptos básicos:

* Volúmenes físicos (PV): Representa una unidad de almacenamiento que aprovisiona espacio de almacenamiento para el volumen lógico que vamos a crear.
* Grupo volumen (VG): Representa un almacén de espacio para LVM. Un VG estará compuesto por varios PV, pudiendo tener tantos VG como sean necesarios.
* Volumen lógico (LV): Representan unidades lógicas creadas a partir de VG creado previamente. Se podrán crear tantos LV como sean necesarios para un VG. La creación de un LVM genera un archivo especial en /dev, con la forma /dev/nombre_del_grupo/nombre_volumne_logico. El mapeo de espacio desde un LV hasta un PV es configurable pudiendo ser: Lineal, RAID, Cache, ...

== Paso 6.1: Creación de volumen físico LVM (PV) ==

Para listar las unidades de almacenamiento disponibles en el sistema, empleamos la siguiente orden:

lsblk

Para crear un volumen físico en la unidad /dev/vdb, empleamos la orden:

pvcreate /dev/vdb

Recuerde que la unidad /dev/vdb tiene que estar en desuso.

Para ver los volúmenes físicos existentes, empleamos la orden:

pvscan

Para obtener más información:

pvdisplay

Para eliminar un PV, por ejemplo /dev/vdb:

pvremove /dev/vdb

Si reporta error indicando que está en uso, mueve el contenido del volumen que quieres borrar a otro de los volúmenes físicos que forman parte del grupo:

pvmove /dev/vdb /dev/vdc

y prueba a borrarlo de nuevo. La orden ''lsblk'' ofrece información acerca del uso de los volúmenes físicos.

== Paso 6.2: Creación de grupo de volumenes LVM (VG) ==

Para crear un grupo, empleamos el comando vgcreate:

vgcreate vg_prueba /dev/vdb /dev/vdc

Esto añade al grupo 'vg_prueba' los volúmenes vdb y vdc, haciendo que la capacidad del grupo sea la capacidad agregada de los PV añadidos.

Para eliminar un grupo vgremove:

vgremove vg_prueba

Para extender un grupo creado (por ejemplo, vg_prueba) con más PV (por ejemplo /dev/vde) usamos el comando vgextend:

vgextend vg_prueba /dev/vde

Para reducir la capacidad de un grupo creado (por ejemplo, vg_prueba) basta con usar el comando vgreduce indicando la unidad (PV) a quitar, por ejemplo /dev/vde:

vgreduce vg_prueba /dev/vde

Para mostrar todos los grupos de volumenes existentes

vgscan

== Paso 6.3: Creación de volumen lógico (LV) ==

Para crear un volúmen lógico, empleamos la orden:

lvcreate --name volumen1 --size 100MB vg_prueba

Opcionalmente, es posible crear también un volumen restringiendo los volúmenes físicos empleados disponible en el grupo, por ejemplo, indicando que solo se puede usar el volumen físico /dev/vdb y /dev/vdc:

lvcreate --name volumen1 --size 100MB /dev/vdb /dev/vdc

A partir de este momento hay una unidad que se presenta como ''/dev/mapper/vg_prueba-volumen1''.

Podemos ahora formatear el volumen lógico:

mkfs.ext4 /dev/vg_prueba/volumen1

y montarlo para almacenar información:

mount /dev/vg_prueba/volumen1 /mnt

Puedes extender un volumen lógico en 1 Gbyte de más:

lvextend --size +1GB /dev/vg_prueba/volumen1

Para ext4, justo después tienes que redimensionar el sistema de ficheros:

resize2fs /dev/vg_prueba/volumen1

Aunque también puedes extender el tamaño del volumen y el sistema de ficheros mediante:

lvextend --size +1GB /dev/vg_prueba/volumen1 --resizefs

Puedes comprobar con:

df -h

que el sistema de ficheros en ''volumen1'' ocupa ahora todo el volumen lógico.

Reducir el tamaño de un volumen lógico es un poco más complicado, ¡podrían perder datos si no se realiza correctamente!

Primero, desmontamos el volumen:

umount /mnt/volumen1

reducir el tamaño del sistema de ficheros, comprobamos la integridad del sistema de ficheros:

e2fsck -f /dev/vg_prueba/volumen1

Y lo redimensionamos (reducimos de tamaño):

resize2fs /dev/vg_prueba/volumen1 500M

Ahora ya, por último lugar, puedes reducir el tamaño del volumen:

lvreduce --size 500M /dev/vg_prueba/volumen1

Para comprobar que hay ido todo bien, vuelve a redimensionar el sistema de ficheros para que ocupe todo el espacio disponible.

resize2fs /dev/vg_prueba/volumen1

Y puedes volver a montar el sistema de ficheros:

mount /dev/vg_prueba/volumen1 /mnt/volumen1

con

df -h

para comprar el nuevo tamaño disponible de sólo 500 MBytes.

Es posible borrar un volumen lógico:

lvremove /dev/vg_prueba/volumen1

asegúrate que no está montando, de lo contrario esta órden reportará que el volumen está en uso.

== Paso 6.4: Montaje persistente del volúmen lógico con /etc/fstab ==

Recuerde usar el '''UUID'' para referirse al volumen lógico desde /etc/fstab:

blkid /dev/vg_prueba/volumen1

que en /etc/fstab resulta en:

UUID=bb50c6a1-b332-40b7-98b5-878cbd30d94e /mnt ext4 rw,user,exec 0 0

= Paso 7: Creación de volumen lógico con RAID =

Para crear un RAID 0 de 20 GBytes.

lvcreate --type raid0 --stripes 2 --size 20G --name mi_raid0 vg_prueba

Para comprobar el estado del raid (mira el % que indica el nivel de sincronía):

lvs -a

Para comprobar los volúmenes que forman parte del RAID:

lsblk

* -o indica el formato de salida del estado, al poner +devices añade información sobre los volúmenes físicos empleados en el RAID.

* --stripes indica cuantos discos (del grupo de volúmenes) se usan activamente en la distribución de los datos.

En un RAID 0 con stripe 2 (el mínimo para poder hacerlo), sería:

Disco 1 Disco 2
A1 B1 C1 A2 B2 C2

Recuerde que RAID 1 hace ''mirroring'', por lo que no se hace striping, pero requiere como mínimo dos discos:

Disco 1 Disco 2
A B C A B C

Para crear un RAID 1+0, se necesitan 4 volúmenes físicos como mínimo previamente para crear un RAID 1+0, pues combina ambos RAID.

lvcreate --type raid10 --mirrors 1 --stripes 2 --size 20G --name raid0 vg_prueba

Para RAID 1+0, la cuenta de discos necesario es:

stripes * (mirrors + 1) = 2 * (1 + 1) = 4 discos.

Para reemplazar un volumen físico del RAID por otro, puede hacer:

lvconvert --replace /dev/vda vg_prueba/raid0 /dev/vdb

o, de manera síncrona:

pvmove /dev/vda /dev/vdb

Hay un artículo [https://en.wikipedia.org/wiki/Standard_RAID_levels Wikipedia] que describe los niveles de RAID de manera muy detallada.

'''NOTA''': Es mejor gestionar [[RAID con mdadm]] y luego combinarlo con lvm para la gestión de volúmenes, pero el material oficial de la asignatura prefiere usar lvm.

= Paso 8: GlusterFS =

GlusterFS es un sistema de archivos cliente-servidor de almacenamiento en red escalable. También puede consultar [https://docs.gluster.org/en/latest/Administrator-Guide/ official documentation] para más detalles.

Algunos conceptos:

* Nodo: máquina que proporciona espacio de almacenamiento.
* Pool: Un conjunto de nodos.
* Cliente: máquina en la que se monta un volumen

y con respecto al almacenamiento:

* Brick: Unidad mínima de almacenamiento (dada por un sistema de archivos exportado por un nodo). En cada nodo se define un brick.
* Volumen: unidad lógica compuesta por bricks de uno o varios nodos.

== Paso 8.1: Instalar el servidor GlusterFS ==

Para instalar Glusterfs:

<syntaxhighlight lang="bash">
apt install glusterfs-server
systemctl enable --now glusterd
systemctl start glusterd
systemctl status glusterd
</syntaxhighlight>

Puedes consultar los logs en: /var/log/glusterfs/glusterd.log

Puedes comprobar que el servicio está activo verificado que el puerto TCP/24007 está activo:

<syntaxhighlight lang="bash">
ss -ltn
</syntaxhighlight>

La orden ''ss'' muestra con esta opción los servicios TCP (-t) que están escuchando (-l, de ''listen'') y usando la notación numérica (-n).

Si vamos a construir un pool con dos nodos, tenemos que editar /etc/hostname y /etc/hosts de lo contrario tendremos problemas al crear un pool.

'''Si clonas una máquina virtual tras la instalación de los paquetes''', tienes que volver a crear el identificador único del nodo tal [https://wenhan.blog/post/glusterfs-failed-to-probe-a-cloned-peer/ aquí].

=== Paso 8.1.1. Editar /etc/hostname ===

Gluster requiere nombres únicos para identificar a las máquinas que forman parte del pool:

<syntaxhighlight lang="bash">
nano /etc/hostname
</syntaxhighlight>

Y pones ''server1''.

Tras esto, hay que reiniciar el sistema para que el cambio de nombre surta efecto.

Para la segunda máquina, pones ''server2''. Y así sucesivamente.

'''Es fundamental que todas las máquinas del pool tengan nombres únicos, de lo contrario gluster no va a funcionar'''.

=== Paso 8.1.2. Editar el /etc/hosts ===

Suponiendo que el nodo 2 tiene la dirección IP 192.168.122.75 y el nodo 1 tiene la IP 192.168.122.175, hay que editar /etc/hosts con:

<syntaxhighlight lang="bash">
127.0.0.1 localhost
192.168.122.175 server1
192.168.122.75 server2
</syntaxhighlight>

'''en todas las máquinas que formen parte del pool'''.

== Paso 8.2: Gestionar el pool de servidores ==

Para añadir el nodo 1 y al 2 al mismo pool, desde el nodo 2 hay que invocar:

<syntaxhighlight lang="bash">
gluster peer probe server1
</syntaxhighlight>

Ahora tienes que comprobar la lista de nodos del clúster en el ''pool'':

<syntaxhighlight lang="bash">
gluster pool list
</syntaxhighlight>

que muestra desde el nodo 1 lo siguiente:

<syntaxhighlight lang="bash">
UUID Hostname State
ca4b43a2-aa4b43a2-bb3422cc-a4540010 server2 Connected
ba4bbba2-bb4bbba2-cc3422cc-aaabff67 localhost Connected
</syntaxhighlight>

Comprobar el estado de los nodos:

<syntaxhighlight lang="bash">
gluster peer status
</syntaxhighlight>

que muestra:

<syntaxhighlight lang="bash">
Number of peers: 1

Hostname: server2
Uuid: ca4b43a2-aa4b43a2-bb3422cc-a45400S10
State: Peer in Cluster (Connected)
</syntaxhighlight>

Es posible borrar un nodo mediante la siguiente orden:

<syntaxhighlight lang="bash">
gluster peer detach server2
</syntaxhighlight>

== Paso 8.3: Gestionar el almacenamiento ==

En ambos nodos cree una carpeta:

<syntaxhighlight lang="bash">
mkdir -p /data/myvol1/brick1
</syntaxhighlight>

En '''uno''' de los nodos, puede crear el volumen:

<syntaxhighlight lang="bash">
gluster volume create myvol1 replica 2 server1:/data/myvol1/brick1 server2:/data/myvol1/brick1
</syntaxhighlight>

'''Nota''': Si la carpeta está en el raíz, entonces hay que añadir ''force'' al final de la orden anterior.

Y para iniciar el volumen:

<syntaxhighlight lang="bash">
gluster volume start myvol1
</syntaxhighlight>

Para listar los volúmenes existentes:

<syntaxhighlight lang="bash">
gluster volume list
</syntaxhighlight>

Puede comprobar la información y el estado del volumen:

<syntaxhighlight lang="bash">
gluster volume info
gluster volume status
</syntaxhighlight>

Además, cada nuevo volumen de glusterfs abre un puerto TCP que se puede observar con:

<syntaxhighlight lang="bash">
ss -ltnp
</syntaxhighlight>

La opción ''-p'' muestra el proceso asociado a dicho puerto, se puede observar que es un proceso de ''glusterfsd''. Esta información sobre los puertos TCP asociados al volumen también aparece en la información de''status'':

<syntaxhighlight lang="bash">
gluster volume status
</syntaxhighlight>

En caso de necesitar borrar un volumen de red, puedes invocar:

<syntaxhighlight lang="bash">
gluster volume stop myvol1
gluster volume delete myvol1
</syntaxhighlight>

parando el volumen en primer lugar para luego borrarlo.

== Paso 8.4: Cliente GlusterFS ==

Primero instala el paquete de cliente de GlusterFS.

<syntaxhighlight lang="bash">
apt install glusterfs-client
</syntaxhighlight>

Desde el cliente, puede montar el volumen con:

<syntaxhighlight lang="bash">
mount -t glusterfs server1:/myvol1 /mnt
</syntaxhighlight>

= Anexo =

* [[RAID con mdadm]]

Sistemas de archivos

2025-12-15T12:01:40Z

Pneira: /* Paso 6.3: Creación de volumen lógico (LV) */

= Paso 1: Añadir un disco a la máquina virtual =

Vamos a usar cualquier máquina virtual de debian cloud que hayamos usado
previamente y vamos a añadir dos discos virtuales para hacer pruebas.

# Abrimos la ventana de la máquina virtual a usar
# Nos movemos a Vista -> Detalles, y le damos al botón de 'Agregar hardware'
# Seleccionamos Almacenamiento, le damos un tamaño de 5GB y en el tipo de dispositivo seleccionamos 'dispositivo de disco'. Con estas opciones, pulsamos Finalizar., y ya tendremos nuestro disco creado.
# Repetir el paso anterior y crear otro disco de 4GB

Para crear un nuevo disco virtual desde el intérprete de órdenes:

<syntaxhighlight lang="bash">
qemu-img create -f qcow2 mi-disco.img 20G
</syntaxhighlight>

Para adjuntar este disco a una máquina virtual existente:

<syntaxhighlight lang="bash">
virsh attach-disk mi-mv /home/usuario/mi-disco.img vdb --cache none --subdriver qcow2 --config
</syntaxhighlight>

Esto va a adjuntar el disco virtual creando anteriormente a la máquina virtual cuyo nombre es ''mi-mv'' haciendo uso del driver paravirtualizado ''VirtIO''.

Ojo: ''virsh attach-disk'' requiere una ruta absoluta al disco virtual.

Posible errores:

* La máquina virtual a la que se quiere adjuntar el nuevo disco no existe

<syntaxhighlight lang="bash">
error: failed to get domain 'mi-mv'
</syntaxhighlight>

Consulte el listado de máquinas virtuales existentes con ''virsh''.

* El identificador del disco virtual ya existe:

<syntaxhighlight lang="bash">
error: Failed to attach disk
error: XML error: target 'vdb' duplicated for disk sources ...
</syntaxhighlight>

En este caso, indica que ''vdb'' ya está en uso para un disco virtual existente, por lo que debe emplear otro identificador tal como ''vdc'', ''vdd'', etc.

Para ver los discos virtuales de una máquina virtual:

<syntaxhighlight lang="bash">
virsh domblklist mi-mv
</syntaxhighlight>

que muestra una salida similar a:

<syntaxhighlight lang="bash">
Target Source
----------------------------------------------
hda /home/usuario/debian-cloud.img
vda /home/usuario/mi-disco.img
</syntaxhighlight>

Para eliminar un discho de la máquina virtual:

<syntaxhighlight lang="bash">
virsh detach-disk mi-mv vda --config
</syntaxhighlight>

= Paso 2: Ver discos en Linux =

Volvamos a la vista consola (Vista -> Consola) y arranquemos la máquina (Máquina virtual -> Ejecutar).

Para comprobar los discos añadidos en el paso 1 vamos a utilizar el comando '''lsblk''', el cual nos mostrará una salida similar a la siguiente:

<syntaxhighlight lang="bash">
NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT
sr0 11:0 1 1024M 0 rom
vda 252:0 0 2.2G 0 disk
├─vda1 252:1 0 2.1G 0 part /
├─vda14 252:14 0 4M 0 part
└─vda15 252:15 0 106M 0 part /boot/efi
vdb 252:16 0 20G 0 disk
</syntaxhighlight>

Aqui vemos que tenemos 3 discos:

* vda: el actual de la imagen cloud que añadimos al crear la máquina
* vdb: el disco que añadimos en el paso 1 de 5GB
* vdc: el disco que añadimos en el paso 1 de 4GB

También vemos que el disco vda tiene 3 particiones: vda1, vda14 y vda15

= Paso 3: Creación de particiones en Linux =

Vamos a utilizar ahora nuestro disco añadido de 20GB, en el paso anterior deberiamos de haber identificado cual es, en mi caso /dev/vdb, aseguraros cual es el vuestro y comenzaremos a particionar el disco:

<syntaxhighlight lang="bash">
fdisk /dev/vdb
</syntaxhighlight>

Desde fdisk, se pueden realizar las siguientes acciones:

* '''p''': Imprimir la tabla de particiones actual. Para un disco nuevo, la tabla de particiones está vacía y el tipo de particionado es DOS.
* '''t''': Establecer tipo de partición.
* '''g''': Cambia el tipo de particionado al esquema GPT.
* '''n''': Crear nueva partición, que solicita: El número de partición (si pulsamos intro, asigna una automáticamente), el comienzo de la partición (pulsando intro, la añade al final de lo que hay) y finalmente el tamaño de la particion (si pulsamos intro, se usa todo el espacio disponible en el disco para la partición).
* '''d''': Borrar partición.
* '''w''': Escribe la tabla de particiones a disco.

Tras crear una partición, con '''lsblk''' podemos comprobar que se ha realizado la operación correctamente.

<syntaxhighlight lang="bash">
NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT
sr0 11:0 1 1024M 0 rom
vda 252:0 0 2.2G 0 disk
├─vda1 252:1 0 2.1G 0 part /
├─vda14 252:14 0 4M 0 part
└─vda15 252:15 0 106M 0 part /boot/efi
vdb 252:16 0 20G 0 disk
└─vdb1 252:17 0 20G 0 part
</syntaxhighlight>

= Paso 4: Crear un sistema de archivos =

Tras la creación de la partición, vamos a crear un sistema de ficheros '''ext4'''.

<syntaxhighlight lang="bash">
mkfs -t ext4 /dev/vda1
</syntaxhighlight>

Una vez hecho esto, vamos a comprobar que se han aplicado bien los cambios:

<syntaxhighlight lang="bash">
file -s /dev/vda1
</syntaxhighlight>

Hay otros sistemas de ficheros, como ''fat''.

= Paso 5: Montar y desmontar sistema de ficheros =

Tras haber creado en los pasos anteriores unas particiones y formatearlas, vamos a pasar ahora a montarlas para poderles dar uso.

<syntaxhighlight lang="bash">
mount /dev/vda1 /mnt
</syntaxhighlight>

tras esto, podemos comprobar que ha sido montada, mediante:

<syntaxhighlight lang="bash">
mount | grep vda1
</syntaxhighlight>

Podemos probar a crear un fichero en el nuevo sistema de ficheros que hemos montado:

<syntaxhighlight lang="bash">
touch /mnt/fichero.txt
</syntaxhighlight>

y comprobar que existe.

<syntaxhighlight lang="bash">
ls -la /mnt
</syntaxhighlight>

Para desmontar el sistema de fichero, tenemos que hacer:

<syntaxhighlight lang="bash">
umount /mnt
</syntaxhighlight>

== Paso 5.1: Montar persistente modificando /etc/fstab ==

Hay un fichero de configuración del sistema /etc/fstab (fstab viene de '''f'''ile '''s'''ystem '''tab'''le) que indica la configuración de montaje en tiempo de arranque de la máquina virtual.

Podemos consultar su contenido con:

<syntaxhighlight lang="bash">
cat /etc/fstab
</syntaxhighlight>

Cada fila contiene un montaje de una partición, la cual contiene:

* Identificación de la partición: PARTUUID de la partición.
* Punto de montaje: donde se montará el dispositivo
* Sistema de archivos: ext4, fat.
* Opciones: aquí pondremos las diferentes opciones de montaje, como por ejemplo montar para solo lectura, dar permisos a un usuario para utilizar la partición, etc. Hay que tener en cuenta que cada sistema tiene sus opciones.
* backup: si está a cero, no haremos backup
* chequeo: si está a cero no se hace chequeo al arrancar el sistema operativo.

Para obtener el PARTUUID de la partición, hay que ejecutar:

<syntaxhighlight lang="bash">
blkid /dev/vda1
</syntaxhighlight>

que va a mostrar la etique PARTUUID.

Ahora abrimos /etc/fstab y añadimos esta línea:

<syntaxhighlight lang="bash">
PARTUUID=de50c6a1-b332-40b7-98b5-878cbd30d94e /mnt ext4 rw,user,exec 0 0
</syntaxhighlight>

Para montar todos los sistemas de ficheros en /etc/fstab, podemos hacer:

<syntaxhighlight lang="bash">
mount -a
</syntaxhighlight>

Podemos comprobar que está montado.

<syntaxhighlight lang="bash">
lsblk
</syntaxhighlight>

= Paso 6: Gestión volúmenes (Logic Volume Manager, LVM) =

Logic Volume Manager (LVM) es una capa de software que permite crear volúmenes lógicos y mapearlos de manera sencilla sobre dispositivos físicos.

La instalación de LVM es sencilla mediante la orden:

apt-get install lvm2

La gestión de LVM se basa en tres conceptos básicos:

* Volúmenes físicos (PV): Representa una unidad de almacenamiento que aprovisiona espacio de almacenamiento para el volumen lógico que vamos a crear.
* Grupo volumen (VG): Representa un almacén de espacio para LVM. Un VG estará compuesto por varios PV, pudiendo tener tantos VG como sean necesarios.
* Volumen lógico (LV): Representan unidades lógicas creadas a partir de VG creado previamente. Se podrán crear tantos LV como sean necesarios para un VG. La creación de un LVM genera un archivo especial en /dev, con la forma /dev/nombre_del_grupo/nombre_volumne_logico. El mapeo de espacio desde un LV hasta un PV es configurable pudiendo ser: Lineal, RAID, Cache, ...

== Paso 6.1: Creación de volumen físico LVM (PV) ==

Para listar las unidades de almacenamiento disponibles en el sistema, empleamos la siguiente orden:

lsblk

Para crear un volumen físico en la unidad /dev/vdb, empleamos la orden:

pvcreate /dev/vdb

Recuerde que la unidad /dev/vdb tiene que estar en desuso.

Para ver los volúmenes físicos existentes, empleamos la orden:

pvscan

Para obtener más información:

pvdisplay

Para eliminar un PV, por ejemplo /dev/vdb:

pvremove /dev/vdb

Si reporta error indicando que está en uso, mueve el contenido del volumen que quieres borrar a otro de los volúmenes físicos que forman parte del grupo:

pvmove /dev/vdb /dev/vdc

y prueba a borrarlo de nuevo. La orden ''lsblk'' ofrece información acerca del uso de los volúmenes físicos.

== Paso 6.2: Creación de grupo de volumenes LVM (VG) ==

Para crear un grupo, empleamos el comando vgcreate:

vgcreate vg_prueba /dev/vdb /dev/vdc

Esto añade al grupo 'vg_prueba' los volúmenes vdb y vdc, haciendo que la capacidad del grupo sea la capacidad agregada de los PV añadidos.

Para eliminar un grupo vgremove:

vgremove vg_prueba

Para extender un grupo creado (por ejemplo, vg_prueba) con más PV (por ejemplo /dev/vde) usamos el comando vgextend:

vgextend vg_prueba /dev/vde

Para reducir la capacidad de un grupo creado (por ejemplo, vg_prueba) basta con usar el comando vgreduce indicando la unidad (PV) a quitar, por ejemplo /dev/vde:

vgreduce vg_prueba /dev/vde

Para mostrar todos los grupos de volumenes existentes

vgscan

== Paso 6.3: Creación de volumen lógico (LV) ==

Para crear un volúmen lógico, empleamos la orden:

lvcreate --name volumen1 --size 100MB vg_prueba

Opcionalmente, es posible crear también un volumen restringiendo los volúmenes físicos empleados disponible en el grupo, por ejemplo, indicando que solo se puede usar el volumen físico /dev/vdb y /dev/vdc:

lvcreate --name volumen1 --size 100MB /dev/vdb /dev/vdc

A partir de este momento hay una unidad que se presenta como ''/dev/mapper/vg_prueba-volumen1''.

Podemos ahora formatear el volumen lógico:

mkfs.ext4 /dev/vg_prueba/volumen1

y montarlo para almacenar información:

mount /dev/vg_prueba/volumen1 /mnt

Puedes extender un volumen lógico en 1 Gbyte de más:

lvextend --size +1GB /dev/vg_prueba/volumen1

Justo después tienes que redimensionar el sistema de ficheros:

resize2fs /dev/vg_prueba/volumen1

Puedes comprobar con:

df -h

que el sistema de ficheros en ''volumen1'' ocupa ahora todo el volumen lógico.

Reducir el tamaño de un volumen lógico es un poco más complicado, ¡podrían perder datos si no se realiza correctamente!

Primero, desmontamos el volumen:

umount /mnt/volumen1

reducir el tamaño del sistema de ficheros, comprobamos la integridad del sistema de ficheros:

e2fsck -f /dev/vg_prueba/volumen1

Y lo redimensionamos (reducimos de tamaño):

resize2fs /dev/vg_prueba/volumen1 500M

Ahora ya, por último lugar, puedes reducir el tamaño del volumen:

lvreduce --size 500M /dev/vg_prueba/volumen1

Para comprobar que hay ido todo bien, vuelve a redimensionar el sistema de ficheros para que ocupe todo el espacio disponible.

resize2fs /dev/vg_prueba/volumen1

Y puedes volver a montar el sistema de ficheros:

mount /dev/vg_prueba/volumen1 /mnt/volumen1

con

df -h

para comprar el nuevo tamaño disponible de sólo 500 MBytes.

Es posible borrar un volumen lógico:

lvremove /dev/vg_prueba/volumen1

asegúrate que no está montando, de lo contrario esta órden reportará que el volumen está en uso.

== Paso 6.4: Montaje persistente del volúmen lógico con /etc/fstab ==

Recuerde usar el '''UUID'' para referirse al volumen lógico desde /etc/fstab:

blkid /dev/vg_prueba/volumen1

que en /etc/fstab resulta en:

UUID=bb50c6a1-b332-40b7-98b5-878cbd30d94e /mnt ext4 rw,user,exec 0 0

= Paso 7: Creación de volumen lógico con RAID =

Para crear un RAID 0 de 20 GBytes.

lvcreate --type raid0 --stripes 2 --size 20G --name mi_raid0 vg_prueba

Para comprobar el estado del raid (mira el % que indica el nivel de sincronía):

lvs -a

Para comprobar los volúmenes que forman parte del RAID:

lsblk

* -o indica el formato de salida del estado, al poner +devices añade información sobre los volúmenes físicos empleados en el RAID.

* --stripes indica cuantos discos (del grupo de volúmenes) se usan activamente en la distribución de los datos.

En un RAID 0 con stripe 2 (el mínimo para poder hacerlo), sería:

Disco 1 Disco 2
A1 B1 C1 A2 B2 C2

Recuerde que RAID 1 hace ''mirroring'', por lo que no se hace striping, pero requiere como mínimo dos discos:

Disco 1 Disco 2
A B C A B C

Para crear un RAID 1+0, se necesitan 4 volúmenes físicos como mínimo previamente para crear un RAID 1+0, pues combina ambos RAID.

lvcreate --type raid10 --mirrors 1 --stripes 2 --size 20G --name raid0 vg_prueba

Para RAID 1+0, la cuenta de discos necesario es:

stripes * (mirrors + 1) = 2 * (1 + 1) = 4 discos.

Para reemplazar un volumen físico del RAID por otro, puede hacer:

lvconvert --replace /dev/vda vg_prueba/raid0 /dev/vdb

o, de manera síncrona:

pvmove /dev/vda /dev/vdb

Hay un artículo [https://en.wikipedia.org/wiki/Standard_RAID_levels Wikipedia] que describe los niveles de RAID de manera muy detallada.

'''NOTA''': Es mejor gestionar [[RAID con mdadm]] y luego combinarlo con lvm para la gestión de volúmenes, pero el material oficial de la asignatura prefiere usar lvm.

= Paso 8: GlusterFS =

GlusterFS es un sistema de archivos cliente-servidor de almacenamiento en red escalable. También puede consultar [https://docs.gluster.org/en/latest/Administrator-Guide/ official documentation] para más detalles.

Algunos conceptos:

* Nodo: máquina que proporciona espacio de almacenamiento.
* Pool: Un conjunto de nodos.
* Cliente: máquina en la que se monta un volumen

y con respecto al almacenamiento:

* Brick: Unidad mínima de almacenamiento (dada por un sistema de archivos exportado por un nodo). En cada nodo se define un brick.
* Volumen: unidad lógica compuesta por bricks de uno o varios nodos.

== Paso 8.1: Instalar el servidor GlusterFS ==

Para instalar Glusterfs:

<syntaxhighlight lang="bash">
apt install glusterfs-server
systemctl enable --now glusterd
systemctl start glusterd
systemctl status glusterd
</syntaxhighlight>

Puedes consultar los logs en: /var/log/glusterfs/glusterd.log

Puedes comprobar que el servicio está activo verificado que el puerto TCP/24007 está activo:

<syntaxhighlight lang="bash">
ss -ltn
</syntaxhighlight>

La orden ''ss'' muestra con esta opción los servicios TCP (-t) que están escuchando (-l, de ''listen'') y usando la notación numérica (-n).

Si vamos a construir un pool con dos nodos, tenemos que editar /etc/hostname y /etc/hosts de lo contrario tendremos problemas al crear un pool.

'''Si clonas una máquina virtual tras la instalación de los paquetes''', tienes que volver a crear el identificador único del nodo tal [https://wenhan.blog/post/glusterfs-failed-to-probe-a-cloned-peer/ aquí].

=== Paso 8.1.1. Editar /etc/hostname ===

Gluster requiere nombres únicos para identificar a las máquinas que forman parte del pool:

<syntaxhighlight lang="bash">
nano /etc/hostname
</syntaxhighlight>

Y pones ''server1''.

Tras esto, hay que reiniciar el sistema para que el cambio de nombre surta efecto.

Para la segunda máquina, pones ''server2''. Y así sucesivamente.

'''Es fundamental que todas las máquinas del pool tengan nombres únicos, de lo contrario gluster no va a funcionar'''.

=== Paso 8.1.2. Editar el /etc/hosts ===

Suponiendo que el nodo 2 tiene la dirección IP 192.168.122.75 y el nodo 1 tiene la IP 192.168.122.175, hay que editar /etc/hosts con:

<syntaxhighlight lang="bash">
127.0.0.1 localhost
192.168.122.175 server1
192.168.122.75 server2
</syntaxhighlight>

'''en todas las máquinas que formen parte del pool'''.

== Paso 8.2: Gestionar el pool de servidores ==

Para añadir el nodo 1 y al 2 al mismo pool, desde el nodo 2 hay que invocar:

<syntaxhighlight lang="bash">
gluster peer probe server1
</syntaxhighlight>

Ahora tienes que comprobar la lista de nodos del clúster en el ''pool'':

<syntaxhighlight lang="bash">
gluster pool list
</syntaxhighlight>

que muestra desde el nodo 1 lo siguiente:

<syntaxhighlight lang="bash">
UUID Hostname State
ca4b43a2-aa4b43a2-bb3422cc-a4540010 server2 Connected
ba4bbba2-bb4bbba2-cc3422cc-aaabff67 localhost Connected
</syntaxhighlight>

Comprobar el estado de los nodos:

<syntaxhighlight lang="bash">
gluster peer status
</syntaxhighlight>

que muestra:

<syntaxhighlight lang="bash">
Number of peers: 1

Hostname: server2
Uuid: ca4b43a2-aa4b43a2-bb3422cc-a45400S10
State: Peer in Cluster (Connected)
</syntaxhighlight>

Es posible borrar un nodo mediante la siguiente orden:

<syntaxhighlight lang="bash">
gluster peer detach server2
</syntaxhighlight>

== Paso 8.3: Gestionar el almacenamiento ==

En ambos nodos cree una carpeta:

<syntaxhighlight lang="bash">
mkdir -p /data/myvol1/brick1
</syntaxhighlight>

En '''uno''' de los nodos, puede crear el volumen:

<syntaxhighlight lang="bash">
gluster volume create myvol1 replica 2 server1:/data/myvol1/brick1 server2:/data/myvol1/brick1
</syntaxhighlight>

'''Nota''': Si la carpeta está en el raíz, entonces hay que añadir ''force'' al final de la orden anterior.

Y para iniciar el volumen:

<syntaxhighlight lang="bash">
gluster volume start myvol1
</syntaxhighlight>

Para listar los volúmenes existentes:

<syntaxhighlight lang="bash">
gluster volume list
</syntaxhighlight>

Puede comprobar la información y el estado del volumen:

<syntaxhighlight lang="bash">
gluster volume info
gluster volume status
</syntaxhighlight>

Además, cada nuevo volumen de glusterfs abre un puerto TCP que se puede observar con:

<syntaxhighlight lang="bash">
ss -ltnp
</syntaxhighlight>

La opción ''-p'' muestra el proceso asociado a dicho puerto, se puede observar que es un proceso de ''glusterfsd''. Esta información sobre los puertos TCP asociados al volumen también aparece en la información de''status'':

<syntaxhighlight lang="bash">
gluster volume status
</syntaxhighlight>

En caso de necesitar borrar un volumen de red, puedes invocar:

<syntaxhighlight lang="bash">
gluster volume stop myvol1
gluster volume delete myvol1
</syntaxhighlight>

parando el volumen en primer lugar para luego borrarlo.

== Paso 8.4: Cliente GlusterFS ==

Primero instala el paquete de cliente de GlusterFS.

<syntaxhighlight lang="bash">
apt install glusterfs-client
</syntaxhighlight>

Desde el cliente, puede montar el volumen con:

<syntaxhighlight lang="bash">
mount -t glusterfs server1:/myvol1 /mnt
</syntaxhighlight>

= Anexo =

* [[RAID con mdadm]]

Contenedores

2025-12-11T18:36:04Z

Pneira: /* Ejercicio 6: python pyramid */

En esta práctica aprenderemos a utilizar [https://es.wikipedia.org/wiki/Podman podman] para desplegar contenedores.

= Paso 1: Instalar podman =

Para instalar el paquete oficial:

<syntaxhighlight lang="bash">
apt install podman
</syntaxhighlight>

podman es un clon de '''docker''.

Si añade un usuario 'test' a su sistema con:

<syntaxhighlight lang="bash">
adduser test
</syntaxhighlight>

recuerde hacer:

<syntaxhighlight lang="bash">
loginctl enable-linger test
systemctl start --user dbus
</syntaxhighlight>

para evitar un warning que se muestra al ejecutar '''podman''' como usuario.

= Paso 2: Repositorio de imágenes de contenedores DockerHub =

Docker ofrece un servicio de nube denominado ''DockerHub'' que puede ser empleado como red social para compartir tus imágenes de Podman. En ''DockerHub'' existen además imágenes de contenedores preconfiguradas de software, muchas de ellas oficiales (ofrecidas por el propio fabricante del software) que se podrán emplear como base para construir nuevas imágenes adaptadas a nuestras necesidades.

Podremos realizar búsquedas en este repositorio ''DockerHub'' puedes emplear el siguiente comando:

<syntaxhighlight lang="bash">
podman search docker.io/library/hello-world
</syntaxhighlight>

Para descargarnos la imagen de ''hello-world'' podemos usar la orden ''pull'':

<syntaxhighlight lang="bash">
podman pull docker.io/library/hello-world
</syntaxhighlight>

También podemos publicar imágenes propias, esto require '''registro de usuario''' en la nube de ''DockerHub'', lo que '''no''' es obligatorio para la realización de esta práctica. Para subir una imagen, hay que validarse como usuario en la nube de ''DockerHub'':

<syntaxhighlight lang="bash">
podman login
</syntaxhighlight>

Tras introducir tu usuario y contraseña, puedes comenzar a publicar tus propias imágenes.

<syntaxhighlight lang="bash">
podman push MI_IMAGEN
</syntaxhighlight>

Este paso es '''opcional''', sólo en caso de que se quieran subir imágenes de contenedores a la nube de docker.io.

= Paso 4: Comprobar imágenes en nuestra máquina =

Para ver las imágenes que tenemos en nuestra máquina, utilizaremos el comando:

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Inicialmente, no tenemos imágenes en almacenamiento, podemos descargarnos la imagen oficial de Debian 13 (Trixie):

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian
</syntaxhighlight>

Ahora si, ya debería de aparecernos la imagen ''debian''.

Comentar también que cada imagen puede tener varias etiquetas, por ejemplo, la imagen Debian 12 (Bookworm), cuando la hemos visto en el listado de imágenes, venía con el tag latest, que es el tag que se descarga por defecto, pero nosotros podemos especificar otro, por ejemplo:

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian:bookworm
</syntaxhighlight>

Para traernos la versión de la imagen de Debian 12 ''Bookworm''.

Ahora tendremos dos imágenes con diferente etiqueta, que serían como las diferentes versiones de cada imagen.

= Paso 5: Lanzar un contenedor =

Un contenedor no es más que una imagen de podman ejecutándose, sería similar a
una máquina virtual, aunque mucho más liviano.

Para crear un contenedor, utilizaremos una imagen, en este caso, la imagen
hello-world. Hacemos lo siguiente:

<syntaxhighlight lang="bash">
podman run hello-world
</syntaxhighlight>

Esto nos mostrará el siguiente mensaje si todo está correcto:

<syntaxhighlight lang="bash">
Hello from Docker!
This message shows that your installation appears to be working correctly.

To generate this message, Docker took the following steps:
1. The Docker client contacted the Docker daemon.
2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
(amd64)
3. The Docker daemon created a new container from that image which runs the
executable that produces the output you are currently reading.
4. The Docker daemon streamed that output to the Docker client, which sent it
to your terminal.

To try something more ambitious, you can run an Debian container with:
$ podman run -it debian bash

Share images, automate workflows, and more with a free Docker ID:
https://hub.docker.com/

For more examples and ideas, visit:
https://docs.docker.com/get-started/
</syntaxhighlight>

Al crear los contenedores utilizando el comando 'run', tenemos varias opciones:

* Lanzar una terminal en el contenedor en modo interactivo
* Lanzar en segundo plano y conectarnos posteriormente al contenedor

== Paso 5.1: Lanzar una terminal en el contenedor en modo interactivo (-ti) ==

Para este ejemplo vamos a utilizar otra imagen diferente, en este caso vamos a utilizar una imagen de debian.

Vamos a lanzar un contenedor y ejecutar una terminal en el que se va a ejecutar el programa '''bash''' que me ofrece un interprete de órdenes:

<syntaxhighlight lang="bash">
podman run -ti debian bash
</syntaxhighlight>

La opción ''-t'' indica que se crea un terminal en el contenedor. Y la opción ''-i'' indica que el contenedor se ejecuta en modo interactivo.

Al acceder al contenedor de ''debian'' nos aparece un ''hash'' en el prompt de la shell, que identifica a la instancia del contenedor (es valor es similar al que muestra la orden ''podman container ls'').

Para salir del contenedor, escribimos 'exit' o pulsamos ''CTRL + D''

== Paso 5.2 Lanzar en segundo plano (-d) ==

Otro ejemplo, con la imagen de Debian:

<syntaxhighlight lang="bash">
podman run -dti debian
</syntaxhighlight>

que muestra un hash que identifica de forma única el contenedor lanzado:

<syntaxhighlight lang="bash">
2ec1daae4676a4e84dc04fd91399c1dfe92119544ff12ee307991fe573d3db64
</syntaxhighlight>

Mediante el comando ''attach'' puedo entrar al contenedor:

<syntaxhighlight lang="bash">
podman attach 2ec1daae4676
</syntaxhighlight>

Para salir, pulsamos ''CTRL + P'' seguido de ''CTRL + Q''.

De manera similar, puedo lanzar en segundo plano la imagen de contenedor de ''hello-world'':

<syntaxhighlight lang="bash">
podman run -d hello-world
</syntaxhighlight>

Y consultar los logs:

<syntaxhighlight lang="bash">
podman logs b67fae3312bc321
</syntaxhighlight>

== Paso 5.3: Añadir variables de entorno a un contenedor ==

Utilizaremos la imagen anterior, y vamos a añadir una variable de entorno
llamada TEST que contenga el valor 'test'. A parte, también ejecutaremos la
terminal como antes, para comprobar con el comando echo, que la variable de
entorno está creada correctamente:

<syntaxhighlight lang="bash">
podman run -ti -e TEST=test debian bash
</syntaxhighlight>

Ahora, desde el contenedor podemos comprobar el valor de la variable de entorno ''$TEST''.

<syntaxhighlight lang="bash">
echo $TEST
test
</syntaxhighlight>

= Paso 6: Listar contenedores en ejecución =

Hemos estado haciendo pruebas y ejecutando contenedores en el paso anterior, vamos a ver donde se encuentran estos contenedores que hemos ejecutado, y después veremos algunas opciones más del comando run.

Tenemos dos opciones para ver los contenedores:

<syntaxhighlight lang="bash">
podman container ls -a
</syntaxhighlight>

o la versión corta:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Ambas hacen lo mismo, y debería de mostrarnos una salida similar a la siguiente:

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
e2bde5f5500c debian "bash" 6 minutes ago Exited (0) 2 seconds ago pensive_sammet
544ad27dbc3c debian "bash" 7 minutes ago Exited (0) 7 minutes ago serene_elgamal
</syntaxhighlight>

En la información veremos que el contenedor tiene el estado exited, eso quiere decir que no se está ejecutando y ya ha finalizado. Vamos a hacer una prueba para ver un contendor ejecutándose:

<syntaxhighlight lang="bash">
podman run -d debian sleep 30
</syntaxhighlight>

Con el comando sleep 30 esperamos 30 segundos hasta que termine el comando, asíque durante esos 30 segundos, el contenedor estará ejecutándose, veámoslo:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
eacceb27d52d debian "sleep 30" 12 seconds ago Up 11 seconds sharp_pasteur
</syntaxhighlight>

Vamos a ver alguna opciones más de la orden ''run''.

== Paso 6.1: Dar un nombre al contenedor (--name) ==

Por defecto, podman creará automáticamente un nombre como hemos visto en las salidas del comando ''podman ps -a''. Podemos establecer el nombre del contenedor que queramos con la opción ''--name'':

<syntaxhighlight lang="bash">
podman run -ti --name mi_debian debian
</syntaxhighlight>

== Paso 6.2: Eliminar contenedor cuando termine (--rm) ==

Vamos a mezclar todo lo visto anteriormente:

* Lanzar en segundo plano (-d)
* Ejecutar contenedor durante 30 segundos (sleep 30)
* Dar un nombre a la imagen (--name)
* Eliminar contenedor cuando termine (--rm)

<syntaxhighlight lang="bash">
podman run -d --rm --name bye-bye debian sleep 30
</syntaxhighlight>

Antes y una vez pasados los 30 segundos, podemos comprobar que el contenedor ha desaparecido.

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

= Paso 7: Parar y eliminar contenedores =

Para parar contenedores podemos usar el ID o su nombre:

<syntaxhighlight lang="bash">
podman stop my_container
podman stop e4901956f108
podman ps -a
</syntaxhighlight>

Una vez hemos comprobado que han terminado su ejecución, podemos eliminar los ficheros resultantes de su ejecución:

<syntaxhighlight lang="bash">
podman container rm my_container
</syntaxhighlight>

Para borrar todos los contenedores ya finalizados

<syntaxhighlight lang="bash">
podman container prune
</syntaxhighlight>

= Paso 8: Conectarnos a un contenedor que se está ejecutando en segundo plano =

Vamos a ejecutar de nuevo un contenedor que no termine:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a conectarnos a este contenedor que está ejecutándose en segundo
plano:

<syntaxhighlight lang="bash">
podman attach mi-contenedor
</syntaxhighlight>

Veremos la orden bash ejecutándose, para terminar, hacemos un 'CTRL + C', y ahora, veremos que ha pasado con el contenedor:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Lo veremos parado, por que lo que hemos hecho ha sido conectarnos al contenedor
y parar el comando que se estaba ejecutando, así que ahora tenemos el contenedor
finalizado.

''Nota:'' Para salir del contenedor '''sin detenerlo''' hacemos 'CTRL + P' seguido 'CTRL + Q'

= Paso 9: Ejecutar un comando dentro de un contenedor en ejecución =

Vamos a ver otresta vez como ejecutar un comando en un contenedor que ya está
ejecutándose:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a ejecutar un comando en ese contenedor con el nombre ''mi-contenedor''.
El comando exec es similar al comando run, pero para ejecutar un comando dentro de un contenedor:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor ls
</syntaxhighlight>

Para redirigir la salida a un fichero en el anfitrión:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor ls > x.txt
</syntaxhighlight>

Para redirigir la salida a un fichero ''dentro'' del contenedor, hacemos:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor sh -c "ls > x.txt"
</syntaxhighlight>

También es posible ejecutar comandos con tuberías:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor sh -c "ls -la | grep ^d"
</syntaxhighlight>

= Paso 10: Persistencia en contenedores =

Al hacer ''exit'' y salir de un contenedor, se pierden todos los cambios que hemos realizado. Los

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-ejemplo debian bash
</syntaxhighlight>

Ahora, vamos a crear una carpeta en el contenedor y comprobar que esa carpeta existe:

<syntaxhighlight lang="bash">
podman exec mi-ejemplo mkdir test
podman exec mi-ejemplo ls
</syntaxhighlight>

Veremos que la carpeta existe, pero, ¿qué ocurre si para el contenedor?

<syntaxhighlight lang="bash">
podman container stop mi-ejemplo
</syntaxhighlight>

Y volvemos a lanzarlo:

<syntaxhighlight lang="bash">
podman container rm mi-ejemplo
podman run -d -ti --name mi-ejemplo debian bash
podman exec mi-ejemplo ls
</syntaxhighlight>

Podemos comprobar que la carpeta creada anteriormente, no existe.

¿Qué podemos hacer para mantener la modificaciones realizadas sobre un contenedor?

== Paso 10.1: Crear una imagen derivada de la imagen base ==

Es posible crear una imagen derivada, con modificaciones, a partir de una imagen existente mediante la orden '''commit'''.

Por ejemplo, si queremos una imagen ''debian'' que incluya el programa ''ping'' ya instalado, tendríamos que lanzar un contenedor a partir de la imagen ''ubuntu'':

<syntaxhighlight lang="bash">
podman run -d -ti debian bash
</syntaxhighlight>

Suponiendo que el contenido está identificado con el ID 56ef5b312334

Instalamos el paquete ping:

<syntaxhighlight lang="bash">
podman exec 56ef5b312334 apt -y install ping
</syntaxhighlight>

Generamos la imagen derivada con el nombre ''ubuntu-con-ping'':

<syntaxhighlight lang="bash">
podman commit 56ef5b312334 ubuntu-con-ping
</syntaxhighlight>

Ya podemos para nuestro contendor:

<syntaxhighlight lang="bash">
podman stop 56ef5b312334
</syntaxhighlight>

Y lanzar un nuevo contenedor a partir de la imagen ''debian-con-ping'':

<syntaxhighlight lang="bash">
podman run -d -ti debian-con-ping bash
</syntaxhighlight>

== Paso 10.2: Mantener la persistencia mediante volúmen ==

Otra opción para mantener los datos es montar un volumen al ejecutar el contenedor.

Primero crearemos una carpeta que hará de volumen en nuestra máquina, que será la que luego montemos para podman:

<syntaxhighlight lang="bash">
mkdir /home/debian/volumen
</syntaxhighlight>

Ahora vamos a montar la carpeta al ejecutar el contenedor, lo hacemos con la
opción -v, la cual tiene 3 campos separados por ':':

# El volumen en nuestra máquina
# Donde se montará el volumen dentro del contenedor
# Opciones de mmontaje, por ejemplo rw (read and write) o ro (read only)

<syntaxhighlight lang="bash">
podman run --rm -ti -v /home/debian/volumen:/volumen:rw debian bash
mkdir /volumen/test
touch /volumen/test/file
exit
</syntaxhighlight>

Una vez nos salgamos del contenedor, podemos ver que en nuestra máquina están
los datos:

<syntaxhighlight lang="bash">
ls /home/ubuntu/volumen/
ls /home/ubuntu/volumen/test
</syntaxhighlight>

La próxima vez que ejecutemos un contenedor, si montamos ese volumen, los datos
estarán ahí, además esta forma tiene el beneficio de compartir datos entre
nuestra máquina y el contenedor de forma sencilla.

= Paso 11: Crear nuestra propia imagen de contenedor =

Para crear una imagen de un contenedor con una aplicación de Python hug, creamos en primer lugar la carpeta que contendrá los ficheros que nos permiten crear la imagen.

<syntaxhighlight lang="bash">
mkdir miapp
cd miapp
</syntaxhighlight>

Definimos un fichero ''Dockerfile'' para definir la imagen:

<syntaxhighlight lang="bash">
FROM ubuntu

RUN apt -y update
RUN apt -y upgrade
RUN apt -y install python3-hug
RUN mkdir /app
COPY endpoint.py /app
WORKDIR /app
CMD hug -f endpoint.py
</syntaxhighlight>

Alternativamente, puedes crear un [[Creando imagen propia usando Ubuntu de base|Dockerfile empleando la imagen de Ubuntu]] como base en lugar de Alpine.

Y añadimos el fichero ''endpoint.py'' que emplea el framework Python hug con el contenido siguiente:

<syntaxhighlight lang="bash">
import hug

@hug.get('/welcome')
def welcome(username="unknown"):
""" Say welcome to username """
return "Welcome " + username
</syntaxhighlight>

Este fichero es un ejemplo de uso de Python hug. Si hacemos una petición a /welcome?username="LSO", esto nos devolverá el mensaje "Welcome LSO".

Una vez tengamos los dos ficheros creados en nuestra máquina virtual, podemos construir nuestra imagen:

<syntaxhighlight lang="bash">
podman build -t app:v1 -f Dockerfile .
</syntaxhighlight>

Vamos a explicar para que sirve cada línea:

* FROM: servirá para basarnos en una imagen existente, en este caso, una imagen de python alpine, que contiene python y no ocupa mucho espacio
* ENV: para crear variables de entorno
* RUN: para ejecutar comandos, ya sea para crear una carpeta, instalar dependencias o cualquier otra opción que necesitemos
* COPY: para copiar datos desde nuestra máquina a la imagen
* WORKDIR: para cambiar el directorio de trabajo
* CMD: este comando será ejecutado por defecto al iniciar un contenedor a partir de esta imagen

Esto construirá una imagen podman basada en python:alpine, en la cual hemos
guardado nuestra pequeña aplicación y se va a ejecutar cuando ejecutemos un
contenedor basado en esa imagen. Para comprobar que la imagen se ha creado
correctamente, listamos las imagenes, y debería de aparecernos una imagen con
nombre 'app' y tag 'v1':

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen, y vamos a añadir una nueva
opción, -p 8001:8000. Esta opción hará que el puerto interno 8000 del contenedor
sea expuesto en el puerto 8001 de nuestra máquina:

<syntaxhighlight lang="bash">
podman run --name my-app --rm -d -p 8001:8000 app:v1
</syntaxhighlight>

''Nota:'' podman supone que la redirección de puerto es TCP, para una redirección de puertos UDP, puedes usar:

<syntaxhighlight lang="bash">
... -p 8001:8000/udp
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código. En nuestra
máquina haremos:

<syntaxhighlight lang="bash">
curl -X GET http://localhost:8001/welcome?username=LSO
</syntaxhighlight>

Comprobaremos que la salida del comando curl, es "Welcome LSO".

Antes de terminar, vamos a comprobar otro pequeño detalle que añadimos en
nuestra imagen, la variable de entorno USERNAME, vamos a comprobar que funciona:

<syntaxhighlight lang="bash">
podman exec -ti my-app ash
echo $USERNAME
</syntaxhighlight>

Funciona correctamente, pero al ejecutar el contenedor, podemos cambiar esta
variable de entorno como vimos en uno de los pasos anteriores:

<syntaxhighlight lang="bash">
podman run --rm -ti -e USERNAME=me app:v1 ash
echo $USERNAME
</syntaxhighlight>

Esto nos servirá para tener opciones por defecto y que el usuario pueda
cambiarlo a su antojo, como por ejemplo contraseñas u otros detalles.

= Paso 12: Eliminar imágenes =

Para borrar una imagen, puede hacer:

<syntaxhighlight lang="bash">
podman image rm hello-world
</syntaxhighlight>

= Paso 13: Varios podman a la vez (podman-compose) =

Antes de comenzar, vamos a parar todos los contenedores que tengamos abiertos,
para dejar el entorno de podman limpio, que nos vendrá bien para esta parte.

Cuando queremos ejecutar varios contenedores a la vez y que estén conectados
entre ellos fácilmente, utilizaremos podman-compose, donde con un fichero de
configuración simple en yaml, tendremos toda la configuración de lo que vamos a
ejecutar.

Primero vamos a instalar podman-compose:

<syntaxhighlight lang="bash">
sudo apt install podman-compose
</syntaxhighlight>

Ahora veamos un pequeño ejemplo donde explicaremos todos los detalles para crear
un podman-compose, en este caso, el nombre por defecto de los ficheros suele ser
podman-compose.yml, y el contenido será similar a:

<syntaxhighlight lang="bash">
version: '3'

services:
web:
container_name: web
restart: always
build:
context: .
ports:
- "8000:8000"
volumes:
- /home/ubuntu/volume:/volumen:rw
environment:
USERNAME: test
web2:
container_name: web2
build:
dockerfile: Dockerfile
context: .
depends_on:
- web
command: touch web2
web3:
container_name: web3
restart: on-failure
image: pstauffer/curl
depends_on:
- web
command: curl -X GET web:8000/welcome?username=web3
</syntaxhighlight>

En el podman-compose definimos diferentes servicios a ejecutar, en nuestro caso
hemos iniciado tres servicios diferentes, web, web2 y web3:

El primer servicio, web:

* container_name: para darle un nombre por defecto al contenedor cuando se cree
* restart: pueden ser:
** "no": si la máquina termina, no se vuelve a iniciar (opción por defecto)
** always: siempre que el contenedor termine, intenta iniciarse de nuevo
** on-failure: solo intenta reiniciarse si el contenedor termina con fallo
** unless-stopped: solo reinicia el contenedor si el usuario es el que lo termina
* Utilizará el fichero Dockerfile creado en el paso 11 para generar la imagen a usar.
* Expondrá el puerto 8000 del contenedor en el 8000 de nuestra máquina
* Montará un volumen, se hace de forma similar a la línea de comandos
* Creará una variable de entorno

El segundo servicio, web2:

* Utilizará el fichero Dockerfile también, la diferencia entre este y el primer servicio, es que si el nombre del Dockerfile cambia, tendremos que hacerlo de esta segunda forma, la primera por defecto solo buscará el fichero Dockerfile
* depends_on hará que para ejecutar este servicio, su dependencia tenga ya que estar iniciada
* Ejecutaremos un comando el cual sustituirá al comando de la imagen

El tercer servicio, web3:

* Utilizará la imagen ostauffer/curl que es un imagen mínima que contiene el comando curl
* restart: en este caso, hasta que el comando no se ejecute correctamente, se seguirá reiniciando el contenedor
* depends_on igual que el servicio 2, dependerá del servicio 1
* Ejecutaremos un comando para llamar desde el servicio 3 al servicio 1

== Paso 13.1: Construir podman-compose ==

En el caso de existir servicios que tengan Dockerfiles, esto hará que se construyan previamente, como hacer un podman build de cada uno de los servicios que contenga un Dockerfile:

<syntaxhighlight lang="bash">
podman-compose build
</syntaxhighlight>

Con esto se generarán las imágenes necesarias para ejecutar todos los servicios.

== Paso 13.2: Iniciar podman-compose ==

Para iniciar todos los servicios, ejecutaremos:

<syntaxhighlight lang="bash">
podman-compose up -d
</syntaxhighlight>

Después de esto podremos ver el logs de todos los servicios:

<syntaxhighlight lang="bash">
podman-compose logs -f
</syntaxhighlight>

Aquí veremos que el servicio 3 ha conseguido llamar correctamente al servicio 1.

Ahora veremos como podman-compose ha creado los contenedores:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

La salida será similar a la siguiente:

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
219a4118244c pstauffer/curl "curl -X GET web:800…" 6 seconds ago Exited (0) 3 seconds ago web3
c97e894cb3ae ubuntu_web2 "touch web2" 6 seconds ago Exited (0) 4 seconds ago web2
f35d034204fc ubuntu_web "/bin/sh -c 'hug -f …" 6 seconds ago Up 5 seconds 0.0.0.0:8000->8000/tcp web
</syntaxhighlight>

Aquí vemos varios detalles:

* El nombre que le hemos dado en el podman-compose ha funcionado correctamente
* Vemos que los comandos son los correctos también
* web2 está parado por que la política de reinicio es apagar cuando se termine de ejecutar un comando
* web 3 está parado por que el comando ha terminado con un salida correcta

Vamos a comprobar ahora que en el servicio web está todo correcto:

<syntaxhighlight lang="bash">
podman exec -ti web ash
echo $USERNAME
ls /volumen
exit
</syntaxhighlight>

Podemos comprobar que tanto cambiar la variable de entorno como crear un
volumen ha funcionado correctamente.

== Paso 13.3: Parar podman-compose ==

Para parar todos los servicios:

<syntaxhighlight lang="bash">
podman-compose down
</syntaxhighlight>

Comprobamos:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Vemos que han desaparecido todos los contenedores.

= Paso 14: Ejercicios =

== Ejercicio 1: Image derivada de Debian con el programa sl ==

Lance un contenedor a partir de una imagen de Debian, instale el programa sl, ejecute sl (desde fuera del contenedor) y detenga el contenedor.

== Ejercicio 2 ==

== Ejercicio 3: Variante de httpd ==

Construya una imagen ''httpd-hola-mundo'' a partir de la imagen ''httpd''. El fichero de index.html de la carpeta htdocs/ tiene que mostrar el mensaje "hola mundo".

<syntaxhighlight lang="bash">
podman pull httpd
</syntaxhighlight>

Edita el fichero Dockerfile:

<syntaxhighlight lang="bash">
nano Dockerfile
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
FROM httpd

COPY index.html htdocs/index.html
</syntaxhighlight>

Edita el fichero index.html:

<syntaxhighlight lang="bash">
nano index.html
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

Construye la imagen:

<syntaxhighlight lang="bash">
podman build -t mihttpd -f Dockerfile .
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen:

<syntaxhighlight lang="bash">
podman run --name mihttpd -d -p 8080:80 mihttpd
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código:
<syntaxhighlight lang="bash">
curl -X GET http://localhost:8080
</syntaxhighlight>

Tiene que salir por pantalla esto:
<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

== Ejercicio 4: aplicación flask ==

Flask es un framework python para implementar webs. Cree una imagen "miapp-flask" a partir de la imagen de "python":

* Instale flask mediante: pip install flask
* Cree la carpeta "app"
* Establezca la variable FLASK_APP a "hello.py"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"

El fichero hello.py contiene un "hola mundo" para Flask:

<syntaxhighlight lang="python">
from flask import Flask
app = Flask(__name__)

@app.route("/")
def hello():
return "Hello World!"

if __name__ == "__main__":
app.run()
</syntaxhighlight>

Solución con alpine:

<syntaxhighlight lang="bash">
FROM python:alpine

RUN mkdir /app
RUN pip install flask
ENV FLASK_APP="app/hello.py"
COPY hello.py
WORKDIR /
CMD flask run --host=0.0.0.0
</syntaxhighlight>

Solución con Ubuntu:

<syntaxhighlight lang="bash">
FROM ubuntu:bionic

RUN apt-get update
RUN apt-get -y install python python-pip wget
RUN pip install Flask
ENV FLASK_APP="app/hello.py"
RUN mkdir /app
COPY hello.py /app
CMD flask run --host=0.0.0.0
</syntaxhighlight>

== Ejercicio 5: mysql ==

'''EN LA MÁQUINA VIRTUAL:'''

mkdir miapp
cd miapp
podman pull mysql
nano Dockerfile

<syntaxhighlight lang="bash">
FROM mysql
ENV MYSQL_ROOT_PASSWORD="lacontraseñaqueyoquiera"
RUN mkdir /app
WORKDIR /app

</syntaxhighlight>

CTRL+O , ENTER Y CTRL+X (para guardar Dockerfile y salir)

podman build -ti mrfdocker -f Dockerfile .
podman run --name mymrf --rm -p 8001:3306 mrfdocker
docker images

'''EN LA TERMINAL DEL HOST:'''

''Instalación de mysql:''

apt install mysql-client-core-5.7
apt-get install mysql-server
service mysql start

''Para entrar:''

mysql -u root -p -P 8001

Una vez dentro de msql:

mysql> show databases;

''Para salir:''

exit

== Ejercicio 6: python pyramid ==

Pyramid es un framework python para implementar webs. Cree una imagen "miapp-pyramid":

* Emplee la imagen de debian como referencia, instale los paquetes python3 y python3-pyramid.
* Cree la carpeta "app"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"
* La aplicación se lanza con la orden: python hello.py
* Compruebe que funciona con curl, la ruta a la web es http://127.0.0.1:8000/hello, suponiendo que ha empleado el puerto 8000 para exponer el servicio.

El fichero hello.py contiene un "hola mundo" para Pyramid:

<syntaxhighlight lang="bash">
from wsgiref.simple_server import make_server
from pyramid.config import Configurator
from pyramid.response import Response

def hello_world(request):
print('Request inbound!')
return Response('Podman works with Pyramid!')

if __name__ == '__main__':
config = Configurator()
config.add_route('hello', '/')
config.add_view(hello_world, route_name='hello')
app = config.make_wsgi_app()
server = make_server('0.0.0.0', 6543, app)
server.serve_forever()
</syntaxhighlight>

Este programa recibe peticiones en el puerto 6543.

== Ejercicio 7 ==

Cree una imagen derivada de Ubuntu, instale el paquete apache2, php y libapache2-mod-php.
Active el módulo de php para apache2 mediante la orden:

<syntaxhighlight lang="bash">
a2enmod php
</syntaxhighlight>

Cree la carpeta /var/www/php.

Cree el fichero index.php

<syntaxhighlight lang="php">
<?php
Print "Hello, World!";
?>
</syntaxhighlight>

y copielo a /var/www/php/.

Cree el fichero 000-default.conf y copielo a /etc/apache2/sites-enabled/

Dicho fichero contiene.

<syntaxhighlight lang="bash">
<VirtualHost *:80>
DocumentRoot /var/www/php

<Directory /var/www/php/>
Options Indexes FollowSymLinks MultiViews
AllowOverride All
Order deny,allow
Allow from all
</Directory>

ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>
</syntaxhighlight>

Tiene que lanzar apache con la orden: apachectl -D FOREGROUND

Tras crear la imagen, láncela mapeando el puerto 8888 al 80, pruebe que puede acceder a http://127.0.0.1:8888/php/ mediante curl

Solución:

<syntaxhighlight lang="bash">
FROM ubuntu:latest

RUN apt-get update
RUN apt-get install -y tzdata
RUN apt-get install -y apache2
RUN apt-get install -y php
RUN apt-get install -y libapache2-mod-php
RUN a2enmod php7.2
COPY index.php /var/www/php
COPY 000-default.conf /etc/apache2/sites-enabled/
CMD apachectl -D FOREGROUND
</syntaxhighlight>

Y para lanzarlo:

podman run --name my-app --rm -d -p 8001:8000 app:v1

y para probarlo:

curl -X GET http://127.0.0.1:8888/php/

== Ejercicio 8 ==

Instale el paquete ''netcat-traditional'' en una imagen de contenedor de ''ubuntu''. Lance la orden:

nc -u -l -p 8080

en el contenedor. Asegúrese de crear una redirección de puertos de 9999 desde el ''host'' al puerto 8080 en el contenedor.

Desde fuera del contenedor, pruebe a conectarse con:

nc -u 127.0.0.1 9999

== Ejercicio 9 ==

Cree una imagen derivada de "ubuntu" con un Dockerfile que incluya soporte de python y lance el siguiente código en Python:

<syntaxhighlight lang="python">
from http.server import BaseHTTPRequestHandler, HTTPServer
import time

hostName = "0.0.0.0"
serverPort = 8080

class MyServer(BaseHTTPRequestHandler):
def do_GET(self):
self.send_response(200)
self.send_header("Content-type", "text/html")
self.end_headers()
self.wfile.write(bytes("<html><head><title>Welcome!</title></head>", "utf-8"))
self.wfile.write(bytes("<body>", "utf-8"))
self.wfile.write(bytes("This is an example web server.", "utf-8"))
self.wfile.write(bytes("</body></html>", "utf-8"))

if __name__ == "__main__":
webServer = HTTPServer((hostName, serverPort), MyServer)
print("Server started http://%s:%s" % (hostName, serverPort))

try:
webServer.serve_forever()
except KeyboardInterrupt:
pass

webServer.server_close()
print("Server stopped.")
</syntaxhighlight>

Llame a su imagen "python-http-server". Lance una instancia de la imagen "python-http-server" mapeando el puerto 9999 al puerto 8888/tcp del contenedor. Compruebe con:

<syntaxhighlight lang="bash">
curl http://127.0.0.1:9999/
</syntaxhighlight>

que muestre la página HTML que ofrece el servidor, que debería ser:

<syntaxhighlight lang="bash">
<html><head><title>Welcome!</title></head><body>This is an example web server.</body></html>
</syntaxhighlight>

Contenedores

2025-12-11T18:30:53Z

Pneira: /* Ejercicio 6: python pyramid */

En esta práctica aprenderemos a utilizar [https://es.wikipedia.org/wiki/Podman podman] para desplegar contenedores.

= Paso 1: Instalar podman =

Para instalar el paquete oficial:

<syntaxhighlight lang="bash">
apt install podman
</syntaxhighlight>

podman es un clon de '''docker''.

Si añade un usuario 'test' a su sistema con:

<syntaxhighlight lang="bash">
adduser test
</syntaxhighlight>

recuerde hacer:

<syntaxhighlight lang="bash">
loginctl enable-linger test
systemctl start --user dbus
</syntaxhighlight>

para evitar un warning que se muestra al ejecutar '''podman''' como usuario.

= Paso 2: Repositorio de imágenes de contenedores DockerHub =

Docker ofrece un servicio de nube denominado ''DockerHub'' que puede ser empleado como red social para compartir tus imágenes de Podman. En ''DockerHub'' existen además imágenes de contenedores preconfiguradas de software, muchas de ellas oficiales (ofrecidas por el propio fabricante del software) que se podrán emplear como base para construir nuevas imágenes adaptadas a nuestras necesidades.

Podremos realizar búsquedas en este repositorio ''DockerHub'' puedes emplear el siguiente comando:

<syntaxhighlight lang="bash">
podman search docker.io/library/hello-world
</syntaxhighlight>

Para descargarnos la imagen de ''hello-world'' podemos usar la orden ''pull'':

<syntaxhighlight lang="bash">
podman pull docker.io/library/hello-world
</syntaxhighlight>

También podemos publicar imágenes propias, esto require '''registro de usuario''' en la nube de ''DockerHub'', lo que '''no''' es obligatorio para la realización de esta práctica. Para subir una imagen, hay que validarse como usuario en la nube de ''DockerHub'':

<syntaxhighlight lang="bash">
podman login
</syntaxhighlight>

Tras introducir tu usuario y contraseña, puedes comenzar a publicar tus propias imágenes.

<syntaxhighlight lang="bash">
podman push MI_IMAGEN
</syntaxhighlight>

Este paso es '''opcional''', sólo en caso de que se quieran subir imágenes de contenedores a la nube de docker.io.

= Paso 4: Comprobar imágenes en nuestra máquina =

Para ver las imágenes que tenemos en nuestra máquina, utilizaremos el comando:

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Inicialmente, no tenemos imágenes en almacenamiento, podemos descargarnos la imagen oficial de Debian 13 (Trixie):

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian
</syntaxhighlight>

Ahora si, ya debería de aparecernos la imagen ''debian''.

Comentar también que cada imagen puede tener varias etiquetas, por ejemplo, la imagen Debian 12 (Bookworm), cuando la hemos visto en el listado de imágenes, venía con el tag latest, que es el tag que se descarga por defecto, pero nosotros podemos especificar otro, por ejemplo:

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian:bookworm
</syntaxhighlight>

Para traernos la versión de la imagen de Debian 12 ''Bookworm''.

Ahora tendremos dos imágenes con diferente etiqueta, que serían como las diferentes versiones de cada imagen.

= Paso 5: Lanzar un contenedor =

Un contenedor no es más que una imagen de podman ejecutándose, sería similar a
una máquina virtual, aunque mucho más liviano.

Para crear un contenedor, utilizaremos una imagen, en este caso, la imagen
hello-world. Hacemos lo siguiente:

<syntaxhighlight lang="bash">
podman run hello-world
</syntaxhighlight>

Esto nos mostrará el siguiente mensaje si todo está correcto:

<syntaxhighlight lang="bash">
Hello from Docker!
This message shows that your installation appears to be working correctly.

To generate this message, Docker took the following steps:
1. The Docker client contacted the Docker daemon.
2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
(amd64)
3. The Docker daemon created a new container from that image which runs the
executable that produces the output you are currently reading.
4. The Docker daemon streamed that output to the Docker client, which sent it
to your terminal.

To try something more ambitious, you can run an Debian container with:
$ podman run -it debian bash

Share images, automate workflows, and more with a free Docker ID:
https://hub.docker.com/

For more examples and ideas, visit:
https://docs.docker.com/get-started/
</syntaxhighlight>

Al crear los contenedores utilizando el comando 'run', tenemos varias opciones:

* Lanzar una terminal en el contenedor en modo interactivo
* Lanzar en segundo plano y conectarnos posteriormente al contenedor

== Paso 5.1: Lanzar una terminal en el contenedor en modo interactivo (-ti) ==

Para este ejemplo vamos a utilizar otra imagen diferente, en este caso vamos a utilizar una imagen de debian.

Vamos a lanzar un contenedor y ejecutar una terminal en el que se va a ejecutar el programa '''bash''' que me ofrece un interprete de órdenes:

<syntaxhighlight lang="bash">
podman run -ti debian bash
</syntaxhighlight>

La opción ''-t'' indica que se crea un terminal en el contenedor. Y la opción ''-i'' indica que el contenedor se ejecuta en modo interactivo.

Al acceder al contenedor de ''debian'' nos aparece un ''hash'' en el prompt de la shell, que identifica a la instancia del contenedor (es valor es similar al que muestra la orden ''podman container ls'').

Para salir del contenedor, escribimos 'exit' o pulsamos ''CTRL + D''

== Paso 5.2 Lanzar en segundo plano (-d) ==

Otro ejemplo, con la imagen de Debian:

<syntaxhighlight lang="bash">
podman run -dti debian
</syntaxhighlight>

que muestra un hash que identifica de forma única el contenedor lanzado:

<syntaxhighlight lang="bash">
2ec1daae4676a4e84dc04fd91399c1dfe92119544ff12ee307991fe573d3db64
</syntaxhighlight>

Mediante el comando ''attach'' puedo entrar al contenedor:

<syntaxhighlight lang="bash">
podman attach 2ec1daae4676
</syntaxhighlight>

Para salir, pulsamos ''CTRL + P'' seguido de ''CTRL + Q''.

De manera similar, puedo lanzar en segundo plano la imagen de contenedor de ''hello-world'':

<syntaxhighlight lang="bash">
podman run -d hello-world
</syntaxhighlight>

Y consultar los logs:

<syntaxhighlight lang="bash">
podman logs b67fae3312bc321
</syntaxhighlight>

== Paso 5.3: Añadir variables de entorno a un contenedor ==

Utilizaremos la imagen anterior, y vamos a añadir una variable de entorno
llamada TEST que contenga el valor 'test'. A parte, también ejecutaremos la
terminal como antes, para comprobar con el comando echo, que la variable de
entorno está creada correctamente:

<syntaxhighlight lang="bash">
podman run -ti -e TEST=test debian bash
</syntaxhighlight>

Ahora, desde el contenedor podemos comprobar el valor de la variable de entorno ''$TEST''.

<syntaxhighlight lang="bash">
echo $TEST
test
</syntaxhighlight>

= Paso 6: Listar contenedores en ejecución =

Hemos estado haciendo pruebas y ejecutando contenedores en el paso anterior, vamos a ver donde se encuentran estos contenedores que hemos ejecutado, y después veremos algunas opciones más del comando run.

Tenemos dos opciones para ver los contenedores:

<syntaxhighlight lang="bash">
podman container ls -a
</syntaxhighlight>

o la versión corta:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Ambas hacen lo mismo, y debería de mostrarnos una salida similar a la siguiente:

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
e2bde5f5500c debian "bash" 6 minutes ago Exited (0) 2 seconds ago pensive_sammet
544ad27dbc3c debian "bash" 7 minutes ago Exited (0) 7 minutes ago serene_elgamal
</syntaxhighlight>

En la información veremos que el contenedor tiene el estado exited, eso quiere decir que no se está ejecutando y ya ha finalizado. Vamos a hacer una prueba para ver un contendor ejecutándose:

<syntaxhighlight lang="bash">
podman run -d debian sleep 30
</syntaxhighlight>

Con el comando sleep 30 esperamos 30 segundos hasta que termine el comando, asíque durante esos 30 segundos, el contenedor estará ejecutándose, veámoslo:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
eacceb27d52d debian "sleep 30" 12 seconds ago Up 11 seconds sharp_pasteur
</syntaxhighlight>

Vamos a ver alguna opciones más de la orden ''run''.

== Paso 6.1: Dar un nombre al contenedor (--name) ==

Por defecto, podman creará automáticamente un nombre como hemos visto en las salidas del comando ''podman ps -a''. Podemos establecer el nombre del contenedor que queramos con la opción ''--name'':

<syntaxhighlight lang="bash">
podman run -ti --name mi_debian debian
</syntaxhighlight>

== Paso 6.2: Eliminar contenedor cuando termine (--rm) ==

Vamos a mezclar todo lo visto anteriormente:

* Lanzar en segundo plano (-d)
* Ejecutar contenedor durante 30 segundos (sleep 30)
* Dar un nombre a la imagen (--name)
* Eliminar contenedor cuando termine (--rm)

<syntaxhighlight lang="bash">
podman run -d --rm --name bye-bye debian sleep 30
</syntaxhighlight>

Antes y una vez pasados los 30 segundos, podemos comprobar que el contenedor ha desaparecido.

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

= Paso 7: Parar y eliminar contenedores =

Para parar contenedores podemos usar el ID o su nombre:

<syntaxhighlight lang="bash">
podman stop my_container
podman stop e4901956f108
podman ps -a
</syntaxhighlight>

Una vez hemos comprobado que han terminado su ejecución, podemos eliminar los ficheros resultantes de su ejecución:

<syntaxhighlight lang="bash">
podman container rm my_container
</syntaxhighlight>

Para borrar todos los contenedores ya finalizados

<syntaxhighlight lang="bash">
podman container prune
</syntaxhighlight>

= Paso 8: Conectarnos a un contenedor que se está ejecutando en segundo plano =

Vamos a ejecutar de nuevo un contenedor que no termine:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a conectarnos a este contenedor que está ejecutándose en segundo
plano:

<syntaxhighlight lang="bash">
podman attach mi-contenedor
</syntaxhighlight>

Veremos la orden bash ejecutándose, para terminar, hacemos un 'CTRL + C', y ahora, veremos que ha pasado con el contenedor:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Lo veremos parado, por que lo que hemos hecho ha sido conectarnos al contenedor
y parar el comando que se estaba ejecutando, así que ahora tenemos el contenedor
finalizado.

''Nota:'' Para salir del contenedor '''sin detenerlo''' hacemos 'CTRL + P' seguido 'CTRL + Q'

= Paso 9: Ejecutar un comando dentro de un contenedor en ejecución =

Vamos a ver otresta vez como ejecutar un comando en un contenedor que ya está
ejecutándose:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a ejecutar un comando en ese contenedor con el nombre ''mi-contenedor''.
El comando exec es similar al comando run, pero para ejecutar un comando dentro de un contenedor:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor ls
</syntaxhighlight>

Para redirigir la salida a un fichero en el anfitrión:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor ls > x.txt
</syntaxhighlight>

Para redirigir la salida a un fichero ''dentro'' del contenedor, hacemos:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor sh -c "ls > x.txt"
</syntaxhighlight>

También es posible ejecutar comandos con tuberías:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor sh -c "ls -la | grep ^d"
</syntaxhighlight>

= Paso 10: Persistencia en contenedores =

Al hacer ''exit'' y salir de un contenedor, se pierden todos los cambios que hemos realizado. Los

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-ejemplo debian bash
</syntaxhighlight>

Ahora, vamos a crear una carpeta en el contenedor y comprobar que esa carpeta existe:

<syntaxhighlight lang="bash">
podman exec mi-ejemplo mkdir test
podman exec mi-ejemplo ls
</syntaxhighlight>

Veremos que la carpeta existe, pero, ¿qué ocurre si para el contenedor?

<syntaxhighlight lang="bash">
podman container stop mi-ejemplo
</syntaxhighlight>

Y volvemos a lanzarlo:

<syntaxhighlight lang="bash">
podman container rm mi-ejemplo
podman run -d -ti --name mi-ejemplo debian bash
podman exec mi-ejemplo ls
</syntaxhighlight>

Podemos comprobar que la carpeta creada anteriormente, no existe.

¿Qué podemos hacer para mantener la modificaciones realizadas sobre un contenedor?

== Paso 10.1: Crear una imagen derivada de la imagen base ==

Es posible crear una imagen derivada, con modificaciones, a partir de una imagen existente mediante la orden '''commit'''.

Por ejemplo, si queremos una imagen ''debian'' que incluya el programa ''ping'' ya instalado, tendríamos que lanzar un contenedor a partir de la imagen ''ubuntu'':

<syntaxhighlight lang="bash">
podman run -d -ti debian bash
</syntaxhighlight>

Suponiendo que el contenido está identificado con el ID 56ef5b312334

Instalamos el paquete ping:

<syntaxhighlight lang="bash">
podman exec 56ef5b312334 apt -y install ping
</syntaxhighlight>

Generamos la imagen derivada con el nombre ''ubuntu-con-ping'':

<syntaxhighlight lang="bash">
podman commit 56ef5b312334 ubuntu-con-ping
</syntaxhighlight>

Ya podemos para nuestro contendor:

<syntaxhighlight lang="bash">
podman stop 56ef5b312334
</syntaxhighlight>

Y lanzar un nuevo contenedor a partir de la imagen ''debian-con-ping'':

<syntaxhighlight lang="bash">
podman run -d -ti debian-con-ping bash
</syntaxhighlight>

== Paso 10.2: Mantener la persistencia mediante volúmen ==

Otra opción para mantener los datos es montar un volumen al ejecutar el contenedor.

Primero crearemos una carpeta que hará de volumen en nuestra máquina, que será la que luego montemos para podman:

<syntaxhighlight lang="bash">
mkdir /home/debian/volumen
</syntaxhighlight>

Ahora vamos a montar la carpeta al ejecutar el contenedor, lo hacemos con la
opción -v, la cual tiene 3 campos separados por ':':

# El volumen en nuestra máquina
# Donde se montará el volumen dentro del contenedor
# Opciones de mmontaje, por ejemplo rw (read and write) o ro (read only)

<syntaxhighlight lang="bash">
podman run --rm -ti -v /home/debian/volumen:/volumen:rw debian bash
mkdir /volumen/test
touch /volumen/test/file
exit
</syntaxhighlight>

Una vez nos salgamos del contenedor, podemos ver que en nuestra máquina están
los datos:

<syntaxhighlight lang="bash">
ls /home/ubuntu/volumen/
ls /home/ubuntu/volumen/test
</syntaxhighlight>

La próxima vez que ejecutemos un contenedor, si montamos ese volumen, los datos
estarán ahí, además esta forma tiene el beneficio de compartir datos entre
nuestra máquina y el contenedor de forma sencilla.

= Paso 11: Crear nuestra propia imagen de contenedor =

Para crear una imagen de un contenedor con una aplicación de Python hug, creamos en primer lugar la carpeta que contendrá los ficheros que nos permiten crear la imagen.

<syntaxhighlight lang="bash">
mkdir miapp
cd miapp
</syntaxhighlight>

Definimos un fichero ''Dockerfile'' para definir la imagen:

<syntaxhighlight lang="bash">
FROM ubuntu

RUN apt -y update
RUN apt -y upgrade
RUN apt -y install python3-hug
RUN mkdir /app
COPY endpoint.py /app
WORKDIR /app
CMD hug -f endpoint.py
</syntaxhighlight>

Alternativamente, puedes crear un [[Creando imagen propia usando Ubuntu de base|Dockerfile empleando la imagen de Ubuntu]] como base en lugar de Alpine.

Y añadimos el fichero ''endpoint.py'' que emplea el framework Python hug con el contenido siguiente:

<syntaxhighlight lang="bash">
import hug

@hug.get('/welcome')
def welcome(username="unknown"):
""" Say welcome to username """
return "Welcome " + username
</syntaxhighlight>

Este fichero es un ejemplo de uso de Python hug. Si hacemos una petición a /welcome?username="LSO", esto nos devolverá el mensaje "Welcome LSO".

Una vez tengamos los dos ficheros creados en nuestra máquina virtual, podemos construir nuestra imagen:

<syntaxhighlight lang="bash">
podman build -t app:v1 -f Dockerfile .
</syntaxhighlight>

Vamos a explicar para que sirve cada línea:

* FROM: servirá para basarnos en una imagen existente, en este caso, una imagen de python alpine, que contiene python y no ocupa mucho espacio
* ENV: para crear variables de entorno
* RUN: para ejecutar comandos, ya sea para crear una carpeta, instalar dependencias o cualquier otra opción que necesitemos
* COPY: para copiar datos desde nuestra máquina a la imagen
* WORKDIR: para cambiar el directorio de trabajo
* CMD: este comando será ejecutado por defecto al iniciar un contenedor a partir de esta imagen

Esto construirá una imagen podman basada en python:alpine, en la cual hemos
guardado nuestra pequeña aplicación y se va a ejecutar cuando ejecutemos un
contenedor basado en esa imagen. Para comprobar que la imagen se ha creado
correctamente, listamos las imagenes, y debería de aparecernos una imagen con
nombre 'app' y tag 'v1':

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen, y vamos a añadir una nueva
opción, -p 8001:8000. Esta opción hará que el puerto interno 8000 del contenedor
sea expuesto en el puerto 8001 de nuestra máquina:

<syntaxhighlight lang="bash">
podman run --name my-app --rm -d -p 8001:8000 app:v1
</syntaxhighlight>

''Nota:'' podman supone que la redirección de puerto es TCP, para una redirección de puertos UDP, puedes usar:

<syntaxhighlight lang="bash">
... -p 8001:8000/udp
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código. En nuestra
máquina haremos:

<syntaxhighlight lang="bash">
curl -X GET http://localhost:8001/welcome?username=LSO
</syntaxhighlight>

Comprobaremos que la salida del comando curl, es "Welcome LSO".

Antes de terminar, vamos a comprobar otro pequeño detalle que añadimos en
nuestra imagen, la variable de entorno USERNAME, vamos a comprobar que funciona:

<syntaxhighlight lang="bash">
podman exec -ti my-app ash
echo $USERNAME
</syntaxhighlight>

Funciona correctamente, pero al ejecutar el contenedor, podemos cambiar esta
variable de entorno como vimos en uno de los pasos anteriores:

<syntaxhighlight lang="bash">
podman run --rm -ti -e USERNAME=me app:v1 ash
echo $USERNAME
</syntaxhighlight>

Esto nos servirá para tener opciones por defecto y que el usuario pueda
cambiarlo a su antojo, como por ejemplo contraseñas u otros detalles.

= Paso 12: Eliminar imágenes =

Para borrar una imagen, puede hacer:

<syntaxhighlight lang="bash">
podman image rm hello-world
</syntaxhighlight>

= Paso 13: Varios podman a la vez (podman-compose) =

Antes de comenzar, vamos a parar todos los contenedores que tengamos abiertos,
para dejar el entorno de podman limpio, que nos vendrá bien para esta parte.

Cuando queremos ejecutar varios contenedores a la vez y que estén conectados
entre ellos fácilmente, utilizaremos podman-compose, donde con un fichero de
configuración simple en yaml, tendremos toda la configuración de lo que vamos a
ejecutar.

Primero vamos a instalar podman-compose:

<syntaxhighlight lang="bash">
sudo apt install podman-compose
</syntaxhighlight>

Ahora veamos un pequeño ejemplo donde explicaremos todos los detalles para crear
un podman-compose, en este caso, el nombre por defecto de los ficheros suele ser
podman-compose.yml, y el contenido será similar a:

<syntaxhighlight lang="bash">
version: '3'

services:
web:
container_name: web
restart: always
build:
context: .
ports:
- "8000:8000"
volumes:
- /home/ubuntu/volume:/volumen:rw
environment:
USERNAME: test
web2:
container_name: web2
build:
dockerfile: Dockerfile
context: .
depends_on:
- web
command: touch web2
web3:
container_name: web3
restart: on-failure
image: pstauffer/curl
depends_on:
- web
command: curl -X GET web:8000/welcome?username=web3
</syntaxhighlight>

En el podman-compose definimos diferentes servicios a ejecutar, en nuestro caso
hemos iniciado tres servicios diferentes, web, web2 y web3:

El primer servicio, web:

* container_name: para darle un nombre por defecto al contenedor cuando se cree
* restart: pueden ser:
** "no": si la máquina termina, no se vuelve a iniciar (opción por defecto)
** always: siempre que el contenedor termine, intenta iniciarse de nuevo
** on-failure: solo intenta reiniciarse si el contenedor termina con fallo
** unless-stopped: solo reinicia el contenedor si el usuario es el que lo termina
* Utilizará el fichero Dockerfile creado en el paso 11 para generar la imagen a usar.
* Expondrá el puerto 8000 del contenedor en el 8000 de nuestra máquina
* Montará un volumen, se hace de forma similar a la línea de comandos
* Creará una variable de entorno

El segundo servicio, web2:

* Utilizará el fichero Dockerfile también, la diferencia entre este y el primer servicio, es que si el nombre del Dockerfile cambia, tendremos que hacerlo de esta segunda forma, la primera por defecto solo buscará el fichero Dockerfile
* depends_on hará que para ejecutar este servicio, su dependencia tenga ya que estar iniciada
* Ejecutaremos un comando el cual sustituirá al comando de la imagen

El tercer servicio, web3:

* Utilizará la imagen ostauffer/curl que es un imagen mínima que contiene el comando curl
* restart: en este caso, hasta que el comando no se ejecute correctamente, se seguirá reiniciando el contenedor
* depends_on igual que el servicio 2, dependerá del servicio 1
* Ejecutaremos un comando para llamar desde el servicio 3 al servicio 1

== Paso 13.1: Construir podman-compose ==

En el caso de existir servicios que tengan Dockerfiles, esto hará que se construyan previamente, como hacer un podman build de cada uno de los servicios que contenga un Dockerfile:

<syntaxhighlight lang="bash">
podman-compose build
</syntaxhighlight>

Con esto se generarán las imágenes necesarias para ejecutar todos los servicios.

== Paso 13.2: Iniciar podman-compose ==

Para iniciar todos los servicios, ejecutaremos:

<syntaxhighlight lang="bash">
podman-compose up -d
</syntaxhighlight>

Después de esto podremos ver el logs de todos los servicios:

<syntaxhighlight lang="bash">
podman-compose logs -f
</syntaxhighlight>

Aquí veremos que el servicio 3 ha conseguido llamar correctamente al servicio 1.

Ahora veremos como podman-compose ha creado los contenedores:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

La salida será similar a la siguiente:

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
219a4118244c pstauffer/curl "curl -X GET web:800…" 6 seconds ago Exited (0) 3 seconds ago web3
c97e894cb3ae ubuntu_web2 "touch web2" 6 seconds ago Exited (0) 4 seconds ago web2
f35d034204fc ubuntu_web "/bin/sh -c 'hug -f …" 6 seconds ago Up 5 seconds 0.0.0.0:8000->8000/tcp web
</syntaxhighlight>

Aquí vemos varios detalles:

* El nombre que le hemos dado en el podman-compose ha funcionado correctamente
* Vemos que los comandos son los correctos también
* web2 está parado por que la política de reinicio es apagar cuando se termine de ejecutar un comando
* web 3 está parado por que el comando ha terminado con un salida correcta

Vamos a comprobar ahora que en el servicio web está todo correcto:

<syntaxhighlight lang="bash">
podman exec -ti web ash
echo $USERNAME
ls /volumen
exit
</syntaxhighlight>

Podemos comprobar que tanto cambiar la variable de entorno como crear un
volumen ha funcionado correctamente.

== Paso 13.3: Parar podman-compose ==

Para parar todos los servicios:

<syntaxhighlight lang="bash">
podman-compose down
</syntaxhighlight>

Comprobamos:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Vemos que han desaparecido todos los contenedores.

= Paso 14: Ejercicios =

== Ejercicio 1: Image derivada de Debian con el programa sl ==

Lance un contenedor a partir de una imagen de Debian, instale el programa sl, ejecute sl (desde fuera del contenedor) y detenga el contenedor.

== Ejercicio 2 ==

== Ejercicio 3: Variante de httpd ==

Construya una imagen ''httpd-hola-mundo'' a partir de la imagen ''httpd''. El fichero de index.html de la carpeta htdocs/ tiene que mostrar el mensaje "hola mundo".

<syntaxhighlight lang="bash">
podman pull httpd
</syntaxhighlight>

Edita el fichero Dockerfile:

<syntaxhighlight lang="bash">
nano Dockerfile
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
FROM httpd

COPY index.html htdocs/index.html
</syntaxhighlight>

Edita el fichero index.html:

<syntaxhighlight lang="bash">
nano index.html
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

Construye la imagen:

<syntaxhighlight lang="bash">
podman build -t mihttpd -f Dockerfile .
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen:

<syntaxhighlight lang="bash">
podman run --name mihttpd -d -p 8080:80 mihttpd
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código:
<syntaxhighlight lang="bash">
curl -X GET http://localhost:8080
</syntaxhighlight>

Tiene que salir por pantalla esto:
<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

== Ejercicio 4: aplicación flask ==

Flask es un framework python para implementar webs. Cree una imagen "miapp-flask" a partir de la imagen de "python":

* Instale flask mediante: pip install flask
* Cree la carpeta "app"
* Establezca la variable FLASK_APP a "hello.py"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"

El fichero hello.py contiene un "hola mundo" para Flask:

<syntaxhighlight lang="python">
from flask import Flask
app = Flask(__name__)

@app.route("/")
def hello():
return "Hello World!"

if __name__ == "__main__":
app.run()
</syntaxhighlight>

Solución con alpine:

<syntaxhighlight lang="bash">
FROM python:alpine

RUN mkdir /app
RUN pip install flask
ENV FLASK_APP="app/hello.py"
COPY hello.py
WORKDIR /
CMD flask run --host=0.0.0.0
</syntaxhighlight>

Solución con Ubuntu:

<syntaxhighlight lang="bash">
FROM ubuntu:bionic

RUN apt-get update
RUN apt-get -y install python python-pip wget
RUN pip install Flask
ENV FLASK_APP="app/hello.py"
RUN mkdir /app
COPY hello.py /app
CMD flask run --host=0.0.0.0
</syntaxhighlight>

== Ejercicio 5: mysql ==

'''EN LA MÁQUINA VIRTUAL:'''

mkdir miapp
cd miapp
podman pull mysql
nano Dockerfile

<syntaxhighlight lang="bash">
FROM mysql
ENV MYSQL_ROOT_PASSWORD="lacontraseñaqueyoquiera"
RUN mkdir /app
WORKDIR /app

</syntaxhighlight>

CTRL+O , ENTER Y CTRL+X (para guardar Dockerfile y salir)

podman build -ti mrfdocker -f Dockerfile .
podman run --name mymrf --rm -p 8001:3306 mrfdocker
docker images

'''EN LA TERMINAL DEL HOST:'''

''Instalación de mysql:''

apt install mysql-client-core-5.7
apt-get install mysql-server
service mysql start

''Para entrar:''

mysql -u root -p -P 8001

Una vez dentro de msql:

mysql> show databases;

''Para salir:''

exit

== Ejercicio 6: python pyramid ==

Pyramid es un framework python para implementar webs. Cree una imagen "miapp-pyramid":

* Emplee la imagen de debian como referencia, instale los paquetes python3 y python3-pip.
* Instale Pyramid mediante: pip install pyramid
* Cree la carpeta "app"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"
* La aplicación se lanza con la orden: python hello.py
* Compruebe que funciona con curl, la ruta a la web es http://127.0.0.1:8000/hello, suponiendo que ha empleado el puerto 8000 para exponer el servicio.

El fichero hello.py contiene un "hola mundo" para Pyramid:

<syntaxhighlight lang="bash">
from wsgiref.simple_server import make_server
from pyramid.config import Configurator
from pyramid.response import Response

def hello_world(request):
print('Request inbound!')
return Response('Podman works with Pyramid!')

if __name__ == '__main__':
config = Configurator()
config.add_route('hello', '/')
config.add_view(hello_world, route_name='hello')
app = config.make_wsgi_app()
server = make_server('0.0.0.0', 6543, app)
server.serve_forever()
</syntaxhighlight>

Este programa recibe peticiones en el puerto 6543.

== Ejercicio 7 ==

Cree una imagen derivada de Ubuntu, instale el paquete apache2, php y libapache2-mod-php.
Active el módulo de php para apache2 mediante la orden:

<syntaxhighlight lang="bash">
a2enmod php
</syntaxhighlight>

Cree la carpeta /var/www/php.

Cree el fichero index.php

<syntaxhighlight lang="php">
<?php
Print "Hello, World!";
?>
</syntaxhighlight>

y copielo a /var/www/php/.

Cree el fichero 000-default.conf y copielo a /etc/apache2/sites-enabled/

Dicho fichero contiene.

<syntaxhighlight lang="bash">
<VirtualHost *:80>
DocumentRoot /var/www/php

<Directory /var/www/php/>
Options Indexes FollowSymLinks MultiViews
AllowOverride All
Order deny,allow
Allow from all
</Directory>

ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>
</syntaxhighlight>

Tiene que lanzar apache con la orden: apachectl -D FOREGROUND

Tras crear la imagen, láncela mapeando el puerto 8888 al 80, pruebe que puede acceder a http://127.0.0.1:8888/php/ mediante curl

Solución:

<syntaxhighlight lang="bash">
FROM ubuntu:latest

RUN apt-get update
RUN apt-get install -y tzdata
RUN apt-get install -y apache2
RUN apt-get install -y php
RUN apt-get install -y libapache2-mod-php
RUN a2enmod php7.2
COPY index.php /var/www/php
COPY 000-default.conf /etc/apache2/sites-enabled/
CMD apachectl -D FOREGROUND
</syntaxhighlight>

Y para lanzarlo:

podman run --name my-app --rm -d -p 8001:8000 app:v1

y para probarlo:

curl -X GET http://127.0.0.1:8888/php/

== Ejercicio 8 ==

Instale el paquete ''netcat-traditional'' en una imagen de contenedor de ''ubuntu''. Lance la orden:

nc -u -l -p 8080

en el contenedor. Asegúrese de crear una redirección de puertos de 9999 desde el ''host'' al puerto 8080 en el contenedor.

Desde fuera del contenedor, pruebe a conectarse con:

nc -u 127.0.0.1 9999

== Ejercicio 9 ==

Cree una imagen derivada de "ubuntu" con un Dockerfile que incluya soporte de python y lance el siguiente código en Python:

<syntaxhighlight lang="python">
from http.server import BaseHTTPRequestHandler, HTTPServer
import time

hostName = "0.0.0.0"
serverPort = 8080

class MyServer(BaseHTTPRequestHandler):
def do_GET(self):
self.send_response(200)
self.send_header("Content-type", "text/html")
self.end_headers()
self.wfile.write(bytes("<html><head><title>Welcome!</title></head>", "utf-8"))
self.wfile.write(bytes("<body>", "utf-8"))
self.wfile.write(bytes("This is an example web server.", "utf-8"))
self.wfile.write(bytes("</body></html>", "utf-8"))

if __name__ == "__main__":
webServer = HTTPServer((hostName, serverPort), MyServer)
print("Server started http://%s:%s" % (hostName, serverPort))

try:
webServer.serve_forever()
except KeyboardInterrupt:
pass

webServer.server_close()
print("Server stopped.")
</syntaxhighlight>

Llame a su imagen "python-http-server". Lance una instancia de la imagen "python-http-server" mapeando el puerto 9999 al puerto 8888/tcp del contenedor. Compruebe con:

<syntaxhighlight lang="bash">
curl http://127.0.0.1:9999/
</syntaxhighlight>

que muestre la página HTML que ofrece el servidor, que debería ser:

<syntaxhighlight lang="bash">
<html><head><title>Welcome!</title></head><body>This is an example web server.</body></html>
</syntaxhighlight>

Contenedores

2025-12-11T18:21:42Z

Pneira: /* Ejercicio 6: python pyramid */

En esta práctica aprenderemos a utilizar [https://es.wikipedia.org/wiki/Podman podman] para desplegar contenedores.

= Paso 1: Instalar podman =

Para instalar el paquete oficial:

<syntaxhighlight lang="bash">
apt install podman
</syntaxhighlight>

podman es un clon de '''docker''.

Si añade un usuario 'test' a su sistema con:

<syntaxhighlight lang="bash">
adduser test
</syntaxhighlight>

recuerde hacer:

<syntaxhighlight lang="bash">
loginctl enable-linger test
systemctl start --user dbus
</syntaxhighlight>

para evitar un warning que se muestra al ejecutar '''podman''' como usuario.

= Paso 2: Repositorio de imágenes de contenedores DockerHub =

Docker ofrece un servicio de nube denominado ''DockerHub'' que puede ser empleado como red social para compartir tus imágenes de Podman. En ''DockerHub'' existen además imágenes de contenedores preconfiguradas de software, muchas de ellas oficiales (ofrecidas por el propio fabricante del software) que se podrán emplear como base para construir nuevas imágenes adaptadas a nuestras necesidades.

Podremos realizar búsquedas en este repositorio ''DockerHub'' puedes emplear el siguiente comando:

<syntaxhighlight lang="bash">
podman search docker.io/library/hello-world
</syntaxhighlight>

Para descargarnos la imagen de ''hello-world'' podemos usar la orden ''pull'':

<syntaxhighlight lang="bash">
podman pull docker.io/library/hello-world
</syntaxhighlight>

También podemos publicar imágenes propias, esto require '''registro de usuario''' en la nube de ''DockerHub'', lo que '''no''' es obligatorio para la realización de esta práctica. Para subir una imagen, hay que validarse como usuario en la nube de ''DockerHub'':

<syntaxhighlight lang="bash">
podman login
</syntaxhighlight>

Tras introducir tu usuario y contraseña, puedes comenzar a publicar tus propias imágenes.

<syntaxhighlight lang="bash">
podman push MI_IMAGEN
</syntaxhighlight>

Este paso es '''opcional''', sólo en caso de que se quieran subir imágenes de contenedores a la nube de docker.io.

= Paso 4: Comprobar imágenes en nuestra máquina =

Para ver las imágenes que tenemos en nuestra máquina, utilizaremos el comando:

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Inicialmente, no tenemos imágenes en almacenamiento, podemos descargarnos la imagen oficial de Debian 13 (Trixie):

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian
</syntaxhighlight>

Ahora si, ya debería de aparecernos la imagen ''debian''.

Comentar también que cada imagen puede tener varias etiquetas, por ejemplo, la imagen Debian 12 (Bookworm), cuando la hemos visto en el listado de imágenes, venía con el tag latest, que es el tag que se descarga por defecto, pero nosotros podemos especificar otro, por ejemplo:

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian:bookworm
</syntaxhighlight>

Para traernos la versión de la imagen de Debian 12 ''Bookworm''.

Ahora tendremos dos imágenes con diferente etiqueta, que serían como las diferentes versiones de cada imagen.

= Paso 5: Lanzar un contenedor =

Un contenedor no es más que una imagen de podman ejecutándose, sería similar a
una máquina virtual, aunque mucho más liviano.

Para crear un contenedor, utilizaremos una imagen, en este caso, la imagen
hello-world. Hacemos lo siguiente:

<syntaxhighlight lang="bash">
podman run hello-world
</syntaxhighlight>

Esto nos mostrará el siguiente mensaje si todo está correcto:

<syntaxhighlight lang="bash">
Hello from Docker!
This message shows that your installation appears to be working correctly.

To generate this message, Docker took the following steps:
1. The Docker client contacted the Docker daemon.
2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
(amd64)
3. The Docker daemon created a new container from that image which runs the
executable that produces the output you are currently reading.
4. The Docker daemon streamed that output to the Docker client, which sent it
to your terminal.

To try something more ambitious, you can run an Debian container with:
$ podman run -it debian bash

Share images, automate workflows, and more with a free Docker ID:
https://hub.docker.com/

For more examples and ideas, visit:
https://docs.docker.com/get-started/
</syntaxhighlight>

Al crear los contenedores utilizando el comando 'run', tenemos varias opciones:

* Lanzar una terminal en el contenedor en modo interactivo
* Lanzar en segundo plano y conectarnos posteriormente al contenedor

== Paso 5.1: Lanzar una terminal en el contenedor en modo interactivo (-ti) ==

Para este ejemplo vamos a utilizar otra imagen diferente, en este caso vamos a utilizar una imagen de debian.

Vamos a lanzar un contenedor y ejecutar una terminal en el que se va a ejecutar el programa '''bash''' que me ofrece un interprete de órdenes:

<syntaxhighlight lang="bash">
podman run -ti debian bash
</syntaxhighlight>

La opción ''-t'' indica que se crea un terminal en el contenedor. Y la opción ''-i'' indica que el contenedor se ejecuta en modo interactivo.

Al acceder al contenedor de ''debian'' nos aparece un ''hash'' en el prompt de la shell, que identifica a la instancia del contenedor (es valor es similar al que muestra la orden ''podman container ls'').

Para salir del contenedor, escribimos 'exit' o pulsamos ''CTRL + D''

== Paso 5.2 Lanzar en segundo plano (-d) ==

Otro ejemplo, con la imagen de Debian:

<syntaxhighlight lang="bash">
podman run -dti debian
</syntaxhighlight>

que muestra un hash que identifica de forma única el contenedor lanzado:

<syntaxhighlight lang="bash">
2ec1daae4676a4e84dc04fd91399c1dfe92119544ff12ee307991fe573d3db64
</syntaxhighlight>

Mediante el comando ''attach'' puedo entrar al contenedor:

<syntaxhighlight lang="bash">
podman attach 2ec1daae4676
</syntaxhighlight>

Para salir, pulsamos ''CTRL + P'' seguido de ''CTRL + Q''.

De manera similar, puedo lanzar en segundo plano la imagen de contenedor de ''hello-world'':

<syntaxhighlight lang="bash">
podman run -d hello-world
</syntaxhighlight>

Y consultar los logs:

<syntaxhighlight lang="bash">
podman logs b67fae3312bc321
</syntaxhighlight>

== Paso 5.3: Añadir variables de entorno a un contenedor ==

Utilizaremos la imagen anterior, y vamos a añadir una variable de entorno
llamada TEST que contenga el valor 'test'. A parte, también ejecutaremos la
terminal como antes, para comprobar con el comando echo, que la variable de
entorno está creada correctamente:

<syntaxhighlight lang="bash">
podman run -ti -e TEST=test debian bash
</syntaxhighlight>

Ahora, desde el contenedor podemos comprobar el valor de la variable de entorno ''$TEST''.

<syntaxhighlight lang="bash">
echo $TEST
test
</syntaxhighlight>

= Paso 6: Listar contenedores en ejecución =

Hemos estado haciendo pruebas y ejecutando contenedores en el paso anterior, vamos a ver donde se encuentran estos contenedores que hemos ejecutado, y después veremos algunas opciones más del comando run.

Tenemos dos opciones para ver los contenedores:

<syntaxhighlight lang="bash">
podman container ls -a
</syntaxhighlight>

o la versión corta:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Ambas hacen lo mismo, y debería de mostrarnos una salida similar a la siguiente:

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
e2bde5f5500c debian "bash" 6 minutes ago Exited (0) 2 seconds ago pensive_sammet
544ad27dbc3c debian "bash" 7 minutes ago Exited (0) 7 minutes ago serene_elgamal
</syntaxhighlight>

En la información veremos que el contenedor tiene el estado exited, eso quiere decir que no se está ejecutando y ya ha finalizado. Vamos a hacer una prueba para ver un contendor ejecutándose:

<syntaxhighlight lang="bash">
podman run -d debian sleep 30
</syntaxhighlight>

Con el comando sleep 30 esperamos 30 segundos hasta que termine el comando, asíque durante esos 30 segundos, el contenedor estará ejecutándose, veámoslo:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
eacceb27d52d debian "sleep 30" 12 seconds ago Up 11 seconds sharp_pasteur
</syntaxhighlight>

Vamos a ver alguna opciones más de la orden ''run''.

== Paso 6.1: Dar un nombre al contenedor (--name) ==

Por defecto, podman creará automáticamente un nombre como hemos visto en las salidas del comando ''podman ps -a''. Podemos establecer el nombre del contenedor que queramos con la opción ''--name'':

<syntaxhighlight lang="bash">
podman run -ti --name mi_debian debian
</syntaxhighlight>

== Paso 6.2: Eliminar contenedor cuando termine (--rm) ==

Vamos a mezclar todo lo visto anteriormente:

* Lanzar en segundo plano (-d)
* Ejecutar contenedor durante 30 segundos (sleep 30)
* Dar un nombre a la imagen (--name)
* Eliminar contenedor cuando termine (--rm)

<syntaxhighlight lang="bash">
podman run -d --rm --name bye-bye debian sleep 30
</syntaxhighlight>

Antes y una vez pasados los 30 segundos, podemos comprobar que el contenedor ha desaparecido.

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

= Paso 7: Parar y eliminar contenedores =

Para parar contenedores podemos usar el ID o su nombre:

<syntaxhighlight lang="bash">
podman stop my_container
podman stop e4901956f108
podman ps -a
</syntaxhighlight>

Una vez hemos comprobado que han terminado su ejecución, podemos eliminar los ficheros resultantes de su ejecución:

<syntaxhighlight lang="bash">
podman container rm my_container
</syntaxhighlight>

Para borrar todos los contenedores ya finalizados

<syntaxhighlight lang="bash">
podman container prune
</syntaxhighlight>

= Paso 8: Conectarnos a un contenedor que se está ejecutando en segundo plano =

Vamos a ejecutar de nuevo un contenedor que no termine:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a conectarnos a este contenedor que está ejecutándose en segundo
plano:

<syntaxhighlight lang="bash">
podman attach mi-contenedor
</syntaxhighlight>

Veremos la orden bash ejecutándose, para terminar, hacemos un 'CTRL + C', y ahora, veremos que ha pasado con el contenedor:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Lo veremos parado, por que lo que hemos hecho ha sido conectarnos al contenedor
y parar el comando que se estaba ejecutando, así que ahora tenemos el contenedor
finalizado.

''Nota:'' Para salir del contenedor '''sin detenerlo''' hacemos 'CTRL + P' seguido 'CTRL + Q'

= Paso 9: Ejecutar un comando dentro de un contenedor en ejecución =

Vamos a ver otresta vez como ejecutar un comando en un contenedor que ya está
ejecutándose:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a ejecutar un comando en ese contenedor con el nombre ''mi-contenedor''.
El comando exec es similar al comando run, pero para ejecutar un comando dentro de un contenedor:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor ls
</syntaxhighlight>

Para redirigir la salida a un fichero en el anfitrión:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor ls > x.txt
</syntaxhighlight>

Para redirigir la salida a un fichero ''dentro'' del contenedor, hacemos:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor sh -c "ls > x.txt"
</syntaxhighlight>

También es posible ejecutar comandos con tuberías:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor sh -c "ls -la | grep ^d"
</syntaxhighlight>

= Paso 10: Persistencia en contenedores =

Al hacer ''exit'' y salir de un contenedor, se pierden todos los cambios que hemos realizado. Los

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-ejemplo debian bash
</syntaxhighlight>

Ahora, vamos a crear una carpeta en el contenedor y comprobar que esa carpeta existe:

<syntaxhighlight lang="bash">
podman exec mi-ejemplo mkdir test
podman exec mi-ejemplo ls
</syntaxhighlight>

Veremos que la carpeta existe, pero, ¿qué ocurre si para el contenedor?

<syntaxhighlight lang="bash">
podman container stop mi-ejemplo
</syntaxhighlight>

Y volvemos a lanzarlo:

<syntaxhighlight lang="bash">
podman container rm mi-ejemplo
podman run -d -ti --name mi-ejemplo debian bash
podman exec mi-ejemplo ls
</syntaxhighlight>

Podemos comprobar que la carpeta creada anteriormente, no existe.

¿Qué podemos hacer para mantener la modificaciones realizadas sobre un contenedor?

== Paso 10.1: Crear una imagen derivada de la imagen base ==

Es posible crear una imagen derivada, con modificaciones, a partir de una imagen existente mediante la orden '''commit'''.

Por ejemplo, si queremos una imagen ''debian'' que incluya el programa ''ping'' ya instalado, tendríamos que lanzar un contenedor a partir de la imagen ''ubuntu'':

<syntaxhighlight lang="bash">
podman run -d -ti debian bash
</syntaxhighlight>

Suponiendo que el contenido está identificado con el ID 56ef5b312334

Instalamos el paquete ping:

<syntaxhighlight lang="bash">
podman exec 56ef5b312334 apt -y install ping
</syntaxhighlight>

Generamos la imagen derivada con el nombre ''ubuntu-con-ping'':

<syntaxhighlight lang="bash">
podman commit 56ef5b312334 ubuntu-con-ping
</syntaxhighlight>

Ya podemos para nuestro contendor:

<syntaxhighlight lang="bash">
podman stop 56ef5b312334
</syntaxhighlight>

Y lanzar un nuevo contenedor a partir de la imagen ''debian-con-ping'':

<syntaxhighlight lang="bash">
podman run -d -ti debian-con-ping bash
</syntaxhighlight>

== Paso 10.2: Mantener la persistencia mediante volúmen ==

Otra opción para mantener los datos es montar un volumen al ejecutar el contenedor.

Primero crearemos una carpeta que hará de volumen en nuestra máquina, que será la que luego montemos para podman:

<syntaxhighlight lang="bash">
mkdir /home/debian/volumen
</syntaxhighlight>

Ahora vamos a montar la carpeta al ejecutar el contenedor, lo hacemos con la
opción -v, la cual tiene 3 campos separados por ':':

# El volumen en nuestra máquina
# Donde se montará el volumen dentro del contenedor
# Opciones de mmontaje, por ejemplo rw (read and write) o ro (read only)

<syntaxhighlight lang="bash">
podman run --rm -ti -v /home/debian/volumen:/volumen:rw debian bash
mkdir /volumen/test
touch /volumen/test/file
exit
</syntaxhighlight>

Una vez nos salgamos del contenedor, podemos ver que en nuestra máquina están
los datos:

<syntaxhighlight lang="bash">
ls /home/ubuntu/volumen/
ls /home/ubuntu/volumen/test
</syntaxhighlight>

La próxima vez que ejecutemos un contenedor, si montamos ese volumen, los datos
estarán ahí, además esta forma tiene el beneficio de compartir datos entre
nuestra máquina y el contenedor de forma sencilla.

= Paso 11: Crear nuestra propia imagen de contenedor =

Para crear una imagen de un contenedor con una aplicación de Python hug, creamos en primer lugar la carpeta que contendrá los ficheros que nos permiten crear la imagen.

<syntaxhighlight lang="bash">
mkdir miapp
cd miapp
</syntaxhighlight>

Definimos un fichero ''Dockerfile'' para definir la imagen:

<syntaxhighlight lang="bash">
FROM ubuntu

RUN apt -y update
RUN apt -y upgrade
RUN apt -y install python3-hug
RUN mkdir /app
COPY endpoint.py /app
WORKDIR /app
CMD hug -f endpoint.py
</syntaxhighlight>

Alternativamente, puedes crear un [[Creando imagen propia usando Ubuntu de base|Dockerfile empleando la imagen de Ubuntu]] como base en lugar de Alpine.

Y añadimos el fichero ''endpoint.py'' que emplea el framework Python hug con el contenido siguiente:

<syntaxhighlight lang="bash">
import hug

@hug.get('/welcome')
def welcome(username="unknown"):
""" Say welcome to username """
return "Welcome " + username
</syntaxhighlight>

Este fichero es un ejemplo de uso de Python hug. Si hacemos una petición a /welcome?username="LSO", esto nos devolverá el mensaje "Welcome LSO".

Una vez tengamos los dos ficheros creados en nuestra máquina virtual, podemos construir nuestra imagen:

<syntaxhighlight lang="bash">
podman build -t app:v1 -f Dockerfile .
</syntaxhighlight>

Vamos a explicar para que sirve cada línea:

* FROM: servirá para basarnos en una imagen existente, en este caso, una imagen de python alpine, que contiene python y no ocupa mucho espacio
* ENV: para crear variables de entorno
* RUN: para ejecutar comandos, ya sea para crear una carpeta, instalar dependencias o cualquier otra opción que necesitemos
* COPY: para copiar datos desde nuestra máquina a la imagen
* WORKDIR: para cambiar el directorio de trabajo
* CMD: este comando será ejecutado por defecto al iniciar un contenedor a partir de esta imagen

Esto construirá una imagen podman basada en python:alpine, en la cual hemos
guardado nuestra pequeña aplicación y se va a ejecutar cuando ejecutemos un
contenedor basado en esa imagen. Para comprobar que la imagen se ha creado
correctamente, listamos las imagenes, y debería de aparecernos una imagen con
nombre 'app' y tag 'v1':

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen, y vamos a añadir una nueva
opción, -p 8001:8000. Esta opción hará que el puerto interno 8000 del contenedor
sea expuesto en el puerto 8001 de nuestra máquina:

<syntaxhighlight lang="bash">
podman run --name my-app --rm -d -p 8001:8000 app:v1
</syntaxhighlight>

''Nota:'' podman supone que la redirección de puerto es TCP, para una redirección de puertos UDP, puedes usar:

<syntaxhighlight lang="bash">
... -p 8001:8000/udp
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código. En nuestra
máquina haremos:

<syntaxhighlight lang="bash">
curl -X GET http://localhost:8001/welcome?username=LSO
</syntaxhighlight>

Comprobaremos que la salida del comando curl, es "Welcome LSO".

Antes de terminar, vamos a comprobar otro pequeño detalle que añadimos en
nuestra imagen, la variable de entorno USERNAME, vamos a comprobar que funciona:

<syntaxhighlight lang="bash">
podman exec -ti my-app ash
echo $USERNAME
</syntaxhighlight>

Funciona correctamente, pero al ejecutar el contenedor, podemos cambiar esta
variable de entorno como vimos en uno de los pasos anteriores:

<syntaxhighlight lang="bash">
podman run --rm -ti -e USERNAME=me app:v1 ash
echo $USERNAME
</syntaxhighlight>

Esto nos servirá para tener opciones por defecto y que el usuario pueda
cambiarlo a su antojo, como por ejemplo contraseñas u otros detalles.

= Paso 12: Eliminar imágenes =

Para borrar una imagen, puede hacer:

<syntaxhighlight lang="bash">
podman image rm hello-world
</syntaxhighlight>

= Paso 13: Varios podman a la vez (podman-compose) =

Antes de comenzar, vamos a parar todos los contenedores que tengamos abiertos,
para dejar el entorno de podman limpio, que nos vendrá bien para esta parte.

Cuando queremos ejecutar varios contenedores a la vez y que estén conectados
entre ellos fácilmente, utilizaremos podman-compose, donde con un fichero de
configuración simple en yaml, tendremos toda la configuración de lo que vamos a
ejecutar.

Primero vamos a instalar podman-compose:

<syntaxhighlight lang="bash">
sudo apt install podman-compose
</syntaxhighlight>

Ahora veamos un pequeño ejemplo donde explicaremos todos los detalles para crear
un podman-compose, en este caso, el nombre por defecto de los ficheros suele ser
podman-compose.yml, y el contenido será similar a:

<syntaxhighlight lang="bash">
version: '3'

services:
web:
container_name: web
restart: always
build:
context: .
ports:
- "8000:8000"
volumes:
- /home/ubuntu/volume:/volumen:rw
environment:
USERNAME: test
web2:
container_name: web2
build:
dockerfile: Dockerfile
context: .
depends_on:
- web
command: touch web2
web3:
container_name: web3
restart: on-failure
image: pstauffer/curl
depends_on:
- web
command: curl -X GET web:8000/welcome?username=web3
</syntaxhighlight>

En el podman-compose definimos diferentes servicios a ejecutar, en nuestro caso
hemos iniciado tres servicios diferentes, web, web2 y web3:

El primer servicio, web:

* container_name: para darle un nombre por defecto al contenedor cuando se cree
* restart: pueden ser:
** "no": si la máquina termina, no se vuelve a iniciar (opción por defecto)
** always: siempre que el contenedor termine, intenta iniciarse de nuevo
** on-failure: solo intenta reiniciarse si el contenedor termina con fallo
** unless-stopped: solo reinicia el contenedor si el usuario es el que lo termina
* Utilizará el fichero Dockerfile creado en el paso 11 para generar la imagen a usar.
* Expondrá el puerto 8000 del contenedor en el 8000 de nuestra máquina
* Montará un volumen, se hace de forma similar a la línea de comandos
* Creará una variable de entorno

El segundo servicio, web2:

* Utilizará el fichero Dockerfile también, la diferencia entre este y el primer servicio, es que si el nombre del Dockerfile cambia, tendremos que hacerlo de esta segunda forma, la primera por defecto solo buscará el fichero Dockerfile
* depends_on hará que para ejecutar este servicio, su dependencia tenga ya que estar iniciada
* Ejecutaremos un comando el cual sustituirá al comando de la imagen

El tercer servicio, web3:

* Utilizará la imagen ostauffer/curl que es un imagen mínima que contiene el comando curl
* restart: en este caso, hasta que el comando no se ejecute correctamente, se seguirá reiniciando el contenedor
* depends_on igual que el servicio 2, dependerá del servicio 1
* Ejecutaremos un comando para llamar desde el servicio 3 al servicio 1

== Paso 13.1: Construir podman-compose ==

En el caso de existir servicios que tengan Dockerfiles, esto hará que se construyan previamente, como hacer un podman build de cada uno de los servicios que contenga un Dockerfile:

<syntaxhighlight lang="bash">
podman-compose build
</syntaxhighlight>

Con esto se generarán las imágenes necesarias para ejecutar todos los servicios.

== Paso 13.2: Iniciar podman-compose ==

Para iniciar todos los servicios, ejecutaremos:

<syntaxhighlight lang="bash">
podman-compose up -d
</syntaxhighlight>

Después de esto podremos ver el logs de todos los servicios:

<syntaxhighlight lang="bash">
podman-compose logs -f
</syntaxhighlight>

Aquí veremos que el servicio 3 ha conseguido llamar correctamente al servicio 1.

Ahora veremos como podman-compose ha creado los contenedores:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

La salida será similar a la siguiente:

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
219a4118244c pstauffer/curl "curl -X GET web:800…" 6 seconds ago Exited (0) 3 seconds ago web3
c97e894cb3ae ubuntu_web2 "touch web2" 6 seconds ago Exited (0) 4 seconds ago web2
f35d034204fc ubuntu_web "/bin/sh -c 'hug -f …" 6 seconds ago Up 5 seconds 0.0.0.0:8000->8000/tcp web
</syntaxhighlight>

Aquí vemos varios detalles:

* El nombre que le hemos dado en el podman-compose ha funcionado correctamente
* Vemos que los comandos son los correctos también
* web2 está parado por que la política de reinicio es apagar cuando se termine de ejecutar un comando
* web 3 está parado por que el comando ha terminado con un salida correcta

Vamos a comprobar ahora que en el servicio web está todo correcto:

<syntaxhighlight lang="bash">
podman exec -ti web ash
echo $USERNAME
ls /volumen
exit
</syntaxhighlight>

Podemos comprobar que tanto cambiar la variable de entorno como crear un
volumen ha funcionado correctamente.

== Paso 13.3: Parar podman-compose ==

Para parar todos los servicios:

<syntaxhighlight lang="bash">
podman-compose down
</syntaxhighlight>

Comprobamos:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Vemos que han desaparecido todos los contenedores.

= Paso 14: Ejercicios =

== Ejercicio 1: Image derivada de Debian con el programa sl ==

Lance un contenedor a partir de una imagen de Debian, instale el programa sl, ejecute sl (desde fuera del contenedor) y detenga el contenedor.

== Ejercicio 2 ==

== Ejercicio 3: Variante de httpd ==

Construya una imagen ''httpd-hola-mundo'' a partir de la imagen ''httpd''. El fichero de index.html de la carpeta htdocs/ tiene que mostrar el mensaje "hola mundo".

<syntaxhighlight lang="bash">
podman pull httpd
</syntaxhighlight>

Edita el fichero Dockerfile:

<syntaxhighlight lang="bash">
nano Dockerfile
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
FROM httpd

COPY index.html htdocs/index.html
</syntaxhighlight>

Edita el fichero index.html:

<syntaxhighlight lang="bash">
nano index.html
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

Construye la imagen:

<syntaxhighlight lang="bash">
podman build -t mihttpd -f Dockerfile .
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen:

<syntaxhighlight lang="bash">
podman run --name mihttpd -d -p 8080:80 mihttpd
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código:
<syntaxhighlight lang="bash">
curl -X GET http://localhost:8080
</syntaxhighlight>

Tiene que salir por pantalla esto:
<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

== Ejercicio 4: aplicación flask ==

Flask es un framework python para implementar webs. Cree una imagen "miapp-flask" a partir de la imagen de "python":

* Instale flask mediante: pip install flask
* Cree la carpeta "app"
* Establezca la variable FLASK_APP a "hello.py"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"

El fichero hello.py contiene un "hola mundo" para Flask:

<syntaxhighlight lang="python">
from flask import Flask
app = Flask(__name__)

@app.route("/")
def hello():
return "Hello World!"

if __name__ == "__main__":
app.run()
</syntaxhighlight>

Solución con alpine:

<syntaxhighlight lang="bash">
FROM python:alpine

RUN mkdir /app
RUN pip install flask
ENV FLASK_APP="app/hello.py"
COPY hello.py
WORKDIR /
CMD flask run --host=0.0.0.0
</syntaxhighlight>

Solución con Ubuntu:

<syntaxhighlight lang="bash">
FROM ubuntu:bionic

RUN apt-get update
RUN apt-get -y install python python-pip wget
RUN pip install Flask
ENV FLASK_APP="app/hello.py"
RUN mkdir /app
COPY hello.py /app
CMD flask run --host=0.0.0.0
</syntaxhighlight>

== Ejercicio 5: mysql ==

'''EN LA MÁQUINA VIRTUAL:'''

mkdir miapp
cd miapp
podman pull mysql
nano Dockerfile

<syntaxhighlight lang="bash">
FROM mysql
ENV MYSQL_ROOT_PASSWORD="lacontraseñaqueyoquiera"
RUN mkdir /app
WORKDIR /app

</syntaxhighlight>

CTRL+O , ENTER Y CTRL+X (para guardar Dockerfile y salir)

podman build -ti mrfdocker -f Dockerfile .
podman run --name mymrf --rm -p 8001:3306 mrfdocker
docker images

'''EN LA TERMINAL DEL HOST:'''

''Instalación de mysql:''

apt install mysql-client-core-5.7
apt-get install mysql-server
service mysql start

''Para entrar:''

mysql -u root -p -P 8001

Una vez dentro de msql:

mysql> show databases;

''Para salir:''

exit

== Ejercicio 6: python pyramid ==

Pyramid es un framework python para implementar webs. Cree una imagen "miapp-pyramid":

* Emplee la imagen de debian como referencia, instale los paquetes python y python-pip.
* Instale Pyramid mediante: pip install pyramid
* Cree la carpeta "app"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"
* La aplicación se lanza con la orden: python hello.py
* Compruebe que funciona con curl, la ruta a la web es http://127.0.0.1:8000/hello, suponiendo que ha empleado el puerto 8000 para exponer el servicio.

El fichero hello.py contiene un "hola mundo" para Pyramid:

<syntaxhighlight lang="bash">
from wsgiref.simple_server import make_server
from pyramid.config import Configurator
from pyramid.response import Response

def hello_world(request):
print('Request inbound!')
return Response('Podman works with Pyramid!')

if __name__ == '__main__':
config = Configurator()
config.add_route('hello', '/')
config.add_view(hello_world, route_name='hello')
app = config.make_wsgi_app()
server = make_server('0.0.0.0', 6543, app)
server.serve_forever()
</syntaxhighlight>

Este programa recibe peticiones en el puerto 6543.

== Ejercicio 7 ==

Cree una imagen derivada de Ubuntu, instale el paquete apache2, php y libapache2-mod-php.
Active el módulo de php para apache2 mediante la orden:

<syntaxhighlight lang="bash">
a2enmod php
</syntaxhighlight>

Cree la carpeta /var/www/php.

Cree el fichero index.php

<syntaxhighlight lang="php">
<?php
Print "Hello, World!";
?>
</syntaxhighlight>

y copielo a /var/www/php/.

Cree el fichero 000-default.conf y copielo a /etc/apache2/sites-enabled/

Dicho fichero contiene.

<syntaxhighlight lang="bash">
<VirtualHost *:80>
DocumentRoot /var/www/php

<Directory /var/www/php/>
Options Indexes FollowSymLinks MultiViews
AllowOverride All
Order deny,allow
Allow from all
</Directory>

ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>
</syntaxhighlight>

Tiene que lanzar apache con la orden: apachectl -D FOREGROUND

Tras crear la imagen, láncela mapeando el puerto 8888 al 80, pruebe que puede acceder a http://127.0.0.1:8888/php/ mediante curl

Solución:

<syntaxhighlight lang="bash">
FROM ubuntu:latest

RUN apt-get update
RUN apt-get install -y tzdata
RUN apt-get install -y apache2
RUN apt-get install -y php
RUN apt-get install -y libapache2-mod-php
RUN a2enmod php7.2
COPY index.php /var/www/php
COPY 000-default.conf /etc/apache2/sites-enabled/
CMD apachectl -D FOREGROUND
</syntaxhighlight>

Y para lanzarlo:

podman run --name my-app --rm -d -p 8001:8000 app:v1

y para probarlo:

curl -X GET http://127.0.0.1:8888/php/

== Ejercicio 8 ==

Instale el paquete ''netcat-traditional'' en una imagen de contenedor de ''ubuntu''. Lance la orden:

nc -u -l -p 8080

en el contenedor. Asegúrese de crear una redirección de puertos de 9999 desde el ''host'' al puerto 8080 en el contenedor.

Desde fuera del contenedor, pruebe a conectarse con:

nc -u 127.0.0.1 9999

== Ejercicio 9 ==

Cree una imagen derivada de "ubuntu" con un Dockerfile que incluya soporte de python y lance el siguiente código en Python:

<syntaxhighlight lang="python">
from http.server import BaseHTTPRequestHandler, HTTPServer
import time

hostName = "0.0.0.0"
serverPort = 8080

class MyServer(BaseHTTPRequestHandler):
def do_GET(self):
self.send_response(200)
self.send_header("Content-type", "text/html")
self.end_headers()
self.wfile.write(bytes("<html><head><title>Welcome!</title></head>", "utf-8"))
self.wfile.write(bytes("<body>", "utf-8"))
self.wfile.write(bytes("This is an example web server.", "utf-8"))
self.wfile.write(bytes("</body></html>", "utf-8"))

if __name__ == "__main__":
webServer = HTTPServer((hostName, serverPort), MyServer)
print("Server started http://%s:%s" % (hostName, serverPort))

try:
webServer.serve_forever()
except KeyboardInterrupt:
pass

webServer.server_close()
print("Server stopped.")
</syntaxhighlight>

Llame a su imagen "python-http-server". Lance una instancia de la imagen "python-http-server" mapeando el puerto 9999 al puerto 8888/tcp del contenedor. Compruebe con:

<syntaxhighlight lang="bash">
curl http://127.0.0.1:9999/
</syntaxhighlight>

que muestre la página HTML que ofrece el servidor, que debería ser:

<syntaxhighlight lang="bash">
<html><head><title>Welcome!</title></head><body>This is an example web server.</body></html>
</syntaxhighlight>

Contenedores

2025-12-11T08:44:28Z

Pneira: /* Paso 1: Instalar podman */

En esta práctica aprenderemos a utilizar [https://es.wikipedia.org/wiki/Podman podman] para desplegar contenedores.

= Paso 1: Instalar podman =

Para instalar el paquete oficial:

<syntaxhighlight lang="bash">
apt install podman
</syntaxhighlight>

podman es un clon de '''docker''.

Si añade un usuario 'test' a su sistema con:

<syntaxhighlight lang="bash">
adduser test
</syntaxhighlight>

recuerde hacer:

<syntaxhighlight lang="bash">
loginctl enable-linger test
systemctl start --user dbus
</syntaxhighlight>

para evitar un warning que se muestra al ejecutar '''podman''' como usuario.

= Paso 2: Repositorio de imágenes de contenedores DockerHub =

Docker ofrece un servicio de nube denominado ''DockerHub'' que puede ser empleado como red social para compartir tus imágenes de Podman. En ''DockerHub'' existen además imágenes de contenedores preconfiguradas de software, muchas de ellas oficiales (ofrecidas por el propio fabricante del software) que se podrán emplear como base para construir nuevas imágenes adaptadas a nuestras necesidades.

Podremos realizar búsquedas en este repositorio ''DockerHub'' puedes emplear el siguiente comando:

<syntaxhighlight lang="bash">
podman search docker.io/library/hello-world
</syntaxhighlight>

Para descargarnos la imagen de ''hello-world'' podemos usar la orden ''pull'':

<syntaxhighlight lang="bash">
podman pull docker.io/library/hello-world
</syntaxhighlight>

También podemos publicar imágenes propias, esto require '''registro de usuario''' en la nube de ''DockerHub'', lo que '''no''' es obligatorio para la realización de esta práctica. Para subir una imagen, hay que validarse como usuario en la nube de ''DockerHub'':

<syntaxhighlight lang="bash">
podman login
</syntaxhighlight>

Tras introducir tu usuario y contraseña, puedes comenzar a publicar tus propias imágenes.

<syntaxhighlight lang="bash">
podman push MI_IMAGEN
</syntaxhighlight>

Este paso es '''opcional''', sólo en caso de que se quieran subir imágenes de contenedores a la nube de docker.io.

= Paso 4: Comprobar imágenes en nuestra máquina =

Para ver las imágenes que tenemos en nuestra máquina, utilizaremos el comando:

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Inicialmente, no tenemos imágenes en almacenamiento, podemos descargarnos la imagen oficial de Debian 13 (Trixie):

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian
</syntaxhighlight>

Ahora si, ya debería de aparecernos la imagen ''debian''.

Comentar también que cada imagen puede tener varias etiquetas, por ejemplo, la imagen Debian 12 (Bookworm), cuando la hemos visto en el listado de imágenes, venía con el tag latest, que es el tag que se descarga por defecto, pero nosotros podemos especificar otro, por ejemplo:

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian:bookworm
</syntaxhighlight>

Para traernos la versión de la imagen de Debian 12 ''Bookworm''.

Ahora tendremos dos imágenes con diferente etiqueta, que serían como las diferentes versiones de cada imagen.

= Paso 5: Lanzar un contenedor =

Un contenedor no es más que una imagen de podman ejecutándose, sería similar a
una máquina virtual, aunque mucho más liviano.

Para crear un contenedor, utilizaremos una imagen, en este caso, la imagen
hello-world. Hacemos lo siguiente:

<syntaxhighlight lang="bash">
podman run hello-world
</syntaxhighlight>

Esto nos mostrará el siguiente mensaje si todo está correcto:

<syntaxhighlight lang="bash">
Hello from Docker!
This message shows that your installation appears to be working correctly.

To generate this message, Docker took the following steps:
1. The Docker client contacted the Docker daemon.
2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
(amd64)
3. The Docker daemon created a new container from that image which runs the
executable that produces the output you are currently reading.
4. The Docker daemon streamed that output to the Docker client, which sent it
to your terminal.

To try something more ambitious, you can run an Debian container with:
$ podman run -it debian bash

Share images, automate workflows, and more with a free Docker ID:
https://hub.docker.com/

For more examples and ideas, visit:
https://docs.docker.com/get-started/
</syntaxhighlight>

Al crear los contenedores utilizando el comando 'run', tenemos varias opciones:

* Lanzar una terminal en el contenedor en modo interactivo
* Lanzar en segundo plano y conectarnos posteriormente al contenedor

== Paso 5.1: Lanzar una terminal en el contenedor en modo interactivo (-ti) ==

Para este ejemplo vamos a utilizar otra imagen diferente, en este caso vamos a utilizar una imagen de debian.

Vamos a lanzar un contenedor y ejecutar una terminal en el que se va a ejecutar el programa '''bash''' que me ofrece un interprete de órdenes:

<syntaxhighlight lang="bash">
podman run -ti debian bash
</syntaxhighlight>

La opción ''-t'' indica que se crea un terminal en el contenedor. Y la opción ''-i'' indica que el contenedor se ejecuta en modo interactivo.

Al acceder al contenedor de ''debian'' nos aparece un ''hash'' en el prompt de la shell, que identifica a la instancia del contenedor (es valor es similar al que muestra la orden ''podman container ls'').

Para salir del contenedor, escribimos 'exit' o pulsamos ''CTRL + D''

== Paso 5.2 Lanzar en segundo plano (-d) ==

Otro ejemplo, con la imagen de Debian:

<syntaxhighlight lang="bash">
podman run -dti debian
</syntaxhighlight>

que muestra un hash que identifica de forma única el contenedor lanzado:

<syntaxhighlight lang="bash">
2ec1daae4676a4e84dc04fd91399c1dfe92119544ff12ee307991fe573d3db64
</syntaxhighlight>

Mediante el comando ''attach'' puedo entrar al contenedor:

<syntaxhighlight lang="bash">
podman attach 2ec1daae4676
</syntaxhighlight>

Para salir, pulsamos ''CTRL + P'' seguido de ''CTRL + Q''.

De manera similar, puedo lanzar en segundo plano la imagen de contenedor de ''hello-world'':

<syntaxhighlight lang="bash">
podman run -d hello-world
</syntaxhighlight>

Y consultar los logs:

<syntaxhighlight lang="bash">
podman logs b67fae3312bc321
</syntaxhighlight>

== Paso 5.3: Añadir variables de entorno a un contenedor ==

Utilizaremos la imagen anterior, y vamos a añadir una variable de entorno
llamada TEST que contenga el valor 'test'. A parte, también ejecutaremos la
terminal como antes, para comprobar con el comando echo, que la variable de
entorno está creada correctamente:

<syntaxhighlight lang="bash">
podman run -ti -e TEST=test debian bash
</syntaxhighlight>

Ahora, desde el contenedor podemos comprobar el valor de la variable de entorno ''$TEST''.

<syntaxhighlight lang="bash">
echo $TEST
test
</syntaxhighlight>

= Paso 6: Listar contenedores en ejecución =

Hemos estado haciendo pruebas y ejecutando contenedores en el paso anterior, vamos a ver donde se encuentran estos contenedores que hemos ejecutado, y después veremos algunas opciones más del comando run.

Tenemos dos opciones para ver los contenedores:

<syntaxhighlight lang="bash">
podman container ls -a
</syntaxhighlight>

o la versión corta:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Ambas hacen lo mismo, y debería de mostrarnos una salida similar a la siguiente:

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
e2bde5f5500c debian "bash" 6 minutes ago Exited (0) 2 seconds ago pensive_sammet
544ad27dbc3c debian "bash" 7 minutes ago Exited (0) 7 minutes ago serene_elgamal
</syntaxhighlight>

En la información veremos que el contenedor tiene el estado exited, eso quiere decir que no se está ejecutando y ya ha finalizado. Vamos a hacer una prueba para ver un contendor ejecutándose:

<syntaxhighlight lang="bash">
podman run -d debian sleep 30
</syntaxhighlight>

Con el comando sleep 30 esperamos 30 segundos hasta que termine el comando, asíque durante esos 30 segundos, el contenedor estará ejecutándose, veámoslo:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
eacceb27d52d debian "sleep 30" 12 seconds ago Up 11 seconds sharp_pasteur
</syntaxhighlight>

Vamos a ver alguna opciones más de la orden ''run''.

== Paso 6.1: Dar un nombre al contenedor (--name) ==

Por defecto, podman creará automáticamente un nombre como hemos visto en las salidas del comando ''podman ps -a''. Podemos establecer el nombre del contenedor que queramos con la opción ''--name'':

<syntaxhighlight lang="bash">
podman run -ti --name mi_debian debian
</syntaxhighlight>

== Paso 6.2: Eliminar contenedor cuando termine (--rm) ==

Vamos a mezclar todo lo visto anteriormente:

* Lanzar en segundo plano (-d)
* Ejecutar contenedor durante 30 segundos (sleep 30)
* Dar un nombre a la imagen (--name)
* Eliminar contenedor cuando termine (--rm)

<syntaxhighlight lang="bash">
podman run -d --rm --name bye-bye debian sleep 30
</syntaxhighlight>

Antes y una vez pasados los 30 segundos, podemos comprobar que el contenedor ha desaparecido.

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

= Paso 7: Parar y eliminar contenedores =

Para parar contenedores podemos usar el ID o su nombre:

<syntaxhighlight lang="bash">
podman stop my_container
podman stop e4901956f108
podman ps -a
</syntaxhighlight>

Una vez hemos comprobado que han terminado su ejecución, podemos eliminar los ficheros resultantes de su ejecución:

<syntaxhighlight lang="bash">
podman container rm my_container
</syntaxhighlight>

Para borrar todos los contenedores ya finalizados

<syntaxhighlight lang="bash">
podman container prune
</syntaxhighlight>

= Paso 8: Conectarnos a un contenedor que se está ejecutando en segundo plano =

Vamos a ejecutar de nuevo un contenedor que no termine:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a conectarnos a este contenedor que está ejecutándose en segundo
plano:

<syntaxhighlight lang="bash">
podman attach mi-contenedor
</syntaxhighlight>

Veremos la orden bash ejecutándose, para terminar, hacemos un 'CTRL + C', y ahora, veremos que ha pasado con el contenedor:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Lo veremos parado, por que lo que hemos hecho ha sido conectarnos al contenedor
y parar el comando que se estaba ejecutando, así que ahora tenemos el contenedor
finalizado.

''Nota:'' Para salir del contenedor '''sin detenerlo''' hacemos 'CTRL + P' seguido 'CTRL + Q'

= Paso 9: Ejecutar un comando dentro de un contenedor en ejecución =

Vamos a ver otresta vez como ejecutar un comando en un contenedor que ya está
ejecutándose:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a ejecutar un comando en ese contenedor con el nombre ''mi-contenedor''.
El comando exec es similar al comando run, pero para ejecutar un comando dentro de un contenedor:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor ls
</syntaxhighlight>

Para redirigir la salida a un fichero en el anfitrión:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor ls > x.txt
</syntaxhighlight>

Para redirigir la salida a un fichero ''dentro'' del contenedor, hacemos:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor sh -c "ls > x.txt"
</syntaxhighlight>

También es posible ejecutar comandos con tuberías:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor sh -c "ls -la | grep ^d"
</syntaxhighlight>

= Paso 10: Persistencia en contenedores =

Al hacer ''exit'' y salir de un contenedor, se pierden todos los cambios que hemos realizado. Los

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-ejemplo debian bash
</syntaxhighlight>

Ahora, vamos a crear una carpeta en el contenedor y comprobar que esa carpeta existe:

<syntaxhighlight lang="bash">
podman exec mi-ejemplo mkdir test
podman exec mi-ejemplo ls
</syntaxhighlight>

Veremos que la carpeta existe, pero, ¿qué ocurre si para el contenedor?

<syntaxhighlight lang="bash">
podman container stop mi-ejemplo
</syntaxhighlight>

Y volvemos a lanzarlo:

<syntaxhighlight lang="bash">
podman container rm mi-ejemplo
podman run -d -ti --name mi-ejemplo debian bash
podman exec mi-ejemplo ls
</syntaxhighlight>

Podemos comprobar que la carpeta creada anteriormente, no existe.

¿Qué podemos hacer para mantener la modificaciones realizadas sobre un contenedor?

== Paso 10.1: Crear una imagen derivada de la imagen base ==

Es posible crear una imagen derivada, con modificaciones, a partir de una imagen existente mediante la orden '''commit'''.

Por ejemplo, si queremos una imagen ''debian'' que incluya el programa ''ping'' ya instalado, tendríamos que lanzar un contenedor a partir de la imagen ''ubuntu'':

<syntaxhighlight lang="bash">
podman run -d -ti debian bash
</syntaxhighlight>

Suponiendo que el contenido está identificado con el ID 56ef5b312334

Instalamos el paquete ping:

<syntaxhighlight lang="bash">
podman exec 56ef5b312334 apt -y install ping
</syntaxhighlight>

Generamos la imagen derivada con el nombre ''ubuntu-con-ping'':

<syntaxhighlight lang="bash">
podman commit 56ef5b312334 ubuntu-con-ping
</syntaxhighlight>

Ya podemos para nuestro contendor:

<syntaxhighlight lang="bash">
podman stop 56ef5b312334
</syntaxhighlight>

Y lanzar un nuevo contenedor a partir de la imagen ''debian-con-ping'':

<syntaxhighlight lang="bash">
podman run -d -ti debian-con-ping bash
</syntaxhighlight>

== Paso 10.2: Mantener la persistencia mediante volúmen ==

Otra opción para mantener los datos es montar un volumen al ejecutar el contenedor.

Primero crearemos una carpeta que hará de volumen en nuestra máquina, que será la que luego montemos para podman:

<syntaxhighlight lang="bash">
mkdir /home/debian/volumen
</syntaxhighlight>

Ahora vamos a montar la carpeta al ejecutar el contenedor, lo hacemos con la
opción -v, la cual tiene 3 campos separados por ':':

# El volumen en nuestra máquina
# Donde se montará el volumen dentro del contenedor
# Opciones de mmontaje, por ejemplo rw (read and write) o ro (read only)

<syntaxhighlight lang="bash">
podman run --rm -ti -v /home/debian/volumen:/volumen:rw debian bash
mkdir /volumen/test
touch /volumen/test/file
exit
</syntaxhighlight>

Una vez nos salgamos del contenedor, podemos ver que en nuestra máquina están
los datos:

<syntaxhighlight lang="bash">
ls /home/ubuntu/volumen/
ls /home/ubuntu/volumen/test
</syntaxhighlight>

La próxima vez que ejecutemos un contenedor, si montamos ese volumen, los datos
estarán ahí, además esta forma tiene el beneficio de compartir datos entre
nuestra máquina y el contenedor de forma sencilla.

= Paso 11: Crear nuestra propia imagen de contenedor =

Para crear una imagen de un contenedor con una aplicación de Python hug, creamos en primer lugar la carpeta que contendrá los ficheros que nos permiten crear la imagen.

<syntaxhighlight lang="bash">
mkdir miapp
cd miapp
</syntaxhighlight>

Definimos un fichero ''Dockerfile'' para definir la imagen:

<syntaxhighlight lang="bash">
FROM ubuntu

RUN apt -y update
RUN apt -y upgrade
RUN apt -y install python3-hug
RUN mkdir /app
COPY endpoint.py /app
WORKDIR /app
CMD hug -f endpoint.py
</syntaxhighlight>

Alternativamente, puedes crear un [[Creando imagen propia usando Ubuntu de base|Dockerfile empleando la imagen de Ubuntu]] como base en lugar de Alpine.

Y añadimos el fichero ''endpoint.py'' que emplea el framework Python hug con el contenido siguiente:

<syntaxhighlight lang="bash">
import hug

@hug.get('/welcome')
def welcome(username="unknown"):
""" Say welcome to username """
return "Welcome " + username
</syntaxhighlight>

Este fichero es un ejemplo de uso de Python hug. Si hacemos una petición a /welcome?username="LSO", esto nos devolverá el mensaje "Welcome LSO".

Una vez tengamos los dos ficheros creados en nuestra máquina virtual, podemos construir nuestra imagen:

<syntaxhighlight lang="bash">
podman build -t app:v1 -f Dockerfile .
</syntaxhighlight>

Vamos a explicar para que sirve cada línea:

* FROM: servirá para basarnos en una imagen existente, en este caso, una imagen de python alpine, que contiene python y no ocupa mucho espacio
* ENV: para crear variables de entorno
* RUN: para ejecutar comandos, ya sea para crear una carpeta, instalar dependencias o cualquier otra opción que necesitemos
* COPY: para copiar datos desde nuestra máquina a la imagen
* WORKDIR: para cambiar el directorio de trabajo
* CMD: este comando será ejecutado por defecto al iniciar un contenedor a partir de esta imagen

Esto construirá una imagen podman basada en python:alpine, en la cual hemos
guardado nuestra pequeña aplicación y se va a ejecutar cuando ejecutemos un
contenedor basado en esa imagen. Para comprobar que la imagen se ha creado
correctamente, listamos las imagenes, y debería de aparecernos una imagen con
nombre 'app' y tag 'v1':

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen, y vamos a añadir una nueva
opción, -p 8001:8000. Esta opción hará que el puerto interno 8000 del contenedor
sea expuesto en el puerto 8001 de nuestra máquina:

<syntaxhighlight lang="bash">
podman run --name my-app --rm -d -p 8001:8000 app:v1
</syntaxhighlight>

''Nota:'' podman supone que la redirección de puerto es TCP, para una redirección de puertos UDP, puedes usar:

<syntaxhighlight lang="bash">
... -p 8001:8000/udp
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código. En nuestra
máquina haremos:

<syntaxhighlight lang="bash">
curl -X GET http://localhost:8001/welcome?username=LSO
</syntaxhighlight>

Comprobaremos que la salida del comando curl, es "Welcome LSO".

Antes de terminar, vamos a comprobar otro pequeño detalle que añadimos en
nuestra imagen, la variable de entorno USERNAME, vamos a comprobar que funciona:

<syntaxhighlight lang="bash">
podman exec -ti my-app ash
echo $USERNAME
</syntaxhighlight>

Funciona correctamente, pero al ejecutar el contenedor, podemos cambiar esta
variable de entorno como vimos en uno de los pasos anteriores:

<syntaxhighlight lang="bash">
podman run --rm -ti -e USERNAME=me app:v1 ash
echo $USERNAME
</syntaxhighlight>

Esto nos servirá para tener opciones por defecto y que el usuario pueda
cambiarlo a su antojo, como por ejemplo contraseñas u otros detalles.

= Paso 12: Eliminar imágenes =

Para borrar una imagen, puede hacer:

<syntaxhighlight lang="bash">
podman image rm hello-world
</syntaxhighlight>

= Paso 13: Varios podman a la vez (podman-compose) =

Antes de comenzar, vamos a parar todos los contenedores que tengamos abiertos,
para dejar el entorno de podman limpio, que nos vendrá bien para esta parte.

Cuando queremos ejecutar varios contenedores a la vez y que estén conectados
entre ellos fácilmente, utilizaremos podman-compose, donde con un fichero de
configuración simple en yaml, tendremos toda la configuración de lo que vamos a
ejecutar.

Primero vamos a instalar podman-compose:

<syntaxhighlight lang="bash">
sudo apt install podman-compose
</syntaxhighlight>

Ahora veamos un pequeño ejemplo donde explicaremos todos los detalles para crear
un podman-compose, en este caso, el nombre por defecto de los ficheros suele ser
podman-compose.yml, y el contenido será similar a:

<syntaxhighlight lang="bash">
version: '3'

services:
web:
container_name: web
restart: always
build:
context: .
ports:
- "8000:8000"
volumes:
- /home/ubuntu/volume:/volumen:rw
environment:
USERNAME: test
web2:
container_name: web2
build:
dockerfile: Dockerfile
context: .
depends_on:
- web
command: touch web2
web3:
container_name: web3
restart: on-failure
image: pstauffer/curl
depends_on:
- web
command: curl -X GET web:8000/welcome?username=web3
</syntaxhighlight>

En el podman-compose definimos diferentes servicios a ejecutar, en nuestro caso
hemos iniciado tres servicios diferentes, web, web2 y web3:

El primer servicio, web:

* container_name: para darle un nombre por defecto al contenedor cuando se cree
* restart: pueden ser:
** "no": si la máquina termina, no se vuelve a iniciar (opción por defecto)
** always: siempre que el contenedor termine, intenta iniciarse de nuevo
** on-failure: solo intenta reiniciarse si el contenedor termina con fallo
** unless-stopped: solo reinicia el contenedor si el usuario es el que lo termina
* Utilizará el fichero Dockerfile creado en el paso 11 para generar la imagen a usar.
* Expondrá el puerto 8000 del contenedor en el 8000 de nuestra máquina
* Montará un volumen, se hace de forma similar a la línea de comandos
* Creará una variable de entorno

El segundo servicio, web2:

* Utilizará el fichero Dockerfile también, la diferencia entre este y el primer servicio, es que si el nombre del Dockerfile cambia, tendremos que hacerlo de esta segunda forma, la primera por defecto solo buscará el fichero Dockerfile
* depends_on hará que para ejecutar este servicio, su dependencia tenga ya que estar iniciada
* Ejecutaremos un comando el cual sustituirá al comando de la imagen

El tercer servicio, web3:

* Utilizará la imagen ostauffer/curl que es un imagen mínima que contiene el comando curl
* restart: en este caso, hasta que el comando no se ejecute correctamente, se seguirá reiniciando el contenedor
* depends_on igual que el servicio 2, dependerá del servicio 1
* Ejecutaremos un comando para llamar desde el servicio 3 al servicio 1

== Paso 13.1: Construir podman-compose ==

En el caso de existir servicios que tengan Dockerfiles, esto hará que se construyan previamente, como hacer un podman build de cada uno de los servicios que contenga un Dockerfile:

<syntaxhighlight lang="bash">
podman-compose build
</syntaxhighlight>

Con esto se generarán las imágenes necesarias para ejecutar todos los servicios.

== Paso 13.2: Iniciar podman-compose ==

Para iniciar todos los servicios, ejecutaremos:

<syntaxhighlight lang="bash">
podman-compose up -d
</syntaxhighlight>

Después de esto podremos ver el logs de todos los servicios:

<syntaxhighlight lang="bash">
podman-compose logs -f
</syntaxhighlight>

Aquí veremos que el servicio 3 ha conseguido llamar correctamente al servicio 1.

Ahora veremos como podman-compose ha creado los contenedores:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

La salida será similar a la siguiente:

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
219a4118244c pstauffer/curl "curl -X GET web:800…" 6 seconds ago Exited (0) 3 seconds ago web3
c97e894cb3ae ubuntu_web2 "touch web2" 6 seconds ago Exited (0) 4 seconds ago web2
f35d034204fc ubuntu_web "/bin/sh -c 'hug -f …" 6 seconds ago Up 5 seconds 0.0.0.0:8000->8000/tcp web
</syntaxhighlight>

Aquí vemos varios detalles:

* El nombre que le hemos dado en el podman-compose ha funcionado correctamente
* Vemos que los comandos son los correctos también
* web2 está parado por que la política de reinicio es apagar cuando se termine de ejecutar un comando
* web 3 está parado por que el comando ha terminado con un salida correcta

Vamos a comprobar ahora que en el servicio web está todo correcto:

<syntaxhighlight lang="bash">
podman exec -ti web ash
echo $USERNAME
ls /volumen
exit
</syntaxhighlight>

Podemos comprobar que tanto cambiar la variable de entorno como crear un
volumen ha funcionado correctamente.

== Paso 13.3: Parar podman-compose ==

Para parar todos los servicios:

<syntaxhighlight lang="bash">
podman-compose down
</syntaxhighlight>

Comprobamos:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Vemos que han desaparecido todos los contenedores.

= Paso 14: Ejercicios =

== Ejercicio 1: Image derivada de Debian con el programa sl ==

Lance un contenedor a partir de una imagen de Debian, instale el programa sl, ejecute sl (desde fuera del contenedor) y detenga el contenedor.

== Ejercicio 2 ==

== Ejercicio 3: Variante de httpd ==

Construya una imagen ''httpd-hola-mundo'' a partir de la imagen ''httpd''. El fichero de index.html de la carpeta htdocs/ tiene que mostrar el mensaje "hola mundo".

<syntaxhighlight lang="bash">
podman pull httpd
</syntaxhighlight>

Edita el fichero Dockerfile:

<syntaxhighlight lang="bash">
nano Dockerfile
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
FROM httpd

COPY index.html htdocs/index.html
</syntaxhighlight>

Edita el fichero index.html:

<syntaxhighlight lang="bash">
nano index.html
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

Construye la imagen:

<syntaxhighlight lang="bash">
podman build -t mihttpd -f Dockerfile .
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen:

<syntaxhighlight lang="bash">
podman run --name mihttpd -d -p 8080:80 mihttpd
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código:
<syntaxhighlight lang="bash">
curl -X GET http://localhost:8080
</syntaxhighlight>

Tiene que salir por pantalla esto:
<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

== Ejercicio 4: aplicación flask ==

Flask es un framework python para implementar webs. Cree una imagen "miapp-flask" a partir de la imagen de "python":

* Instale flask mediante: pip install flask
* Cree la carpeta "app"
* Establezca la variable FLASK_APP a "hello.py"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"

El fichero hello.py contiene un "hola mundo" para Flask:

<syntaxhighlight lang="python">
from flask import Flask
app = Flask(__name__)

@app.route("/")
def hello():
return "Hello World!"

if __name__ == "__main__":
app.run()
</syntaxhighlight>

Solución con alpine:

<syntaxhighlight lang="bash">
FROM python:alpine

RUN mkdir /app
RUN pip install flask
ENV FLASK_APP="app/hello.py"
COPY hello.py
WORKDIR /
CMD flask run --host=0.0.0.0
</syntaxhighlight>

Solución con Ubuntu:

<syntaxhighlight lang="bash">
FROM ubuntu:bionic

RUN apt-get update
RUN apt-get -y install python python-pip wget
RUN pip install Flask
ENV FLASK_APP="app/hello.py"
RUN mkdir /app
COPY hello.py /app
CMD flask run --host=0.0.0.0
</syntaxhighlight>

== Ejercicio 5: mysql ==

'''EN LA MÁQUINA VIRTUAL:'''

mkdir miapp
cd miapp
podman pull mysql
nano Dockerfile

<syntaxhighlight lang="bash">
FROM mysql
ENV MYSQL_ROOT_PASSWORD="lacontraseñaqueyoquiera"
RUN mkdir /app
WORKDIR /app

</syntaxhighlight>

CTRL+O , ENTER Y CTRL+X (para guardar Dockerfile y salir)

podman build -ti mrfdocker -f Dockerfile .
podman run --name mymrf --rm -p 8001:3306 mrfdocker
docker images

'''EN LA TERMINAL DEL HOST:'''

''Instalación de mysql:''

apt install mysql-client-core-5.7
apt-get install mysql-server
service mysql start

''Para entrar:''

mysql -u root -p -P 8001

Una vez dentro de msql:

mysql> show databases;

''Para salir:''

exit

== Ejercicio 6: python pyramid ==

Pyramid es un framework python para implementar webs. Cree una imagen "miapp-pyramid":

* Emplee la imagen de Ubuntu como referencia, instale los paquetes python y python-pip.
* Instale Pyramid mediante: pip install pyramid
* Cree la carpeta "app"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"
* La aplicación se lanza con la orden: python hello.py
* Compruebe que funciona con curl, la ruta a la web es http://127.0.0.1:8000/hello, suponiendo que ha empleado el puerto 8000 para exponer el servicio.

El fichero hello.py contiene un "hola mundo" para Pyramid:

<syntaxhighlight lang="bash">
from wsgiref.simple_server import make_server
from pyramid.config import Configurator
from pyramid.response import Response

def hello_world(request):
print('Request inbound!')
return Response('Podman works with Pyramid!')

if __name__ == '__main__':
config = Configurator()
config.add_route('hello', '/')
config.add_view(hello_world, route_name='hello')
app = config.make_wsgi_app()
server = make_server('0.0.0.0', 6543, app)
server.serve_forever()
</syntaxhighlight>

Este programa recibe peticiones en el puerto 6543.

== Ejercicio 7 ==

Cree una imagen derivada de Ubuntu, instale el paquete apache2, php y libapache2-mod-php.
Active el módulo de php para apache2 mediante la orden:

<syntaxhighlight lang="bash">
a2enmod php
</syntaxhighlight>

Cree la carpeta /var/www/php.

Cree el fichero index.php

<syntaxhighlight lang="php">
<?php
Print "Hello, World!";
?>
</syntaxhighlight>

y copielo a /var/www/php/.

Cree el fichero 000-default.conf y copielo a /etc/apache2/sites-enabled/

Dicho fichero contiene.

<syntaxhighlight lang="bash">
<VirtualHost *:80>
DocumentRoot /var/www/php

<Directory /var/www/php/>
Options Indexes FollowSymLinks MultiViews
AllowOverride All
Order deny,allow
Allow from all
</Directory>

ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>
</syntaxhighlight>

Tiene que lanzar apache con la orden: apachectl -D FOREGROUND

Tras crear la imagen, láncela mapeando el puerto 8888 al 80, pruebe que puede acceder a http://127.0.0.1:8888/php/ mediante curl

Solución:

<syntaxhighlight lang="bash">
FROM ubuntu:latest

RUN apt-get update
RUN apt-get install -y tzdata
RUN apt-get install -y apache2
RUN apt-get install -y php
RUN apt-get install -y libapache2-mod-php
RUN a2enmod php7.2
COPY index.php /var/www/php
COPY 000-default.conf /etc/apache2/sites-enabled/
CMD apachectl -D FOREGROUND
</syntaxhighlight>

Y para lanzarlo:

podman run --name my-app --rm -d -p 8001:8000 app:v1

y para probarlo:

curl -X GET http://127.0.0.1:8888/php/

== Ejercicio 8 ==

Instale el paquete ''netcat-traditional'' en una imagen de contenedor de ''ubuntu''. Lance la orden:

nc -u -l -p 8080

en el contenedor. Asegúrese de crear una redirección de puertos de 9999 desde el ''host'' al puerto 8080 en el contenedor.

Desde fuera del contenedor, pruebe a conectarse con:

nc -u 127.0.0.1 9999

== Ejercicio 9 ==

Cree una imagen derivada de "ubuntu" con un Dockerfile que incluya soporte de python y lance el siguiente código en Python:

<syntaxhighlight lang="python">
from http.server import BaseHTTPRequestHandler, HTTPServer
import time

hostName = "0.0.0.0"
serverPort = 8080

class MyServer(BaseHTTPRequestHandler):
def do_GET(self):
self.send_response(200)
self.send_header("Content-type", "text/html")
self.end_headers()
self.wfile.write(bytes("<html><head><title>Welcome!</title></head>", "utf-8"))
self.wfile.write(bytes("<body>", "utf-8"))
self.wfile.write(bytes("This is an example web server.", "utf-8"))
self.wfile.write(bytes("</body></html>", "utf-8"))

if __name__ == "__main__":
webServer = HTTPServer((hostName, serverPort), MyServer)
print("Server started http://%s:%s" % (hostName, serverPort))

try:
webServer.serve_forever()
except KeyboardInterrupt:
pass

webServer.server_close()
print("Server stopped.")
</syntaxhighlight>

Llame a su imagen "python-http-server". Lance una instancia de la imagen "python-http-server" mapeando el puerto 9999 al puerto 8888/tcp del contenedor. Compruebe con:

<syntaxhighlight lang="bash">
curl http://127.0.0.1:9999/
</syntaxhighlight>

que muestre la página HTML que ofrece el servidor, que debería ser:

<syntaxhighlight lang="bash">
<html><head><title>Welcome!</title></head><body>This is an example web server.</body></html>
</syntaxhighlight>

Contenedores

2025-12-11T08:43:57Z

Pneira: /* Paso 1: Instalar podman */

En esta práctica aprenderemos a utilizar [https://es.wikipedia.org/wiki/Podman podman] para desplegar contenedores.

= Paso 1: Instalar podman =

Para instalar el paquete oficial:

<syntaxhighlight lang="bash">
apt install podman
</syntaxhighlight>

podman es un clon de '''docker''.

Si añade un usuario 'test' a su sistema con:

<syntaxhighlight lang="bash">
adduser test
</syntaxhighlight>

recuerde hacer:

<syntaxhighlight lang="bash">
loginctl enable-linger test
systemctl start --user dbus
</syntaxhighlight>

= Paso 2: Repositorio de imágenes de contenedores DockerHub =

Docker ofrece un servicio de nube denominado ''DockerHub'' que puede ser empleado como red social para compartir tus imágenes de Podman. En ''DockerHub'' existen además imágenes de contenedores preconfiguradas de software, muchas de ellas oficiales (ofrecidas por el propio fabricante del software) que se podrán emplear como base para construir nuevas imágenes adaptadas a nuestras necesidades.

Podremos realizar búsquedas en este repositorio ''DockerHub'' puedes emplear el siguiente comando:

<syntaxhighlight lang="bash">
podman search docker.io/library/hello-world
</syntaxhighlight>

Para descargarnos la imagen de ''hello-world'' podemos usar la orden ''pull'':

<syntaxhighlight lang="bash">
podman pull docker.io/library/hello-world
</syntaxhighlight>

También podemos publicar imágenes propias, esto require '''registro de usuario''' en la nube de ''DockerHub'', lo que '''no''' es obligatorio para la realización de esta práctica. Para subir una imagen, hay que validarse como usuario en la nube de ''DockerHub'':

<syntaxhighlight lang="bash">
podman login
</syntaxhighlight>

Tras introducir tu usuario y contraseña, puedes comenzar a publicar tus propias imágenes.

<syntaxhighlight lang="bash">
podman push MI_IMAGEN
</syntaxhighlight>

Este paso es '''opcional''', sólo en caso de que se quieran subir imágenes de contenedores a la nube de docker.io.

= Paso 4: Comprobar imágenes en nuestra máquina =

Para ver las imágenes que tenemos en nuestra máquina, utilizaremos el comando:

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Inicialmente, no tenemos imágenes en almacenamiento, podemos descargarnos la imagen oficial de Debian 13 (Trixie):

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian
</syntaxhighlight>

Ahora si, ya debería de aparecernos la imagen ''debian''.

Comentar también que cada imagen puede tener varias etiquetas, por ejemplo, la imagen Debian 12 (Bookworm), cuando la hemos visto en el listado de imágenes, venía con el tag latest, que es el tag que se descarga por defecto, pero nosotros podemos especificar otro, por ejemplo:

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian:bookworm
</syntaxhighlight>

Para traernos la versión de la imagen de Debian 12 ''Bookworm''.

Ahora tendremos dos imágenes con diferente etiqueta, que serían como las diferentes versiones de cada imagen.

= Paso 5: Lanzar un contenedor =

Un contenedor no es más que una imagen de podman ejecutándose, sería similar a
una máquina virtual, aunque mucho más liviano.

Para crear un contenedor, utilizaremos una imagen, en este caso, la imagen
hello-world. Hacemos lo siguiente:

<syntaxhighlight lang="bash">
podman run hello-world
</syntaxhighlight>

Esto nos mostrará el siguiente mensaje si todo está correcto:

<syntaxhighlight lang="bash">
Hello from Docker!
This message shows that your installation appears to be working correctly.

To generate this message, Docker took the following steps:
1. The Docker client contacted the Docker daemon.
2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
(amd64)
3. The Docker daemon created a new container from that image which runs the
executable that produces the output you are currently reading.
4. The Docker daemon streamed that output to the Docker client, which sent it
to your terminal.

To try something more ambitious, you can run an Debian container with:
$ podman run -it debian bash

Share images, automate workflows, and more with a free Docker ID:
https://hub.docker.com/

For more examples and ideas, visit:
https://docs.docker.com/get-started/
</syntaxhighlight>

Al crear los contenedores utilizando el comando 'run', tenemos varias opciones:

* Lanzar una terminal en el contenedor en modo interactivo
* Lanzar en segundo plano y conectarnos posteriormente al contenedor

== Paso 5.1: Lanzar una terminal en el contenedor en modo interactivo (-ti) ==

Para este ejemplo vamos a utilizar otra imagen diferente, en este caso vamos a utilizar una imagen de debian.

Vamos a lanzar un contenedor y ejecutar una terminal en el que se va a ejecutar el programa '''bash''' que me ofrece un interprete de órdenes:

<syntaxhighlight lang="bash">
podman run -ti debian bash
</syntaxhighlight>

La opción ''-t'' indica que se crea un terminal en el contenedor. Y la opción ''-i'' indica que el contenedor se ejecuta en modo interactivo.

Al acceder al contenedor de ''debian'' nos aparece un ''hash'' en el prompt de la shell, que identifica a la instancia del contenedor (es valor es similar al que muestra la orden ''podman container ls'').

Para salir del contenedor, escribimos 'exit' o pulsamos ''CTRL + D''

== Paso 5.2 Lanzar en segundo plano (-d) ==

Otro ejemplo, con la imagen de Debian:

<syntaxhighlight lang="bash">
podman run -dti debian
</syntaxhighlight>

que muestra un hash que identifica de forma única el contenedor lanzado:

<syntaxhighlight lang="bash">
2ec1daae4676a4e84dc04fd91399c1dfe92119544ff12ee307991fe573d3db64
</syntaxhighlight>

Mediante el comando ''attach'' puedo entrar al contenedor:

<syntaxhighlight lang="bash">
podman attach 2ec1daae4676
</syntaxhighlight>

Para salir, pulsamos ''CTRL + P'' seguido de ''CTRL + Q''.

De manera similar, puedo lanzar en segundo plano la imagen de contenedor de ''hello-world'':

<syntaxhighlight lang="bash">
podman run -d hello-world
</syntaxhighlight>

Y consultar los logs:

<syntaxhighlight lang="bash">
podman logs b67fae3312bc321
</syntaxhighlight>

== Paso 5.3: Añadir variables de entorno a un contenedor ==

Utilizaremos la imagen anterior, y vamos a añadir una variable de entorno
llamada TEST que contenga el valor 'test'. A parte, también ejecutaremos la
terminal como antes, para comprobar con el comando echo, que la variable de
entorno está creada correctamente:

<syntaxhighlight lang="bash">
podman run -ti -e TEST=test debian bash
</syntaxhighlight>

Ahora, desde el contenedor podemos comprobar el valor de la variable de entorno ''$TEST''.

<syntaxhighlight lang="bash">
echo $TEST
test
</syntaxhighlight>

= Paso 6: Listar contenedores en ejecución =

Hemos estado haciendo pruebas y ejecutando contenedores en el paso anterior, vamos a ver donde se encuentran estos contenedores que hemos ejecutado, y después veremos algunas opciones más del comando run.

Tenemos dos opciones para ver los contenedores:

<syntaxhighlight lang="bash">
podman container ls -a
</syntaxhighlight>

o la versión corta:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Ambas hacen lo mismo, y debería de mostrarnos una salida similar a la siguiente:

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
e2bde5f5500c debian "bash" 6 minutes ago Exited (0) 2 seconds ago pensive_sammet
544ad27dbc3c debian "bash" 7 minutes ago Exited (0) 7 minutes ago serene_elgamal
</syntaxhighlight>

En la información veremos que el contenedor tiene el estado exited, eso quiere decir que no se está ejecutando y ya ha finalizado. Vamos a hacer una prueba para ver un contendor ejecutándose:

<syntaxhighlight lang="bash">
podman run -d debian sleep 30
</syntaxhighlight>

Con el comando sleep 30 esperamos 30 segundos hasta que termine el comando, asíque durante esos 30 segundos, el contenedor estará ejecutándose, veámoslo:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
eacceb27d52d debian "sleep 30" 12 seconds ago Up 11 seconds sharp_pasteur
</syntaxhighlight>

Vamos a ver alguna opciones más de la orden ''run''.

== Paso 6.1: Dar un nombre al contenedor (--name) ==

Por defecto, podman creará automáticamente un nombre como hemos visto en las salidas del comando ''podman ps -a''. Podemos establecer el nombre del contenedor que queramos con la opción ''--name'':

<syntaxhighlight lang="bash">
podman run -ti --name mi_debian debian
</syntaxhighlight>

== Paso 6.2: Eliminar contenedor cuando termine (--rm) ==

Vamos a mezclar todo lo visto anteriormente:

* Lanzar en segundo plano (-d)
* Ejecutar contenedor durante 30 segundos (sleep 30)
* Dar un nombre a la imagen (--name)
* Eliminar contenedor cuando termine (--rm)

<syntaxhighlight lang="bash">
podman run -d --rm --name bye-bye debian sleep 30
</syntaxhighlight>

Antes y una vez pasados los 30 segundos, podemos comprobar que el contenedor ha desaparecido.

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

= Paso 7: Parar y eliminar contenedores =

Para parar contenedores podemos usar el ID o su nombre:

<syntaxhighlight lang="bash">
podman stop my_container
podman stop e4901956f108
podman ps -a
</syntaxhighlight>

Una vez hemos comprobado que han terminado su ejecución, podemos eliminar los ficheros resultantes de su ejecución:

<syntaxhighlight lang="bash">
podman container rm my_container
</syntaxhighlight>

Para borrar todos los contenedores ya finalizados

<syntaxhighlight lang="bash">
podman container prune
</syntaxhighlight>

= Paso 8: Conectarnos a un contenedor que se está ejecutando en segundo plano =

Vamos a ejecutar de nuevo un contenedor que no termine:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a conectarnos a este contenedor que está ejecutándose en segundo
plano:

<syntaxhighlight lang="bash">
podman attach mi-contenedor
</syntaxhighlight>

Veremos la orden bash ejecutándose, para terminar, hacemos un 'CTRL + C', y ahora, veremos que ha pasado con el contenedor:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Lo veremos parado, por que lo que hemos hecho ha sido conectarnos al contenedor
y parar el comando que se estaba ejecutando, así que ahora tenemos el contenedor
finalizado.

''Nota:'' Para salir del contenedor '''sin detenerlo''' hacemos 'CTRL + P' seguido 'CTRL + Q'

= Paso 9: Ejecutar un comando dentro de un contenedor en ejecución =

Vamos a ver otresta vez como ejecutar un comando en un contenedor que ya está
ejecutándose:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a ejecutar un comando en ese contenedor con el nombre ''mi-contenedor''.
El comando exec es similar al comando run, pero para ejecutar un comando dentro de un contenedor:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor ls
</syntaxhighlight>

Para redirigir la salida a un fichero en el anfitrión:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor ls > x.txt
</syntaxhighlight>

Para redirigir la salida a un fichero ''dentro'' del contenedor, hacemos:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor sh -c "ls > x.txt"
</syntaxhighlight>

También es posible ejecutar comandos con tuberías:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor sh -c "ls -la | grep ^d"
</syntaxhighlight>

= Paso 10: Persistencia en contenedores =

Al hacer ''exit'' y salir de un contenedor, se pierden todos los cambios que hemos realizado. Los

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-ejemplo debian bash
</syntaxhighlight>

Ahora, vamos a crear una carpeta en el contenedor y comprobar que esa carpeta existe:

<syntaxhighlight lang="bash">
podman exec mi-ejemplo mkdir test
podman exec mi-ejemplo ls
</syntaxhighlight>

Veremos que la carpeta existe, pero, ¿qué ocurre si para el contenedor?

<syntaxhighlight lang="bash">
podman container stop mi-ejemplo
</syntaxhighlight>

Y volvemos a lanzarlo:

<syntaxhighlight lang="bash">
podman container rm mi-ejemplo
podman run -d -ti --name mi-ejemplo debian bash
podman exec mi-ejemplo ls
</syntaxhighlight>

Podemos comprobar que la carpeta creada anteriormente, no existe.

¿Qué podemos hacer para mantener la modificaciones realizadas sobre un contenedor?

== Paso 10.1: Crear una imagen derivada de la imagen base ==

Es posible crear una imagen derivada, con modificaciones, a partir de una imagen existente mediante la orden '''commit'''.

Por ejemplo, si queremos una imagen ''debian'' que incluya el programa ''ping'' ya instalado, tendríamos que lanzar un contenedor a partir de la imagen ''ubuntu'':

<syntaxhighlight lang="bash">
podman run -d -ti debian bash
</syntaxhighlight>

Suponiendo que el contenido está identificado con el ID 56ef5b312334

Instalamos el paquete ping:

<syntaxhighlight lang="bash">
podman exec 56ef5b312334 apt -y install ping
</syntaxhighlight>

Generamos la imagen derivada con el nombre ''ubuntu-con-ping'':

<syntaxhighlight lang="bash">
podman commit 56ef5b312334 ubuntu-con-ping
</syntaxhighlight>

Ya podemos para nuestro contendor:

<syntaxhighlight lang="bash">
podman stop 56ef5b312334
</syntaxhighlight>

Y lanzar un nuevo contenedor a partir de la imagen ''debian-con-ping'':

<syntaxhighlight lang="bash">
podman run -d -ti debian-con-ping bash
</syntaxhighlight>

== Paso 10.2: Mantener la persistencia mediante volúmen ==

Otra opción para mantener los datos es montar un volumen al ejecutar el contenedor.

Primero crearemos una carpeta que hará de volumen en nuestra máquina, que será la que luego montemos para podman:

<syntaxhighlight lang="bash">
mkdir /home/debian/volumen
</syntaxhighlight>

Ahora vamos a montar la carpeta al ejecutar el contenedor, lo hacemos con la
opción -v, la cual tiene 3 campos separados por ':':

# El volumen en nuestra máquina
# Donde se montará el volumen dentro del contenedor
# Opciones de mmontaje, por ejemplo rw (read and write) o ro (read only)

<syntaxhighlight lang="bash">
podman run --rm -ti -v /home/debian/volumen:/volumen:rw debian bash
mkdir /volumen/test
touch /volumen/test/file
exit
</syntaxhighlight>

Una vez nos salgamos del contenedor, podemos ver que en nuestra máquina están
los datos:

<syntaxhighlight lang="bash">
ls /home/ubuntu/volumen/
ls /home/ubuntu/volumen/test
</syntaxhighlight>

La próxima vez que ejecutemos un contenedor, si montamos ese volumen, los datos
estarán ahí, además esta forma tiene el beneficio de compartir datos entre
nuestra máquina y el contenedor de forma sencilla.

= Paso 11: Crear nuestra propia imagen de contenedor =

Para crear una imagen de un contenedor con una aplicación de Python hug, creamos en primer lugar la carpeta que contendrá los ficheros que nos permiten crear la imagen.

<syntaxhighlight lang="bash">
mkdir miapp
cd miapp
</syntaxhighlight>

Definimos un fichero ''Dockerfile'' para definir la imagen:

<syntaxhighlight lang="bash">
FROM ubuntu

RUN apt -y update
RUN apt -y upgrade
RUN apt -y install python3-hug
RUN mkdir /app
COPY endpoint.py /app
WORKDIR /app
CMD hug -f endpoint.py
</syntaxhighlight>

Alternativamente, puedes crear un [[Creando imagen propia usando Ubuntu de base|Dockerfile empleando la imagen de Ubuntu]] como base en lugar de Alpine.

Y añadimos el fichero ''endpoint.py'' que emplea el framework Python hug con el contenido siguiente:

<syntaxhighlight lang="bash">
import hug

@hug.get('/welcome')
def welcome(username="unknown"):
""" Say welcome to username """
return "Welcome " + username
</syntaxhighlight>

Este fichero es un ejemplo de uso de Python hug. Si hacemos una petición a /welcome?username="LSO", esto nos devolverá el mensaje "Welcome LSO".

Una vez tengamos los dos ficheros creados en nuestra máquina virtual, podemos construir nuestra imagen:

<syntaxhighlight lang="bash">
podman build -t app:v1 -f Dockerfile .
</syntaxhighlight>

Vamos a explicar para que sirve cada línea:

* FROM: servirá para basarnos en una imagen existente, en este caso, una imagen de python alpine, que contiene python y no ocupa mucho espacio
* ENV: para crear variables de entorno
* RUN: para ejecutar comandos, ya sea para crear una carpeta, instalar dependencias o cualquier otra opción que necesitemos
* COPY: para copiar datos desde nuestra máquina a la imagen
* WORKDIR: para cambiar el directorio de trabajo
* CMD: este comando será ejecutado por defecto al iniciar un contenedor a partir de esta imagen

Esto construirá una imagen podman basada en python:alpine, en la cual hemos
guardado nuestra pequeña aplicación y se va a ejecutar cuando ejecutemos un
contenedor basado en esa imagen. Para comprobar que la imagen se ha creado
correctamente, listamos las imagenes, y debería de aparecernos una imagen con
nombre 'app' y tag 'v1':

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen, y vamos a añadir una nueva
opción, -p 8001:8000. Esta opción hará que el puerto interno 8000 del contenedor
sea expuesto en el puerto 8001 de nuestra máquina:

<syntaxhighlight lang="bash">
podman run --name my-app --rm -d -p 8001:8000 app:v1
</syntaxhighlight>

''Nota:'' podman supone que la redirección de puerto es TCP, para una redirección de puertos UDP, puedes usar:

<syntaxhighlight lang="bash">
... -p 8001:8000/udp
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código. En nuestra
máquina haremos:

<syntaxhighlight lang="bash">
curl -X GET http://localhost:8001/welcome?username=LSO
</syntaxhighlight>

Comprobaremos que la salida del comando curl, es "Welcome LSO".

Antes de terminar, vamos a comprobar otro pequeño detalle que añadimos en
nuestra imagen, la variable de entorno USERNAME, vamos a comprobar que funciona:

<syntaxhighlight lang="bash">
podman exec -ti my-app ash
echo $USERNAME
</syntaxhighlight>

Funciona correctamente, pero al ejecutar el contenedor, podemos cambiar esta
variable de entorno como vimos en uno de los pasos anteriores:

<syntaxhighlight lang="bash">
podman run --rm -ti -e USERNAME=me app:v1 ash
echo $USERNAME
</syntaxhighlight>

Esto nos servirá para tener opciones por defecto y que el usuario pueda
cambiarlo a su antojo, como por ejemplo contraseñas u otros detalles.

= Paso 12: Eliminar imágenes =

Para borrar una imagen, puede hacer:

<syntaxhighlight lang="bash">
podman image rm hello-world
</syntaxhighlight>

= Paso 13: Varios podman a la vez (podman-compose) =

Antes de comenzar, vamos a parar todos los contenedores que tengamos abiertos,
para dejar el entorno de podman limpio, que nos vendrá bien para esta parte.

Cuando queremos ejecutar varios contenedores a la vez y que estén conectados
entre ellos fácilmente, utilizaremos podman-compose, donde con un fichero de
configuración simple en yaml, tendremos toda la configuración de lo que vamos a
ejecutar.

Primero vamos a instalar podman-compose:

<syntaxhighlight lang="bash">
sudo apt install podman-compose
</syntaxhighlight>

Ahora veamos un pequeño ejemplo donde explicaremos todos los detalles para crear
un podman-compose, en este caso, el nombre por defecto de los ficheros suele ser
podman-compose.yml, y el contenido será similar a:

<syntaxhighlight lang="bash">
version: '3'

services:
web:
container_name: web
restart: always
build:
context: .
ports:
- "8000:8000"
volumes:
- /home/ubuntu/volume:/volumen:rw
environment:
USERNAME: test
web2:
container_name: web2
build:
dockerfile: Dockerfile
context: .
depends_on:
- web
command: touch web2
web3:
container_name: web3
restart: on-failure
image: pstauffer/curl
depends_on:
- web
command: curl -X GET web:8000/welcome?username=web3
</syntaxhighlight>

En el podman-compose definimos diferentes servicios a ejecutar, en nuestro caso
hemos iniciado tres servicios diferentes, web, web2 y web3:

El primer servicio, web:

* container_name: para darle un nombre por defecto al contenedor cuando se cree
* restart: pueden ser:
** "no": si la máquina termina, no se vuelve a iniciar (opción por defecto)
** always: siempre que el contenedor termine, intenta iniciarse de nuevo
** on-failure: solo intenta reiniciarse si el contenedor termina con fallo
** unless-stopped: solo reinicia el contenedor si el usuario es el que lo termina
* Utilizará el fichero Dockerfile creado en el paso 11 para generar la imagen a usar.
* Expondrá el puerto 8000 del contenedor en el 8000 de nuestra máquina
* Montará un volumen, se hace de forma similar a la línea de comandos
* Creará una variable de entorno

El segundo servicio, web2:

* Utilizará el fichero Dockerfile también, la diferencia entre este y el primer servicio, es que si el nombre del Dockerfile cambia, tendremos que hacerlo de esta segunda forma, la primera por defecto solo buscará el fichero Dockerfile
* depends_on hará que para ejecutar este servicio, su dependencia tenga ya que estar iniciada
* Ejecutaremos un comando el cual sustituirá al comando de la imagen

El tercer servicio, web3:

* Utilizará la imagen ostauffer/curl que es un imagen mínima que contiene el comando curl
* restart: en este caso, hasta que el comando no se ejecute correctamente, se seguirá reiniciando el contenedor
* depends_on igual que el servicio 2, dependerá del servicio 1
* Ejecutaremos un comando para llamar desde el servicio 3 al servicio 1

== Paso 13.1: Construir podman-compose ==

En el caso de existir servicios que tengan Dockerfiles, esto hará que se construyan previamente, como hacer un podman build de cada uno de los servicios que contenga un Dockerfile:

<syntaxhighlight lang="bash">
podman-compose build
</syntaxhighlight>

Con esto se generarán las imágenes necesarias para ejecutar todos los servicios.

== Paso 13.2: Iniciar podman-compose ==

Para iniciar todos los servicios, ejecutaremos:

<syntaxhighlight lang="bash">
podman-compose up -d
</syntaxhighlight>

Después de esto podremos ver el logs de todos los servicios:

<syntaxhighlight lang="bash">
podman-compose logs -f
</syntaxhighlight>

Aquí veremos que el servicio 3 ha conseguido llamar correctamente al servicio 1.

Ahora veremos como podman-compose ha creado los contenedores:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

La salida será similar a la siguiente:

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
219a4118244c pstauffer/curl "curl -X GET web:800…" 6 seconds ago Exited (0) 3 seconds ago web3
c97e894cb3ae ubuntu_web2 "touch web2" 6 seconds ago Exited (0) 4 seconds ago web2
f35d034204fc ubuntu_web "/bin/sh -c 'hug -f …" 6 seconds ago Up 5 seconds 0.0.0.0:8000->8000/tcp web
</syntaxhighlight>

Aquí vemos varios detalles:

* El nombre que le hemos dado en el podman-compose ha funcionado correctamente
* Vemos que los comandos son los correctos también
* web2 está parado por que la política de reinicio es apagar cuando se termine de ejecutar un comando
* web 3 está parado por que el comando ha terminado con un salida correcta

Vamos a comprobar ahora que en el servicio web está todo correcto:

<syntaxhighlight lang="bash">
podman exec -ti web ash
echo $USERNAME
ls /volumen
exit
</syntaxhighlight>

Podemos comprobar que tanto cambiar la variable de entorno como crear un
volumen ha funcionado correctamente.

== Paso 13.3: Parar podman-compose ==

Para parar todos los servicios:

<syntaxhighlight lang="bash">
podman-compose down
</syntaxhighlight>

Comprobamos:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Vemos que han desaparecido todos los contenedores.

= Paso 14: Ejercicios =

== Ejercicio 1: Image derivada de Debian con el programa sl ==

Lance un contenedor a partir de una imagen de Debian, instale el programa sl, ejecute sl (desde fuera del contenedor) y detenga el contenedor.

== Ejercicio 2 ==

== Ejercicio 3: Variante de httpd ==

Construya una imagen ''httpd-hola-mundo'' a partir de la imagen ''httpd''. El fichero de index.html de la carpeta htdocs/ tiene que mostrar el mensaje "hola mundo".

<syntaxhighlight lang="bash">
podman pull httpd
</syntaxhighlight>

Edita el fichero Dockerfile:

<syntaxhighlight lang="bash">
nano Dockerfile
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
FROM httpd

COPY index.html htdocs/index.html
</syntaxhighlight>

Edita el fichero index.html:

<syntaxhighlight lang="bash">
nano index.html
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

Construye la imagen:

<syntaxhighlight lang="bash">
podman build -t mihttpd -f Dockerfile .
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen:

<syntaxhighlight lang="bash">
podman run --name mihttpd -d -p 8080:80 mihttpd
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código:
<syntaxhighlight lang="bash">
curl -X GET http://localhost:8080
</syntaxhighlight>

Tiene que salir por pantalla esto:
<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

== Ejercicio 4: aplicación flask ==

Flask es un framework python para implementar webs. Cree una imagen "miapp-flask" a partir de la imagen de "python":

* Instale flask mediante: pip install flask
* Cree la carpeta "app"
* Establezca la variable FLASK_APP a "hello.py"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"

El fichero hello.py contiene un "hola mundo" para Flask:

<syntaxhighlight lang="python">
from flask import Flask
app = Flask(__name__)

@app.route("/")
def hello():
return "Hello World!"

if __name__ == "__main__":
app.run()
</syntaxhighlight>

Solución con alpine:

<syntaxhighlight lang="bash">
FROM python:alpine

RUN mkdir /app
RUN pip install flask
ENV FLASK_APP="app/hello.py"
COPY hello.py
WORKDIR /
CMD flask run --host=0.0.0.0
</syntaxhighlight>

Solución con Ubuntu:

<syntaxhighlight lang="bash">
FROM ubuntu:bionic

RUN apt-get update
RUN apt-get -y install python python-pip wget
RUN pip install Flask
ENV FLASK_APP="app/hello.py"
RUN mkdir /app
COPY hello.py /app
CMD flask run --host=0.0.0.0
</syntaxhighlight>

== Ejercicio 5: mysql ==

'''EN LA MÁQUINA VIRTUAL:'''

mkdir miapp
cd miapp
podman pull mysql
nano Dockerfile

<syntaxhighlight lang="bash">
FROM mysql
ENV MYSQL_ROOT_PASSWORD="lacontraseñaqueyoquiera"
RUN mkdir /app
WORKDIR /app

</syntaxhighlight>

CTRL+O , ENTER Y CTRL+X (para guardar Dockerfile y salir)

podman build -ti mrfdocker -f Dockerfile .
podman run --name mymrf --rm -p 8001:3306 mrfdocker
docker images

'''EN LA TERMINAL DEL HOST:'''

''Instalación de mysql:''

apt install mysql-client-core-5.7
apt-get install mysql-server
service mysql start

''Para entrar:''

mysql -u root -p -P 8001

Una vez dentro de msql:

mysql> show databases;

''Para salir:''

exit

== Ejercicio 6: python pyramid ==

Pyramid es un framework python para implementar webs. Cree una imagen "miapp-pyramid":

* Emplee la imagen de Ubuntu como referencia, instale los paquetes python y python-pip.
* Instale Pyramid mediante: pip install pyramid
* Cree la carpeta "app"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"
* La aplicación se lanza con la orden: python hello.py
* Compruebe que funciona con curl, la ruta a la web es http://127.0.0.1:8000/hello, suponiendo que ha empleado el puerto 8000 para exponer el servicio.

El fichero hello.py contiene un "hola mundo" para Pyramid:

<syntaxhighlight lang="bash">
from wsgiref.simple_server import make_server
from pyramid.config import Configurator
from pyramid.response import Response

def hello_world(request):
print('Request inbound!')
return Response('Podman works with Pyramid!')

if __name__ == '__main__':
config = Configurator()
config.add_route('hello', '/')
config.add_view(hello_world, route_name='hello')
app = config.make_wsgi_app()
server = make_server('0.0.0.0', 6543, app)
server.serve_forever()
</syntaxhighlight>

Este programa recibe peticiones en el puerto 6543.

== Ejercicio 7 ==

Cree una imagen derivada de Ubuntu, instale el paquete apache2, php y libapache2-mod-php.
Active el módulo de php para apache2 mediante la orden:

<syntaxhighlight lang="bash">
a2enmod php
</syntaxhighlight>

Cree la carpeta /var/www/php.

Cree el fichero index.php

<syntaxhighlight lang="php">
<?php
Print "Hello, World!";
?>
</syntaxhighlight>

y copielo a /var/www/php/.

Cree el fichero 000-default.conf y copielo a /etc/apache2/sites-enabled/

Dicho fichero contiene.

<syntaxhighlight lang="bash">
<VirtualHost *:80>
DocumentRoot /var/www/php

<Directory /var/www/php/>
Options Indexes FollowSymLinks MultiViews
AllowOverride All
Order deny,allow
Allow from all
</Directory>

ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>
</syntaxhighlight>

Tiene que lanzar apache con la orden: apachectl -D FOREGROUND

Tras crear la imagen, láncela mapeando el puerto 8888 al 80, pruebe que puede acceder a http://127.0.0.1:8888/php/ mediante curl

Solución:

<syntaxhighlight lang="bash">
FROM ubuntu:latest

RUN apt-get update
RUN apt-get install -y tzdata
RUN apt-get install -y apache2
RUN apt-get install -y php
RUN apt-get install -y libapache2-mod-php
RUN a2enmod php7.2
COPY index.php /var/www/php
COPY 000-default.conf /etc/apache2/sites-enabled/
CMD apachectl -D FOREGROUND
</syntaxhighlight>

Y para lanzarlo:

podman run --name my-app --rm -d -p 8001:8000 app:v1

y para probarlo:

curl -X GET http://127.0.0.1:8888/php/

== Ejercicio 8 ==

Instale el paquete ''netcat-traditional'' en una imagen de contenedor de ''ubuntu''. Lance la orden:

nc -u -l -p 8080

en el contenedor. Asegúrese de crear una redirección de puertos de 9999 desde el ''host'' al puerto 8080 en el contenedor.

Desde fuera del contenedor, pruebe a conectarse con:

nc -u 127.0.0.1 9999

== Ejercicio 9 ==

Cree una imagen derivada de "ubuntu" con un Dockerfile que incluya soporte de python y lance el siguiente código en Python:

<syntaxhighlight lang="python">
from http.server import BaseHTTPRequestHandler, HTTPServer
import time

hostName = "0.0.0.0"
serverPort = 8080

class MyServer(BaseHTTPRequestHandler):
def do_GET(self):
self.send_response(200)
self.send_header("Content-type", "text/html")
self.end_headers()
self.wfile.write(bytes("<html><head><title>Welcome!</title></head>", "utf-8"))
self.wfile.write(bytes("<body>", "utf-8"))
self.wfile.write(bytes("This is an example web server.", "utf-8"))
self.wfile.write(bytes("</body></html>", "utf-8"))

if __name__ == "__main__":
webServer = HTTPServer((hostName, serverPort), MyServer)
print("Server started http://%s:%s" % (hostName, serverPort))

try:
webServer.serve_forever()
except KeyboardInterrupt:
pass

webServer.server_close()
print("Server stopped.")
</syntaxhighlight>

Llame a su imagen "python-http-server". Lance una instancia de la imagen "python-http-server" mapeando el puerto 9999 al puerto 8888/tcp del contenedor. Compruebe con:

<syntaxhighlight lang="bash">
curl http://127.0.0.1:9999/
</syntaxhighlight>

que muestre la página HTML que ofrece el servidor, que debería ser:

<syntaxhighlight lang="bash">
<html><head><title>Welcome!</title></head><body>This is an example web server.</body></html>
</syntaxhighlight>

Contenedores

2025-12-10T10:48:35Z

Pneira: /* Ejercicio 9 */

En esta práctica aprenderemos a utilizar [https://es.wikipedia.org/wiki/Podman podman] para desplegar contenedores.

= Paso 1: Instalar podman =

Para instalar el paquete oficial:

<syntaxhighlight lang="bash">
apt install podman
</syntaxhighlight>

podman es un clon de '''docker''.

= Paso 2: Repositorio de imágenes de contenedores DockerHub =

Docker ofrece un servicio de nube denominado ''DockerHub'' que puede ser empleado como red social para compartir tus imágenes de Podman. En ''DockerHub'' existen además imágenes de contenedores preconfiguradas de software, muchas de ellas oficiales (ofrecidas por el propio fabricante del software) que se podrán emplear como base para construir nuevas imágenes adaptadas a nuestras necesidades.

Podremos realizar búsquedas en este repositorio ''DockerHub'' puedes emplear el siguiente comando:

<syntaxhighlight lang="bash">
podman search docker.io/library/hello-world
</syntaxhighlight>

Para descargarnos la imagen de ''hello-world'' podemos usar la orden ''pull'':

<syntaxhighlight lang="bash">
podman pull docker.io/library/hello-world
</syntaxhighlight>

También podemos publicar imágenes propias, esto require '''registro de usuario''' en la nube de ''DockerHub'', lo que '''no''' es obligatorio para la realización de esta práctica. Para subir una imagen, hay que validarse como usuario en la nube de ''DockerHub'':

<syntaxhighlight lang="bash">
podman login
</syntaxhighlight>

Tras introducir tu usuario y contraseña, puedes comenzar a publicar tus propias imágenes.

<syntaxhighlight lang="bash">
podman push MI_IMAGEN
</syntaxhighlight>

Este paso es '''opcional''', sólo en caso de que se quieran subir imágenes de contenedores a la nube de docker.io.

= Paso 4: Comprobar imágenes en nuestra máquina =

Para ver las imágenes que tenemos en nuestra máquina, utilizaremos el comando:

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Inicialmente, no tenemos imágenes en almacenamiento, podemos descargarnos la imagen oficial de Debian 13 (Trixie):

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian
</syntaxhighlight>

Ahora si, ya debería de aparecernos la imagen ''debian''.

Comentar también que cada imagen puede tener varias etiquetas, por ejemplo, la imagen Debian 12 (Bookworm), cuando la hemos visto en el listado de imágenes, venía con el tag latest, que es el tag que se descarga por defecto, pero nosotros podemos especificar otro, por ejemplo:

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian:bookworm
</syntaxhighlight>

Para traernos la versión de la imagen de Debian 12 ''Bookworm''.

Ahora tendremos dos imágenes con diferente etiqueta, que serían como las diferentes versiones de cada imagen.

= Paso 5: Lanzar un contenedor =

Un contenedor no es más que una imagen de podman ejecutándose, sería similar a
una máquina virtual, aunque mucho más liviano.

Para crear un contenedor, utilizaremos una imagen, en este caso, la imagen
hello-world. Hacemos lo siguiente:

<syntaxhighlight lang="bash">
podman run hello-world
</syntaxhighlight>

Esto nos mostrará el siguiente mensaje si todo está correcto:

<syntaxhighlight lang="bash">
Hello from Docker!
This message shows that your installation appears to be working correctly.

To generate this message, Docker took the following steps:
1. The Docker client contacted the Docker daemon.
2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
(amd64)
3. The Docker daemon created a new container from that image which runs the
executable that produces the output you are currently reading.
4. The Docker daemon streamed that output to the Docker client, which sent it
to your terminal.

To try something more ambitious, you can run an Debian container with:
$ podman run -it debian bash

Share images, automate workflows, and more with a free Docker ID:
https://hub.docker.com/

For more examples and ideas, visit:
https://docs.docker.com/get-started/
</syntaxhighlight>

Al crear los contenedores utilizando el comando 'run', tenemos varias opciones:

* Lanzar una terminal en el contenedor en modo interactivo
* Lanzar en segundo plano y conectarnos posteriormente al contenedor

== Paso 5.1: Lanzar una terminal en el contenedor en modo interactivo (-ti) ==

Para este ejemplo vamos a utilizar otra imagen diferente, en este caso vamos a utilizar una imagen de debian.

Vamos a lanzar un contenedor y ejecutar una terminal en el que se va a ejecutar el programa '''bash''' que me ofrece un interprete de órdenes:

<syntaxhighlight lang="bash">
podman run -ti debian bash
</syntaxhighlight>

La opción ''-t'' indica que se crea un terminal en el contenedor. Y la opción ''-i'' indica que el contenedor se ejecuta en modo interactivo.

Al acceder al contenedor de ''debian'' nos aparece un ''hash'' en el prompt de la shell, que identifica a la instancia del contenedor (es valor es similar al que muestra la orden ''podman container ls'').

Para salir del contenedor, escribimos 'exit' o pulsamos ''CTRL + D''

== Paso 5.2 Lanzar en segundo plano (-d) ==

Otro ejemplo, con la imagen de Debian:

<syntaxhighlight lang="bash">
podman run -dti debian
</syntaxhighlight>

que muestra un hash que identifica de forma única el contenedor lanzado:

<syntaxhighlight lang="bash">
2ec1daae4676a4e84dc04fd91399c1dfe92119544ff12ee307991fe573d3db64
</syntaxhighlight>

Mediante el comando ''attach'' puedo entrar al contenedor:

<syntaxhighlight lang="bash">
podman attach 2ec1daae4676
</syntaxhighlight>

Para salir, pulsamos ''CTRL + P'' seguido de ''CTRL + Q''.

De manera similar, puedo lanzar en segundo plano la imagen de contenedor de ''hello-world'':

<syntaxhighlight lang="bash">
podman run -d hello-world
</syntaxhighlight>

Y consultar los logs:

<syntaxhighlight lang="bash">
podman logs b67fae3312bc321
</syntaxhighlight>

== Paso 5.3: Añadir variables de entorno a un contenedor ==

Utilizaremos la imagen anterior, y vamos a añadir una variable de entorno
llamada TEST que contenga el valor 'test'. A parte, también ejecutaremos la
terminal como antes, para comprobar con el comando echo, que la variable de
entorno está creada correctamente:

<syntaxhighlight lang="bash">
podman run -ti -e TEST=test debian bash
</syntaxhighlight>

Ahora, desde el contenedor podemos comprobar el valor de la variable de entorno ''$TEST''.

<syntaxhighlight lang="bash">
echo $TEST
test
</syntaxhighlight>

= Paso 6: Listar contenedores en ejecución =

Hemos estado haciendo pruebas y ejecutando contenedores en el paso anterior, vamos a ver donde se encuentran estos contenedores que hemos ejecutado, y después veremos algunas opciones más del comando run.

Tenemos dos opciones para ver los contenedores:

<syntaxhighlight lang="bash">
podman container ls -a
</syntaxhighlight>

o la versión corta:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Ambas hacen lo mismo, y debería de mostrarnos una salida similar a la siguiente:

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
e2bde5f5500c debian "bash" 6 minutes ago Exited (0) 2 seconds ago pensive_sammet
544ad27dbc3c debian "bash" 7 minutes ago Exited (0) 7 minutes ago serene_elgamal
</syntaxhighlight>

En la información veremos que el contenedor tiene el estado exited, eso quiere decir que no se está ejecutando y ya ha finalizado. Vamos a hacer una prueba para ver un contendor ejecutándose:

<syntaxhighlight lang="bash">
podman run -d debian sleep 30
</syntaxhighlight>

Con el comando sleep 30 esperamos 30 segundos hasta que termine el comando, asíque durante esos 30 segundos, el contenedor estará ejecutándose, veámoslo:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
eacceb27d52d debian "sleep 30" 12 seconds ago Up 11 seconds sharp_pasteur
</syntaxhighlight>

Vamos a ver alguna opciones más de la orden ''run''.

== Paso 6.1: Dar un nombre al contenedor (--name) ==

Por defecto, podman creará automáticamente un nombre como hemos visto en las salidas del comando ''podman ps -a''. Podemos establecer el nombre del contenedor que queramos con la opción ''--name'':

<syntaxhighlight lang="bash">
podman run -ti --name mi_debian debian
</syntaxhighlight>

== Paso 6.2: Eliminar contenedor cuando termine (--rm) ==

Vamos a mezclar todo lo visto anteriormente:

* Lanzar en segundo plano (-d)
* Ejecutar contenedor durante 30 segundos (sleep 30)
* Dar un nombre a la imagen (--name)
* Eliminar contenedor cuando termine (--rm)

<syntaxhighlight lang="bash">
podman run -d --rm --name bye-bye debian sleep 30
</syntaxhighlight>

Antes y una vez pasados los 30 segundos, podemos comprobar que el contenedor ha desaparecido.

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

= Paso 7: Parar y eliminar contenedores =

Para parar contenedores podemos usar el ID o su nombre:

<syntaxhighlight lang="bash">
podman stop my_container
podman stop e4901956f108
podman ps -a
</syntaxhighlight>

Una vez hemos comprobado que han terminado su ejecución, podemos eliminar los ficheros resultantes de su ejecución:

<syntaxhighlight lang="bash">
podman container rm my_container
</syntaxhighlight>

Para borrar todos los contenedores ya finalizados

<syntaxhighlight lang="bash">
podman container prune
</syntaxhighlight>

= Paso 8: Conectarnos a un contenedor que se está ejecutando en segundo plano =

Vamos a ejecutar de nuevo un contenedor que no termine:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a conectarnos a este contenedor que está ejecutándose en segundo
plano:

<syntaxhighlight lang="bash">
podman attach mi-contenedor
</syntaxhighlight>

Veremos la orden bash ejecutándose, para terminar, hacemos un 'CTRL + C', y ahora, veremos que ha pasado con el contenedor:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Lo veremos parado, por que lo que hemos hecho ha sido conectarnos al contenedor
y parar el comando que se estaba ejecutando, así que ahora tenemos el contenedor
finalizado.

''Nota:'' Para salir del contenedor '''sin detenerlo''' hacemos 'CTRL + P' seguido 'CTRL + Q'

= Paso 9: Ejecutar un comando dentro de un contenedor en ejecución =

Vamos a ver otresta vez como ejecutar un comando en un contenedor que ya está
ejecutándose:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a ejecutar un comando en ese contenedor con el nombre ''mi-contenedor''.
El comando exec es similar al comando run, pero para ejecutar un comando dentro de un contenedor:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor ls
</syntaxhighlight>

Para redirigir la salida a un fichero en el anfitrión:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor ls > x.txt
</syntaxhighlight>

Para redirigir la salida a un fichero ''dentro'' del contenedor, hacemos:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor sh -c "ls > x.txt"
</syntaxhighlight>

También es posible ejecutar comandos con tuberías:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor sh -c "ls -la | grep ^d"
</syntaxhighlight>

= Paso 10: Persistencia en contenedores =

Al hacer ''exit'' y salir de un contenedor, se pierden todos los cambios que hemos realizado. Los

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-ejemplo debian bash
</syntaxhighlight>

Ahora, vamos a crear una carpeta en el contenedor y comprobar que esa carpeta existe:

<syntaxhighlight lang="bash">
podman exec mi-ejemplo mkdir test
podman exec mi-ejemplo ls
</syntaxhighlight>

Veremos que la carpeta existe, pero, ¿qué ocurre si para el contenedor?

<syntaxhighlight lang="bash">
podman container stop mi-ejemplo
</syntaxhighlight>

Y volvemos a lanzarlo:

<syntaxhighlight lang="bash">
podman container rm mi-ejemplo
podman run -d -ti --name mi-ejemplo debian bash
podman exec mi-ejemplo ls
</syntaxhighlight>

Podemos comprobar que la carpeta creada anteriormente, no existe.

¿Qué podemos hacer para mantener la modificaciones realizadas sobre un contenedor?

== Paso 10.1: Crear una imagen derivada de la imagen base ==

Es posible crear una imagen derivada, con modificaciones, a partir de una imagen existente mediante la orden '''commit'''.

Por ejemplo, si queremos una imagen ''debian'' que incluya el programa ''ping'' ya instalado, tendríamos que lanzar un contenedor a partir de la imagen ''ubuntu'':

<syntaxhighlight lang="bash">
podman run -d -ti debian bash
</syntaxhighlight>

Suponiendo que el contenido está identificado con el ID 56ef5b312334

Instalamos el paquete ping:

<syntaxhighlight lang="bash">
podman exec 56ef5b312334 apt -y install ping
</syntaxhighlight>

Generamos la imagen derivada con el nombre ''ubuntu-con-ping'':

<syntaxhighlight lang="bash">
podman commit 56ef5b312334 ubuntu-con-ping
</syntaxhighlight>

Ya podemos para nuestro contendor:

<syntaxhighlight lang="bash">
podman stop 56ef5b312334
</syntaxhighlight>

Y lanzar un nuevo contenedor a partir de la imagen ''debian-con-ping'':

<syntaxhighlight lang="bash">
podman run -d -ti debian-con-ping bash
</syntaxhighlight>

== Paso 10.2: Mantener la persistencia mediante volúmen ==

Otra opción para mantener los datos es montar un volumen al ejecutar el contenedor.

Primero crearemos una carpeta que hará de volumen en nuestra máquina, que será la que luego montemos para podman:

<syntaxhighlight lang="bash">
mkdir /home/debian/volumen
</syntaxhighlight>

Ahora vamos a montar la carpeta al ejecutar el contenedor, lo hacemos con la
opción -v, la cual tiene 3 campos separados por ':':

# El volumen en nuestra máquina
# Donde se montará el volumen dentro del contenedor
# Opciones de mmontaje, por ejemplo rw (read and write) o ro (read only)

<syntaxhighlight lang="bash">
podman run --rm -ti -v /home/debian/volumen:/volumen:rw debian bash
mkdir /volumen/test
touch /volumen/test/file
exit
</syntaxhighlight>

Una vez nos salgamos del contenedor, podemos ver que en nuestra máquina están
los datos:

<syntaxhighlight lang="bash">
ls /home/ubuntu/volumen/
ls /home/ubuntu/volumen/test
</syntaxhighlight>

La próxima vez que ejecutemos un contenedor, si montamos ese volumen, los datos
estarán ahí, además esta forma tiene el beneficio de compartir datos entre
nuestra máquina y el contenedor de forma sencilla.

= Paso 11: Crear nuestra propia imagen de contenedor =

Para crear una imagen de un contenedor con una aplicación de Python hug, creamos en primer lugar la carpeta que contendrá los ficheros que nos permiten crear la imagen.

<syntaxhighlight lang="bash">
mkdir miapp
cd miapp
</syntaxhighlight>

Definimos un fichero ''Dockerfile'' para definir la imagen:

<syntaxhighlight lang="bash">
FROM ubuntu

RUN apt -y update
RUN apt -y upgrade
RUN apt -y install python3-hug
RUN mkdir /app
COPY endpoint.py /app
WORKDIR /app
CMD hug -f endpoint.py
</syntaxhighlight>

Alternativamente, puedes crear un [[Creando imagen propia usando Ubuntu de base|Dockerfile empleando la imagen de Ubuntu]] como base en lugar de Alpine.

Y añadimos el fichero ''endpoint.py'' que emplea el framework Python hug con el contenido siguiente:

<syntaxhighlight lang="bash">
import hug

@hug.get('/welcome')
def welcome(username="unknown"):
""" Say welcome to username """
return "Welcome " + username
</syntaxhighlight>

Este fichero es un ejemplo de uso de Python hug. Si hacemos una petición a /welcome?username="LSO", esto nos devolverá el mensaje "Welcome LSO".

Una vez tengamos los dos ficheros creados en nuestra máquina virtual, podemos construir nuestra imagen:

<syntaxhighlight lang="bash">
podman build -t app:v1 -f Dockerfile .
</syntaxhighlight>

Vamos a explicar para que sirve cada línea:

* FROM: servirá para basarnos en una imagen existente, en este caso, una imagen de python alpine, que contiene python y no ocupa mucho espacio
* ENV: para crear variables de entorno
* RUN: para ejecutar comandos, ya sea para crear una carpeta, instalar dependencias o cualquier otra opción que necesitemos
* COPY: para copiar datos desde nuestra máquina a la imagen
* WORKDIR: para cambiar el directorio de trabajo
* CMD: este comando será ejecutado por defecto al iniciar un contenedor a partir de esta imagen

Esto construirá una imagen podman basada en python:alpine, en la cual hemos
guardado nuestra pequeña aplicación y se va a ejecutar cuando ejecutemos un
contenedor basado en esa imagen. Para comprobar que la imagen se ha creado
correctamente, listamos las imagenes, y debería de aparecernos una imagen con
nombre 'app' y tag 'v1':

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen, y vamos a añadir una nueva
opción, -p 8001:8000. Esta opción hará que el puerto interno 8000 del contenedor
sea expuesto en el puerto 8001 de nuestra máquina:

<syntaxhighlight lang="bash">
podman run --name my-app --rm -d -p 8001:8000 app:v1
</syntaxhighlight>

''Nota:'' podman supone que la redirección de puerto es TCP, para una redirección de puertos UDP, puedes usar:

<syntaxhighlight lang="bash">
... -p 8001:8000/udp
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código. En nuestra
máquina haremos:

<syntaxhighlight lang="bash">
curl -X GET http://localhost:8001/welcome?username=LSO
</syntaxhighlight>

Comprobaremos que la salida del comando curl, es "Welcome LSO".

Antes de terminar, vamos a comprobar otro pequeño detalle que añadimos en
nuestra imagen, la variable de entorno USERNAME, vamos a comprobar que funciona:

<syntaxhighlight lang="bash">
podman exec -ti my-app ash
echo $USERNAME
</syntaxhighlight>

Funciona correctamente, pero al ejecutar el contenedor, podemos cambiar esta
variable de entorno como vimos en uno de los pasos anteriores:

<syntaxhighlight lang="bash">
podman run --rm -ti -e USERNAME=me app:v1 ash
echo $USERNAME
</syntaxhighlight>

Esto nos servirá para tener opciones por defecto y que el usuario pueda
cambiarlo a su antojo, como por ejemplo contraseñas u otros detalles.

= Paso 12: Eliminar imágenes =

Para borrar una imagen, puede hacer:

<syntaxhighlight lang="bash">
podman image rm hello-world
</syntaxhighlight>

= Paso 13: Varios podman a la vez (podman-compose) =

Antes de comenzar, vamos a parar todos los contenedores que tengamos abiertos,
para dejar el entorno de podman limpio, que nos vendrá bien para esta parte.

Cuando queremos ejecutar varios contenedores a la vez y que estén conectados
entre ellos fácilmente, utilizaremos podman-compose, donde con un fichero de
configuración simple en yaml, tendremos toda la configuración de lo que vamos a
ejecutar.

Primero vamos a instalar podman-compose:

<syntaxhighlight lang="bash">
sudo apt install podman-compose
</syntaxhighlight>

Ahora veamos un pequeño ejemplo donde explicaremos todos los detalles para crear
un podman-compose, en este caso, el nombre por defecto de los ficheros suele ser
podman-compose.yml, y el contenido será similar a:

<syntaxhighlight lang="bash">
version: '3'

services:
web:
container_name: web
restart: always
build:
context: .
ports:
- "8000:8000"
volumes:
- /home/ubuntu/volume:/volumen:rw
environment:
USERNAME: test
web2:
container_name: web2
build:
dockerfile: Dockerfile
context: .
depends_on:
- web
command: touch web2
web3:
container_name: web3
restart: on-failure
image: pstauffer/curl
depends_on:
- web
command: curl -X GET web:8000/welcome?username=web3
</syntaxhighlight>

En el podman-compose definimos diferentes servicios a ejecutar, en nuestro caso
hemos iniciado tres servicios diferentes, web, web2 y web3:

El primer servicio, web:

* container_name: para darle un nombre por defecto al contenedor cuando se cree
* restart: pueden ser:
** "no": si la máquina termina, no se vuelve a iniciar (opción por defecto)
** always: siempre que el contenedor termine, intenta iniciarse de nuevo
** on-failure: solo intenta reiniciarse si el contenedor termina con fallo
** unless-stopped: solo reinicia el contenedor si el usuario es el que lo termina
* Utilizará el fichero Dockerfile creado en el paso 11 para generar la imagen a usar.
* Expondrá el puerto 8000 del contenedor en el 8000 de nuestra máquina
* Montará un volumen, se hace de forma similar a la línea de comandos
* Creará una variable de entorno

El segundo servicio, web2:

* Utilizará el fichero Dockerfile también, la diferencia entre este y el primer servicio, es que si el nombre del Dockerfile cambia, tendremos que hacerlo de esta segunda forma, la primera por defecto solo buscará el fichero Dockerfile
* depends_on hará que para ejecutar este servicio, su dependencia tenga ya que estar iniciada
* Ejecutaremos un comando el cual sustituirá al comando de la imagen

El tercer servicio, web3:

* Utilizará la imagen ostauffer/curl que es un imagen mínima que contiene el comando curl
* restart: en este caso, hasta que el comando no se ejecute correctamente, se seguirá reiniciando el contenedor
* depends_on igual que el servicio 2, dependerá del servicio 1
* Ejecutaremos un comando para llamar desde el servicio 3 al servicio 1

== Paso 13.1: Construir podman-compose ==

En el caso de existir servicios que tengan Dockerfiles, esto hará que se construyan previamente, como hacer un podman build de cada uno de los servicios que contenga un Dockerfile:

<syntaxhighlight lang="bash">
podman-compose build
</syntaxhighlight>

Con esto se generarán las imágenes necesarias para ejecutar todos los servicios.

== Paso 13.2: Iniciar podman-compose ==

Para iniciar todos los servicios, ejecutaremos:

<syntaxhighlight lang="bash">
podman-compose up -d
</syntaxhighlight>

Después de esto podremos ver el logs de todos los servicios:

<syntaxhighlight lang="bash">
podman-compose logs -f
</syntaxhighlight>

Aquí veremos que el servicio 3 ha conseguido llamar correctamente al servicio 1.

Ahora veremos como podman-compose ha creado los contenedores:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

La salida será similar a la siguiente:

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
219a4118244c pstauffer/curl "curl -X GET web:800…" 6 seconds ago Exited (0) 3 seconds ago web3
c97e894cb3ae ubuntu_web2 "touch web2" 6 seconds ago Exited (0) 4 seconds ago web2
f35d034204fc ubuntu_web "/bin/sh -c 'hug -f …" 6 seconds ago Up 5 seconds 0.0.0.0:8000->8000/tcp web
</syntaxhighlight>

Aquí vemos varios detalles:

* El nombre que le hemos dado en el podman-compose ha funcionado correctamente
* Vemos que los comandos son los correctos también
* web2 está parado por que la política de reinicio es apagar cuando se termine de ejecutar un comando
* web 3 está parado por que el comando ha terminado con un salida correcta

Vamos a comprobar ahora que en el servicio web está todo correcto:

<syntaxhighlight lang="bash">
podman exec -ti web ash
echo $USERNAME
ls /volumen
exit
</syntaxhighlight>

Podemos comprobar que tanto cambiar la variable de entorno como crear un
volumen ha funcionado correctamente.

== Paso 13.3: Parar podman-compose ==

Para parar todos los servicios:

<syntaxhighlight lang="bash">
podman-compose down
</syntaxhighlight>

Comprobamos:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Vemos que han desaparecido todos los contenedores.

= Paso 14: Ejercicios =

== Ejercicio 1: Image derivada de Debian con el programa sl ==

Lance un contenedor a partir de una imagen de Debian, instale el programa sl, ejecute sl (desde fuera del contenedor) y detenga el contenedor.

== Ejercicio 2 ==

== Ejercicio 3: Variante de httpd ==

Construya una imagen ''httpd-hola-mundo'' a partir de la imagen ''httpd''. El fichero de index.html de la carpeta htdocs/ tiene que mostrar el mensaje "hola mundo".

<syntaxhighlight lang="bash">
podman pull httpd
</syntaxhighlight>

Edita el fichero Dockerfile:

<syntaxhighlight lang="bash">
nano Dockerfile
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
FROM httpd

COPY index.html htdocs/index.html
</syntaxhighlight>

Edita el fichero index.html:

<syntaxhighlight lang="bash">
nano index.html
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

Construye la imagen:

<syntaxhighlight lang="bash">
podman build -t mihttpd -f Dockerfile .
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen:

<syntaxhighlight lang="bash">
podman run --name mihttpd -d -p 8080:80 mihttpd
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código:
<syntaxhighlight lang="bash">
curl -X GET http://localhost:8080
</syntaxhighlight>

Tiene que salir por pantalla esto:
<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

== Ejercicio 4: aplicación flask ==

Flask es un framework python para implementar webs. Cree una imagen "miapp-flask" a partir de la imagen de "python":

* Instale flask mediante: pip install flask
* Cree la carpeta "app"
* Establezca la variable FLASK_APP a "hello.py"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"

El fichero hello.py contiene un "hola mundo" para Flask:

<syntaxhighlight lang="python">
from flask import Flask
app = Flask(__name__)

@app.route("/")
def hello():
return "Hello World!"

if __name__ == "__main__":
app.run()
</syntaxhighlight>

Solución con alpine:

<syntaxhighlight lang="bash">
FROM python:alpine

RUN mkdir /app
RUN pip install flask
ENV FLASK_APP="app/hello.py"
COPY hello.py
WORKDIR /
CMD flask run --host=0.0.0.0
</syntaxhighlight>

Solución con Ubuntu:

<syntaxhighlight lang="bash">
FROM ubuntu:bionic

RUN apt-get update
RUN apt-get -y install python python-pip wget
RUN pip install Flask
ENV FLASK_APP="app/hello.py"
RUN mkdir /app
COPY hello.py /app
CMD flask run --host=0.0.0.0
</syntaxhighlight>

== Ejercicio 5: mysql ==

'''EN LA MÁQUINA VIRTUAL:'''

mkdir miapp
cd miapp
podman pull mysql
nano Dockerfile

<syntaxhighlight lang="bash">
FROM mysql
ENV MYSQL_ROOT_PASSWORD="lacontraseñaqueyoquiera"
RUN mkdir /app
WORKDIR /app

</syntaxhighlight>

CTRL+O , ENTER Y CTRL+X (para guardar Dockerfile y salir)

podman build -ti mrfdocker -f Dockerfile .
podman run --name mymrf --rm -p 8001:3306 mrfdocker
docker images

'''EN LA TERMINAL DEL HOST:'''

''Instalación de mysql:''

apt install mysql-client-core-5.7
apt-get install mysql-server
service mysql start

''Para entrar:''

mysql -u root -p -P 8001

Una vez dentro de msql:

mysql> show databases;

''Para salir:''

exit

== Ejercicio 6: python pyramid ==

Pyramid es un framework python para implementar webs. Cree una imagen "miapp-pyramid":

* Emplee la imagen de Ubuntu como referencia, instale los paquetes python y python-pip.
* Instale Pyramid mediante: pip install pyramid
* Cree la carpeta "app"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"
* La aplicación se lanza con la orden: python hello.py
* Compruebe que funciona con curl, la ruta a la web es http://127.0.0.1:8000/hello, suponiendo que ha empleado el puerto 8000 para exponer el servicio.

El fichero hello.py contiene un "hola mundo" para Pyramid:

<syntaxhighlight lang="bash">
from wsgiref.simple_server import make_server
from pyramid.config import Configurator
from pyramid.response import Response

def hello_world(request):
print('Request inbound!')
return Response('Podman works with Pyramid!')

if __name__ == '__main__':
config = Configurator()
config.add_route('hello', '/')
config.add_view(hello_world, route_name='hello')
app = config.make_wsgi_app()
server = make_server('0.0.0.0', 6543, app)
server.serve_forever()
</syntaxhighlight>

Este programa recibe peticiones en el puerto 6543.

== Ejercicio 7 ==

Cree una imagen derivada de Ubuntu, instale el paquete apache2, php y libapache2-mod-php.
Active el módulo de php para apache2 mediante la orden:

<syntaxhighlight lang="bash">
a2enmod php
</syntaxhighlight>

Cree la carpeta /var/www/php.

Cree el fichero index.php

<syntaxhighlight lang="php">
<?php
Print "Hello, World!";
?>
</syntaxhighlight>

y copielo a /var/www/php/.

Cree el fichero 000-default.conf y copielo a /etc/apache2/sites-enabled/

Dicho fichero contiene.

<syntaxhighlight lang="bash">
<VirtualHost *:80>
DocumentRoot /var/www/php

<Directory /var/www/php/>
Options Indexes FollowSymLinks MultiViews
AllowOverride All
Order deny,allow
Allow from all
</Directory>

ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>
</syntaxhighlight>

Tiene que lanzar apache con la orden: apachectl -D FOREGROUND

Tras crear la imagen, láncela mapeando el puerto 8888 al 80, pruebe que puede acceder a http://127.0.0.1:8888/php/ mediante curl

Solución:

<syntaxhighlight lang="bash">
FROM ubuntu:latest

RUN apt-get update
RUN apt-get install -y tzdata
RUN apt-get install -y apache2
RUN apt-get install -y php
RUN apt-get install -y libapache2-mod-php
RUN a2enmod php7.2
COPY index.php /var/www/php
COPY 000-default.conf /etc/apache2/sites-enabled/
CMD apachectl -D FOREGROUND
</syntaxhighlight>

Y para lanzarlo:

podman run --name my-app --rm -d -p 8001:8000 app:v1

y para probarlo:

curl -X GET http://127.0.0.1:8888/php/

== Ejercicio 8 ==

Instale el paquete ''netcat-traditional'' en una imagen de contenedor de ''ubuntu''. Lance la orden:

nc -u -l -p 8080

en el contenedor. Asegúrese de crear una redirección de puertos de 9999 desde el ''host'' al puerto 8080 en el contenedor.

Desde fuera del contenedor, pruebe a conectarse con:

nc -u 127.0.0.1 9999

== Ejercicio 9 ==

Cree una imagen derivada de "ubuntu" con un Dockerfile que incluya soporte de python y lance el siguiente código en Python:

<syntaxhighlight lang="python">
from http.server import BaseHTTPRequestHandler, HTTPServer
import time

hostName = "0.0.0.0"
serverPort = 8080

class MyServer(BaseHTTPRequestHandler):
def do_GET(self):
self.send_response(200)
self.send_header("Content-type", "text/html")
self.end_headers()
self.wfile.write(bytes("<html><head><title>Welcome!</title></head>", "utf-8"))
self.wfile.write(bytes("<body>", "utf-8"))
self.wfile.write(bytes("This is an example web server.", "utf-8"))
self.wfile.write(bytes("</body></html>", "utf-8"))

if __name__ == "__main__":
webServer = HTTPServer((hostName, serverPort), MyServer)
print("Server started http://%s:%s" % (hostName, serverPort))

try:
webServer.serve_forever()
except KeyboardInterrupt:
pass

webServer.server_close()
print("Server stopped.")
</syntaxhighlight>

Llame a su imagen "python-http-server". Lance una instancia de la imagen "python-http-server" mapeando el puerto 9999 al puerto 8888/tcp del contenedor. Compruebe con:

<syntaxhighlight lang="bash">
curl http://127.0.0.1:9999/
</syntaxhighlight>

que muestre la página HTML que ofrece el servidor, que debería ser:

<syntaxhighlight lang="bash">
<html><head><title>Welcome!</title></head><body>This is an example web server.</body></html>
</syntaxhighlight>

Contenedores

2025-12-10T10:47:51Z

Pneira: /* Ejercicio 9 */

En esta práctica aprenderemos a utilizar [https://es.wikipedia.org/wiki/Podman podman] para desplegar contenedores.

= Paso 1: Instalar podman =

Para instalar el paquete oficial:

<syntaxhighlight lang="bash">
apt install podman
</syntaxhighlight>

podman es un clon de '''docker''.

= Paso 2: Repositorio de imágenes de contenedores DockerHub =

Docker ofrece un servicio de nube denominado ''DockerHub'' que puede ser empleado como red social para compartir tus imágenes de Podman. En ''DockerHub'' existen además imágenes de contenedores preconfiguradas de software, muchas de ellas oficiales (ofrecidas por el propio fabricante del software) que se podrán emplear como base para construir nuevas imágenes adaptadas a nuestras necesidades.

Podremos realizar búsquedas en este repositorio ''DockerHub'' puedes emplear el siguiente comando:

<syntaxhighlight lang="bash">
podman search docker.io/library/hello-world
</syntaxhighlight>

Para descargarnos la imagen de ''hello-world'' podemos usar la orden ''pull'':

<syntaxhighlight lang="bash">
podman pull docker.io/library/hello-world
</syntaxhighlight>

También podemos publicar imágenes propias, esto require '''registro de usuario''' en la nube de ''DockerHub'', lo que '''no''' es obligatorio para la realización de esta práctica. Para subir una imagen, hay que validarse como usuario en la nube de ''DockerHub'':

<syntaxhighlight lang="bash">
podman login
</syntaxhighlight>

Tras introducir tu usuario y contraseña, puedes comenzar a publicar tus propias imágenes.

<syntaxhighlight lang="bash">
podman push MI_IMAGEN
</syntaxhighlight>

Este paso es '''opcional''', sólo en caso de que se quieran subir imágenes de contenedores a la nube de docker.io.

= Paso 4: Comprobar imágenes en nuestra máquina =

Para ver las imágenes que tenemos en nuestra máquina, utilizaremos el comando:

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Inicialmente, no tenemos imágenes en almacenamiento, podemos descargarnos la imagen oficial de Debian 13 (Trixie):

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian
</syntaxhighlight>

Ahora si, ya debería de aparecernos la imagen ''debian''.

Comentar también que cada imagen puede tener varias etiquetas, por ejemplo, la imagen Debian 12 (Bookworm), cuando la hemos visto en el listado de imágenes, venía con el tag latest, que es el tag que se descarga por defecto, pero nosotros podemos especificar otro, por ejemplo:

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian:bookworm
</syntaxhighlight>

Para traernos la versión de la imagen de Debian 12 ''Bookworm''.

Ahora tendremos dos imágenes con diferente etiqueta, que serían como las diferentes versiones de cada imagen.

= Paso 5: Lanzar un contenedor =

Un contenedor no es más que una imagen de podman ejecutándose, sería similar a
una máquina virtual, aunque mucho más liviano.

Para crear un contenedor, utilizaremos una imagen, en este caso, la imagen
hello-world. Hacemos lo siguiente:

<syntaxhighlight lang="bash">
podman run hello-world
</syntaxhighlight>

Esto nos mostrará el siguiente mensaje si todo está correcto:

<syntaxhighlight lang="bash">
Hello from Docker!
This message shows that your installation appears to be working correctly.

To generate this message, Docker took the following steps:
1. The Docker client contacted the Docker daemon.
2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
(amd64)
3. The Docker daemon created a new container from that image which runs the
executable that produces the output you are currently reading.
4. The Docker daemon streamed that output to the Docker client, which sent it
to your terminal.

To try something more ambitious, you can run an Debian container with:
$ podman run -it debian bash

Share images, automate workflows, and more with a free Docker ID:
https://hub.docker.com/

For more examples and ideas, visit:
https://docs.docker.com/get-started/
</syntaxhighlight>

Al crear los contenedores utilizando el comando 'run', tenemos varias opciones:

* Lanzar una terminal en el contenedor en modo interactivo
* Lanzar en segundo plano y conectarnos posteriormente al contenedor

== Paso 5.1: Lanzar una terminal en el contenedor en modo interactivo (-ti) ==

Para este ejemplo vamos a utilizar otra imagen diferente, en este caso vamos a utilizar una imagen de debian.

Vamos a lanzar un contenedor y ejecutar una terminal en el que se va a ejecutar el programa '''bash''' que me ofrece un interprete de órdenes:

<syntaxhighlight lang="bash">
podman run -ti debian bash
</syntaxhighlight>

La opción ''-t'' indica que se crea un terminal en el contenedor. Y la opción ''-i'' indica que el contenedor se ejecuta en modo interactivo.

Al acceder al contenedor de ''debian'' nos aparece un ''hash'' en el prompt de la shell, que identifica a la instancia del contenedor (es valor es similar al que muestra la orden ''podman container ls'').

Para salir del contenedor, escribimos 'exit' o pulsamos ''CTRL + D''

== Paso 5.2 Lanzar en segundo plano (-d) ==

Otro ejemplo, con la imagen de Debian:

<syntaxhighlight lang="bash">
podman run -dti debian
</syntaxhighlight>

que muestra un hash que identifica de forma única el contenedor lanzado:

<syntaxhighlight lang="bash">
2ec1daae4676a4e84dc04fd91399c1dfe92119544ff12ee307991fe573d3db64
</syntaxhighlight>

Mediante el comando ''attach'' puedo entrar al contenedor:

<syntaxhighlight lang="bash">
podman attach 2ec1daae4676
</syntaxhighlight>

Para salir, pulsamos ''CTRL + P'' seguido de ''CTRL + Q''.

De manera similar, puedo lanzar en segundo plano la imagen de contenedor de ''hello-world'':

<syntaxhighlight lang="bash">
podman run -d hello-world
</syntaxhighlight>

Y consultar los logs:

<syntaxhighlight lang="bash">
podman logs b67fae3312bc321
</syntaxhighlight>

== Paso 5.3: Añadir variables de entorno a un contenedor ==

Utilizaremos la imagen anterior, y vamos a añadir una variable de entorno
llamada TEST que contenga el valor 'test'. A parte, también ejecutaremos la
terminal como antes, para comprobar con el comando echo, que la variable de
entorno está creada correctamente:

<syntaxhighlight lang="bash">
podman run -ti -e TEST=test debian bash
</syntaxhighlight>

Ahora, desde el contenedor podemos comprobar el valor de la variable de entorno ''$TEST''.

<syntaxhighlight lang="bash">
echo $TEST
test
</syntaxhighlight>

= Paso 6: Listar contenedores en ejecución =

Hemos estado haciendo pruebas y ejecutando contenedores en el paso anterior, vamos a ver donde se encuentran estos contenedores que hemos ejecutado, y después veremos algunas opciones más del comando run.

Tenemos dos opciones para ver los contenedores:

<syntaxhighlight lang="bash">
podman container ls -a
</syntaxhighlight>

o la versión corta:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Ambas hacen lo mismo, y debería de mostrarnos una salida similar a la siguiente:

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
e2bde5f5500c debian "bash" 6 minutes ago Exited (0) 2 seconds ago pensive_sammet
544ad27dbc3c debian "bash" 7 minutes ago Exited (0) 7 minutes ago serene_elgamal
</syntaxhighlight>

En la información veremos que el contenedor tiene el estado exited, eso quiere decir que no se está ejecutando y ya ha finalizado. Vamos a hacer una prueba para ver un contendor ejecutándose:

<syntaxhighlight lang="bash">
podman run -d debian sleep 30
</syntaxhighlight>

Con el comando sleep 30 esperamos 30 segundos hasta que termine el comando, asíque durante esos 30 segundos, el contenedor estará ejecutándose, veámoslo:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
eacceb27d52d debian "sleep 30" 12 seconds ago Up 11 seconds sharp_pasteur
</syntaxhighlight>

Vamos a ver alguna opciones más de la orden ''run''.

== Paso 6.1: Dar un nombre al contenedor (--name) ==

Por defecto, podman creará automáticamente un nombre como hemos visto en las salidas del comando ''podman ps -a''. Podemos establecer el nombre del contenedor que queramos con la opción ''--name'':

<syntaxhighlight lang="bash">
podman run -ti --name mi_debian debian
</syntaxhighlight>

== Paso 6.2: Eliminar contenedor cuando termine (--rm) ==

Vamos a mezclar todo lo visto anteriormente:

* Lanzar en segundo plano (-d)
* Ejecutar contenedor durante 30 segundos (sleep 30)
* Dar un nombre a la imagen (--name)
* Eliminar contenedor cuando termine (--rm)

<syntaxhighlight lang="bash">
podman run -d --rm --name bye-bye debian sleep 30
</syntaxhighlight>

Antes y una vez pasados los 30 segundos, podemos comprobar que el contenedor ha desaparecido.

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

= Paso 7: Parar y eliminar contenedores =

Para parar contenedores podemos usar el ID o su nombre:

<syntaxhighlight lang="bash">
podman stop my_container
podman stop e4901956f108
podman ps -a
</syntaxhighlight>

Una vez hemos comprobado que han terminado su ejecución, podemos eliminar los ficheros resultantes de su ejecución:

<syntaxhighlight lang="bash">
podman container rm my_container
</syntaxhighlight>

Para borrar todos los contenedores ya finalizados

<syntaxhighlight lang="bash">
podman container prune
</syntaxhighlight>

= Paso 8: Conectarnos a un contenedor que se está ejecutando en segundo plano =

Vamos a ejecutar de nuevo un contenedor que no termine:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a conectarnos a este contenedor que está ejecutándose en segundo
plano:

<syntaxhighlight lang="bash">
podman attach mi-contenedor
</syntaxhighlight>

Veremos la orden bash ejecutándose, para terminar, hacemos un 'CTRL + C', y ahora, veremos que ha pasado con el contenedor:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Lo veremos parado, por que lo que hemos hecho ha sido conectarnos al contenedor
y parar el comando que se estaba ejecutando, así que ahora tenemos el contenedor
finalizado.

''Nota:'' Para salir del contenedor '''sin detenerlo''' hacemos 'CTRL + P' seguido 'CTRL + Q'

= Paso 9: Ejecutar un comando dentro de un contenedor en ejecución =

Vamos a ver otresta vez como ejecutar un comando en un contenedor que ya está
ejecutándose:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a ejecutar un comando en ese contenedor con el nombre ''mi-contenedor''.
El comando exec es similar al comando run, pero para ejecutar un comando dentro de un contenedor:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor ls
</syntaxhighlight>

Para redirigir la salida a un fichero en el anfitrión:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor ls > x.txt
</syntaxhighlight>

Para redirigir la salida a un fichero ''dentro'' del contenedor, hacemos:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor sh -c "ls > x.txt"
</syntaxhighlight>

También es posible ejecutar comandos con tuberías:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor sh -c "ls -la | grep ^d"
</syntaxhighlight>

= Paso 10: Persistencia en contenedores =

Al hacer ''exit'' y salir de un contenedor, se pierden todos los cambios que hemos realizado. Los

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-ejemplo debian bash
</syntaxhighlight>

Ahora, vamos a crear una carpeta en el contenedor y comprobar que esa carpeta existe:

<syntaxhighlight lang="bash">
podman exec mi-ejemplo mkdir test
podman exec mi-ejemplo ls
</syntaxhighlight>

Veremos que la carpeta existe, pero, ¿qué ocurre si para el contenedor?

<syntaxhighlight lang="bash">
podman container stop mi-ejemplo
</syntaxhighlight>

Y volvemos a lanzarlo:

<syntaxhighlight lang="bash">
podman container rm mi-ejemplo
podman run -d -ti --name mi-ejemplo debian bash
podman exec mi-ejemplo ls
</syntaxhighlight>

Podemos comprobar que la carpeta creada anteriormente, no existe.

¿Qué podemos hacer para mantener la modificaciones realizadas sobre un contenedor?

== Paso 10.1: Crear una imagen derivada de la imagen base ==

Es posible crear una imagen derivada, con modificaciones, a partir de una imagen existente mediante la orden '''commit'''.

Por ejemplo, si queremos una imagen ''debian'' que incluya el programa ''ping'' ya instalado, tendríamos que lanzar un contenedor a partir de la imagen ''ubuntu'':

<syntaxhighlight lang="bash">
podman run -d -ti debian bash
</syntaxhighlight>

Suponiendo que el contenido está identificado con el ID 56ef5b312334

Instalamos el paquete ping:

<syntaxhighlight lang="bash">
podman exec 56ef5b312334 apt -y install ping
</syntaxhighlight>

Generamos la imagen derivada con el nombre ''ubuntu-con-ping'':

<syntaxhighlight lang="bash">
podman commit 56ef5b312334 ubuntu-con-ping
</syntaxhighlight>

Ya podemos para nuestro contendor:

<syntaxhighlight lang="bash">
podman stop 56ef5b312334
</syntaxhighlight>

Y lanzar un nuevo contenedor a partir de la imagen ''debian-con-ping'':

<syntaxhighlight lang="bash">
podman run -d -ti debian-con-ping bash
</syntaxhighlight>

== Paso 10.2: Mantener la persistencia mediante volúmen ==

Otra opción para mantener los datos es montar un volumen al ejecutar el contenedor.

Primero crearemos una carpeta que hará de volumen en nuestra máquina, que será la que luego montemos para podman:

<syntaxhighlight lang="bash">
mkdir /home/debian/volumen
</syntaxhighlight>

Ahora vamos a montar la carpeta al ejecutar el contenedor, lo hacemos con la
opción -v, la cual tiene 3 campos separados por ':':

# El volumen en nuestra máquina
# Donde se montará el volumen dentro del contenedor
# Opciones de mmontaje, por ejemplo rw (read and write) o ro (read only)

<syntaxhighlight lang="bash">
podman run --rm -ti -v /home/debian/volumen:/volumen:rw debian bash
mkdir /volumen/test
touch /volumen/test/file
exit
</syntaxhighlight>

Una vez nos salgamos del contenedor, podemos ver que en nuestra máquina están
los datos:

<syntaxhighlight lang="bash">
ls /home/ubuntu/volumen/
ls /home/ubuntu/volumen/test
</syntaxhighlight>

La próxima vez que ejecutemos un contenedor, si montamos ese volumen, los datos
estarán ahí, además esta forma tiene el beneficio de compartir datos entre
nuestra máquina y el contenedor de forma sencilla.

= Paso 11: Crear nuestra propia imagen de contenedor =

Para crear una imagen de un contenedor con una aplicación de Python hug, creamos en primer lugar la carpeta que contendrá los ficheros que nos permiten crear la imagen.

<syntaxhighlight lang="bash">
mkdir miapp
cd miapp
</syntaxhighlight>

Definimos un fichero ''Dockerfile'' para definir la imagen:

<syntaxhighlight lang="bash">
FROM ubuntu

RUN apt -y update
RUN apt -y upgrade
RUN apt -y install python3-hug
RUN mkdir /app
COPY endpoint.py /app
WORKDIR /app
CMD hug -f endpoint.py
</syntaxhighlight>

Alternativamente, puedes crear un [[Creando imagen propia usando Ubuntu de base|Dockerfile empleando la imagen de Ubuntu]] como base en lugar de Alpine.

Y añadimos el fichero ''endpoint.py'' que emplea el framework Python hug con el contenido siguiente:

<syntaxhighlight lang="bash">
import hug

@hug.get('/welcome')
def welcome(username="unknown"):
""" Say welcome to username """
return "Welcome " + username
</syntaxhighlight>

Este fichero es un ejemplo de uso de Python hug. Si hacemos una petición a /welcome?username="LSO", esto nos devolverá el mensaje "Welcome LSO".

Una vez tengamos los dos ficheros creados en nuestra máquina virtual, podemos construir nuestra imagen:

<syntaxhighlight lang="bash">
podman build -t app:v1 -f Dockerfile .
</syntaxhighlight>

Vamos a explicar para que sirve cada línea:

* FROM: servirá para basarnos en una imagen existente, en este caso, una imagen de python alpine, que contiene python y no ocupa mucho espacio
* ENV: para crear variables de entorno
* RUN: para ejecutar comandos, ya sea para crear una carpeta, instalar dependencias o cualquier otra opción que necesitemos
* COPY: para copiar datos desde nuestra máquina a la imagen
* WORKDIR: para cambiar el directorio de trabajo
* CMD: este comando será ejecutado por defecto al iniciar un contenedor a partir de esta imagen

Esto construirá una imagen podman basada en python:alpine, en la cual hemos
guardado nuestra pequeña aplicación y se va a ejecutar cuando ejecutemos un
contenedor basado en esa imagen. Para comprobar que la imagen se ha creado
correctamente, listamos las imagenes, y debería de aparecernos una imagen con
nombre 'app' y tag 'v1':

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen, y vamos a añadir una nueva
opción, -p 8001:8000. Esta opción hará que el puerto interno 8000 del contenedor
sea expuesto en el puerto 8001 de nuestra máquina:

<syntaxhighlight lang="bash">
podman run --name my-app --rm -d -p 8001:8000 app:v1
</syntaxhighlight>

''Nota:'' podman supone que la redirección de puerto es TCP, para una redirección de puertos UDP, puedes usar:

<syntaxhighlight lang="bash">
... -p 8001:8000/udp
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código. En nuestra
máquina haremos:

<syntaxhighlight lang="bash">
curl -X GET http://localhost:8001/welcome?username=LSO
</syntaxhighlight>

Comprobaremos que la salida del comando curl, es "Welcome LSO".

Antes de terminar, vamos a comprobar otro pequeño detalle que añadimos en
nuestra imagen, la variable de entorno USERNAME, vamos a comprobar que funciona:

<syntaxhighlight lang="bash">
podman exec -ti my-app ash
echo $USERNAME
</syntaxhighlight>

Funciona correctamente, pero al ejecutar el contenedor, podemos cambiar esta
variable de entorno como vimos en uno de los pasos anteriores:

<syntaxhighlight lang="bash">
podman run --rm -ti -e USERNAME=me app:v1 ash
echo $USERNAME
</syntaxhighlight>

Esto nos servirá para tener opciones por defecto y que el usuario pueda
cambiarlo a su antojo, como por ejemplo contraseñas u otros detalles.

= Paso 12: Eliminar imágenes =

Para borrar una imagen, puede hacer:

<syntaxhighlight lang="bash">
podman image rm hello-world
</syntaxhighlight>

= Paso 13: Varios podman a la vez (podman-compose) =

Antes de comenzar, vamos a parar todos los contenedores que tengamos abiertos,
para dejar el entorno de podman limpio, que nos vendrá bien para esta parte.

Cuando queremos ejecutar varios contenedores a la vez y que estén conectados
entre ellos fácilmente, utilizaremos podman-compose, donde con un fichero de
configuración simple en yaml, tendremos toda la configuración de lo que vamos a
ejecutar.

Primero vamos a instalar podman-compose:

<syntaxhighlight lang="bash">
sudo apt install podman-compose
</syntaxhighlight>

Ahora veamos un pequeño ejemplo donde explicaremos todos los detalles para crear
un podman-compose, en este caso, el nombre por defecto de los ficheros suele ser
podman-compose.yml, y el contenido será similar a:

<syntaxhighlight lang="bash">
version: '3'

services:
web:
container_name: web
restart: always
build:
context: .
ports:
- "8000:8000"
volumes:
- /home/ubuntu/volume:/volumen:rw
environment:
USERNAME: test
web2:
container_name: web2
build:
dockerfile: Dockerfile
context: .
depends_on:
- web
command: touch web2
web3:
container_name: web3
restart: on-failure
image: pstauffer/curl
depends_on:
- web
command: curl -X GET web:8000/welcome?username=web3
</syntaxhighlight>

En el podman-compose definimos diferentes servicios a ejecutar, en nuestro caso
hemos iniciado tres servicios diferentes, web, web2 y web3:

El primer servicio, web:

* container_name: para darle un nombre por defecto al contenedor cuando se cree
* restart: pueden ser:
** "no": si la máquina termina, no se vuelve a iniciar (opción por defecto)
** always: siempre que el contenedor termine, intenta iniciarse de nuevo
** on-failure: solo intenta reiniciarse si el contenedor termina con fallo
** unless-stopped: solo reinicia el contenedor si el usuario es el que lo termina
* Utilizará el fichero Dockerfile creado en el paso 11 para generar la imagen a usar.
* Expondrá el puerto 8000 del contenedor en el 8000 de nuestra máquina
* Montará un volumen, se hace de forma similar a la línea de comandos
* Creará una variable de entorno

El segundo servicio, web2:

* Utilizará el fichero Dockerfile también, la diferencia entre este y el primer servicio, es que si el nombre del Dockerfile cambia, tendremos que hacerlo de esta segunda forma, la primera por defecto solo buscará el fichero Dockerfile
* depends_on hará que para ejecutar este servicio, su dependencia tenga ya que estar iniciada
* Ejecutaremos un comando el cual sustituirá al comando de la imagen

El tercer servicio, web3:

* Utilizará la imagen ostauffer/curl que es un imagen mínima que contiene el comando curl
* restart: en este caso, hasta que el comando no se ejecute correctamente, se seguirá reiniciando el contenedor
* depends_on igual que el servicio 2, dependerá del servicio 1
* Ejecutaremos un comando para llamar desde el servicio 3 al servicio 1

== Paso 13.1: Construir podman-compose ==

En el caso de existir servicios que tengan Dockerfiles, esto hará que se construyan previamente, como hacer un podman build de cada uno de los servicios que contenga un Dockerfile:

<syntaxhighlight lang="bash">
podman-compose build
</syntaxhighlight>

Con esto se generarán las imágenes necesarias para ejecutar todos los servicios.

== Paso 13.2: Iniciar podman-compose ==

Para iniciar todos los servicios, ejecutaremos:

<syntaxhighlight lang="bash">
podman-compose up -d
</syntaxhighlight>

Después de esto podremos ver el logs de todos los servicios:

<syntaxhighlight lang="bash">
podman-compose logs -f
</syntaxhighlight>

Aquí veremos que el servicio 3 ha conseguido llamar correctamente al servicio 1.

Ahora veremos como podman-compose ha creado los contenedores:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

La salida será similar a la siguiente:

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
219a4118244c pstauffer/curl "curl -X GET web:800…" 6 seconds ago Exited (0) 3 seconds ago web3
c97e894cb3ae ubuntu_web2 "touch web2" 6 seconds ago Exited (0) 4 seconds ago web2
f35d034204fc ubuntu_web "/bin/sh -c 'hug -f …" 6 seconds ago Up 5 seconds 0.0.0.0:8000->8000/tcp web
</syntaxhighlight>

Aquí vemos varios detalles:

* El nombre que le hemos dado en el podman-compose ha funcionado correctamente
* Vemos que los comandos son los correctos también
* web2 está parado por que la política de reinicio es apagar cuando se termine de ejecutar un comando
* web 3 está parado por que el comando ha terminado con un salida correcta

Vamos a comprobar ahora que en el servicio web está todo correcto:

<syntaxhighlight lang="bash">
podman exec -ti web ash
echo $USERNAME
ls /volumen
exit
</syntaxhighlight>

Podemos comprobar que tanto cambiar la variable de entorno como crear un
volumen ha funcionado correctamente.

== Paso 13.3: Parar podman-compose ==

Para parar todos los servicios:

<syntaxhighlight lang="bash">
podman-compose down
</syntaxhighlight>

Comprobamos:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Vemos que han desaparecido todos los contenedores.

= Paso 14: Ejercicios =

== Ejercicio 1: Image derivada de Debian con el programa sl ==

Lance un contenedor a partir de una imagen de Debian, instale el programa sl, ejecute sl (desde fuera del contenedor) y detenga el contenedor.

== Ejercicio 2 ==

== Ejercicio 3: Variante de httpd ==

Construya una imagen ''httpd-hola-mundo'' a partir de la imagen ''httpd''. El fichero de index.html de la carpeta htdocs/ tiene que mostrar el mensaje "hola mundo".

<syntaxhighlight lang="bash">
podman pull httpd
</syntaxhighlight>

Edita el fichero Dockerfile:

<syntaxhighlight lang="bash">
nano Dockerfile
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
FROM httpd

COPY index.html htdocs/index.html
</syntaxhighlight>

Edita el fichero index.html:

<syntaxhighlight lang="bash">
nano index.html
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

Construye la imagen:

<syntaxhighlight lang="bash">
podman build -t mihttpd -f Dockerfile .
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen:

<syntaxhighlight lang="bash">
podman run --name mihttpd -d -p 8080:80 mihttpd
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código:
<syntaxhighlight lang="bash">
curl -X GET http://localhost:8080
</syntaxhighlight>

Tiene que salir por pantalla esto:
<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

== Ejercicio 4: aplicación flask ==

Flask es un framework python para implementar webs. Cree una imagen "miapp-flask" a partir de la imagen de "python":

* Instale flask mediante: pip install flask
* Cree la carpeta "app"
* Establezca la variable FLASK_APP a "hello.py"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"

El fichero hello.py contiene un "hola mundo" para Flask:

<syntaxhighlight lang="python">
from flask import Flask
app = Flask(__name__)

@app.route("/")
def hello():
return "Hello World!"

if __name__ == "__main__":
app.run()
</syntaxhighlight>

Solución con alpine:

<syntaxhighlight lang="bash">
FROM python:alpine

RUN mkdir /app
RUN pip install flask
ENV FLASK_APP="app/hello.py"
COPY hello.py
WORKDIR /
CMD flask run --host=0.0.0.0
</syntaxhighlight>

Solución con Ubuntu:

<syntaxhighlight lang="bash">
FROM ubuntu:bionic

RUN apt-get update
RUN apt-get -y install python python-pip wget
RUN pip install Flask
ENV FLASK_APP="app/hello.py"
RUN mkdir /app
COPY hello.py /app
CMD flask run --host=0.0.0.0
</syntaxhighlight>

== Ejercicio 5: mysql ==

'''EN LA MÁQUINA VIRTUAL:'''

mkdir miapp
cd miapp
podman pull mysql
nano Dockerfile

<syntaxhighlight lang="bash">
FROM mysql
ENV MYSQL_ROOT_PASSWORD="lacontraseñaqueyoquiera"
RUN mkdir /app
WORKDIR /app

</syntaxhighlight>

CTRL+O , ENTER Y CTRL+X (para guardar Dockerfile y salir)

podman build -ti mrfdocker -f Dockerfile .
podman run --name mymrf --rm -p 8001:3306 mrfdocker
docker images

'''EN LA TERMINAL DEL HOST:'''

''Instalación de mysql:''

apt install mysql-client-core-5.7
apt-get install mysql-server
service mysql start

''Para entrar:''

mysql -u root -p -P 8001

Una vez dentro de msql:

mysql> show databases;

''Para salir:''

exit

== Ejercicio 6: python pyramid ==

Pyramid es un framework python para implementar webs. Cree una imagen "miapp-pyramid":

* Emplee la imagen de Ubuntu como referencia, instale los paquetes python y python-pip.
* Instale Pyramid mediante: pip install pyramid
* Cree la carpeta "app"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"
* La aplicación se lanza con la orden: python hello.py
* Compruebe que funciona con curl, la ruta a la web es http://127.0.0.1:8000/hello, suponiendo que ha empleado el puerto 8000 para exponer el servicio.

El fichero hello.py contiene un "hola mundo" para Pyramid:

<syntaxhighlight lang="bash">
from wsgiref.simple_server import make_server
from pyramid.config import Configurator
from pyramid.response import Response

def hello_world(request):
print('Request inbound!')
return Response('Podman works with Pyramid!')

if __name__ == '__main__':
config = Configurator()
config.add_route('hello', '/')
config.add_view(hello_world, route_name='hello')
app = config.make_wsgi_app()
server = make_server('0.0.0.0', 6543, app)
server.serve_forever()
</syntaxhighlight>

Este programa recibe peticiones en el puerto 6543.

== Ejercicio 7 ==

Cree una imagen derivada de Ubuntu, instale el paquete apache2, php y libapache2-mod-php.
Active el módulo de php para apache2 mediante la orden:

<syntaxhighlight lang="bash">
a2enmod php
</syntaxhighlight>

Cree la carpeta /var/www/php.

Cree el fichero index.php

<syntaxhighlight lang="php">
<?php
Print "Hello, World!";
?>
</syntaxhighlight>

y copielo a /var/www/php/.

Cree el fichero 000-default.conf y copielo a /etc/apache2/sites-enabled/

Dicho fichero contiene.

<syntaxhighlight lang="bash">
<VirtualHost *:80>
DocumentRoot /var/www/php

<Directory /var/www/php/>
Options Indexes FollowSymLinks MultiViews
AllowOverride All
Order deny,allow
Allow from all
</Directory>

ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>
</syntaxhighlight>

Tiene que lanzar apache con la orden: apachectl -D FOREGROUND

Tras crear la imagen, láncela mapeando el puerto 8888 al 80, pruebe que puede acceder a http://127.0.0.1:8888/php/ mediante curl

Solución:

<syntaxhighlight lang="bash">
FROM ubuntu:latest

RUN apt-get update
RUN apt-get install -y tzdata
RUN apt-get install -y apache2
RUN apt-get install -y php
RUN apt-get install -y libapache2-mod-php
RUN a2enmod php7.2
COPY index.php /var/www/php
COPY 000-default.conf /etc/apache2/sites-enabled/
CMD apachectl -D FOREGROUND
</syntaxhighlight>

Y para lanzarlo:

podman run --name my-app --rm -d -p 8001:8000 app:v1

y para probarlo:

curl -X GET http://127.0.0.1:8888/php/

== Ejercicio 8 ==

Instale el paquete ''netcat-traditional'' en una imagen de contenedor de ''ubuntu''. Lance la orden:

nc -u -l -p 8080

en el contenedor. Asegúrese de crear una redirección de puertos de 9999 desde el ''host'' al puerto 8080 en el contenedor.

Desde fuera del contenedor, pruebe a conectarse con:

nc -u 127.0.0.1 9999

== Ejercicio 9 ==

Cree una imagen derivada de "ubuntu" con un Dockerfile que incluya soporte de python y lance el siguiente código en Python:

<syntaxhighlight lang="python">
from http.server import BaseHTTPRequestHandler, HTTPServer
import time

hostName = "0.0.0.0"
serverPort = 8080

class MyServer(BaseHTTPRequestHandler):
def do_GET(self):
self.send_response(200)
self.send_header("Content-type", "text/html")
self.end_headers()
self.wfile.write(bytes("<html><head><title>Welcome!</title></head>", "utf-8"))
self.wfile.write(bytes("<body>", "utf-8"))
self.wfile.write(bytes("This is an example web server.", "utf-8"))
self.wfile.write(bytes("</body></html>", "utf-8"))

if __name__ == "__main__":
webServer = HTTPServer((hostName, serverPort), MyServer)
print("Server started http://%s:%s" % (hostName, serverPort))

try:
webServer.serve_forever()
except KeyboardInterrupt:
pass

webServer.server_close()
print("Server stopped.")
</syntaxhighlight>

Llame a su imagen "python-http-server". Lance una instancia de la imagen "python-http-server" mapeando el puerto 9999 al puerto 8888/tcp del contenedor. Compruebe con:

<syntax lang="bash">
curl http://127.0.0.1:9999/
</syntax>

que muestre la página HTML que ofrece el servidor, que debería ser:

<syntax lang="bash">
<html><head><title>Welcome!</title></head><body>This is an example web server.</body></html>
</syntax>

Contenedores

2025-12-09T16:10:10Z

Pneira: /* Paso 9: Ejecutar un comando dentro de un contenedor en ejecución */

En esta práctica aprenderemos a utilizar [https://es.wikipedia.org/wiki/Podman podman] para desplegar contenedores.

= Paso 1: Instalar podman =

Para instalar el paquete oficial:

<syntaxhighlight lang="bash">
apt install podman
</syntaxhighlight>

podman es un clon de '''docker''.

= Paso 2: Repositorio de imágenes de contenedores DockerHub =

Docker ofrece un servicio de nube denominado ''DockerHub'' que puede ser empleado como red social para compartir tus imágenes de Podman. En ''DockerHub'' existen además imágenes de contenedores preconfiguradas de software, muchas de ellas oficiales (ofrecidas por el propio fabricante del software) que se podrán emplear como base para construir nuevas imágenes adaptadas a nuestras necesidades.

Podremos realizar búsquedas en este repositorio ''DockerHub'' puedes emplear el siguiente comando:

<syntaxhighlight lang="bash">
podman search docker.io/library/hello-world
</syntaxhighlight>

Para descargarnos la imagen de ''hello-world'' podemos usar la orden ''pull'':

<syntaxhighlight lang="bash">
podman pull docker.io/library/hello-world
</syntaxhighlight>

También podemos publicar imágenes propias, esto require '''registro de usuario''' en la nube de ''DockerHub'', lo que '''no''' es obligatorio para la realización de esta práctica. Para subir una imagen, hay que validarse como usuario en la nube de ''DockerHub'':

<syntaxhighlight lang="bash">
podman login
</syntaxhighlight>

Tras introducir tu usuario y contraseña, puedes comenzar a publicar tus propias imágenes.

<syntaxhighlight lang="bash">
podman push MI_IMAGEN
</syntaxhighlight>

Este paso es '''opcional''', sólo en caso de que se quieran subir imágenes de contenedores a la nube de docker.io.

= Paso 4: Comprobar imágenes en nuestra máquina =

Para ver las imágenes que tenemos en nuestra máquina, utilizaremos el comando:

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Inicialmente, no tenemos imágenes en almacenamiento, podemos descargarnos la imagen oficial de Debian 13 (Trixie):

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian
</syntaxhighlight>

Ahora si, ya debería de aparecernos la imagen ''debian''.

Comentar también que cada imagen puede tener varias etiquetas, por ejemplo, la imagen Debian 12 (Bookworm), cuando la hemos visto en el listado de imágenes, venía con el tag latest, que es el tag que se descarga por defecto, pero nosotros podemos especificar otro, por ejemplo:

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian:bookworm
</syntaxhighlight>

Para traernos la versión de la imagen de Debian 12 ''Bookworm''.

Ahora tendremos dos imágenes con diferente etiqueta, que serían como las diferentes versiones de cada imagen.

= Paso 5: Lanzar un contenedor =

Un contenedor no es más que una imagen de podman ejecutándose, sería similar a
una máquina virtual, aunque mucho más liviano.

Para crear un contenedor, utilizaremos una imagen, en este caso, la imagen
hello-world. Hacemos lo siguiente:

<syntaxhighlight lang="bash">
podman run hello-world
</syntaxhighlight>

Esto nos mostrará el siguiente mensaje si todo está correcto:

<syntaxhighlight lang="bash">
Hello from Docker!
This message shows that your installation appears to be working correctly.

To generate this message, Docker took the following steps:
1. The Docker client contacted the Docker daemon.
2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
(amd64)
3. The Docker daemon created a new container from that image which runs the
executable that produces the output you are currently reading.
4. The Docker daemon streamed that output to the Docker client, which sent it
to your terminal.

To try something more ambitious, you can run an Debian container with:
$ podman run -it debian bash

Share images, automate workflows, and more with a free Docker ID:
https://hub.docker.com/

For more examples and ideas, visit:
https://docs.docker.com/get-started/
</syntaxhighlight>

Al crear los contenedores utilizando el comando 'run', tenemos varias opciones:

* Lanzar una terminal en el contenedor en modo interactivo
* Lanzar en segundo plano y conectarnos posteriormente al contenedor

== Paso 5.1: Lanzar una terminal en el contenedor en modo interactivo (-ti) ==

Para este ejemplo vamos a utilizar otra imagen diferente, en este caso vamos a utilizar una imagen de debian.

Vamos a lanzar un contenedor y ejecutar una terminal en el que se va a ejecutar el programa '''bash''' que me ofrece un interprete de órdenes:

<syntaxhighlight lang="bash">
podman run -ti debian bash
</syntaxhighlight>

La opción ''-t'' indica que se crea un terminal en el contenedor. Y la opción ''-i'' indica que el contenedor se ejecuta en modo interactivo.

Al acceder al contenedor de ''debian'' nos aparece un ''hash'' en el prompt de la shell, que identifica a la instancia del contenedor (es valor es similar al que muestra la orden ''podman container ls'').

Para salir del contenedor, escribimos 'exit' o pulsamos ''CTRL + D''

== Paso 5.2 Lanzar en segundo plano (-d) ==

Otro ejemplo, con la imagen de Debian:

<syntaxhighlight lang="bash">
podman run -dti debian
</syntaxhighlight>

que muestra un hash que identifica de forma única el contenedor lanzado:

<syntaxhighlight lang="bash">
2ec1daae4676a4e84dc04fd91399c1dfe92119544ff12ee307991fe573d3db64
</syntaxhighlight>

Mediante el comando ''attach'' puedo entrar al contenedor:

<syntaxhighlight lang="bash">
podman attach 2ec1daae4676
</syntaxhighlight>

Para salir, pulsamos ''CTRL + P'' seguido de ''CTRL + Q''.

De manera similar, puedo lanzar en segundo plano la imagen de contenedor de ''hello-world'':

<syntaxhighlight lang="bash">
podman run -d hello-world
</syntaxhighlight>

Y consultar los logs:

<syntaxhighlight lang="bash">
podman logs b67fae3312bc321
</syntaxhighlight>

== Paso 5.3: Añadir variables de entorno a un contenedor ==

Utilizaremos la imagen anterior, y vamos a añadir una variable de entorno
llamada TEST que contenga el valor 'test'. A parte, también ejecutaremos la
terminal como antes, para comprobar con el comando echo, que la variable de
entorno está creada correctamente:

<syntaxhighlight lang="bash">
podman run -ti -e TEST=test debian bash
</syntaxhighlight>

Ahora, desde el contenedor podemos comprobar el valor de la variable de entorno ''$TEST''.

<syntaxhighlight lang="bash">
echo $TEST
test
</syntaxhighlight>

= Paso 6: Listar contenedores en ejecución =

Hemos estado haciendo pruebas y ejecutando contenedores en el paso anterior, vamos a ver donde se encuentran estos contenedores que hemos ejecutado, y después veremos algunas opciones más del comando run.

Tenemos dos opciones para ver los contenedores:

<syntaxhighlight lang="bash">
podman container ls -a
</syntaxhighlight>

o la versión corta:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Ambas hacen lo mismo, y debería de mostrarnos una salida similar a la siguiente:

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
e2bde5f5500c debian "bash" 6 minutes ago Exited (0) 2 seconds ago pensive_sammet
544ad27dbc3c debian "bash" 7 minutes ago Exited (0) 7 minutes ago serene_elgamal
</syntaxhighlight>

En la información veremos que el contenedor tiene el estado exited, eso quiere decir que no se está ejecutando y ya ha finalizado. Vamos a hacer una prueba para ver un contendor ejecutándose:

<syntaxhighlight lang="bash">
podman run -d debian sleep 30
</syntaxhighlight>

Con el comando sleep 30 esperamos 30 segundos hasta que termine el comando, asíque durante esos 30 segundos, el contenedor estará ejecutándose, veámoslo:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
eacceb27d52d debian "sleep 30" 12 seconds ago Up 11 seconds sharp_pasteur
</syntaxhighlight>

Vamos a ver alguna opciones más de la orden ''run''.

== Paso 6.1: Dar un nombre al contenedor (--name) ==

Por defecto, podman creará automáticamente un nombre como hemos visto en las salidas del comando ''podman ps -a''. Podemos establecer el nombre del contenedor que queramos con la opción ''--name'':

<syntaxhighlight lang="bash">
podman run -ti --name mi_debian debian
</syntaxhighlight>

== Paso 6.2: Eliminar contenedor cuando termine (--rm) ==

Vamos a mezclar todo lo visto anteriormente:

* Lanzar en segundo plano (-d)
* Ejecutar contenedor durante 30 segundos (sleep 30)
* Dar un nombre a la imagen (--name)
* Eliminar contenedor cuando termine (--rm)

<syntaxhighlight lang="bash">
podman run -d --rm --name bye-bye debian sleep 30
</syntaxhighlight>

Antes y una vez pasados los 30 segundos, podemos comprobar que el contenedor ha desaparecido.

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

= Paso 7: Parar y eliminar contenedores =

Para parar contenedores podemos usar el ID o su nombre:

<syntaxhighlight lang="bash">
podman stop my_container
podman stop e4901956f108
podman ps -a
</syntaxhighlight>

Una vez hemos comprobado que han terminado su ejecución, podemos eliminar los ficheros resultantes de su ejecución:

<syntaxhighlight lang="bash">
podman container rm my_container
</syntaxhighlight>

Para borrar todos los contenedores ya finalizados

<syntaxhighlight lang="bash">
podman container prune
</syntaxhighlight>

= Paso 8: Conectarnos a un contenedor que se está ejecutando en segundo plano =

Vamos a ejecutar de nuevo un contenedor que no termine:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a conectarnos a este contenedor que está ejecutándose en segundo
plano:

<syntaxhighlight lang="bash">
podman attach mi-contenedor
</syntaxhighlight>

Veremos la orden bash ejecutándose, para terminar, hacemos un 'CTRL + C', y ahora, veremos que ha pasado con el contenedor:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Lo veremos parado, por que lo que hemos hecho ha sido conectarnos al contenedor
y parar el comando que se estaba ejecutando, así que ahora tenemos el contenedor
finalizado.

''Nota:'' Para salir del contenedor '''sin detenerlo''' hacemos 'CTRL + P' seguido 'CTRL + Q'

= Paso 9: Ejecutar un comando dentro de un contenedor en ejecución =

Vamos a ver otresta vez como ejecutar un comando en un contenedor que ya está
ejecutándose:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a ejecutar un comando en ese contenedor con el nombre ''mi-contenedor''.
El comando exec es similar al comando run, pero para ejecutar un comando dentro de un contenedor:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor ls
</syntaxhighlight>

Para redirigir la salida a un fichero en el anfitrión:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor ls > x.txt
</syntaxhighlight>

Para redirigir la salida a un fichero ''dentro'' del contenedor, hacemos:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor sh -c "ls > x.txt"
</syntaxhighlight>

También es posible ejecutar comandos con tuberías:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor sh -c "ls -la | grep ^d"
</syntaxhighlight>

= Paso 10: Persistencia en contenedores =

Al hacer ''exit'' y salir de un contenedor, se pierden todos los cambios que hemos realizado. Los

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-ejemplo debian bash
</syntaxhighlight>

Ahora, vamos a crear una carpeta en el contenedor y comprobar que esa carpeta existe:

<syntaxhighlight lang="bash">
podman exec mi-ejemplo mkdir test
podman exec mi-ejemplo ls
</syntaxhighlight>

Veremos que la carpeta existe, pero, ¿qué ocurre si para el contenedor?

<syntaxhighlight lang="bash">
podman container stop mi-ejemplo
</syntaxhighlight>

Y volvemos a lanzarlo:

<syntaxhighlight lang="bash">
podman container rm mi-ejemplo
podman run -d -ti --name mi-ejemplo debian bash
podman exec mi-ejemplo ls
</syntaxhighlight>

Podemos comprobar que la carpeta creada anteriormente, no existe.

¿Qué podemos hacer para mantener la modificaciones realizadas sobre un contenedor?

== Paso 10.1: Crear una imagen derivada de la imagen base ==

Es posible crear una imagen derivada, con modificaciones, a partir de una imagen existente mediante la orden '''commit'''.

Por ejemplo, si queremos una imagen ''debian'' que incluya el programa ''ping'' ya instalado, tendríamos que lanzar un contenedor a partir de la imagen ''ubuntu'':

<syntaxhighlight lang="bash">
podman run -d -ti debian bash
</syntaxhighlight>

Suponiendo que el contenido está identificado con el ID 56ef5b312334

Instalamos el paquete ping:

<syntaxhighlight lang="bash">
podman exec 56ef5b312334 apt -y install ping
</syntaxhighlight>

Generamos la imagen derivada con el nombre ''ubuntu-con-ping'':

<syntaxhighlight lang="bash">
podman commit 56ef5b312334 ubuntu-con-ping
</syntaxhighlight>

Ya podemos para nuestro contendor:

<syntaxhighlight lang="bash">
podman stop 56ef5b312334
</syntaxhighlight>

Y lanzar un nuevo contenedor a partir de la imagen ''debian-con-ping'':

<syntaxhighlight lang="bash">
podman run -d -ti debian-con-ping bash
</syntaxhighlight>

== Paso 10.2: Mantener la persistencia mediante volúmen ==

Otra opción para mantener los datos es montar un volumen al ejecutar el contenedor.

Primero crearemos una carpeta que hará de volumen en nuestra máquina, que será la que luego montemos para podman:

<syntaxhighlight lang="bash">
mkdir /home/debian/volumen
</syntaxhighlight>

Ahora vamos a montar la carpeta al ejecutar el contenedor, lo hacemos con la
opción -v, la cual tiene 3 campos separados por ':':

# El volumen en nuestra máquina
# Donde se montará el volumen dentro del contenedor
# Opciones de mmontaje, por ejemplo rw (read and write) o ro (read only)

<syntaxhighlight lang="bash">
podman run --rm -ti -v /home/debian/volumen:/volumen:rw debian bash
mkdir /volumen/test
touch /volumen/test/file
exit
</syntaxhighlight>

Una vez nos salgamos del contenedor, podemos ver que en nuestra máquina están
los datos:

<syntaxhighlight lang="bash">
ls /home/ubuntu/volumen/
ls /home/ubuntu/volumen/test
</syntaxhighlight>

La próxima vez que ejecutemos un contenedor, si montamos ese volumen, los datos
estarán ahí, además esta forma tiene el beneficio de compartir datos entre
nuestra máquina y el contenedor de forma sencilla.

= Paso 11: Crear nuestra propia imagen de contenedor =

Para crear una imagen de un contenedor con una aplicación de Python hug, creamos en primer lugar la carpeta que contendrá los ficheros que nos permiten crear la imagen.

<syntaxhighlight lang="bash">
mkdir miapp
cd miapp
</syntaxhighlight>

Definimos un fichero ''Dockerfile'' para definir la imagen:

<syntaxhighlight lang="bash">
FROM ubuntu

RUN apt -y update
RUN apt -y upgrade
RUN apt -y install python3-hug
RUN mkdir /app
COPY endpoint.py /app
WORKDIR /app
CMD hug -f endpoint.py
</syntaxhighlight>

Alternativamente, puedes crear un [[Creando imagen propia usando Ubuntu de base|Dockerfile empleando la imagen de Ubuntu]] como base en lugar de Alpine.

Y añadimos el fichero ''endpoint.py'' que emplea el framework Python hug con el contenido siguiente:

<syntaxhighlight lang="bash">
import hug

@hug.get('/welcome')
def welcome(username="unknown"):
""" Say welcome to username """
return "Welcome " + username
</syntaxhighlight>

Este fichero es un ejemplo de uso de Python hug. Si hacemos una petición a /welcome?username="LSO", esto nos devolverá el mensaje "Welcome LSO".

Una vez tengamos los dos ficheros creados en nuestra máquina virtual, podemos construir nuestra imagen:

<syntaxhighlight lang="bash">
podman build -t app:v1 -f Dockerfile .
</syntaxhighlight>

Vamos a explicar para que sirve cada línea:

* FROM: servirá para basarnos en una imagen existente, en este caso, una imagen de python alpine, que contiene python y no ocupa mucho espacio
* ENV: para crear variables de entorno
* RUN: para ejecutar comandos, ya sea para crear una carpeta, instalar dependencias o cualquier otra opción que necesitemos
* COPY: para copiar datos desde nuestra máquina a la imagen
* WORKDIR: para cambiar el directorio de trabajo
* CMD: este comando será ejecutado por defecto al iniciar un contenedor a partir de esta imagen

Esto construirá una imagen podman basada en python:alpine, en la cual hemos
guardado nuestra pequeña aplicación y se va a ejecutar cuando ejecutemos un
contenedor basado en esa imagen. Para comprobar que la imagen se ha creado
correctamente, listamos las imagenes, y debería de aparecernos una imagen con
nombre 'app' y tag 'v1':

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen, y vamos a añadir una nueva
opción, -p 8001:8000. Esta opción hará que el puerto interno 8000 del contenedor
sea expuesto en el puerto 8001 de nuestra máquina:

<syntaxhighlight lang="bash">
podman run --name my-app --rm -d -p 8001:8000 app:v1
</syntaxhighlight>

''Nota:'' podman supone que la redirección de puerto es TCP, para una redirección de puertos UDP, puedes usar:

<syntaxhighlight lang="bash">
... -p 8001:8000/udp
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código. En nuestra
máquina haremos:

<syntaxhighlight lang="bash">
curl -X GET http://localhost:8001/welcome?username=LSO
</syntaxhighlight>

Comprobaremos que la salida del comando curl, es "Welcome LSO".

Antes de terminar, vamos a comprobar otro pequeño detalle que añadimos en
nuestra imagen, la variable de entorno USERNAME, vamos a comprobar que funciona:

<syntaxhighlight lang="bash">
podman exec -ti my-app ash
echo $USERNAME
</syntaxhighlight>

Funciona correctamente, pero al ejecutar el contenedor, podemos cambiar esta
variable de entorno como vimos en uno de los pasos anteriores:

<syntaxhighlight lang="bash">
podman run --rm -ti -e USERNAME=me app:v1 ash
echo $USERNAME
</syntaxhighlight>

Esto nos servirá para tener opciones por defecto y que el usuario pueda
cambiarlo a su antojo, como por ejemplo contraseñas u otros detalles.

= Paso 12: Eliminar imágenes =

Para borrar una imagen, puede hacer:

<syntaxhighlight lang="bash">
podman image rm hello-world
</syntaxhighlight>

= Paso 13: Varios podman a la vez (podman-compose) =

Antes de comenzar, vamos a parar todos los contenedores que tengamos abiertos,
para dejar el entorno de podman limpio, que nos vendrá bien para esta parte.

Cuando queremos ejecutar varios contenedores a la vez y que estén conectados
entre ellos fácilmente, utilizaremos podman-compose, donde con un fichero de
configuración simple en yaml, tendremos toda la configuración de lo que vamos a
ejecutar.

Primero vamos a instalar podman-compose:

<syntaxhighlight lang="bash">
sudo apt install podman-compose
</syntaxhighlight>

Ahora veamos un pequeño ejemplo donde explicaremos todos los detalles para crear
un podman-compose, en este caso, el nombre por defecto de los ficheros suele ser
podman-compose.yml, y el contenido será similar a:

<syntaxhighlight lang="bash">
version: '3'

services:
web:
container_name: web
restart: always
build:
context: .
ports:
- "8000:8000"
volumes:
- /home/ubuntu/volume:/volumen:rw
environment:
USERNAME: test
web2:
container_name: web2
build:
dockerfile: Dockerfile
context: .
depends_on:
- web
command: touch web2
web3:
container_name: web3
restart: on-failure
image: pstauffer/curl
depends_on:
- web
command: curl -X GET web:8000/welcome?username=web3
</syntaxhighlight>

En el podman-compose definimos diferentes servicios a ejecutar, en nuestro caso
hemos iniciado tres servicios diferentes, web, web2 y web3:

El primer servicio, web:

* container_name: para darle un nombre por defecto al contenedor cuando se cree
* restart: pueden ser:
** "no": si la máquina termina, no se vuelve a iniciar (opción por defecto)
** always: siempre que el contenedor termine, intenta iniciarse de nuevo
** on-failure: solo intenta reiniciarse si el contenedor termina con fallo
** unless-stopped: solo reinicia el contenedor si el usuario es el que lo termina
* Utilizará el fichero Dockerfile creado en el paso 11 para generar la imagen a usar.
* Expondrá el puerto 8000 del contenedor en el 8000 de nuestra máquina
* Montará un volumen, se hace de forma similar a la línea de comandos
* Creará una variable de entorno

El segundo servicio, web2:

* Utilizará el fichero Dockerfile también, la diferencia entre este y el primer servicio, es que si el nombre del Dockerfile cambia, tendremos que hacerlo de esta segunda forma, la primera por defecto solo buscará el fichero Dockerfile
* depends_on hará que para ejecutar este servicio, su dependencia tenga ya que estar iniciada
* Ejecutaremos un comando el cual sustituirá al comando de la imagen

El tercer servicio, web3:

* Utilizará la imagen ostauffer/curl que es un imagen mínima que contiene el comando curl
* restart: en este caso, hasta que el comando no se ejecute correctamente, se seguirá reiniciando el contenedor
* depends_on igual que el servicio 2, dependerá del servicio 1
* Ejecutaremos un comando para llamar desde el servicio 3 al servicio 1

== Paso 13.1: Construir podman-compose ==

En el caso de existir servicios que tengan Dockerfiles, esto hará que se construyan previamente, como hacer un podman build de cada uno de los servicios que contenga un Dockerfile:

<syntaxhighlight lang="bash">
podman-compose build
</syntaxhighlight>

Con esto se generarán las imágenes necesarias para ejecutar todos los servicios.

== Paso 13.2: Iniciar podman-compose ==

Para iniciar todos los servicios, ejecutaremos:

<syntaxhighlight lang="bash">
podman-compose up -d
</syntaxhighlight>

Después de esto podremos ver el logs de todos los servicios:

<syntaxhighlight lang="bash">
podman-compose logs -f
</syntaxhighlight>

Aquí veremos que el servicio 3 ha conseguido llamar correctamente al servicio 1.

Ahora veremos como podman-compose ha creado los contenedores:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

La salida será similar a la siguiente:

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
219a4118244c pstauffer/curl "curl -X GET web:800…" 6 seconds ago Exited (0) 3 seconds ago web3
c97e894cb3ae ubuntu_web2 "touch web2" 6 seconds ago Exited (0) 4 seconds ago web2
f35d034204fc ubuntu_web "/bin/sh -c 'hug -f …" 6 seconds ago Up 5 seconds 0.0.0.0:8000->8000/tcp web
</syntaxhighlight>

Aquí vemos varios detalles:

* El nombre que le hemos dado en el podman-compose ha funcionado correctamente
* Vemos que los comandos son los correctos también
* web2 está parado por que la política de reinicio es apagar cuando se termine de ejecutar un comando
* web 3 está parado por que el comando ha terminado con un salida correcta

Vamos a comprobar ahora que en el servicio web está todo correcto:

<syntaxhighlight lang="bash">
podman exec -ti web ash
echo $USERNAME
ls /volumen
exit
</syntaxhighlight>

Podemos comprobar que tanto cambiar la variable de entorno como crear un
volumen ha funcionado correctamente.

== Paso 13.3: Parar podman-compose ==

Para parar todos los servicios:

<syntaxhighlight lang="bash">
podman-compose down
</syntaxhighlight>

Comprobamos:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Vemos que han desaparecido todos los contenedores.

= Paso 14: Ejercicios =

== Ejercicio 1: Image derivada de Debian con el programa sl ==

Lance un contenedor a partir de una imagen de Debian, instale el programa sl, ejecute sl (desde fuera del contenedor) y detenga el contenedor.

== Ejercicio 2 ==

== Ejercicio 3: Variante de httpd ==

Construya una imagen ''httpd-hola-mundo'' a partir de la imagen ''httpd''. El fichero de index.html de la carpeta htdocs/ tiene que mostrar el mensaje "hola mundo".

<syntaxhighlight lang="bash">
podman pull httpd
</syntaxhighlight>

Edita el fichero Dockerfile:

<syntaxhighlight lang="bash">
nano Dockerfile
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
FROM httpd

COPY index.html htdocs/index.html
</syntaxhighlight>

Edita el fichero index.html:

<syntaxhighlight lang="bash">
nano index.html
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

Construye la imagen:

<syntaxhighlight lang="bash">
podman build -t mihttpd -f Dockerfile .
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen:

<syntaxhighlight lang="bash">
podman run --name mihttpd -d -p 8080:80 mihttpd
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código:
<syntaxhighlight lang="bash">
curl -X GET http://localhost:8080
</syntaxhighlight>

Tiene que salir por pantalla esto:
<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

== Ejercicio 4: aplicación flask ==

Flask es un framework python para implementar webs. Cree una imagen "miapp-flask" a partir de la imagen de "python":

* Instale flask mediante: pip install flask
* Cree la carpeta "app"
* Establezca la variable FLASK_APP a "hello.py"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"

El fichero hello.py contiene un "hola mundo" para Flask:

<syntaxhighlight lang="python">
from flask import Flask
app = Flask(__name__)

@app.route("/")
def hello():
return "Hello World!"

if __name__ == "__main__":
app.run()
</syntaxhighlight>

Solución con alpine:

<syntaxhighlight lang="bash">
FROM python:alpine

RUN mkdir /app
RUN pip install flask
ENV FLASK_APP="app/hello.py"
COPY hello.py
WORKDIR /
CMD flask run --host=0.0.0.0
</syntaxhighlight>

Solución con Ubuntu:

<syntaxhighlight lang="bash">
FROM ubuntu:bionic

RUN apt-get update
RUN apt-get -y install python python-pip wget
RUN pip install Flask
ENV FLASK_APP="app/hello.py"
RUN mkdir /app
COPY hello.py /app
CMD flask run --host=0.0.0.0
</syntaxhighlight>

== Ejercicio 5: mysql ==

'''EN LA MÁQUINA VIRTUAL:'''

mkdir miapp
cd miapp
podman pull mysql
nano Dockerfile

<syntaxhighlight lang="bash">
FROM mysql
ENV MYSQL_ROOT_PASSWORD="lacontraseñaqueyoquiera"
RUN mkdir /app
WORKDIR /app

</syntaxhighlight>

CTRL+O , ENTER Y CTRL+X (para guardar Dockerfile y salir)

podman build -ti mrfdocker -f Dockerfile .
podman run --name mymrf --rm -p 8001:3306 mrfdocker
docker images

'''EN LA TERMINAL DEL HOST:'''

''Instalación de mysql:''

apt install mysql-client-core-5.7
apt-get install mysql-server
service mysql start

''Para entrar:''

mysql -u root -p -P 8001

Una vez dentro de msql:

mysql> show databases;

''Para salir:''

exit

== Ejercicio 6: python pyramid ==

Pyramid es un framework python para implementar webs. Cree una imagen "miapp-pyramid":

* Emplee la imagen de Ubuntu como referencia, instale los paquetes python y python-pip.
* Instale Pyramid mediante: pip install pyramid
* Cree la carpeta "app"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"
* La aplicación se lanza con la orden: python hello.py
* Compruebe que funciona con curl, la ruta a la web es http://127.0.0.1:8000/hello, suponiendo que ha empleado el puerto 8000 para exponer el servicio.

El fichero hello.py contiene un "hola mundo" para Pyramid:

<syntaxhighlight lang="bash">
from wsgiref.simple_server import make_server
from pyramid.config import Configurator
from pyramid.response import Response

def hello_world(request):
print('Request inbound!')
return Response('Podman works with Pyramid!')

if __name__ == '__main__':
config = Configurator()
config.add_route('hello', '/')
config.add_view(hello_world, route_name='hello')
app = config.make_wsgi_app()
server = make_server('0.0.0.0', 6543, app)
server.serve_forever()
</syntaxhighlight>

Este programa recibe peticiones en el puerto 6543.

== Ejercicio 7 ==

Cree una imagen derivada de Ubuntu, instale el paquete apache2, php y libapache2-mod-php.
Active el módulo de php para apache2 mediante la orden:

<syntaxhighlight lang="bash">
a2enmod php
</syntaxhighlight>

Cree la carpeta /var/www/php.

Cree el fichero index.php

<syntaxhighlight lang="php">
<?php
Print "Hello, World!";
?>
</syntaxhighlight>

y copielo a /var/www/php/.

Cree el fichero 000-default.conf y copielo a /etc/apache2/sites-enabled/

Dicho fichero contiene.

<syntaxhighlight lang="bash">
<VirtualHost *:80>
DocumentRoot /var/www/php

<Directory /var/www/php/>
Options Indexes FollowSymLinks MultiViews
AllowOverride All
Order deny,allow
Allow from all
</Directory>

ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>
</syntaxhighlight>

Tiene que lanzar apache con la orden: apachectl -D FOREGROUND

Tras crear la imagen, láncela mapeando el puerto 8888 al 80, pruebe que puede acceder a http://127.0.0.1:8888/php/ mediante curl

Solución:

<syntaxhighlight lang="bash">
FROM ubuntu:latest

RUN apt-get update
RUN apt-get install -y tzdata
RUN apt-get install -y apache2
RUN apt-get install -y php
RUN apt-get install -y libapache2-mod-php
RUN a2enmod php7.2
COPY index.php /var/www/php
COPY 000-default.conf /etc/apache2/sites-enabled/
CMD apachectl -D FOREGROUND
</syntaxhighlight>

Y para lanzarlo:

podman run --name my-app --rm -d -p 8001:8000 app:v1

y para probarlo:

curl -X GET http://127.0.0.1:8888/php/

== Ejercicio 8 ==

Instale el paquete ''netcat-traditional'' en una imagen de contenedor de ''ubuntu''. Lance la orden:

nc -u -l -p 8080

en el contenedor. Asegúrese de crear una redirección de puertos de 9999 desde el ''host'' al puerto 8080 en el contenedor.

Desde fuera del contenedor, pruebe a conectarse con:

nc -u 127.0.0.1 9999

== Ejercicio 9 ==

Cree una imagen derivada de "ubuntu" con un Dockerfile que incluya soporte de python y lance el siguiente código en Python:

<syntax lang="python">
from http.server import BaseHTTPRequestHandler, HTTPServer
import time

hostName = "0.0.0.0"
serverPort = 8080

class MyServer(BaseHTTPRequestHandler):
def do_GET(self):
self.send_response(200)
self.send_header("Content-type", "text/html")
self.end_headers()
self.wfile.write(bytes("<html><head><title>Welcome!</title></head>", "utf-8"))
self.wfile.write(bytes("<body>", "utf-8"))
self.wfile.write(bytes("This is an example web server.", "utf-8"))
self.wfile.write(bytes("</body></html>", "utf-8"))

if __name__ == "__main__":
webServer = HTTPServer((hostName, serverPort), MyServer)
print("Server started http://%s:%s" % (hostName, serverPort))

try:
webServer.serve_forever()
except KeyboardInterrupt:
pass

webServer.server_close()
print("Server stopped.")
</syntax>

Llame a su imagen "python-http-server". Lance una instancia de la imagen "python-http-server" mapeando el puerto 9999 al puerto 8888/tcp del contenedor. Compruebe con:

<syntax lang="bash">
curl http://127.0.0.1:9999/
</syntax>

que muestre la página HTML que ofrece el servidor, que debería ser:

<syntax lang="bash">
<html><head><title>Welcome!</title></head><body>This is an example web server.</body></html>
</syntax>

Contenedores

2025-12-09T15:57:34Z

Pneira: /* Paso 7: Parar y eliminar contenedores */

En esta práctica aprenderemos a utilizar [https://es.wikipedia.org/wiki/Podman podman] para desplegar contenedores.

= Paso 1: Instalar podman =

Para instalar el paquete oficial:

<syntaxhighlight lang="bash">
apt install podman
</syntaxhighlight>

podman es un clon de '''docker''.

= Paso 2: Repositorio de imágenes de contenedores DockerHub =

Docker ofrece un servicio de nube denominado ''DockerHub'' que puede ser empleado como red social para compartir tus imágenes de Podman. En ''DockerHub'' existen además imágenes de contenedores preconfiguradas de software, muchas de ellas oficiales (ofrecidas por el propio fabricante del software) que se podrán emplear como base para construir nuevas imágenes adaptadas a nuestras necesidades.

Podremos realizar búsquedas en este repositorio ''DockerHub'' puedes emplear el siguiente comando:

<syntaxhighlight lang="bash">
podman search docker.io/library/hello-world
</syntaxhighlight>

Para descargarnos la imagen de ''hello-world'' podemos usar la orden ''pull'':

<syntaxhighlight lang="bash">
podman pull docker.io/library/hello-world
</syntaxhighlight>

También podemos publicar imágenes propias, esto require '''registro de usuario''' en la nube de ''DockerHub'', lo que '''no''' es obligatorio para la realización de esta práctica. Para subir una imagen, hay que validarse como usuario en la nube de ''DockerHub'':

<syntaxhighlight lang="bash">
podman login
</syntaxhighlight>

Tras introducir tu usuario y contraseña, puedes comenzar a publicar tus propias imágenes.

<syntaxhighlight lang="bash">
podman push MI_IMAGEN
</syntaxhighlight>

Este paso es '''opcional''', sólo en caso de que se quieran subir imágenes de contenedores a la nube de docker.io.

= Paso 4: Comprobar imágenes en nuestra máquina =

Para ver las imágenes que tenemos en nuestra máquina, utilizaremos el comando:

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Inicialmente, no tenemos imágenes en almacenamiento, podemos descargarnos la imagen oficial de Debian 13 (Trixie):

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian
</syntaxhighlight>

Ahora si, ya debería de aparecernos la imagen ''debian''.

Comentar también que cada imagen puede tener varias etiquetas, por ejemplo, la imagen Debian 12 (Bookworm), cuando la hemos visto en el listado de imágenes, venía con el tag latest, que es el tag que se descarga por defecto, pero nosotros podemos especificar otro, por ejemplo:

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian:bookworm
</syntaxhighlight>

Para traernos la versión de la imagen de Debian 12 ''Bookworm''.

Ahora tendremos dos imágenes con diferente etiqueta, que serían como las diferentes versiones de cada imagen.

= Paso 5: Lanzar un contenedor =

Un contenedor no es más que una imagen de podman ejecutándose, sería similar a
una máquina virtual, aunque mucho más liviano.

Para crear un contenedor, utilizaremos una imagen, en este caso, la imagen
hello-world. Hacemos lo siguiente:

<syntaxhighlight lang="bash">
podman run hello-world
</syntaxhighlight>

Esto nos mostrará el siguiente mensaje si todo está correcto:

<syntaxhighlight lang="bash">
Hello from Docker!
This message shows that your installation appears to be working correctly.

To generate this message, Docker took the following steps:
1. The Docker client contacted the Docker daemon.
2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
(amd64)
3. The Docker daemon created a new container from that image which runs the
executable that produces the output you are currently reading.
4. The Docker daemon streamed that output to the Docker client, which sent it
to your terminal.

To try something more ambitious, you can run an Debian container with:
$ podman run -it debian bash

Share images, automate workflows, and more with a free Docker ID:
https://hub.docker.com/

For more examples and ideas, visit:
https://docs.docker.com/get-started/
</syntaxhighlight>

Al crear los contenedores utilizando el comando 'run', tenemos varias opciones:

* Lanzar una terminal en el contenedor en modo interactivo
* Lanzar en segundo plano y conectarnos posteriormente al contenedor

== Paso 5.1: Lanzar una terminal en el contenedor en modo interactivo (-ti) ==

Para este ejemplo vamos a utilizar otra imagen diferente, en este caso vamos a utilizar una imagen de debian.

Vamos a lanzar un contenedor y ejecutar una terminal en el que se va a ejecutar el programa '''bash''' que me ofrece un interprete de órdenes:

<syntaxhighlight lang="bash">
podman run -ti debian bash
</syntaxhighlight>

La opción ''-t'' indica que se crea un terminal en el contenedor. Y la opción ''-i'' indica que el contenedor se ejecuta en modo interactivo.

Al acceder al contenedor de ''debian'' nos aparece un ''hash'' en el prompt de la shell, que identifica a la instancia del contenedor (es valor es similar al que muestra la orden ''podman container ls'').

Para salir del contenedor, escribimos 'exit' o pulsamos ''CTRL + D''

== Paso 5.2 Lanzar en segundo plano (-d) ==

Otro ejemplo, con la imagen de Debian:

<syntaxhighlight lang="bash">
podman run -dti debian
</syntaxhighlight>

que muestra un hash que identifica de forma única el contenedor lanzado:

<syntaxhighlight lang="bash">
2ec1daae4676a4e84dc04fd91399c1dfe92119544ff12ee307991fe573d3db64
</syntaxhighlight>

Mediante el comando ''attach'' puedo entrar al contenedor:

<syntaxhighlight lang="bash">
podman attach 2ec1daae4676
</syntaxhighlight>

Para salir, pulsamos ''CTRL + P'' seguido de ''CTRL + Q''.

De manera similar, puedo lanzar en segundo plano la imagen de contenedor de ''hello-world'':

<syntaxhighlight lang="bash">
podman run -d hello-world
</syntaxhighlight>

Y consultar los logs:

<syntaxhighlight lang="bash">
podman logs b67fae3312bc321
</syntaxhighlight>

== Paso 5.3: Añadir variables de entorno a un contenedor ==

Utilizaremos la imagen anterior, y vamos a añadir una variable de entorno
llamada TEST que contenga el valor 'test'. A parte, también ejecutaremos la
terminal como antes, para comprobar con el comando echo, que la variable de
entorno está creada correctamente:

<syntaxhighlight lang="bash">
podman run -ti -e TEST=test debian bash
</syntaxhighlight>

Ahora, desde el contenedor podemos comprobar el valor de la variable de entorno ''$TEST''.

<syntaxhighlight lang="bash">
echo $TEST
test
</syntaxhighlight>

= Paso 6: Listar contenedores en ejecución =

Hemos estado haciendo pruebas y ejecutando contenedores en el paso anterior, vamos a ver donde se encuentran estos contenedores que hemos ejecutado, y después veremos algunas opciones más del comando run.

Tenemos dos opciones para ver los contenedores:

<syntaxhighlight lang="bash">
podman container ls -a
</syntaxhighlight>

o la versión corta:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Ambas hacen lo mismo, y debería de mostrarnos una salida similar a la siguiente:

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
e2bde5f5500c debian "bash" 6 minutes ago Exited (0) 2 seconds ago pensive_sammet
544ad27dbc3c debian "bash" 7 minutes ago Exited (0) 7 minutes ago serene_elgamal
</syntaxhighlight>

En la información veremos que el contenedor tiene el estado exited, eso quiere decir que no se está ejecutando y ya ha finalizado. Vamos a hacer una prueba para ver un contendor ejecutándose:

<syntaxhighlight lang="bash">
podman run -d debian sleep 30
</syntaxhighlight>

Con el comando sleep 30 esperamos 30 segundos hasta que termine el comando, asíque durante esos 30 segundos, el contenedor estará ejecutándose, veámoslo:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
eacceb27d52d debian "sleep 30" 12 seconds ago Up 11 seconds sharp_pasteur
</syntaxhighlight>

Vamos a ver alguna opciones más de la orden ''run''.

== Paso 6.1: Dar un nombre al contenedor (--name) ==

Por defecto, podman creará automáticamente un nombre como hemos visto en las salidas del comando ''podman ps -a''. Podemos establecer el nombre del contenedor que queramos con la opción ''--name'':

<syntaxhighlight lang="bash">
podman run -ti --name mi_debian debian
</syntaxhighlight>

== Paso 6.2: Eliminar contenedor cuando termine (--rm) ==

Vamos a mezclar todo lo visto anteriormente:

* Lanzar en segundo plano (-d)
* Ejecutar contenedor durante 30 segundos (sleep 30)
* Dar un nombre a la imagen (--name)
* Eliminar contenedor cuando termine (--rm)

<syntaxhighlight lang="bash">
podman run -d --rm --name bye-bye debian sleep 30
</syntaxhighlight>

Antes y una vez pasados los 30 segundos, podemos comprobar que el contenedor ha desaparecido.

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

= Paso 7: Parar y eliminar contenedores =

Para parar contenedores podemos usar el ID o su nombre:

<syntaxhighlight lang="bash">
podman stop my_container
podman stop e4901956f108
podman ps -a
</syntaxhighlight>

Una vez hemos comprobado que han terminado su ejecución, podemos eliminar los ficheros resultantes de su ejecución:

<syntaxhighlight lang="bash">
podman container rm my_container
</syntaxhighlight>

Para borrar todos los contenedores ya finalizados

<syntaxhighlight lang="bash">
podman container prune
</syntaxhighlight>

= Paso 8: Conectarnos a un contenedor que se está ejecutando en segundo plano =

Vamos a ejecutar de nuevo un contenedor que no termine:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a conectarnos a este contenedor que está ejecutándose en segundo
plano:

<syntaxhighlight lang="bash">
podman attach mi-contenedor
</syntaxhighlight>

Veremos la orden bash ejecutándose, para terminar, hacemos un 'CTRL + C', y ahora, veremos que ha pasado con el contenedor:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Lo veremos parado, por que lo que hemos hecho ha sido conectarnos al contenedor
y parar el comando que se estaba ejecutando, así que ahora tenemos el contenedor
finalizado.

''Nota:'' Para salir del contenedor '''sin detenerlo''' hacemos 'CTRL + P' seguido 'CTRL + Q'

= Paso 9: Ejecutar un comando dentro de un contenedor en ejecución =

Vamos a ver otresta vez como ejecutar un comando en un contenedor que ya está
ejecutándose:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a ejecutar un comando en ese contenedor con el nombre ''mi-contenedor''.
El comando exec es similar al comando run, pero para ejecutar un comando dentro de un contenedor:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor ls
</syntaxhighlight>

Para redirigir la salida a un fichero en el anfitrión:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor ls > x.txt
</syntaxhighlight>

Para redirigir la salida a un fichero ''dentro'' del contenedor, hacemos:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor bash -c "ls > x.txt"
</syntaxhighlight>

= Paso 10: Persistencia en contenedores =

Al hacer ''exit'' y salir de un contenedor, se pierden todos los cambios que hemos realizado. Los

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-ejemplo debian bash
</syntaxhighlight>

Ahora, vamos a crear una carpeta en el contenedor y comprobar que esa carpeta existe:

<syntaxhighlight lang="bash">
podman exec mi-ejemplo mkdir test
podman exec mi-ejemplo ls
</syntaxhighlight>

Veremos que la carpeta existe, pero, ¿qué ocurre si para el contenedor?

<syntaxhighlight lang="bash">
podman container stop mi-ejemplo
</syntaxhighlight>

Y volvemos a lanzarlo:

<syntaxhighlight lang="bash">
podman container rm mi-ejemplo
podman run -d -ti --name mi-ejemplo debian bash
podman exec mi-ejemplo ls
</syntaxhighlight>

Podemos comprobar que la carpeta creada anteriormente, no existe.

¿Qué podemos hacer para mantener la modificaciones realizadas sobre un contenedor?

== Paso 10.1: Crear una imagen derivada de la imagen base ==

Es posible crear una imagen derivada, con modificaciones, a partir de una imagen existente mediante la orden '''commit'''.

Por ejemplo, si queremos una imagen ''debian'' que incluya el programa ''ping'' ya instalado, tendríamos que lanzar un contenedor a partir de la imagen ''ubuntu'':

<syntaxhighlight lang="bash">
podman run -d -ti debian bash
</syntaxhighlight>

Suponiendo que el contenido está identificado con el ID 56ef5b312334

Instalamos el paquete ping:

<syntaxhighlight lang="bash">
podman exec 56ef5b312334 apt -y install ping
</syntaxhighlight>

Generamos la imagen derivada con el nombre ''ubuntu-con-ping'':

<syntaxhighlight lang="bash">
podman commit 56ef5b312334 ubuntu-con-ping
</syntaxhighlight>

Ya podemos para nuestro contendor:

<syntaxhighlight lang="bash">
podman stop 56ef5b312334
</syntaxhighlight>

Y lanzar un nuevo contenedor a partir de la imagen ''debian-con-ping'':

<syntaxhighlight lang="bash">
podman run -d -ti debian-con-ping bash
</syntaxhighlight>

== Paso 10.2: Mantener la persistencia mediante volúmen ==

Otra opción para mantener los datos es montar un volumen al ejecutar el contenedor.

Primero crearemos una carpeta que hará de volumen en nuestra máquina, que será la que luego montemos para podman:

<syntaxhighlight lang="bash">
mkdir /home/debian/volumen
</syntaxhighlight>

Ahora vamos a montar la carpeta al ejecutar el contenedor, lo hacemos con la
opción -v, la cual tiene 3 campos separados por ':':

# El volumen en nuestra máquina
# Donde se montará el volumen dentro del contenedor
# Opciones de mmontaje, por ejemplo rw (read and write) o ro (read only)

<syntaxhighlight lang="bash">
podman run --rm -ti -v /home/debian/volumen:/volumen:rw debian bash
mkdir /volumen/test
touch /volumen/test/file
exit
</syntaxhighlight>

Una vez nos salgamos del contenedor, podemos ver que en nuestra máquina están
los datos:

<syntaxhighlight lang="bash">
ls /home/ubuntu/volumen/
ls /home/ubuntu/volumen/test
</syntaxhighlight>

La próxima vez que ejecutemos un contenedor, si montamos ese volumen, los datos
estarán ahí, además esta forma tiene el beneficio de compartir datos entre
nuestra máquina y el contenedor de forma sencilla.

= Paso 11: Crear nuestra propia imagen de contenedor =

Para crear una imagen de un contenedor con una aplicación de Python hug, creamos en primer lugar la carpeta que contendrá los ficheros que nos permiten crear la imagen.

<syntaxhighlight lang="bash">
mkdir miapp
cd miapp
</syntaxhighlight>

Definimos un fichero ''Dockerfile'' para definir la imagen:

<syntaxhighlight lang="bash">
FROM ubuntu

RUN apt -y update
RUN apt -y upgrade
RUN apt -y install python3-hug
RUN mkdir /app
COPY endpoint.py /app
WORKDIR /app
CMD hug -f endpoint.py
</syntaxhighlight>

Alternativamente, puedes crear un [[Creando imagen propia usando Ubuntu de base|Dockerfile empleando la imagen de Ubuntu]] como base en lugar de Alpine.

Y añadimos el fichero ''endpoint.py'' que emplea el framework Python hug con el contenido siguiente:

<syntaxhighlight lang="bash">
import hug

@hug.get('/welcome')
def welcome(username="unknown"):
""" Say welcome to username """
return "Welcome " + username
</syntaxhighlight>

Este fichero es un ejemplo de uso de Python hug. Si hacemos una petición a /welcome?username="LSO", esto nos devolverá el mensaje "Welcome LSO".

Una vez tengamos los dos ficheros creados en nuestra máquina virtual, podemos construir nuestra imagen:

<syntaxhighlight lang="bash">
podman build -t app:v1 -f Dockerfile .
</syntaxhighlight>

Vamos a explicar para que sirve cada línea:

* FROM: servirá para basarnos en una imagen existente, en este caso, una imagen de python alpine, que contiene python y no ocupa mucho espacio
* ENV: para crear variables de entorno
* RUN: para ejecutar comandos, ya sea para crear una carpeta, instalar dependencias o cualquier otra opción que necesitemos
* COPY: para copiar datos desde nuestra máquina a la imagen
* WORKDIR: para cambiar el directorio de trabajo
* CMD: este comando será ejecutado por defecto al iniciar un contenedor a partir de esta imagen

Esto construirá una imagen podman basada en python:alpine, en la cual hemos
guardado nuestra pequeña aplicación y se va a ejecutar cuando ejecutemos un
contenedor basado en esa imagen. Para comprobar que la imagen se ha creado
correctamente, listamos las imagenes, y debería de aparecernos una imagen con
nombre 'app' y tag 'v1':

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen, y vamos a añadir una nueva
opción, -p 8001:8000. Esta opción hará que el puerto interno 8000 del contenedor
sea expuesto en el puerto 8001 de nuestra máquina:

<syntaxhighlight lang="bash">
podman run --name my-app --rm -d -p 8001:8000 app:v1
</syntaxhighlight>

''Nota:'' podman supone que la redirección de puerto es TCP, para una redirección de puertos UDP, puedes usar:

<syntaxhighlight lang="bash">
... -p 8001:8000/udp
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código. En nuestra
máquina haremos:

<syntaxhighlight lang="bash">
curl -X GET http://localhost:8001/welcome?username=LSO
</syntaxhighlight>

Comprobaremos que la salida del comando curl, es "Welcome LSO".

Antes de terminar, vamos a comprobar otro pequeño detalle que añadimos en
nuestra imagen, la variable de entorno USERNAME, vamos a comprobar que funciona:

<syntaxhighlight lang="bash">
podman exec -ti my-app ash
echo $USERNAME
</syntaxhighlight>

Funciona correctamente, pero al ejecutar el contenedor, podemos cambiar esta
variable de entorno como vimos en uno de los pasos anteriores:

<syntaxhighlight lang="bash">
podman run --rm -ti -e USERNAME=me app:v1 ash
echo $USERNAME
</syntaxhighlight>

Esto nos servirá para tener opciones por defecto y que el usuario pueda
cambiarlo a su antojo, como por ejemplo contraseñas u otros detalles.

= Paso 12: Eliminar imágenes =

Para borrar una imagen, puede hacer:

<syntaxhighlight lang="bash">
podman image rm hello-world
</syntaxhighlight>

= Paso 13: Varios podman a la vez (podman-compose) =

Antes de comenzar, vamos a parar todos los contenedores que tengamos abiertos,
para dejar el entorno de podman limpio, que nos vendrá bien para esta parte.

Cuando queremos ejecutar varios contenedores a la vez y que estén conectados
entre ellos fácilmente, utilizaremos podman-compose, donde con un fichero de
configuración simple en yaml, tendremos toda la configuración de lo que vamos a
ejecutar.

Primero vamos a instalar podman-compose:

<syntaxhighlight lang="bash">
sudo apt install podman-compose
</syntaxhighlight>

Ahora veamos un pequeño ejemplo donde explicaremos todos los detalles para crear
un podman-compose, en este caso, el nombre por defecto de los ficheros suele ser
podman-compose.yml, y el contenido será similar a:

<syntaxhighlight lang="bash">
version: '3'

services:
web:
container_name: web
restart: always
build:
context: .
ports:
- "8000:8000"
volumes:
- /home/ubuntu/volume:/volumen:rw
environment:
USERNAME: test
web2:
container_name: web2
build:
dockerfile: Dockerfile
context: .
depends_on:
- web
command: touch web2
web3:
container_name: web3
restart: on-failure
image: pstauffer/curl
depends_on:
- web
command: curl -X GET web:8000/welcome?username=web3
</syntaxhighlight>

En el podman-compose definimos diferentes servicios a ejecutar, en nuestro caso
hemos iniciado tres servicios diferentes, web, web2 y web3:

El primer servicio, web:

* container_name: para darle un nombre por defecto al contenedor cuando se cree
* restart: pueden ser:
** "no": si la máquina termina, no se vuelve a iniciar (opción por defecto)
** always: siempre que el contenedor termine, intenta iniciarse de nuevo
** on-failure: solo intenta reiniciarse si el contenedor termina con fallo
** unless-stopped: solo reinicia el contenedor si el usuario es el que lo termina
* Utilizará el fichero Dockerfile creado en el paso 11 para generar la imagen a usar.
* Expondrá el puerto 8000 del contenedor en el 8000 de nuestra máquina
* Montará un volumen, se hace de forma similar a la línea de comandos
* Creará una variable de entorno

El segundo servicio, web2:

* Utilizará el fichero Dockerfile también, la diferencia entre este y el primer servicio, es que si el nombre del Dockerfile cambia, tendremos que hacerlo de esta segunda forma, la primera por defecto solo buscará el fichero Dockerfile
* depends_on hará que para ejecutar este servicio, su dependencia tenga ya que estar iniciada
* Ejecutaremos un comando el cual sustituirá al comando de la imagen

El tercer servicio, web3:

* Utilizará la imagen ostauffer/curl que es un imagen mínima que contiene el comando curl
* restart: en este caso, hasta que el comando no se ejecute correctamente, se seguirá reiniciando el contenedor
* depends_on igual que el servicio 2, dependerá del servicio 1
* Ejecutaremos un comando para llamar desde el servicio 3 al servicio 1

== Paso 13.1: Construir podman-compose ==

En el caso de existir servicios que tengan Dockerfiles, esto hará que se construyan previamente, como hacer un podman build de cada uno de los servicios que contenga un Dockerfile:

<syntaxhighlight lang="bash">
podman-compose build
</syntaxhighlight>

Con esto se generarán las imágenes necesarias para ejecutar todos los servicios.

== Paso 13.2: Iniciar podman-compose ==

Para iniciar todos los servicios, ejecutaremos:

<syntaxhighlight lang="bash">
podman-compose up -d
</syntaxhighlight>

Después de esto podremos ver el logs de todos los servicios:

<syntaxhighlight lang="bash">
podman-compose logs -f
</syntaxhighlight>

Aquí veremos que el servicio 3 ha conseguido llamar correctamente al servicio 1.

Ahora veremos como podman-compose ha creado los contenedores:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

La salida será similar a la siguiente:

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
219a4118244c pstauffer/curl "curl -X GET web:800…" 6 seconds ago Exited (0) 3 seconds ago web3
c97e894cb3ae ubuntu_web2 "touch web2" 6 seconds ago Exited (0) 4 seconds ago web2
f35d034204fc ubuntu_web "/bin/sh -c 'hug -f …" 6 seconds ago Up 5 seconds 0.0.0.0:8000->8000/tcp web
</syntaxhighlight>

Aquí vemos varios detalles:

* El nombre que le hemos dado en el podman-compose ha funcionado correctamente
* Vemos que los comandos son los correctos también
* web2 está parado por que la política de reinicio es apagar cuando se termine de ejecutar un comando
* web 3 está parado por que el comando ha terminado con un salida correcta

Vamos a comprobar ahora que en el servicio web está todo correcto:

<syntaxhighlight lang="bash">
podman exec -ti web ash
echo $USERNAME
ls /volumen
exit
</syntaxhighlight>

Podemos comprobar que tanto cambiar la variable de entorno como crear un
volumen ha funcionado correctamente.

== Paso 13.3: Parar podman-compose ==

Para parar todos los servicios:

<syntaxhighlight lang="bash">
podman-compose down
</syntaxhighlight>

Comprobamos:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Vemos que han desaparecido todos los contenedores.

= Paso 14: Ejercicios =

== Ejercicio 1: Image derivada de Debian con el programa sl ==

Lance un contenedor a partir de una imagen de Debian, instale el programa sl, ejecute sl (desde fuera del contenedor) y detenga el contenedor.

== Ejercicio 2 ==

== Ejercicio 3: Variante de httpd ==

Construya una imagen ''httpd-hola-mundo'' a partir de la imagen ''httpd''. El fichero de index.html de la carpeta htdocs/ tiene que mostrar el mensaje "hola mundo".

<syntaxhighlight lang="bash">
podman pull httpd
</syntaxhighlight>

Edita el fichero Dockerfile:

<syntaxhighlight lang="bash">
nano Dockerfile
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
FROM httpd

COPY index.html htdocs/index.html
</syntaxhighlight>

Edita el fichero index.html:

<syntaxhighlight lang="bash">
nano index.html
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

Construye la imagen:

<syntaxhighlight lang="bash">
podman build -t mihttpd -f Dockerfile .
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen:

<syntaxhighlight lang="bash">
podman run --name mihttpd -d -p 8080:80 mihttpd
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código:
<syntaxhighlight lang="bash">
curl -X GET http://localhost:8080
</syntaxhighlight>

Tiene que salir por pantalla esto:
<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

== Ejercicio 4: aplicación flask ==

Flask es un framework python para implementar webs. Cree una imagen "miapp-flask" a partir de la imagen de "python":

* Instale flask mediante: pip install flask
* Cree la carpeta "app"
* Establezca la variable FLASK_APP a "hello.py"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"

El fichero hello.py contiene un "hola mundo" para Flask:

<syntaxhighlight lang="python">
from flask import Flask
app = Flask(__name__)

@app.route("/")
def hello():
return "Hello World!"

if __name__ == "__main__":
app.run()
</syntaxhighlight>

Solución con alpine:

<syntaxhighlight lang="bash">
FROM python:alpine

RUN mkdir /app
RUN pip install flask
ENV FLASK_APP="app/hello.py"
COPY hello.py
WORKDIR /
CMD flask run --host=0.0.0.0
</syntaxhighlight>

Solución con Ubuntu:

<syntaxhighlight lang="bash">
FROM ubuntu:bionic

RUN apt-get update
RUN apt-get -y install python python-pip wget
RUN pip install Flask
ENV FLASK_APP="app/hello.py"
RUN mkdir /app
COPY hello.py /app
CMD flask run --host=0.0.0.0
</syntaxhighlight>

== Ejercicio 5: mysql ==

'''EN LA MÁQUINA VIRTUAL:'''

mkdir miapp
cd miapp
podman pull mysql
nano Dockerfile

<syntaxhighlight lang="bash">
FROM mysql
ENV MYSQL_ROOT_PASSWORD="lacontraseñaqueyoquiera"
RUN mkdir /app
WORKDIR /app

</syntaxhighlight>

CTRL+O , ENTER Y CTRL+X (para guardar Dockerfile y salir)

podman build -ti mrfdocker -f Dockerfile .
podman run --name mymrf --rm -p 8001:3306 mrfdocker
docker images

'''EN LA TERMINAL DEL HOST:'''

''Instalación de mysql:''

apt install mysql-client-core-5.7
apt-get install mysql-server
service mysql start

''Para entrar:''

mysql -u root -p -P 8001

Una vez dentro de msql:

mysql> show databases;

''Para salir:''

exit

== Ejercicio 6: python pyramid ==

Pyramid es un framework python para implementar webs. Cree una imagen "miapp-pyramid":

* Emplee la imagen de Ubuntu como referencia, instale los paquetes python y python-pip.
* Instale Pyramid mediante: pip install pyramid
* Cree la carpeta "app"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"
* La aplicación se lanza con la orden: python hello.py
* Compruebe que funciona con curl, la ruta a la web es http://127.0.0.1:8000/hello, suponiendo que ha empleado el puerto 8000 para exponer el servicio.

El fichero hello.py contiene un "hola mundo" para Pyramid:

<syntaxhighlight lang="bash">
from wsgiref.simple_server import make_server
from pyramid.config import Configurator
from pyramid.response import Response

def hello_world(request):
print('Request inbound!')
return Response('Podman works with Pyramid!')

if __name__ == '__main__':
config = Configurator()
config.add_route('hello', '/')
config.add_view(hello_world, route_name='hello')
app = config.make_wsgi_app()
server = make_server('0.0.0.0', 6543, app)
server.serve_forever()
</syntaxhighlight>

Este programa recibe peticiones en el puerto 6543.

== Ejercicio 7 ==

Cree una imagen derivada de Ubuntu, instale el paquete apache2, php y libapache2-mod-php.
Active el módulo de php para apache2 mediante la orden:

<syntaxhighlight lang="bash">
a2enmod php
</syntaxhighlight>

Cree la carpeta /var/www/php.

Cree el fichero index.php

<syntaxhighlight lang="php">
<?php
Print "Hello, World!";
?>
</syntaxhighlight>

y copielo a /var/www/php/.

Cree el fichero 000-default.conf y copielo a /etc/apache2/sites-enabled/

Dicho fichero contiene.

<syntaxhighlight lang="bash">
<VirtualHost *:80>
DocumentRoot /var/www/php

<Directory /var/www/php/>
Options Indexes FollowSymLinks MultiViews
AllowOverride All
Order deny,allow
Allow from all
</Directory>

ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>
</syntaxhighlight>

Tiene que lanzar apache con la orden: apachectl -D FOREGROUND

Tras crear la imagen, láncela mapeando el puerto 8888 al 80, pruebe que puede acceder a http://127.0.0.1:8888/php/ mediante curl

Solución:

<syntaxhighlight lang="bash">
FROM ubuntu:latest

RUN apt-get update
RUN apt-get install -y tzdata
RUN apt-get install -y apache2
RUN apt-get install -y php
RUN apt-get install -y libapache2-mod-php
RUN a2enmod php7.2
COPY index.php /var/www/php
COPY 000-default.conf /etc/apache2/sites-enabled/
CMD apachectl -D FOREGROUND
</syntaxhighlight>

Y para lanzarlo:

podman run --name my-app --rm -d -p 8001:8000 app:v1

y para probarlo:

curl -X GET http://127.0.0.1:8888/php/

== Ejercicio 8 ==

Instale el paquete ''netcat-traditional'' en una imagen de contenedor de ''ubuntu''. Lance la orden:

nc -u -l -p 8080

en el contenedor. Asegúrese de crear una redirección de puertos de 9999 desde el ''host'' al puerto 8080 en el contenedor.

Desde fuera del contenedor, pruebe a conectarse con:

nc -u 127.0.0.1 9999

== Ejercicio 9 ==

Cree una imagen derivada de "ubuntu" con un Dockerfile que incluya soporte de python y lance el siguiente código en Python:

<syntax lang="python">
from http.server import BaseHTTPRequestHandler, HTTPServer
import time

hostName = "0.0.0.0"
serverPort = 8080

class MyServer(BaseHTTPRequestHandler):
def do_GET(self):
self.send_response(200)
self.send_header("Content-type", "text/html")
self.end_headers()
self.wfile.write(bytes("<html><head><title>Welcome!</title></head>", "utf-8"))
self.wfile.write(bytes("<body>", "utf-8"))
self.wfile.write(bytes("This is an example web server.", "utf-8"))
self.wfile.write(bytes("</body></html>", "utf-8"))

if __name__ == "__main__":
webServer = HTTPServer((hostName, serverPort), MyServer)
print("Server started http://%s:%s" % (hostName, serverPort))

try:
webServer.serve_forever()
except KeyboardInterrupt:
pass

webServer.server_close()
print("Server stopped.")
</syntax>

Llame a su imagen "python-http-server". Lance una instancia de la imagen "python-http-server" mapeando el puerto 9999 al puerto 8888/tcp del contenedor. Compruebe con:

<syntax lang="bash">
curl http://127.0.0.1:9999/
</syntax>

que muestre la página HTML que ofrece el servidor, que debería ser:

<syntax lang="bash">
<html><head><title>Welcome!</title></head><body>This is an example web server.</body></html>
</syntax>

Contenedores

2025-12-09T15:54:11Z

Pneira: /* Paso 14: Ejercicios */

En esta práctica aprenderemos a utilizar [https://es.wikipedia.org/wiki/Podman podman] para desplegar contenedores.

= Paso 1: Instalar podman =

Para instalar el paquete oficial:

<syntaxhighlight lang="bash">
apt install podman
</syntaxhighlight>

podman es un clon de '''docker''.

= Paso 2: Repositorio de imágenes de contenedores DockerHub =

Docker ofrece un servicio de nube denominado ''DockerHub'' que puede ser empleado como red social para compartir tus imágenes de Podman. En ''DockerHub'' existen además imágenes de contenedores preconfiguradas de software, muchas de ellas oficiales (ofrecidas por el propio fabricante del software) que se podrán emplear como base para construir nuevas imágenes adaptadas a nuestras necesidades.

Podremos realizar búsquedas en este repositorio ''DockerHub'' puedes emplear el siguiente comando:

<syntaxhighlight lang="bash">
podman search docker.io/library/hello-world
</syntaxhighlight>

Para descargarnos la imagen de ''hello-world'' podemos usar la orden ''pull'':

<syntaxhighlight lang="bash">
podman pull docker.io/library/hello-world
</syntaxhighlight>

También podemos publicar imágenes propias, esto require '''registro de usuario''' en la nube de ''DockerHub'', lo que '''no''' es obligatorio para la realización de esta práctica. Para subir una imagen, hay que validarse como usuario en la nube de ''DockerHub'':

<syntaxhighlight lang="bash">
podman login
</syntaxhighlight>

Tras introducir tu usuario y contraseña, puedes comenzar a publicar tus propias imágenes.

<syntaxhighlight lang="bash">
podman push MI_IMAGEN
</syntaxhighlight>

Este paso es '''opcional''', sólo en caso de que se quieran subir imágenes de contenedores a la nube de docker.io.

= Paso 4: Comprobar imágenes en nuestra máquina =

Para ver las imágenes que tenemos en nuestra máquina, utilizaremos el comando:

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Inicialmente, no tenemos imágenes en almacenamiento, podemos descargarnos la imagen oficial de Debian 13 (Trixie):

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian
</syntaxhighlight>

Ahora si, ya debería de aparecernos la imagen ''debian''.

Comentar también que cada imagen puede tener varias etiquetas, por ejemplo, la imagen Debian 12 (Bookworm), cuando la hemos visto en el listado de imágenes, venía con el tag latest, que es el tag que se descarga por defecto, pero nosotros podemos especificar otro, por ejemplo:

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian:bookworm
</syntaxhighlight>

Para traernos la versión de la imagen de Debian 12 ''Bookworm''.

Ahora tendremos dos imágenes con diferente etiqueta, que serían como las diferentes versiones de cada imagen.

= Paso 5: Lanzar un contenedor =

Un contenedor no es más que una imagen de podman ejecutándose, sería similar a
una máquina virtual, aunque mucho más liviano.

Para crear un contenedor, utilizaremos una imagen, en este caso, la imagen
hello-world. Hacemos lo siguiente:

<syntaxhighlight lang="bash">
podman run hello-world
</syntaxhighlight>

Esto nos mostrará el siguiente mensaje si todo está correcto:

<syntaxhighlight lang="bash">
Hello from Docker!
This message shows that your installation appears to be working correctly.

To generate this message, Docker took the following steps:
1. The Docker client contacted the Docker daemon.
2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
(amd64)
3. The Docker daemon created a new container from that image which runs the
executable that produces the output you are currently reading.
4. The Docker daemon streamed that output to the Docker client, which sent it
to your terminal.

To try something more ambitious, you can run an Debian container with:
$ podman run -it debian bash

Share images, automate workflows, and more with a free Docker ID:
https://hub.docker.com/

For more examples and ideas, visit:
https://docs.docker.com/get-started/
</syntaxhighlight>

Al crear los contenedores utilizando el comando 'run', tenemos varias opciones:

* Lanzar una terminal en el contenedor en modo interactivo
* Lanzar en segundo plano y conectarnos posteriormente al contenedor

== Paso 5.1: Lanzar una terminal en el contenedor en modo interactivo (-ti) ==

Para este ejemplo vamos a utilizar otra imagen diferente, en este caso vamos a utilizar una imagen de debian.

Vamos a lanzar un contenedor y ejecutar una terminal en el que se va a ejecutar el programa '''bash''' que me ofrece un interprete de órdenes:

<syntaxhighlight lang="bash">
podman run -ti debian bash
</syntaxhighlight>

La opción ''-t'' indica que se crea un terminal en el contenedor. Y la opción ''-i'' indica que el contenedor se ejecuta en modo interactivo.

Al acceder al contenedor de ''debian'' nos aparece un ''hash'' en el prompt de la shell, que identifica a la instancia del contenedor (es valor es similar al que muestra la orden ''podman container ls'').

Para salir del contenedor, escribimos 'exit' o pulsamos ''CTRL + D''

== Paso 5.2 Lanzar en segundo plano (-d) ==

Otro ejemplo, con la imagen de Debian:

<syntaxhighlight lang="bash">
podman run -dti debian
</syntaxhighlight>

que muestra un hash que identifica de forma única el contenedor lanzado:

<syntaxhighlight lang="bash">
2ec1daae4676a4e84dc04fd91399c1dfe92119544ff12ee307991fe573d3db64
</syntaxhighlight>

Mediante el comando ''attach'' puedo entrar al contenedor:

<syntaxhighlight lang="bash">
podman attach 2ec1daae4676
</syntaxhighlight>

Para salir, pulsamos ''CTRL + P'' seguido de ''CTRL + Q''.

De manera similar, puedo lanzar en segundo plano la imagen de contenedor de ''hello-world'':

<syntaxhighlight lang="bash">
podman run -d hello-world
</syntaxhighlight>

Y consultar los logs:

<syntaxhighlight lang="bash">
podman logs b67fae3312bc321
</syntaxhighlight>

== Paso 5.3: Añadir variables de entorno a un contenedor ==

Utilizaremos la imagen anterior, y vamos a añadir una variable de entorno
llamada TEST que contenga el valor 'test'. A parte, también ejecutaremos la
terminal como antes, para comprobar con el comando echo, que la variable de
entorno está creada correctamente:

<syntaxhighlight lang="bash">
podman run -ti -e TEST=test debian bash
</syntaxhighlight>

Ahora, desde el contenedor podemos comprobar el valor de la variable de entorno ''$TEST''.

<syntaxhighlight lang="bash">
echo $TEST
test
</syntaxhighlight>

= Paso 6: Listar contenedores en ejecución =

Hemos estado haciendo pruebas y ejecutando contenedores en el paso anterior, vamos a ver donde se encuentran estos contenedores que hemos ejecutado, y después veremos algunas opciones más del comando run.

Tenemos dos opciones para ver los contenedores:

<syntaxhighlight lang="bash">
podman container ls -a
</syntaxhighlight>

o la versión corta:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Ambas hacen lo mismo, y debería de mostrarnos una salida similar a la siguiente:

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
e2bde5f5500c debian "bash" 6 minutes ago Exited (0) 2 seconds ago pensive_sammet
544ad27dbc3c debian "bash" 7 minutes ago Exited (0) 7 minutes ago serene_elgamal
</syntaxhighlight>

En la información veremos que el contenedor tiene el estado exited, eso quiere decir que no se está ejecutando y ya ha finalizado. Vamos a hacer una prueba para ver un contendor ejecutándose:

<syntaxhighlight lang="bash">
podman run -d debian sleep 30
</syntaxhighlight>

Con el comando sleep 30 esperamos 30 segundos hasta que termine el comando, asíque durante esos 30 segundos, el contenedor estará ejecutándose, veámoslo:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
eacceb27d52d debian "sleep 30" 12 seconds ago Up 11 seconds sharp_pasteur
</syntaxhighlight>

Vamos a ver alguna opciones más de la orden ''run''.

== Paso 6.1: Dar un nombre al contenedor (--name) ==

Por defecto, podman creará automáticamente un nombre como hemos visto en las salidas del comando ''podman ps -a''. Podemos establecer el nombre del contenedor que queramos con la opción ''--name'':

<syntaxhighlight lang="bash">
podman run -ti --name mi_debian debian
</syntaxhighlight>

== Paso 6.2: Eliminar contenedor cuando termine (--rm) ==

Vamos a mezclar todo lo visto anteriormente:

* Lanzar en segundo plano (-d)
* Ejecutar contenedor durante 30 segundos (sleep 30)
* Dar un nombre a la imagen (--name)
* Eliminar contenedor cuando termine (--rm)

<syntaxhighlight lang="bash">
podman run -d --rm --name bye-bye debian sleep 30
</syntaxhighlight>

Antes y una vez pasados los 30 segundos, podemos comprobar que el contenedor ha desaparecido.

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

= Paso 7: Parar y eliminar contenedores =

Los contenedores podemos pararlos o eliminarlos, veamos como hacerlo. Antes que
nada, borraremos todos los contenedores que estén terminados, para ello:

<syntaxhighlight lang="bash">
podman container prune
podman ps -a
</syntaxhighlight>

Ya lo hemos dejado todo limpio para seguir, ahora vamos a crear un contenedor,
utilizando un comando de linux que no termina, para que así se quede
ejecutándose el contenedor infinitamente:

<syntaxhighlight lang="bash">
podman run -d -ti --name my_container debian bash
podman ps -a
</syntaxhighlight>

Vamos a pararlo (podemos utilizar el nombre dado o el id):

<syntaxhighlight lang="bash">
podman stop my_container
podman stop e4901956f108
podman ps -a
</syntaxhighlight>

Veremos que ya ha terminado, y ahora vamos a eliminarlo, pero solo este
contenedor, no como previamente que eliminamos todos. Lo mismo que para pararlo,
podemos utilizar el nombre o el id.

<syntaxhighlight lang="bash">
podman container rm my_container
podman container rm my_container
podman ps -a
</syntaxhighlight>

Veremos que ya no tenemos el contenedor y está correctamente eliminado.

= Paso 8: Conectarnos a un contenedor que se está ejecutando en segundo plano =

Vamos a ejecutar de nuevo un contenedor que no termine:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a conectarnos a este contenedor que está ejecutándose en segundo
plano:

<syntaxhighlight lang="bash">
podman attach mi-contenedor
</syntaxhighlight>

Veremos la orden bash ejecutándose, para terminar, hacemos un 'CTRL + C', y ahora, veremos que ha pasado con el contenedor:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Lo veremos parado, por que lo que hemos hecho ha sido conectarnos al contenedor
y parar el comando que se estaba ejecutando, así que ahora tenemos el contenedor
finalizado.

''Nota:'' Para salir del contenedor '''sin detenerlo''' hacemos 'CTRL + P' seguido 'CTRL + Q'

= Paso 9: Ejecutar un comando dentro de un contenedor en ejecución =

Vamos a ver otresta vez como ejecutar un comando en un contenedor que ya está
ejecutándose:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a ejecutar un comando en ese contenedor con el nombre ''mi-contenedor''.
El comando exec es similar al comando run, pero para ejecutar un comando dentro de un contenedor:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor ls
</syntaxhighlight>

Para redirigir la salida a un fichero en el anfitrión:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor ls > x.txt
</syntaxhighlight>

Para redirigir la salida a un fichero ''dentro'' del contenedor, hacemos:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor bash -c "ls > x.txt"
</syntaxhighlight>

= Paso 10: Persistencia en contenedores =

Al hacer ''exit'' y salir de un contenedor, se pierden todos los cambios que hemos realizado. Los

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-ejemplo debian bash
</syntaxhighlight>

Ahora, vamos a crear una carpeta en el contenedor y comprobar que esa carpeta existe:

<syntaxhighlight lang="bash">
podman exec mi-ejemplo mkdir test
podman exec mi-ejemplo ls
</syntaxhighlight>

Veremos que la carpeta existe, pero, ¿qué ocurre si para el contenedor?

<syntaxhighlight lang="bash">
podman container stop mi-ejemplo
</syntaxhighlight>

Y volvemos a lanzarlo:

<syntaxhighlight lang="bash">
podman container rm mi-ejemplo
podman run -d -ti --name mi-ejemplo debian bash
podman exec mi-ejemplo ls
</syntaxhighlight>

Podemos comprobar que la carpeta creada anteriormente, no existe.

¿Qué podemos hacer para mantener la modificaciones realizadas sobre un contenedor?

== Paso 10.1: Crear una imagen derivada de la imagen base ==

Es posible crear una imagen derivada, con modificaciones, a partir de una imagen existente mediante la orden '''commit'''.

Por ejemplo, si queremos una imagen ''debian'' que incluya el programa ''ping'' ya instalado, tendríamos que lanzar un contenedor a partir de la imagen ''ubuntu'':

<syntaxhighlight lang="bash">
podman run -d -ti debian bash
</syntaxhighlight>

Suponiendo que el contenido está identificado con el ID 56ef5b312334

Instalamos el paquete ping:

<syntaxhighlight lang="bash">
podman exec 56ef5b312334 apt -y install ping
</syntaxhighlight>

Generamos la imagen derivada con el nombre ''ubuntu-con-ping'':

<syntaxhighlight lang="bash">
podman commit 56ef5b312334 ubuntu-con-ping
</syntaxhighlight>

Ya podemos para nuestro contendor:

<syntaxhighlight lang="bash">
podman stop 56ef5b312334
</syntaxhighlight>

Y lanzar un nuevo contenedor a partir de la imagen ''debian-con-ping'':

<syntaxhighlight lang="bash">
podman run -d -ti debian-con-ping bash
</syntaxhighlight>

== Paso 10.2: Mantener la persistencia mediante volúmen ==

Otra opción para mantener los datos es montar un volumen al ejecutar el contenedor.

Primero crearemos una carpeta que hará de volumen en nuestra máquina, que será la que luego montemos para podman:

<syntaxhighlight lang="bash">
mkdir /home/debian/volumen
</syntaxhighlight>

Ahora vamos a montar la carpeta al ejecutar el contenedor, lo hacemos con la
opción -v, la cual tiene 3 campos separados por ':':

# El volumen en nuestra máquina
# Donde se montará el volumen dentro del contenedor
# Opciones de mmontaje, por ejemplo rw (read and write) o ro (read only)

<syntaxhighlight lang="bash">
podman run --rm -ti -v /home/debian/volumen:/volumen:rw debian bash
mkdir /volumen/test
touch /volumen/test/file
exit
</syntaxhighlight>

Una vez nos salgamos del contenedor, podemos ver que en nuestra máquina están
los datos:

<syntaxhighlight lang="bash">
ls /home/ubuntu/volumen/
ls /home/ubuntu/volumen/test
</syntaxhighlight>

La próxima vez que ejecutemos un contenedor, si montamos ese volumen, los datos
estarán ahí, además esta forma tiene el beneficio de compartir datos entre
nuestra máquina y el contenedor de forma sencilla.

= Paso 11: Crear nuestra propia imagen de contenedor =

Para crear una imagen de un contenedor con una aplicación de Python hug, creamos en primer lugar la carpeta que contendrá los ficheros que nos permiten crear la imagen.

<syntaxhighlight lang="bash">
mkdir miapp
cd miapp
</syntaxhighlight>

Definimos un fichero ''Dockerfile'' para definir la imagen:

<syntaxhighlight lang="bash">
FROM ubuntu

RUN apt -y update
RUN apt -y upgrade
RUN apt -y install python3-hug
RUN mkdir /app
COPY endpoint.py /app
WORKDIR /app
CMD hug -f endpoint.py
</syntaxhighlight>

Alternativamente, puedes crear un [[Creando imagen propia usando Ubuntu de base|Dockerfile empleando la imagen de Ubuntu]] como base en lugar de Alpine.

Y añadimos el fichero ''endpoint.py'' que emplea el framework Python hug con el contenido siguiente:

<syntaxhighlight lang="bash">
import hug

@hug.get('/welcome')
def welcome(username="unknown"):
""" Say welcome to username """
return "Welcome " + username
</syntaxhighlight>

Este fichero es un ejemplo de uso de Python hug. Si hacemos una petición a /welcome?username="LSO", esto nos devolverá el mensaje "Welcome LSO".

Una vez tengamos los dos ficheros creados en nuestra máquina virtual, podemos construir nuestra imagen:

<syntaxhighlight lang="bash">
podman build -t app:v1 -f Dockerfile .
</syntaxhighlight>

Vamos a explicar para que sirve cada línea:

* FROM: servirá para basarnos en una imagen existente, en este caso, una imagen de python alpine, que contiene python y no ocupa mucho espacio
* ENV: para crear variables de entorno
* RUN: para ejecutar comandos, ya sea para crear una carpeta, instalar dependencias o cualquier otra opción que necesitemos
* COPY: para copiar datos desde nuestra máquina a la imagen
* WORKDIR: para cambiar el directorio de trabajo
* CMD: este comando será ejecutado por defecto al iniciar un contenedor a partir de esta imagen

Esto construirá una imagen podman basada en python:alpine, en la cual hemos
guardado nuestra pequeña aplicación y se va a ejecutar cuando ejecutemos un
contenedor basado en esa imagen. Para comprobar que la imagen se ha creado
correctamente, listamos las imagenes, y debería de aparecernos una imagen con
nombre 'app' y tag 'v1':

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen, y vamos a añadir una nueva
opción, -p 8001:8000. Esta opción hará que el puerto interno 8000 del contenedor
sea expuesto en el puerto 8001 de nuestra máquina:

<syntaxhighlight lang="bash">
podman run --name my-app --rm -d -p 8001:8000 app:v1
</syntaxhighlight>

''Nota:'' podman supone que la redirección de puerto es TCP, para una redirección de puertos UDP, puedes usar:

<syntaxhighlight lang="bash">
... -p 8001:8000/udp
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código. En nuestra
máquina haremos:

<syntaxhighlight lang="bash">
curl -X GET http://localhost:8001/welcome?username=LSO
</syntaxhighlight>

Comprobaremos que la salida del comando curl, es "Welcome LSO".

Antes de terminar, vamos a comprobar otro pequeño detalle que añadimos en
nuestra imagen, la variable de entorno USERNAME, vamos a comprobar que funciona:

<syntaxhighlight lang="bash">
podman exec -ti my-app ash
echo $USERNAME
</syntaxhighlight>

Funciona correctamente, pero al ejecutar el contenedor, podemos cambiar esta
variable de entorno como vimos en uno de los pasos anteriores:

<syntaxhighlight lang="bash">
podman run --rm -ti -e USERNAME=me app:v1 ash
echo $USERNAME
</syntaxhighlight>

Esto nos servirá para tener opciones por defecto y que el usuario pueda
cambiarlo a su antojo, como por ejemplo contraseñas u otros detalles.

= Paso 12: Eliminar imágenes =

Para borrar una imagen, puede hacer:

<syntaxhighlight lang="bash">
podman image rm hello-world
</syntaxhighlight>

= Paso 13: Varios podman a la vez (podman-compose) =

Antes de comenzar, vamos a parar todos los contenedores que tengamos abiertos,
para dejar el entorno de podman limpio, que nos vendrá bien para esta parte.

Cuando queremos ejecutar varios contenedores a la vez y que estén conectados
entre ellos fácilmente, utilizaremos podman-compose, donde con un fichero de
configuración simple en yaml, tendremos toda la configuración de lo que vamos a
ejecutar.

Primero vamos a instalar podman-compose:

<syntaxhighlight lang="bash">
sudo apt install podman-compose
</syntaxhighlight>

Ahora veamos un pequeño ejemplo donde explicaremos todos los detalles para crear
un podman-compose, en este caso, el nombre por defecto de los ficheros suele ser
podman-compose.yml, y el contenido será similar a:

<syntaxhighlight lang="bash">
version: '3'

services:
web:
container_name: web
restart: always
build:
context: .
ports:
- "8000:8000"
volumes:
- /home/ubuntu/volume:/volumen:rw
environment:
USERNAME: test
web2:
container_name: web2
build:
dockerfile: Dockerfile
context: .
depends_on:
- web
command: touch web2
web3:
container_name: web3
restart: on-failure
image: pstauffer/curl
depends_on:
- web
command: curl -X GET web:8000/welcome?username=web3
</syntaxhighlight>

En el podman-compose definimos diferentes servicios a ejecutar, en nuestro caso
hemos iniciado tres servicios diferentes, web, web2 y web3:

El primer servicio, web:

* container_name: para darle un nombre por defecto al contenedor cuando se cree
* restart: pueden ser:
** "no": si la máquina termina, no se vuelve a iniciar (opción por defecto)
** always: siempre que el contenedor termine, intenta iniciarse de nuevo
** on-failure: solo intenta reiniciarse si el contenedor termina con fallo
** unless-stopped: solo reinicia el contenedor si el usuario es el que lo termina
* Utilizará el fichero Dockerfile creado en el paso 11 para generar la imagen a usar.
* Expondrá el puerto 8000 del contenedor en el 8000 de nuestra máquina
* Montará un volumen, se hace de forma similar a la línea de comandos
* Creará una variable de entorno

El segundo servicio, web2:

* Utilizará el fichero Dockerfile también, la diferencia entre este y el primer servicio, es que si el nombre del Dockerfile cambia, tendremos que hacerlo de esta segunda forma, la primera por defecto solo buscará el fichero Dockerfile
* depends_on hará que para ejecutar este servicio, su dependencia tenga ya que estar iniciada
* Ejecutaremos un comando el cual sustituirá al comando de la imagen

El tercer servicio, web3:

* Utilizará la imagen ostauffer/curl que es un imagen mínima que contiene el comando curl
* restart: en este caso, hasta que el comando no se ejecute correctamente, se seguirá reiniciando el contenedor
* depends_on igual que el servicio 2, dependerá del servicio 1
* Ejecutaremos un comando para llamar desde el servicio 3 al servicio 1

== Paso 13.1: Construir podman-compose ==

En el caso de existir servicios que tengan Dockerfiles, esto hará que se construyan previamente, como hacer un podman build de cada uno de los servicios que contenga un Dockerfile:

<syntaxhighlight lang="bash">
podman-compose build
</syntaxhighlight>

Con esto se generarán las imágenes necesarias para ejecutar todos los servicios.

== Paso 13.2: Iniciar podman-compose ==

Para iniciar todos los servicios, ejecutaremos:

<syntaxhighlight lang="bash">
podman-compose up -d
</syntaxhighlight>

Después de esto podremos ver el logs de todos los servicios:

<syntaxhighlight lang="bash">
podman-compose logs -f
</syntaxhighlight>

Aquí veremos que el servicio 3 ha conseguido llamar correctamente al servicio 1.

Ahora veremos como podman-compose ha creado los contenedores:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

La salida será similar a la siguiente:

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
219a4118244c pstauffer/curl "curl -X GET web:800…" 6 seconds ago Exited (0) 3 seconds ago web3
c97e894cb3ae ubuntu_web2 "touch web2" 6 seconds ago Exited (0) 4 seconds ago web2
f35d034204fc ubuntu_web "/bin/sh -c 'hug -f …" 6 seconds ago Up 5 seconds 0.0.0.0:8000->8000/tcp web
</syntaxhighlight>

Aquí vemos varios detalles:

* El nombre que le hemos dado en el podman-compose ha funcionado correctamente
* Vemos que los comandos son los correctos también
* web2 está parado por que la política de reinicio es apagar cuando se termine de ejecutar un comando
* web 3 está parado por que el comando ha terminado con un salida correcta

Vamos a comprobar ahora que en el servicio web está todo correcto:

<syntaxhighlight lang="bash">
podman exec -ti web ash
echo $USERNAME
ls /volumen
exit
</syntaxhighlight>

Podemos comprobar que tanto cambiar la variable de entorno como crear un
volumen ha funcionado correctamente.

== Paso 13.3: Parar podman-compose ==

Para parar todos los servicios:

<syntaxhighlight lang="bash">
podman-compose down
</syntaxhighlight>

Comprobamos:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Vemos que han desaparecido todos los contenedores.

= Paso 14: Ejercicios =

== Ejercicio 1: Image derivada de Debian con el programa sl ==

Lance un contenedor a partir de una imagen de Debian, instale el programa sl, ejecute sl (desde fuera del contenedor) y detenga el contenedor.

== Ejercicio 2 ==

== Ejercicio 3: Variante de httpd ==

Construya una imagen ''httpd-hola-mundo'' a partir de la imagen ''httpd''. El fichero de index.html de la carpeta htdocs/ tiene que mostrar el mensaje "hola mundo".

<syntaxhighlight lang="bash">
podman pull httpd
</syntaxhighlight>

Edita el fichero Dockerfile:

<syntaxhighlight lang="bash">
nano Dockerfile
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
FROM httpd

COPY index.html htdocs/index.html
</syntaxhighlight>

Edita el fichero index.html:

<syntaxhighlight lang="bash">
nano index.html
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

Construye la imagen:

<syntaxhighlight lang="bash">
podman build -t mihttpd -f Dockerfile .
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen:

<syntaxhighlight lang="bash">
podman run --name mihttpd -d -p 8080:80 mihttpd
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código:
<syntaxhighlight lang="bash">
curl -X GET http://localhost:8080
</syntaxhighlight>

Tiene que salir por pantalla esto:
<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

== Ejercicio 4: aplicación flask ==

Flask es un framework python para implementar webs. Cree una imagen "miapp-flask" a partir de la imagen de "python":

* Instale flask mediante: pip install flask
* Cree la carpeta "app"
* Establezca la variable FLASK_APP a "hello.py"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"

El fichero hello.py contiene un "hola mundo" para Flask:

<syntaxhighlight lang="python">
from flask import Flask
app = Flask(__name__)

@app.route("/")
def hello():
return "Hello World!"

if __name__ == "__main__":
app.run()
</syntaxhighlight>

Solución con alpine:

<syntaxhighlight lang="bash">
FROM python:alpine

RUN mkdir /app
RUN pip install flask
ENV FLASK_APP="app/hello.py"
COPY hello.py
WORKDIR /
CMD flask run --host=0.0.0.0
</syntaxhighlight>

Solución con Ubuntu:

<syntaxhighlight lang="bash">
FROM ubuntu:bionic

RUN apt-get update
RUN apt-get -y install python python-pip wget
RUN pip install Flask
ENV FLASK_APP="app/hello.py"
RUN mkdir /app
COPY hello.py /app
CMD flask run --host=0.0.0.0
</syntaxhighlight>

== Ejercicio 5: mysql ==

'''EN LA MÁQUINA VIRTUAL:'''

mkdir miapp
cd miapp
podman pull mysql
nano Dockerfile

<syntaxhighlight lang="bash">
FROM mysql
ENV MYSQL_ROOT_PASSWORD="lacontraseñaqueyoquiera"
RUN mkdir /app
WORKDIR /app

</syntaxhighlight>

CTRL+O , ENTER Y CTRL+X (para guardar Dockerfile y salir)

podman build -ti mrfdocker -f Dockerfile .
podman run --name mymrf --rm -p 8001:3306 mrfdocker
docker images

'''EN LA TERMINAL DEL HOST:'''

''Instalación de mysql:''

apt install mysql-client-core-5.7
apt-get install mysql-server
service mysql start

''Para entrar:''

mysql -u root -p -P 8001

Una vez dentro de msql:

mysql> show databases;

''Para salir:''

exit

== Ejercicio 6: python pyramid ==

Pyramid es un framework python para implementar webs. Cree una imagen "miapp-pyramid":

* Emplee la imagen de Ubuntu como referencia, instale los paquetes python y python-pip.
* Instale Pyramid mediante: pip install pyramid
* Cree la carpeta "app"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"
* La aplicación se lanza con la orden: python hello.py
* Compruebe que funciona con curl, la ruta a la web es http://127.0.0.1:8000/hello, suponiendo que ha empleado el puerto 8000 para exponer el servicio.

El fichero hello.py contiene un "hola mundo" para Pyramid:

<syntaxhighlight lang="bash">
from wsgiref.simple_server import make_server
from pyramid.config import Configurator
from pyramid.response import Response

def hello_world(request):
print('Request inbound!')
return Response('Podman works with Pyramid!')

if __name__ == '__main__':
config = Configurator()
config.add_route('hello', '/')
config.add_view(hello_world, route_name='hello')
app = config.make_wsgi_app()
server = make_server('0.0.0.0', 6543, app)
server.serve_forever()
</syntaxhighlight>

Este programa recibe peticiones en el puerto 6543.

== Ejercicio 7 ==

Cree una imagen derivada de Ubuntu, instale el paquete apache2, php y libapache2-mod-php.
Active el módulo de php para apache2 mediante la orden:

<syntaxhighlight lang="bash">
a2enmod php
</syntaxhighlight>

Cree la carpeta /var/www/php.

Cree el fichero index.php

<syntaxhighlight lang="php">
<?php
Print "Hello, World!";
?>
</syntaxhighlight>

y copielo a /var/www/php/.

Cree el fichero 000-default.conf y copielo a /etc/apache2/sites-enabled/

Dicho fichero contiene.

<syntaxhighlight lang="bash">
<VirtualHost *:80>
DocumentRoot /var/www/php

<Directory /var/www/php/>
Options Indexes FollowSymLinks MultiViews
AllowOverride All
Order deny,allow
Allow from all
</Directory>

ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>
</syntaxhighlight>

Tiene que lanzar apache con la orden: apachectl -D FOREGROUND

Tras crear la imagen, láncela mapeando el puerto 8888 al 80, pruebe que puede acceder a http://127.0.0.1:8888/php/ mediante curl

Solución:

<syntaxhighlight lang="bash">
FROM ubuntu:latest

RUN apt-get update
RUN apt-get install -y tzdata
RUN apt-get install -y apache2
RUN apt-get install -y php
RUN apt-get install -y libapache2-mod-php
RUN a2enmod php7.2
COPY index.php /var/www/php
COPY 000-default.conf /etc/apache2/sites-enabled/
CMD apachectl -D FOREGROUND
</syntaxhighlight>

Y para lanzarlo:

podman run --name my-app --rm -d -p 8001:8000 app:v1

y para probarlo:

curl -X GET http://127.0.0.1:8888/php/

== Ejercicio 8 ==

Instale el paquete ''netcat-traditional'' en una imagen de contenedor de ''ubuntu''. Lance la orden:

nc -u -l -p 8080

en el contenedor. Asegúrese de crear una redirección de puertos de 9999 desde el ''host'' al puerto 8080 en el contenedor.

Desde fuera del contenedor, pruebe a conectarse con:

nc -u 127.0.0.1 9999

== Ejercicio 9 ==

Cree una imagen derivada de "ubuntu" con un Dockerfile que incluya soporte de python y lance el siguiente código en Python:

<syntax lang="python">
from http.server import BaseHTTPRequestHandler, HTTPServer
import time

hostName = "0.0.0.0"
serverPort = 8080

class MyServer(BaseHTTPRequestHandler):
def do_GET(self):
self.send_response(200)
self.send_header("Content-type", "text/html")
self.end_headers()
self.wfile.write(bytes("<html><head><title>Welcome!</title></head>", "utf-8"))
self.wfile.write(bytes("<body>", "utf-8"))
self.wfile.write(bytes("This is an example web server.", "utf-8"))
self.wfile.write(bytes("</body></html>", "utf-8"))

if __name__ == "__main__":
webServer = HTTPServer((hostName, serverPort), MyServer)
print("Server started http://%s:%s" % (hostName, serverPort))

try:
webServer.serve_forever()
except KeyboardInterrupt:
pass

webServer.server_close()
print("Server stopped.")
</syntax>

Llame a su imagen "python-http-server". Lance una instancia de la imagen "python-http-server" mapeando el puerto 9999 al puerto 8888/tcp del contenedor. Compruebe con:

<syntax lang="bash">
curl http://127.0.0.1:9999/
</syntax>

que muestre la página HTML que ofrece el servidor, que debería ser:

<syntax lang="bash">
<html><head><title>Welcome!</title></head><body>This is an example web server.</body></html>
</syntax>

Contenedores

2025-12-09T15:51:29Z

Pneira: /* Ejercicio 3: Variante de httpd */

En esta práctica aprenderemos a utilizar [https://es.wikipedia.org/wiki/Podman podman] para desplegar contenedores.

= Paso 1: Instalar podman =

Para instalar el paquete oficial:

<syntaxhighlight lang="bash">
apt install podman
</syntaxhighlight>

podman es un clon de '''docker''.

= Paso 2: Repositorio de imágenes de contenedores DockerHub =

Docker ofrece un servicio de nube denominado ''DockerHub'' que puede ser empleado como red social para compartir tus imágenes de Podman. En ''DockerHub'' existen además imágenes de contenedores preconfiguradas de software, muchas de ellas oficiales (ofrecidas por el propio fabricante del software) que se podrán emplear como base para construir nuevas imágenes adaptadas a nuestras necesidades.

Podremos realizar búsquedas en este repositorio ''DockerHub'' puedes emplear el siguiente comando:

<syntaxhighlight lang="bash">
podman search docker.io/library/hello-world
</syntaxhighlight>

Para descargarnos la imagen de ''hello-world'' podemos usar la orden ''pull'':

<syntaxhighlight lang="bash">
podman pull docker.io/library/hello-world
</syntaxhighlight>

También podemos publicar imágenes propias, esto require '''registro de usuario''' en la nube de ''DockerHub'', lo que '''no''' es obligatorio para la realización de esta práctica. Para subir una imagen, hay que validarse como usuario en la nube de ''DockerHub'':

<syntaxhighlight lang="bash">
podman login
</syntaxhighlight>

Tras introducir tu usuario y contraseña, puedes comenzar a publicar tus propias imágenes.

<syntaxhighlight lang="bash">
podman push MI_IMAGEN
</syntaxhighlight>

Este paso es '''opcional''', sólo en caso de que se quieran subir imágenes de contenedores a la nube de docker.io.

= Paso 4: Comprobar imágenes en nuestra máquina =

Para ver las imágenes que tenemos en nuestra máquina, utilizaremos el comando:

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Inicialmente, no tenemos imágenes en almacenamiento, podemos descargarnos la imagen oficial de Debian 13 (Trixie):

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian
</syntaxhighlight>

Ahora si, ya debería de aparecernos la imagen ''debian''.

Comentar también que cada imagen puede tener varias etiquetas, por ejemplo, la imagen Debian 12 (Bookworm), cuando la hemos visto en el listado de imágenes, venía con el tag latest, que es el tag que se descarga por defecto, pero nosotros podemos especificar otro, por ejemplo:

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian:bookworm
</syntaxhighlight>

Para traernos la versión de la imagen de Debian 12 ''Bookworm''.

Ahora tendremos dos imágenes con diferente etiqueta, que serían como las diferentes versiones de cada imagen.

= Paso 5: Lanzar un contenedor =

Un contenedor no es más que una imagen de podman ejecutándose, sería similar a
una máquina virtual, aunque mucho más liviano.

Para crear un contenedor, utilizaremos una imagen, en este caso, la imagen
hello-world. Hacemos lo siguiente:

<syntaxhighlight lang="bash">
podman run hello-world
</syntaxhighlight>

Esto nos mostrará el siguiente mensaje si todo está correcto:

<syntaxhighlight lang="bash">
Hello from Docker!
This message shows that your installation appears to be working correctly.

To generate this message, Docker took the following steps:
1. The Docker client contacted the Docker daemon.
2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
(amd64)
3. The Docker daemon created a new container from that image which runs the
executable that produces the output you are currently reading.
4. The Docker daemon streamed that output to the Docker client, which sent it
to your terminal.

To try something more ambitious, you can run an Debian container with:
$ podman run -it debian bash

Share images, automate workflows, and more with a free Docker ID:
https://hub.docker.com/

For more examples and ideas, visit:
https://docs.docker.com/get-started/
</syntaxhighlight>

Al crear los contenedores utilizando el comando 'run', tenemos varias opciones:

* Lanzar una terminal en el contenedor en modo interactivo
* Lanzar en segundo plano y conectarnos posteriormente al contenedor

== Paso 5.1: Lanzar una terminal en el contenedor en modo interactivo (-ti) ==

Para este ejemplo vamos a utilizar otra imagen diferente, en este caso vamos a utilizar una imagen de debian.

Vamos a lanzar un contenedor y ejecutar una terminal en el que se va a ejecutar el programa '''bash''' que me ofrece un interprete de órdenes:

<syntaxhighlight lang="bash">
podman run -ti debian bash
</syntaxhighlight>

La opción ''-t'' indica que se crea un terminal en el contenedor. Y la opción ''-i'' indica que el contenedor se ejecuta en modo interactivo.

Al acceder al contenedor de ''debian'' nos aparece un ''hash'' en el prompt de la shell, que identifica a la instancia del contenedor (es valor es similar al que muestra la orden ''podman container ls'').

Para salir del contenedor, escribimos 'exit' o pulsamos ''CTRL + D''

== Paso 5.2 Lanzar en segundo plano (-d) ==

Otro ejemplo, con la imagen de Debian:

<syntaxhighlight lang="bash">
podman run -dti debian
</syntaxhighlight>

que muestra un hash que identifica de forma única el contenedor lanzado:

<syntaxhighlight lang="bash">
2ec1daae4676a4e84dc04fd91399c1dfe92119544ff12ee307991fe573d3db64
</syntaxhighlight>

Mediante el comando ''attach'' puedo entrar al contenedor:

<syntaxhighlight lang="bash">
podman attach 2ec1daae4676
</syntaxhighlight>

Para salir, pulsamos ''CTRL + P'' seguido de ''CTRL + Q''.

De manera similar, puedo lanzar en segundo plano la imagen de contenedor de ''hello-world'':

<syntaxhighlight lang="bash">
podman run -d hello-world
</syntaxhighlight>

Y consultar los logs:

<syntaxhighlight lang="bash">
podman logs b67fae3312bc321
</syntaxhighlight>

== Paso 5.3: Añadir variables de entorno a un contenedor ==

Utilizaremos la imagen anterior, y vamos a añadir una variable de entorno
llamada TEST que contenga el valor 'test'. A parte, también ejecutaremos la
terminal como antes, para comprobar con el comando echo, que la variable de
entorno está creada correctamente:

<syntaxhighlight lang="bash">
podman run -ti -e TEST=test debian bash
</syntaxhighlight>

Ahora, desde el contenedor podemos comprobar el valor de la variable de entorno ''$TEST''.

<syntaxhighlight lang="bash">
echo $TEST
test
</syntaxhighlight>

= Paso 6: Listar contenedores en ejecución =

Hemos estado haciendo pruebas y ejecutando contenedores en el paso anterior, vamos a ver donde se encuentran estos contenedores que hemos ejecutado, y después veremos algunas opciones más del comando run.

Tenemos dos opciones para ver los contenedores:

<syntaxhighlight lang="bash">
podman container ls -a
</syntaxhighlight>

o la versión corta:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Ambas hacen lo mismo, y debería de mostrarnos una salida similar a la siguiente:

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
e2bde5f5500c debian "bash" 6 minutes ago Exited (0) 2 seconds ago pensive_sammet
544ad27dbc3c debian "bash" 7 minutes ago Exited (0) 7 minutes ago serene_elgamal
</syntaxhighlight>

En la información veremos que el contenedor tiene el estado exited, eso quiere decir que no se está ejecutando y ya ha finalizado. Vamos a hacer una prueba para ver un contendor ejecutándose:

<syntaxhighlight lang="bash">
podman run -d debian sleep 30
</syntaxhighlight>

Con el comando sleep 30 esperamos 30 segundos hasta que termine el comando, asíque durante esos 30 segundos, el contenedor estará ejecutándose, veámoslo:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
eacceb27d52d debian "sleep 30" 12 seconds ago Up 11 seconds sharp_pasteur
</syntaxhighlight>

Vamos a ver alguna opciones más de la orden ''run''.

== Paso 6.1: Dar un nombre al contenedor (--name) ==

Por defecto, podman creará automáticamente un nombre como hemos visto en las salidas del comando ''podman ps -a''. Podemos establecer el nombre del contenedor que queramos con la opción ''--name'':

<syntaxhighlight lang="bash">
podman run -ti --name mi_debian debian
</syntaxhighlight>

== Paso 6.2: Eliminar contenedor cuando termine (--rm) ==

Vamos a mezclar todo lo visto anteriormente:

* Lanzar en segundo plano (-d)
* Ejecutar contenedor durante 30 segundos (sleep 30)
* Dar un nombre a la imagen (--name)
* Eliminar contenedor cuando termine (--rm)

<syntaxhighlight lang="bash">
podman run -d --rm --name bye-bye debian sleep 30
</syntaxhighlight>

Antes y una vez pasados los 30 segundos, podemos comprobar que el contenedor ha desaparecido.

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

= Paso 7: Parar y eliminar contenedores =

Los contenedores podemos pararlos o eliminarlos, veamos como hacerlo. Antes que
nada, borraremos todos los contenedores que estén terminados, para ello:

<syntaxhighlight lang="bash">
podman container prune
podman ps -a
</syntaxhighlight>

Ya lo hemos dejado todo limpio para seguir, ahora vamos a crear un contenedor,
utilizando un comando de linux que no termina, para que así se quede
ejecutándose el contenedor infinitamente:

<syntaxhighlight lang="bash">
podman run -d -ti --name my_container debian bash
podman ps -a
</syntaxhighlight>

Vamos a pararlo (podemos utilizar el nombre dado o el id):

<syntaxhighlight lang="bash">
podman stop my_container
podman stop e4901956f108
podman ps -a
</syntaxhighlight>

Veremos que ya ha terminado, y ahora vamos a eliminarlo, pero solo este
contenedor, no como previamente que eliminamos todos. Lo mismo que para pararlo,
podemos utilizar el nombre o el id.

<syntaxhighlight lang="bash">
podman container rm my_container
podman container rm my_container
podman ps -a
</syntaxhighlight>

Veremos que ya no tenemos el contenedor y está correctamente eliminado.

= Paso 8: Conectarnos a un contenedor que se está ejecutando en segundo plano =

Vamos a ejecutar de nuevo un contenedor que no termine:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a conectarnos a este contenedor que está ejecutándose en segundo
plano:

<syntaxhighlight lang="bash">
podman attach mi-contenedor
</syntaxhighlight>

Veremos la orden bash ejecutándose, para terminar, hacemos un 'CTRL + C', y ahora, veremos que ha pasado con el contenedor:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Lo veremos parado, por que lo que hemos hecho ha sido conectarnos al contenedor
y parar el comando que se estaba ejecutando, así que ahora tenemos el contenedor
finalizado.

''Nota:'' Para salir del contenedor '''sin detenerlo''' hacemos 'CTRL + P' seguido 'CTRL + Q'

= Paso 9: Ejecutar un comando dentro de un contenedor en ejecución =

Vamos a ver otresta vez como ejecutar un comando en un contenedor que ya está
ejecutándose:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a ejecutar un comando en ese contenedor con el nombre ''mi-contenedor''.
El comando exec es similar al comando run, pero para ejecutar un comando dentro de un contenedor:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor ls
</syntaxhighlight>

Para redirigir la salida a un fichero en el anfitrión:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor ls > x.txt
</syntaxhighlight>

Para redirigir la salida a un fichero ''dentro'' del contenedor, hacemos:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor bash -c "ls > x.txt"
</syntaxhighlight>

= Paso 10: Persistencia en contenedores =

Al hacer ''exit'' y salir de un contenedor, se pierden todos los cambios que hemos realizado. Los

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-ejemplo debian bash
</syntaxhighlight>

Ahora, vamos a crear una carpeta en el contenedor y comprobar que esa carpeta existe:

<syntaxhighlight lang="bash">
podman exec mi-ejemplo mkdir test
podman exec mi-ejemplo ls
</syntaxhighlight>

Veremos que la carpeta existe, pero, ¿qué ocurre si para el contenedor?

<syntaxhighlight lang="bash">
podman container stop mi-ejemplo
</syntaxhighlight>

Y volvemos a lanzarlo:

<syntaxhighlight lang="bash">
podman container rm mi-ejemplo
podman run -d -ti --name mi-ejemplo debian bash
podman exec mi-ejemplo ls
</syntaxhighlight>

Podemos comprobar que la carpeta creada anteriormente, no existe.

¿Qué podemos hacer para mantener la modificaciones realizadas sobre un contenedor?

== Paso 10.1: Crear una imagen derivada de la imagen base ==

Es posible crear una imagen derivada, con modificaciones, a partir de una imagen existente mediante la orden '''commit'''.

Por ejemplo, si queremos una imagen ''debian'' que incluya el programa ''ping'' ya instalado, tendríamos que lanzar un contenedor a partir de la imagen ''ubuntu'':

<syntaxhighlight lang="bash">
podman run -d -ti debian bash
</syntaxhighlight>

Suponiendo que el contenido está identificado con el ID 56ef5b312334

Instalamos el paquete ping:

<syntaxhighlight lang="bash">
podman exec 56ef5b312334 apt -y install ping
</syntaxhighlight>

Generamos la imagen derivada con el nombre ''ubuntu-con-ping'':

<syntaxhighlight lang="bash">
podman commit 56ef5b312334 ubuntu-con-ping
</syntaxhighlight>

Ya podemos para nuestro contendor:

<syntaxhighlight lang="bash">
podman stop 56ef5b312334
</syntaxhighlight>

Y lanzar un nuevo contenedor a partir de la imagen ''debian-con-ping'':

<syntaxhighlight lang="bash">
podman run -d -ti debian-con-ping bash
</syntaxhighlight>

== Paso 10.2: Mantener la persistencia mediante volúmen ==

Otra opción para mantener los datos es montar un volumen al ejecutar el contenedor.

Primero crearemos una carpeta que hará de volumen en nuestra máquina, que será la que luego montemos para podman:

<syntaxhighlight lang="bash">
mkdir /home/debian/volumen
</syntaxhighlight>

Ahora vamos a montar la carpeta al ejecutar el contenedor, lo hacemos con la
opción -v, la cual tiene 3 campos separados por ':':

# El volumen en nuestra máquina
# Donde se montará el volumen dentro del contenedor
# Opciones de mmontaje, por ejemplo rw (read and write) o ro (read only)

<syntaxhighlight lang="bash">
podman run --rm -ti -v /home/debian/volumen:/volumen:rw debian bash
mkdir /volumen/test
touch /volumen/test/file
exit
</syntaxhighlight>

Una vez nos salgamos del contenedor, podemos ver que en nuestra máquina están
los datos:

<syntaxhighlight lang="bash">
ls /home/ubuntu/volumen/
ls /home/ubuntu/volumen/test
</syntaxhighlight>

La próxima vez que ejecutemos un contenedor, si montamos ese volumen, los datos
estarán ahí, además esta forma tiene el beneficio de compartir datos entre
nuestra máquina y el contenedor de forma sencilla.

= Paso 11: Crear nuestra propia imagen de contenedor =

Para crear una imagen de un contenedor con una aplicación de Python hug, creamos en primer lugar la carpeta que contendrá los ficheros que nos permiten crear la imagen.

<syntaxhighlight lang="bash">
mkdir miapp
cd miapp
</syntaxhighlight>

Definimos un fichero ''Dockerfile'' para definir la imagen:

<syntaxhighlight lang="bash">
FROM ubuntu

RUN apt -y update
RUN apt -y upgrade
RUN apt -y install python3-hug
RUN mkdir /app
COPY endpoint.py /app
WORKDIR /app
CMD hug -f endpoint.py
</syntaxhighlight>

Alternativamente, puedes crear un [[Creando imagen propia usando Ubuntu de base|Dockerfile empleando la imagen de Ubuntu]] como base en lugar de Alpine.

Y añadimos el fichero ''endpoint.py'' que emplea el framework Python hug con el contenido siguiente:

<syntaxhighlight lang="bash">
import hug

@hug.get('/welcome')
def welcome(username="unknown"):
""" Say welcome to username """
return "Welcome " + username
</syntaxhighlight>

Este fichero es un ejemplo de uso de Python hug. Si hacemos una petición a /welcome?username="LSO", esto nos devolverá el mensaje "Welcome LSO".

Una vez tengamos los dos ficheros creados en nuestra máquina virtual, podemos construir nuestra imagen:

<syntaxhighlight lang="bash">
podman build -t app:v1 -f Dockerfile .
</syntaxhighlight>

Vamos a explicar para que sirve cada línea:

* FROM: servirá para basarnos en una imagen existente, en este caso, una imagen de python alpine, que contiene python y no ocupa mucho espacio
* ENV: para crear variables de entorno
* RUN: para ejecutar comandos, ya sea para crear una carpeta, instalar dependencias o cualquier otra opción que necesitemos
* COPY: para copiar datos desde nuestra máquina a la imagen
* WORKDIR: para cambiar el directorio de trabajo
* CMD: este comando será ejecutado por defecto al iniciar un contenedor a partir de esta imagen

Esto construirá una imagen podman basada en python:alpine, en la cual hemos
guardado nuestra pequeña aplicación y se va a ejecutar cuando ejecutemos un
contenedor basado en esa imagen. Para comprobar que la imagen se ha creado
correctamente, listamos las imagenes, y debería de aparecernos una imagen con
nombre 'app' y tag 'v1':

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen, y vamos a añadir una nueva
opción, -p 8001:8000. Esta opción hará que el puerto interno 8000 del contenedor
sea expuesto en el puerto 8001 de nuestra máquina:

<syntaxhighlight lang="bash">
podman run --name my-app --rm -d -p 8001:8000 app:v1
</syntaxhighlight>

''Nota:'' podman supone que la redirección de puerto es TCP, para una redirección de puertos UDP, puedes usar:

<syntaxhighlight lang="bash">
... -p 8001:8000/udp
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código. En nuestra
máquina haremos:

<syntaxhighlight lang="bash">
curl -X GET http://localhost:8001/welcome?username=LSO
</syntaxhighlight>

Comprobaremos que la salida del comando curl, es "Welcome LSO".

Antes de terminar, vamos a comprobar otro pequeño detalle que añadimos en
nuestra imagen, la variable de entorno USERNAME, vamos a comprobar que funciona:

<syntaxhighlight lang="bash">
podman exec -ti my-app ash
echo $USERNAME
</syntaxhighlight>

Funciona correctamente, pero al ejecutar el contenedor, podemos cambiar esta
variable de entorno como vimos en uno de los pasos anteriores:

<syntaxhighlight lang="bash">
podman run --rm -ti -e USERNAME=me app:v1 ash
echo $USERNAME
</syntaxhighlight>

Esto nos servirá para tener opciones por defecto y que el usuario pueda
cambiarlo a su antojo, como por ejemplo contraseñas u otros detalles.

= Paso 12: Eliminar imágenes =

Para borrar una imagen, puede hacer:

<syntaxhighlight lang="bash">
podman image rm hello-world
</syntaxhighlight>

= Paso 13: Varios podman a la vez (podman-compose) =

Antes de comenzar, vamos a parar todos los contenedores que tengamos abiertos,
para dejar el entorno de podman limpio, que nos vendrá bien para esta parte.

Cuando queremos ejecutar varios contenedores a la vez y que estén conectados
entre ellos fácilmente, utilizaremos podman-compose, donde con un fichero de
configuración simple en yaml, tendremos toda la configuración de lo que vamos a
ejecutar.

Primero vamos a instalar podman-compose:

<syntaxhighlight lang="bash">
sudo apt install podman-compose
</syntaxhighlight>

Ahora veamos un pequeño ejemplo donde explicaremos todos los detalles para crear
un podman-compose, en este caso, el nombre por defecto de los ficheros suele ser
podman-compose.yml, y el contenido será similar a:

<syntaxhighlight lang="bash">
version: '3'

services:
web:
container_name: web
restart: always
build:
context: .
ports:
- "8000:8000"
volumes:
- /home/ubuntu/volume:/volumen:rw
environment:
USERNAME: test
web2:
container_name: web2
build:
dockerfile: Dockerfile
context: .
depends_on:
- web
command: touch web2
web3:
container_name: web3
restart: on-failure
image: pstauffer/curl
depends_on:
- web
command: curl -X GET web:8000/welcome?username=web3
</syntaxhighlight>

En el podman-compose definimos diferentes servicios a ejecutar, en nuestro caso
hemos iniciado tres servicios diferentes, web, web2 y web3:

El primer servicio, web:

* container_name: para darle un nombre por defecto al contenedor cuando se cree
* restart: pueden ser:
** "no": si la máquina termina, no se vuelve a iniciar (opción por defecto)
** always: siempre que el contenedor termine, intenta iniciarse de nuevo
** on-failure: solo intenta reiniciarse si el contenedor termina con fallo
** unless-stopped: solo reinicia el contenedor si el usuario es el que lo termina
* Utilizará el fichero Dockerfile creado en el paso 11 para generar la imagen a usar.
* Expondrá el puerto 8000 del contenedor en el 8000 de nuestra máquina
* Montará un volumen, se hace de forma similar a la línea de comandos
* Creará una variable de entorno

El segundo servicio, web2:

* Utilizará el fichero Dockerfile también, la diferencia entre este y el primer servicio, es que si el nombre del Dockerfile cambia, tendremos que hacerlo de esta segunda forma, la primera por defecto solo buscará el fichero Dockerfile
* depends_on hará que para ejecutar este servicio, su dependencia tenga ya que estar iniciada
* Ejecutaremos un comando el cual sustituirá al comando de la imagen

El tercer servicio, web3:

* Utilizará la imagen ostauffer/curl que es un imagen mínima que contiene el comando curl
* restart: en este caso, hasta que el comando no se ejecute correctamente, se seguirá reiniciando el contenedor
* depends_on igual que el servicio 2, dependerá del servicio 1
* Ejecutaremos un comando para llamar desde el servicio 3 al servicio 1

== Paso 13.1: Construir podman-compose ==

En el caso de existir servicios que tengan Dockerfiles, esto hará que se construyan previamente, como hacer un podman build de cada uno de los servicios que contenga un Dockerfile:

<syntaxhighlight lang="bash">
podman-compose build
</syntaxhighlight>

Con esto se generarán las imágenes necesarias para ejecutar todos los servicios.

== Paso 13.2: Iniciar podman-compose ==

Para iniciar todos los servicios, ejecutaremos:

<syntaxhighlight lang="bash">
podman-compose up -d
</syntaxhighlight>

Después de esto podremos ver el logs de todos los servicios:

<syntaxhighlight lang="bash">
podman-compose logs -f
</syntaxhighlight>

Aquí veremos que el servicio 3 ha conseguido llamar correctamente al servicio 1.

Ahora veremos como podman-compose ha creado los contenedores:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

La salida será similar a la siguiente:

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
219a4118244c pstauffer/curl "curl -X GET web:800…" 6 seconds ago Exited (0) 3 seconds ago web3
c97e894cb3ae ubuntu_web2 "touch web2" 6 seconds ago Exited (0) 4 seconds ago web2
f35d034204fc ubuntu_web "/bin/sh -c 'hug -f …" 6 seconds ago Up 5 seconds 0.0.0.0:8000->8000/tcp web
</syntaxhighlight>

Aquí vemos varios detalles:

* El nombre que le hemos dado en el podman-compose ha funcionado correctamente
* Vemos que los comandos son los correctos también
* web2 está parado por que la política de reinicio es apagar cuando se termine de ejecutar un comando
* web 3 está parado por que el comando ha terminado con un salida correcta

Vamos a comprobar ahora que en el servicio web está todo correcto:

<syntaxhighlight lang="bash">
podman exec -ti web ash
echo $USERNAME
ls /volumen
exit
</syntaxhighlight>

Podemos comprobar que tanto cambiar la variable de entorno como crear un
volumen ha funcionado correctamente.

== Paso 13.3: Parar podman-compose ==

Para parar todos los servicios:

<syntaxhighlight lang="bash">
podman-compose down
</syntaxhighlight>

Comprobamos:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Vemos que han desaparecido todos los contenedores.

= Paso 14: Ejercicios =

== Ejercicio 3: Variante de httpd ==

Construya una imagen ''httpd-hola-mundo'' a partir de la imagen ''httpd''. El fichero de index.html de la carpeta htdocs/ tiene que mostrar el mensaje "hola mundo".

<syntaxhighlight lang="bash">
podman pull httpd
</syntaxhighlight>

Edita el fichero Dockerfile:

<syntaxhighlight lang="bash">
nano Dockerfile
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
FROM httpd

COPY index.html htdocs/index.html
</syntaxhighlight>

Edita el fichero index.html:

<syntaxhighlight lang="bash">
nano index.html
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

Construye la imagen:

<syntaxhighlight lang="bash">
podman build -t mihttpd -f Dockerfile .
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen:

<syntaxhighlight lang="bash">
podman run --name mihttpd -d -p 8080:80 mihttpd
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código:
<syntaxhighlight lang="bash">
curl -X GET http://localhost:8080
</syntaxhighlight>

Tiene que salir por pantalla esto:
<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

== Ejercicio 4: aplicación flask ==

Flask es un framework python para implementar webs. Cree una imagen "miapp-flask" a partir de la imagen de "python":

* Instale flask mediante: pip install flask
* Cree la carpeta "app"
* Establezca la variable FLASK_APP a "hello.py"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"

El fichero hello.py contiene un "hola mundo" para Flask:

<syntaxhighlight lang="python">
from flask import Flask
app = Flask(__name__)

@app.route("/")
def hello():
return "Hello World!"

if __name__ == "__main__":
app.run()
</syntaxhighlight>

Solución con alpine:

<syntaxhighlight lang="bash">
FROM python:alpine

RUN mkdir /app
RUN pip install flask
ENV FLASK_APP="app/hello.py"
COPY hello.py
WORKDIR /
CMD flask run --host=0.0.0.0
</syntaxhighlight>

Solución con Ubuntu:

<syntaxhighlight lang="bash">
FROM ubuntu:bionic

RUN apt-get update
RUN apt-get -y install python python-pip wget
RUN pip install Flask
ENV FLASK_APP="app/hello.py"
RUN mkdir /app
COPY hello.py /app
CMD flask run --host=0.0.0.0
</syntaxhighlight>

== Ejercicio 5: mysql ==

'''EN LA MÁQUINA VIRTUAL:'''

mkdir miapp
cd miapp
podman pull mysql
nano Dockerfile

<syntaxhighlight lang="bash">
FROM mysql
ENV MYSQL_ROOT_PASSWORD="lacontraseñaqueyoquiera"
RUN mkdir /app
WORKDIR /app

</syntaxhighlight>

CTRL+O , ENTER Y CTRL+X (para guardar Dockerfile y salir)

podman build -ti mrfdocker -f Dockerfile .
podman run --name mymrf --rm -p 8001:3306 mrfdocker
docker images

'''EN LA TERMINAL DEL HOST:'''

''Instalación de mysql:''

apt install mysql-client-core-5.7
apt-get install mysql-server
service mysql start

''Para entrar:''

mysql -u root -p -P 8001

Una vez dentro de msql:

mysql> show databases;

''Para salir:''

exit

== Ejercicio 6: python pyramid ==

Pyramid es un framework python para implementar webs. Cree una imagen "miapp-pyramid":

* Emplee la imagen de Ubuntu como referencia, instale los paquetes python y python-pip.
* Instale Pyramid mediante: pip install pyramid
* Cree la carpeta "app"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"
* La aplicación se lanza con la orden: python hello.py
* Compruebe que funciona con curl, la ruta a la web es http://127.0.0.1:8000/hello, suponiendo que ha empleado el puerto 8000 para exponer el servicio.

El fichero hello.py contiene un "hola mundo" para Pyramid:

<syntaxhighlight lang="bash">
from wsgiref.simple_server import make_server
from pyramid.config import Configurator
from pyramid.response import Response

def hello_world(request):
print('Request inbound!')
return Response('Podman works with Pyramid!')

if __name__ == '__main__':
config = Configurator()
config.add_route('hello', '/')
config.add_view(hello_world, route_name='hello')
app = config.make_wsgi_app()
server = make_server('0.0.0.0', 6543, app)
server.serve_forever()
</syntaxhighlight>

Este programa recibe peticiones en el puerto 6543.

== Ejercicio 7 ==

Cree una imagen derivada de Ubuntu, instale el paquete apache2, php y libapache2-mod-php.
Active el módulo de php para apache2 mediante la orden:

<syntaxhighlight lang="bash">
a2enmod php
</syntaxhighlight>

Cree la carpeta /var/www/php.

Cree el fichero index.php

<syntaxhighlight lang="php">
<?php
Print "Hello, World!";
?>
</syntaxhighlight>

y copielo a /var/www/php/.

Cree el fichero 000-default.conf y copielo a /etc/apache2/sites-enabled/

Dicho fichero contiene.

<syntaxhighlight lang="bash">
<VirtualHost *:80>
DocumentRoot /var/www/php

<Directory /var/www/php/>
Options Indexes FollowSymLinks MultiViews
AllowOverride All
Order deny,allow
Allow from all
</Directory>

ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>
</syntaxhighlight>

Tiene que lanzar apache con la orden: apachectl -D FOREGROUND

Tras crear la imagen, láncela mapeando el puerto 8888 al 80, pruebe que puede acceder a http://127.0.0.1:8888/php/ mediante curl

Solución:

<syntaxhighlight lang="bash">
FROM ubuntu:latest

RUN apt-get update
RUN apt-get install -y tzdata
RUN apt-get install -y apache2
RUN apt-get install -y php
RUN apt-get install -y libapache2-mod-php
RUN a2enmod php7.2
COPY index.php /var/www/php
COPY 000-default.conf /etc/apache2/sites-enabled/
CMD apachectl -D FOREGROUND
</syntaxhighlight>

Y para lanzarlo:

podman run --name my-app --rm -d -p 8001:8000 app:v1

y para probarlo:

curl -X GET http://127.0.0.1:8888/php/

== Ejercicio 8 ==

Instale el paquete ''netcat-traditional'' en una imagen de contenedor de ''ubuntu''. Lance la orden:

nc -u -l -p 8080

en el contenedor. Asegúrese de crear una redirección de puertos de 9999 desde el ''host'' al puerto 8080 en el contenedor.

Desde fuera del contenedor, pruebe a conectarse con:

nc -u 127.0.0.1 9999

== Ejercicio 9 ==

Cree una imagen derivada de "ubuntu" con un Dockerfile que incluya soporte de python y lance el siguiente código en Python:

<syntax lang="python">
from http.server import BaseHTTPRequestHandler, HTTPServer
import time

hostName = "0.0.0.0"
serverPort = 8080

class MyServer(BaseHTTPRequestHandler):
def do_GET(self):
self.send_response(200)
self.send_header("Content-type", "text/html")
self.end_headers()
self.wfile.write(bytes("<html><head><title>Welcome!</title></head>", "utf-8"))
self.wfile.write(bytes("<body>", "utf-8"))
self.wfile.write(bytes("This is an example web server.", "utf-8"))
self.wfile.write(bytes("</body></html>", "utf-8"))

if __name__ == "__main__":
webServer = HTTPServer((hostName, serverPort), MyServer)
print("Server started http://%s:%s" % (hostName, serverPort))

try:
webServer.serve_forever()
except KeyboardInterrupt:
pass

webServer.server_close()
print("Server stopped.")
</syntax>

Llame a su imagen "python-http-server". Lance una instancia de la imagen "python-http-server" mapeando el puerto 9999 al puerto 8888/tcp del contenedor. Compruebe con:

<syntax lang="bash">
curl http://127.0.0.1:9999/
</syntax>

que muestre la página HTML que ofrece el servidor, que debería ser:

<syntax lang="bash">
<html><head><title>Welcome!</title></head><body>This is an example web server.</body></html>
</syntax>

Contenedores

2025-12-09T15:51:11Z

Pneira: /* Paso 14: Ejercicios */

En esta práctica aprenderemos a utilizar [https://es.wikipedia.org/wiki/Podman podman] para desplegar contenedores.

= Paso 1: Instalar podman =

Para instalar el paquete oficial:

<syntaxhighlight lang="bash">
apt install podman
</syntaxhighlight>

podman es un clon de '''docker''.

= Paso 2: Repositorio de imágenes de contenedores DockerHub =

Docker ofrece un servicio de nube denominado ''DockerHub'' que puede ser empleado como red social para compartir tus imágenes de Podman. En ''DockerHub'' existen además imágenes de contenedores preconfiguradas de software, muchas de ellas oficiales (ofrecidas por el propio fabricante del software) que se podrán emplear como base para construir nuevas imágenes adaptadas a nuestras necesidades.

Podremos realizar búsquedas en este repositorio ''DockerHub'' puedes emplear el siguiente comando:

<syntaxhighlight lang="bash">
podman search docker.io/library/hello-world
</syntaxhighlight>

Para descargarnos la imagen de ''hello-world'' podemos usar la orden ''pull'':

<syntaxhighlight lang="bash">
podman pull docker.io/library/hello-world
</syntaxhighlight>

También podemos publicar imágenes propias, esto require '''registro de usuario''' en la nube de ''DockerHub'', lo que '''no''' es obligatorio para la realización de esta práctica. Para subir una imagen, hay que validarse como usuario en la nube de ''DockerHub'':

<syntaxhighlight lang="bash">
podman login
</syntaxhighlight>

Tras introducir tu usuario y contraseña, puedes comenzar a publicar tus propias imágenes.

<syntaxhighlight lang="bash">
podman push MI_IMAGEN
</syntaxhighlight>

Este paso es '''opcional''', sólo en caso de que se quieran subir imágenes de contenedores a la nube de docker.io.

= Paso 4: Comprobar imágenes en nuestra máquina =

Para ver las imágenes que tenemos en nuestra máquina, utilizaremos el comando:

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Inicialmente, no tenemos imágenes en almacenamiento, podemos descargarnos la imagen oficial de Debian 13 (Trixie):

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian
</syntaxhighlight>

Ahora si, ya debería de aparecernos la imagen ''debian''.

Comentar también que cada imagen puede tener varias etiquetas, por ejemplo, la imagen Debian 12 (Bookworm), cuando la hemos visto en el listado de imágenes, venía con el tag latest, que es el tag que se descarga por defecto, pero nosotros podemos especificar otro, por ejemplo:

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian:bookworm
</syntaxhighlight>

Para traernos la versión de la imagen de Debian 12 ''Bookworm''.

Ahora tendremos dos imágenes con diferente etiqueta, que serían como las diferentes versiones de cada imagen.

= Paso 5: Lanzar un contenedor =

Un contenedor no es más que una imagen de podman ejecutándose, sería similar a
una máquina virtual, aunque mucho más liviano.

Para crear un contenedor, utilizaremos una imagen, en este caso, la imagen
hello-world. Hacemos lo siguiente:

<syntaxhighlight lang="bash">
podman run hello-world
</syntaxhighlight>

Esto nos mostrará el siguiente mensaje si todo está correcto:

<syntaxhighlight lang="bash">
Hello from Docker!
This message shows that your installation appears to be working correctly.

To generate this message, Docker took the following steps:
1. The Docker client contacted the Docker daemon.
2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
(amd64)
3. The Docker daemon created a new container from that image which runs the
executable that produces the output you are currently reading.
4. The Docker daemon streamed that output to the Docker client, which sent it
to your terminal.

To try something more ambitious, you can run an Debian container with:
$ podman run -it debian bash

Share images, automate workflows, and more with a free Docker ID:
https://hub.docker.com/

For more examples and ideas, visit:
https://docs.docker.com/get-started/
</syntaxhighlight>

Al crear los contenedores utilizando el comando 'run', tenemos varias opciones:

* Lanzar una terminal en el contenedor en modo interactivo
* Lanzar en segundo plano y conectarnos posteriormente al contenedor

== Paso 5.1: Lanzar una terminal en el contenedor en modo interactivo (-ti) ==

Para este ejemplo vamos a utilizar otra imagen diferente, en este caso vamos a utilizar una imagen de debian.

Vamos a lanzar un contenedor y ejecutar una terminal en el que se va a ejecutar el programa '''bash''' que me ofrece un interprete de órdenes:

<syntaxhighlight lang="bash">
podman run -ti debian bash
</syntaxhighlight>

La opción ''-t'' indica que se crea un terminal en el contenedor. Y la opción ''-i'' indica que el contenedor se ejecuta en modo interactivo.

Al acceder al contenedor de ''debian'' nos aparece un ''hash'' en el prompt de la shell, que identifica a la instancia del contenedor (es valor es similar al que muestra la orden ''podman container ls'').

Para salir del contenedor, escribimos 'exit' o pulsamos ''CTRL + D''

== Paso 5.2 Lanzar en segundo plano (-d) ==

Otro ejemplo, con la imagen de Debian:

<syntaxhighlight lang="bash">
podman run -dti debian
</syntaxhighlight>

que muestra un hash que identifica de forma única el contenedor lanzado:

<syntaxhighlight lang="bash">
2ec1daae4676a4e84dc04fd91399c1dfe92119544ff12ee307991fe573d3db64
</syntaxhighlight>

Mediante el comando ''attach'' puedo entrar al contenedor:

<syntaxhighlight lang="bash">
podman attach 2ec1daae4676
</syntaxhighlight>

Para salir, pulsamos ''CTRL + P'' seguido de ''CTRL + Q''.

De manera similar, puedo lanzar en segundo plano la imagen de contenedor de ''hello-world'':

<syntaxhighlight lang="bash">
podman run -d hello-world
</syntaxhighlight>

Y consultar los logs:

<syntaxhighlight lang="bash">
podman logs b67fae3312bc321
</syntaxhighlight>

== Paso 5.3: Añadir variables de entorno a un contenedor ==

Utilizaremos la imagen anterior, y vamos a añadir una variable de entorno
llamada TEST que contenga el valor 'test'. A parte, también ejecutaremos la
terminal como antes, para comprobar con el comando echo, que la variable de
entorno está creada correctamente:

<syntaxhighlight lang="bash">
podman run -ti -e TEST=test debian bash
</syntaxhighlight>

Ahora, desde el contenedor podemos comprobar el valor de la variable de entorno ''$TEST''.

<syntaxhighlight lang="bash">
echo $TEST
test
</syntaxhighlight>

= Paso 6: Listar contenedores en ejecución =

Hemos estado haciendo pruebas y ejecutando contenedores en el paso anterior, vamos a ver donde se encuentran estos contenedores que hemos ejecutado, y después veremos algunas opciones más del comando run.

Tenemos dos opciones para ver los contenedores:

<syntaxhighlight lang="bash">
podman container ls -a
</syntaxhighlight>

o la versión corta:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Ambas hacen lo mismo, y debería de mostrarnos una salida similar a la siguiente:

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
e2bde5f5500c debian "bash" 6 minutes ago Exited (0) 2 seconds ago pensive_sammet
544ad27dbc3c debian "bash" 7 minutes ago Exited (0) 7 minutes ago serene_elgamal
</syntaxhighlight>

En la información veremos que el contenedor tiene el estado exited, eso quiere decir que no se está ejecutando y ya ha finalizado. Vamos a hacer una prueba para ver un contendor ejecutándose:

<syntaxhighlight lang="bash">
podman run -d debian sleep 30
</syntaxhighlight>

Con el comando sleep 30 esperamos 30 segundos hasta que termine el comando, asíque durante esos 30 segundos, el contenedor estará ejecutándose, veámoslo:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
eacceb27d52d debian "sleep 30" 12 seconds ago Up 11 seconds sharp_pasteur
</syntaxhighlight>

Vamos a ver alguna opciones más de la orden ''run''.

== Paso 6.1: Dar un nombre al contenedor (--name) ==

Por defecto, podman creará automáticamente un nombre como hemos visto en las salidas del comando ''podman ps -a''. Podemos establecer el nombre del contenedor que queramos con la opción ''--name'':

<syntaxhighlight lang="bash">
podman run -ti --name mi_debian debian
</syntaxhighlight>

== Paso 6.2: Eliminar contenedor cuando termine (--rm) ==

Vamos a mezclar todo lo visto anteriormente:

* Lanzar en segundo plano (-d)
* Ejecutar contenedor durante 30 segundos (sleep 30)
* Dar un nombre a la imagen (--name)
* Eliminar contenedor cuando termine (--rm)

<syntaxhighlight lang="bash">
podman run -d --rm --name bye-bye debian sleep 30
</syntaxhighlight>

Antes y una vez pasados los 30 segundos, podemos comprobar que el contenedor ha desaparecido.

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

= Paso 7: Parar y eliminar contenedores =

Los contenedores podemos pararlos o eliminarlos, veamos como hacerlo. Antes que
nada, borraremos todos los contenedores que estén terminados, para ello:

<syntaxhighlight lang="bash">
podman container prune
podman ps -a
</syntaxhighlight>

Ya lo hemos dejado todo limpio para seguir, ahora vamos a crear un contenedor,
utilizando un comando de linux que no termina, para que así se quede
ejecutándose el contenedor infinitamente:

<syntaxhighlight lang="bash">
podman run -d -ti --name my_container debian bash
podman ps -a
</syntaxhighlight>

Vamos a pararlo (podemos utilizar el nombre dado o el id):

<syntaxhighlight lang="bash">
podman stop my_container
podman stop e4901956f108
podman ps -a
</syntaxhighlight>

Veremos que ya ha terminado, y ahora vamos a eliminarlo, pero solo este
contenedor, no como previamente que eliminamos todos. Lo mismo que para pararlo,
podemos utilizar el nombre o el id.

<syntaxhighlight lang="bash">
podman container rm my_container
podman container rm my_container
podman ps -a
</syntaxhighlight>

Veremos que ya no tenemos el contenedor y está correctamente eliminado.

= Paso 8: Conectarnos a un contenedor que se está ejecutando en segundo plano =

Vamos a ejecutar de nuevo un contenedor que no termine:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a conectarnos a este contenedor que está ejecutándose en segundo
plano:

<syntaxhighlight lang="bash">
podman attach mi-contenedor
</syntaxhighlight>

Veremos la orden bash ejecutándose, para terminar, hacemos un 'CTRL + C', y ahora, veremos que ha pasado con el contenedor:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Lo veremos parado, por que lo que hemos hecho ha sido conectarnos al contenedor
y parar el comando que se estaba ejecutando, así que ahora tenemos el contenedor
finalizado.

''Nota:'' Para salir del contenedor '''sin detenerlo''' hacemos 'CTRL + P' seguido 'CTRL + Q'

= Paso 9: Ejecutar un comando dentro de un contenedor en ejecución =

Vamos a ver otresta vez como ejecutar un comando en un contenedor que ya está
ejecutándose:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a ejecutar un comando en ese contenedor con el nombre ''mi-contenedor''.
El comando exec es similar al comando run, pero para ejecutar un comando dentro de un contenedor:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor ls
</syntaxhighlight>

Para redirigir la salida a un fichero en el anfitrión:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor ls > x.txt
</syntaxhighlight>

Para redirigir la salida a un fichero ''dentro'' del contenedor, hacemos:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor bash -c "ls > x.txt"
</syntaxhighlight>

= Paso 10: Persistencia en contenedores =

Al hacer ''exit'' y salir de un contenedor, se pierden todos los cambios que hemos realizado. Los

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-ejemplo debian bash
</syntaxhighlight>

Ahora, vamos a crear una carpeta en el contenedor y comprobar que esa carpeta existe:

<syntaxhighlight lang="bash">
podman exec mi-ejemplo mkdir test
podman exec mi-ejemplo ls
</syntaxhighlight>

Veremos que la carpeta existe, pero, ¿qué ocurre si para el contenedor?

<syntaxhighlight lang="bash">
podman container stop mi-ejemplo
</syntaxhighlight>

Y volvemos a lanzarlo:

<syntaxhighlight lang="bash">
podman container rm mi-ejemplo
podman run -d -ti --name mi-ejemplo debian bash
podman exec mi-ejemplo ls
</syntaxhighlight>

Podemos comprobar que la carpeta creada anteriormente, no existe.

¿Qué podemos hacer para mantener la modificaciones realizadas sobre un contenedor?

== Paso 10.1: Crear una imagen derivada de la imagen base ==

Es posible crear una imagen derivada, con modificaciones, a partir de una imagen existente mediante la orden '''commit'''.

Por ejemplo, si queremos una imagen ''debian'' que incluya el programa ''ping'' ya instalado, tendríamos que lanzar un contenedor a partir de la imagen ''ubuntu'':

<syntaxhighlight lang="bash">
podman run -d -ti debian bash
</syntaxhighlight>

Suponiendo que el contenido está identificado con el ID 56ef5b312334

Instalamos el paquete ping:

<syntaxhighlight lang="bash">
podman exec 56ef5b312334 apt -y install ping
</syntaxhighlight>

Generamos la imagen derivada con el nombre ''ubuntu-con-ping'':

<syntaxhighlight lang="bash">
podman commit 56ef5b312334 ubuntu-con-ping
</syntaxhighlight>

Ya podemos para nuestro contendor:

<syntaxhighlight lang="bash">
podman stop 56ef5b312334
</syntaxhighlight>

Y lanzar un nuevo contenedor a partir de la imagen ''debian-con-ping'':

<syntaxhighlight lang="bash">
podman run -d -ti debian-con-ping bash
</syntaxhighlight>

== Paso 10.2: Mantener la persistencia mediante volúmen ==

Otra opción para mantener los datos es montar un volumen al ejecutar el contenedor.

Primero crearemos una carpeta que hará de volumen en nuestra máquina, que será la que luego montemos para podman:

<syntaxhighlight lang="bash">
mkdir /home/debian/volumen
</syntaxhighlight>

Ahora vamos a montar la carpeta al ejecutar el contenedor, lo hacemos con la
opción -v, la cual tiene 3 campos separados por ':':

# El volumen en nuestra máquina
# Donde se montará el volumen dentro del contenedor
# Opciones de mmontaje, por ejemplo rw (read and write) o ro (read only)

<syntaxhighlight lang="bash">
podman run --rm -ti -v /home/debian/volumen:/volumen:rw debian bash
mkdir /volumen/test
touch /volumen/test/file
exit
</syntaxhighlight>

Una vez nos salgamos del contenedor, podemos ver que en nuestra máquina están
los datos:

<syntaxhighlight lang="bash">
ls /home/ubuntu/volumen/
ls /home/ubuntu/volumen/test
</syntaxhighlight>

La próxima vez que ejecutemos un contenedor, si montamos ese volumen, los datos
estarán ahí, además esta forma tiene el beneficio de compartir datos entre
nuestra máquina y el contenedor de forma sencilla.

= Paso 11: Crear nuestra propia imagen de contenedor =

Para crear una imagen de un contenedor con una aplicación de Python hug, creamos en primer lugar la carpeta que contendrá los ficheros que nos permiten crear la imagen.

<syntaxhighlight lang="bash">
mkdir miapp
cd miapp
</syntaxhighlight>

Definimos un fichero ''Dockerfile'' para definir la imagen:

<syntaxhighlight lang="bash">
FROM ubuntu

RUN apt -y update
RUN apt -y upgrade
RUN apt -y install python3-hug
RUN mkdir /app
COPY endpoint.py /app
WORKDIR /app
CMD hug -f endpoint.py
</syntaxhighlight>

Alternativamente, puedes crear un [[Creando imagen propia usando Ubuntu de base|Dockerfile empleando la imagen de Ubuntu]] como base en lugar de Alpine.

Y añadimos el fichero ''endpoint.py'' que emplea el framework Python hug con el contenido siguiente:

<syntaxhighlight lang="bash">
import hug

@hug.get('/welcome')
def welcome(username="unknown"):
""" Say welcome to username """
return "Welcome " + username
</syntaxhighlight>

Este fichero es un ejemplo de uso de Python hug. Si hacemos una petición a /welcome?username="LSO", esto nos devolverá el mensaje "Welcome LSO".

Una vez tengamos los dos ficheros creados en nuestra máquina virtual, podemos construir nuestra imagen:

<syntaxhighlight lang="bash">
podman build -t app:v1 -f Dockerfile .
</syntaxhighlight>

Vamos a explicar para que sirve cada línea:

* FROM: servirá para basarnos en una imagen existente, en este caso, una imagen de python alpine, que contiene python y no ocupa mucho espacio
* ENV: para crear variables de entorno
* RUN: para ejecutar comandos, ya sea para crear una carpeta, instalar dependencias o cualquier otra opción que necesitemos
* COPY: para copiar datos desde nuestra máquina a la imagen
* WORKDIR: para cambiar el directorio de trabajo
* CMD: este comando será ejecutado por defecto al iniciar un contenedor a partir de esta imagen

Esto construirá una imagen podman basada en python:alpine, en la cual hemos
guardado nuestra pequeña aplicación y se va a ejecutar cuando ejecutemos un
contenedor basado en esa imagen. Para comprobar que la imagen se ha creado
correctamente, listamos las imagenes, y debería de aparecernos una imagen con
nombre 'app' y tag 'v1':

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen, y vamos a añadir una nueva
opción, -p 8001:8000. Esta opción hará que el puerto interno 8000 del contenedor
sea expuesto en el puerto 8001 de nuestra máquina:

<syntaxhighlight lang="bash">
podman run --name my-app --rm -d -p 8001:8000 app:v1
</syntaxhighlight>

''Nota:'' podman supone que la redirección de puerto es TCP, para una redirección de puertos UDP, puedes usar:

<syntaxhighlight lang="bash">
... -p 8001:8000/udp
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código. En nuestra
máquina haremos:

<syntaxhighlight lang="bash">
curl -X GET http://localhost:8001/welcome?username=LSO
</syntaxhighlight>

Comprobaremos que la salida del comando curl, es "Welcome LSO".

Antes de terminar, vamos a comprobar otro pequeño detalle que añadimos en
nuestra imagen, la variable de entorno USERNAME, vamos a comprobar que funciona:

<syntaxhighlight lang="bash">
podman exec -ti my-app ash
echo $USERNAME
</syntaxhighlight>

Funciona correctamente, pero al ejecutar el contenedor, podemos cambiar esta
variable de entorno como vimos en uno de los pasos anteriores:

<syntaxhighlight lang="bash">
podman run --rm -ti -e USERNAME=me app:v1 ash
echo $USERNAME
</syntaxhighlight>

Esto nos servirá para tener opciones por defecto y que el usuario pueda
cambiarlo a su antojo, como por ejemplo contraseñas u otros detalles.

= Paso 12: Eliminar imágenes =

Para borrar una imagen, puede hacer:

<syntaxhighlight lang="bash">
podman image rm hello-world
</syntaxhighlight>

= Paso 13: Varios podman a la vez (podman-compose) =

Antes de comenzar, vamos a parar todos los contenedores que tengamos abiertos,
para dejar el entorno de podman limpio, que nos vendrá bien para esta parte.

Cuando queremos ejecutar varios contenedores a la vez y que estén conectados
entre ellos fácilmente, utilizaremos podman-compose, donde con un fichero de
configuración simple en yaml, tendremos toda la configuración de lo que vamos a
ejecutar.

Primero vamos a instalar podman-compose:

<syntaxhighlight lang="bash">
sudo apt install podman-compose
</syntaxhighlight>

Ahora veamos un pequeño ejemplo donde explicaremos todos los detalles para crear
un podman-compose, en este caso, el nombre por defecto de los ficheros suele ser
podman-compose.yml, y el contenido será similar a:

<syntaxhighlight lang="bash">
version: '3'

services:
web:
container_name: web
restart: always
build:
context: .
ports:
- "8000:8000"
volumes:
- /home/ubuntu/volume:/volumen:rw
environment:
USERNAME: test
web2:
container_name: web2
build:
dockerfile: Dockerfile
context: .
depends_on:
- web
command: touch web2
web3:
container_name: web3
restart: on-failure
image: pstauffer/curl
depends_on:
- web
command: curl -X GET web:8000/welcome?username=web3
</syntaxhighlight>

En el podman-compose definimos diferentes servicios a ejecutar, en nuestro caso
hemos iniciado tres servicios diferentes, web, web2 y web3:

El primer servicio, web:

* container_name: para darle un nombre por defecto al contenedor cuando se cree
* restart: pueden ser:
** "no": si la máquina termina, no se vuelve a iniciar (opción por defecto)
** always: siempre que el contenedor termine, intenta iniciarse de nuevo
** on-failure: solo intenta reiniciarse si el contenedor termina con fallo
** unless-stopped: solo reinicia el contenedor si el usuario es el que lo termina
* Utilizará el fichero Dockerfile creado en el paso 11 para generar la imagen a usar.
* Expondrá el puerto 8000 del contenedor en el 8000 de nuestra máquina
* Montará un volumen, se hace de forma similar a la línea de comandos
* Creará una variable de entorno

El segundo servicio, web2:

* Utilizará el fichero Dockerfile también, la diferencia entre este y el primer servicio, es que si el nombre del Dockerfile cambia, tendremos que hacerlo de esta segunda forma, la primera por defecto solo buscará el fichero Dockerfile
* depends_on hará que para ejecutar este servicio, su dependencia tenga ya que estar iniciada
* Ejecutaremos un comando el cual sustituirá al comando de la imagen

El tercer servicio, web3:

* Utilizará la imagen ostauffer/curl que es un imagen mínima que contiene el comando curl
* restart: en este caso, hasta que el comando no se ejecute correctamente, se seguirá reiniciando el contenedor
* depends_on igual que el servicio 2, dependerá del servicio 1
* Ejecutaremos un comando para llamar desde el servicio 3 al servicio 1

== Paso 13.1: Construir podman-compose ==

En el caso de existir servicios que tengan Dockerfiles, esto hará que se construyan previamente, como hacer un podman build de cada uno de los servicios que contenga un Dockerfile:

<syntaxhighlight lang="bash">
podman-compose build
</syntaxhighlight>

Con esto se generarán las imágenes necesarias para ejecutar todos los servicios.

== Paso 13.2: Iniciar podman-compose ==

Para iniciar todos los servicios, ejecutaremos:

<syntaxhighlight lang="bash">
podman-compose up -d
</syntaxhighlight>

Después de esto podremos ver el logs de todos los servicios:

<syntaxhighlight lang="bash">
podman-compose logs -f
</syntaxhighlight>

Aquí veremos que el servicio 3 ha conseguido llamar correctamente al servicio 1.

Ahora veremos como podman-compose ha creado los contenedores:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

La salida será similar a la siguiente:

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
219a4118244c pstauffer/curl "curl -X GET web:800…" 6 seconds ago Exited (0) 3 seconds ago web3
c97e894cb3ae ubuntu_web2 "touch web2" 6 seconds ago Exited (0) 4 seconds ago web2
f35d034204fc ubuntu_web "/bin/sh -c 'hug -f …" 6 seconds ago Up 5 seconds 0.0.0.0:8000->8000/tcp web
</syntaxhighlight>

Aquí vemos varios detalles:

* El nombre que le hemos dado en el podman-compose ha funcionado correctamente
* Vemos que los comandos son los correctos también
* web2 está parado por que la política de reinicio es apagar cuando se termine de ejecutar un comando
* web 3 está parado por que el comando ha terminado con un salida correcta

Vamos a comprobar ahora que en el servicio web está todo correcto:

<syntaxhighlight lang="bash">
podman exec -ti web ash
echo $USERNAME
ls /volumen
exit
</syntaxhighlight>

Podemos comprobar que tanto cambiar la variable de entorno como crear un
volumen ha funcionado correctamente.

== Paso 13.3: Parar podman-compose ==

Para parar todos los servicios:

<syntaxhighlight lang="bash">
podman-compose down
</syntaxhighlight>

Comprobamos:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Vemos que han desaparecido todos los contenedores.

= Paso 14: Ejercicios =

== Ejercicio 3: Variante de httpd ==

Construya una imagen ''httpd-hola-mundo'' a partir de la imagen ''httpd''. El fichero de index.html de la carpeta htdocs/ tiene que mostrar el mensaje "hola mundo".

<syntaxhighlight lang="bash">
podman pull httpd
</syntaxhighlight>

Edita el fichero Dockerfile:

<syntaxhighlight lang="bash">
nano Dockerfile
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
FROM httpd

COPY index.html htdocs/index.html
</syntaxhighlight>

Edita el fichero index.html:

<syntaxhighlight lang="bash">
nano index.html
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

Construye la imagen:

<syntaxhighlight lang="bash">
podman build -t mihttpd -f Dockerfile .
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen:

<syntaxhighlight lang="bash">
podman run --name mihttpd -d -p 8080:80 mihttpd
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código:
<syntaxhighlight lang="bash">
curl -X GET http://localhost:8080
</syntaxhighlight>

Tiene que salir por pantalla esto:
<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

== Ejercicio 4: aplicación flask ==

Flask es un framework python para implementar webs. Cree una imagen "miapp-flask" a partir de la imagen de "python":

* Instale flask mediante: pip install flask
* Cree la carpeta "app"
* Establezca la variable FLASK_APP a "hello.py"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"

El fichero hello.py contiene un "hola mundo" para Flask:

<syntaxhighlight lang="python">
from flask import Flask
app = Flask(__name__)

@app.route("/")
def hello():
return "Hello World!"

if __name__ == "__main__":
app.run()
</syntaxhighlight>

Solución con alpine:

<syntaxhighlight lang="bash">
FROM python:alpine

RUN mkdir /app
RUN pip install flask
ENV FLASK_APP="app/hello.py"
COPY hello.py
WORKDIR /
CMD flask run --host=0.0.0.0
</syntaxhighlight>

Solución con Ubuntu:

<syntaxhighlight lang="bash">
FROM ubuntu:bionic

RUN apt-get update
RUN apt-get -y install python python-pip wget
RUN pip install Flask
ENV FLASK_APP="app/hello.py"
RUN mkdir /app
COPY hello.py /app
CMD flask run --host=0.0.0.0
</syntaxhighlight>

== Ejercicio 5: mysql ==

'''EN LA MÁQUINA VIRTUAL:'''

mkdir miapp
cd miapp
podman pull mysql
nano Dockerfile

<syntaxhighlight lang="bash">
FROM mysql
ENV MYSQL_ROOT_PASSWORD="lacontraseñaqueyoquiera"
RUN mkdir /app
WORKDIR /app

</syntaxhighlight>

CTRL+O , ENTER Y CTRL+X (para guardar Dockerfile y salir)

podman build -ti mrfdocker -f Dockerfile .
podman run --name mymrf --rm -p 8001:3306 mrfdocker
docker images

'''EN LA TERMINAL DEL HOST:'''

''Instalación de mysql:''

apt install mysql-client-core-5.7
apt-get install mysql-server
service mysql start

''Para entrar:''

mysql -u root -p -P 8001

Una vez dentro de msql:

mysql> show databases;

''Para salir:''

exit

== Ejercicio 6: python pyramid ==

Pyramid es un framework python para implementar webs. Cree una imagen "miapp-pyramid":

* Emplee la imagen de Ubuntu como referencia, instale los paquetes python y python-pip.
* Instale Pyramid mediante: pip install pyramid
* Cree la carpeta "app"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"
* La aplicación se lanza con la orden: python hello.py
* Compruebe que funciona con curl, la ruta a la web es http://127.0.0.1:8000/hello, suponiendo que ha empleado el puerto 8000 para exponer el servicio.

El fichero hello.py contiene un "hola mundo" para Pyramid:

<syntaxhighlight lang="bash">
from wsgiref.simple_server import make_server
from pyramid.config import Configurator
from pyramid.response import Response

def hello_world(request):
print('Request inbound!')
return Response('Podman works with Pyramid!')

if __name__ == '__main__':
config = Configurator()
config.add_route('hello', '/')
config.add_view(hello_world, route_name='hello')
app = config.make_wsgi_app()
server = make_server('0.0.0.0', 6543, app)
server.serve_forever()
</syntaxhighlight>

Este programa recibe peticiones en el puerto 6543.

== Ejercicio 7 ==

Cree una imagen derivada de Ubuntu, instale el paquete apache2, php y libapache2-mod-php.
Active el módulo de php para apache2 mediante la orden:

<syntaxhighlight lang="bash">
a2enmod php
</syntaxhighlight>

Cree la carpeta /var/www/php.

Cree el fichero index.php

<syntaxhighlight lang="php">
<?php
Print "Hello, World!";
?>
</syntaxhighlight>

y copielo a /var/www/php/.

Cree el fichero 000-default.conf y copielo a /etc/apache2/sites-enabled/

Dicho fichero contiene.

<syntaxhighlight lang="bash">
<VirtualHost *:80>
DocumentRoot /var/www/php

<Directory /var/www/php/>
Options Indexes FollowSymLinks MultiViews
AllowOverride All
Order deny,allow
Allow from all
</Directory>

ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>
</syntaxhighlight>

Tiene que lanzar apache con la orden: apachectl -D FOREGROUND

Tras crear la imagen, láncela mapeando el puerto 8888 al 80, pruebe que puede acceder a http://127.0.0.1:8888/php/ mediante curl

Solución:

<syntaxhighlight lang="bash">
FROM ubuntu:latest

RUN apt-get update
RUN apt-get install -y tzdata
RUN apt-get install -y apache2
RUN apt-get install -y php
RUN apt-get install -y libapache2-mod-php
RUN a2enmod php7.2
COPY index.php /var/www/php
COPY 000-default.conf /etc/apache2/sites-enabled/
CMD apachectl -D FOREGROUND
</syntaxhighlight>

Y para lanzarlo:

podman run --name my-app --rm -d -p 8001:8000 app:v1

y para probarlo:

curl -X GET http://127.0.0.1:8888/php/

== Ejercicio 8 ==

Instale el paquete ''netcat-traditional'' en una imagen de contenedor de ''ubuntu''. Lance la orden:

nc -u -l -p 8080

en el contenedor. Asegúrese de crear una redirección de puertos de 9999 desde el ''host'' al puerto 8080 en el contenedor.

Desde fuera del contenedor, pruebe a conectarse con:

nc -u 127.0.0.1 9999

== Ejercicio 9 ==

Cree una imagen derivada de "ubuntu" con un Dockerfile que incluya soporte de python y lance el siguiente código en Python:

<syntax lang="python">
from http.server import BaseHTTPRequestHandler, HTTPServer
import time

hostName = "0.0.0.0"
serverPort = 8080

class MyServer(BaseHTTPRequestHandler):
def do_GET(self):
self.send_response(200)
self.send_header("Content-type", "text/html")
self.end_headers()
self.wfile.write(bytes("<html><head><title>Welcome!</title></head>", "utf-8"))
self.wfile.write(bytes("<body>", "utf-8"))
self.wfile.write(bytes("This is an example web server.", "utf-8"))
self.wfile.write(bytes("</body></html>", "utf-8"))

if __name__ == "__main__":
webServer = HTTPServer((hostName, serverPort), MyServer)
print("Server started http://%s:%s" % (hostName, serverPort))

try:
webServer.serve_forever()
except KeyboardInterrupt:
pass

webServer.server_close()
print("Server stopped.")
</syntax>

Llame a su imagen "python-http-server". Lance una instancia de la imagen "python-http-server" mapeando el puerto 9999 al puerto 8888/tcp del contenedor. Compruebe con:

<syntax lang="bash">
curl http://127.0.0.1:9999/
</syntax>

que muestre la página HTML que ofrece el servidor, que debería ser:

<syntax lang="bash">
<html><head><title>Welcome!</title></head><body>This is an example web server.</body></html>
</syntax>

Contenedores

2025-12-09T15:50:05Z

Pneira: /* Paso 14: Ejercicios */

En esta práctica aprenderemos a utilizar [https://es.wikipedia.org/wiki/Podman podman] para desplegar contenedores.

= Paso 1: Instalar podman =

Para instalar el paquete oficial:

<syntaxhighlight lang="bash">
apt install podman
</syntaxhighlight>

podman es un clon de '''docker''.

= Paso 2: Repositorio de imágenes de contenedores DockerHub =

Docker ofrece un servicio de nube denominado ''DockerHub'' que puede ser empleado como red social para compartir tus imágenes de Podman. En ''DockerHub'' existen además imágenes de contenedores preconfiguradas de software, muchas de ellas oficiales (ofrecidas por el propio fabricante del software) que se podrán emplear como base para construir nuevas imágenes adaptadas a nuestras necesidades.

Podremos realizar búsquedas en este repositorio ''DockerHub'' puedes emplear el siguiente comando:

<syntaxhighlight lang="bash">
podman search docker.io/library/hello-world
</syntaxhighlight>

Para descargarnos la imagen de ''hello-world'' podemos usar la orden ''pull'':

<syntaxhighlight lang="bash">
podman pull docker.io/library/hello-world
</syntaxhighlight>

También podemos publicar imágenes propias, esto require '''registro de usuario''' en la nube de ''DockerHub'', lo que '''no''' es obligatorio para la realización de esta práctica. Para subir una imagen, hay que validarse como usuario en la nube de ''DockerHub'':

<syntaxhighlight lang="bash">
podman login
</syntaxhighlight>

Tras introducir tu usuario y contraseña, puedes comenzar a publicar tus propias imágenes.

<syntaxhighlight lang="bash">
podman push MI_IMAGEN
</syntaxhighlight>

Este paso es '''opcional''', sólo en caso de que se quieran subir imágenes de contenedores a la nube de docker.io.

= Paso 4: Comprobar imágenes en nuestra máquina =

Para ver las imágenes que tenemos en nuestra máquina, utilizaremos el comando:

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Inicialmente, no tenemos imágenes en almacenamiento, podemos descargarnos la imagen oficial de Debian 13 (Trixie):

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian
</syntaxhighlight>

Ahora si, ya debería de aparecernos la imagen ''debian''.

Comentar también que cada imagen puede tener varias etiquetas, por ejemplo, la imagen Debian 12 (Bookworm), cuando la hemos visto en el listado de imágenes, venía con el tag latest, que es el tag que se descarga por defecto, pero nosotros podemos especificar otro, por ejemplo:

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian:bookworm
</syntaxhighlight>

Para traernos la versión de la imagen de Debian 12 ''Bookworm''.

Ahora tendremos dos imágenes con diferente etiqueta, que serían como las diferentes versiones de cada imagen.

= Paso 5: Lanzar un contenedor =

Un contenedor no es más que una imagen de podman ejecutándose, sería similar a
una máquina virtual, aunque mucho más liviano.

Para crear un contenedor, utilizaremos una imagen, en este caso, la imagen
hello-world. Hacemos lo siguiente:

<syntaxhighlight lang="bash">
podman run hello-world
</syntaxhighlight>

Esto nos mostrará el siguiente mensaje si todo está correcto:

<syntaxhighlight lang="bash">
Hello from Docker!
This message shows that your installation appears to be working correctly.

To generate this message, Docker took the following steps:
1. The Docker client contacted the Docker daemon.
2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
(amd64)
3. The Docker daemon created a new container from that image which runs the
executable that produces the output you are currently reading.
4. The Docker daemon streamed that output to the Docker client, which sent it
to your terminal.

To try something more ambitious, you can run an Debian container with:
$ podman run -it debian bash

Share images, automate workflows, and more with a free Docker ID:
https://hub.docker.com/

For more examples and ideas, visit:
https://docs.docker.com/get-started/
</syntaxhighlight>

Al crear los contenedores utilizando el comando 'run', tenemos varias opciones:

* Lanzar una terminal en el contenedor en modo interactivo
* Lanzar en segundo plano y conectarnos posteriormente al contenedor

== Paso 5.1: Lanzar una terminal en el contenedor en modo interactivo (-ti) ==

Para este ejemplo vamos a utilizar otra imagen diferente, en este caso vamos a utilizar una imagen de debian.

Vamos a lanzar un contenedor y ejecutar una terminal en el que se va a ejecutar el programa '''bash''' que me ofrece un interprete de órdenes:

<syntaxhighlight lang="bash">
podman run -ti debian bash
</syntaxhighlight>

La opción ''-t'' indica que se crea un terminal en el contenedor. Y la opción ''-i'' indica que el contenedor se ejecuta en modo interactivo.

Al acceder al contenedor de ''debian'' nos aparece un ''hash'' en el prompt de la shell, que identifica a la instancia del contenedor (es valor es similar al que muestra la orden ''podman container ls'').

Para salir del contenedor, escribimos 'exit' o pulsamos ''CTRL + D''

== Paso 5.2 Lanzar en segundo plano (-d) ==

Otro ejemplo, con la imagen de Debian:

<syntaxhighlight lang="bash">
podman run -dti debian
</syntaxhighlight>

que muestra un hash que identifica de forma única el contenedor lanzado:

<syntaxhighlight lang="bash">
2ec1daae4676a4e84dc04fd91399c1dfe92119544ff12ee307991fe573d3db64
</syntaxhighlight>

Mediante el comando ''attach'' puedo entrar al contenedor:

<syntaxhighlight lang="bash">
podman attach 2ec1daae4676
</syntaxhighlight>

Para salir, pulsamos ''CTRL + P'' seguido de ''CTRL + Q''.

De manera similar, puedo lanzar en segundo plano la imagen de contenedor de ''hello-world'':

<syntaxhighlight lang="bash">
podman run -d hello-world
</syntaxhighlight>

Y consultar los logs:

<syntaxhighlight lang="bash">
podman logs b67fae3312bc321
</syntaxhighlight>

== Paso 5.3: Añadir variables de entorno a un contenedor ==

Utilizaremos la imagen anterior, y vamos a añadir una variable de entorno
llamada TEST que contenga el valor 'test'. A parte, también ejecutaremos la
terminal como antes, para comprobar con el comando echo, que la variable de
entorno está creada correctamente:

<syntaxhighlight lang="bash">
podman run -ti -e TEST=test debian bash
</syntaxhighlight>

Ahora, desde el contenedor podemos comprobar el valor de la variable de entorno ''$TEST''.

<syntaxhighlight lang="bash">
echo $TEST
test
</syntaxhighlight>

= Paso 6: Listar contenedores en ejecución =

Hemos estado haciendo pruebas y ejecutando contenedores en el paso anterior, vamos a ver donde se encuentran estos contenedores que hemos ejecutado, y después veremos algunas opciones más del comando run.

Tenemos dos opciones para ver los contenedores:

<syntaxhighlight lang="bash">
podman container ls -a
</syntaxhighlight>

o la versión corta:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Ambas hacen lo mismo, y debería de mostrarnos una salida similar a la siguiente:

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
e2bde5f5500c debian "bash" 6 minutes ago Exited (0) 2 seconds ago pensive_sammet
544ad27dbc3c debian "bash" 7 minutes ago Exited (0) 7 minutes ago serene_elgamal
</syntaxhighlight>

En la información veremos que el contenedor tiene el estado exited, eso quiere decir que no se está ejecutando y ya ha finalizado. Vamos a hacer una prueba para ver un contendor ejecutándose:

<syntaxhighlight lang="bash">
podman run -d debian sleep 30
</syntaxhighlight>

Con el comando sleep 30 esperamos 30 segundos hasta que termine el comando, asíque durante esos 30 segundos, el contenedor estará ejecutándose, veámoslo:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
eacceb27d52d debian "sleep 30" 12 seconds ago Up 11 seconds sharp_pasteur
</syntaxhighlight>

Vamos a ver alguna opciones más de la orden ''run''.

== Paso 6.1: Dar un nombre al contenedor (--name) ==

Por defecto, podman creará automáticamente un nombre como hemos visto en las salidas del comando ''podman ps -a''. Podemos establecer el nombre del contenedor que queramos con la opción ''--name'':

<syntaxhighlight lang="bash">
podman run -ti --name mi_debian debian
</syntaxhighlight>

== Paso 6.2: Eliminar contenedor cuando termine (--rm) ==

Vamos a mezclar todo lo visto anteriormente:

* Lanzar en segundo plano (-d)
* Ejecutar contenedor durante 30 segundos (sleep 30)
* Dar un nombre a la imagen (--name)
* Eliminar contenedor cuando termine (--rm)

<syntaxhighlight lang="bash">
podman run -d --rm --name bye-bye debian sleep 30
</syntaxhighlight>

Antes y una vez pasados los 30 segundos, podemos comprobar que el contenedor ha desaparecido.

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

= Paso 7: Parar y eliminar contenedores =

Los contenedores podemos pararlos o eliminarlos, veamos como hacerlo. Antes que
nada, borraremos todos los contenedores que estén terminados, para ello:

<syntaxhighlight lang="bash">
podman container prune
podman ps -a
</syntaxhighlight>

Ya lo hemos dejado todo limpio para seguir, ahora vamos a crear un contenedor,
utilizando un comando de linux que no termina, para que así se quede
ejecutándose el contenedor infinitamente:

<syntaxhighlight lang="bash">
podman run -d -ti --name my_container debian bash
podman ps -a
</syntaxhighlight>

Vamos a pararlo (podemos utilizar el nombre dado o el id):

<syntaxhighlight lang="bash">
podman stop my_container
podman stop e4901956f108
podman ps -a
</syntaxhighlight>

Veremos que ya ha terminado, y ahora vamos a eliminarlo, pero solo este
contenedor, no como previamente que eliminamos todos. Lo mismo que para pararlo,
podemos utilizar el nombre o el id.

<syntaxhighlight lang="bash">
podman container rm my_container
podman container rm my_container
podman ps -a
</syntaxhighlight>

Veremos que ya no tenemos el contenedor y está correctamente eliminado.

= Paso 8: Conectarnos a un contenedor que se está ejecutando en segundo plano =

Vamos a ejecutar de nuevo un contenedor que no termine:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a conectarnos a este contenedor que está ejecutándose en segundo
plano:

<syntaxhighlight lang="bash">
podman attach mi-contenedor
</syntaxhighlight>

Veremos la orden bash ejecutándose, para terminar, hacemos un 'CTRL + C', y ahora, veremos que ha pasado con el contenedor:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Lo veremos parado, por que lo que hemos hecho ha sido conectarnos al contenedor
y parar el comando que se estaba ejecutando, así que ahora tenemos el contenedor
finalizado.

''Nota:'' Para salir del contenedor '''sin detenerlo''' hacemos 'CTRL + P' seguido 'CTRL + Q'

= Paso 9: Ejecutar un comando dentro de un contenedor en ejecución =

Vamos a ver otresta vez como ejecutar un comando en un contenedor que ya está
ejecutándose:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a ejecutar un comando en ese contenedor con el nombre ''mi-contenedor''.
El comando exec es similar al comando run, pero para ejecutar un comando dentro de un contenedor:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor ls
</syntaxhighlight>

Para redirigir la salida a un fichero en el anfitrión:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor ls > x.txt
</syntaxhighlight>

Para redirigir la salida a un fichero ''dentro'' del contenedor, hacemos:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor bash -c "ls > x.txt"
</syntaxhighlight>

= Paso 10: Persistencia en contenedores =

Al hacer ''exit'' y salir de un contenedor, se pierden todos los cambios que hemos realizado. Los

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-ejemplo debian bash
</syntaxhighlight>

Ahora, vamos a crear una carpeta en el contenedor y comprobar que esa carpeta existe:

<syntaxhighlight lang="bash">
podman exec mi-ejemplo mkdir test
podman exec mi-ejemplo ls
</syntaxhighlight>

Veremos que la carpeta existe, pero, ¿qué ocurre si para el contenedor?

<syntaxhighlight lang="bash">
podman container stop mi-ejemplo
</syntaxhighlight>

Y volvemos a lanzarlo:

<syntaxhighlight lang="bash">
podman container rm mi-ejemplo
podman run -d -ti --name mi-ejemplo debian bash
podman exec mi-ejemplo ls
</syntaxhighlight>

Podemos comprobar que la carpeta creada anteriormente, no existe.

¿Qué podemos hacer para mantener la modificaciones realizadas sobre un contenedor?

== Paso 10.1: Crear una imagen derivada de la imagen base ==

Es posible crear una imagen derivada, con modificaciones, a partir de una imagen existente mediante la orden '''commit'''.

Por ejemplo, si queremos una imagen ''debian'' que incluya el programa ''ping'' ya instalado, tendríamos que lanzar un contenedor a partir de la imagen ''ubuntu'':

<syntaxhighlight lang="bash">
podman run -d -ti debian bash
</syntaxhighlight>

Suponiendo que el contenido está identificado con el ID 56ef5b312334

Instalamos el paquete ping:

<syntaxhighlight lang="bash">
podman exec 56ef5b312334 apt -y install ping
</syntaxhighlight>

Generamos la imagen derivada con el nombre ''ubuntu-con-ping'':

<syntaxhighlight lang="bash">
podman commit 56ef5b312334 ubuntu-con-ping
</syntaxhighlight>

Ya podemos para nuestro contendor:

<syntaxhighlight lang="bash">
podman stop 56ef5b312334
</syntaxhighlight>

Y lanzar un nuevo contenedor a partir de la imagen ''debian-con-ping'':

<syntaxhighlight lang="bash">
podman run -d -ti debian-con-ping bash
</syntaxhighlight>

== Paso 10.2: Mantener la persistencia mediante volúmen ==

Otra opción para mantener los datos es montar un volumen al ejecutar el contenedor.

Primero crearemos una carpeta que hará de volumen en nuestra máquina, que será la que luego montemos para podman:

<syntaxhighlight lang="bash">
mkdir /home/debian/volumen
</syntaxhighlight>

Ahora vamos a montar la carpeta al ejecutar el contenedor, lo hacemos con la
opción -v, la cual tiene 3 campos separados por ':':

# El volumen en nuestra máquina
# Donde se montará el volumen dentro del contenedor
# Opciones de mmontaje, por ejemplo rw (read and write) o ro (read only)

<syntaxhighlight lang="bash">
podman run --rm -ti -v /home/debian/volumen:/volumen:rw debian bash
mkdir /volumen/test
touch /volumen/test/file
exit
</syntaxhighlight>

Una vez nos salgamos del contenedor, podemos ver que en nuestra máquina están
los datos:

<syntaxhighlight lang="bash">
ls /home/ubuntu/volumen/
ls /home/ubuntu/volumen/test
</syntaxhighlight>

La próxima vez que ejecutemos un contenedor, si montamos ese volumen, los datos
estarán ahí, además esta forma tiene el beneficio de compartir datos entre
nuestra máquina y el contenedor de forma sencilla.

= Paso 11: Crear nuestra propia imagen de contenedor =

Para crear una imagen de un contenedor con una aplicación de Python hug, creamos en primer lugar la carpeta que contendrá los ficheros que nos permiten crear la imagen.

<syntaxhighlight lang="bash">
mkdir miapp
cd miapp
</syntaxhighlight>

Definimos un fichero ''Dockerfile'' para definir la imagen:

<syntaxhighlight lang="bash">
FROM ubuntu

RUN apt -y update
RUN apt -y upgrade
RUN apt -y install python3-hug
RUN mkdir /app
COPY endpoint.py /app
WORKDIR /app
CMD hug -f endpoint.py
</syntaxhighlight>

Alternativamente, puedes crear un [[Creando imagen propia usando Ubuntu de base|Dockerfile empleando la imagen de Ubuntu]] como base en lugar de Alpine.

Y añadimos el fichero ''endpoint.py'' que emplea el framework Python hug con el contenido siguiente:

<syntaxhighlight lang="bash">
import hug

@hug.get('/welcome')
def welcome(username="unknown"):
""" Say welcome to username """
return "Welcome " + username
</syntaxhighlight>

Este fichero es un ejemplo de uso de Python hug. Si hacemos una petición a /welcome?username="LSO", esto nos devolverá el mensaje "Welcome LSO".

Una vez tengamos los dos ficheros creados en nuestra máquina virtual, podemos construir nuestra imagen:

<syntaxhighlight lang="bash">
podman build -t app:v1 -f Dockerfile .
</syntaxhighlight>

Vamos a explicar para que sirve cada línea:

* FROM: servirá para basarnos en una imagen existente, en este caso, una imagen de python alpine, que contiene python y no ocupa mucho espacio
* ENV: para crear variables de entorno
* RUN: para ejecutar comandos, ya sea para crear una carpeta, instalar dependencias o cualquier otra opción que necesitemos
* COPY: para copiar datos desde nuestra máquina a la imagen
* WORKDIR: para cambiar el directorio de trabajo
* CMD: este comando será ejecutado por defecto al iniciar un contenedor a partir de esta imagen

Esto construirá una imagen podman basada en python:alpine, en la cual hemos
guardado nuestra pequeña aplicación y se va a ejecutar cuando ejecutemos un
contenedor basado en esa imagen. Para comprobar que la imagen se ha creado
correctamente, listamos las imagenes, y debería de aparecernos una imagen con
nombre 'app' y tag 'v1':

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen, y vamos a añadir una nueva
opción, -p 8001:8000. Esta opción hará que el puerto interno 8000 del contenedor
sea expuesto en el puerto 8001 de nuestra máquina:

<syntaxhighlight lang="bash">
podman run --name my-app --rm -d -p 8001:8000 app:v1
</syntaxhighlight>

''Nota:'' podman supone que la redirección de puerto es TCP, para una redirección de puertos UDP, puedes usar:

<syntaxhighlight lang="bash">
... -p 8001:8000/udp
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código. En nuestra
máquina haremos:

<syntaxhighlight lang="bash">
curl -X GET http://localhost:8001/welcome?username=LSO
</syntaxhighlight>

Comprobaremos que la salida del comando curl, es "Welcome LSO".

Antes de terminar, vamos a comprobar otro pequeño detalle que añadimos en
nuestra imagen, la variable de entorno USERNAME, vamos a comprobar que funciona:

<syntaxhighlight lang="bash">
podman exec -ti my-app ash
echo $USERNAME
</syntaxhighlight>

Funciona correctamente, pero al ejecutar el contenedor, podemos cambiar esta
variable de entorno como vimos en uno de los pasos anteriores:

<syntaxhighlight lang="bash">
podman run --rm -ti -e USERNAME=me app:v1 ash
echo $USERNAME
</syntaxhighlight>

Esto nos servirá para tener opciones por defecto y que el usuario pueda
cambiarlo a su antojo, como por ejemplo contraseñas u otros detalles.

= Paso 12: Eliminar imágenes =

Para borrar una imagen, puede hacer:

<syntaxhighlight lang="bash">
podman image rm hello-world
</syntaxhighlight>

= Paso 13: Varios podman a la vez (podman-compose) =

Antes de comenzar, vamos a parar todos los contenedores que tengamos abiertos,
para dejar el entorno de podman limpio, que nos vendrá bien para esta parte.

Cuando queremos ejecutar varios contenedores a la vez y que estén conectados
entre ellos fácilmente, utilizaremos podman-compose, donde con un fichero de
configuración simple en yaml, tendremos toda la configuración de lo que vamos a
ejecutar.

Primero vamos a instalar podman-compose:

<syntaxhighlight lang="bash">
sudo apt install podman-compose
</syntaxhighlight>

Ahora veamos un pequeño ejemplo donde explicaremos todos los detalles para crear
un podman-compose, en este caso, el nombre por defecto de los ficheros suele ser
podman-compose.yml, y el contenido será similar a:

<syntaxhighlight lang="bash">
version: '3'

services:
web:
container_name: web
restart: always
build:
context: .
ports:
- "8000:8000"
volumes:
- /home/ubuntu/volume:/volumen:rw
environment:
USERNAME: test
web2:
container_name: web2
build:
dockerfile: Dockerfile
context: .
depends_on:
- web
command: touch web2
web3:
container_name: web3
restart: on-failure
image: pstauffer/curl
depends_on:
- web
command: curl -X GET web:8000/welcome?username=web3
</syntaxhighlight>

En el podman-compose definimos diferentes servicios a ejecutar, en nuestro caso
hemos iniciado tres servicios diferentes, web, web2 y web3:

El primer servicio, web:

* container_name: para darle un nombre por defecto al contenedor cuando se cree
* restart: pueden ser:
** "no": si la máquina termina, no se vuelve a iniciar (opción por defecto)
** always: siempre que el contenedor termine, intenta iniciarse de nuevo
** on-failure: solo intenta reiniciarse si el contenedor termina con fallo
** unless-stopped: solo reinicia el contenedor si el usuario es el que lo termina
* Utilizará el fichero Dockerfile creado en el paso 11 para generar la imagen a usar.
* Expondrá el puerto 8000 del contenedor en el 8000 de nuestra máquina
* Montará un volumen, se hace de forma similar a la línea de comandos
* Creará una variable de entorno

El segundo servicio, web2:

* Utilizará el fichero Dockerfile también, la diferencia entre este y el primer servicio, es que si el nombre del Dockerfile cambia, tendremos que hacerlo de esta segunda forma, la primera por defecto solo buscará el fichero Dockerfile
* depends_on hará que para ejecutar este servicio, su dependencia tenga ya que estar iniciada
* Ejecutaremos un comando el cual sustituirá al comando de la imagen

El tercer servicio, web3:

* Utilizará la imagen ostauffer/curl que es un imagen mínima que contiene el comando curl
* restart: en este caso, hasta que el comando no se ejecute correctamente, se seguirá reiniciando el contenedor
* depends_on igual que el servicio 2, dependerá del servicio 1
* Ejecutaremos un comando para llamar desde el servicio 3 al servicio 1

== Paso 13.1: Construir podman-compose ==

En el caso de existir servicios que tengan Dockerfiles, esto hará que se construyan previamente, como hacer un podman build de cada uno de los servicios que contenga un Dockerfile:

<syntaxhighlight lang="bash">
podman-compose build
</syntaxhighlight>

Con esto se generarán las imágenes necesarias para ejecutar todos los servicios.

== Paso 13.2: Iniciar podman-compose ==

Para iniciar todos los servicios, ejecutaremos:

<syntaxhighlight lang="bash">
podman-compose up -d
</syntaxhighlight>

Después de esto podremos ver el logs de todos los servicios:

<syntaxhighlight lang="bash">
podman-compose logs -f
</syntaxhighlight>

Aquí veremos que el servicio 3 ha conseguido llamar correctamente al servicio 1.

Ahora veremos como podman-compose ha creado los contenedores:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

La salida será similar a la siguiente:

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
219a4118244c pstauffer/curl "curl -X GET web:800…" 6 seconds ago Exited (0) 3 seconds ago web3
c97e894cb3ae ubuntu_web2 "touch web2" 6 seconds ago Exited (0) 4 seconds ago web2
f35d034204fc ubuntu_web "/bin/sh -c 'hug -f …" 6 seconds ago Up 5 seconds 0.0.0.0:8000->8000/tcp web
</syntaxhighlight>

Aquí vemos varios detalles:

* El nombre que le hemos dado en el podman-compose ha funcionado correctamente
* Vemos que los comandos son los correctos también
* web2 está parado por que la política de reinicio es apagar cuando se termine de ejecutar un comando
* web 3 está parado por que el comando ha terminado con un salida correcta

Vamos a comprobar ahora que en el servicio web está todo correcto:

<syntaxhighlight lang="bash">
podman exec -ti web ash
echo $USERNAME
ls /volumen
exit
</syntaxhighlight>

Podemos comprobar que tanto cambiar la variable de entorno como crear un
volumen ha funcionado correctamente.

== Paso 13.3: Parar podman-compose ==

Para parar todos los servicios:

<syntaxhighlight lang="bash">
podman-compose down
</syntaxhighlight>

Comprobamos:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Vemos que han desaparecido todos los contenedores.

= Paso 14: Ejercicios =

== Ejercicio 1: Variante de httpd ==

Construya una imagen ''httpd-hola-mundo'' a partir de la imagen ''httpd''. El fichero de index.html de la carpeta htdocs/ tiene que mostrar el mensaje "hola mundo".

<syntaxhighlight lang="bash">
podman pull httpd
</syntaxhighlight>

Edita el fichero Dockerfile:

<syntaxhighlight lang="bash">
nano Dockerfile
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
FROM httpd

COPY index.html htdocs/index.html
</syntaxhighlight>

Edita el fichero index.html:

<syntaxhighlight lang="bash">
nano index.html
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

Construye la imagen:

<syntaxhighlight lang="bash">
podman build -t mihttpd -f Dockerfile .
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen:

<syntaxhighlight lang="bash">
podman run --name mihttpd -d -p 8080:80 mihttpd
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código:
<syntaxhighlight lang="bash">
curl -X GET http://localhost:8080
</syntaxhighlight>

Tiene que salir por pantalla esto:
<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

== Ejercicio 2: aplicación flask ==

Flask es un framework python para implementar webs. Cree una imagen "miapp-flask" a partir de la imagen de "python":

* Instale flask mediante: pip install flask
* Cree la carpeta "app"
* Establezca la variable FLASK_APP a "hello.py"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"

El fichero hello.py contiene un "hola mundo" para Flask:

<syntaxhighlight lang="python">
from flask import Flask
app = Flask(__name__)

@app.route("/")
def hello():
return "Hello World!"

if __name__ == "__main__":
app.run()
</syntaxhighlight>

Solución con alpine:

<syntaxhighlight lang="bash">
FROM python:alpine

RUN mkdir /app
RUN pip install flask
ENV FLASK_APP="app/hello.py"
COPY hello.py
WORKDIR /
CMD flask run --host=0.0.0.0
</syntaxhighlight>

Solución con Ubuntu:

<syntaxhighlight lang="bash">
FROM ubuntu:bionic

RUN apt-get update
RUN apt-get -y install python python-pip wget
RUN pip install Flask
ENV FLASK_APP="app/hello.py"
RUN mkdir /app
COPY hello.py /app
CMD flask run --host=0.0.0.0
</syntaxhighlight>

== Ejercicio 3: mysql ==

'''EN LA MÁQUINA VIRTUAL:'''

mkdir miapp

cd miapp

podman pull mysql

nano Dockerfile

<syntaxhighlight lang="bash">
FROM mysql
ENV MYSQL_ROOT_PASSWORD="lacontraseñaqueyoquiera"
RUN mkdir /app
WORKDIR /app

</syntaxhighlight>

CTRL+O , ENTER Y CTRL+X (para guardar Dockerfile y salir)

podman build -ti mrfdocker -f Dockerfile .
podman run --name mymrf --rm -p 8001:3306 mrfdocker
docker images

'''EN LA TERMINAL DEL HOST:'''

''Instalación de mysql:''

apt install mysql-client-core-5.7
apt-get install mysql-server
service mysql start

''Para entrar:''

mysql -u root -p -P 8001

Una vez dentro de msql:

mysql> show databases;

''Para salir:''

exit

== Ejercicio 5: python pyramid ==

Pyramid es un framework python para implementar webs. Cree una imagen "miapp-pyramid":

* Emplee la imagen de Ubuntu como referencia, instale los paquetes python y python-pip.
* Instale Pyramid mediante: pip install pyramid
* Cree la carpeta "app"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"
* La aplicación se lanza con la orden: python hello.py
* Compruebe que funciona con curl, la ruta a la web es http://127.0.0.1:8000/hello, suponiendo que ha empleado el puerto 8000 para exponer el servicio.

El fichero hello.py contiene un "hola mundo" para Pyramid:

<syntaxhighlight lang="bash">
from wsgiref.simple_server import make_server
from pyramid.config import Configurator
from pyramid.response import Response

def hello_world(request):
print('Request inbound!')
return Response('Podman works with Pyramid!')

if __name__ == '__main__':
config = Configurator()
config.add_route('hello', '/')
config.add_view(hello_world, route_name='hello')
app = config.make_wsgi_app()
server = make_server('0.0.0.0', 6543, app)
server.serve_forever()
</syntaxhighlight>

Este programa recibe peticiones en el puerto 6543.

== Ejercicio 6 ==

Cree una imagen derivada de Ubuntu, instale el paquete apache2, php y libapache2-mod-php.
Active el módulo de php para apache2 mediante la orden:

<syntaxhighlight lang="bash">
a2enmod php
</syntaxhighlight>

Cree la carpeta /var/www/php.

Cree el fichero index.php

<syntaxhighlight lang="php">
<?php
Print "Hello, World!";
?>
</syntaxhighlight>

y copielo a /var/www/php/.

Cree el fichero 000-default.conf y copielo a /etc/apache2/sites-enabled/

Dicho fichero contiene.

<syntaxhighlight lang="bash">
<VirtualHost *:80>
DocumentRoot /var/www/php

<Directory /var/www/php/>
Options Indexes FollowSymLinks MultiViews
AllowOverride All
Order deny,allow
Allow from all
</Directory>

ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>
</syntaxhighlight>

Tiene que lanzar apache con la orden: apachectl -D FOREGROUND

Tras crear la imagen, láncela mapeando el puerto 8888 al 80, pruebe que puede acceder a http://127.0.0.1:8888/php/ mediante curl

Solución:

<syntaxhighlight lang="bash">
FROM ubuntu:latest

RUN apt-get update
RUN apt-get install -y tzdata
RUN apt-get install -y apache2
RUN apt-get install -y php
RUN apt-get install -y libapache2-mod-php
RUN a2enmod php7.2
COPY index.php /var/www/php
COPY 000-default.conf /etc/apache2/sites-enabled/
CMD apachectl -D FOREGROUND
</syntaxhighlight>

Y para lanzarlo:

podman run --name my-app --rm -d -p 8001:8000 app:v1

y para probarlo:

curl -X GET http://127.0.0.1:8888/php/

== Ejercicio 7 ==

Instale el paquete ''netcat-traditional'' en una imagen de contenedor de ''ubuntu''. Lance la orden:

nc -u -l -p 8080

en el contenedor. Asegúrese de crear una redirección de puertos de 9999 desde el ''host'' al puerto 8080 en el contenedor.

Desde fuera del contenedor, pruebe a conectarse con:

nc -u 127.0.0.1 9999

== Ejercicio 8 ==

Cree una imagen derivada de "ubuntu" con un Dockerfile que incluya soporte de python y lance el siguiente código en Python:

<syntax lang="python">
from http.server import BaseHTTPRequestHandler, HTTPServer
import time

hostName = "0.0.0.0"
serverPort = 8080

class MyServer(BaseHTTPRequestHandler):
def do_GET(self):
self.send_response(200)
self.send_header("Content-type", "text/html")
self.end_headers()
self.wfile.write(bytes("<html><head><title>Welcome!</title></head>", "utf-8"))
self.wfile.write(bytes("<body>", "utf-8"))
self.wfile.write(bytes("This is an example web server.", "utf-8"))
self.wfile.write(bytes("</body></html>", "utf-8"))

if __name__ == "__main__":
webServer = HTTPServer((hostName, serverPort), MyServer)
print("Server started http://%s:%s" % (hostName, serverPort))

try:
webServer.serve_forever()
except KeyboardInterrupt:
pass

webServer.server_close()
print("Server stopped.")
</syntax>

Llame a su imagen "python-http-server". Lance una instancia de la imagen "python-http-server" mapeando el puerto 9999 al puerto 8888/tcp del contenedor. Compruebe con:

<syntax lang="bash">
curl http://127.0.0.1:9999/
</syntax>

que muestre la página HTML que ofrece el servidor, que debería ser:

<syntax lang="bash">
<html><head><title>Welcome!</title></head><body>This is an example web server.</body></html>
</syntax>

Contenedores

2025-12-09T15:48:17Z

Pneira: /* Ejercicio 1: Variante de httpd */

En esta práctica aprenderemos a utilizar [https://es.wikipedia.org/wiki/Podman podman] para desplegar contenedores.

= Paso 1: Instalar podman =

Para instalar el paquete oficial:

<syntaxhighlight lang="bash">
apt install podman
</syntaxhighlight>

podman es un clon de '''docker''.

= Paso 2: Repositorio de imágenes de contenedores DockerHub =

Docker ofrece un servicio de nube denominado ''DockerHub'' que puede ser empleado como red social para compartir tus imágenes de Podman. En ''DockerHub'' existen además imágenes de contenedores preconfiguradas de software, muchas de ellas oficiales (ofrecidas por el propio fabricante del software) que se podrán emplear como base para construir nuevas imágenes adaptadas a nuestras necesidades.

Podremos realizar búsquedas en este repositorio ''DockerHub'' puedes emplear el siguiente comando:

<syntaxhighlight lang="bash">
podman search docker.io/library/hello-world
</syntaxhighlight>

Para descargarnos la imagen de ''hello-world'' podemos usar la orden ''pull'':

<syntaxhighlight lang="bash">
podman pull docker.io/library/hello-world
</syntaxhighlight>

También podemos publicar imágenes propias, esto require '''registro de usuario''' en la nube de ''DockerHub'', lo que '''no''' es obligatorio para la realización de esta práctica. Para subir una imagen, hay que validarse como usuario en la nube de ''DockerHub'':

<syntaxhighlight lang="bash">
podman login
</syntaxhighlight>

Tras introducir tu usuario y contraseña, puedes comenzar a publicar tus propias imágenes.

<syntaxhighlight lang="bash">
podman push MI_IMAGEN
</syntaxhighlight>

Este paso es '''opcional''', sólo en caso de que se quieran subir imágenes de contenedores a la nube de docker.io.

= Paso 4: Comprobar imágenes en nuestra máquina =

Para ver las imágenes que tenemos en nuestra máquina, utilizaremos el comando:

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Inicialmente, no tenemos imágenes en almacenamiento, podemos descargarnos la imagen oficial de Debian 13 (Trixie):

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian
</syntaxhighlight>

Ahora si, ya debería de aparecernos la imagen ''debian''.

Comentar también que cada imagen puede tener varias etiquetas, por ejemplo, la imagen Debian 12 (Bookworm), cuando la hemos visto en el listado de imágenes, venía con el tag latest, que es el tag que se descarga por defecto, pero nosotros podemos especificar otro, por ejemplo:

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian:bookworm
</syntaxhighlight>

Para traernos la versión de la imagen de Debian 12 ''Bookworm''.

Ahora tendremos dos imágenes con diferente etiqueta, que serían como las diferentes versiones de cada imagen.

= Paso 5: Lanzar un contenedor =

Un contenedor no es más que una imagen de podman ejecutándose, sería similar a
una máquina virtual, aunque mucho más liviano.

Para crear un contenedor, utilizaremos una imagen, en este caso, la imagen
hello-world. Hacemos lo siguiente:

<syntaxhighlight lang="bash">
podman run hello-world
</syntaxhighlight>

Esto nos mostrará el siguiente mensaje si todo está correcto:

<syntaxhighlight lang="bash">
Hello from Docker!
This message shows that your installation appears to be working correctly.

To generate this message, Docker took the following steps:
1. The Docker client contacted the Docker daemon.
2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
(amd64)
3. The Docker daemon created a new container from that image which runs the
executable that produces the output you are currently reading.
4. The Docker daemon streamed that output to the Docker client, which sent it
to your terminal.

To try something more ambitious, you can run an Debian container with:
$ podman run -it debian bash

Share images, automate workflows, and more with a free Docker ID:
https://hub.docker.com/

For more examples and ideas, visit:
https://docs.docker.com/get-started/
</syntaxhighlight>

Al crear los contenedores utilizando el comando 'run', tenemos varias opciones:

* Lanzar una terminal en el contenedor en modo interactivo
* Lanzar en segundo plano y conectarnos posteriormente al contenedor

== Paso 5.1: Lanzar una terminal en el contenedor en modo interactivo (-ti) ==

Para este ejemplo vamos a utilizar otra imagen diferente, en este caso vamos a utilizar una imagen de debian.

Vamos a lanzar un contenedor y ejecutar una terminal en el que se va a ejecutar el programa '''bash''' que me ofrece un interprete de órdenes:

<syntaxhighlight lang="bash">
podman run -ti debian bash
</syntaxhighlight>

La opción ''-t'' indica que se crea un terminal en el contenedor. Y la opción ''-i'' indica que el contenedor se ejecuta en modo interactivo.

Al acceder al contenedor de ''debian'' nos aparece un ''hash'' en el prompt de la shell, que identifica a la instancia del contenedor (es valor es similar al que muestra la orden ''podman container ls'').

Para salir del contenedor, escribimos 'exit' o pulsamos ''CTRL + D''

== Paso 5.2 Lanzar en segundo plano (-d) ==

Otro ejemplo, con la imagen de Debian:

<syntaxhighlight lang="bash">
podman run -dti debian
</syntaxhighlight>

que muestra un hash que identifica de forma única el contenedor lanzado:

<syntaxhighlight lang="bash">
2ec1daae4676a4e84dc04fd91399c1dfe92119544ff12ee307991fe573d3db64
</syntaxhighlight>

Mediante el comando ''attach'' puedo entrar al contenedor:

<syntaxhighlight lang="bash">
podman attach 2ec1daae4676
</syntaxhighlight>

Para salir, pulsamos ''CTRL + P'' seguido de ''CTRL + Q''.

De manera similar, puedo lanzar en segundo plano la imagen de contenedor de ''hello-world'':

<syntaxhighlight lang="bash">
podman run -d hello-world
</syntaxhighlight>

Y consultar los logs:

<syntaxhighlight lang="bash">
podman logs b67fae3312bc321
</syntaxhighlight>

== Paso 5.3: Añadir variables de entorno a un contenedor ==

Utilizaremos la imagen anterior, y vamos a añadir una variable de entorno
llamada TEST que contenga el valor 'test'. A parte, también ejecutaremos la
terminal como antes, para comprobar con el comando echo, que la variable de
entorno está creada correctamente:

<syntaxhighlight lang="bash">
podman run -ti -e TEST=test debian bash
</syntaxhighlight>

Ahora, desde el contenedor podemos comprobar el valor de la variable de entorno ''$TEST''.

<syntaxhighlight lang="bash">
echo $TEST
test
</syntaxhighlight>

= Paso 6: Listar contenedores en ejecución =

Hemos estado haciendo pruebas y ejecutando contenedores en el paso anterior, vamos a ver donde se encuentran estos contenedores que hemos ejecutado, y después veremos algunas opciones más del comando run.

Tenemos dos opciones para ver los contenedores:

<syntaxhighlight lang="bash">
podman container ls -a
</syntaxhighlight>

o la versión corta:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Ambas hacen lo mismo, y debería de mostrarnos una salida similar a la siguiente:

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
e2bde5f5500c debian "bash" 6 minutes ago Exited (0) 2 seconds ago pensive_sammet
544ad27dbc3c debian "bash" 7 minutes ago Exited (0) 7 minutes ago serene_elgamal
</syntaxhighlight>

En la información veremos que el contenedor tiene el estado exited, eso quiere decir que no se está ejecutando y ya ha finalizado. Vamos a hacer una prueba para ver un contendor ejecutándose:

<syntaxhighlight lang="bash">
podman run -d debian sleep 30
</syntaxhighlight>

Con el comando sleep 30 esperamos 30 segundos hasta que termine el comando, asíque durante esos 30 segundos, el contenedor estará ejecutándose, veámoslo:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
eacceb27d52d debian "sleep 30" 12 seconds ago Up 11 seconds sharp_pasteur
</syntaxhighlight>

Vamos a ver alguna opciones más de la orden ''run''.

== Paso 6.1: Dar un nombre al contenedor (--name) ==

Por defecto, podman creará automáticamente un nombre como hemos visto en las salidas del comando ''podman ps -a''. Podemos establecer el nombre del contenedor que queramos con la opción ''--name'':

<syntaxhighlight lang="bash">
podman run -ti --name mi_debian debian
</syntaxhighlight>

== Paso 6.2: Eliminar contenedor cuando termine (--rm) ==

Vamos a mezclar todo lo visto anteriormente:

* Lanzar en segundo plano (-d)
* Ejecutar contenedor durante 30 segundos (sleep 30)
* Dar un nombre a la imagen (--name)
* Eliminar contenedor cuando termine (--rm)

<syntaxhighlight lang="bash">
podman run -d --rm --name bye-bye debian sleep 30
</syntaxhighlight>

Antes y una vez pasados los 30 segundos, podemos comprobar que el contenedor ha desaparecido.

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

= Paso 7: Parar y eliminar contenedores =

Los contenedores podemos pararlos o eliminarlos, veamos como hacerlo. Antes que
nada, borraremos todos los contenedores que estén terminados, para ello:

<syntaxhighlight lang="bash">
podman container prune
podman ps -a
</syntaxhighlight>

Ya lo hemos dejado todo limpio para seguir, ahora vamos a crear un contenedor,
utilizando un comando de linux que no termina, para que así se quede
ejecutándose el contenedor infinitamente:

<syntaxhighlight lang="bash">
podman run -d -ti --name my_container debian bash
podman ps -a
</syntaxhighlight>

Vamos a pararlo (podemos utilizar el nombre dado o el id):

<syntaxhighlight lang="bash">
podman stop my_container
podman stop e4901956f108
podman ps -a
</syntaxhighlight>

Veremos que ya ha terminado, y ahora vamos a eliminarlo, pero solo este
contenedor, no como previamente que eliminamos todos. Lo mismo que para pararlo,
podemos utilizar el nombre o el id.

<syntaxhighlight lang="bash">
podman container rm my_container
podman container rm my_container
podman ps -a
</syntaxhighlight>

Veremos que ya no tenemos el contenedor y está correctamente eliminado.

= Paso 8: Conectarnos a un contenedor que se está ejecutando en segundo plano =

Vamos a ejecutar de nuevo un contenedor que no termine:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a conectarnos a este contenedor que está ejecutándose en segundo
plano:

<syntaxhighlight lang="bash">
podman attach mi-contenedor
</syntaxhighlight>

Veremos la orden bash ejecutándose, para terminar, hacemos un 'CTRL + C', y ahora, veremos que ha pasado con el contenedor:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Lo veremos parado, por que lo que hemos hecho ha sido conectarnos al contenedor
y parar el comando que se estaba ejecutando, así que ahora tenemos el contenedor
finalizado.

''Nota:'' Para salir del contenedor '''sin detenerlo''' hacemos 'CTRL + P' seguido 'CTRL + Q'

= Paso 9: Ejecutar un comando dentro de un contenedor en ejecución =

Vamos a ver otresta vez como ejecutar un comando en un contenedor que ya está
ejecutándose:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a ejecutar un comando en ese contenedor con el nombre ''mi-contenedor''.
El comando exec es similar al comando run, pero para ejecutar un comando dentro de un contenedor:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor ls
</syntaxhighlight>

Para redirigir la salida a un fichero en el anfitrión:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor ls > x.txt
</syntaxhighlight>

Para redirigir la salida a un fichero ''dentro'' del contenedor, hacemos:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor bash -c "ls > x.txt"
</syntaxhighlight>

= Paso 10: Persistencia en contenedores =

Al hacer ''exit'' y salir de un contenedor, se pierden todos los cambios que hemos realizado. Los

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-ejemplo debian bash
</syntaxhighlight>

Ahora, vamos a crear una carpeta en el contenedor y comprobar que esa carpeta existe:

<syntaxhighlight lang="bash">
podman exec mi-ejemplo mkdir test
podman exec mi-ejemplo ls
</syntaxhighlight>

Veremos que la carpeta existe, pero, ¿qué ocurre si para el contenedor?

<syntaxhighlight lang="bash">
podman container stop mi-ejemplo
</syntaxhighlight>

Y volvemos a lanzarlo:

<syntaxhighlight lang="bash">
podman container rm mi-ejemplo
podman run -d -ti --name mi-ejemplo debian bash
podman exec mi-ejemplo ls
</syntaxhighlight>

Podemos comprobar que la carpeta creada anteriormente, no existe.

¿Qué podemos hacer para mantener la modificaciones realizadas sobre un contenedor?

== Paso 10.1: Crear una imagen derivada de la imagen base ==

Es posible crear una imagen derivada, con modificaciones, a partir de una imagen existente mediante la orden '''commit'''.

Por ejemplo, si queremos una imagen ''debian'' que incluya el programa ''ping'' ya instalado, tendríamos que lanzar un contenedor a partir de la imagen ''ubuntu'':

<syntaxhighlight lang="bash">
podman run -d -ti debian bash
</syntaxhighlight>

Suponiendo que el contenido está identificado con el ID 56ef5b312334

Instalamos el paquete ping:

<syntaxhighlight lang="bash">
podman exec 56ef5b312334 apt -y install ping
</syntaxhighlight>

Generamos la imagen derivada con el nombre ''ubuntu-con-ping'':

<syntaxhighlight lang="bash">
podman commit 56ef5b312334 ubuntu-con-ping
</syntaxhighlight>

Ya podemos para nuestro contendor:

<syntaxhighlight lang="bash">
podman stop 56ef5b312334
</syntaxhighlight>

Y lanzar un nuevo contenedor a partir de la imagen ''debian-con-ping'':

<syntaxhighlight lang="bash">
podman run -d -ti debian-con-ping bash
</syntaxhighlight>

== Paso 10.2: Mantener la persistencia mediante volúmen ==

Otra opción para mantener los datos es montar un volumen al ejecutar el contenedor.

Primero crearemos una carpeta que hará de volumen en nuestra máquina, que será la que luego montemos para podman:

<syntaxhighlight lang="bash">
mkdir /home/debian/volumen
</syntaxhighlight>

Ahora vamos a montar la carpeta al ejecutar el contenedor, lo hacemos con la
opción -v, la cual tiene 3 campos separados por ':':

# El volumen en nuestra máquina
# Donde se montará el volumen dentro del contenedor
# Opciones de mmontaje, por ejemplo rw (read and write) o ro (read only)

<syntaxhighlight lang="bash">
podman run --rm -ti -v /home/debian/volumen:/volumen:rw debian bash
mkdir /volumen/test
touch /volumen/test/file
exit
</syntaxhighlight>

Una vez nos salgamos del contenedor, podemos ver que en nuestra máquina están
los datos:

<syntaxhighlight lang="bash">
ls /home/ubuntu/volumen/
ls /home/ubuntu/volumen/test
</syntaxhighlight>

La próxima vez que ejecutemos un contenedor, si montamos ese volumen, los datos
estarán ahí, además esta forma tiene el beneficio de compartir datos entre
nuestra máquina y el contenedor de forma sencilla.

= Paso 11: Crear nuestra propia imagen de contenedor =

Para crear una imagen de un contenedor con una aplicación de Python hug, creamos en primer lugar la carpeta que contendrá los ficheros que nos permiten crear la imagen.

<syntaxhighlight lang="bash">
mkdir miapp
cd miapp
</syntaxhighlight>

Definimos un fichero ''Dockerfile'' para definir la imagen:

<syntaxhighlight lang="bash">
FROM ubuntu

RUN apt -y update
RUN apt -y upgrade
RUN apt -y install python3-hug
RUN mkdir /app
COPY endpoint.py /app
WORKDIR /app
CMD hug -f endpoint.py
</syntaxhighlight>

Alternativamente, puedes crear un [[Creando imagen propia usando Ubuntu de base|Dockerfile empleando la imagen de Ubuntu]] como base en lugar de Alpine.

Y añadimos el fichero ''endpoint.py'' que emplea el framework Python hug con el contenido siguiente:

<syntaxhighlight lang="bash">
import hug

@hug.get('/welcome')
def welcome(username="unknown"):
""" Say welcome to username """
return "Welcome " + username
</syntaxhighlight>

Este fichero es un ejemplo de uso de Python hug. Si hacemos una petición a /welcome?username="LSO", esto nos devolverá el mensaje "Welcome LSO".

Una vez tengamos los dos ficheros creados en nuestra máquina virtual, podemos construir nuestra imagen:

<syntaxhighlight lang="bash">
podman build -t app:v1 -f Dockerfile .
</syntaxhighlight>

Vamos a explicar para que sirve cada línea:

* FROM: servirá para basarnos en una imagen existente, en este caso, una imagen de python alpine, que contiene python y no ocupa mucho espacio
* ENV: para crear variables de entorno
* RUN: para ejecutar comandos, ya sea para crear una carpeta, instalar dependencias o cualquier otra opción que necesitemos
* COPY: para copiar datos desde nuestra máquina a la imagen
* WORKDIR: para cambiar el directorio de trabajo
* CMD: este comando será ejecutado por defecto al iniciar un contenedor a partir de esta imagen

Esto construirá una imagen podman basada en python:alpine, en la cual hemos
guardado nuestra pequeña aplicación y se va a ejecutar cuando ejecutemos un
contenedor basado en esa imagen. Para comprobar que la imagen se ha creado
correctamente, listamos las imagenes, y debería de aparecernos una imagen con
nombre 'app' y tag 'v1':

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen, y vamos a añadir una nueva
opción, -p 8001:8000. Esta opción hará que el puerto interno 8000 del contenedor
sea expuesto en el puerto 8001 de nuestra máquina:

<syntaxhighlight lang="bash">
podman run --name my-app --rm -d -p 8001:8000 app:v1
</syntaxhighlight>

''Nota:'' podman supone que la redirección de puerto es TCP, para una redirección de puertos UDP, puedes usar:

<syntaxhighlight lang="bash">
... -p 8001:8000/udp
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código. En nuestra
máquina haremos:

<syntaxhighlight lang="bash">
curl -X GET http://localhost:8001/welcome?username=LSO
</syntaxhighlight>

Comprobaremos que la salida del comando curl, es "Welcome LSO".

Antes de terminar, vamos a comprobar otro pequeño detalle que añadimos en
nuestra imagen, la variable de entorno USERNAME, vamos a comprobar que funciona:

<syntaxhighlight lang="bash">
podman exec -ti my-app ash
echo $USERNAME
</syntaxhighlight>

Funciona correctamente, pero al ejecutar el contenedor, podemos cambiar esta
variable de entorno como vimos en uno de los pasos anteriores:

<syntaxhighlight lang="bash">
podman run --rm -ti -e USERNAME=me app:v1 ash
echo $USERNAME
</syntaxhighlight>

Esto nos servirá para tener opciones por defecto y que el usuario pueda
cambiarlo a su antojo, como por ejemplo contraseñas u otros detalles.

= Paso 12: Eliminar imágenes =

Para borrar una imagen, puede hacer:

<syntaxhighlight lang="bash">
podman image rm hello-world
</syntaxhighlight>

= Paso 13: Varios podman a la vez (podman-compose) =

Antes de comenzar, vamos a parar todos los contenedores que tengamos abiertos,
para dejar el entorno de podman limpio, que nos vendrá bien para esta parte.

Cuando queremos ejecutar varios contenedores a la vez y que estén conectados
entre ellos fácilmente, utilizaremos podman-compose, donde con un fichero de
configuración simple en yaml, tendremos toda la configuración de lo que vamos a
ejecutar.

Primero vamos a instalar podman-compose:

<syntaxhighlight lang="bash">
sudo apt install podman-compose
</syntaxhighlight>

Ahora veamos un pequeño ejemplo donde explicaremos todos los detalles para crear
un podman-compose, en este caso, el nombre por defecto de los ficheros suele ser
podman-compose.yml, y el contenido será similar a:

<syntaxhighlight lang="bash">
version: '3'

services:
web:
container_name: web
restart: always
build:
context: .
ports:
- "8000:8000"
volumes:
- /home/ubuntu/volume:/volumen:rw
environment:
USERNAME: test
web2:
container_name: web2
build:
dockerfile: Dockerfile
context: .
depends_on:
- web
command: touch web2
web3:
container_name: web3
restart: on-failure
image: pstauffer/curl
depends_on:
- web
command: curl -X GET web:8000/welcome?username=web3
</syntaxhighlight>

En el podman-compose definimos diferentes servicios a ejecutar, en nuestro caso
hemos iniciado tres servicios diferentes, web, web2 y web3:

El primer servicio, web:

* container_name: para darle un nombre por defecto al contenedor cuando se cree
* restart: pueden ser:
** "no": si la máquina termina, no se vuelve a iniciar (opción por defecto)
** always: siempre que el contenedor termine, intenta iniciarse de nuevo
** on-failure: solo intenta reiniciarse si el contenedor termina con fallo
** unless-stopped: solo reinicia el contenedor si el usuario es el que lo termina
* Utilizará el fichero Dockerfile creado en el paso 11 para generar la imagen a usar.
* Expondrá el puerto 8000 del contenedor en el 8000 de nuestra máquina
* Montará un volumen, se hace de forma similar a la línea de comandos
* Creará una variable de entorno

El segundo servicio, web2:

* Utilizará el fichero Dockerfile también, la diferencia entre este y el primer servicio, es que si el nombre del Dockerfile cambia, tendremos que hacerlo de esta segunda forma, la primera por defecto solo buscará el fichero Dockerfile
* depends_on hará que para ejecutar este servicio, su dependencia tenga ya que estar iniciada
* Ejecutaremos un comando el cual sustituirá al comando de la imagen

El tercer servicio, web3:

* Utilizará la imagen ostauffer/curl que es un imagen mínima que contiene el comando curl
* restart: en este caso, hasta que el comando no se ejecute correctamente, se seguirá reiniciando el contenedor
* depends_on igual que el servicio 2, dependerá del servicio 1
* Ejecutaremos un comando para llamar desde el servicio 3 al servicio 1

== Paso 13.1: Construir podman-compose ==

En el caso de existir servicios que tengan Dockerfiles, esto hará que se construyan previamente, como hacer un podman build de cada uno de los servicios que contenga un Dockerfile:

<syntaxhighlight lang="bash">
podman-compose build
</syntaxhighlight>

Con esto se generarán las imágenes necesarias para ejecutar todos los servicios.

== Paso 13.2: Iniciar podman-compose ==

Para iniciar todos los servicios, ejecutaremos:

<syntaxhighlight lang="bash">
podman-compose up -d
</syntaxhighlight>

Después de esto podremos ver el logs de todos los servicios:

<syntaxhighlight lang="bash">
podman-compose logs -f
</syntaxhighlight>

Aquí veremos que el servicio 3 ha conseguido llamar correctamente al servicio 1.

Ahora veremos como podman-compose ha creado los contenedores:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

La salida será similar a la siguiente:

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
219a4118244c pstauffer/curl "curl -X GET web:800…" 6 seconds ago Exited (0) 3 seconds ago web3
c97e894cb3ae ubuntu_web2 "touch web2" 6 seconds ago Exited (0) 4 seconds ago web2
f35d034204fc ubuntu_web "/bin/sh -c 'hug -f …" 6 seconds ago Up 5 seconds 0.0.0.0:8000->8000/tcp web
</syntaxhighlight>

Aquí vemos varios detalles:

* El nombre que le hemos dado en el podman-compose ha funcionado correctamente
* Vemos que los comandos son los correctos también
* web2 está parado por que la política de reinicio es apagar cuando se termine de ejecutar un comando
* web 3 está parado por que el comando ha terminado con un salida correcta

Vamos a comprobar ahora que en el servicio web está todo correcto:

<syntaxhighlight lang="bash">
podman exec -ti web ash
echo $USERNAME
ls /volumen
exit
</syntaxhighlight>

Podemos comprobar que tanto cambiar la variable de entorno como crear un
volumen ha funcionado correctamente.

== Paso 13.3: Parar podman-compose ==

Para parar todos los servicios:

<syntaxhighlight lang="bash">
podman-compose down
</syntaxhighlight>

Comprobamos:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Vemos que han desaparecido todos los contenedores.

= Paso 14: Ejercicios =

== Ejercicio 1: Variante de httpd ==

Construya una imagen ''httpd-hola-mundo'' a partir de la imagen ''httpd''. El fichero de index.html de la carpeta htdocs/ tiene que mostrar el mensaje "hola mundo".

<syntaxhighlight lang="bash">
podman pull httpd
</syntaxhighlight>

Edita el fichero Dockerfile:

<syntaxhighlight lang="bash">
nano Dockerfile
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
FROM httpd

COPY index.html htdocs/index.html
</syntaxhighlight>

Edita el fichero index.html:

<syntaxhighlight lang="bash">
nano index.html
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

Construye la imagen:

<syntaxhighlight lang="bash">
podman build -t mihttpd -f Dockerfile .
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen:

<syntaxhighlight lang="bash">
podman run --name mihttpd -d -p 8080:80 mihttpd
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código:
<syntaxhighlight lang="bash">
curl -X GET http://localhost:8080
</syntaxhighlight>

Tiene que salir por pantalla esto:
<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

== Ejercicio 2: aplicación flask ==

Flask es un framework python para implementar webs. Cree una imagen "miapp-flask" a partir de la imagen de "python":

* Instale flask mediante: pip install flask
* Cree la carpeta "app"
* Establezca la variable FLASK_APP a "hello.py"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"

El fichero hello.py contiene un "hola mundo" para Flask:

<syntaxhighlight lang="python">
from flask import Flask
app = Flask(__name__)

@app.route("/")
def hello():
return "Hello World!"

if __name__ == "__main__":
app.run()
</syntaxhighlight>

Solución con alpine:

<syntaxhighlight lang="bash">
FROM python:alpine

RUN mkdir /app
RUN pip install flask
ENV FLASK_APP="app/hello.py"
COPY hello.py
WORKDIR /
CMD flask run --host=0.0.0.0
</syntaxhighlight>

Solución con Ubuntu:

<syntaxhighlight lang="bash">
FROM ubuntu:bionic

RUN apt-get update
RUN apt-get -y install python python-pip wget
RUN pip install Flask
ENV FLASK_APP="app/hello.py"
RUN mkdir /app
COPY hello.py /app
CMD flask run --host=0.0.0.0
</syntaxhighlight>

== Ejercicio 3: mysql ==

'''EN LA MÁQUINA VIRTUAL:'''

mkdir miapp

cd miapp

sudo docker pull mysql

nano Dockerfile

<syntaxhighlight lang="bash">
FROM mysql
ENV MYSQL_ROOT_PASSWORD="lacontraseñaqueyoquiera"
RUN mkdir /app
WORKDIR /app

</syntaxhighlight>

CTRL+O , ENTER Y CTRL+X (para guardar Dockerfile y salir)

sudo docker build -ti mrfdocker -f Dockerfile .

sudo docker run --name mymrf --rm -p 8001:3306 mrfdocker

sudo docker images

'''EN LA TERMINAL DEL HOST:'''

''Instalación de mysql:''

sudo apt install mysql-client-core-5.7

> sudo apt-get install mysql-server

> sudo service mysql start

''Para entrar:''

sudo mysql -u root -p -P 8001

Una vez dentro de msql:

mysql> show databases;
''
Para salir:''

exit

== Ejercicio 5: python pyramid ==

Pyramid es un framework python para implementar webs. Cree una imagen "miapp-pyramid":

* Emplee la imagen de Ubuntu como referencia, instale los paquetes python y python-pip.
* Instale Pyramid mediante: pip install pyramid
* Cree la carpeta "app"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"
* La aplicación se lanza con la orden: python hello.py
* Compruebe que funciona con curl, la ruta a la web es http://127.0.0.1:8000/hello, suponiendo que ha empleado el puerto 8000 para exponer el servicio.

El fichero hello.py contiene un "hola mundo" para Pyramid:

<syntaxhighlight lang="bash">
from wsgiref.simple_server import make_server
from pyramid.config import Configurator
from pyramid.response import Response

def hello_world(request):
print('Request inbound!')
return Response('Docker works with Pyramid!')

if __name__ == '__main__':
config = Configurator()
config.add_route('hello', '/')
config.add_view(hello_world, route_name='hello')
app = config.make_wsgi_app()
server = make_server('0.0.0.0', 6543, app)
server.serve_forever()
</syntaxhighlight>

Este programa recibe peticiones en el puerto 6543.

== Ejercicio 6 ==

Cree una imagen derivada de Ubuntu, instale el paquete apache2, php y libapache2-mod-php.
Active el módulo de php para apache2 mediante la orden:

<syntaxhighlight lang="bash">
a2enmod php
</syntaxhighlight>

Cree la carpeta /var/www/php.

Cree el fichero index.php

<syntaxhighlight lang="php">
<?php
Print "Hello, World!";
?>
</syntaxhighlight>

y copielo a /var/www/php/.

Cree el fichero 000-default.conf y copielo a /etc/apache2/sites-enabled/

Dicho fichero contiene.

<syntaxhighlight lang="bash">
<VirtualHost *:80>
DocumentRoot /var/www/php

<Directory /var/www/php/>
Options Indexes FollowSymLinks MultiViews
AllowOverride All
Order deny,allow
Allow from all
</Directory>

ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>
</syntaxhighlight>

Tiene que lanzar apache con la orden: apachectl -D FOREGROUND

Tras crear la imagen, láncela mapeando el puerto 8888 al 80, pruebe que puede acceder a http://127.0.0.1:8888/php/ mediante curl

Solución:

<syntaxhighlight lang="bash">
FROM ubuntu:latest

RUN apt-get update
RUN apt-get install -y tzdata
RUN apt-get install -y apache2
RUN apt-get install -y php
RUN apt-get install -y libapache2-mod-php
RUN a2enmod php7.2
COPY index.php /var/www/php
COPY 000-default.conf /etc/apache2/sites-enabled/
CMD apachectl -D FOREGROUND
</syntaxhighlight>

Y para lanzarlo:

docker run --name my-app --rm -d -p 8001:8000 app:v1

y para probarlo:

curl -X GET http://127.0.0.1:8888/php/

== Ejercicio 7 ==

Instale el paquete ''netcat-traditional'' en una imagen de contenedor de ''ubuntu''. Lance la orden:

nc -u -l -p 8080

en el contenedor. Asegúrese de crear una redirección de puertos de 9999 desde el ''host'' al puerto 8080 en el contenedor.

Desde fuera del contenedor, pruebe a conectarse con:

nc -u 127.0.0.1 9999

== Ejercicio 8 ==

Cree una imagen derivada de "ubuntu" con un Dockerfile que incluya soporte de python y lance el siguiente código en Python:

<syntax lang="python">
from http.server import BaseHTTPRequestHandler, HTTPServer
import time

hostName = "0.0.0.0"
serverPort = 8080

class MyServer(BaseHTTPRequestHandler):
def do_GET(self):
self.send_response(200)
self.send_header("Content-type", "text/html")
self.end_headers()
self.wfile.write(bytes("<html><head><title>Welcome!</title></head>", "utf-8"))
self.wfile.write(bytes("<body>", "utf-8"))
self.wfile.write(bytes("This is an example web server.", "utf-8"))
self.wfile.write(bytes("</body></html>", "utf-8"))

if __name__ == "__main__":
webServer = HTTPServer((hostName, serverPort), MyServer)
print("Server started http://%s:%s" % (hostName, serverPort))

try:
webServer.serve_forever()
except KeyboardInterrupt:
pass

webServer.server_close()
print("Server stopped.")
</syntax>

Llame a su imagen "python-http-server". Lance una instancia de la imagen "python-http-server" mapeando el puerto 9999 al puerto 8888/tcp del contenedor. Compruebe con:

<syntax lang="bash">
curl http://127.0.0.1:9999/
</syntax>

que muestre la página HTML que ofrece el servidor, que debería ser:

<syntax lang="bash">
<html><head><title>Welcome!</title></head><body>This is an example web server.</body></html>
</syntax>

Contenedores

2025-12-09T15:12:47Z

Pneira: /* Paso 2: Repositorio de imágenes de contenedores DockerHub */

En esta práctica aprenderemos a utilizar [https://es.wikipedia.org/wiki/Podman podman] para desplegar contenedores.

= Paso 1: Instalar podman =

Para instalar el paquete oficial:

<syntaxhighlight lang="bash">
apt install podman
</syntaxhighlight>

podman es un clon de '''docker''.

= Paso 2: Repositorio de imágenes de contenedores DockerHub =

Docker ofrece un servicio de nube denominado ''DockerHub'' que puede ser empleado como red social para compartir tus imágenes de Podman. En ''DockerHub'' existen además imágenes de contenedores preconfiguradas de software, muchas de ellas oficiales (ofrecidas por el propio fabricante del software) que se podrán emplear como base para construir nuevas imágenes adaptadas a nuestras necesidades.

Podremos realizar búsquedas en este repositorio ''DockerHub'' puedes emplear el siguiente comando:

<syntaxhighlight lang="bash">
podman search docker.io/library/hello-world
</syntaxhighlight>

Para descargarnos la imagen de ''hello-world'' podemos usar la orden ''pull'':

<syntaxhighlight lang="bash">
podman pull docker.io/library/hello-world
</syntaxhighlight>

También podemos publicar imágenes propias, esto require '''registro de usuario''' en la nube de ''DockerHub'', lo que '''no''' es obligatorio para la realización de esta práctica. Para subir una imagen, hay que validarse como usuario en la nube de ''DockerHub'':

<syntaxhighlight lang="bash">
podman login
</syntaxhighlight>

Tras introducir tu usuario y contraseña, puedes comenzar a publicar tus propias imágenes.

<syntaxhighlight lang="bash">
podman push MI_IMAGEN
</syntaxhighlight>

Este paso es '''opcional''', sólo en caso de que se quieran subir imágenes de contenedores a la nube de docker.io.

= Paso 4: Comprobar imágenes en nuestra máquina =

Para ver las imágenes que tenemos en nuestra máquina, utilizaremos el comando:

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Inicialmente, no tenemos imágenes en almacenamiento, podemos descargarnos la imagen oficial de Debian 13 (Trixie):

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian
</syntaxhighlight>

Ahora si, ya debería de aparecernos la imagen ''debian''.

Comentar también que cada imagen puede tener varias etiquetas, por ejemplo, la imagen Debian 12 (Bookworm), cuando la hemos visto en el listado de imágenes, venía con el tag latest, que es el tag que se descarga por defecto, pero nosotros podemos especificar otro, por ejemplo:

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian:bookworm
</syntaxhighlight>

Para traernos la versión de la imagen de Debian 12 ''Bookworm''.

Ahora tendremos dos imágenes con diferente etiqueta, que serían como las diferentes versiones de cada imagen.

= Paso 5: Lanzar un contenedor =

Un contenedor no es más que una imagen de podman ejecutándose, sería similar a
una máquina virtual, aunque mucho más liviano.

Para crear un contenedor, utilizaremos una imagen, en este caso, la imagen
hello-world. Hacemos lo siguiente:

<syntaxhighlight lang="bash">
podman run hello-world
</syntaxhighlight>

Esto nos mostrará el siguiente mensaje si todo está correcto:

<syntaxhighlight lang="bash">
Hello from Docker!
This message shows that your installation appears to be working correctly.

To generate this message, Docker took the following steps:
1. The Docker client contacted the Docker daemon.
2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
(amd64)
3. The Docker daemon created a new container from that image which runs the
executable that produces the output you are currently reading.
4. The Docker daemon streamed that output to the Docker client, which sent it
to your terminal.

To try something more ambitious, you can run an Debian container with:
$ podman run -it debian bash

Share images, automate workflows, and more with a free Docker ID:
https://hub.docker.com/

For more examples and ideas, visit:
https://docs.docker.com/get-started/
</syntaxhighlight>

Al crear los contenedores utilizando el comando 'run', tenemos varias opciones:

* Lanzar una terminal en el contenedor en modo interactivo
* Lanzar en segundo plano y conectarnos posteriormente al contenedor

== Paso 5.1: Lanzar una terminal en el contenedor en modo interactivo (-ti) ==

Para este ejemplo vamos a utilizar otra imagen diferente, en este caso vamos a utilizar una imagen de debian.

Vamos a lanzar un contenedor y ejecutar una terminal en el que se va a ejecutar el programa '''bash''' que me ofrece un interprete de órdenes:

<syntaxhighlight lang="bash">
podman run -ti debian bash
</syntaxhighlight>

La opción ''-t'' indica que se crea un terminal en el contenedor. Y la opción ''-i'' indica que el contenedor se ejecuta en modo interactivo.

Al acceder al contenedor de ''debian'' nos aparece un ''hash'' en el prompt de la shell, que identifica a la instancia del contenedor (es valor es similar al que muestra la orden ''podman container ls'').

Para salir del contenedor, escribimos 'exit' o pulsamos ''CTRL + D''

== Paso 5.2 Lanzar en segundo plano (-d) ==

Otro ejemplo, con la imagen de Debian:

<syntaxhighlight lang="bash">
podman run -dti debian
</syntaxhighlight>

que muestra un hash que identifica de forma única el contenedor lanzado:

<syntaxhighlight lang="bash">
2ec1daae4676a4e84dc04fd91399c1dfe92119544ff12ee307991fe573d3db64
</syntaxhighlight>

Mediante el comando ''attach'' puedo entrar al contenedor:

<syntaxhighlight lang="bash">
podman attach 2ec1daae4676
</syntaxhighlight>

Para salir, pulsamos ''CTRL + P'' seguido de ''CTRL + Q''.

De manera similar, puedo lanzar en segundo plano la imagen de contenedor de ''hello-world'':

<syntaxhighlight lang="bash">
podman run -d hello-world
</syntaxhighlight>

Y consultar los logs:

<syntaxhighlight lang="bash">
podman logs b67fae3312bc321
</syntaxhighlight>

== Paso 5.3: Añadir variables de entorno a un contenedor ==

Utilizaremos la imagen anterior, y vamos a añadir una variable de entorno
llamada TEST que contenga el valor 'test'. A parte, también ejecutaremos la
terminal como antes, para comprobar con el comando echo, que la variable de
entorno está creada correctamente:

<syntaxhighlight lang="bash">
podman run -ti -e TEST=test debian bash
</syntaxhighlight>

Ahora, desde el contenedor podemos comprobar el valor de la variable de entorno ''$TEST''.

<syntaxhighlight lang="bash">
echo $TEST
test
</syntaxhighlight>

= Paso 6: Listar contenedores en ejecución =

Hemos estado haciendo pruebas y ejecutando contenedores en el paso anterior, vamos a ver donde se encuentran estos contenedores que hemos ejecutado, y después veremos algunas opciones más del comando run.

Tenemos dos opciones para ver los contenedores:

<syntaxhighlight lang="bash">
podman container ls -a
</syntaxhighlight>

o la versión corta:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Ambas hacen lo mismo, y debería de mostrarnos una salida similar a la siguiente:

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
e2bde5f5500c debian "bash" 6 minutes ago Exited (0) 2 seconds ago pensive_sammet
544ad27dbc3c debian "bash" 7 minutes ago Exited (0) 7 minutes ago serene_elgamal
</syntaxhighlight>

En la información veremos que el contenedor tiene el estado exited, eso quiere decir que no se está ejecutando y ya ha finalizado. Vamos a hacer una prueba para ver un contendor ejecutándose:

<syntaxhighlight lang="bash">
podman run -d debian sleep 30
</syntaxhighlight>

Con el comando sleep 30 esperamos 30 segundos hasta que termine el comando, asíque durante esos 30 segundos, el contenedor estará ejecutándose, veámoslo:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
eacceb27d52d debian "sleep 30" 12 seconds ago Up 11 seconds sharp_pasteur
</syntaxhighlight>

Vamos a ver alguna opciones más de la orden ''run''.

== Paso 6.1: Dar un nombre al contenedor (--name) ==

Por defecto, podman creará automáticamente un nombre como hemos visto en las salidas del comando ''podman ps -a''. Podemos establecer el nombre del contenedor que queramos con la opción ''--name'':

<syntaxhighlight lang="bash">
podman run -ti --name mi_debian debian
</syntaxhighlight>

== Paso 6.2: Eliminar contenedor cuando termine (--rm) ==

Vamos a mezclar todo lo visto anteriormente:

* Lanzar en segundo plano (-d)
* Ejecutar contenedor durante 30 segundos (sleep 30)
* Dar un nombre a la imagen (--name)
* Eliminar contenedor cuando termine (--rm)

<syntaxhighlight lang="bash">
podman run -d --rm --name bye-bye debian sleep 30
</syntaxhighlight>

Antes y una vez pasados los 30 segundos, podemos comprobar que el contenedor ha desaparecido.

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

= Paso 7: Parar y eliminar contenedores =

Los contenedores podemos pararlos o eliminarlos, veamos como hacerlo. Antes que
nada, borraremos todos los contenedores que estén terminados, para ello:

<syntaxhighlight lang="bash">
podman container prune
podman ps -a
</syntaxhighlight>

Ya lo hemos dejado todo limpio para seguir, ahora vamos a crear un contenedor,
utilizando un comando de linux que no termina, para que así se quede
ejecutándose el contenedor infinitamente:

<syntaxhighlight lang="bash">
podman run -d -ti --name my_container debian bash
podman ps -a
</syntaxhighlight>

Vamos a pararlo (podemos utilizar el nombre dado o el id):

<syntaxhighlight lang="bash">
podman stop my_container
podman stop e4901956f108
podman ps -a
</syntaxhighlight>

Veremos que ya ha terminado, y ahora vamos a eliminarlo, pero solo este
contenedor, no como previamente que eliminamos todos. Lo mismo que para pararlo,
podemos utilizar el nombre o el id.

<syntaxhighlight lang="bash">
podman container rm my_container
podman container rm my_container
podman ps -a
</syntaxhighlight>

Veremos que ya no tenemos el contenedor y está correctamente eliminado.

= Paso 8: Conectarnos a un contenedor que se está ejecutando en segundo plano =

Vamos a ejecutar de nuevo un contenedor que no termine:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a conectarnos a este contenedor que está ejecutándose en segundo
plano:

<syntaxhighlight lang="bash">
podman attach mi-contenedor
</syntaxhighlight>

Veremos la orden bash ejecutándose, para terminar, hacemos un 'CTRL + C', y ahora, veremos que ha pasado con el contenedor:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Lo veremos parado, por que lo que hemos hecho ha sido conectarnos al contenedor
y parar el comando que se estaba ejecutando, así que ahora tenemos el contenedor
finalizado.

''Nota:'' Para salir del contenedor '''sin detenerlo''' hacemos 'CTRL + P' seguido 'CTRL + Q'

= Paso 9: Ejecutar un comando dentro de un contenedor en ejecución =

Vamos a ver otresta vez como ejecutar un comando en un contenedor que ya está
ejecutándose:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a ejecutar un comando en ese contenedor con el nombre ''mi-contenedor''.
El comando exec es similar al comando run, pero para ejecutar un comando dentro de un contenedor:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor ls
</syntaxhighlight>

Para redirigir la salida a un fichero en el anfitrión:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor ls > x.txt
</syntaxhighlight>

Para redirigir la salida a un fichero ''dentro'' del contenedor, hacemos:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor bash -c "ls > x.txt"
</syntaxhighlight>

= Paso 10: Persistencia en contenedores =

Al hacer ''exit'' y salir de un contenedor, se pierden todos los cambios que hemos realizado. Los

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-ejemplo debian bash
</syntaxhighlight>

Ahora, vamos a crear una carpeta en el contenedor y comprobar que esa carpeta existe:

<syntaxhighlight lang="bash">
podman exec mi-ejemplo mkdir test
podman exec mi-ejemplo ls
</syntaxhighlight>

Veremos que la carpeta existe, pero, ¿qué ocurre si para el contenedor?

<syntaxhighlight lang="bash">
podman container stop mi-ejemplo
</syntaxhighlight>

Y volvemos a lanzarlo:

<syntaxhighlight lang="bash">
podman container rm mi-ejemplo
podman run -d -ti --name mi-ejemplo debian bash
podman exec mi-ejemplo ls
</syntaxhighlight>

Podemos comprobar que la carpeta creada anteriormente, no existe.

¿Qué podemos hacer para mantener la modificaciones realizadas sobre un contenedor?

== Paso 10.1: Crear una imagen derivada de la imagen base ==

Es posible crear una imagen derivada, con modificaciones, a partir de una imagen existente mediante la orden '''commit'''.

Por ejemplo, si queremos una imagen ''debian'' que incluya el programa ''ping'' ya instalado, tendríamos que lanzar un contenedor a partir de la imagen ''ubuntu'':

<syntaxhighlight lang="bash">
podman run -d -ti debian bash
</syntaxhighlight>

Suponiendo que el contenido está identificado con el ID 56ef5b312334

Instalamos el paquete ping:

<syntaxhighlight lang="bash">
podman exec 56ef5b312334 apt -y install ping
</syntaxhighlight>

Generamos la imagen derivada con el nombre ''ubuntu-con-ping'':

<syntaxhighlight lang="bash">
podman commit 56ef5b312334 ubuntu-con-ping
</syntaxhighlight>

Ya podemos para nuestro contendor:

<syntaxhighlight lang="bash">
podman stop 56ef5b312334
</syntaxhighlight>

Y lanzar un nuevo contenedor a partir de la imagen ''debian-con-ping'':

<syntaxhighlight lang="bash">
podman run -d -ti debian-con-ping bash
</syntaxhighlight>

== Paso 10.2: Mantener la persistencia mediante volúmen ==

Otra opción para mantener los datos es montar un volumen al ejecutar el contenedor.

Primero crearemos una carpeta que hará de volumen en nuestra máquina, que será la que luego montemos para podman:

<syntaxhighlight lang="bash">
mkdir /home/debian/volumen
</syntaxhighlight>

Ahora vamos a montar la carpeta al ejecutar el contenedor, lo hacemos con la
opción -v, la cual tiene 3 campos separados por ':':

# El volumen en nuestra máquina
# Donde se montará el volumen dentro del contenedor
# Opciones de mmontaje, por ejemplo rw (read and write) o ro (read only)

<syntaxhighlight lang="bash">
podman run --rm -ti -v /home/debian/volumen:/volumen:rw debian bash
mkdir /volumen/test
touch /volumen/test/file
exit
</syntaxhighlight>

Una vez nos salgamos del contenedor, podemos ver que en nuestra máquina están
los datos:

<syntaxhighlight lang="bash">
ls /home/ubuntu/volumen/
ls /home/ubuntu/volumen/test
</syntaxhighlight>

La próxima vez que ejecutemos un contenedor, si montamos ese volumen, los datos
estarán ahí, además esta forma tiene el beneficio de compartir datos entre
nuestra máquina y el contenedor de forma sencilla.

= Paso 11: Crear nuestra propia imagen de contenedor =

Para crear una imagen de un contenedor con una aplicación de Python hug, creamos en primer lugar la carpeta que contendrá los ficheros que nos permiten crear la imagen.

<syntaxhighlight lang="bash">
mkdir miapp
cd miapp
</syntaxhighlight>

Definimos un fichero ''Dockerfile'' para definir la imagen:

<syntaxhighlight lang="bash">
FROM ubuntu

RUN apt -y update
RUN apt -y upgrade
RUN apt -y install python3-hug
RUN mkdir /app
COPY endpoint.py /app
WORKDIR /app
CMD hug -f endpoint.py
</syntaxhighlight>

Alternativamente, puedes crear un [[Creando imagen propia usando Ubuntu de base|Dockerfile empleando la imagen de Ubuntu]] como base en lugar de Alpine.

Y añadimos el fichero ''endpoint.py'' que emplea el framework Python hug con el contenido siguiente:

<syntaxhighlight lang="bash">
import hug

@hug.get('/welcome')
def welcome(username="unknown"):
""" Say welcome to username """
return "Welcome " + username
</syntaxhighlight>

Este fichero es un ejemplo de uso de Python hug. Si hacemos una petición a /welcome?username="LSO", esto nos devolverá el mensaje "Welcome LSO".

Una vez tengamos los dos ficheros creados en nuestra máquina virtual, podemos construir nuestra imagen:

<syntaxhighlight lang="bash">
podman build -t app:v1 -f Dockerfile .
</syntaxhighlight>

Vamos a explicar para que sirve cada línea:

* FROM: servirá para basarnos en una imagen existente, en este caso, una imagen de python alpine, que contiene python y no ocupa mucho espacio
* ENV: para crear variables de entorno
* RUN: para ejecutar comandos, ya sea para crear una carpeta, instalar dependencias o cualquier otra opción que necesitemos
* COPY: para copiar datos desde nuestra máquina a la imagen
* WORKDIR: para cambiar el directorio de trabajo
* CMD: este comando será ejecutado por defecto al iniciar un contenedor a partir de esta imagen

Esto construirá una imagen podman basada en python:alpine, en la cual hemos
guardado nuestra pequeña aplicación y se va a ejecutar cuando ejecutemos un
contenedor basado en esa imagen. Para comprobar que la imagen se ha creado
correctamente, listamos las imagenes, y debería de aparecernos una imagen con
nombre 'app' y tag 'v1':

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen, y vamos a añadir una nueva
opción, -p 8001:8000. Esta opción hará que el puerto interno 8000 del contenedor
sea expuesto en el puerto 8001 de nuestra máquina:

<syntaxhighlight lang="bash">
podman run --name my-app --rm -d -p 8001:8000 app:v1
</syntaxhighlight>

''Nota:'' podman supone que la redirección de puerto es TCP, para una redirección de puertos UDP, puedes usar:

<syntaxhighlight lang="bash">
... -p 8001:8000/udp
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código. En nuestra
máquina haremos:

<syntaxhighlight lang="bash">
curl -X GET http://localhost:8001/welcome?username=LSO
</syntaxhighlight>

Comprobaremos que la salida del comando curl, es "Welcome LSO".

Antes de terminar, vamos a comprobar otro pequeño detalle que añadimos en
nuestra imagen, la variable de entorno USERNAME, vamos a comprobar que funciona:

<syntaxhighlight lang="bash">
podman exec -ti my-app ash
echo $USERNAME
</syntaxhighlight>

Funciona correctamente, pero al ejecutar el contenedor, podemos cambiar esta
variable de entorno como vimos en uno de los pasos anteriores:

<syntaxhighlight lang="bash">
podman run --rm -ti -e USERNAME=me app:v1 ash
echo $USERNAME
</syntaxhighlight>

Esto nos servirá para tener opciones por defecto y que el usuario pueda
cambiarlo a su antojo, como por ejemplo contraseñas u otros detalles.

= Paso 12: Eliminar imágenes =

Para borrar una imagen, puede hacer:

<syntaxhighlight lang="bash">
podman image rm hello-world
</syntaxhighlight>

= Paso 13: Varios podman a la vez (podman-compose) =

Antes de comenzar, vamos a parar todos los contenedores que tengamos abiertos,
para dejar el entorno de podman limpio, que nos vendrá bien para esta parte.

Cuando queremos ejecutar varios contenedores a la vez y que estén conectados
entre ellos fácilmente, utilizaremos podman-compose, donde con un fichero de
configuración simple en yaml, tendremos toda la configuración de lo que vamos a
ejecutar.

Primero vamos a instalar podman-compose:

<syntaxhighlight lang="bash">
sudo apt install podman-compose
</syntaxhighlight>

Ahora veamos un pequeño ejemplo donde explicaremos todos los detalles para crear
un podman-compose, en este caso, el nombre por defecto de los ficheros suele ser
podman-compose.yml, y el contenido será similar a:

<syntaxhighlight lang="bash">
version: '3'

services:
web:
container_name: web
restart: always
build:
context: .
ports:
- "8000:8000"
volumes:
- /home/ubuntu/volume:/volumen:rw
environment:
USERNAME: test
web2:
container_name: web2
build:
dockerfile: Dockerfile
context: .
depends_on:
- web
command: touch web2
web3:
container_name: web3
restart: on-failure
image: pstauffer/curl
depends_on:
- web
command: curl -X GET web:8000/welcome?username=web3
</syntaxhighlight>

En el podman-compose definimos diferentes servicios a ejecutar, en nuestro caso
hemos iniciado tres servicios diferentes, web, web2 y web3:

El primer servicio, web:

* container_name: para darle un nombre por defecto al contenedor cuando se cree
* restart: pueden ser:
** "no": si la máquina termina, no se vuelve a iniciar (opción por defecto)
** always: siempre que el contenedor termine, intenta iniciarse de nuevo
** on-failure: solo intenta reiniciarse si el contenedor termina con fallo
** unless-stopped: solo reinicia el contenedor si el usuario es el que lo termina
* Utilizará el fichero Dockerfile creado en el paso 11 para generar la imagen a usar.
* Expondrá el puerto 8000 del contenedor en el 8000 de nuestra máquina
* Montará un volumen, se hace de forma similar a la línea de comandos
* Creará una variable de entorno

El segundo servicio, web2:

* Utilizará el fichero Dockerfile también, la diferencia entre este y el primer servicio, es que si el nombre del Dockerfile cambia, tendremos que hacerlo de esta segunda forma, la primera por defecto solo buscará el fichero Dockerfile
* depends_on hará que para ejecutar este servicio, su dependencia tenga ya que estar iniciada
* Ejecutaremos un comando el cual sustituirá al comando de la imagen

El tercer servicio, web3:

* Utilizará la imagen ostauffer/curl que es un imagen mínima que contiene el comando curl
* restart: en este caso, hasta que el comando no se ejecute correctamente, se seguirá reiniciando el contenedor
* depends_on igual que el servicio 2, dependerá del servicio 1
* Ejecutaremos un comando para llamar desde el servicio 3 al servicio 1

== Paso 13.1: Construir podman-compose ==

En el caso de existir servicios que tengan Dockerfiles, esto hará que se construyan previamente, como hacer un podman build de cada uno de los servicios que contenga un Dockerfile:

<syntaxhighlight lang="bash">
podman-compose build
</syntaxhighlight>

Con esto se generarán las imágenes necesarias para ejecutar todos los servicios.

== Paso 13.2: Iniciar podman-compose ==

Para iniciar todos los servicios, ejecutaremos:

<syntaxhighlight lang="bash">
podman-compose up -d
</syntaxhighlight>

Después de esto podremos ver el logs de todos los servicios:

<syntaxhighlight lang="bash">
podman-compose logs -f
</syntaxhighlight>

Aquí veremos que el servicio 3 ha conseguido llamar correctamente al servicio 1.

Ahora veremos como podman-compose ha creado los contenedores:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

La salida será similar a la siguiente:

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
219a4118244c pstauffer/curl "curl -X GET web:800…" 6 seconds ago Exited (0) 3 seconds ago web3
c97e894cb3ae ubuntu_web2 "touch web2" 6 seconds ago Exited (0) 4 seconds ago web2
f35d034204fc ubuntu_web "/bin/sh -c 'hug -f …" 6 seconds ago Up 5 seconds 0.0.0.0:8000->8000/tcp web
</syntaxhighlight>

Aquí vemos varios detalles:

* El nombre que le hemos dado en el podman-compose ha funcionado correctamente
* Vemos que los comandos son los correctos también
* web2 está parado por que la política de reinicio es apagar cuando se termine de ejecutar un comando
* web 3 está parado por que el comando ha terminado con un salida correcta

Vamos a comprobar ahora que en el servicio web está todo correcto:

<syntaxhighlight lang="bash">
podman exec -ti web ash
echo $USERNAME
ls /volumen
exit
</syntaxhighlight>

Podemos comprobar que tanto cambiar la variable de entorno como crear un
volumen ha funcionado correctamente.

== Paso 13.3: Parar podman-compose ==

Para parar todos los servicios:

<syntaxhighlight lang="bash">
podman-compose down
</syntaxhighlight>

Comprobamos:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Vemos que han desaparecido todos los contenedores.

= Paso 14: Ejercicios =

== Ejercicio 1: Variante de httpd ==

Construya una imagen ''httpd-hola-mundo'' a partir de la imagen ''httpd''. El fichero de index.html de la carpeta htdocs/ tiene que mostrar el mensaje "hola mundo".

<syntaxhighlight lang="bash">
docker pull httpd
</syntaxhighlight>

Edita el fichero Dockerfile:

<syntaxhighlight lang="bash">
nano Dockerfile
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
FROM httpd

COPY index.html htdocs/index.html
</syntaxhighlight>

Edita el fichero index.html:

<syntaxhighlight lang="bash">
nano index.html
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

Construye la imagen:

<syntaxhighlight lang="bash">
docker build -t mihttpd -f Dockerfile .
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen:

<syntaxhighlight lang="bash">
sudo docker run --name mihttpd -d -p 8080:80 mihttpd
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código:
<syntaxhighlight lang="bash">
curl -X GET http://localhost:8080
</syntaxhighlight>

Tiene que salir por pantalla esto:
<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

== Ejercicio 2: aplicación flask ==

Flask es un framework python para implementar webs. Cree una imagen "miapp-flask" a partir de la imagen de "python":

* Instale flask mediante: pip install flask
* Cree la carpeta "app"
* Establezca la variable FLASK_APP a "hello.py"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"

El fichero hello.py contiene un "hola mundo" para Flask:

<syntaxhighlight lang="python">
from flask import Flask
app = Flask(__name__)

@app.route("/")
def hello():
return "Hello World!"

if __name__ == "__main__":
app.run()
</syntaxhighlight>

Solución con alpine:

<syntaxhighlight lang="bash">
FROM python:alpine

RUN mkdir /app
RUN pip install flask
ENV FLASK_APP="app/hello.py"
COPY hello.py
WORKDIR /
CMD flask run --host=0.0.0.0
</syntaxhighlight>

Solución con Ubuntu:

<syntaxhighlight lang="bash">
FROM ubuntu:bionic

RUN apt-get update
RUN apt-get -y install python python-pip wget
RUN pip install Flask
ENV FLASK_APP="app/hello.py"
RUN mkdir /app
COPY hello.py /app
CMD flask run --host=0.0.0.0
</syntaxhighlight>

== Ejercicio 3: mysql ==

'''EN LA MÁQUINA VIRTUAL:'''

mkdir miapp

cd miapp

sudo docker pull mysql

nano Dockerfile

<syntaxhighlight lang="bash">
FROM mysql
ENV MYSQL_ROOT_PASSWORD="lacontraseñaqueyoquiera"
RUN mkdir /app
WORKDIR /app

</syntaxhighlight>

CTRL+O , ENTER Y CTRL+X (para guardar Dockerfile y salir)

sudo docker build -ti mrfdocker -f Dockerfile .

sudo docker run --name mymrf --rm -p 8001:3306 mrfdocker

sudo docker images

'''EN LA TERMINAL DEL HOST:'''

''Instalación de mysql:''

sudo apt install mysql-client-core-5.7

> sudo apt-get install mysql-server

> sudo service mysql start

''Para entrar:''

sudo mysql -u root -p -P 8001

Una vez dentro de msql:

mysql> show databases;
''
Para salir:''

exit

== Ejercicio 5: python pyramid ==

Pyramid es un framework python para implementar webs. Cree una imagen "miapp-pyramid":

* Emplee la imagen de Ubuntu como referencia, instale los paquetes python y python-pip.
* Instale Pyramid mediante: pip install pyramid
* Cree la carpeta "app"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"
* La aplicación se lanza con la orden: python hello.py
* Compruebe que funciona con curl, la ruta a la web es http://127.0.0.1:8000/hello, suponiendo que ha empleado el puerto 8000 para exponer el servicio.

El fichero hello.py contiene un "hola mundo" para Pyramid:

<syntaxhighlight lang="bash">
from wsgiref.simple_server import make_server
from pyramid.config import Configurator
from pyramid.response import Response

def hello_world(request):
print('Request inbound!')
return Response('Docker works with Pyramid!')

if __name__ == '__main__':
config = Configurator()
config.add_route('hello', '/')
config.add_view(hello_world, route_name='hello')
app = config.make_wsgi_app()
server = make_server('0.0.0.0', 6543, app)
server.serve_forever()
</syntaxhighlight>

Este programa recibe peticiones en el puerto 6543.

== Ejercicio 6 ==

Cree una imagen derivada de Ubuntu, instale el paquete apache2, php y libapache2-mod-php.
Active el módulo de php para apache2 mediante la orden:

<syntaxhighlight lang="bash">
a2enmod php
</syntaxhighlight>

Cree la carpeta /var/www/php.

Cree el fichero index.php

<syntaxhighlight lang="php">
<?php
Print "Hello, World!";
?>
</syntaxhighlight>

y copielo a /var/www/php/.

Cree el fichero 000-default.conf y copielo a /etc/apache2/sites-enabled/

Dicho fichero contiene.

<syntaxhighlight lang="bash">
<VirtualHost *:80>
DocumentRoot /var/www/php

<Directory /var/www/php/>
Options Indexes FollowSymLinks MultiViews
AllowOverride All
Order deny,allow
Allow from all
</Directory>

ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>
</syntaxhighlight>

Tiene que lanzar apache con la orden: apachectl -D FOREGROUND

Tras crear la imagen, láncela mapeando el puerto 8888 al 80, pruebe que puede acceder a http://127.0.0.1:8888/php/ mediante curl

Solución:

<syntaxhighlight lang="bash">
FROM ubuntu:latest

RUN apt-get update
RUN apt-get install -y tzdata
RUN apt-get install -y apache2
RUN apt-get install -y php
RUN apt-get install -y libapache2-mod-php
RUN a2enmod php7.2
COPY index.php /var/www/php
COPY 000-default.conf /etc/apache2/sites-enabled/
CMD apachectl -D FOREGROUND
</syntaxhighlight>

Y para lanzarlo:

docker run --name my-app --rm -d -p 8001:8000 app:v1

y para probarlo:

curl -X GET http://127.0.0.1:8888/php/

== Ejercicio 7 ==

Instale el paquete ''netcat-traditional'' en una imagen de contenedor de ''ubuntu''. Lance la orden:

nc -u -l -p 8080

en el contenedor. Asegúrese de crear una redirección de puertos de 9999 desde el ''host'' al puerto 8080 en el contenedor.

Desde fuera del contenedor, pruebe a conectarse con:

nc -u 127.0.0.1 9999

== Ejercicio 8 ==

Cree una imagen derivada de "ubuntu" con un Dockerfile que incluya soporte de python y lance el siguiente código en Python:

<syntax lang="python">
from http.server import BaseHTTPRequestHandler, HTTPServer
import time

hostName = "0.0.0.0"
serverPort = 8080

class MyServer(BaseHTTPRequestHandler):
def do_GET(self):
self.send_response(200)
self.send_header("Content-type", "text/html")
self.end_headers()
self.wfile.write(bytes("<html><head><title>Welcome!</title></head>", "utf-8"))
self.wfile.write(bytes("<body>", "utf-8"))
self.wfile.write(bytes("This is an example web server.", "utf-8"))
self.wfile.write(bytes("</body></html>", "utf-8"))

if __name__ == "__main__":
webServer = HTTPServer((hostName, serverPort), MyServer)
print("Server started http://%s:%s" % (hostName, serverPort))

try:
webServer.serve_forever()
except KeyboardInterrupt:
pass

webServer.server_close()
print("Server stopped.")
</syntax>

Llame a su imagen "python-http-server". Lance una instancia de la imagen "python-http-server" mapeando el puerto 9999 al puerto 8888/tcp del contenedor. Compruebe con:

<syntax lang="bash">
curl http://127.0.0.1:9999/
</syntax>

que muestre la página HTML que ofrece el servidor, que debería ser:

<syntax lang="bash">
<html><head><title>Welcome!</title></head><body>This is an example web server.</body></html>
</syntax>

Contenedores

2025-12-09T13:39:35Z

Pneira: /* Paso 12: Eliminar imágenes */

En esta práctica aprenderemos a utilizar [https://es.wikipedia.org/wiki/Podman podman] para desplegar contenedores.

= Paso 1: Instalar podman =

Para instalar el paquete oficial:

<syntaxhighlight lang="bash">
apt install podman
</syntaxhighlight>

podman es un clon de '''docker''.

= Paso 2: Repositorio de imágenes de contenedores DockerHub =

Docker ofrece un servicio de nube denominado ''DockerHub'' que puede ser empleado como red social para compartir tus imágenes de Podman. En ''DockerHub'' existen además imágenes de contenedores preconfiguradas de software, muchas de ellas oficiales (ofrecidas por el propio fabricante del software) que se podrán emplear como base para construir nuevas imágenes adaptadas a nuestras necesidades.

Podremos realizar búsquedas en este repositorio ''DockerHub'' puedes emplear el siguiente comando:

<syntaxhighlight lang="bash">
podman search docker.io/library/hello-world
</syntaxhighlight>

Para descargarnos la imagen de ''hello-world'' podemos usar la orden ''pull'':

<syntaxhighlight lang="bash">
podman pull hello-world
</syntaxhighlight>

También podemos publicar imágenes propias, esto require '''registro de usuario''' en la nube de ''DockerHub'', lo que '''no''' es obligatorio para la realización de esta práctica. Para subir una imagen, hay que validarse como usuario en la nube de ''DockerHub'':

<syntaxhighlight lang="bash">
podman login
</syntaxhighlight>

Tras introducir tu usuario y contraseña, puedes comenzar a publicar tus propias imágenes.

<syntaxhighlight lang="bash">
podman push MI_IMAGEN
</syntaxhighlight>

Este paso es '''opcional''', sólo en caso de que se quieran subir imágenes de contenedores a la nube de docker.io.

= Paso 4: Comprobar imágenes en nuestra máquina =

Para ver las imágenes que tenemos en nuestra máquina, utilizaremos el comando:

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Inicialmente, no tenemos imágenes en almacenamiento, podemos descargarnos la imagen oficial de Debian 13 (Trixie):

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian
</syntaxhighlight>

Ahora si, ya debería de aparecernos la imagen ''debian''.

Comentar también que cada imagen puede tener varias etiquetas, por ejemplo, la imagen Debian 12 (Bookworm), cuando la hemos visto en el listado de imágenes, venía con el tag latest, que es el tag que se descarga por defecto, pero nosotros podemos especificar otro, por ejemplo:

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian:bookworm
</syntaxhighlight>

Para traernos la versión de la imagen de Debian 12 ''Bookworm''.

Ahora tendremos dos imágenes con diferente etiqueta, que serían como las diferentes versiones de cada imagen.

= Paso 5: Lanzar un contenedor =

Un contenedor no es más que una imagen de podman ejecutándose, sería similar a
una máquina virtual, aunque mucho más liviano.

Para crear un contenedor, utilizaremos una imagen, en este caso, la imagen
hello-world. Hacemos lo siguiente:

<syntaxhighlight lang="bash">
podman run hello-world
</syntaxhighlight>

Esto nos mostrará el siguiente mensaje si todo está correcto:

<syntaxhighlight lang="bash">
Hello from Docker!
This message shows that your installation appears to be working correctly.

To generate this message, Docker took the following steps:
1. The Docker client contacted the Docker daemon.
2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
(amd64)
3. The Docker daemon created a new container from that image which runs the
executable that produces the output you are currently reading.
4. The Docker daemon streamed that output to the Docker client, which sent it
to your terminal.

To try something more ambitious, you can run an Debian container with:
$ podman run -it debian bash

Share images, automate workflows, and more with a free Docker ID:
https://hub.docker.com/

For more examples and ideas, visit:
https://docs.docker.com/get-started/
</syntaxhighlight>

Al crear los contenedores utilizando el comando 'run', tenemos varias opciones:

* Lanzar una terminal en el contenedor en modo interactivo
* Lanzar en segundo plano y conectarnos posteriormente al contenedor

== Paso 5.1: Lanzar una terminal en el contenedor en modo interactivo (-ti) ==

Para este ejemplo vamos a utilizar otra imagen diferente, en este caso vamos a utilizar una imagen de debian.

Vamos a lanzar un contenedor y ejecutar una terminal en el que se va a ejecutar el programa '''bash''' que me ofrece un interprete de órdenes:

<syntaxhighlight lang="bash">
podman run -ti debian bash
</syntaxhighlight>

La opción ''-t'' indica que se crea un terminal en el contenedor. Y la opción ''-i'' indica que el contenedor se ejecuta en modo interactivo.

Al acceder al contenedor de ''debian'' nos aparece un ''hash'' en el prompt de la shell, que identifica a la instancia del contenedor (es valor es similar al que muestra la orden ''podman container ls'').

Para salir del contenedor, escribimos 'exit' o pulsamos ''CTRL + D''

== Paso 5.2 Lanzar en segundo plano (-d) ==

Otro ejemplo, con la imagen de Debian:

<syntaxhighlight lang="bash">
podman run -dti debian
</syntaxhighlight>

que muestra un hash que identifica de forma única el contenedor lanzado:

<syntaxhighlight lang="bash">
2ec1daae4676a4e84dc04fd91399c1dfe92119544ff12ee307991fe573d3db64
</syntaxhighlight>

Mediante el comando ''attach'' puedo entrar al contenedor:

<syntaxhighlight lang="bash">
podman attach 2ec1daae4676
</syntaxhighlight>

Para salir, pulsamos ''CTRL + P'' seguido de ''CTRL + Q''.

De manera similar, puedo lanzar en segundo plano la imagen de contenedor de ''hello-world'':

<syntaxhighlight lang="bash">
podman run -d hello-world
</syntaxhighlight>

Y consultar los logs:

<syntaxhighlight lang="bash">
podman logs b67fae3312bc321
</syntaxhighlight>

== Paso 5.3: Añadir variables de entorno a un contenedor ==

Utilizaremos la imagen anterior, y vamos a añadir una variable de entorno
llamada TEST que contenga el valor 'test'. A parte, también ejecutaremos la
terminal como antes, para comprobar con el comando echo, que la variable de
entorno está creada correctamente:

<syntaxhighlight lang="bash">
podman run -ti -e TEST=test debian bash
</syntaxhighlight>

Ahora, desde el contenedor podemos comprobar el valor de la variable de entorno ''$TEST''.

<syntaxhighlight lang="bash">
echo $TEST
test
</syntaxhighlight>

= Paso 6: Listar contenedores en ejecución =

Hemos estado haciendo pruebas y ejecutando contenedores en el paso anterior, vamos a ver donde se encuentran estos contenedores que hemos ejecutado, y después veremos algunas opciones más del comando run.

Tenemos dos opciones para ver los contenedores:

<syntaxhighlight lang="bash">
podman container ls -a
</syntaxhighlight>

o la versión corta:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Ambas hacen lo mismo, y debería de mostrarnos una salida similar a la siguiente:

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
e2bde5f5500c debian "bash" 6 minutes ago Exited (0) 2 seconds ago pensive_sammet
544ad27dbc3c debian "bash" 7 minutes ago Exited (0) 7 minutes ago serene_elgamal
</syntaxhighlight>

En la información veremos que el contenedor tiene el estado exited, eso quiere decir que no se está ejecutando y ya ha finalizado. Vamos a hacer una prueba para ver un contendor ejecutándose:

<syntaxhighlight lang="bash">
podman run -d debian sleep 30
</syntaxhighlight>

Con el comando sleep 30 esperamos 30 segundos hasta que termine el comando, asíque durante esos 30 segundos, el contenedor estará ejecutándose, veámoslo:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
eacceb27d52d debian "sleep 30" 12 seconds ago Up 11 seconds sharp_pasteur
</syntaxhighlight>

Vamos a ver alguna opciones más de la orden ''run''.

== Paso 6.1: Dar un nombre al contenedor (--name) ==

Por defecto, podman creará automáticamente un nombre como hemos visto en las salidas del comando ''podman ps -a''. Podemos establecer el nombre del contenedor que queramos con la opción ''--name'':

<syntaxhighlight lang="bash">
podman run -ti --name mi_debian debian
</syntaxhighlight>

== Paso 6.2: Eliminar contenedor cuando termine (--rm) ==

Vamos a mezclar todo lo visto anteriormente:

* Lanzar en segundo plano (-d)
* Ejecutar contenedor durante 30 segundos (sleep 30)
* Dar un nombre a la imagen (--name)
* Eliminar contenedor cuando termine (--rm)

<syntaxhighlight lang="bash">
podman run -d --rm --name bye-bye debian sleep 30
</syntaxhighlight>

Antes y una vez pasados los 30 segundos, podemos comprobar que el contenedor ha desaparecido.

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

= Paso 7: Parar y eliminar contenedores =

Los contenedores podemos pararlos o eliminarlos, veamos como hacerlo. Antes que
nada, borraremos todos los contenedores que estén terminados, para ello:

<syntaxhighlight lang="bash">
podman container prune
podman ps -a
</syntaxhighlight>

Ya lo hemos dejado todo limpio para seguir, ahora vamos a crear un contenedor,
utilizando un comando de linux que no termina, para que así se quede
ejecutándose el contenedor infinitamente:

<syntaxhighlight lang="bash">
podman run -d -ti --name my_container debian bash
podman ps -a
</syntaxhighlight>

Vamos a pararlo (podemos utilizar el nombre dado o el id):

<syntaxhighlight lang="bash">
podman stop my_container
podman stop e4901956f108
podman ps -a
</syntaxhighlight>

Veremos que ya ha terminado, y ahora vamos a eliminarlo, pero solo este
contenedor, no como previamente que eliminamos todos. Lo mismo que para pararlo,
podemos utilizar el nombre o el id.

<syntaxhighlight lang="bash">
podman container rm my_container
podman container rm my_container
podman ps -a
</syntaxhighlight>

Veremos que ya no tenemos el contenedor y está correctamente eliminado.

= Paso 8: Conectarnos a un contenedor que se está ejecutando en segundo plano =

Vamos a ejecutar de nuevo un contenedor que no termine:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a conectarnos a este contenedor que está ejecutándose en segundo
plano:

<syntaxhighlight lang="bash">
podman attach mi-contenedor
</syntaxhighlight>

Veremos la orden bash ejecutándose, para terminar, hacemos un 'CTRL + C', y ahora, veremos que ha pasado con el contenedor:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Lo veremos parado, por que lo que hemos hecho ha sido conectarnos al contenedor
y parar el comando que se estaba ejecutando, así que ahora tenemos el contenedor
finalizado.

''Nota:'' Para salir del contenedor '''sin detenerlo''' hacemos 'CTRL + P' seguido 'CTRL + Q'

= Paso 9: Ejecutar un comando dentro de un contenedor en ejecución =

Vamos a ver otresta vez como ejecutar un comando en un contenedor que ya está
ejecutándose:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a ejecutar un comando en ese contenedor con el nombre ''mi-contenedor''.
El comando exec es similar al comando run, pero para ejecutar un comando dentro de un contenedor:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor ls
</syntaxhighlight>

Para redirigir la salida a un fichero en el anfitrión:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor ls > x.txt
</syntaxhighlight>

Para redirigir la salida a un fichero ''dentro'' del contenedor, hacemos:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor bash -c "ls > x.txt"
</syntaxhighlight>

= Paso 10: Persistencia en contenedores =

Al hacer ''exit'' y salir de un contenedor, se pierden todos los cambios que hemos realizado. Los

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-ejemplo debian bash
</syntaxhighlight>

Ahora, vamos a crear una carpeta en el contenedor y comprobar que esa carpeta existe:

<syntaxhighlight lang="bash">
podman exec mi-ejemplo mkdir test
podman exec mi-ejemplo ls
</syntaxhighlight>

Veremos que la carpeta existe, pero, ¿qué ocurre si para el contenedor?

<syntaxhighlight lang="bash">
podman container stop mi-ejemplo
</syntaxhighlight>

Y volvemos a lanzarlo:

<syntaxhighlight lang="bash">
podman container rm mi-ejemplo
podman run -d -ti --name mi-ejemplo debian bash
podman exec mi-ejemplo ls
</syntaxhighlight>

Podemos comprobar que la carpeta creada anteriormente, no existe.

¿Qué podemos hacer para mantener la modificaciones realizadas sobre un contenedor?

== Paso 10.1: Crear una imagen derivada de la imagen base ==

Es posible crear una imagen derivada, con modificaciones, a partir de una imagen existente mediante la orden '''commit'''.

Por ejemplo, si queremos una imagen ''debian'' que incluya el programa ''ping'' ya instalado, tendríamos que lanzar un contenedor a partir de la imagen ''ubuntu'':

<syntaxhighlight lang="bash">
podman run -d -ti debian bash
</syntaxhighlight>

Suponiendo que el contenido está identificado con el ID 56ef5b312334

Instalamos el paquete ping:

<syntaxhighlight lang="bash">
podman exec 56ef5b312334 apt -y install ping
</syntaxhighlight>

Generamos la imagen derivada con el nombre ''ubuntu-con-ping'':

<syntaxhighlight lang="bash">
podman commit 56ef5b312334 ubuntu-con-ping
</syntaxhighlight>

Ya podemos para nuestro contendor:

<syntaxhighlight lang="bash">
podman stop 56ef5b312334
</syntaxhighlight>

Y lanzar un nuevo contenedor a partir de la imagen ''debian-con-ping'':

<syntaxhighlight lang="bash">
podman run -d -ti debian-con-ping bash
</syntaxhighlight>

== Paso 10.2: Mantener la persistencia mediante volúmen ==

Otra opción para mantener los datos es montar un volumen al ejecutar el contenedor.

Primero crearemos una carpeta que hará de volumen en nuestra máquina, que será la que luego montemos para podman:

<syntaxhighlight lang="bash">
mkdir /home/debian/volumen
</syntaxhighlight>

Ahora vamos a montar la carpeta al ejecutar el contenedor, lo hacemos con la
opción -v, la cual tiene 3 campos separados por ':':

# El volumen en nuestra máquina
# Donde se montará el volumen dentro del contenedor
# Opciones de mmontaje, por ejemplo rw (read and write) o ro (read only)

<syntaxhighlight lang="bash">
podman run --rm -ti -v /home/debian/volumen:/volumen:rw debian bash
mkdir /volumen/test
touch /volumen/test/file
exit
</syntaxhighlight>

Una vez nos salgamos del contenedor, podemos ver que en nuestra máquina están
los datos:

<syntaxhighlight lang="bash">
ls /home/ubuntu/volumen/
ls /home/ubuntu/volumen/test
</syntaxhighlight>

La próxima vez que ejecutemos un contenedor, si montamos ese volumen, los datos
estarán ahí, además esta forma tiene el beneficio de compartir datos entre
nuestra máquina y el contenedor de forma sencilla.

= Paso 11: Crear nuestra propia imagen de contenedor =

Para crear una imagen de un contenedor con una aplicación de Python hug, creamos en primer lugar la carpeta que contendrá los ficheros que nos permiten crear la imagen.

<syntaxhighlight lang="bash">
mkdir miapp
cd miapp
</syntaxhighlight>

Definimos un fichero ''Dockerfile'' para definir la imagen:

<syntaxhighlight lang="bash">
FROM ubuntu

RUN apt -y update
RUN apt -y upgrade
RUN apt -y install python3-hug
RUN mkdir /app
COPY endpoint.py /app
WORKDIR /app
CMD hug -f endpoint.py
</syntaxhighlight>

Alternativamente, puedes crear un [[Creando imagen propia usando Ubuntu de base|Dockerfile empleando la imagen de Ubuntu]] como base en lugar de Alpine.

Y añadimos el fichero ''endpoint.py'' que emplea el framework Python hug con el contenido siguiente:

<syntaxhighlight lang="bash">
import hug

@hug.get('/welcome')
def welcome(username="unknown"):
""" Say welcome to username """
return "Welcome " + username
</syntaxhighlight>

Este fichero es un ejemplo de uso de Python hug. Si hacemos una petición a /welcome?username="LSO", esto nos devolverá el mensaje "Welcome LSO".

Una vez tengamos los dos ficheros creados en nuestra máquina virtual, podemos construir nuestra imagen:

<syntaxhighlight lang="bash">
podman build -t app:v1 -f Dockerfile .
</syntaxhighlight>

Vamos a explicar para que sirve cada línea:

* FROM: servirá para basarnos en una imagen existente, en este caso, una imagen de python alpine, que contiene python y no ocupa mucho espacio
* ENV: para crear variables de entorno
* RUN: para ejecutar comandos, ya sea para crear una carpeta, instalar dependencias o cualquier otra opción que necesitemos
* COPY: para copiar datos desde nuestra máquina a la imagen
* WORKDIR: para cambiar el directorio de trabajo
* CMD: este comando será ejecutado por defecto al iniciar un contenedor a partir de esta imagen

Esto construirá una imagen podman basada en python:alpine, en la cual hemos
guardado nuestra pequeña aplicación y se va a ejecutar cuando ejecutemos un
contenedor basado en esa imagen. Para comprobar que la imagen se ha creado
correctamente, listamos las imagenes, y debería de aparecernos una imagen con
nombre 'app' y tag 'v1':

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen, y vamos a añadir una nueva
opción, -p 8001:8000. Esta opción hará que el puerto interno 8000 del contenedor
sea expuesto en el puerto 8001 de nuestra máquina:

<syntaxhighlight lang="bash">
podman run --name my-app --rm -d -p 8001:8000 app:v1
</syntaxhighlight>

''Nota:'' podman supone que la redirección de puerto es TCP, para una redirección de puertos UDP, puedes usar:

<syntaxhighlight lang="bash">
... -p 8001:8000/udp
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código. En nuestra
máquina haremos:

<syntaxhighlight lang="bash">
curl -X GET http://localhost:8001/welcome?username=LSO
</syntaxhighlight>

Comprobaremos que la salida del comando curl, es "Welcome LSO".

Antes de terminar, vamos a comprobar otro pequeño detalle que añadimos en
nuestra imagen, la variable de entorno USERNAME, vamos a comprobar que funciona:

<syntaxhighlight lang="bash">
podman exec -ti my-app ash
echo $USERNAME
</syntaxhighlight>

Funciona correctamente, pero al ejecutar el contenedor, podemos cambiar esta
variable de entorno como vimos en uno de los pasos anteriores:

<syntaxhighlight lang="bash">
podman run --rm -ti -e USERNAME=me app:v1 ash
echo $USERNAME
</syntaxhighlight>

Esto nos servirá para tener opciones por defecto y que el usuario pueda
cambiarlo a su antojo, como por ejemplo contraseñas u otros detalles.

= Paso 12: Eliminar imágenes =

Para borrar una imagen, puede hacer:

<syntaxhighlight lang="bash">
podman image rm hello-world
</syntaxhighlight>

= Paso 13: Varios podman a la vez (podman-compose) =

Antes de comenzar, vamos a parar todos los contenedores que tengamos abiertos,
para dejar el entorno de podman limpio, que nos vendrá bien para esta parte.

Cuando queremos ejecutar varios contenedores a la vez y que estén conectados
entre ellos fácilmente, utilizaremos podman-compose, donde con un fichero de
configuración simple en yaml, tendremos toda la configuración de lo que vamos a
ejecutar.

Primero vamos a instalar podman-compose:

<syntaxhighlight lang="bash">
sudo apt install podman-compose
</syntaxhighlight>

Ahora veamos un pequeño ejemplo donde explicaremos todos los detalles para crear
un podman-compose, en este caso, el nombre por defecto de los ficheros suele ser
podman-compose.yml, y el contenido será similar a:

<syntaxhighlight lang="bash">
version: '3'

services:
web:
container_name: web
restart: always
build:
context: .
ports:
- "8000:8000"
volumes:
- /home/ubuntu/volume:/volumen:rw
environment:
USERNAME: test
web2:
container_name: web2
build:
dockerfile: Dockerfile
context: .
depends_on:
- web
command: touch web2
web3:
container_name: web3
restart: on-failure
image: pstauffer/curl
depends_on:
- web
command: curl -X GET web:8000/welcome?username=web3
</syntaxhighlight>

En el podman-compose definimos diferentes servicios a ejecutar, en nuestro caso
hemos iniciado tres servicios diferentes, web, web2 y web3:

El primer servicio, web:

* container_name: para darle un nombre por defecto al contenedor cuando se cree
* restart: pueden ser:
** "no": si la máquina termina, no se vuelve a iniciar (opción por defecto)
** always: siempre que el contenedor termine, intenta iniciarse de nuevo
** on-failure: solo intenta reiniciarse si el contenedor termina con fallo
** unless-stopped: solo reinicia el contenedor si el usuario es el que lo termina
* Utilizará el fichero Dockerfile creado en el paso 11 para generar la imagen a usar.
* Expondrá el puerto 8000 del contenedor en el 8000 de nuestra máquina
* Montará un volumen, se hace de forma similar a la línea de comandos
* Creará una variable de entorno

El segundo servicio, web2:

* Utilizará el fichero Dockerfile también, la diferencia entre este y el primer servicio, es que si el nombre del Dockerfile cambia, tendremos que hacerlo de esta segunda forma, la primera por defecto solo buscará el fichero Dockerfile
* depends_on hará que para ejecutar este servicio, su dependencia tenga ya que estar iniciada
* Ejecutaremos un comando el cual sustituirá al comando de la imagen

El tercer servicio, web3:

* Utilizará la imagen ostauffer/curl que es un imagen mínima que contiene el comando curl
* restart: en este caso, hasta que el comando no se ejecute correctamente, se seguirá reiniciando el contenedor
* depends_on igual que el servicio 2, dependerá del servicio 1
* Ejecutaremos un comando para llamar desde el servicio 3 al servicio 1

== Paso 13.1: Construir podman-compose ==

En el caso de existir servicios que tengan Dockerfiles, esto hará que se construyan previamente, como hacer un podman build de cada uno de los servicios que contenga un Dockerfile:

<syntaxhighlight lang="bash">
podman-compose build
</syntaxhighlight>

Con esto se generarán las imágenes necesarias para ejecutar todos los servicios.

== Paso 13.2: Iniciar podman-compose ==

Para iniciar todos los servicios, ejecutaremos:

<syntaxhighlight lang="bash">
podman-compose up -d
</syntaxhighlight>

Después de esto podremos ver el logs de todos los servicios:

<syntaxhighlight lang="bash">
podman-compose logs -f
</syntaxhighlight>

Aquí veremos que el servicio 3 ha conseguido llamar correctamente al servicio 1.

Ahora veremos como podman-compose ha creado los contenedores:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

La salida será similar a la siguiente:

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
219a4118244c pstauffer/curl "curl -X GET web:800…" 6 seconds ago Exited (0) 3 seconds ago web3
c97e894cb3ae ubuntu_web2 "touch web2" 6 seconds ago Exited (0) 4 seconds ago web2
f35d034204fc ubuntu_web "/bin/sh -c 'hug -f …" 6 seconds ago Up 5 seconds 0.0.0.0:8000->8000/tcp web
</syntaxhighlight>

Aquí vemos varios detalles:

* El nombre que le hemos dado en el podman-compose ha funcionado correctamente
* Vemos que los comandos son los correctos también
* web2 está parado por que la política de reinicio es apagar cuando se termine de ejecutar un comando
* web 3 está parado por que el comando ha terminado con un salida correcta

Vamos a comprobar ahora que en el servicio web está todo correcto:

<syntaxhighlight lang="bash">
podman exec -ti web ash
echo $USERNAME
ls /volumen
exit
</syntaxhighlight>

Podemos comprobar que tanto cambiar la variable de entorno como crear un
volumen ha funcionado correctamente.

== Paso 13.3: Parar podman-compose ==

Para parar todos los servicios:

<syntaxhighlight lang="bash">
podman-compose down
</syntaxhighlight>

Comprobamos:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Vemos que han desaparecido todos los contenedores.

= Paso 14: Ejercicios =

== Ejercicio 1: Variante de httpd ==

Construya una imagen ''httpd-hola-mundo'' a partir de la imagen ''httpd''. El fichero de index.html de la carpeta htdocs/ tiene que mostrar el mensaje "hola mundo".

<syntaxhighlight lang="bash">
docker pull httpd
</syntaxhighlight>

Edita el fichero Dockerfile:

<syntaxhighlight lang="bash">
nano Dockerfile
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
FROM httpd

COPY index.html htdocs/index.html
</syntaxhighlight>

Edita el fichero index.html:

<syntaxhighlight lang="bash">
nano index.html
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

Construye la imagen:

<syntaxhighlight lang="bash">
docker build -t mihttpd -f Dockerfile .
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen:

<syntaxhighlight lang="bash">
sudo docker run --name mihttpd -d -p 8080:80 mihttpd
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código:
<syntaxhighlight lang="bash">
curl -X GET http://localhost:8080
</syntaxhighlight>

Tiene que salir por pantalla esto:
<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

== Ejercicio 2: aplicación flask ==

Flask es un framework python para implementar webs. Cree una imagen "miapp-flask" a partir de la imagen de "python":

* Instale flask mediante: pip install flask
* Cree la carpeta "app"
* Establezca la variable FLASK_APP a "hello.py"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"

El fichero hello.py contiene un "hola mundo" para Flask:

<syntaxhighlight lang="python">
from flask import Flask
app = Flask(__name__)

@app.route("/")
def hello():
return "Hello World!"

if __name__ == "__main__":
app.run()
</syntaxhighlight>

Solución con alpine:

<syntaxhighlight lang="bash">
FROM python:alpine

RUN mkdir /app
RUN pip install flask
ENV FLASK_APP="app/hello.py"
COPY hello.py
WORKDIR /
CMD flask run --host=0.0.0.0
</syntaxhighlight>

Solución con Ubuntu:

<syntaxhighlight lang="bash">
FROM ubuntu:bionic

RUN apt-get update
RUN apt-get -y install python python-pip wget
RUN pip install Flask
ENV FLASK_APP="app/hello.py"
RUN mkdir /app
COPY hello.py /app
CMD flask run --host=0.0.0.0
</syntaxhighlight>

== Ejercicio 3: mysql ==

'''EN LA MÁQUINA VIRTUAL:'''

mkdir miapp

cd miapp

sudo docker pull mysql

nano Dockerfile

<syntaxhighlight lang="bash">
FROM mysql
ENV MYSQL_ROOT_PASSWORD="lacontraseñaqueyoquiera"
RUN mkdir /app
WORKDIR /app

</syntaxhighlight>

CTRL+O , ENTER Y CTRL+X (para guardar Dockerfile y salir)

sudo docker build -ti mrfdocker -f Dockerfile .

sudo docker run --name mymrf --rm -p 8001:3306 mrfdocker

sudo docker images

'''EN LA TERMINAL DEL HOST:'''

''Instalación de mysql:''

sudo apt install mysql-client-core-5.7

> sudo apt-get install mysql-server

> sudo service mysql start

''Para entrar:''

sudo mysql -u root -p -P 8001

Una vez dentro de msql:

mysql> show databases;
''
Para salir:''

exit

== Ejercicio 5: python pyramid ==

Pyramid es un framework python para implementar webs. Cree una imagen "miapp-pyramid":

* Emplee la imagen de Ubuntu como referencia, instale los paquetes python y python-pip.
* Instale Pyramid mediante: pip install pyramid
* Cree la carpeta "app"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"
* La aplicación se lanza con la orden: python hello.py
* Compruebe que funciona con curl, la ruta a la web es http://127.0.0.1:8000/hello, suponiendo que ha empleado el puerto 8000 para exponer el servicio.

El fichero hello.py contiene un "hola mundo" para Pyramid:

<syntaxhighlight lang="bash">
from wsgiref.simple_server import make_server
from pyramid.config import Configurator
from pyramid.response import Response

def hello_world(request):
print('Request inbound!')
return Response('Docker works with Pyramid!')

if __name__ == '__main__':
config = Configurator()
config.add_route('hello', '/')
config.add_view(hello_world, route_name='hello')
app = config.make_wsgi_app()
server = make_server('0.0.0.0', 6543, app)
server.serve_forever()
</syntaxhighlight>

Este programa recibe peticiones en el puerto 6543.

== Ejercicio 6 ==

Cree una imagen derivada de Ubuntu, instale el paquete apache2, php y libapache2-mod-php.
Active el módulo de php para apache2 mediante la orden:

<syntaxhighlight lang="bash">
a2enmod php
</syntaxhighlight>

Cree la carpeta /var/www/php.

Cree el fichero index.php

<syntaxhighlight lang="php">
<?php
Print "Hello, World!";
?>
</syntaxhighlight>

y copielo a /var/www/php/.

Cree el fichero 000-default.conf y copielo a /etc/apache2/sites-enabled/

Dicho fichero contiene.

<syntaxhighlight lang="bash">
<VirtualHost *:80>
DocumentRoot /var/www/php

<Directory /var/www/php/>
Options Indexes FollowSymLinks MultiViews
AllowOverride All
Order deny,allow
Allow from all
</Directory>

ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>
</syntaxhighlight>

Tiene que lanzar apache con la orden: apachectl -D FOREGROUND

Tras crear la imagen, láncela mapeando el puerto 8888 al 80, pruebe que puede acceder a http://127.0.0.1:8888/php/ mediante curl

Solución:

<syntaxhighlight lang="bash">
FROM ubuntu:latest

RUN apt-get update
RUN apt-get install -y tzdata
RUN apt-get install -y apache2
RUN apt-get install -y php
RUN apt-get install -y libapache2-mod-php
RUN a2enmod php7.2
COPY index.php /var/www/php
COPY 000-default.conf /etc/apache2/sites-enabled/
CMD apachectl -D FOREGROUND
</syntaxhighlight>

Y para lanzarlo:

docker run --name my-app --rm -d -p 8001:8000 app:v1

y para probarlo:

curl -X GET http://127.0.0.1:8888/php/

== Ejercicio 7 ==

Instale el paquete ''netcat-traditional'' en una imagen de contenedor de ''ubuntu''. Lance la orden:

nc -u -l -p 8080

en el contenedor. Asegúrese de crear una redirección de puertos de 9999 desde el ''host'' al puerto 8080 en el contenedor.

Desde fuera del contenedor, pruebe a conectarse con:

nc -u 127.0.0.1 9999

== Ejercicio 8 ==

Cree una imagen derivada de "ubuntu" con un Dockerfile que incluya soporte de python y lance el siguiente código en Python:

<syntax lang="python">
from http.server import BaseHTTPRequestHandler, HTTPServer
import time

hostName = "0.0.0.0"
serverPort = 8080

class MyServer(BaseHTTPRequestHandler):
def do_GET(self):
self.send_response(200)
self.send_header("Content-type", "text/html")
self.end_headers()
self.wfile.write(bytes("<html><head><title>Welcome!</title></head>", "utf-8"))
self.wfile.write(bytes("<body>", "utf-8"))
self.wfile.write(bytes("This is an example web server.", "utf-8"))
self.wfile.write(bytes("</body></html>", "utf-8"))

if __name__ == "__main__":
webServer = HTTPServer((hostName, serverPort), MyServer)
print("Server started http://%s:%s" % (hostName, serverPort))

try:
webServer.serve_forever()
except KeyboardInterrupt:
pass

webServer.server_close()
print("Server stopped.")
</syntax>

Llame a su imagen "python-http-server". Lance una instancia de la imagen "python-http-server" mapeando el puerto 9999 al puerto 8888/tcp del contenedor. Compruebe con:

<syntax lang="bash">
curl http://127.0.0.1:9999/
</syntax>

que muestre la página HTML que ofrece el servidor, que debería ser:

<syntax lang="bash">
<html><head><title>Welcome!</title></head><body>This is an example web server.</body></html>
</syntax>

Contenedores

2025-12-09T11:30:52Z

Pneira: /* Paso 9: Ejecutar un comando dentro de un contenedor en ejecución */

En esta práctica aprenderemos a utilizar [https://es.wikipedia.org/wiki/Podman podman] para desplegar contenedores.

= Paso 1: Instalar podman =

Para instalar el paquete oficial:

<syntaxhighlight lang="bash">
apt install podman
</syntaxhighlight>

podman es un clon de '''docker''.

= Paso 2: Repositorio de imágenes de contenedores DockerHub =

Docker ofrece un servicio de nube denominado ''DockerHub'' que puede ser empleado como red social para compartir tus imágenes de Podman. En ''DockerHub'' existen además imágenes de contenedores preconfiguradas de software, muchas de ellas oficiales (ofrecidas por el propio fabricante del software) que se podrán emplear como base para construir nuevas imágenes adaptadas a nuestras necesidades.

Podremos realizar búsquedas en este repositorio ''DockerHub'' puedes emplear el siguiente comando:

<syntaxhighlight lang="bash">
podman search docker.io/library/hello-world
</syntaxhighlight>

Para descargarnos la imagen de ''hello-world'' podemos usar la orden ''pull'':

<syntaxhighlight lang="bash">
podman pull hello-world
</syntaxhighlight>

También podemos publicar imágenes propias, esto require '''registro de usuario''' en la nube de ''DockerHub'', lo que '''no''' es obligatorio para la realización de esta práctica. Para subir una imagen, hay que validarse como usuario en la nube de ''DockerHub'':

<syntaxhighlight lang="bash">
podman login
</syntaxhighlight>

Tras introducir tu usuario y contraseña, puedes comenzar a publicar tus propias imágenes.

<syntaxhighlight lang="bash">
podman push MI_IMAGEN
</syntaxhighlight>

Este paso es '''opcional''', sólo en caso de que se quieran subir imágenes de contenedores a la nube de docker.io.

= Paso 4: Comprobar imágenes en nuestra máquina =

Para ver las imágenes que tenemos en nuestra máquina, utilizaremos el comando:

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Inicialmente, no tenemos imágenes en almacenamiento, podemos descargarnos la imagen oficial de Debian 13 (Trixie):

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian
</syntaxhighlight>

Ahora si, ya debería de aparecernos la imagen ''debian''.

Comentar también que cada imagen puede tener varias etiquetas, por ejemplo, la imagen Debian 12 (Bookworm), cuando la hemos visto en el listado de imágenes, venía con el tag latest, que es el tag que se descarga por defecto, pero nosotros podemos especificar otro, por ejemplo:

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian:bookworm
</syntaxhighlight>

Para traernos la versión de la imagen de Debian 12 ''Bookworm''.

Ahora tendremos dos imágenes con diferente etiqueta, que serían como las diferentes versiones de cada imagen.

= Paso 5: Lanzar un contenedor =

Un contenedor no es más que una imagen de podman ejecutándose, sería similar a
una máquina virtual, aunque mucho más liviano.

Para crear un contenedor, utilizaremos una imagen, en este caso, la imagen
hello-world. Hacemos lo siguiente:

<syntaxhighlight lang="bash">
podman run hello-world
</syntaxhighlight>

Esto nos mostrará el siguiente mensaje si todo está correcto:

<syntaxhighlight lang="bash">
Hello from Docker!
This message shows that your installation appears to be working correctly.

To generate this message, Docker took the following steps:
1. The Docker client contacted the Docker daemon.
2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
(amd64)
3. The Docker daemon created a new container from that image which runs the
executable that produces the output you are currently reading.
4. The Docker daemon streamed that output to the Docker client, which sent it
to your terminal.

To try something more ambitious, you can run an Debian container with:
$ podman run -it debian bash

Share images, automate workflows, and more with a free Docker ID:
https://hub.docker.com/

For more examples and ideas, visit:
https://docs.docker.com/get-started/
</syntaxhighlight>

Al crear los contenedores utilizando el comando 'run', tenemos varias opciones:

* Lanzar una terminal en el contenedor en modo interactivo
* Lanzar en segundo plano y conectarnos posteriormente al contenedor

== Paso 5.1: Lanzar una terminal en el contenedor en modo interactivo (-ti) ==

Para este ejemplo vamos a utilizar otra imagen diferente, en este caso vamos a utilizar una imagen de debian.

Vamos a lanzar un contenedor y ejecutar una terminal en el que se va a ejecutar el programa '''bash''' que me ofrece un interprete de órdenes:

<syntaxhighlight lang="bash">
podman run -ti debian bash
</syntaxhighlight>

La opción ''-t'' indica que se crea un terminal en el contenedor. Y la opción ''-i'' indica que el contenedor se ejecuta en modo interactivo.

Al acceder al contenedor de ''debian'' nos aparece un ''hash'' en el prompt de la shell, que identifica a la instancia del contenedor (es valor es similar al que muestra la orden ''podman container ls'').

Para salir del contenedor, escribimos 'exit' o pulsamos ''CTRL + D''

== Paso 5.2 Lanzar en segundo plano (-d) ==

Otro ejemplo, con la imagen de Debian:

<syntaxhighlight lang="bash">
podman run -dti debian
</syntaxhighlight>

que muestra un hash que identifica de forma única el contenedor lanzado:

<syntaxhighlight lang="bash">
2ec1daae4676a4e84dc04fd91399c1dfe92119544ff12ee307991fe573d3db64
</syntaxhighlight>

Mediante el comando ''attach'' puedo entrar al contenedor:

<syntaxhighlight lang="bash">
podman attach 2ec1daae4676
</syntaxhighlight>

Para salir, pulsamos ''CTRL + P'' seguido de ''CTRL + Q''.

De manera similar, puedo lanzar en segundo plano la imagen de contenedor de ''hello-world'':

<syntaxhighlight lang="bash">
podman run -d hello-world
</syntaxhighlight>

Y consultar los logs:

<syntaxhighlight lang="bash">
podman logs b67fae3312bc321
</syntaxhighlight>

== Paso 5.3: Añadir variables de entorno a un contenedor ==

Utilizaremos la imagen anterior, y vamos a añadir una variable de entorno
llamada TEST que contenga el valor 'test'. A parte, también ejecutaremos la
terminal como antes, para comprobar con el comando echo, que la variable de
entorno está creada correctamente:

<syntaxhighlight lang="bash">
podman run -ti -e TEST=test debian bash
</syntaxhighlight>

Ahora, desde el contenedor podemos comprobar el valor de la variable de entorno ''$TEST''.

<syntaxhighlight lang="bash">
echo $TEST
test
</syntaxhighlight>

= Paso 6: Listar contenedores en ejecución =

Hemos estado haciendo pruebas y ejecutando contenedores en el paso anterior, vamos a ver donde se encuentran estos contenedores que hemos ejecutado, y después veremos algunas opciones más del comando run.

Tenemos dos opciones para ver los contenedores:

<syntaxhighlight lang="bash">
podman container ls -a
</syntaxhighlight>

o la versión corta:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Ambas hacen lo mismo, y debería de mostrarnos una salida similar a la siguiente:

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
e2bde5f5500c debian "bash" 6 minutes ago Exited (0) 2 seconds ago pensive_sammet
544ad27dbc3c debian "bash" 7 minutes ago Exited (0) 7 minutes ago serene_elgamal
</syntaxhighlight>

En la información veremos que el contenedor tiene el estado exited, eso quiere decir que no se está ejecutando y ya ha finalizado. Vamos a hacer una prueba para ver un contendor ejecutándose:

<syntaxhighlight lang="bash">
podman run -d debian sleep 30
</syntaxhighlight>

Con el comando sleep 30 esperamos 30 segundos hasta que termine el comando, asíque durante esos 30 segundos, el contenedor estará ejecutándose, veámoslo:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
eacceb27d52d debian "sleep 30" 12 seconds ago Up 11 seconds sharp_pasteur
</syntaxhighlight>

Vamos a ver alguna opciones más de la orden ''run''.

== Paso 6.1: Dar un nombre al contenedor (--name) ==

Por defecto, podman creará automáticamente un nombre como hemos visto en las salidas del comando ''podman ps -a''. Podemos establecer el nombre del contenedor que queramos con la opción ''--name'':

<syntaxhighlight lang="bash">
podman run -ti --name mi_debian debian
</syntaxhighlight>

== Paso 6.2: Eliminar contenedor cuando termine (--rm) ==

Vamos a mezclar todo lo visto anteriormente:

* Lanzar en segundo plano (-d)
* Ejecutar contenedor durante 30 segundos (sleep 30)
* Dar un nombre a la imagen (--name)
* Eliminar contenedor cuando termine (--rm)

<syntaxhighlight lang="bash">
podman run -d --rm --name bye-bye debian sleep 30
</syntaxhighlight>

Antes y una vez pasados los 30 segundos, podemos comprobar que el contenedor ha desaparecido.

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

= Paso 7: Parar y eliminar contenedores =

Los contenedores podemos pararlos o eliminarlos, veamos como hacerlo. Antes que
nada, borraremos todos los contenedores que estén terminados, para ello:

<syntaxhighlight lang="bash">
podman container prune
podman ps -a
</syntaxhighlight>

Ya lo hemos dejado todo limpio para seguir, ahora vamos a crear un contenedor,
utilizando un comando de linux que no termina, para que así se quede
ejecutándose el contenedor infinitamente:

<syntaxhighlight lang="bash">
podman run -d -ti --name my_container debian bash
podman ps -a
</syntaxhighlight>

Vamos a pararlo (podemos utilizar el nombre dado o el id):

<syntaxhighlight lang="bash">
podman stop my_container
podman stop e4901956f108
podman ps -a
</syntaxhighlight>

Veremos que ya ha terminado, y ahora vamos a eliminarlo, pero solo este
contenedor, no como previamente que eliminamos todos. Lo mismo que para pararlo,
podemos utilizar el nombre o el id.

<syntaxhighlight lang="bash">
podman container rm my_container
podman container rm my_container
podman ps -a
</syntaxhighlight>

Veremos que ya no tenemos el contenedor y está correctamente eliminado.

= Paso 8: Conectarnos a un contenedor que se está ejecutando en segundo plano =

Vamos a ejecutar de nuevo un contenedor que no termine:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a conectarnos a este contenedor que está ejecutándose en segundo
plano:

<syntaxhighlight lang="bash">
podman attach mi-contenedor
</syntaxhighlight>

Veremos la orden bash ejecutándose, para terminar, hacemos un 'CTRL + C', y ahora, veremos que ha pasado con el contenedor:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Lo veremos parado, por que lo que hemos hecho ha sido conectarnos al contenedor
y parar el comando que se estaba ejecutando, así que ahora tenemos el contenedor
finalizado.

''Nota:'' Para salir del contenedor '''sin detenerlo''' hacemos 'CTRL + P' seguido 'CTRL + Q'

= Paso 9: Ejecutar un comando dentro de un contenedor en ejecución =

Vamos a ver otresta vez como ejecutar un comando en un contenedor que ya está
ejecutándose:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a ejecutar un comando en ese contenedor con el nombre ''mi-contenedor''.
El comando exec es similar al comando run, pero para ejecutar un comando dentro de un contenedor:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor ls
</syntaxhighlight>

Para redirigir la salida a un fichero en el anfitrión:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor ls > x.txt
</syntaxhighlight>

Para redirigir la salida a un fichero ''dentro'' del contenedor, hacemos:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor bash -c "ls > x.txt"
</syntaxhighlight>

= Paso 10: Persistencia en contenedores =

Al hacer ''exit'' y salir de un contenedor, se pierden todos los cambios que hemos realizado. Los

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-ejemplo debian bash
</syntaxhighlight>

Ahora, vamos a crear una carpeta en el contenedor y comprobar que esa carpeta existe:

<syntaxhighlight lang="bash">
podman exec mi-ejemplo mkdir test
podman exec mi-ejemplo ls
</syntaxhighlight>

Veremos que la carpeta existe, pero, ¿qué ocurre si para el contenedor?

<syntaxhighlight lang="bash">
podman container stop mi-ejemplo
</syntaxhighlight>

Y volvemos a lanzarlo:

<syntaxhighlight lang="bash">
podman container rm mi-ejemplo
podman run -d -ti --name mi-ejemplo debian bash
podman exec mi-ejemplo ls
</syntaxhighlight>

Podemos comprobar que la carpeta creada anteriormente, no existe.

¿Qué podemos hacer para mantener la modificaciones realizadas sobre un contenedor?

== Paso 10.1: Crear una imagen derivada de la imagen base ==

Es posible crear una imagen derivada, con modificaciones, a partir de una imagen existente mediante la orden '''commit'''.

Por ejemplo, si queremos una imagen ''debian'' que incluya el programa ''ping'' ya instalado, tendríamos que lanzar un contenedor a partir de la imagen ''ubuntu'':

<syntaxhighlight lang="bash">
podman run -d -ti debian bash
</syntaxhighlight>

Suponiendo que el contenido está identificado con el ID 56ef5b312334

Instalamos el paquete ping:

<syntaxhighlight lang="bash">
podman exec 56ef5b312334 apt -y install ping
</syntaxhighlight>

Generamos la imagen derivada con el nombre ''ubuntu-con-ping'':

<syntaxhighlight lang="bash">
podman commit 56ef5b312334 ubuntu-con-ping
</syntaxhighlight>

Ya podemos para nuestro contendor:

<syntaxhighlight lang="bash">
podman stop 56ef5b312334
</syntaxhighlight>

Y lanzar un nuevo contenedor a partir de la imagen ''debian-con-ping'':

<syntaxhighlight lang="bash">
podman run -d -ti debian-con-ping bash
</syntaxhighlight>

== Paso 10.2: Mantener la persistencia mediante volúmen ==

Otra opción para mantener los datos es montar un volumen al ejecutar el contenedor.

Primero crearemos una carpeta que hará de volumen en nuestra máquina, que será la que luego montemos para podman:

<syntaxhighlight lang="bash">
mkdir /home/debian/volumen
</syntaxhighlight>

Ahora vamos a montar la carpeta al ejecutar el contenedor, lo hacemos con la
opción -v, la cual tiene 3 campos separados por ':':

# El volumen en nuestra máquina
# Donde se montará el volumen dentro del contenedor
# Opciones de mmontaje, por ejemplo rw (read and write) o ro (read only)

<syntaxhighlight lang="bash">
podman run --rm -ti -v /home/debian/volumen:/volumen:rw debian bash
mkdir /volumen/test
touch /volumen/test/file
exit
</syntaxhighlight>

Una vez nos salgamos del contenedor, podemos ver que en nuestra máquina están
los datos:

<syntaxhighlight lang="bash">
ls /home/ubuntu/volumen/
ls /home/ubuntu/volumen/test
</syntaxhighlight>

La próxima vez que ejecutemos un contenedor, si montamos ese volumen, los datos
estarán ahí, además esta forma tiene el beneficio de compartir datos entre
nuestra máquina y el contenedor de forma sencilla.

= Paso 11: Crear nuestra propia imagen de contenedor =

Para crear una imagen de un contenedor con una aplicación de Python hug, creamos en primer lugar la carpeta que contendrá los ficheros que nos permiten crear la imagen.

<syntaxhighlight lang="bash">
mkdir miapp
cd miapp
</syntaxhighlight>

Definimos un fichero ''Dockerfile'' para definir la imagen:

<syntaxhighlight lang="bash">
FROM ubuntu

RUN apt -y update
RUN apt -y upgrade
RUN apt -y install python3-hug
RUN mkdir /app
COPY endpoint.py /app
WORKDIR /app
CMD hug -f endpoint.py
</syntaxhighlight>

Alternativamente, puedes crear un [[Creando imagen propia usando Ubuntu de base|Dockerfile empleando la imagen de Ubuntu]] como base en lugar de Alpine.

Y añadimos el fichero ''endpoint.py'' que emplea el framework Python hug con el contenido siguiente:

<syntaxhighlight lang="bash">
import hug

@hug.get('/welcome')
def welcome(username="unknown"):
""" Say welcome to username """
return "Welcome " + username
</syntaxhighlight>

Este fichero es un ejemplo de uso de Python hug. Si hacemos una petición a /welcome?username="LSO", esto nos devolverá el mensaje "Welcome LSO".

Una vez tengamos los dos ficheros creados en nuestra máquina virtual, podemos construir nuestra imagen:

<syntaxhighlight lang="bash">
podman build -t app:v1 -f Dockerfile .
</syntaxhighlight>

Vamos a explicar para que sirve cada línea:

* FROM: servirá para basarnos en una imagen existente, en este caso, una imagen de python alpine, que contiene python y no ocupa mucho espacio
* ENV: para crear variables de entorno
* RUN: para ejecutar comandos, ya sea para crear una carpeta, instalar dependencias o cualquier otra opción que necesitemos
* COPY: para copiar datos desde nuestra máquina a la imagen
* WORKDIR: para cambiar el directorio de trabajo
* CMD: este comando será ejecutado por defecto al iniciar un contenedor a partir de esta imagen

Esto construirá una imagen podman basada en python:alpine, en la cual hemos
guardado nuestra pequeña aplicación y se va a ejecutar cuando ejecutemos un
contenedor basado en esa imagen. Para comprobar que la imagen se ha creado
correctamente, listamos las imagenes, y debería de aparecernos una imagen con
nombre 'app' y tag 'v1':

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen, y vamos a añadir una nueva
opción, -p 8001:8000. Esta opción hará que el puerto interno 8000 del contenedor
sea expuesto en el puerto 8001 de nuestra máquina:

<syntaxhighlight lang="bash">
podman run --name my-app --rm -d -p 8001:8000 app:v1
</syntaxhighlight>

''Nota:'' podman supone que la redirección de puerto es TCP, para una redirección de puertos UDP, puedes usar:

<syntaxhighlight lang="bash">
... -p 8001:8000/udp
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código. En nuestra
máquina haremos:

<syntaxhighlight lang="bash">
curl -X GET http://localhost:8001/welcome?username=LSO
</syntaxhighlight>

Comprobaremos que la salida del comando curl, es "Welcome LSO".

Antes de terminar, vamos a comprobar otro pequeño detalle que añadimos en
nuestra imagen, la variable de entorno USERNAME, vamos a comprobar que funciona:

<syntaxhighlight lang="bash">
podman exec -ti my-app ash
echo $USERNAME
</syntaxhighlight>

Funciona correctamente, pero al ejecutar el contenedor, podemos cambiar esta
variable de entorno como vimos en uno de los pasos anteriores:

<syntaxhighlight lang="bash">
podman run --rm -ti -e USERNAME=me app:v1 ash
echo $USERNAME
</syntaxhighlight>

Esto nos servirá para tener opciones por defecto y que el usuario pueda
cambiarlo a su antojo, como por ejemplo contraseñas u otros detalles.

= Paso 12: Eliminar imágenes =

Veremos que después de todas las pruebas que hemos estado haciendo, tenemos
muchas imágenes, y algunas de las cuales no nos servirán o no las utilizaremos,
así que podemos borrarlas para ahorrar espacio.

Al igual que con los contenedores, tenemos una opción para borrar imágenes que
no se utilicen:

<syntaxhighlight lang="bash">
podman image prune
</syntaxhighlight>

Esto borrará imágenes intermedias que se utilizan a veces para construir
nuestras imágenes o imágenes que hemos intentado construir y nos han fallado.

La otra opción para borrar imágenes una a una, sería utilizando el comando
podman rmi y utilizar el nombre de la imagen o el id. Si esta es la salida de
'podman images':

<syntaxhighlight lang="bash">
REPOSITORY TAG IMAGE ID CREATED SIZE
app v1 18609c517d32 14 minutes ago 109MB
python alpine 39fb80313465 23 hours ago 98.7MB
debian latest 85c4fd36a543 13 days ago 114MB
hello-world latest fce289e99eb9 7 months ago 1.84kB
hello-world linux fce289e99eb9 7 months ago 1.84kB
</syntaxhighlight>

Podemos eliminar las imágenes de hello-world:

<syntaxhighlight lang="bash">
podman rmi hello-world
</syntaxhighlight>

ó

<syntaxhighlight lang="bash">
podman rmi fce289e99eb9
</syntaxhighlight>

= Paso 13: Varios podman a la vez (podman-compose) =

Antes de comenzar, vamos a parar todos los contenedores que tengamos abiertos,
para dejar el entorno de podman limpio, que nos vendrá bien para esta parte.

Cuando queremos ejecutar varios contenedores a la vez y que estén conectados
entre ellos fácilmente, utilizaremos podman-compose, donde con un fichero de
configuración simple en yaml, tendremos toda la configuración de lo que vamos a
ejecutar.

Primero vamos a instalar podman-compose:

<syntaxhighlight lang="bash">
sudo apt install podman-compose
</syntaxhighlight>

Ahora veamos un pequeño ejemplo donde explicaremos todos los detalles para crear
un podman-compose, en este caso, el nombre por defecto de los ficheros suele ser
podman-compose.yml, y el contenido será similar a:

<syntaxhighlight lang="bash">
version: '3'

services:
web:
container_name: web
restart: always
build:
context: .
ports:
- "8000:8000"
volumes:
- /home/ubuntu/volume:/volumen:rw
environment:
USERNAME: test
web2:
container_name: web2
build:
dockerfile: Dockerfile
context: .
depends_on:
- web
command: touch web2
web3:
container_name: web3
restart: on-failure
image: pstauffer/curl
depends_on:
- web
command: curl -X GET web:8000/welcome?username=web3
</syntaxhighlight>

En el podman-compose definimos diferentes servicios a ejecutar, en nuestro caso
hemos iniciado tres servicios diferentes, web, web2 y web3:

El primer servicio, web:

* container_name: para darle un nombre por defecto al contenedor cuando se cree
* restart: pueden ser:
** "no": si la máquina termina, no se vuelve a iniciar (opción por defecto)
** always: siempre que el contenedor termine, intenta iniciarse de nuevo
** on-failure: solo intenta reiniciarse si el contenedor termina con fallo
** unless-stopped: solo reinicia el contenedor si el usuario es el que lo termina
* Utilizará el fichero Dockerfile creado en el paso 11 para generar la imagen a usar.
* Expondrá el puerto 8000 del contenedor en el 8000 de nuestra máquina
* Montará un volumen, se hace de forma similar a la línea de comandos
* Creará una variable de entorno

El segundo servicio, web2:

* Utilizará el fichero Dockerfile también, la diferencia entre este y el primer servicio, es que si el nombre del Dockerfile cambia, tendremos que hacerlo de esta segunda forma, la primera por defecto solo buscará el fichero Dockerfile
* depends_on hará que para ejecutar este servicio, su dependencia tenga ya que estar iniciada
* Ejecutaremos un comando el cual sustituirá al comando de la imagen

El tercer servicio, web3:

* Utilizará la imagen ostauffer/curl que es un imagen mínima que contiene el comando curl
* restart: en este caso, hasta que el comando no se ejecute correctamente, se seguirá reiniciando el contenedor
* depends_on igual que el servicio 2, dependerá del servicio 1
* Ejecutaremos un comando para llamar desde el servicio 3 al servicio 1

== Paso 13.1: Construir podman-compose ==

En el caso de existir servicios que tengan Dockerfiles, esto hará que se construyan previamente, como hacer un podman build de cada uno de los servicios que contenga un Dockerfile:

<syntaxhighlight lang="bash">
podman-compose build
</syntaxhighlight>

Con esto se generarán las imágenes necesarias para ejecutar todos los servicios.

== Paso 13.2: Iniciar podman-compose ==

Para iniciar todos los servicios, ejecutaremos:

<syntaxhighlight lang="bash">
podman-compose up -d
</syntaxhighlight>

Después de esto podremos ver el logs de todos los servicios:

<syntaxhighlight lang="bash">
podman-compose logs -f
</syntaxhighlight>

Aquí veremos que el servicio 3 ha conseguido llamar correctamente al servicio 1.

Ahora veremos como podman-compose ha creado los contenedores:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

La salida será similar a la siguiente:

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
219a4118244c pstauffer/curl "curl -X GET web:800…" 6 seconds ago Exited (0) 3 seconds ago web3
c97e894cb3ae ubuntu_web2 "touch web2" 6 seconds ago Exited (0) 4 seconds ago web2
f35d034204fc ubuntu_web "/bin/sh -c 'hug -f …" 6 seconds ago Up 5 seconds 0.0.0.0:8000->8000/tcp web
</syntaxhighlight>

Aquí vemos varios detalles:

* El nombre que le hemos dado en el podman-compose ha funcionado correctamente
* Vemos que los comandos son los correctos también
* web2 está parado por que la política de reinicio es apagar cuando se termine de ejecutar un comando
* web 3 está parado por que el comando ha terminado con un salida correcta

Vamos a comprobar ahora que en el servicio web está todo correcto:

<syntaxhighlight lang="bash">
podman exec -ti web ash
echo $USERNAME
ls /volumen
exit
</syntaxhighlight>

Podemos comprobar que tanto cambiar la variable de entorno como crear un
volumen ha funcionado correctamente.

== Paso 13.3: Parar podman-compose ==

Para parar todos los servicios:

<syntaxhighlight lang="bash">
podman-compose down
</syntaxhighlight>

Comprobamos:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Vemos que han desaparecido todos los contenedores.

= Paso 14: Ejercicios =

== Ejercicio 1: Variante de httpd ==

Construya una imagen ''httpd-hola-mundo'' a partir de la imagen ''httpd''. El fichero de index.html de la carpeta htdocs/ tiene que mostrar el mensaje "hola mundo".

<syntaxhighlight lang="bash">
docker pull httpd
</syntaxhighlight>

Edita el fichero Dockerfile:

<syntaxhighlight lang="bash">
nano Dockerfile
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
FROM httpd

COPY index.html htdocs/index.html
</syntaxhighlight>

Edita el fichero index.html:

<syntaxhighlight lang="bash">
nano index.html
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

Construye la imagen:

<syntaxhighlight lang="bash">
docker build -t mihttpd -f Dockerfile .
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen:

<syntaxhighlight lang="bash">
sudo docker run --name mihttpd -d -p 8080:80 mihttpd
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código:
<syntaxhighlight lang="bash">
curl -X GET http://localhost:8080
</syntaxhighlight>

Tiene que salir por pantalla esto:
<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

== Ejercicio 2: aplicación flask ==

Flask es un framework python para implementar webs. Cree una imagen "miapp-flask" a partir de la imagen de "python":

* Instale flask mediante: pip install flask
* Cree la carpeta "app"
* Establezca la variable FLASK_APP a "hello.py"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"

El fichero hello.py contiene un "hola mundo" para Flask:

<syntaxhighlight lang="python">
from flask import Flask
app = Flask(__name__)

@app.route("/")
def hello():
return "Hello World!"

if __name__ == "__main__":
app.run()
</syntaxhighlight>

Solución con alpine:

<syntaxhighlight lang="bash">
FROM python:alpine

RUN mkdir /app
RUN pip install flask
ENV FLASK_APP="app/hello.py"
COPY hello.py
WORKDIR /
CMD flask run --host=0.0.0.0
</syntaxhighlight>

Solución con Ubuntu:

<syntaxhighlight lang="bash">
FROM ubuntu:bionic

RUN apt-get update
RUN apt-get -y install python python-pip wget
RUN pip install Flask
ENV FLASK_APP="app/hello.py"
RUN mkdir /app
COPY hello.py /app
CMD flask run --host=0.0.0.0
</syntaxhighlight>

== Ejercicio 3: mysql ==

'''EN LA MÁQUINA VIRTUAL:'''

mkdir miapp

cd miapp

sudo docker pull mysql

nano Dockerfile

<syntaxhighlight lang="bash">
FROM mysql
ENV MYSQL_ROOT_PASSWORD="lacontraseñaqueyoquiera"
RUN mkdir /app
WORKDIR /app

</syntaxhighlight>

CTRL+O , ENTER Y CTRL+X (para guardar Dockerfile y salir)

sudo docker build -ti mrfdocker -f Dockerfile .

sudo docker run --name mymrf --rm -p 8001:3306 mrfdocker

sudo docker images

'''EN LA TERMINAL DEL HOST:'''

''Instalación de mysql:''

sudo apt install mysql-client-core-5.7

> sudo apt-get install mysql-server

> sudo service mysql start

''Para entrar:''

sudo mysql -u root -p -P 8001

Una vez dentro de msql:

mysql> show databases;
''
Para salir:''

exit

== Ejercicio 5: python pyramid ==

Pyramid es un framework python para implementar webs. Cree una imagen "miapp-pyramid":

* Emplee la imagen de Ubuntu como referencia, instale los paquetes python y python-pip.
* Instale Pyramid mediante: pip install pyramid
* Cree la carpeta "app"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"
* La aplicación se lanza con la orden: python hello.py
* Compruebe que funciona con curl, la ruta a la web es http://127.0.0.1:8000/hello, suponiendo que ha empleado el puerto 8000 para exponer el servicio.

El fichero hello.py contiene un "hola mundo" para Pyramid:

<syntaxhighlight lang="bash">
from wsgiref.simple_server import make_server
from pyramid.config import Configurator
from pyramid.response import Response

def hello_world(request):
print('Request inbound!')
return Response('Docker works with Pyramid!')

if __name__ == '__main__':
config = Configurator()
config.add_route('hello', '/')
config.add_view(hello_world, route_name='hello')
app = config.make_wsgi_app()
server = make_server('0.0.0.0', 6543, app)
server.serve_forever()
</syntaxhighlight>

Este programa recibe peticiones en el puerto 6543.

== Ejercicio 6 ==

Cree una imagen derivada de Ubuntu, instale el paquete apache2, php y libapache2-mod-php.
Active el módulo de php para apache2 mediante la orden:

<syntaxhighlight lang="bash">
a2enmod php
</syntaxhighlight>

Cree la carpeta /var/www/php.

Cree el fichero index.php

<syntaxhighlight lang="php">
<?php
Print "Hello, World!";
?>
</syntaxhighlight>

y copielo a /var/www/php/.

Cree el fichero 000-default.conf y copielo a /etc/apache2/sites-enabled/

Dicho fichero contiene.

<syntaxhighlight lang="bash">
<VirtualHost *:80>
DocumentRoot /var/www/php

<Directory /var/www/php/>
Options Indexes FollowSymLinks MultiViews
AllowOverride All
Order deny,allow
Allow from all
</Directory>

ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>
</syntaxhighlight>

Tiene que lanzar apache con la orden: apachectl -D FOREGROUND

Tras crear la imagen, láncela mapeando el puerto 8888 al 80, pruebe que puede acceder a http://127.0.0.1:8888/php/ mediante curl

Solución:

<syntaxhighlight lang="bash">
FROM ubuntu:latest

RUN apt-get update
RUN apt-get install -y tzdata
RUN apt-get install -y apache2
RUN apt-get install -y php
RUN apt-get install -y libapache2-mod-php
RUN a2enmod php7.2
COPY index.php /var/www/php
COPY 000-default.conf /etc/apache2/sites-enabled/
CMD apachectl -D FOREGROUND
</syntaxhighlight>

Y para lanzarlo:

docker run --name my-app --rm -d -p 8001:8000 app:v1

y para probarlo:

curl -X GET http://127.0.0.1:8888/php/

== Ejercicio 7 ==

Instale el paquete ''netcat-traditional'' en una imagen de contenedor de ''ubuntu''. Lance la orden:

nc -u -l -p 8080

en el contenedor. Asegúrese de crear una redirección de puertos de 9999 desde el ''host'' al puerto 8080 en el contenedor.

Desde fuera del contenedor, pruebe a conectarse con:

nc -u 127.0.0.1 9999

== Ejercicio 8 ==

Cree una imagen derivada de "ubuntu" con un Dockerfile que incluya soporte de python y lance el siguiente código en Python:

<syntax lang="python">
from http.server import BaseHTTPRequestHandler, HTTPServer
import time

hostName = "0.0.0.0"
serverPort = 8080

class MyServer(BaseHTTPRequestHandler):
def do_GET(self):
self.send_response(200)
self.send_header("Content-type", "text/html")
self.end_headers()
self.wfile.write(bytes("<html><head><title>Welcome!</title></head>", "utf-8"))
self.wfile.write(bytes("<body>", "utf-8"))
self.wfile.write(bytes("This is an example web server.", "utf-8"))
self.wfile.write(bytes("</body></html>", "utf-8"))

if __name__ == "__main__":
webServer = HTTPServer((hostName, serverPort), MyServer)
print("Server started http://%s:%s" % (hostName, serverPort))

try:
webServer.serve_forever()
except KeyboardInterrupt:
pass

webServer.server_close()
print("Server stopped.")
</syntax>

Llame a su imagen "python-http-server". Lance una instancia de la imagen "python-http-server" mapeando el puerto 9999 al puerto 8888/tcp del contenedor. Compruebe con:

<syntax lang="bash">
curl http://127.0.0.1:9999/
</syntax>

que muestre la página HTML que ofrece el servidor, que debería ser:

<syntax lang="bash">
<html><head><title>Welcome!</title></head><body>This is an example web server.</body></html>
</syntax>

Contenedores

2025-12-09T11:29:40Z

Pneira: /* Paso 9: Ejecutar un comando dentro de un contenedor en ejecución */

En esta práctica aprenderemos a utilizar [https://es.wikipedia.org/wiki/Podman podman] para desplegar contenedores.

= Paso 1: Instalar podman =

Para instalar el paquete oficial:

<syntaxhighlight lang="bash">
apt install podman
</syntaxhighlight>

podman es un clon de '''docker''.

= Paso 2: Repositorio de imágenes de contenedores DockerHub =

Docker ofrece un servicio de nube denominado ''DockerHub'' que puede ser empleado como red social para compartir tus imágenes de Podman. En ''DockerHub'' existen además imágenes de contenedores preconfiguradas de software, muchas de ellas oficiales (ofrecidas por el propio fabricante del software) que se podrán emplear como base para construir nuevas imágenes adaptadas a nuestras necesidades.

Podremos realizar búsquedas en este repositorio ''DockerHub'' puedes emplear el siguiente comando:

<syntaxhighlight lang="bash">
podman search docker.io/library/hello-world
</syntaxhighlight>

Para descargarnos la imagen de ''hello-world'' podemos usar la orden ''pull'':

<syntaxhighlight lang="bash">
podman pull hello-world
</syntaxhighlight>

También podemos publicar imágenes propias, esto require '''registro de usuario''' en la nube de ''DockerHub'', lo que '''no''' es obligatorio para la realización de esta práctica. Para subir una imagen, hay que validarse como usuario en la nube de ''DockerHub'':

<syntaxhighlight lang="bash">
podman login
</syntaxhighlight>

Tras introducir tu usuario y contraseña, puedes comenzar a publicar tus propias imágenes.

<syntaxhighlight lang="bash">
podman push MI_IMAGEN
</syntaxhighlight>

Este paso es '''opcional''', sólo en caso de que se quieran subir imágenes de contenedores a la nube de docker.io.

= Paso 4: Comprobar imágenes en nuestra máquina =

Para ver las imágenes que tenemos en nuestra máquina, utilizaremos el comando:

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Inicialmente, no tenemos imágenes en almacenamiento, podemos descargarnos la imagen oficial de Debian 13 (Trixie):

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian
</syntaxhighlight>

Ahora si, ya debería de aparecernos la imagen ''debian''.

Comentar también que cada imagen puede tener varias etiquetas, por ejemplo, la imagen Debian 12 (Bookworm), cuando la hemos visto en el listado de imágenes, venía con el tag latest, que es el tag que se descarga por defecto, pero nosotros podemos especificar otro, por ejemplo:

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian:bookworm
</syntaxhighlight>

Para traernos la versión de la imagen de Debian 12 ''Bookworm''.

Ahora tendremos dos imágenes con diferente etiqueta, que serían como las diferentes versiones de cada imagen.

= Paso 5: Lanzar un contenedor =

Un contenedor no es más que una imagen de podman ejecutándose, sería similar a
una máquina virtual, aunque mucho más liviano.

Para crear un contenedor, utilizaremos una imagen, en este caso, la imagen
hello-world. Hacemos lo siguiente:

<syntaxhighlight lang="bash">
podman run hello-world
</syntaxhighlight>

Esto nos mostrará el siguiente mensaje si todo está correcto:

<syntaxhighlight lang="bash">
Hello from Docker!
This message shows that your installation appears to be working correctly.

To generate this message, Docker took the following steps:
1. The Docker client contacted the Docker daemon.
2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
(amd64)
3. The Docker daemon created a new container from that image which runs the
executable that produces the output you are currently reading.
4. The Docker daemon streamed that output to the Docker client, which sent it
to your terminal.

To try something more ambitious, you can run an Debian container with:
$ podman run -it debian bash

Share images, automate workflows, and more with a free Docker ID:
https://hub.docker.com/

For more examples and ideas, visit:
https://docs.docker.com/get-started/
</syntaxhighlight>

Al crear los contenedores utilizando el comando 'run', tenemos varias opciones:

* Lanzar una terminal en el contenedor en modo interactivo
* Lanzar en segundo plano y conectarnos posteriormente al contenedor

== Paso 5.1: Lanzar una terminal en el contenedor en modo interactivo (-ti) ==

Para este ejemplo vamos a utilizar otra imagen diferente, en este caso vamos a utilizar una imagen de debian.

Vamos a lanzar un contenedor y ejecutar una terminal en el que se va a ejecutar el programa '''bash''' que me ofrece un interprete de órdenes:

<syntaxhighlight lang="bash">
podman run -ti debian bash
</syntaxhighlight>

La opción ''-t'' indica que se crea un terminal en el contenedor. Y la opción ''-i'' indica que el contenedor se ejecuta en modo interactivo.

Al acceder al contenedor de ''debian'' nos aparece un ''hash'' en el prompt de la shell, que identifica a la instancia del contenedor (es valor es similar al que muestra la orden ''podman container ls'').

Para salir del contenedor, escribimos 'exit' o pulsamos ''CTRL + D''

== Paso 5.2 Lanzar en segundo plano (-d) ==

Otro ejemplo, con la imagen de Debian:

<syntaxhighlight lang="bash">
podman run -dti debian
</syntaxhighlight>

que muestra un hash que identifica de forma única el contenedor lanzado:

<syntaxhighlight lang="bash">
2ec1daae4676a4e84dc04fd91399c1dfe92119544ff12ee307991fe573d3db64
</syntaxhighlight>

Mediante el comando ''attach'' puedo entrar al contenedor:

<syntaxhighlight lang="bash">
podman attach 2ec1daae4676
</syntaxhighlight>

Para salir, pulsamos ''CTRL + P'' seguido de ''CTRL + Q''.

De manera similar, puedo lanzar en segundo plano la imagen de contenedor de ''hello-world'':

<syntaxhighlight lang="bash">
podman run -d hello-world
</syntaxhighlight>

Y consultar los logs:

<syntaxhighlight lang="bash">
podman logs b67fae3312bc321
</syntaxhighlight>

== Paso 5.3: Añadir variables de entorno a un contenedor ==

Utilizaremos la imagen anterior, y vamos a añadir una variable de entorno
llamada TEST que contenga el valor 'test'. A parte, también ejecutaremos la
terminal como antes, para comprobar con el comando echo, que la variable de
entorno está creada correctamente:

<syntaxhighlight lang="bash">
podman run -ti -e TEST=test debian bash
</syntaxhighlight>

Ahora, desde el contenedor podemos comprobar el valor de la variable de entorno ''$TEST''.

<syntaxhighlight lang="bash">
echo $TEST
test
</syntaxhighlight>

= Paso 6: Listar contenedores en ejecución =

Hemos estado haciendo pruebas y ejecutando contenedores en el paso anterior, vamos a ver donde se encuentran estos contenedores que hemos ejecutado, y después veremos algunas opciones más del comando run.

Tenemos dos opciones para ver los contenedores:

<syntaxhighlight lang="bash">
podman container ls -a
</syntaxhighlight>

o la versión corta:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Ambas hacen lo mismo, y debería de mostrarnos una salida similar a la siguiente:

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
e2bde5f5500c debian "bash" 6 minutes ago Exited (0) 2 seconds ago pensive_sammet
544ad27dbc3c debian "bash" 7 minutes ago Exited (0) 7 minutes ago serene_elgamal
</syntaxhighlight>

En la información veremos que el contenedor tiene el estado exited, eso quiere decir que no se está ejecutando y ya ha finalizado. Vamos a hacer una prueba para ver un contendor ejecutándose:

<syntaxhighlight lang="bash">
podman run -d debian sleep 30
</syntaxhighlight>

Con el comando sleep 30 esperamos 30 segundos hasta que termine el comando, asíque durante esos 30 segundos, el contenedor estará ejecutándose, veámoslo:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
eacceb27d52d debian "sleep 30" 12 seconds ago Up 11 seconds sharp_pasteur
</syntaxhighlight>

Vamos a ver alguna opciones más de la orden ''run''.

== Paso 6.1: Dar un nombre al contenedor (--name) ==

Por defecto, podman creará automáticamente un nombre como hemos visto en las salidas del comando ''podman ps -a''. Podemos establecer el nombre del contenedor que queramos con la opción ''--name'':

<syntaxhighlight lang="bash">
podman run -ti --name mi_debian debian
</syntaxhighlight>

== Paso 6.2: Eliminar contenedor cuando termine (--rm) ==

Vamos a mezclar todo lo visto anteriormente:

* Lanzar en segundo plano (-d)
* Ejecutar contenedor durante 30 segundos (sleep 30)
* Dar un nombre a la imagen (--name)
* Eliminar contenedor cuando termine (--rm)

<syntaxhighlight lang="bash">
podman run -d --rm --name bye-bye debian sleep 30
</syntaxhighlight>

Antes y una vez pasados los 30 segundos, podemos comprobar que el contenedor ha desaparecido.

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

= Paso 7: Parar y eliminar contenedores =

Los contenedores podemos pararlos o eliminarlos, veamos como hacerlo. Antes que
nada, borraremos todos los contenedores que estén terminados, para ello:

<syntaxhighlight lang="bash">
podman container prune
podman ps -a
</syntaxhighlight>

Ya lo hemos dejado todo limpio para seguir, ahora vamos a crear un contenedor,
utilizando un comando de linux que no termina, para que así se quede
ejecutándose el contenedor infinitamente:

<syntaxhighlight lang="bash">
podman run -d -ti --name my_container debian bash
podman ps -a
</syntaxhighlight>

Vamos a pararlo (podemos utilizar el nombre dado o el id):

<syntaxhighlight lang="bash">
podman stop my_container
podman stop e4901956f108
podman ps -a
</syntaxhighlight>

Veremos que ya ha terminado, y ahora vamos a eliminarlo, pero solo este
contenedor, no como previamente que eliminamos todos. Lo mismo que para pararlo,
podemos utilizar el nombre o el id.

<syntaxhighlight lang="bash">
podman container rm my_container
podman container rm my_container
podman ps -a
</syntaxhighlight>

Veremos que ya no tenemos el contenedor y está correctamente eliminado.

= Paso 8: Conectarnos a un contenedor que se está ejecutando en segundo plano =

Vamos a ejecutar de nuevo un contenedor que no termine:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a conectarnos a este contenedor que está ejecutándose en segundo
plano:

<syntaxhighlight lang="bash">
podman attach mi-contenedor
</syntaxhighlight>

Veremos la orden bash ejecutándose, para terminar, hacemos un 'CTRL + C', y ahora, veremos que ha pasado con el contenedor:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Lo veremos parado, por que lo que hemos hecho ha sido conectarnos al contenedor
y parar el comando que se estaba ejecutando, así que ahora tenemos el contenedor
finalizado.

''Nota:'' Para salir del contenedor '''sin detenerlo''' hacemos 'CTRL + P' seguido 'CTRL + Q'

= Paso 9: Ejecutar un comando dentro de un contenedor en ejecución =

Vamos a ver otresta vez como ejecutar un comando en un contenedor que ya está
ejecutándose:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a ejecutar un comando en ese contenedor con el nombre ''mi-contenedor''.
El comando exec es similar al comando run, pero para ejecutar un comando dentro de un contenedor:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor ls
</syntaxhighlight>

= Paso 10: Persistencia en contenedores =

Al hacer ''exit'' y salir de un contenedor, se pierden todos los cambios que hemos realizado. Los

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-ejemplo debian bash
</syntaxhighlight>

Ahora, vamos a crear una carpeta en el contenedor y comprobar que esa carpeta existe:

<syntaxhighlight lang="bash">
podman exec mi-ejemplo mkdir test
podman exec mi-ejemplo ls
</syntaxhighlight>

Veremos que la carpeta existe, pero, ¿qué ocurre si para el contenedor?

<syntaxhighlight lang="bash">
podman container stop mi-ejemplo
</syntaxhighlight>

Y volvemos a lanzarlo:

<syntaxhighlight lang="bash">
podman container rm mi-ejemplo
podman run -d -ti --name mi-ejemplo debian bash
podman exec mi-ejemplo ls
</syntaxhighlight>

Podemos comprobar que la carpeta creada anteriormente, no existe.

¿Qué podemos hacer para mantener la modificaciones realizadas sobre un contenedor?

== Paso 10.1: Crear una imagen derivada de la imagen base ==

Es posible crear una imagen derivada, con modificaciones, a partir de una imagen existente mediante la orden '''commit'''.

Por ejemplo, si queremos una imagen ''debian'' que incluya el programa ''ping'' ya instalado, tendríamos que lanzar un contenedor a partir de la imagen ''ubuntu'':

<syntaxhighlight lang="bash">
podman run -d -ti debian bash
</syntaxhighlight>

Suponiendo que el contenido está identificado con el ID 56ef5b312334

Instalamos el paquete ping:

<syntaxhighlight lang="bash">
podman exec 56ef5b312334 apt -y install ping
</syntaxhighlight>

Generamos la imagen derivada con el nombre ''ubuntu-con-ping'':

<syntaxhighlight lang="bash">
podman commit 56ef5b312334 ubuntu-con-ping
</syntaxhighlight>

Ya podemos para nuestro contendor:

<syntaxhighlight lang="bash">
podman stop 56ef5b312334
</syntaxhighlight>

Y lanzar un nuevo contenedor a partir de la imagen ''debian-con-ping'':

<syntaxhighlight lang="bash">
podman run -d -ti debian-con-ping bash
</syntaxhighlight>

== Paso 10.2: Mantener la persistencia mediante volúmen ==

Otra opción para mantener los datos es montar un volumen al ejecutar el contenedor.

Primero crearemos una carpeta que hará de volumen en nuestra máquina, que será la que luego montemos para podman:

<syntaxhighlight lang="bash">
mkdir /home/debian/volumen
</syntaxhighlight>

Ahora vamos a montar la carpeta al ejecutar el contenedor, lo hacemos con la
opción -v, la cual tiene 3 campos separados por ':':

# El volumen en nuestra máquina
# Donde se montará el volumen dentro del contenedor
# Opciones de mmontaje, por ejemplo rw (read and write) o ro (read only)

<syntaxhighlight lang="bash">
podman run --rm -ti -v /home/debian/volumen:/volumen:rw debian bash
mkdir /volumen/test
touch /volumen/test/file
exit
</syntaxhighlight>

Una vez nos salgamos del contenedor, podemos ver que en nuestra máquina están
los datos:

<syntaxhighlight lang="bash">
ls /home/ubuntu/volumen/
ls /home/ubuntu/volumen/test
</syntaxhighlight>

La próxima vez que ejecutemos un contenedor, si montamos ese volumen, los datos
estarán ahí, además esta forma tiene el beneficio de compartir datos entre
nuestra máquina y el contenedor de forma sencilla.

= Paso 11: Crear nuestra propia imagen de contenedor =

Para crear una imagen de un contenedor con una aplicación de Python hug, creamos en primer lugar la carpeta que contendrá los ficheros que nos permiten crear la imagen.

<syntaxhighlight lang="bash">
mkdir miapp
cd miapp
</syntaxhighlight>

Definimos un fichero ''Dockerfile'' para definir la imagen:

<syntaxhighlight lang="bash">
FROM ubuntu

RUN apt -y update
RUN apt -y upgrade
RUN apt -y install python3-hug
RUN mkdir /app
COPY endpoint.py /app
WORKDIR /app
CMD hug -f endpoint.py
</syntaxhighlight>

Alternativamente, puedes crear un [[Creando imagen propia usando Ubuntu de base|Dockerfile empleando la imagen de Ubuntu]] como base en lugar de Alpine.

Y añadimos el fichero ''endpoint.py'' que emplea el framework Python hug con el contenido siguiente:

<syntaxhighlight lang="bash">
import hug

@hug.get('/welcome')
def welcome(username="unknown"):
""" Say welcome to username """
return "Welcome " + username
</syntaxhighlight>

Este fichero es un ejemplo de uso de Python hug. Si hacemos una petición a /welcome?username="LSO", esto nos devolverá el mensaje "Welcome LSO".

Una vez tengamos los dos ficheros creados en nuestra máquina virtual, podemos construir nuestra imagen:

<syntaxhighlight lang="bash">
podman build -t app:v1 -f Dockerfile .
</syntaxhighlight>

Vamos a explicar para que sirve cada línea:

* FROM: servirá para basarnos en una imagen existente, en este caso, una imagen de python alpine, que contiene python y no ocupa mucho espacio
* ENV: para crear variables de entorno
* RUN: para ejecutar comandos, ya sea para crear una carpeta, instalar dependencias o cualquier otra opción que necesitemos
* COPY: para copiar datos desde nuestra máquina a la imagen
* WORKDIR: para cambiar el directorio de trabajo
* CMD: este comando será ejecutado por defecto al iniciar un contenedor a partir de esta imagen

Esto construirá una imagen podman basada en python:alpine, en la cual hemos
guardado nuestra pequeña aplicación y se va a ejecutar cuando ejecutemos un
contenedor basado en esa imagen. Para comprobar que la imagen se ha creado
correctamente, listamos las imagenes, y debería de aparecernos una imagen con
nombre 'app' y tag 'v1':

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen, y vamos a añadir una nueva
opción, -p 8001:8000. Esta opción hará que el puerto interno 8000 del contenedor
sea expuesto en el puerto 8001 de nuestra máquina:

<syntaxhighlight lang="bash">
podman run --name my-app --rm -d -p 8001:8000 app:v1
</syntaxhighlight>

''Nota:'' podman supone que la redirección de puerto es TCP, para una redirección de puertos UDP, puedes usar:

<syntaxhighlight lang="bash">
... -p 8001:8000/udp
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código. En nuestra
máquina haremos:

<syntaxhighlight lang="bash">
curl -X GET http://localhost:8001/welcome?username=LSO
</syntaxhighlight>

Comprobaremos que la salida del comando curl, es "Welcome LSO".

Antes de terminar, vamos a comprobar otro pequeño detalle que añadimos en
nuestra imagen, la variable de entorno USERNAME, vamos a comprobar que funciona:

<syntaxhighlight lang="bash">
podman exec -ti my-app ash
echo $USERNAME
</syntaxhighlight>

Funciona correctamente, pero al ejecutar el contenedor, podemos cambiar esta
variable de entorno como vimos en uno de los pasos anteriores:

<syntaxhighlight lang="bash">
podman run --rm -ti -e USERNAME=me app:v1 ash
echo $USERNAME
</syntaxhighlight>

Esto nos servirá para tener opciones por defecto y que el usuario pueda
cambiarlo a su antojo, como por ejemplo contraseñas u otros detalles.

= Paso 12: Eliminar imágenes =

Veremos que después de todas las pruebas que hemos estado haciendo, tenemos
muchas imágenes, y algunas de las cuales no nos servirán o no las utilizaremos,
así que podemos borrarlas para ahorrar espacio.

Al igual que con los contenedores, tenemos una opción para borrar imágenes que
no se utilicen:

<syntaxhighlight lang="bash">
podman image prune
</syntaxhighlight>

Esto borrará imágenes intermedias que se utilizan a veces para construir
nuestras imágenes o imágenes que hemos intentado construir y nos han fallado.

La otra opción para borrar imágenes una a una, sería utilizando el comando
podman rmi y utilizar el nombre de la imagen o el id. Si esta es la salida de
'podman images':

<syntaxhighlight lang="bash">
REPOSITORY TAG IMAGE ID CREATED SIZE
app v1 18609c517d32 14 minutes ago 109MB
python alpine 39fb80313465 23 hours ago 98.7MB
debian latest 85c4fd36a543 13 days ago 114MB
hello-world latest fce289e99eb9 7 months ago 1.84kB
hello-world linux fce289e99eb9 7 months ago 1.84kB
</syntaxhighlight>

Podemos eliminar las imágenes de hello-world:

<syntaxhighlight lang="bash">
podman rmi hello-world
</syntaxhighlight>

ó

<syntaxhighlight lang="bash">
podman rmi fce289e99eb9
</syntaxhighlight>

= Paso 13: Varios podman a la vez (podman-compose) =

Antes de comenzar, vamos a parar todos los contenedores que tengamos abiertos,
para dejar el entorno de podman limpio, que nos vendrá bien para esta parte.

Cuando queremos ejecutar varios contenedores a la vez y que estén conectados
entre ellos fácilmente, utilizaremos podman-compose, donde con un fichero de
configuración simple en yaml, tendremos toda la configuración de lo que vamos a
ejecutar.

Primero vamos a instalar podman-compose:

<syntaxhighlight lang="bash">
sudo apt install podman-compose
</syntaxhighlight>

Ahora veamos un pequeño ejemplo donde explicaremos todos los detalles para crear
un podman-compose, en este caso, el nombre por defecto de los ficheros suele ser
podman-compose.yml, y el contenido será similar a:

<syntaxhighlight lang="bash">
version: '3'

services:
web:
container_name: web
restart: always
build:
context: .
ports:
- "8000:8000"
volumes:
- /home/ubuntu/volume:/volumen:rw
environment:
USERNAME: test
web2:
container_name: web2
build:
dockerfile: Dockerfile
context: .
depends_on:
- web
command: touch web2
web3:
container_name: web3
restart: on-failure
image: pstauffer/curl
depends_on:
- web
command: curl -X GET web:8000/welcome?username=web3
</syntaxhighlight>

En el podman-compose definimos diferentes servicios a ejecutar, en nuestro caso
hemos iniciado tres servicios diferentes, web, web2 y web3:

El primer servicio, web:

* container_name: para darle un nombre por defecto al contenedor cuando se cree
* restart: pueden ser:
** "no": si la máquina termina, no se vuelve a iniciar (opción por defecto)
** always: siempre que el contenedor termine, intenta iniciarse de nuevo
** on-failure: solo intenta reiniciarse si el contenedor termina con fallo
** unless-stopped: solo reinicia el contenedor si el usuario es el que lo termina
* Utilizará el fichero Dockerfile creado en el paso 11 para generar la imagen a usar.
* Expondrá el puerto 8000 del contenedor en el 8000 de nuestra máquina
* Montará un volumen, se hace de forma similar a la línea de comandos
* Creará una variable de entorno

El segundo servicio, web2:

* Utilizará el fichero Dockerfile también, la diferencia entre este y el primer servicio, es que si el nombre del Dockerfile cambia, tendremos que hacerlo de esta segunda forma, la primera por defecto solo buscará el fichero Dockerfile
* depends_on hará que para ejecutar este servicio, su dependencia tenga ya que estar iniciada
* Ejecutaremos un comando el cual sustituirá al comando de la imagen

El tercer servicio, web3:

* Utilizará la imagen ostauffer/curl que es un imagen mínima que contiene el comando curl
* restart: en este caso, hasta que el comando no se ejecute correctamente, se seguirá reiniciando el contenedor
* depends_on igual que el servicio 2, dependerá del servicio 1
* Ejecutaremos un comando para llamar desde el servicio 3 al servicio 1

== Paso 13.1: Construir podman-compose ==

En el caso de existir servicios que tengan Dockerfiles, esto hará que se construyan previamente, como hacer un podman build de cada uno de los servicios que contenga un Dockerfile:

<syntaxhighlight lang="bash">
podman-compose build
</syntaxhighlight>

Con esto se generarán las imágenes necesarias para ejecutar todos los servicios.

== Paso 13.2: Iniciar podman-compose ==

Para iniciar todos los servicios, ejecutaremos:

<syntaxhighlight lang="bash">
podman-compose up -d
</syntaxhighlight>

Después de esto podremos ver el logs de todos los servicios:

<syntaxhighlight lang="bash">
podman-compose logs -f
</syntaxhighlight>

Aquí veremos que el servicio 3 ha conseguido llamar correctamente al servicio 1.

Ahora veremos como podman-compose ha creado los contenedores:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

La salida será similar a la siguiente:

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
219a4118244c pstauffer/curl "curl -X GET web:800…" 6 seconds ago Exited (0) 3 seconds ago web3
c97e894cb3ae ubuntu_web2 "touch web2" 6 seconds ago Exited (0) 4 seconds ago web2
f35d034204fc ubuntu_web "/bin/sh -c 'hug -f …" 6 seconds ago Up 5 seconds 0.0.0.0:8000->8000/tcp web
</syntaxhighlight>

Aquí vemos varios detalles:

* El nombre que le hemos dado en el podman-compose ha funcionado correctamente
* Vemos que los comandos son los correctos también
* web2 está parado por que la política de reinicio es apagar cuando se termine de ejecutar un comando
* web 3 está parado por que el comando ha terminado con un salida correcta

Vamos a comprobar ahora que en el servicio web está todo correcto:

<syntaxhighlight lang="bash">
podman exec -ti web ash
echo $USERNAME
ls /volumen
exit
</syntaxhighlight>

Podemos comprobar que tanto cambiar la variable de entorno como crear un
volumen ha funcionado correctamente.

== Paso 13.3: Parar podman-compose ==

Para parar todos los servicios:

<syntaxhighlight lang="bash">
podman-compose down
</syntaxhighlight>

Comprobamos:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Vemos que han desaparecido todos los contenedores.

= Paso 14: Ejercicios =

== Ejercicio 1: Variante de httpd ==

Construya una imagen ''httpd-hola-mundo'' a partir de la imagen ''httpd''. El fichero de index.html de la carpeta htdocs/ tiene que mostrar el mensaje "hola mundo".

<syntaxhighlight lang="bash">
docker pull httpd
</syntaxhighlight>

Edita el fichero Dockerfile:

<syntaxhighlight lang="bash">
nano Dockerfile
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
FROM httpd

COPY index.html htdocs/index.html
</syntaxhighlight>

Edita el fichero index.html:

<syntaxhighlight lang="bash">
nano index.html
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

Construye la imagen:

<syntaxhighlight lang="bash">
docker build -t mihttpd -f Dockerfile .
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen:

<syntaxhighlight lang="bash">
sudo docker run --name mihttpd -d -p 8080:80 mihttpd
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código:
<syntaxhighlight lang="bash">
curl -X GET http://localhost:8080
</syntaxhighlight>

Tiene que salir por pantalla esto:
<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

== Ejercicio 2: aplicación flask ==

Flask es un framework python para implementar webs. Cree una imagen "miapp-flask" a partir de la imagen de "python":

* Instale flask mediante: pip install flask
* Cree la carpeta "app"
* Establezca la variable FLASK_APP a "hello.py"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"

El fichero hello.py contiene un "hola mundo" para Flask:

<syntaxhighlight lang="python">
from flask import Flask
app = Flask(__name__)

@app.route("/")
def hello():
return "Hello World!"

if __name__ == "__main__":
app.run()
</syntaxhighlight>

Solución con alpine:

<syntaxhighlight lang="bash">
FROM python:alpine

RUN mkdir /app
RUN pip install flask
ENV FLASK_APP="app/hello.py"
COPY hello.py
WORKDIR /
CMD flask run --host=0.0.0.0
</syntaxhighlight>

Solución con Ubuntu:

<syntaxhighlight lang="bash">
FROM ubuntu:bionic

RUN apt-get update
RUN apt-get -y install python python-pip wget
RUN pip install Flask
ENV FLASK_APP="app/hello.py"
RUN mkdir /app
COPY hello.py /app
CMD flask run --host=0.0.0.0
</syntaxhighlight>

== Ejercicio 3: mysql ==

'''EN LA MÁQUINA VIRTUAL:'''

mkdir miapp

cd miapp

sudo docker pull mysql

nano Dockerfile

<syntaxhighlight lang="bash">
FROM mysql
ENV MYSQL_ROOT_PASSWORD="lacontraseñaqueyoquiera"
RUN mkdir /app
WORKDIR /app

</syntaxhighlight>

CTRL+O , ENTER Y CTRL+X (para guardar Dockerfile y salir)

sudo docker build -ti mrfdocker -f Dockerfile .

sudo docker run --name mymrf --rm -p 8001:3306 mrfdocker

sudo docker images

'''EN LA TERMINAL DEL HOST:'''

''Instalación de mysql:''

sudo apt install mysql-client-core-5.7

> sudo apt-get install mysql-server

> sudo service mysql start

''Para entrar:''

sudo mysql -u root -p -P 8001

Una vez dentro de msql:

mysql> show databases;
''
Para salir:''

exit

== Ejercicio 5: python pyramid ==

Pyramid es un framework python para implementar webs. Cree una imagen "miapp-pyramid":

* Emplee la imagen de Ubuntu como referencia, instale los paquetes python y python-pip.
* Instale Pyramid mediante: pip install pyramid
* Cree la carpeta "app"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"
* La aplicación se lanza con la orden: python hello.py
* Compruebe que funciona con curl, la ruta a la web es http://127.0.0.1:8000/hello, suponiendo que ha empleado el puerto 8000 para exponer el servicio.

El fichero hello.py contiene un "hola mundo" para Pyramid:

<syntaxhighlight lang="bash">
from wsgiref.simple_server import make_server
from pyramid.config import Configurator
from pyramid.response import Response

def hello_world(request):
print('Request inbound!')
return Response('Docker works with Pyramid!')

if __name__ == '__main__':
config = Configurator()
config.add_route('hello', '/')
config.add_view(hello_world, route_name='hello')
app = config.make_wsgi_app()
server = make_server('0.0.0.0', 6543, app)
server.serve_forever()
</syntaxhighlight>

Este programa recibe peticiones en el puerto 6543.

== Ejercicio 6 ==

Cree una imagen derivada de Ubuntu, instale el paquete apache2, php y libapache2-mod-php.
Active el módulo de php para apache2 mediante la orden:

<syntaxhighlight lang="bash">
a2enmod php
</syntaxhighlight>

Cree la carpeta /var/www/php.

Cree el fichero index.php

<syntaxhighlight lang="php">
<?php
Print "Hello, World!";
?>
</syntaxhighlight>

y copielo a /var/www/php/.

Cree el fichero 000-default.conf y copielo a /etc/apache2/sites-enabled/

Dicho fichero contiene.

<syntaxhighlight lang="bash">
<VirtualHost *:80>
DocumentRoot /var/www/php

<Directory /var/www/php/>
Options Indexes FollowSymLinks MultiViews
AllowOverride All
Order deny,allow
Allow from all
</Directory>

ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>
</syntaxhighlight>

Tiene que lanzar apache con la orden: apachectl -D FOREGROUND

Tras crear la imagen, láncela mapeando el puerto 8888 al 80, pruebe que puede acceder a http://127.0.0.1:8888/php/ mediante curl

Solución:

<syntaxhighlight lang="bash">
FROM ubuntu:latest

RUN apt-get update
RUN apt-get install -y tzdata
RUN apt-get install -y apache2
RUN apt-get install -y php
RUN apt-get install -y libapache2-mod-php
RUN a2enmod php7.2
COPY index.php /var/www/php
COPY 000-default.conf /etc/apache2/sites-enabled/
CMD apachectl -D FOREGROUND
</syntaxhighlight>

Y para lanzarlo:

docker run --name my-app --rm -d -p 8001:8000 app:v1

y para probarlo:

curl -X GET http://127.0.0.1:8888/php/

== Ejercicio 7 ==

Instale el paquete ''netcat-traditional'' en una imagen de contenedor de ''ubuntu''. Lance la orden:

nc -u -l -p 8080

en el contenedor. Asegúrese de crear una redirección de puertos de 9999 desde el ''host'' al puerto 8080 en el contenedor.

Desde fuera del contenedor, pruebe a conectarse con:

nc -u 127.0.0.1 9999

== Ejercicio 8 ==

Cree una imagen derivada de "ubuntu" con un Dockerfile que incluya soporte de python y lance el siguiente código en Python:

<syntax lang="python">
from http.server import BaseHTTPRequestHandler, HTTPServer
import time

hostName = "0.0.0.0"
serverPort = 8080

class MyServer(BaseHTTPRequestHandler):
def do_GET(self):
self.send_response(200)
self.send_header("Content-type", "text/html")
self.end_headers()
self.wfile.write(bytes("<html><head><title>Welcome!</title></head>", "utf-8"))
self.wfile.write(bytes("<body>", "utf-8"))
self.wfile.write(bytes("This is an example web server.", "utf-8"))
self.wfile.write(bytes("</body></html>", "utf-8"))

if __name__ == "__main__":
webServer = HTTPServer((hostName, serverPort), MyServer)
print("Server started http://%s:%s" % (hostName, serverPort))

try:
webServer.serve_forever()
except KeyboardInterrupt:
pass

webServer.server_close()
print("Server stopped.")
</syntax>

Llame a su imagen "python-http-server". Lance una instancia de la imagen "python-http-server" mapeando el puerto 9999 al puerto 8888/tcp del contenedor. Compruebe con:

<syntax lang="bash">
curl http://127.0.0.1:9999/
</syntax>

que muestre la página HTML que ofrece el servidor, que debería ser:

<syntax lang="bash">
<html><head><title>Welcome!</title></head><body>This is an example web server.</body></html>
</syntax>

Contenedores

2025-12-09T11:15:17Z

Pneira: /* Paso 11: Crear nuestra propia imagen podman */

En esta práctica aprenderemos a utilizar [https://es.wikipedia.org/wiki/Podman podman] para desplegar contenedores.

= Paso 1: Instalar podman =

Para instalar el paquete oficial:

<syntaxhighlight lang="bash">
apt install podman
</syntaxhighlight>

podman es un clon de '''docker''.

= Paso 2: Repositorio de imágenes de contenedores DockerHub =

Docker ofrece un servicio de nube denominado ''DockerHub'' que puede ser empleado como red social para compartir tus imágenes de Podman. En ''DockerHub'' existen además imágenes de contenedores preconfiguradas de software, muchas de ellas oficiales (ofrecidas por el propio fabricante del software) que se podrán emplear como base para construir nuevas imágenes adaptadas a nuestras necesidades.

Podremos realizar búsquedas en este repositorio ''DockerHub'' puedes emplear el siguiente comando:

<syntaxhighlight lang="bash">
podman search docker.io/library/hello-world
</syntaxhighlight>

Para descargarnos la imagen de ''hello-world'' podemos usar la orden ''pull'':

<syntaxhighlight lang="bash">
podman pull hello-world
</syntaxhighlight>

También podemos publicar imágenes propias, esto require '''registro de usuario''' en la nube de ''DockerHub'', lo que '''no''' es obligatorio para la realización de esta práctica. Para subir una imagen, hay que validarse como usuario en la nube de ''DockerHub'':

<syntaxhighlight lang="bash">
podman login
</syntaxhighlight>

Tras introducir tu usuario y contraseña, puedes comenzar a publicar tus propias imágenes.

<syntaxhighlight lang="bash">
podman push MI_IMAGEN
</syntaxhighlight>

Este paso es '''opcional''', sólo en caso de que se quieran subir imágenes de contenedores a la nube de docker.io.

= Paso 4: Comprobar imágenes en nuestra máquina =

Para ver las imágenes que tenemos en nuestra máquina, utilizaremos el comando:

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Inicialmente, no tenemos imágenes en almacenamiento, podemos descargarnos la imagen oficial de Debian 13 (Trixie):

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian
</syntaxhighlight>

Ahora si, ya debería de aparecernos la imagen ''debian''.

Comentar también que cada imagen puede tener varias etiquetas, por ejemplo, la imagen Debian 12 (Bookworm), cuando la hemos visto en el listado de imágenes, venía con el tag latest, que es el tag que se descarga por defecto, pero nosotros podemos especificar otro, por ejemplo:

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian:bookworm
</syntaxhighlight>

Para traernos la versión de la imagen de Debian 12 ''Bookworm''.

Ahora tendremos dos imágenes con diferente etiqueta, que serían como las diferentes versiones de cada imagen.

= Paso 5: Lanzar un contenedor =

Un contenedor no es más que una imagen de podman ejecutándose, sería similar a
una máquina virtual, aunque mucho más liviano.

Para crear un contenedor, utilizaremos una imagen, en este caso, la imagen
hello-world. Hacemos lo siguiente:

<syntaxhighlight lang="bash">
podman run hello-world
</syntaxhighlight>

Esto nos mostrará el siguiente mensaje si todo está correcto:

<syntaxhighlight lang="bash">
Hello from Docker!
This message shows that your installation appears to be working correctly.

To generate this message, Docker took the following steps:
1. The Docker client contacted the Docker daemon.
2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
(amd64)
3. The Docker daemon created a new container from that image which runs the
executable that produces the output you are currently reading.
4. The Docker daemon streamed that output to the Docker client, which sent it
to your terminal.

To try something more ambitious, you can run an Debian container with:
$ podman run -it debian bash

Share images, automate workflows, and more with a free Docker ID:
https://hub.docker.com/

For more examples and ideas, visit:
https://docs.docker.com/get-started/
</syntaxhighlight>

Al crear los contenedores utilizando el comando 'run', tenemos varias opciones:

* Lanzar una terminal en el contenedor en modo interactivo
* Lanzar en segundo plano y conectarnos posteriormente al contenedor

== Paso 5.1: Lanzar una terminal en el contenedor en modo interactivo (-ti) ==

Para este ejemplo vamos a utilizar otra imagen diferente, en este caso vamos a utilizar una imagen de debian.

Vamos a lanzar un contenedor y ejecutar una terminal en el que se va a ejecutar el programa '''bash''' que me ofrece un interprete de órdenes:

<syntaxhighlight lang="bash">
podman run -ti debian bash
</syntaxhighlight>

La opción ''-t'' indica que se crea un terminal en el contenedor. Y la opción ''-i'' indica que el contenedor se ejecuta en modo interactivo.

Al acceder al contenedor de ''debian'' nos aparece un ''hash'' en el prompt de la shell, que identifica a la instancia del contenedor (es valor es similar al que muestra la orden ''podman container ls'').

Para salir del contenedor, escribimos 'exit' o pulsamos ''CTRL + D''

== Paso 5.2 Lanzar en segundo plano (-d) ==

Otro ejemplo, con la imagen de Debian:

<syntaxhighlight lang="bash">
podman run -dti debian
</syntaxhighlight>

que muestra un hash que identifica de forma única el contenedor lanzado:

<syntaxhighlight lang="bash">
2ec1daae4676a4e84dc04fd91399c1dfe92119544ff12ee307991fe573d3db64
</syntaxhighlight>

Mediante el comando ''attach'' puedo entrar al contenedor:

<syntaxhighlight lang="bash">
podman attach 2ec1daae4676
</syntaxhighlight>

Para salir, pulsamos ''CTRL + P'' seguido de ''CTRL + Q''.

De manera similar, puedo lanzar en segundo plano la imagen de contenedor de ''hello-world'':

<syntaxhighlight lang="bash">
podman run -d hello-world
</syntaxhighlight>

Y consultar los logs:

<syntaxhighlight lang="bash">
podman logs b67fae3312bc321
</syntaxhighlight>

== Paso 5.3: Añadir variables de entorno a un contenedor ==

Utilizaremos la imagen anterior, y vamos a añadir una variable de entorno
llamada TEST que contenga el valor 'test'. A parte, también ejecutaremos la
terminal como antes, para comprobar con el comando echo, que la variable de
entorno está creada correctamente:

<syntaxhighlight lang="bash">
podman run -ti -e TEST=test debian bash
</syntaxhighlight>

Ahora, desde el contenedor podemos comprobar el valor de la variable de entorno ''$TEST''.

<syntaxhighlight lang="bash">
echo $TEST
test
</syntaxhighlight>

= Paso 6: Listar contenedores en ejecución =

Hemos estado haciendo pruebas y ejecutando contenedores en el paso anterior, vamos a ver donde se encuentran estos contenedores que hemos ejecutado, y después veremos algunas opciones más del comando run.

Tenemos dos opciones para ver los contenedores:

<syntaxhighlight lang="bash">
podman container ls -a
</syntaxhighlight>

o la versión corta:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Ambas hacen lo mismo, y debería de mostrarnos una salida similar a la siguiente:

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
e2bde5f5500c debian "bash" 6 minutes ago Exited (0) 2 seconds ago pensive_sammet
544ad27dbc3c debian "bash" 7 minutes ago Exited (0) 7 minutes ago serene_elgamal
</syntaxhighlight>

En la información veremos que el contenedor tiene el estado exited, eso quiere decir que no se está ejecutando y ya ha finalizado. Vamos a hacer una prueba para ver un contendor ejecutándose:

<syntaxhighlight lang="bash">
podman run -d debian sleep 30
</syntaxhighlight>

Con el comando sleep 30 esperamos 30 segundos hasta que termine el comando, asíque durante esos 30 segundos, el contenedor estará ejecutándose, veámoslo:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
eacceb27d52d debian "sleep 30" 12 seconds ago Up 11 seconds sharp_pasteur
</syntaxhighlight>

Vamos a ver alguna opciones más de la orden ''run''.

== Paso 6.1: Dar un nombre al contenedor (--name) ==

Por defecto, podman creará automáticamente un nombre como hemos visto en las salidas del comando ''podman ps -a''. Podemos establecer el nombre del contenedor que queramos con la opción ''--name'':

<syntaxhighlight lang="bash">
podman run -ti --name mi_debian debian
</syntaxhighlight>

== Paso 6.2: Eliminar contenedor cuando termine (--rm) ==

Vamos a mezclar todo lo visto anteriormente:

* Lanzar en segundo plano (-d)
* Ejecutar contenedor durante 30 segundos (sleep 30)
* Dar un nombre a la imagen (--name)
* Eliminar contenedor cuando termine (--rm)

<syntaxhighlight lang="bash">
podman run -d --rm --name bye-bye debian sleep 30
</syntaxhighlight>

Antes y una vez pasados los 30 segundos, podemos comprobar que el contenedor ha desaparecido.

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

= Paso 7: Parar y eliminar contenedores =

Los contenedores podemos pararlos o eliminarlos, veamos como hacerlo. Antes que
nada, borraremos todos los contenedores que estén terminados, para ello:

<syntaxhighlight lang="bash">
podman container prune
podman ps -a
</syntaxhighlight>

Ya lo hemos dejado todo limpio para seguir, ahora vamos a crear un contenedor,
utilizando un comando de linux que no termina, para que así se quede
ejecutándose el contenedor infinitamente:

<syntaxhighlight lang="bash">
podman run -d -ti --name my_container debian bash
podman ps -a
</syntaxhighlight>

Vamos a pararlo (podemos utilizar el nombre dado o el id):

<syntaxhighlight lang="bash">
podman stop my_container
podman stop e4901956f108
podman ps -a
</syntaxhighlight>

Veremos que ya ha terminado, y ahora vamos a eliminarlo, pero solo este
contenedor, no como previamente que eliminamos todos. Lo mismo que para pararlo,
podemos utilizar el nombre o el id.

<syntaxhighlight lang="bash">
podman container rm my_container
podman container rm my_container
podman ps -a
</syntaxhighlight>

Veremos que ya no tenemos el contenedor y está correctamente eliminado.

= Paso 8: Conectarnos a un contenedor que se está ejecutando en segundo plano =

Vamos a ejecutar de nuevo un contenedor que no termine:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a conectarnos a este contenedor que está ejecutándose en segundo
plano:

<syntaxhighlight lang="bash">
podman attach mi-contenedor
</syntaxhighlight>

Veremos la orden bash ejecutándose, para terminar, hacemos un 'CTRL + C', y ahora, veremos que ha pasado con el contenedor:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Lo veremos parado, por que lo que hemos hecho ha sido conectarnos al contenedor
y parar el comando que se estaba ejecutando, así que ahora tenemos el contenedor
finalizado.

''Nota:'' Para salir del contenedor '''sin detenerlo''' hacemos 'CTRL + P' seguido 'CTRL + Q'

= Paso 9: Ejecutar un comando dentro de un contenedor en ejecución =

Vamos a ver otresta vez como ejecutar un comando en un contenedor que ya está
ejecutándose:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a ejecutar un comando en ese contenedor con el nombre ''mi-contenedor''.
El comando exec es similar al comando run, pero para ejecutar un comando dentro de un contenedor:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor ls
</syntaxhighlight>

Ahora estamos dentro del contenedor creado anteriormente:

<syntaxhighlight lang="bash">
ps -a
</syntaxhighlight>

Aquí veremos en el listado de procesos que hay en ejecución.

Ahora vamos a salirnos del contenedor, escribiendo 'exit' o 'CTRL + D', y
comprobemos el estado del contenedor:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Ahora veremos que el contenedor se sigue ejecutando, no como en el paso anterior.

= Paso 10: Persistencia en contenedores =

Al hacer ''exit'' y salir de un contenedor, se pierden todos los cambios que hemos realizado. Los

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-ejemplo debian bash
</syntaxhighlight>

Ahora, vamos a crear una carpeta en el contenedor y comprobar que esa carpeta existe:

<syntaxhighlight lang="bash">
podman exec mi-ejemplo mkdir test
podman exec mi-ejemplo ls
</syntaxhighlight>

Veremos que la carpeta existe, pero, ¿qué ocurre si para el contenedor?

<syntaxhighlight lang="bash">
podman container stop mi-ejemplo
</syntaxhighlight>

Y volvemos a lanzarlo:

<syntaxhighlight lang="bash">
podman container rm mi-ejemplo
podman run -d -ti --name mi-ejemplo debian bash
podman exec mi-ejemplo ls
</syntaxhighlight>

Podemos comprobar que la carpeta creada anteriormente, no existe.

¿Qué podemos hacer para mantener la modificaciones realizadas sobre un contenedor?

== Paso 10.1: Crear una imagen derivada de la imagen base ==

Es posible crear una imagen derivada, con modificaciones, a partir de una imagen existente mediante la orden '''commit'''.

Por ejemplo, si queremos una imagen ''debian'' que incluya el programa ''ping'' ya instalado, tendríamos que lanzar un contenedor a partir de la imagen ''ubuntu'':

<syntaxhighlight lang="bash">
podman run -d -ti debian bash
</syntaxhighlight>

Suponiendo que el contenido está identificado con el ID 56ef5b312334

Instalamos el paquete ping:

<syntaxhighlight lang="bash">
podman exec 56ef5b312334 apt -y install ping
</syntaxhighlight>

Generamos la imagen derivada con el nombre ''ubuntu-con-ping'':

<syntaxhighlight lang="bash">
podman commit 56ef5b312334 ubuntu-con-ping
</syntaxhighlight>

Ya podemos para nuestro contendor:

<syntaxhighlight lang="bash">
podman stop 56ef5b312334
</syntaxhighlight>

Y lanzar un nuevo contenedor a partir de la imagen ''debian-con-ping'':

<syntaxhighlight lang="bash">
podman run -d -ti debian-con-ping bash
</syntaxhighlight>

== Paso 10.2: Mantener la persistencia mediante volúmen ==

Otra opción para mantener los datos es montar un volumen al ejecutar el contenedor.

Primero crearemos una carpeta que hará de volumen en nuestra máquina, que será la que luego montemos para podman:

<syntaxhighlight lang="bash">
mkdir /home/debian/volumen
</syntaxhighlight>

Ahora vamos a montar la carpeta al ejecutar el contenedor, lo hacemos con la
opción -v, la cual tiene 3 campos separados por ':':

# El volumen en nuestra máquina
# Donde se montará el volumen dentro del contenedor
# Opciones de mmontaje, por ejemplo rw (read and write) o ro (read only)

<syntaxhighlight lang="bash">
podman run --rm -ti -v /home/debian/volumen:/volumen:rw debian bash
mkdir /volumen/test
touch /volumen/test/file
exit
</syntaxhighlight>

Una vez nos salgamos del contenedor, podemos ver que en nuestra máquina están
los datos:

<syntaxhighlight lang="bash">
ls /home/ubuntu/volumen/
ls /home/ubuntu/volumen/test
</syntaxhighlight>

La próxima vez que ejecutemos un contenedor, si montamos ese volumen, los datos
estarán ahí, además esta forma tiene el beneficio de compartir datos entre
nuestra máquina y el contenedor de forma sencilla.

= Paso 11: Crear nuestra propia imagen de contenedor =

Para crear una imagen de un contenedor con una aplicación de Python hug, creamos en primer lugar la carpeta que contendrá los ficheros que nos permiten crear la imagen.

<syntaxhighlight lang="bash">
mkdir miapp
cd miapp
</syntaxhighlight>

Definimos un fichero ''Dockerfile'' para definir la imagen:

<syntaxhighlight lang="bash">
FROM ubuntu

RUN apt -y update
RUN apt -y upgrade
RUN apt -y install python3-hug
RUN mkdir /app
COPY endpoint.py /app
WORKDIR /app
CMD hug -f endpoint.py
</syntaxhighlight>

Alternativamente, puedes crear un [[Creando imagen propia usando Ubuntu de base|Dockerfile empleando la imagen de Ubuntu]] como base en lugar de Alpine.

Y añadimos el fichero ''endpoint.py'' que emplea el framework Python hug con el contenido siguiente:

<syntaxhighlight lang="bash">
import hug

@hug.get('/welcome')
def welcome(username="unknown"):
""" Say welcome to username """
return "Welcome " + username
</syntaxhighlight>

Este fichero es un ejemplo de uso de Python hug. Si hacemos una petición a /welcome?username="LSO", esto nos devolverá el mensaje "Welcome LSO".

Una vez tengamos los dos ficheros creados en nuestra máquina virtual, podemos construir nuestra imagen:

<syntaxhighlight lang="bash">
podman build -t app:v1 -f Dockerfile .
</syntaxhighlight>

Vamos a explicar para que sirve cada línea:

* FROM: servirá para basarnos en una imagen existente, en este caso, una imagen de python alpine, que contiene python y no ocupa mucho espacio
* ENV: para crear variables de entorno
* RUN: para ejecutar comandos, ya sea para crear una carpeta, instalar dependencias o cualquier otra opción que necesitemos
* COPY: para copiar datos desde nuestra máquina a la imagen
* WORKDIR: para cambiar el directorio de trabajo
* CMD: este comando será ejecutado por defecto al iniciar un contenedor a partir de esta imagen

Esto construirá una imagen podman basada en python:alpine, en la cual hemos
guardado nuestra pequeña aplicación y se va a ejecutar cuando ejecutemos un
contenedor basado en esa imagen. Para comprobar que la imagen se ha creado
correctamente, listamos las imagenes, y debería de aparecernos una imagen con
nombre 'app' y tag 'v1':

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen, y vamos a añadir una nueva
opción, -p 8001:8000. Esta opción hará que el puerto interno 8000 del contenedor
sea expuesto en el puerto 8001 de nuestra máquina:

<syntaxhighlight lang="bash">
podman run --name my-app --rm -d -p 8001:8000 app:v1
</syntaxhighlight>

''Nota:'' podman supone que la redirección de puerto es TCP, para una redirección de puertos UDP, puedes usar:

<syntaxhighlight lang="bash">
... -p 8001:8000/udp
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código. En nuestra
máquina haremos:

<syntaxhighlight lang="bash">
curl -X GET http://localhost:8001/welcome?username=LSO
</syntaxhighlight>

Comprobaremos que la salida del comando curl, es "Welcome LSO".

Antes de terminar, vamos a comprobar otro pequeño detalle que añadimos en
nuestra imagen, la variable de entorno USERNAME, vamos a comprobar que funciona:

<syntaxhighlight lang="bash">
podman exec -ti my-app ash
echo $USERNAME
</syntaxhighlight>

Funciona correctamente, pero al ejecutar el contenedor, podemos cambiar esta
variable de entorno como vimos en uno de los pasos anteriores:

<syntaxhighlight lang="bash">
podman run --rm -ti -e USERNAME=me app:v1 ash
echo $USERNAME
</syntaxhighlight>

Esto nos servirá para tener opciones por defecto y que el usuario pueda
cambiarlo a su antojo, como por ejemplo contraseñas u otros detalles.

= Paso 12: Eliminar imágenes =

Veremos que después de todas las pruebas que hemos estado haciendo, tenemos
muchas imágenes, y algunas de las cuales no nos servirán o no las utilizaremos,
así que podemos borrarlas para ahorrar espacio.

Al igual que con los contenedores, tenemos una opción para borrar imágenes que
no se utilicen:

<syntaxhighlight lang="bash">
podman image prune
</syntaxhighlight>

Esto borrará imágenes intermedias que se utilizan a veces para construir
nuestras imágenes o imágenes que hemos intentado construir y nos han fallado.

La otra opción para borrar imágenes una a una, sería utilizando el comando
podman rmi y utilizar el nombre de la imagen o el id. Si esta es la salida de
'podman images':

<syntaxhighlight lang="bash">
REPOSITORY TAG IMAGE ID CREATED SIZE
app v1 18609c517d32 14 minutes ago 109MB
python alpine 39fb80313465 23 hours ago 98.7MB
debian latest 85c4fd36a543 13 days ago 114MB
hello-world latest fce289e99eb9 7 months ago 1.84kB
hello-world linux fce289e99eb9 7 months ago 1.84kB
</syntaxhighlight>

Podemos eliminar las imágenes de hello-world:

<syntaxhighlight lang="bash">
podman rmi hello-world
</syntaxhighlight>

ó

<syntaxhighlight lang="bash">
podman rmi fce289e99eb9
</syntaxhighlight>

= Paso 13: Varios podman a la vez (podman-compose) =

Antes de comenzar, vamos a parar todos los contenedores que tengamos abiertos,
para dejar el entorno de podman limpio, que nos vendrá bien para esta parte.

Cuando queremos ejecutar varios contenedores a la vez y que estén conectados
entre ellos fácilmente, utilizaremos podman-compose, donde con un fichero de
configuración simple en yaml, tendremos toda la configuración de lo que vamos a
ejecutar.

Primero vamos a instalar podman-compose:

<syntaxhighlight lang="bash">
sudo apt install podman-compose
</syntaxhighlight>

Ahora veamos un pequeño ejemplo donde explicaremos todos los detalles para crear
un podman-compose, en este caso, el nombre por defecto de los ficheros suele ser
podman-compose.yml, y el contenido será similar a:

<syntaxhighlight lang="bash">
version: '3'

services:
web:
container_name: web
restart: always
build:
context: .
ports:
- "8000:8000"
volumes:
- /home/ubuntu/volume:/volumen:rw
environment:
USERNAME: test
web2:
container_name: web2
build:
dockerfile: Dockerfile
context: .
depends_on:
- web
command: touch web2
web3:
container_name: web3
restart: on-failure
image: pstauffer/curl
depends_on:
- web
command: curl -X GET web:8000/welcome?username=web3
</syntaxhighlight>

En el podman-compose definimos diferentes servicios a ejecutar, en nuestro caso
hemos iniciado tres servicios diferentes, web, web2 y web3:

El primer servicio, web:

* container_name: para darle un nombre por defecto al contenedor cuando se cree
* restart: pueden ser:
** "no": si la máquina termina, no se vuelve a iniciar (opción por defecto)
** always: siempre que el contenedor termine, intenta iniciarse de nuevo
** on-failure: solo intenta reiniciarse si el contenedor termina con fallo
** unless-stopped: solo reinicia el contenedor si el usuario es el que lo termina
* Utilizará el fichero Dockerfile creado en el paso 11 para generar la imagen a usar.
* Expondrá el puerto 8000 del contenedor en el 8000 de nuestra máquina
* Montará un volumen, se hace de forma similar a la línea de comandos
* Creará una variable de entorno

El segundo servicio, web2:

* Utilizará el fichero Dockerfile también, la diferencia entre este y el primer servicio, es que si el nombre del Dockerfile cambia, tendremos que hacerlo de esta segunda forma, la primera por defecto solo buscará el fichero Dockerfile
* depends_on hará que para ejecutar este servicio, su dependencia tenga ya que estar iniciada
* Ejecutaremos un comando el cual sustituirá al comando de la imagen

El tercer servicio, web3:

* Utilizará la imagen ostauffer/curl que es un imagen mínima que contiene el comando curl
* restart: en este caso, hasta que el comando no se ejecute correctamente, se seguirá reiniciando el contenedor
* depends_on igual que el servicio 2, dependerá del servicio 1
* Ejecutaremos un comando para llamar desde el servicio 3 al servicio 1

== Paso 13.1: Construir podman-compose ==

En el caso de existir servicios que tengan Dockerfiles, esto hará que se construyan previamente, como hacer un podman build de cada uno de los servicios que contenga un Dockerfile:

<syntaxhighlight lang="bash">
podman-compose build
</syntaxhighlight>

Con esto se generarán las imágenes necesarias para ejecutar todos los servicios.

== Paso 13.2: Iniciar podman-compose ==

Para iniciar todos los servicios, ejecutaremos:

<syntaxhighlight lang="bash">
podman-compose up -d
</syntaxhighlight>

Después de esto podremos ver el logs de todos los servicios:

<syntaxhighlight lang="bash">
podman-compose logs -f
</syntaxhighlight>

Aquí veremos que el servicio 3 ha conseguido llamar correctamente al servicio 1.

Ahora veremos como podman-compose ha creado los contenedores:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

La salida será similar a la siguiente:

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
219a4118244c pstauffer/curl "curl -X GET web:800…" 6 seconds ago Exited (0) 3 seconds ago web3
c97e894cb3ae ubuntu_web2 "touch web2" 6 seconds ago Exited (0) 4 seconds ago web2
f35d034204fc ubuntu_web "/bin/sh -c 'hug -f …" 6 seconds ago Up 5 seconds 0.0.0.0:8000->8000/tcp web
</syntaxhighlight>

Aquí vemos varios detalles:

* El nombre que le hemos dado en el podman-compose ha funcionado correctamente
* Vemos que los comandos son los correctos también
* web2 está parado por que la política de reinicio es apagar cuando se termine de ejecutar un comando
* web 3 está parado por que el comando ha terminado con un salida correcta

Vamos a comprobar ahora que en el servicio web está todo correcto:

<syntaxhighlight lang="bash">
podman exec -ti web ash
echo $USERNAME
ls /volumen
exit
</syntaxhighlight>

Podemos comprobar que tanto cambiar la variable de entorno como crear un
volumen ha funcionado correctamente.

== Paso 13.3: Parar podman-compose ==

Para parar todos los servicios:

<syntaxhighlight lang="bash">
podman-compose down
</syntaxhighlight>

Comprobamos:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Vemos que han desaparecido todos los contenedores.

= Paso 14: Ejercicios =

== Ejercicio 1: Variante de httpd ==

Construya una imagen ''httpd-hola-mundo'' a partir de la imagen ''httpd''. El fichero de index.html de la carpeta htdocs/ tiene que mostrar el mensaje "hola mundo".

<syntaxhighlight lang="bash">
docker pull httpd
</syntaxhighlight>

Edita el fichero Dockerfile:

<syntaxhighlight lang="bash">
nano Dockerfile
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
FROM httpd

COPY index.html htdocs/index.html
</syntaxhighlight>

Edita el fichero index.html:

<syntaxhighlight lang="bash">
nano index.html
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

Construye la imagen:

<syntaxhighlight lang="bash">
docker build -t mihttpd -f Dockerfile .
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen:

<syntaxhighlight lang="bash">
sudo docker run --name mihttpd -d -p 8080:80 mihttpd
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código:
<syntaxhighlight lang="bash">
curl -X GET http://localhost:8080
</syntaxhighlight>

Tiene que salir por pantalla esto:
<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

== Ejercicio 2: aplicación flask ==

Flask es un framework python para implementar webs. Cree una imagen "miapp-flask" a partir de la imagen de "python":

* Instale flask mediante: pip install flask
* Cree la carpeta "app"
* Establezca la variable FLASK_APP a "hello.py"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"

El fichero hello.py contiene un "hola mundo" para Flask:

<syntaxhighlight lang="python">
from flask import Flask
app = Flask(__name__)

@app.route("/")
def hello():
return "Hello World!"

if __name__ == "__main__":
app.run()
</syntaxhighlight>

Solución con alpine:

<syntaxhighlight lang="bash">
FROM python:alpine

RUN mkdir /app
RUN pip install flask
ENV FLASK_APP="app/hello.py"
COPY hello.py
WORKDIR /
CMD flask run --host=0.0.0.0
</syntaxhighlight>

Solución con Ubuntu:

<syntaxhighlight lang="bash">
FROM ubuntu:bionic

RUN apt-get update
RUN apt-get -y install python python-pip wget
RUN pip install Flask
ENV FLASK_APP="app/hello.py"
RUN mkdir /app
COPY hello.py /app
CMD flask run --host=0.0.0.0
</syntaxhighlight>

== Ejercicio 3: mysql ==

'''EN LA MÁQUINA VIRTUAL:'''

mkdir miapp

cd miapp

sudo docker pull mysql

nano Dockerfile

<syntaxhighlight lang="bash">
FROM mysql
ENV MYSQL_ROOT_PASSWORD="lacontraseñaqueyoquiera"
RUN mkdir /app
WORKDIR /app

</syntaxhighlight>

CTRL+O , ENTER Y CTRL+X (para guardar Dockerfile y salir)

sudo docker build -ti mrfdocker -f Dockerfile .

sudo docker run --name mymrf --rm -p 8001:3306 mrfdocker

sudo docker images

'''EN LA TERMINAL DEL HOST:'''

''Instalación de mysql:''

sudo apt install mysql-client-core-5.7

> sudo apt-get install mysql-server

> sudo service mysql start

''Para entrar:''

sudo mysql -u root -p -P 8001

Una vez dentro de msql:

mysql> show databases;
''
Para salir:''

exit

== Ejercicio 5: python pyramid ==

Pyramid es un framework python para implementar webs. Cree una imagen "miapp-pyramid":

* Emplee la imagen de Ubuntu como referencia, instale los paquetes python y python-pip.
* Instale Pyramid mediante: pip install pyramid
* Cree la carpeta "app"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"
* La aplicación se lanza con la orden: python hello.py
* Compruebe que funciona con curl, la ruta a la web es http://127.0.0.1:8000/hello, suponiendo que ha empleado el puerto 8000 para exponer el servicio.

El fichero hello.py contiene un "hola mundo" para Pyramid:

<syntaxhighlight lang="bash">
from wsgiref.simple_server import make_server
from pyramid.config import Configurator
from pyramid.response import Response

def hello_world(request):
print('Request inbound!')
return Response('Docker works with Pyramid!')

if __name__ == '__main__':
config = Configurator()
config.add_route('hello', '/')
config.add_view(hello_world, route_name='hello')
app = config.make_wsgi_app()
server = make_server('0.0.0.0', 6543, app)
server.serve_forever()
</syntaxhighlight>

Este programa recibe peticiones en el puerto 6543.

== Ejercicio 6 ==

Cree una imagen derivada de Ubuntu, instale el paquete apache2, php y libapache2-mod-php.
Active el módulo de php para apache2 mediante la orden:

<syntaxhighlight lang="bash">
a2enmod php
</syntaxhighlight>

Cree la carpeta /var/www/php.

Cree el fichero index.php

<syntaxhighlight lang="php">
<?php
Print "Hello, World!";
?>
</syntaxhighlight>

y copielo a /var/www/php/.

Cree el fichero 000-default.conf y copielo a /etc/apache2/sites-enabled/

Dicho fichero contiene.

<syntaxhighlight lang="bash">
<VirtualHost *:80>
DocumentRoot /var/www/php

<Directory /var/www/php/>
Options Indexes FollowSymLinks MultiViews
AllowOverride All
Order deny,allow
Allow from all
</Directory>

ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>
</syntaxhighlight>

Tiene que lanzar apache con la orden: apachectl -D FOREGROUND

Tras crear la imagen, láncela mapeando el puerto 8888 al 80, pruebe que puede acceder a http://127.0.0.1:8888/php/ mediante curl

Solución:

<syntaxhighlight lang="bash">
FROM ubuntu:latest

RUN apt-get update
RUN apt-get install -y tzdata
RUN apt-get install -y apache2
RUN apt-get install -y php
RUN apt-get install -y libapache2-mod-php
RUN a2enmod php7.2
COPY index.php /var/www/php
COPY 000-default.conf /etc/apache2/sites-enabled/
CMD apachectl -D FOREGROUND
</syntaxhighlight>

Y para lanzarlo:

docker run --name my-app --rm -d -p 8001:8000 app:v1

y para probarlo:

curl -X GET http://127.0.0.1:8888/php/

== Ejercicio 7 ==

Instale el paquete ''netcat-traditional'' en una imagen de contenedor de ''ubuntu''. Lance la orden:

nc -u -l -p 8080

en el contenedor. Asegúrese de crear una redirección de puertos de 9999 desde el ''host'' al puerto 8080 en el contenedor.

Desde fuera del contenedor, pruebe a conectarse con:

nc -u 127.0.0.1 9999

== Ejercicio 8 ==

Cree una imagen derivada de "ubuntu" con un Dockerfile que incluya soporte de python y lance el siguiente código en Python:

<syntax lang="python">
from http.server import BaseHTTPRequestHandler, HTTPServer
import time

hostName = "0.0.0.0"
serverPort = 8080

class MyServer(BaseHTTPRequestHandler):
def do_GET(self):
self.send_response(200)
self.send_header("Content-type", "text/html")
self.end_headers()
self.wfile.write(bytes("<html><head><title>Welcome!</title></head>", "utf-8"))
self.wfile.write(bytes("<body>", "utf-8"))
self.wfile.write(bytes("This is an example web server.", "utf-8"))
self.wfile.write(bytes("</body></html>", "utf-8"))

if __name__ == "__main__":
webServer = HTTPServer((hostName, serverPort), MyServer)
print("Server started http://%s:%s" % (hostName, serverPort))

try:
webServer.serve_forever()
except KeyboardInterrupt:
pass

webServer.server_close()
print("Server stopped.")
</syntax>

Llame a su imagen "python-http-server". Lance una instancia de la imagen "python-http-server" mapeando el puerto 9999 al puerto 8888/tcp del contenedor. Compruebe con:

<syntax lang="bash">
curl http://127.0.0.1:9999/
</syntax>

que muestre la página HTML que ofrece el servidor, que debería ser:

<syntax lang="bash">
<html><head><title>Welcome!</title></head><body>This is an example web server.</body></html>
</syntax>

Contenedores

2025-12-09T11:09:57Z

Pneira: /* Paso 8: Conectarnos a un contenedor que se está ejecutando en segundo plano */

En esta práctica aprenderemos a utilizar [https://es.wikipedia.org/wiki/Podman podman] para desplegar contenedores.

= Paso 1: Instalar podman =

Para instalar el paquete oficial:

<syntaxhighlight lang="bash">
apt install podman
</syntaxhighlight>

podman es un clon de '''docker''.

= Paso 2: Repositorio de imágenes de contenedores DockerHub =

Docker ofrece un servicio de nube denominado ''DockerHub'' que puede ser empleado como red social para compartir tus imágenes de Podman. En ''DockerHub'' existen además imágenes de contenedores preconfiguradas de software, muchas de ellas oficiales (ofrecidas por el propio fabricante del software) que se podrán emplear como base para construir nuevas imágenes adaptadas a nuestras necesidades.

Podremos realizar búsquedas en este repositorio ''DockerHub'' puedes emplear el siguiente comando:

<syntaxhighlight lang="bash">
podman search docker.io/library/hello-world
</syntaxhighlight>

Para descargarnos la imagen de ''hello-world'' podemos usar la orden ''pull'':

<syntaxhighlight lang="bash">
podman pull hello-world
</syntaxhighlight>

También podemos publicar imágenes propias, esto require '''registro de usuario''' en la nube de ''DockerHub'', lo que '''no''' es obligatorio para la realización de esta práctica. Para subir una imagen, hay que validarse como usuario en la nube de ''DockerHub'':

<syntaxhighlight lang="bash">
podman login
</syntaxhighlight>

Tras introducir tu usuario y contraseña, puedes comenzar a publicar tus propias imágenes.

<syntaxhighlight lang="bash">
podman push MI_IMAGEN
</syntaxhighlight>

Este paso es '''opcional''', sólo en caso de que se quieran subir imágenes de contenedores a la nube de docker.io.

= Paso 4: Comprobar imágenes en nuestra máquina =

Para ver las imágenes que tenemos en nuestra máquina, utilizaremos el comando:

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Inicialmente, no tenemos imágenes en almacenamiento, podemos descargarnos la imagen oficial de Debian 13 (Trixie):

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian
</syntaxhighlight>

Ahora si, ya debería de aparecernos la imagen ''debian''.

Comentar también que cada imagen puede tener varias etiquetas, por ejemplo, la imagen Debian 12 (Bookworm), cuando la hemos visto en el listado de imágenes, venía con el tag latest, que es el tag que se descarga por defecto, pero nosotros podemos especificar otro, por ejemplo:

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian:bookworm
</syntaxhighlight>

Para traernos la versión de la imagen de Debian 12 ''Bookworm''.

Ahora tendremos dos imágenes con diferente etiqueta, que serían como las diferentes versiones de cada imagen.

= Paso 5: Lanzar un contenedor =

Un contenedor no es más que una imagen de podman ejecutándose, sería similar a
una máquina virtual, aunque mucho más liviano.

Para crear un contenedor, utilizaremos una imagen, en este caso, la imagen
hello-world. Hacemos lo siguiente:

<syntaxhighlight lang="bash">
podman run hello-world
</syntaxhighlight>

Esto nos mostrará el siguiente mensaje si todo está correcto:

<syntaxhighlight lang="bash">
Hello from Docker!
This message shows that your installation appears to be working correctly.

To generate this message, Docker took the following steps:
1. The Docker client contacted the Docker daemon.
2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
(amd64)
3. The Docker daemon created a new container from that image which runs the
executable that produces the output you are currently reading.
4. The Docker daemon streamed that output to the Docker client, which sent it
to your terminal.

To try something more ambitious, you can run an Debian container with:
$ podman run -it debian bash

Share images, automate workflows, and more with a free Docker ID:
https://hub.docker.com/

For more examples and ideas, visit:
https://docs.docker.com/get-started/
</syntaxhighlight>

Al crear los contenedores utilizando el comando 'run', tenemos varias opciones:

* Lanzar una terminal en el contenedor en modo interactivo
* Lanzar en segundo plano y conectarnos posteriormente al contenedor

== Paso 5.1: Lanzar una terminal en el contenedor en modo interactivo (-ti) ==

Para este ejemplo vamos a utilizar otra imagen diferente, en este caso vamos a utilizar una imagen de debian.

Vamos a lanzar un contenedor y ejecutar una terminal en el que se va a ejecutar el programa '''bash''' que me ofrece un interprete de órdenes:

<syntaxhighlight lang="bash">
podman run -ti debian bash
</syntaxhighlight>

La opción ''-t'' indica que se crea un terminal en el contenedor. Y la opción ''-i'' indica que el contenedor se ejecuta en modo interactivo.

Al acceder al contenedor de ''debian'' nos aparece un ''hash'' en el prompt de la shell, que identifica a la instancia del contenedor (es valor es similar al que muestra la orden ''podman container ls'').

Para salir del contenedor, escribimos 'exit' o pulsamos ''CTRL + D''

== Paso 5.2 Lanzar en segundo plano (-d) ==

Otro ejemplo, con la imagen de Debian:

<syntaxhighlight lang="bash">
podman run -dti debian
</syntaxhighlight>

que muestra un hash que identifica de forma única el contenedor lanzado:

<syntaxhighlight lang="bash">
2ec1daae4676a4e84dc04fd91399c1dfe92119544ff12ee307991fe573d3db64
</syntaxhighlight>

Mediante el comando ''attach'' puedo entrar al contenedor:

<syntaxhighlight lang="bash">
podman attach 2ec1daae4676
</syntaxhighlight>

Para salir, pulsamos ''CTRL + P'' seguido de ''CTRL + Q''.

De manera similar, puedo lanzar en segundo plano la imagen de contenedor de ''hello-world'':

<syntaxhighlight lang="bash">
podman run -d hello-world
</syntaxhighlight>

Y consultar los logs:

<syntaxhighlight lang="bash">
podman logs b67fae3312bc321
</syntaxhighlight>

== Paso 5.3: Añadir variables de entorno a un contenedor ==

Utilizaremos la imagen anterior, y vamos a añadir una variable de entorno
llamada TEST que contenga el valor 'test'. A parte, también ejecutaremos la
terminal como antes, para comprobar con el comando echo, que la variable de
entorno está creada correctamente:

<syntaxhighlight lang="bash">
podman run -ti -e TEST=test debian bash
</syntaxhighlight>

Ahora, desde el contenedor podemos comprobar el valor de la variable de entorno ''$TEST''.

<syntaxhighlight lang="bash">
echo $TEST
test
</syntaxhighlight>

= Paso 6: Listar contenedores en ejecución =

Hemos estado haciendo pruebas y ejecutando contenedores en el paso anterior, vamos a ver donde se encuentran estos contenedores que hemos ejecutado, y después veremos algunas opciones más del comando run.

Tenemos dos opciones para ver los contenedores:

<syntaxhighlight lang="bash">
podman container ls -a
</syntaxhighlight>

o la versión corta:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Ambas hacen lo mismo, y debería de mostrarnos una salida similar a la siguiente:

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
e2bde5f5500c debian "bash" 6 minutes ago Exited (0) 2 seconds ago pensive_sammet
544ad27dbc3c debian "bash" 7 minutes ago Exited (0) 7 minutes ago serene_elgamal
</syntaxhighlight>

En la información veremos que el contenedor tiene el estado exited, eso quiere decir que no se está ejecutando y ya ha finalizado. Vamos a hacer una prueba para ver un contendor ejecutándose:

<syntaxhighlight lang="bash">
podman run -d debian sleep 30
</syntaxhighlight>

Con el comando sleep 30 esperamos 30 segundos hasta que termine el comando, asíque durante esos 30 segundos, el contenedor estará ejecutándose, veámoslo:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
eacceb27d52d debian "sleep 30" 12 seconds ago Up 11 seconds sharp_pasteur
</syntaxhighlight>

Vamos a ver alguna opciones más de la orden ''run''.

== Paso 6.1: Dar un nombre al contenedor (--name) ==

Por defecto, podman creará automáticamente un nombre como hemos visto en las salidas del comando ''podman ps -a''. Podemos establecer el nombre del contenedor que queramos con la opción ''--name'':

<syntaxhighlight lang="bash">
podman run -ti --name mi_debian debian
</syntaxhighlight>

== Paso 6.2: Eliminar contenedor cuando termine (--rm) ==

Vamos a mezclar todo lo visto anteriormente:

* Lanzar en segundo plano (-d)
* Ejecutar contenedor durante 30 segundos (sleep 30)
* Dar un nombre a la imagen (--name)
* Eliminar contenedor cuando termine (--rm)

<syntaxhighlight lang="bash">
podman run -d --rm --name bye-bye debian sleep 30
</syntaxhighlight>

Antes y una vez pasados los 30 segundos, podemos comprobar que el contenedor ha desaparecido.

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

= Paso 7: Parar y eliminar contenedores =

Los contenedores podemos pararlos o eliminarlos, veamos como hacerlo. Antes que
nada, borraremos todos los contenedores que estén terminados, para ello:

<syntaxhighlight lang="bash">
podman container prune
podman ps -a
</syntaxhighlight>

Ya lo hemos dejado todo limpio para seguir, ahora vamos a crear un contenedor,
utilizando un comando de linux que no termina, para que así se quede
ejecutándose el contenedor infinitamente:

<syntaxhighlight lang="bash">
podman run -d -ti --name my_container debian bash
podman ps -a
</syntaxhighlight>

Vamos a pararlo (podemos utilizar el nombre dado o el id):

<syntaxhighlight lang="bash">
podman stop my_container
podman stop e4901956f108
podman ps -a
</syntaxhighlight>

Veremos que ya ha terminado, y ahora vamos a eliminarlo, pero solo este
contenedor, no como previamente que eliminamos todos. Lo mismo que para pararlo,
podemos utilizar el nombre o el id.

<syntaxhighlight lang="bash">
podman container rm my_container
podman container rm my_container
podman ps -a
</syntaxhighlight>

Veremos que ya no tenemos el contenedor y está correctamente eliminado.

= Paso 8: Conectarnos a un contenedor que se está ejecutando en segundo plano =

Vamos a ejecutar de nuevo un contenedor que no termine:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a conectarnos a este contenedor que está ejecutándose en segundo
plano:

<syntaxhighlight lang="bash">
podman attach mi-contenedor
</syntaxhighlight>

Veremos la orden bash ejecutándose, para terminar, hacemos un 'CTRL + C', y ahora, veremos que ha pasado con el contenedor:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Lo veremos parado, por que lo que hemos hecho ha sido conectarnos al contenedor
y parar el comando que se estaba ejecutando, así que ahora tenemos el contenedor
finalizado.

''Nota:'' Para salir del contenedor '''sin detenerlo''' hacemos 'CTRL + P' seguido 'CTRL + Q'

= Paso 9: Ejecutar un comando dentro de un contenedor en ejecución =

Vamos a ver otresta vez como ejecutar un comando en un contenedor que ya está
ejecutándose:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a ejecutar un comando en ese contenedor con el nombre ''mi-contenedor''.
El comando exec es similar al comando run, pero para ejecutar un comando dentro de un contenedor:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor ls
</syntaxhighlight>

Ahora estamos dentro del contenedor creado anteriormente:

<syntaxhighlight lang="bash">
ps -a
</syntaxhighlight>

Aquí veremos en el listado de procesos que hay en ejecución.

Ahora vamos a salirnos del contenedor, escribiendo 'exit' o 'CTRL + D', y
comprobemos el estado del contenedor:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Ahora veremos que el contenedor se sigue ejecutando, no como en el paso anterior.

= Paso 10: Persistencia en contenedores =

Al hacer ''exit'' y salir de un contenedor, se pierden todos los cambios que hemos realizado. Los

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-ejemplo debian bash
</syntaxhighlight>

Ahora, vamos a crear una carpeta en el contenedor y comprobar que esa carpeta existe:

<syntaxhighlight lang="bash">
podman exec mi-ejemplo mkdir test
podman exec mi-ejemplo ls
</syntaxhighlight>

Veremos que la carpeta existe, pero, ¿qué ocurre si para el contenedor?

<syntaxhighlight lang="bash">
podman container stop mi-ejemplo
</syntaxhighlight>

Y volvemos a lanzarlo:

<syntaxhighlight lang="bash">
podman container rm mi-ejemplo
podman run -d -ti --name mi-ejemplo debian bash
podman exec mi-ejemplo ls
</syntaxhighlight>

Podemos comprobar que la carpeta creada anteriormente, no existe.

¿Qué podemos hacer para mantener la modificaciones realizadas sobre un contenedor?

== Paso 10.1: Crear una imagen derivada de la imagen base ==

Es posible crear una imagen derivada, con modificaciones, a partir de una imagen existente mediante la orden '''commit'''.

Por ejemplo, si queremos una imagen ''debian'' que incluya el programa ''ping'' ya instalado, tendríamos que lanzar un contenedor a partir de la imagen ''ubuntu'':

<syntaxhighlight lang="bash">
podman run -d -ti debian bash
</syntaxhighlight>

Suponiendo que el contenido está identificado con el ID 56ef5b312334

Instalamos el paquete ping:

<syntaxhighlight lang="bash">
podman exec 56ef5b312334 apt -y install ping
</syntaxhighlight>

Generamos la imagen derivada con el nombre ''ubuntu-con-ping'':

<syntaxhighlight lang="bash">
podman commit 56ef5b312334 ubuntu-con-ping
</syntaxhighlight>

Ya podemos para nuestro contendor:

<syntaxhighlight lang="bash">
podman stop 56ef5b312334
</syntaxhighlight>

Y lanzar un nuevo contenedor a partir de la imagen ''debian-con-ping'':

<syntaxhighlight lang="bash">
podman run -d -ti debian-con-ping bash
</syntaxhighlight>

== Paso 10.2: Mantener la persistencia mediante volúmen ==

Otra opción para mantener los datos es montar un volumen al ejecutar el contenedor.

Primero crearemos una carpeta que hará de volumen en nuestra máquina, que será la que luego montemos para podman:

<syntaxhighlight lang="bash">
mkdir /home/debian/volumen
</syntaxhighlight>

Ahora vamos a montar la carpeta al ejecutar el contenedor, lo hacemos con la
opción -v, la cual tiene 3 campos separados por ':':

# El volumen en nuestra máquina
# Donde se montará el volumen dentro del contenedor
# Opciones de mmontaje, por ejemplo rw (read and write) o ro (read only)

<syntaxhighlight lang="bash">
podman run --rm -ti -v /home/debian/volumen:/volumen:rw debian bash
mkdir /volumen/test
touch /volumen/test/file
exit
</syntaxhighlight>

Una vez nos salgamos del contenedor, podemos ver que en nuestra máquina están
los datos:

<syntaxhighlight lang="bash">
ls /home/ubuntu/volumen/
ls /home/ubuntu/volumen/test
</syntaxhighlight>

La próxima vez que ejecutemos un contenedor, si montamos ese volumen, los datos
estarán ahí, además esta forma tiene el beneficio de compartir datos entre
nuestra máquina y el contenedor de forma sencilla.

= Paso 11: Crear nuestra propia imagen podman =

Para crear una imagen de un contenedor con una aplicación de Python hug, creamos en primer lugar la carpeta que contendrá los ficheros que nos permiten crear la imagen.

<syntaxhighlight lang="bash">
mkdir miapp
cd miapp
</syntaxhighlight>

Definimos un fichero ''Dockerfile'' para definir la imagen:

<syntaxhighlight lang="bash">
FROM ubuntu

RUN apt -y update
RUN apt -y upgrade
RUN apt -y install python3-hug
RUN mkdir /app
COPY endpoint.py /app
WORKDIR /app
CMD hug -f endpoint.py
</syntaxhighlight>

Alternativamente, puedes crear un [[Creando imagen propia usando Ubuntu de base|Dockerfile empleando la imagen de Ubuntu]] como base en lugar de Alpine.

Y añadimos el fichero ''endpoint.py'' que emplea el framework Python hug con el contenido siguiente:

<syntaxhighlight lang="bash">
import hug

@hug.get('/welcome')
def welcome(username="unknown"):
""" Say welcome to username """
return "Welcome " + username
</syntaxhighlight>

Este fichero es un ejemplo de uso de Python hug. Si hacemos una petición a /welcome?username="LSO", esto nos devolverá el mensaje "Welcome LSO".

Una vez tengamos los dos ficheros creados en nuestra máquina virtual, podemos construir nuestra imagen:

<syntaxhighlight lang="bash">
podman build -t app:v1 -f Dockerfile .
</syntaxhighlight>

Vamos a explicar para que sirve cada línea:

* FROM: servirá para basarnos en una imagen existente, en este caso, una imagen de python alpine, que contiene python y no ocupa mucho espacio
* ENV: para crear variables de entorno
* RUN: para ejecutar comandos, ya sea para crear una carpeta, instalar dependencias o cualquier otra opción que necesitemos
* COPY: para copiar datos desde nuestra máquina a la imagen
* WORKDIR: para cambiar el directorio de trabajo
* CMD: este comando será ejecutado por defecto al iniciar un contenedor a partir de esta imagen

Esto construirá una imagen podman basada en python:alpine, en la cual hemos
guardado nuestra pequeña aplicación y se va a ejecutar cuando ejecutemos un
contenedor basado en esa imagen. Para comprobar que la imagen se ha creado
correctamente, listamos las imagenes, y debería de aparecernos una imagen con
nombre 'app' y tag 'v1':

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen, y vamos a añadir una nueva
opción, -p 8001:8000. Esta opción hará que el puerto interno 8000 del contenedor
sea expuesto en el puerto 8001 de nuestra máquina:

<syntaxhighlight lang="bash">
podman run --name my-app --rm -d -p 8001:8000 app:v1
</syntaxhighlight>

''Nota:'' podman supone que la redirección de puerto es TCP, para una redirección de puertos UDP, puedes usar:

<syntaxhighlight lang="bash">
... -p 8001:8000/udp
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código. En nuestra
máquina haremos:

<syntaxhighlight lang="bash">
curl -X GET http://localhost:8001/welcome?username=LSO
</syntaxhighlight>

Comprobaremos que la salida del comando curl, es "Welcome LSO".

Antes de terminar, vamos a comprobar otro pequeño detalle que añadimos en
nuestra imagen, la variable de entorno USERNAME, vamos a comprobar que funciona:

<syntaxhighlight lang="bash">
podman exec -ti my-app ash
echo $USERNAME
</syntaxhighlight>

Funciona correctamente, pero al ejecutar el contenedor, podemos cambiar esta
variable de entorno como vimos en uno de los pasos anteriores:

<syntaxhighlight lang="bash">
podman run --rm -ti -e USERNAME=me app:v1 ash
echo $USERNAME
</syntaxhighlight>

Esto nos servirá para tener opciones por defecto y que el usuario pueda
cambiarlo a su antojo, como por ejemplo contraseñas u otros detalles.

= Paso 12: Eliminar imágenes =

Veremos que después de todas las pruebas que hemos estado haciendo, tenemos
muchas imágenes, y algunas de las cuales no nos servirán o no las utilizaremos,
así que podemos borrarlas para ahorrar espacio.

Al igual que con los contenedores, tenemos una opción para borrar imágenes que
no se utilicen:

<syntaxhighlight lang="bash">
podman image prune
</syntaxhighlight>

Esto borrará imágenes intermedias que se utilizan a veces para construir
nuestras imágenes o imágenes que hemos intentado construir y nos han fallado.

La otra opción para borrar imágenes una a una, sería utilizando el comando
podman rmi y utilizar el nombre de la imagen o el id. Si esta es la salida de
'podman images':

<syntaxhighlight lang="bash">
REPOSITORY TAG IMAGE ID CREATED SIZE
app v1 18609c517d32 14 minutes ago 109MB
python alpine 39fb80313465 23 hours ago 98.7MB
debian latest 85c4fd36a543 13 days ago 114MB
hello-world latest fce289e99eb9 7 months ago 1.84kB
hello-world linux fce289e99eb9 7 months ago 1.84kB
</syntaxhighlight>

Podemos eliminar las imágenes de hello-world:

<syntaxhighlight lang="bash">
podman rmi hello-world
</syntaxhighlight>

ó

<syntaxhighlight lang="bash">
podman rmi fce289e99eb9
</syntaxhighlight>

= Paso 13: Varios podman a la vez (podman-compose) =

Antes de comenzar, vamos a parar todos los contenedores que tengamos abiertos,
para dejar el entorno de podman limpio, que nos vendrá bien para esta parte.

Cuando queremos ejecutar varios contenedores a la vez y que estén conectados
entre ellos fácilmente, utilizaremos podman-compose, donde con un fichero de
configuración simple en yaml, tendremos toda la configuración de lo que vamos a
ejecutar.

Primero vamos a instalar podman-compose:

<syntaxhighlight lang="bash">
sudo apt install podman-compose
</syntaxhighlight>

Ahora veamos un pequeño ejemplo donde explicaremos todos los detalles para crear
un podman-compose, en este caso, el nombre por defecto de los ficheros suele ser
podman-compose.yml, y el contenido será similar a:

<syntaxhighlight lang="bash">
version: '3'

services:
web:
container_name: web
restart: always
build:
context: .
ports:
- "8000:8000"
volumes:
- /home/ubuntu/volume:/volumen:rw
environment:
USERNAME: test
web2:
container_name: web2
build:
dockerfile: Dockerfile
context: .
depends_on:
- web
command: touch web2
web3:
container_name: web3
restart: on-failure
image: pstauffer/curl
depends_on:
- web
command: curl -X GET web:8000/welcome?username=web3
</syntaxhighlight>

En el podman-compose definimos diferentes servicios a ejecutar, en nuestro caso
hemos iniciado tres servicios diferentes, web, web2 y web3:

El primer servicio, web:

* container_name: para darle un nombre por defecto al contenedor cuando se cree
* restart: pueden ser:
** "no": si la máquina termina, no se vuelve a iniciar (opción por defecto)
** always: siempre que el contenedor termine, intenta iniciarse de nuevo
** on-failure: solo intenta reiniciarse si el contenedor termina con fallo
** unless-stopped: solo reinicia el contenedor si el usuario es el que lo termina
* Utilizará el fichero Dockerfile creado en el paso 11 para generar la imagen a usar.
* Expondrá el puerto 8000 del contenedor en el 8000 de nuestra máquina
* Montará un volumen, se hace de forma similar a la línea de comandos
* Creará una variable de entorno

El segundo servicio, web2:

* Utilizará el fichero Dockerfile también, la diferencia entre este y el primer servicio, es que si el nombre del Dockerfile cambia, tendremos que hacerlo de esta segunda forma, la primera por defecto solo buscará el fichero Dockerfile
* depends_on hará que para ejecutar este servicio, su dependencia tenga ya que estar iniciada
* Ejecutaremos un comando el cual sustituirá al comando de la imagen

El tercer servicio, web3:

* Utilizará la imagen ostauffer/curl que es un imagen mínima que contiene el comando curl
* restart: en este caso, hasta que el comando no se ejecute correctamente, se seguirá reiniciando el contenedor
* depends_on igual que el servicio 2, dependerá del servicio 1
* Ejecutaremos un comando para llamar desde el servicio 3 al servicio 1

== Paso 13.1: Construir podman-compose ==

En el caso de existir servicios que tengan Dockerfiles, esto hará que se construyan previamente, como hacer un podman build de cada uno de los servicios que contenga un Dockerfile:

<syntaxhighlight lang="bash">
podman-compose build
</syntaxhighlight>

Con esto se generarán las imágenes necesarias para ejecutar todos los servicios.

== Paso 13.2: Iniciar podman-compose ==

Para iniciar todos los servicios, ejecutaremos:

<syntaxhighlight lang="bash">
podman-compose up -d
</syntaxhighlight>

Después de esto podremos ver el logs de todos los servicios:

<syntaxhighlight lang="bash">
podman-compose logs -f
</syntaxhighlight>

Aquí veremos que el servicio 3 ha conseguido llamar correctamente al servicio 1.

Ahora veremos como podman-compose ha creado los contenedores:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

La salida será similar a la siguiente:

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
219a4118244c pstauffer/curl "curl -X GET web:800…" 6 seconds ago Exited (0) 3 seconds ago web3
c97e894cb3ae ubuntu_web2 "touch web2" 6 seconds ago Exited (0) 4 seconds ago web2
f35d034204fc ubuntu_web "/bin/sh -c 'hug -f …" 6 seconds ago Up 5 seconds 0.0.0.0:8000->8000/tcp web
</syntaxhighlight>

Aquí vemos varios detalles:

* El nombre que le hemos dado en el podman-compose ha funcionado correctamente
* Vemos que los comandos son los correctos también
* web2 está parado por que la política de reinicio es apagar cuando se termine de ejecutar un comando
* web 3 está parado por que el comando ha terminado con un salida correcta

Vamos a comprobar ahora que en el servicio web está todo correcto:

<syntaxhighlight lang="bash">
podman exec -ti web ash
echo $USERNAME
ls /volumen
exit
</syntaxhighlight>

Podemos comprobar que tanto cambiar la variable de entorno como crear un
volumen ha funcionado correctamente.

== Paso 13.3: Parar podman-compose ==

Para parar todos los servicios:

<syntaxhighlight lang="bash">
podman-compose down
</syntaxhighlight>

Comprobamos:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Vemos que han desaparecido todos los contenedores.

= Paso 14: Ejercicios =

== Ejercicio 1: Variante de httpd ==

Construya una imagen ''httpd-hola-mundo'' a partir de la imagen ''httpd''. El fichero de index.html de la carpeta htdocs/ tiene que mostrar el mensaje "hola mundo".

<syntaxhighlight lang="bash">
docker pull httpd
</syntaxhighlight>

Edita el fichero Dockerfile:

<syntaxhighlight lang="bash">
nano Dockerfile
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
FROM httpd

COPY index.html htdocs/index.html
</syntaxhighlight>

Edita el fichero index.html:

<syntaxhighlight lang="bash">
nano index.html
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

Construye la imagen:

<syntaxhighlight lang="bash">
docker build -t mihttpd -f Dockerfile .
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen:

<syntaxhighlight lang="bash">
sudo docker run --name mihttpd -d -p 8080:80 mihttpd
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código:
<syntaxhighlight lang="bash">
curl -X GET http://localhost:8080
</syntaxhighlight>

Tiene que salir por pantalla esto:
<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

== Ejercicio 2: aplicación flask ==

Flask es un framework python para implementar webs. Cree una imagen "miapp-flask" a partir de la imagen de "python":

* Instale flask mediante: pip install flask
* Cree la carpeta "app"
* Establezca la variable FLASK_APP a "hello.py"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"

El fichero hello.py contiene un "hola mundo" para Flask:

<syntaxhighlight lang="python">
from flask import Flask
app = Flask(__name__)

@app.route("/")
def hello():
return "Hello World!"

if __name__ == "__main__":
app.run()
</syntaxhighlight>

Solución con alpine:

<syntaxhighlight lang="bash">
FROM python:alpine

RUN mkdir /app
RUN pip install flask
ENV FLASK_APP="app/hello.py"
COPY hello.py
WORKDIR /
CMD flask run --host=0.0.0.0
</syntaxhighlight>

Solución con Ubuntu:

<syntaxhighlight lang="bash">
FROM ubuntu:bionic

RUN apt-get update
RUN apt-get -y install python python-pip wget
RUN pip install Flask
ENV FLASK_APP="app/hello.py"
RUN mkdir /app
COPY hello.py /app
CMD flask run --host=0.0.0.0
</syntaxhighlight>

== Ejercicio 3: mysql ==

'''EN LA MÁQUINA VIRTUAL:'''

mkdir miapp

cd miapp

sudo docker pull mysql

nano Dockerfile

<syntaxhighlight lang="bash">
FROM mysql
ENV MYSQL_ROOT_PASSWORD="lacontraseñaqueyoquiera"
RUN mkdir /app
WORKDIR /app

</syntaxhighlight>

CTRL+O , ENTER Y CTRL+X (para guardar Dockerfile y salir)

sudo docker build -ti mrfdocker -f Dockerfile .

sudo docker run --name mymrf --rm -p 8001:3306 mrfdocker

sudo docker images

'''EN LA TERMINAL DEL HOST:'''

''Instalación de mysql:''

sudo apt install mysql-client-core-5.7

> sudo apt-get install mysql-server

> sudo service mysql start

''Para entrar:''

sudo mysql -u root -p -P 8001

Una vez dentro de msql:

mysql> show databases;
''
Para salir:''

exit

== Ejercicio 5: python pyramid ==

Pyramid es un framework python para implementar webs. Cree una imagen "miapp-pyramid":

* Emplee la imagen de Ubuntu como referencia, instale los paquetes python y python-pip.
* Instale Pyramid mediante: pip install pyramid
* Cree la carpeta "app"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"
* La aplicación se lanza con la orden: python hello.py
* Compruebe que funciona con curl, la ruta a la web es http://127.0.0.1:8000/hello, suponiendo que ha empleado el puerto 8000 para exponer el servicio.

El fichero hello.py contiene un "hola mundo" para Pyramid:

<syntaxhighlight lang="bash">
from wsgiref.simple_server import make_server
from pyramid.config import Configurator
from pyramid.response import Response

def hello_world(request):
print('Request inbound!')
return Response('Docker works with Pyramid!')

if __name__ == '__main__':
config = Configurator()
config.add_route('hello', '/')
config.add_view(hello_world, route_name='hello')
app = config.make_wsgi_app()
server = make_server('0.0.0.0', 6543, app)
server.serve_forever()
</syntaxhighlight>

Este programa recibe peticiones en el puerto 6543.

== Ejercicio 6 ==

Cree una imagen derivada de Ubuntu, instale el paquete apache2, php y libapache2-mod-php.
Active el módulo de php para apache2 mediante la orden:

<syntaxhighlight lang="bash">
a2enmod php
</syntaxhighlight>

Cree la carpeta /var/www/php.

Cree el fichero index.php

<syntaxhighlight lang="php">
<?php
Print "Hello, World!";
?>
</syntaxhighlight>

y copielo a /var/www/php/.

Cree el fichero 000-default.conf y copielo a /etc/apache2/sites-enabled/

Dicho fichero contiene.

<syntaxhighlight lang="bash">
<VirtualHost *:80>
DocumentRoot /var/www/php

<Directory /var/www/php/>
Options Indexes FollowSymLinks MultiViews
AllowOverride All
Order deny,allow
Allow from all
</Directory>

ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>
</syntaxhighlight>

Tiene que lanzar apache con la orden: apachectl -D FOREGROUND

Tras crear la imagen, láncela mapeando el puerto 8888 al 80, pruebe que puede acceder a http://127.0.0.1:8888/php/ mediante curl

Solución:

<syntaxhighlight lang="bash">
FROM ubuntu:latest

RUN apt-get update
RUN apt-get install -y tzdata
RUN apt-get install -y apache2
RUN apt-get install -y php
RUN apt-get install -y libapache2-mod-php
RUN a2enmod php7.2
COPY index.php /var/www/php
COPY 000-default.conf /etc/apache2/sites-enabled/
CMD apachectl -D FOREGROUND
</syntaxhighlight>

Y para lanzarlo:

docker run --name my-app --rm -d -p 8001:8000 app:v1

y para probarlo:

curl -X GET http://127.0.0.1:8888/php/

== Ejercicio 7 ==

Instale el paquete ''netcat-traditional'' en una imagen de contenedor de ''ubuntu''. Lance la orden:

nc -u -l -p 8080

en el contenedor. Asegúrese de crear una redirección de puertos de 9999 desde el ''host'' al puerto 8080 en el contenedor.

Desde fuera del contenedor, pruebe a conectarse con:

nc -u 127.0.0.1 9999

== Ejercicio 8 ==

Cree una imagen derivada de "ubuntu" con un Dockerfile que incluya soporte de python y lance el siguiente código en Python:

<syntax lang="python">
from http.server import BaseHTTPRequestHandler, HTTPServer
import time

hostName = "0.0.0.0"
serverPort = 8080

class MyServer(BaseHTTPRequestHandler):
def do_GET(self):
self.send_response(200)
self.send_header("Content-type", "text/html")
self.end_headers()
self.wfile.write(bytes("<html><head><title>Welcome!</title></head>", "utf-8"))
self.wfile.write(bytes("<body>", "utf-8"))
self.wfile.write(bytes("This is an example web server.", "utf-8"))
self.wfile.write(bytes("</body></html>", "utf-8"))

if __name__ == "__main__":
webServer = HTTPServer((hostName, serverPort), MyServer)
print("Server started http://%s:%s" % (hostName, serverPort))

try:
webServer.serve_forever()
except KeyboardInterrupt:
pass

webServer.server_close()
print("Server stopped.")
</syntax>

Llame a su imagen "python-http-server". Lance una instancia de la imagen "python-http-server" mapeando el puerto 9999 al puerto 8888/tcp del contenedor. Compruebe con:

<syntax lang="bash">
curl http://127.0.0.1:9999/
</syntax>

que muestre la página HTML que ofrece el servidor, que debería ser:

<syntax lang="bash">
<html><head><title>Welcome!</title></head><body>This is an example web server.</body></html>
</syntax>

Contenedores

2025-12-09T10:52:41Z

Pneira: /* Paso 9: Ejecutar en un contenedor otro comando */

En esta práctica aprenderemos a utilizar [https://es.wikipedia.org/wiki/Podman podman] para desplegar contenedores.

= Paso 1: Instalar podman =

Para instalar el paquete oficial:

<syntaxhighlight lang="bash">
apt install podman
</syntaxhighlight>

podman es un clon de '''docker''.

= Paso 2: Repositorio de imágenes de contenedores DockerHub =

Docker ofrece un servicio de nube denominado ''DockerHub'' que puede ser empleado como red social para compartir tus imágenes de Podman. En ''DockerHub'' existen además imágenes de contenedores preconfiguradas de software, muchas de ellas oficiales (ofrecidas por el propio fabricante del software) que se podrán emplear como base para construir nuevas imágenes adaptadas a nuestras necesidades.

Podremos realizar búsquedas en este repositorio ''DockerHub'' puedes emplear el siguiente comando:

<syntaxhighlight lang="bash">
podman search docker.io/library/hello-world
</syntaxhighlight>

Para descargarnos la imagen de ''hello-world'' podemos usar la orden ''pull'':

<syntaxhighlight lang="bash">
podman pull hello-world
</syntaxhighlight>

También podemos publicar imágenes propias, esto require '''registro de usuario''' en la nube de ''DockerHub'', lo que '''no''' es obligatorio para la realización de esta práctica. Para subir una imagen, hay que validarse como usuario en la nube de ''DockerHub'':

<syntaxhighlight lang="bash">
podman login
</syntaxhighlight>

Tras introducir tu usuario y contraseña, puedes comenzar a publicar tus propias imágenes.

<syntaxhighlight lang="bash">
podman push MI_IMAGEN
</syntaxhighlight>

Este paso es '''opcional''', sólo en caso de que se quieran subir imágenes de contenedores a la nube de docker.io.

= Paso 4: Comprobar imágenes en nuestra máquina =

Para ver las imágenes que tenemos en nuestra máquina, utilizaremos el comando:

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Inicialmente, no tenemos imágenes en almacenamiento, podemos descargarnos la imagen oficial de Debian 13 (Trixie):

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian
</syntaxhighlight>

Ahora si, ya debería de aparecernos la imagen ''debian''.

Comentar también que cada imagen puede tener varias etiquetas, por ejemplo, la imagen Debian 12 (Bookworm), cuando la hemos visto en el listado de imágenes, venía con el tag latest, que es el tag que se descarga por defecto, pero nosotros podemos especificar otro, por ejemplo:

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian:bookworm
</syntaxhighlight>

Para traernos la versión de la imagen de Debian 12 ''Bookworm''.

Ahora tendremos dos imágenes con diferente etiqueta, que serían como las diferentes versiones de cada imagen.

= Paso 5: Lanzar un contenedor =

Un contenedor no es más que una imagen de podman ejecutándose, sería similar a
una máquina virtual, aunque mucho más liviano.

Para crear un contenedor, utilizaremos una imagen, en este caso, la imagen
hello-world. Hacemos lo siguiente:

<syntaxhighlight lang="bash">
podman run hello-world
</syntaxhighlight>

Esto nos mostrará el siguiente mensaje si todo está correcto:

<syntaxhighlight lang="bash">
Hello from Docker!
This message shows that your installation appears to be working correctly.

To generate this message, Docker took the following steps:
1. The Docker client contacted the Docker daemon.
2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
(amd64)
3. The Docker daemon created a new container from that image which runs the
executable that produces the output you are currently reading.
4. The Docker daemon streamed that output to the Docker client, which sent it
to your terminal.

To try something more ambitious, you can run an Debian container with:
$ podman run -it debian bash

Share images, automate workflows, and more with a free Docker ID:
https://hub.docker.com/

For more examples and ideas, visit:
https://docs.docker.com/get-started/
</syntaxhighlight>

Al crear los contenedores utilizando el comando 'run', tenemos varias opciones:

* Lanzar una terminal en el contenedor en modo interactivo
* Lanzar en segundo plano y conectarnos posteriormente al contenedor

== Paso 5.1: Lanzar una terminal en el contenedor en modo interactivo (-ti) ==

Para este ejemplo vamos a utilizar otra imagen diferente, en este caso vamos a utilizar una imagen de debian.

Vamos a lanzar un contenedor y ejecutar una terminal en el que se va a ejecutar el programa '''bash''' que me ofrece un interprete de órdenes:

<syntaxhighlight lang="bash">
podman run -ti debian bash
</syntaxhighlight>

La opción ''-t'' indica que se crea un terminal en el contenedor. Y la opción ''-i'' indica que el contenedor se ejecuta en modo interactivo.

Al acceder al contenedor de ''debian'' nos aparece un ''hash'' en el prompt de la shell, que identifica a la instancia del contenedor (es valor es similar al que muestra la orden ''podman container ls'').

Para salir del contenedor, escribimos 'exit' o pulsamos ''CTRL + D''

== Paso 5.2 Lanzar en segundo plano (-d) ==

Otro ejemplo, con la imagen de Debian:

<syntaxhighlight lang="bash">
podman run -dti debian
</syntaxhighlight>

que muestra un hash que identifica de forma única el contenedor lanzado:

<syntaxhighlight lang="bash">
2ec1daae4676a4e84dc04fd91399c1dfe92119544ff12ee307991fe573d3db64
</syntaxhighlight>

Mediante el comando ''attach'' puedo entrar al contenedor:

<syntaxhighlight lang="bash">
podman attach 2ec1daae4676
</syntaxhighlight>

Para salir, pulsamos ''CTRL + P'' seguido de ''CTRL + Q''.

De manera similar, puedo lanzar en segundo plano la imagen de contenedor de ''hello-world'':

<syntaxhighlight lang="bash">
podman run -d hello-world
</syntaxhighlight>

Y consultar los logs:

<syntaxhighlight lang="bash">
podman logs b67fae3312bc321
</syntaxhighlight>

== Paso 5.3: Añadir variables de entorno a un contenedor ==

Utilizaremos la imagen anterior, y vamos a añadir una variable de entorno
llamada TEST que contenga el valor 'test'. A parte, también ejecutaremos la
terminal como antes, para comprobar con el comando echo, que la variable de
entorno está creada correctamente:

<syntaxhighlight lang="bash">
podman run -ti -e TEST=test debian bash
</syntaxhighlight>

Ahora, desde el contenedor podemos comprobar el valor de la variable de entorno ''$TEST''.

<syntaxhighlight lang="bash">
echo $TEST
test
</syntaxhighlight>

= Paso 6: Listar contenedores en ejecución =

Hemos estado haciendo pruebas y ejecutando contenedores en el paso anterior, vamos a ver donde se encuentran estos contenedores que hemos ejecutado, y después veremos algunas opciones más del comando run.

Tenemos dos opciones para ver los contenedores:

<syntaxhighlight lang="bash">
podman container ls -a
</syntaxhighlight>

o la versión corta:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Ambas hacen lo mismo, y debería de mostrarnos una salida similar a la siguiente:

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
e2bde5f5500c debian "bash" 6 minutes ago Exited (0) 2 seconds ago pensive_sammet
544ad27dbc3c debian "bash" 7 minutes ago Exited (0) 7 minutes ago serene_elgamal
</syntaxhighlight>

En la información veremos que el contenedor tiene el estado exited, eso quiere decir que no se está ejecutando y ya ha finalizado. Vamos a hacer una prueba para ver un contendor ejecutándose:

<syntaxhighlight lang="bash">
podman run -d debian sleep 30
</syntaxhighlight>

Con el comando sleep 30 esperamos 30 segundos hasta que termine el comando, asíque durante esos 30 segundos, el contenedor estará ejecutándose, veámoslo:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
eacceb27d52d debian "sleep 30" 12 seconds ago Up 11 seconds sharp_pasteur
</syntaxhighlight>

Vamos a ver alguna opciones más de la orden ''run''.

== Paso 6.1: Dar un nombre al contenedor (--name) ==

Por defecto, podman creará automáticamente un nombre como hemos visto en las salidas del comando ''podman ps -a''. Podemos establecer el nombre del contenedor que queramos con la opción ''--name'':

<syntaxhighlight lang="bash">
podman run -ti --name mi_debian debian
</syntaxhighlight>

== Paso 6.2: Eliminar contenedor cuando termine (--rm) ==

Vamos a mezclar todo lo visto anteriormente:

* Lanzar en segundo plano (-d)
* Ejecutar contenedor durante 30 segundos (sleep 30)
* Dar un nombre a la imagen (--name)
* Eliminar contenedor cuando termine (--rm)

<syntaxhighlight lang="bash">
podman run -d --rm --name bye-bye debian sleep 30
</syntaxhighlight>

Antes y una vez pasados los 30 segundos, podemos comprobar que el contenedor ha desaparecido.

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

= Paso 7: Parar y eliminar contenedores =

Los contenedores podemos pararlos o eliminarlos, veamos como hacerlo. Antes que
nada, borraremos todos los contenedores que estén terminados, para ello:

<syntaxhighlight lang="bash">
podman container prune
podman ps -a
</syntaxhighlight>

Ya lo hemos dejado todo limpio para seguir, ahora vamos a crear un contenedor,
utilizando un comando de linux que no termina, para que así se quede
ejecutándose el contenedor infinitamente:

<syntaxhighlight lang="bash">
podman run -d -ti --name my_container debian bash
podman ps -a
</syntaxhighlight>

Vamos a pararlo (podemos utilizar el nombre dado o el id):

<syntaxhighlight lang="bash">
podman stop my_container
podman stop e4901956f108
podman ps -a
</syntaxhighlight>

Veremos que ya ha terminado, y ahora vamos a eliminarlo, pero solo este
contenedor, no como previamente que eliminamos todos. Lo mismo que para pararlo,
podemos utilizar el nombre o el id.

<syntaxhighlight lang="bash">
podman container rm my_container
podman container rm my_container
podman ps -a
</syntaxhighlight>

Veremos que ya no tenemos el contenedor y está correctamente eliminado.

= Paso 8: Conectarnos a un contenedor que se está ejecutando en segundo plano =

Vamos a ejecutar de nuevo un contenedor que no termine:

<syntaxhighlight lang="bash">
podman run -d -ti --name to_attach debian bash
</syntaxhighlight>

Ahora, vamos a conectarnos a este contenedor que está ejecutándose en segundo
plano:

<syntaxhighlight lang="bash">
podman attach to_attach
</syntaxhighlight>

Veremos la orden bash ejecutándose, para terminar, hacemos un 'CTRL + C', y ahora, veremos que ha pasado con el contenedor:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Lo veremos parado, por que lo que hemos hecho ha sido conectarnos al contenedor
y parar el comando que se estaba ejecutando, así que ahora tenemos el contenedor
finalizado.

''Nota:'' Para salir del contenedor '''sin detenerlo''' hacemos 'CTRL + P' seguido 'CTRL + Q'

= Paso 9: Ejecutar un comando dentro de un contenedor en ejecución =

Vamos a ver otresta vez como ejecutar un comando en un contenedor que ya está
ejecutándose:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a ejecutar un comando en ese contenedor con el nombre ''mi-contenedor''.
El comando exec es similar al comando run, pero para ejecutar un comando dentro de un contenedor:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor ls
</syntaxhighlight>

Ahora estamos dentro del contenedor creado anteriormente:

<syntaxhighlight lang="bash">
ps -a
</syntaxhighlight>

Aquí veremos en el listado de procesos que hay en ejecución.

Ahora vamos a salirnos del contenedor, escribiendo 'exit' o 'CTRL + D', y
comprobemos el estado del contenedor:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Ahora veremos que el contenedor se sigue ejecutando, no como en el paso anterior.

= Paso 10: Persistencia en contenedores =

Al hacer ''exit'' y salir de un contenedor, se pierden todos los cambios que hemos realizado. Los

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-ejemplo debian bash
</syntaxhighlight>

Ahora, vamos a crear una carpeta en el contenedor y comprobar que esa carpeta existe:

<syntaxhighlight lang="bash">
podman exec mi-ejemplo mkdir test
podman exec mi-ejemplo ls
</syntaxhighlight>

Veremos que la carpeta existe, pero, ¿qué ocurre si para el contenedor?

<syntaxhighlight lang="bash">
podman container stop mi-ejemplo
</syntaxhighlight>

Y volvemos a lanzarlo:

<syntaxhighlight lang="bash">
podman container rm mi-ejemplo
podman run -d -ti --name mi-ejemplo debian bash
podman exec mi-ejemplo ls
</syntaxhighlight>

Podemos comprobar que la carpeta creada anteriormente, no existe.

¿Qué podemos hacer para mantener la modificaciones realizadas sobre un contenedor?

== Paso 10.1: Crear una imagen derivada de la imagen base ==

Es posible crear una imagen derivada, con modificaciones, a partir de una imagen existente mediante la orden '''commit'''.

Por ejemplo, si queremos una imagen ''debian'' que incluya el programa ''ping'' ya instalado, tendríamos que lanzar un contenedor a partir de la imagen ''ubuntu'':

<syntaxhighlight lang="bash">
podman run -d -ti debian bash
</syntaxhighlight>

Suponiendo que el contenido está identificado con el ID 56ef5b312334

Instalamos el paquete ping:

<syntaxhighlight lang="bash">
podman exec 56ef5b312334 apt -y install ping
</syntaxhighlight>

Generamos la imagen derivada con el nombre ''ubuntu-con-ping'':

<syntaxhighlight lang="bash">
podman commit 56ef5b312334 ubuntu-con-ping
</syntaxhighlight>

Ya podemos para nuestro contendor:

<syntaxhighlight lang="bash">
podman stop 56ef5b312334
</syntaxhighlight>

Y lanzar un nuevo contenedor a partir de la imagen ''debian-con-ping'':

<syntaxhighlight lang="bash">
podman run -d -ti debian-con-ping bash
</syntaxhighlight>

== Paso 10.2: Mantener la persistencia mediante volúmen ==

Otra opción para mantener los datos es montar un volumen al ejecutar el contenedor.

Primero crearemos una carpeta que hará de volumen en nuestra máquina, que será la que luego montemos para podman:

<syntaxhighlight lang="bash">
mkdir /home/debian/volumen
</syntaxhighlight>

Ahora vamos a montar la carpeta al ejecutar el contenedor, lo hacemos con la
opción -v, la cual tiene 3 campos separados por ':':

# El volumen en nuestra máquina
# Donde se montará el volumen dentro del contenedor
# Opciones de mmontaje, por ejemplo rw (read and write) o ro (read only)

<syntaxhighlight lang="bash">
podman run --rm -ti -v /home/debian/volumen:/volumen:rw debian bash
mkdir /volumen/test
touch /volumen/test/file
exit
</syntaxhighlight>

Una vez nos salgamos del contenedor, podemos ver que en nuestra máquina están
los datos:

<syntaxhighlight lang="bash">
ls /home/ubuntu/volumen/
ls /home/ubuntu/volumen/test
</syntaxhighlight>

La próxima vez que ejecutemos un contenedor, si montamos ese volumen, los datos
estarán ahí, además esta forma tiene el beneficio de compartir datos entre
nuestra máquina y el contenedor de forma sencilla.

= Paso 11: Crear nuestra propia imagen podman =

Para crear una imagen de un contenedor con una aplicación de Python hug, creamos en primer lugar la carpeta que contendrá los ficheros que nos permiten crear la imagen.

<syntaxhighlight lang="bash">
mkdir miapp
cd miapp
</syntaxhighlight>

Definimos un fichero ''Dockerfile'' para definir la imagen:

<syntaxhighlight lang="bash">
FROM ubuntu

RUN apt -y update
RUN apt -y upgrade
RUN apt -y install python3-hug
RUN mkdir /app
COPY endpoint.py /app
WORKDIR /app
CMD hug -f endpoint.py
</syntaxhighlight>

Alternativamente, puedes crear un [[Creando imagen propia usando Ubuntu de base|Dockerfile empleando la imagen de Ubuntu]] como base en lugar de Alpine.

Y añadimos el fichero ''endpoint.py'' que emplea el framework Python hug con el contenido siguiente:

<syntaxhighlight lang="bash">
import hug

@hug.get('/welcome')
def welcome(username="unknown"):
""" Say welcome to username """
return "Welcome " + username
</syntaxhighlight>

Este fichero es un ejemplo de uso de Python hug. Si hacemos una petición a /welcome?username="LSO", esto nos devolverá el mensaje "Welcome LSO".

Una vez tengamos los dos ficheros creados en nuestra máquina virtual, podemos construir nuestra imagen:

<syntaxhighlight lang="bash">
podman build -t app:v1 -f Dockerfile .
</syntaxhighlight>

Vamos a explicar para que sirve cada línea:

* FROM: servirá para basarnos en una imagen existente, en este caso, una imagen de python alpine, que contiene python y no ocupa mucho espacio
* ENV: para crear variables de entorno
* RUN: para ejecutar comandos, ya sea para crear una carpeta, instalar dependencias o cualquier otra opción que necesitemos
* COPY: para copiar datos desde nuestra máquina a la imagen
* WORKDIR: para cambiar el directorio de trabajo
* CMD: este comando será ejecutado por defecto al iniciar un contenedor a partir de esta imagen

Esto construirá una imagen podman basada en python:alpine, en la cual hemos
guardado nuestra pequeña aplicación y se va a ejecutar cuando ejecutemos un
contenedor basado en esa imagen. Para comprobar que la imagen se ha creado
correctamente, listamos las imagenes, y debería de aparecernos una imagen con
nombre 'app' y tag 'v1':

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen, y vamos a añadir una nueva
opción, -p 8001:8000. Esta opción hará que el puerto interno 8000 del contenedor
sea expuesto en el puerto 8001 de nuestra máquina:

<syntaxhighlight lang="bash">
podman run --name my-app --rm -d -p 8001:8000 app:v1
</syntaxhighlight>

''Nota:'' podman supone que la redirección de puerto es TCP, para una redirección de puertos UDP, puedes usar:

<syntaxhighlight lang="bash">
... -p 8001:8000/udp
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código. En nuestra
máquina haremos:

<syntaxhighlight lang="bash">
curl -X GET http://localhost:8001/welcome?username=LSO
</syntaxhighlight>

Comprobaremos que la salida del comando curl, es "Welcome LSO".

Antes de terminar, vamos a comprobar otro pequeño detalle que añadimos en
nuestra imagen, la variable de entorno USERNAME, vamos a comprobar que funciona:

<syntaxhighlight lang="bash">
podman exec -ti my-app ash
echo $USERNAME
</syntaxhighlight>

Funciona correctamente, pero al ejecutar el contenedor, podemos cambiar esta
variable de entorno como vimos en uno de los pasos anteriores:

<syntaxhighlight lang="bash">
podman run --rm -ti -e USERNAME=me app:v1 ash
echo $USERNAME
</syntaxhighlight>

Esto nos servirá para tener opciones por defecto y que el usuario pueda
cambiarlo a su antojo, como por ejemplo contraseñas u otros detalles.

= Paso 12: Eliminar imágenes =

Veremos que después de todas las pruebas que hemos estado haciendo, tenemos
muchas imágenes, y algunas de las cuales no nos servirán o no las utilizaremos,
así que podemos borrarlas para ahorrar espacio.

Al igual que con los contenedores, tenemos una opción para borrar imágenes que
no se utilicen:

<syntaxhighlight lang="bash">
podman image prune
</syntaxhighlight>

Esto borrará imágenes intermedias que se utilizan a veces para construir
nuestras imágenes o imágenes que hemos intentado construir y nos han fallado.

La otra opción para borrar imágenes una a una, sería utilizando el comando
podman rmi y utilizar el nombre de la imagen o el id. Si esta es la salida de
'podman images':

<syntaxhighlight lang="bash">
REPOSITORY TAG IMAGE ID CREATED SIZE
app v1 18609c517d32 14 minutes ago 109MB
python alpine 39fb80313465 23 hours ago 98.7MB
debian latest 85c4fd36a543 13 days ago 114MB
hello-world latest fce289e99eb9 7 months ago 1.84kB
hello-world linux fce289e99eb9 7 months ago 1.84kB
</syntaxhighlight>

Podemos eliminar las imágenes de hello-world:

<syntaxhighlight lang="bash">
podman rmi hello-world
</syntaxhighlight>

ó

<syntaxhighlight lang="bash">
podman rmi fce289e99eb9
</syntaxhighlight>

= Paso 13: Varios podman a la vez (podman-compose) =

Antes de comenzar, vamos a parar todos los contenedores que tengamos abiertos,
para dejar el entorno de podman limpio, que nos vendrá bien para esta parte.

Cuando queremos ejecutar varios contenedores a la vez y que estén conectados
entre ellos fácilmente, utilizaremos podman-compose, donde con un fichero de
configuración simple en yaml, tendremos toda la configuración de lo que vamos a
ejecutar.

Primero vamos a instalar podman-compose:

<syntaxhighlight lang="bash">
sudo apt install podman-compose
</syntaxhighlight>

Ahora veamos un pequeño ejemplo donde explicaremos todos los detalles para crear
un podman-compose, en este caso, el nombre por defecto de los ficheros suele ser
podman-compose.yml, y el contenido será similar a:

<syntaxhighlight lang="bash">
version: '3'

services:
web:
container_name: web
restart: always
build:
context: .
ports:
- "8000:8000"
volumes:
- /home/ubuntu/volume:/volumen:rw
environment:
USERNAME: test
web2:
container_name: web2
build:
dockerfile: Dockerfile
context: .
depends_on:
- web
command: touch web2
web3:
container_name: web3
restart: on-failure
image: pstauffer/curl
depends_on:
- web
command: curl -X GET web:8000/welcome?username=web3
</syntaxhighlight>

En el podman-compose definimos diferentes servicios a ejecutar, en nuestro caso
hemos iniciado tres servicios diferentes, web, web2 y web3:

El primer servicio, web:

* container_name: para darle un nombre por defecto al contenedor cuando se cree
* restart: pueden ser:
** "no": si la máquina termina, no se vuelve a iniciar (opción por defecto)
** always: siempre que el contenedor termine, intenta iniciarse de nuevo
** on-failure: solo intenta reiniciarse si el contenedor termina con fallo
** unless-stopped: solo reinicia el contenedor si el usuario es el que lo termina
* Utilizará el fichero Dockerfile creado en el paso 11 para generar la imagen a usar.
* Expondrá el puerto 8000 del contenedor en el 8000 de nuestra máquina
* Montará un volumen, se hace de forma similar a la línea de comandos
* Creará una variable de entorno

El segundo servicio, web2:

* Utilizará el fichero Dockerfile también, la diferencia entre este y el primer servicio, es que si el nombre del Dockerfile cambia, tendremos que hacerlo de esta segunda forma, la primera por defecto solo buscará el fichero Dockerfile
* depends_on hará que para ejecutar este servicio, su dependencia tenga ya que estar iniciada
* Ejecutaremos un comando el cual sustituirá al comando de la imagen

El tercer servicio, web3:

* Utilizará la imagen ostauffer/curl que es un imagen mínima que contiene el comando curl
* restart: en este caso, hasta que el comando no se ejecute correctamente, se seguirá reiniciando el contenedor
* depends_on igual que el servicio 2, dependerá del servicio 1
* Ejecutaremos un comando para llamar desde el servicio 3 al servicio 1

== Paso 13.1: Construir podman-compose ==

En el caso de existir servicios que tengan Dockerfiles, esto hará que se construyan previamente, como hacer un podman build de cada uno de los servicios que contenga un Dockerfile:

<syntaxhighlight lang="bash">
podman-compose build
</syntaxhighlight>

Con esto se generarán las imágenes necesarias para ejecutar todos los servicios.

== Paso 13.2: Iniciar podman-compose ==

Para iniciar todos los servicios, ejecutaremos:

<syntaxhighlight lang="bash">
podman-compose up -d
</syntaxhighlight>

Después de esto podremos ver el logs de todos los servicios:

<syntaxhighlight lang="bash">
podman-compose logs -f
</syntaxhighlight>

Aquí veremos que el servicio 3 ha conseguido llamar correctamente al servicio 1.

Ahora veremos como podman-compose ha creado los contenedores:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

La salida será similar a la siguiente:

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
219a4118244c pstauffer/curl "curl -X GET web:800…" 6 seconds ago Exited (0) 3 seconds ago web3
c97e894cb3ae ubuntu_web2 "touch web2" 6 seconds ago Exited (0) 4 seconds ago web2
f35d034204fc ubuntu_web "/bin/sh -c 'hug -f …" 6 seconds ago Up 5 seconds 0.0.0.0:8000->8000/tcp web
</syntaxhighlight>

Aquí vemos varios detalles:

* El nombre que le hemos dado en el podman-compose ha funcionado correctamente
* Vemos que los comandos son los correctos también
* web2 está parado por que la política de reinicio es apagar cuando se termine de ejecutar un comando
* web 3 está parado por que el comando ha terminado con un salida correcta

Vamos a comprobar ahora que en el servicio web está todo correcto:

<syntaxhighlight lang="bash">
podman exec -ti web ash
echo $USERNAME
ls /volumen
exit
</syntaxhighlight>

Podemos comprobar que tanto cambiar la variable de entorno como crear un
volumen ha funcionado correctamente.

== Paso 13.3: Parar podman-compose ==

Para parar todos los servicios:

<syntaxhighlight lang="bash">
podman-compose down
</syntaxhighlight>

Comprobamos:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Vemos que han desaparecido todos los contenedores.

= Paso 14: Ejercicios =

== Ejercicio 1: Variante de httpd ==

Construya una imagen ''httpd-hola-mundo'' a partir de la imagen ''httpd''. El fichero de index.html de la carpeta htdocs/ tiene que mostrar el mensaje "hola mundo".

<syntaxhighlight lang="bash">
docker pull httpd
</syntaxhighlight>

Edita el fichero Dockerfile:

<syntaxhighlight lang="bash">
nano Dockerfile
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
FROM httpd

COPY index.html htdocs/index.html
</syntaxhighlight>

Edita el fichero index.html:

<syntaxhighlight lang="bash">
nano index.html
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

Construye la imagen:

<syntaxhighlight lang="bash">
docker build -t mihttpd -f Dockerfile .
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen:

<syntaxhighlight lang="bash">
sudo docker run --name mihttpd -d -p 8080:80 mihttpd
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código:
<syntaxhighlight lang="bash">
curl -X GET http://localhost:8080
</syntaxhighlight>

Tiene que salir por pantalla esto:
<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

== Ejercicio 2: aplicación flask ==

Flask es un framework python para implementar webs. Cree una imagen "miapp-flask" a partir de la imagen de "python":

* Instale flask mediante: pip install flask
* Cree la carpeta "app"
* Establezca la variable FLASK_APP a "hello.py"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"

El fichero hello.py contiene un "hola mundo" para Flask:

<syntaxhighlight lang="python">
from flask import Flask
app = Flask(__name__)

@app.route("/")
def hello():
return "Hello World!"

if __name__ == "__main__":
app.run()
</syntaxhighlight>

Solución con alpine:

<syntaxhighlight lang="bash">
FROM python:alpine

RUN mkdir /app
RUN pip install flask
ENV FLASK_APP="app/hello.py"
COPY hello.py
WORKDIR /
CMD flask run --host=0.0.0.0
</syntaxhighlight>

Solución con Ubuntu:

<syntaxhighlight lang="bash">
FROM ubuntu:bionic

RUN apt-get update
RUN apt-get -y install python python-pip wget
RUN pip install Flask
ENV FLASK_APP="app/hello.py"
RUN mkdir /app
COPY hello.py /app
CMD flask run --host=0.0.0.0
</syntaxhighlight>

== Ejercicio 3: mysql ==

'''EN LA MÁQUINA VIRTUAL:'''

mkdir miapp

cd miapp

sudo docker pull mysql

nano Dockerfile

<syntaxhighlight lang="bash">
FROM mysql
ENV MYSQL_ROOT_PASSWORD="lacontraseñaqueyoquiera"
RUN mkdir /app
WORKDIR /app

</syntaxhighlight>

CTRL+O , ENTER Y CTRL+X (para guardar Dockerfile y salir)

sudo docker build -ti mrfdocker -f Dockerfile .

sudo docker run --name mymrf --rm -p 8001:3306 mrfdocker

sudo docker images

'''EN LA TERMINAL DEL HOST:'''

''Instalación de mysql:''

sudo apt install mysql-client-core-5.7

> sudo apt-get install mysql-server

> sudo service mysql start

''Para entrar:''

sudo mysql -u root -p -P 8001

Una vez dentro de msql:

mysql> show databases;
''
Para salir:''

exit

== Ejercicio 5: python pyramid ==

Pyramid es un framework python para implementar webs. Cree una imagen "miapp-pyramid":

* Emplee la imagen de Ubuntu como referencia, instale los paquetes python y python-pip.
* Instale Pyramid mediante: pip install pyramid
* Cree la carpeta "app"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"
* La aplicación se lanza con la orden: python hello.py
* Compruebe que funciona con curl, la ruta a la web es http://127.0.0.1:8000/hello, suponiendo que ha empleado el puerto 8000 para exponer el servicio.

El fichero hello.py contiene un "hola mundo" para Pyramid:

<syntaxhighlight lang="bash">
from wsgiref.simple_server import make_server
from pyramid.config import Configurator
from pyramid.response import Response

def hello_world(request):
print('Request inbound!')
return Response('Docker works with Pyramid!')

if __name__ == '__main__':
config = Configurator()
config.add_route('hello', '/')
config.add_view(hello_world, route_name='hello')
app = config.make_wsgi_app()
server = make_server('0.0.0.0', 6543, app)
server.serve_forever()
</syntaxhighlight>

Este programa recibe peticiones en el puerto 6543.

== Ejercicio 6 ==

Cree una imagen derivada de Ubuntu, instale el paquete apache2, php y libapache2-mod-php.
Active el módulo de php para apache2 mediante la orden:

<syntaxhighlight lang="bash">
a2enmod php
</syntaxhighlight>

Cree la carpeta /var/www/php.

Cree el fichero index.php

<syntaxhighlight lang="php">
<?php
Print "Hello, World!";
?>
</syntaxhighlight>

y copielo a /var/www/php/.

Cree el fichero 000-default.conf y copielo a /etc/apache2/sites-enabled/

Dicho fichero contiene.

<syntaxhighlight lang="bash">
<VirtualHost *:80>
DocumentRoot /var/www/php

<Directory /var/www/php/>
Options Indexes FollowSymLinks MultiViews
AllowOverride All
Order deny,allow
Allow from all
</Directory>

ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>
</syntaxhighlight>

Tiene que lanzar apache con la orden: apachectl -D FOREGROUND

Tras crear la imagen, láncela mapeando el puerto 8888 al 80, pruebe que puede acceder a http://127.0.0.1:8888/php/ mediante curl

Solución:

<syntaxhighlight lang="bash">
FROM ubuntu:latest

RUN apt-get update
RUN apt-get install -y tzdata
RUN apt-get install -y apache2
RUN apt-get install -y php
RUN apt-get install -y libapache2-mod-php
RUN a2enmod php7.2
COPY index.php /var/www/php
COPY 000-default.conf /etc/apache2/sites-enabled/
CMD apachectl -D FOREGROUND
</syntaxhighlight>

Y para lanzarlo:

docker run --name my-app --rm -d -p 8001:8000 app:v1

y para probarlo:

curl -X GET http://127.0.0.1:8888/php/

== Ejercicio 7 ==

Instale el paquete ''netcat-traditional'' en una imagen de contenedor de ''ubuntu''. Lance la orden:

nc -u -l -p 8080

en el contenedor. Asegúrese de crear una redirección de puertos de 9999 desde el ''host'' al puerto 8080 en el contenedor.

Desde fuera del contenedor, pruebe a conectarse con:

nc -u 127.0.0.1 9999

== Ejercicio 8 ==

Cree una imagen derivada de "ubuntu" con un Dockerfile que incluya soporte de python y lance el siguiente código en Python:

<syntax lang="python">
from http.server import BaseHTTPRequestHandler, HTTPServer
import time

hostName = "0.0.0.0"
serverPort = 8080

class MyServer(BaseHTTPRequestHandler):
def do_GET(self):
self.send_response(200)
self.send_header("Content-type", "text/html")
self.end_headers()
self.wfile.write(bytes("<html><head><title>Welcome!</title></head>", "utf-8"))
self.wfile.write(bytes("<body>", "utf-8"))
self.wfile.write(bytes("This is an example web server.", "utf-8"))
self.wfile.write(bytes("</body></html>", "utf-8"))

if __name__ == "__main__":
webServer = HTTPServer((hostName, serverPort), MyServer)
print("Server started http://%s:%s" % (hostName, serverPort))

try:
webServer.serve_forever()
except KeyboardInterrupt:
pass

webServer.server_close()
print("Server stopped.")
</syntax>

Llame a su imagen "python-http-server". Lance una instancia de la imagen "python-http-server" mapeando el puerto 9999 al puerto 8888/tcp del contenedor. Compruebe con:

<syntax lang="bash">
curl http://127.0.0.1:9999/
</syntax>

que muestre la página HTML que ofrece el servidor, que debería ser:

<syntax lang="bash">
<html><head><title>Welcome!</title></head><body>This is an example web server.</body></html>
</syntax>

Contenedores

2025-12-09T10:45:10Z

Pneira: /* Paso 5.2 Lanzar en segundo plano (-d) */

En esta práctica aprenderemos a utilizar [https://es.wikipedia.org/wiki/Podman podman] para desplegar contenedores.

= Paso 1: Instalar podman =

Para instalar el paquete oficial:

<syntaxhighlight lang="bash">
apt install podman
</syntaxhighlight>

podman es un clon de '''docker''.

= Paso 2: Repositorio de imágenes de contenedores DockerHub =

Docker ofrece un servicio de nube denominado ''DockerHub'' que puede ser empleado como red social para compartir tus imágenes de Podman. En ''DockerHub'' existen además imágenes de contenedores preconfiguradas de software, muchas de ellas oficiales (ofrecidas por el propio fabricante del software) que se podrán emplear como base para construir nuevas imágenes adaptadas a nuestras necesidades.

Podremos realizar búsquedas en este repositorio ''DockerHub'' puedes emplear el siguiente comando:

<syntaxhighlight lang="bash">
podman search docker.io/library/hello-world
</syntaxhighlight>

Para descargarnos la imagen de ''hello-world'' podemos usar la orden ''pull'':

<syntaxhighlight lang="bash">
podman pull hello-world
</syntaxhighlight>

También podemos publicar imágenes propias, esto require '''registro de usuario''' en la nube de ''DockerHub'', lo que '''no''' es obligatorio para la realización de esta práctica. Para subir una imagen, hay que validarse como usuario en la nube de ''DockerHub'':

<syntaxhighlight lang="bash">
podman login
</syntaxhighlight>

Tras introducir tu usuario y contraseña, puedes comenzar a publicar tus propias imágenes.

<syntaxhighlight lang="bash">
podman push MI_IMAGEN
</syntaxhighlight>

Este paso es '''opcional''', sólo en caso de que se quieran subir imágenes de contenedores a la nube de docker.io.

= Paso 4: Comprobar imágenes en nuestra máquina =

Para ver las imágenes que tenemos en nuestra máquina, utilizaremos el comando:

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Inicialmente, no tenemos imágenes en almacenamiento, podemos descargarnos la imagen oficial de Debian 13 (Trixie):

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian
</syntaxhighlight>

Ahora si, ya debería de aparecernos la imagen ''debian''.

Comentar también que cada imagen puede tener varias etiquetas, por ejemplo, la imagen Debian 12 (Bookworm), cuando la hemos visto en el listado de imágenes, venía con el tag latest, que es el tag que se descarga por defecto, pero nosotros podemos especificar otro, por ejemplo:

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian:bookworm
</syntaxhighlight>

Para traernos la versión de la imagen de Debian 12 ''Bookworm''.

Ahora tendremos dos imágenes con diferente etiqueta, que serían como las diferentes versiones de cada imagen.

= Paso 5: Lanzar un contenedor =

Un contenedor no es más que una imagen de podman ejecutándose, sería similar a
una máquina virtual, aunque mucho más liviano.

Para crear un contenedor, utilizaremos una imagen, en este caso, la imagen
hello-world. Hacemos lo siguiente:

<syntaxhighlight lang="bash">
podman run hello-world
</syntaxhighlight>

Esto nos mostrará el siguiente mensaje si todo está correcto:

<syntaxhighlight lang="bash">
Hello from Docker!
This message shows that your installation appears to be working correctly.

To generate this message, Docker took the following steps:
1. The Docker client contacted the Docker daemon.
2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
(amd64)
3. The Docker daemon created a new container from that image which runs the
executable that produces the output you are currently reading.
4. The Docker daemon streamed that output to the Docker client, which sent it
to your terminal.

To try something more ambitious, you can run an Debian container with:
$ podman run -it debian bash

Share images, automate workflows, and more with a free Docker ID:
https://hub.docker.com/

For more examples and ideas, visit:
https://docs.docker.com/get-started/
</syntaxhighlight>

Al crear los contenedores utilizando el comando 'run', tenemos varias opciones:

* Lanzar una terminal en el contenedor en modo interactivo
* Lanzar en segundo plano y conectarnos posteriormente al contenedor

== Paso 5.1: Lanzar una terminal en el contenedor en modo interactivo (-ti) ==

Para este ejemplo vamos a utilizar otra imagen diferente, en este caso vamos a utilizar una imagen de debian.

Vamos a lanzar un contenedor y ejecutar una terminal en el que se va a ejecutar el programa '''bash''' que me ofrece un interprete de órdenes:

<syntaxhighlight lang="bash">
podman run -ti debian bash
</syntaxhighlight>

La opción ''-t'' indica que se crea un terminal en el contenedor. Y la opción ''-i'' indica que el contenedor se ejecuta en modo interactivo.

Al acceder al contenedor de ''debian'' nos aparece un ''hash'' en el prompt de la shell, que identifica a la instancia del contenedor (es valor es similar al que muestra la orden ''podman container ls'').

Para salir del contenedor, escribimos 'exit' o pulsamos ''CTRL + D''

== Paso 5.2 Lanzar en segundo plano (-d) ==

Otro ejemplo, con la imagen de Debian:

<syntaxhighlight lang="bash">
podman run -dti debian
</syntaxhighlight>

que muestra un hash que identifica de forma única el contenedor lanzado:

<syntaxhighlight lang="bash">
2ec1daae4676a4e84dc04fd91399c1dfe92119544ff12ee307991fe573d3db64
</syntaxhighlight>

Mediante el comando ''attach'' puedo entrar al contenedor:

<syntaxhighlight lang="bash">
podman attach 2ec1daae4676
</syntaxhighlight>

Para salir, pulsamos ''CTRL + P'' seguido de ''CTRL + Q''.

De manera similar, puedo lanzar en segundo plano la imagen de contenedor de ''hello-world'':

<syntaxhighlight lang="bash">
podman run -d hello-world
</syntaxhighlight>

Y consultar los logs:

<syntaxhighlight lang="bash">
podman logs b67fae3312bc321
</syntaxhighlight>

== Paso 5.3: Añadir variables de entorno a un contenedor ==

Utilizaremos la imagen anterior, y vamos a añadir una variable de entorno
llamada TEST que contenga el valor 'test'. A parte, también ejecutaremos la
terminal como antes, para comprobar con el comando echo, que la variable de
entorno está creada correctamente:

<syntaxhighlight lang="bash">
podman run -ti -e TEST=test debian bash
</syntaxhighlight>

Ahora, desde el contenedor podemos comprobar el valor de la variable de entorno ''$TEST''.

<syntaxhighlight lang="bash">
echo $TEST
test
</syntaxhighlight>

= Paso 6: Listar contenedores en ejecución =

Hemos estado haciendo pruebas y ejecutando contenedores en el paso anterior, vamos a ver donde se encuentran estos contenedores que hemos ejecutado, y después veremos algunas opciones más del comando run.

Tenemos dos opciones para ver los contenedores:

<syntaxhighlight lang="bash">
podman container ls -a
</syntaxhighlight>

o la versión corta:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Ambas hacen lo mismo, y debería de mostrarnos una salida similar a la siguiente:

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
e2bde5f5500c debian "bash" 6 minutes ago Exited (0) 2 seconds ago pensive_sammet
544ad27dbc3c debian "bash" 7 minutes ago Exited (0) 7 minutes ago serene_elgamal
</syntaxhighlight>

En la información veremos que el contenedor tiene el estado exited, eso quiere decir que no se está ejecutando y ya ha finalizado. Vamos a hacer una prueba para ver un contendor ejecutándose:

<syntaxhighlight lang="bash">
podman run -d debian sleep 30
</syntaxhighlight>

Con el comando sleep 30 esperamos 30 segundos hasta que termine el comando, asíque durante esos 30 segundos, el contenedor estará ejecutándose, veámoslo:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
eacceb27d52d debian "sleep 30" 12 seconds ago Up 11 seconds sharp_pasteur
</syntaxhighlight>

Vamos a ver alguna opciones más de la orden ''run''.

== Paso 6.1: Dar un nombre al contenedor (--name) ==

Por defecto, podman creará automáticamente un nombre como hemos visto en las salidas del comando ''podman ps -a''. Podemos establecer el nombre del contenedor que queramos con la opción ''--name'':

<syntaxhighlight lang="bash">
podman run -ti --name mi_debian debian
</syntaxhighlight>

== Paso 6.2: Eliminar contenedor cuando termine (--rm) ==

Vamos a mezclar todo lo visto anteriormente:

* Lanzar en segundo plano (-d)
* Ejecutar contenedor durante 30 segundos (sleep 30)
* Dar un nombre a la imagen (--name)
* Eliminar contenedor cuando termine (--rm)

<syntaxhighlight lang="bash">
podman run -d --rm --name bye-bye debian sleep 30
</syntaxhighlight>

Antes y una vez pasados los 30 segundos, podemos comprobar que el contenedor ha desaparecido.

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

= Paso 7: Parar y eliminar contenedores =

Los contenedores podemos pararlos o eliminarlos, veamos como hacerlo. Antes que
nada, borraremos todos los contenedores que estén terminados, para ello:

<syntaxhighlight lang="bash">
podman container prune
podman ps -a
</syntaxhighlight>

Ya lo hemos dejado todo limpio para seguir, ahora vamos a crear un contenedor,
utilizando un comando de linux que no termina, para que así se quede
ejecutándose el contenedor infinitamente:

<syntaxhighlight lang="bash">
podman run -d -ti --name my_container debian bash
podman ps -a
</syntaxhighlight>

Vamos a pararlo (podemos utilizar el nombre dado o el id):

<syntaxhighlight lang="bash">
podman stop my_container
podman stop e4901956f108
podman ps -a
</syntaxhighlight>

Veremos que ya ha terminado, y ahora vamos a eliminarlo, pero solo este
contenedor, no como previamente que eliminamos todos. Lo mismo que para pararlo,
podemos utilizar el nombre o el id.

<syntaxhighlight lang="bash">
podman container rm my_container
podman container rm my_container
podman ps -a
</syntaxhighlight>

Veremos que ya no tenemos el contenedor y está correctamente eliminado.

= Paso 8: Conectarnos a un contenedor que se está ejecutando en segundo plano =

Vamos a ejecutar de nuevo un contenedor que no termine:

<syntaxhighlight lang="bash">
podman run -d -ti --name to_attach debian bash
</syntaxhighlight>

Ahora, vamos a conectarnos a este contenedor que está ejecutándose en segundo
plano:

<syntaxhighlight lang="bash">
podman attach to_attach
</syntaxhighlight>

Veremos la orden bash ejecutándose, para terminar, hacemos un 'CTRL + C', y ahora, veremos que ha pasado con el contenedor:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Lo veremos parado, por que lo que hemos hecho ha sido conectarnos al contenedor
y parar el comando que se estaba ejecutando, así que ahora tenemos el contenedor
finalizado.

''Nota:'' Para salir del contenedor '''sin detenerlo''' hacemos 'CTRL + P' seguido 'CTRL + Q'

= Paso 9: Ejecutar en un contenedor otro comando =

Vamos a ver otresta vez como ejecutar un comando en un contenedor que ya está
ejecutándose:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a ejecutar un comando en ese contenedor con el nombre ''mi-contenedor''.
El comando exec es similar al comando run, pero para ejecutar un comando dentro de un contenedor:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor ls
</syntaxhighlight>

Ahora estamos dentro del contenedor creado anteriormente:

<syntaxhighlight lang="bash">
ps -a
</syntaxhighlight>

Aquí veremos en el listado de procesos que hay en ejecución.

Ahora vamos a salirnos del contenedor, escribiendo 'exit' o 'CTRL + D', y
comprobemos el estado del contenedor:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Ahora veremos que el contenedor se sigue ejecutando, no como en el paso anterior.

= Paso 10: Persistencia en contenedores =

Al hacer ''exit'' y salir de un contenedor, se pierden todos los cambios que hemos realizado. Los

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-ejemplo debian bash
</syntaxhighlight>

Ahora, vamos a crear una carpeta en el contenedor y comprobar que esa carpeta existe:

<syntaxhighlight lang="bash">
podman exec mi-ejemplo mkdir test
podman exec mi-ejemplo ls
</syntaxhighlight>

Veremos que la carpeta existe, pero, ¿qué ocurre si para el contenedor?

<syntaxhighlight lang="bash">
podman container stop mi-ejemplo
</syntaxhighlight>

Y volvemos a lanzarlo:

<syntaxhighlight lang="bash">
podman container rm mi-ejemplo
podman run -d -ti --name mi-ejemplo debian bash
podman exec mi-ejemplo ls
</syntaxhighlight>

Podemos comprobar que la carpeta creada anteriormente, no existe.

¿Qué podemos hacer para mantener la modificaciones realizadas sobre un contenedor?

== Paso 10.1: Crear una imagen derivada de la imagen base ==

Es posible crear una imagen derivada, con modificaciones, a partir de una imagen existente mediante la orden '''commit'''.

Por ejemplo, si queremos una imagen ''debian'' que incluya el programa ''ping'' ya instalado, tendríamos que lanzar un contenedor a partir de la imagen ''ubuntu'':

<syntaxhighlight lang="bash">
podman run -d -ti debian bash
</syntaxhighlight>

Suponiendo que el contenido está identificado con el ID 56ef5b312334

Instalamos el paquete ping:

<syntaxhighlight lang="bash">
podman exec 56ef5b312334 apt -y install ping
</syntaxhighlight>

Generamos la imagen derivada con el nombre ''ubuntu-con-ping'':

<syntaxhighlight lang="bash">
podman commit 56ef5b312334 ubuntu-con-ping
</syntaxhighlight>

Ya podemos para nuestro contendor:

<syntaxhighlight lang="bash">
podman stop 56ef5b312334
</syntaxhighlight>

Y lanzar un nuevo contenedor a partir de la imagen ''debian-con-ping'':

<syntaxhighlight lang="bash">
podman run -d -ti debian-con-ping bash
</syntaxhighlight>

== Paso 10.2: Mantener la persistencia mediante volúmen ==

Otra opción para mantener los datos es montar un volumen al ejecutar el contenedor.

Primero crearemos una carpeta que hará de volumen en nuestra máquina, que será la que luego montemos para podman:

<syntaxhighlight lang="bash">
mkdir /home/debian/volumen
</syntaxhighlight>

Ahora vamos a montar la carpeta al ejecutar el contenedor, lo hacemos con la
opción -v, la cual tiene 3 campos separados por ':':

# El volumen en nuestra máquina
# Donde se montará el volumen dentro del contenedor
# Opciones de mmontaje, por ejemplo rw (read and write) o ro (read only)

<syntaxhighlight lang="bash">
podman run --rm -ti -v /home/debian/volumen:/volumen:rw debian bash
mkdir /volumen/test
touch /volumen/test/file
exit
</syntaxhighlight>

Una vez nos salgamos del contenedor, podemos ver que en nuestra máquina están
los datos:

<syntaxhighlight lang="bash">
ls /home/ubuntu/volumen/
ls /home/ubuntu/volumen/test
</syntaxhighlight>

La próxima vez que ejecutemos un contenedor, si montamos ese volumen, los datos
estarán ahí, además esta forma tiene el beneficio de compartir datos entre
nuestra máquina y el contenedor de forma sencilla.

= Paso 11: Crear nuestra propia imagen podman =

Para crear una imagen de un contenedor con una aplicación de Python hug, creamos en primer lugar la carpeta que contendrá los ficheros que nos permiten crear la imagen.

<syntaxhighlight lang="bash">
mkdir miapp
cd miapp
</syntaxhighlight>

Definimos un fichero ''Dockerfile'' para definir la imagen:

<syntaxhighlight lang="bash">
FROM ubuntu

RUN apt -y update
RUN apt -y upgrade
RUN apt -y install python3-hug
RUN mkdir /app
COPY endpoint.py /app
WORKDIR /app
CMD hug -f endpoint.py
</syntaxhighlight>

Alternativamente, puedes crear un [[Creando imagen propia usando Ubuntu de base|Dockerfile empleando la imagen de Ubuntu]] como base en lugar de Alpine.

Y añadimos el fichero ''endpoint.py'' que emplea el framework Python hug con el contenido siguiente:

<syntaxhighlight lang="bash">
import hug

@hug.get('/welcome')
def welcome(username="unknown"):
""" Say welcome to username """
return "Welcome " + username
</syntaxhighlight>

Este fichero es un ejemplo de uso de Python hug. Si hacemos una petición a /welcome?username="LSO", esto nos devolverá el mensaje "Welcome LSO".

Una vez tengamos los dos ficheros creados en nuestra máquina virtual, podemos construir nuestra imagen:

<syntaxhighlight lang="bash">
podman build -t app:v1 -f Dockerfile .
</syntaxhighlight>

Vamos a explicar para que sirve cada línea:

* FROM: servirá para basarnos en una imagen existente, en este caso, una imagen de python alpine, que contiene python y no ocupa mucho espacio
* ENV: para crear variables de entorno
* RUN: para ejecutar comandos, ya sea para crear una carpeta, instalar dependencias o cualquier otra opción que necesitemos
* COPY: para copiar datos desde nuestra máquina a la imagen
* WORKDIR: para cambiar el directorio de trabajo
* CMD: este comando será ejecutado por defecto al iniciar un contenedor a partir de esta imagen

Esto construirá una imagen podman basada en python:alpine, en la cual hemos
guardado nuestra pequeña aplicación y se va a ejecutar cuando ejecutemos un
contenedor basado en esa imagen. Para comprobar que la imagen se ha creado
correctamente, listamos las imagenes, y debería de aparecernos una imagen con
nombre 'app' y tag 'v1':

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen, y vamos a añadir una nueva
opción, -p 8001:8000. Esta opción hará que el puerto interno 8000 del contenedor
sea expuesto en el puerto 8001 de nuestra máquina:

<syntaxhighlight lang="bash">
podman run --name my-app --rm -d -p 8001:8000 app:v1
</syntaxhighlight>

''Nota:'' podman supone que la redirección de puerto es TCP, para una redirección de puertos UDP, puedes usar:

<syntaxhighlight lang="bash">
... -p 8001:8000/udp
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código. En nuestra
máquina haremos:

<syntaxhighlight lang="bash">
curl -X GET http://localhost:8001/welcome?username=LSO
</syntaxhighlight>

Comprobaremos que la salida del comando curl, es "Welcome LSO".

Antes de terminar, vamos a comprobar otro pequeño detalle que añadimos en
nuestra imagen, la variable de entorno USERNAME, vamos a comprobar que funciona:

<syntaxhighlight lang="bash">
podman exec -ti my-app ash
echo $USERNAME
</syntaxhighlight>

Funciona correctamente, pero al ejecutar el contenedor, podemos cambiar esta
variable de entorno como vimos en uno de los pasos anteriores:

<syntaxhighlight lang="bash">
podman run --rm -ti -e USERNAME=me app:v1 ash
echo $USERNAME
</syntaxhighlight>

Esto nos servirá para tener opciones por defecto y que el usuario pueda
cambiarlo a su antojo, como por ejemplo contraseñas u otros detalles.

= Paso 12: Eliminar imágenes =

Veremos que después de todas las pruebas que hemos estado haciendo, tenemos
muchas imágenes, y algunas de las cuales no nos servirán o no las utilizaremos,
así que podemos borrarlas para ahorrar espacio.

Al igual que con los contenedores, tenemos una opción para borrar imágenes que
no se utilicen:

<syntaxhighlight lang="bash">
podman image prune
</syntaxhighlight>

Esto borrará imágenes intermedias que se utilizan a veces para construir
nuestras imágenes o imágenes que hemos intentado construir y nos han fallado.

La otra opción para borrar imágenes una a una, sería utilizando el comando
podman rmi y utilizar el nombre de la imagen o el id. Si esta es la salida de
'podman images':

<syntaxhighlight lang="bash">
REPOSITORY TAG IMAGE ID CREATED SIZE
app v1 18609c517d32 14 minutes ago 109MB
python alpine 39fb80313465 23 hours ago 98.7MB
debian latest 85c4fd36a543 13 days ago 114MB
hello-world latest fce289e99eb9 7 months ago 1.84kB
hello-world linux fce289e99eb9 7 months ago 1.84kB
</syntaxhighlight>

Podemos eliminar las imágenes de hello-world:

<syntaxhighlight lang="bash">
podman rmi hello-world
</syntaxhighlight>

ó

<syntaxhighlight lang="bash">
podman rmi fce289e99eb9
</syntaxhighlight>

= Paso 13: Varios podman a la vez (podman-compose) =

Antes de comenzar, vamos a parar todos los contenedores que tengamos abiertos,
para dejar el entorno de podman limpio, que nos vendrá bien para esta parte.

Cuando queremos ejecutar varios contenedores a la vez y que estén conectados
entre ellos fácilmente, utilizaremos podman-compose, donde con un fichero de
configuración simple en yaml, tendremos toda la configuración de lo que vamos a
ejecutar.

Primero vamos a instalar podman-compose:

<syntaxhighlight lang="bash">
sudo apt install podman-compose
</syntaxhighlight>

Ahora veamos un pequeño ejemplo donde explicaremos todos los detalles para crear
un podman-compose, en este caso, el nombre por defecto de los ficheros suele ser
podman-compose.yml, y el contenido será similar a:

<syntaxhighlight lang="bash">
version: '3'

services:
web:
container_name: web
restart: always
build:
context: .
ports:
- "8000:8000"
volumes:
- /home/ubuntu/volume:/volumen:rw
environment:
USERNAME: test
web2:
container_name: web2
build:
dockerfile: Dockerfile
context: .
depends_on:
- web
command: touch web2
web3:
container_name: web3
restart: on-failure
image: pstauffer/curl
depends_on:
- web
command: curl -X GET web:8000/welcome?username=web3
</syntaxhighlight>

En el podman-compose definimos diferentes servicios a ejecutar, en nuestro caso
hemos iniciado tres servicios diferentes, web, web2 y web3:

El primer servicio, web:

* container_name: para darle un nombre por defecto al contenedor cuando se cree
* restart: pueden ser:
** "no": si la máquina termina, no se vuelve a iniciar (opción por defecto)
** always: siempre que el contenedor termine, intenta iniciarse de nuevo
** on-failure: solo intenta reiniciarse si el contenedor termina con fallo
** unless-stopped: solo reinicia el contenedor si el usuario es el que lo termina
* Utilizará el fichero Dockerfile creado en el paso 11 para generar la imagen a usar.
* Expondrá el puerto 8000 del contenedor en el 8000 de nuestra máquina
* Montará un volumen, se hace de forma similar a la línea de comandos
* Creará una variable de entorno

El segundo servicio, web2:

* Utilizará el fichero Dockerfile también, la diferencia entre este y el primer servicio, es que si el nombre del Dockerfile cambia, tendremos que hacerlo de esta segunda forma, la primera por defecto solo buscará el fichero Dockerfile
* depends_on hará que para ejecutar este servicio, su dependencia tenga ya que estar iniciada
* Ejecutaremos un comando el cual sustituirá al comando de la imagen

El tercer servicio, web3:

* Utilizará la imagen ostauffer/curl que es un imagen mínima que contiene el comando curl
* restart: en este caso, hasta que el comando no se ejecute correctamente, se seguirá reiniciando el contenedor
* depends_on igual que el servicio 2, dependerá del servicio 1
* Ejecutaremos un comando para llamar desde el servicio 3 al servicio 1

== Paso 13.1: Construir podman-compose ==

En el caso de existir servicios que tengan Dockerfiles, esto hará que se construyan previamente, como hacer un podman build de cada uno de los servicios que contenga un Dockerfile:

<syntaxhighlight lang="bash">
podman-compose build
</syntaxhighlight>

Con esto se generarán las imágenes necesarias para ejecutar todos los servicios.

== Paso 13.2: Iniciar podman-compose ==

Para iniciar todos los servicios, ejecutaremos:

<syntaxhighlight lang="bash">
podman-compose up -d
</syntaxhighlight>

Después de esto podremos ver el logs de todos los servicios:

<syntaxhighlight lang="bash">
podman-compose logs -f
</syntaxhighlight>

Aquí veremos que el servicio 3 ha conseguido llamar correctamente al servicio 1.

Ahora veremos como podman-compose ha creado los contenedores:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

La salida será similar a la siguiente:

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
219a4118244c pstauffer/curl "curl -X GET web:800…" 6 seconds ago Exited (0) 3 seconds ago web3
c97e894cb3ae ubuntu_web2 "touch web2" 6 seconds ago Exited (0) 4 seconds ago web2
f35d034204fc ubuntu_web "/bin/sh -c 'hug -f …" 6 seconds ago Up 5 seconds 0.0.0.0:8000->8000/tcp web
</syntaxhighlight>

Aquí vemos varios detalles:

* El nombre que le hemos dado en el podman-compose ha funcionado correctamente
* Vemos que los comandos son los correctos también
* web2 está parado por que la política de reinicio es apagar cuando se termine de ejecutar un comando
* web 3 está parado por que el comando ha terminado con un salida correcta

Vamos a comprobar ahora que en el servicio web está todo correcto:

<syntaxhighlight lang="bash">
podman exec -ti web ash
echo $USERNAME
ls /volumen
exit
</syntaxhighlight>

Podemos comprobar que tanto cambiar la variable de entorno como crear un
volumen ha funcionado correctamente.

== Paso 13.3: Parar podman-compose ==

Para parar todos los servicios:

<syntaxhighlight lang="bash">
podman-compose down
</syntaxhighlight>

Comprobamos:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Vemos que han desaparecido todos los contenedores.

= Paso 14: Ejercicios =

== Ejercicio 1: Variante de httpd ==

Construya una imagen ''httpd-hola-mundo'' a partir de la imagen ''httpd''. El fichero de index.html de la carpeta htdocs/ tiene que mostrar el mensaje "hola mundo".

<syntaxhighlight lang="bash">
docker pull httpd
</syntaxhighlight>

Edita el fichero Dockerfile:

<syntaxhighlight lang="bash">
nano Dockerfile
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
FROM httpd

COPY index.html htdocs/index.html
</syntaxhighlight>

Edita el fichero index.html:

<syntaxhighlight lang="bash">
nano index.html
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

Construye la imagen:

<syntaxhighlight lang="bash">
docker build -t mihttpd -f Dockerfile .
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen:

<syntaxhighlight lang="bash">
sudo docker run --name mihttpd -d -p 8080:80 mihttpd
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código:
<syntaxhighlight lang="bash">
curl -X GET http://localhost:8080
</syntaxhighlight>

Tiene que salir por pantalla esto:
<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

== Ejercicio 2: aplicación flask ==

Flask es un framework python para implementar webs. Cree una imagen "miapp-flask" a partir de la imagen de "python":

* Instale flask mediante: pip install flask
* Cree la carpeta "app"
* Establezca la variable FLASK_APP a "hello.py"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"

El fichero hello.py contiene un "hola mundo" para Flask:

<syntaxhighlight lang="python">
from flask import Flask
app = Flask(__name__)

@app.route("/")
def hello():
return "Hello World!"

if __name__ == "__main__":
app.run()
</syntaxhighlight>

Solución con alpine:

<syntaxhighlight lang="bash">
FROM python:alpine

RUN mkdir /app
RUN pip install flask
ENV FLASK_APP="app/hello.py"
COPY hello.py
WORKDIR /
CMD flask run --host=0.0.0.0
</syntaxhighlight>

Solución con Ubuntu:

<syntaxhighlight lang="bash">
FROM ubuntu:bionic

RUN apt-get update
RUN apt-get -y install python python-pip wget
RUN pip install Flask
ENV FLASK_APP="app/hello.py"
RUN mkdir /app
COPY hello.py /app
CMD flask run --host=0.0.0.0
</syntaxhighlight>

== Ejercicio 3: mysql ==

'''EN LA MÁQUINA VIRTUAL:'''

mkdir miapp

cd miapp

sudo docker pull mysql

nano Dockerfile

<syntaxhighlight lang="bash">
FROM mysql
ENV MYSQL_ROOT_PASSWORD="lacontraseñaqueyoquiera"
RUN mkdir /app
WORKDIR /app

</syntaxhighlight>

CTRL+O , ENTER Y CTRL+X (para guardar Dockerfile y salir)

sudo docker build -ti mrfdocker -f Dockerfile .

sudo docker run --name mymrf --rm -p 8001:3306 mrfdocker

sudo docker images

'''EN LA TERMINAL DEL HOST:'''

''Instalación de mysql:''

sudo apt install mysql-client-core-5.7

> sudo apt-get install mysql-server

> sudo service mysql start

''Para entrar:''

sudo mysql -u root -p -P 8001

Una vez dentro de msql:

mysql> show databases;
''
Para salir:''

exit

== Ejercicio 5: python pyramid ==

Pyramid es un framework python para implementar webs. Cree una imagen "miapp-pyramid":

* Emplee la imagen de Ubuntu como referencia, instale los paquetes python y python-pip.
* Instale Pyramid mediante: pip install pyramid
* Cree la carpeta "app"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"
* La aplicación se lanza con la orden: python hello.py
* Compruebe que funciona con curl, la ruta a la web es http://127.0.0.1:8000/hello, suponiendo que ha empleado el puerto 8000 para exponer el servicio.

El fichero hello.py contiene un "hola mundo" para Pyramid:

<syntaxhighlight lang="bash">
from wsgiref.simple_server import make_server
from pyramid.config import Configurator
from pyramid.response import Response

def hello_world(request):
print('Request inbound!')
return Response('Docker works with Pyramid!')

if __name__ == '__main__':
config = Configurator()
config.add_route('hello', '/')
config.add_view(hello_world, route_name='hello')
app = config.make_wsgi_app()
server = make_server('0.0.0.0', 6543, app)
server.serve_forever()
</syntaxhighlight>

Este programa recibe peticiones en el puerto 6543.

== Ejercicio 6 ==

Cree una imagen derivada de Ubuntu, instale el paquete apache2, php y libapache2-mod-php.
Active el módulo de php para apache2 mediante la orden:

<syntaxhighlight lang="bash">
a2enmod php
</syntaxhighlight>

Cree la carpeta /var/www/php.

Cree el fichero index.php

<syntaxhighlight lang="php">
<?php
Print "Hello, World!";
?>
</syntaxhighlight>

y copielo a /var/www/php/.

Cree el fichero 000-default.conf y copielo a /etc/apache2/sites-enabled/

Dicho fichero contiene.

<syntaxhighlight lang="bash">
<VirtualHost *:80>
DocumentRoot /var/www/php

<Directory /var/www/php/>
Options Indexes FollowSymLinks MultiViews
AllowOverride All
Order deny,allow
Allow from all
</Directory>

ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>
</syntaxhighlight>

Tiene que lanzar apache con la orden: apachectl -D FOREGROUND

Tras crear la imagen, láncela mapeando el puerto 8888 al 80, pruebe que puede acceder a http://127.0.0.1:8888/php/ mediante curl

Solución:

<syntaxhighlight lang="bash">
FROM ubuntu:latest

RUN apt-get update
RUN apt-get install -y tzdata
RUN apt-get install -y apache2
RUN apt-get install -y php
RUN apt-get install -y libapache2-mod-php
RUN a2enmod php7.2
COPY index.php /var/www/php
COPY 000-default.conf /etc/apache2/sites-enabled/
CMD apachectl -D FOREGROUND
</syntaxhighlight>

Y para lanzarlo:

docker run --name my-app --rm -d -p 8001:8000 app:v1

y para probarlo:

curl -X GET http://127.0.0.1:8888/php/

== Ejercicio 7 ==

Instale el paquete ''netcat-traditional'' en una imagen de contenedor de ''ubuntu''. Lance la orden:

nc -u -l -p 8080

en el contenedor. Asegúrese de crear una redirección de puertos de 9999 desde el ''host'' al puerto 8080 en el contenedor.

Desde fuera del contenedor, pruebe a conectarse con:

nc -u 127.0.0.1 9999

== Ejercicio 8 ==

Cree una imagen derivada de "ubuntu" con un Dockerfile que incluya soporte de python y lance el siguiente código en Python:

<syntax lang="python">
from http.server import BaseHTTPRequestHandler, HTTPServer
import time

hostName = "0.0.0.0"
serverPort = 8080

class MyServer(BaseHTTPRequestHandler):
def do_GET(self):
self.send_response(200)
self.send_header("Content-type", "text/html")
self.end_headers()
self.wfile.write(bytes("<html><head><title>Welcome!</title></head>", "utf-8"))
self.wfile.write(bytes("<body>", "utf-8"))
self.wfile.write(bytes("This is an example web server.", "utf-8"))
self.wfile.write(bytes("</body></html>", "utf-8"))

if __name__ == "__main__":
webServer = HTTPServer((hostName, serverPort), MyServer)
print("Server started http://%s:%s" % (hostName, serverPort))

try:
webServer.serve_forever()
except KeyboardInterrupt:
pass

webServer.server_close()
print("Server stopped.")
</syntax>

Llame a su imagen "python-http-server". Lance una instancia de la imagen "python-http-server" mapeando el puerto 9999 al puerto 8888/tcp del contenedor. Compruebe con:

<syntax lang="bash">
curl http://127.0.0.1:9999/
</syntax>

que muestre la página HTML que ofrece el servidor, que debería ser:

<syntax lang="bash">
<html><head><title>Welcome!</title></head><body>This is an example web server.</body></html>
</syntax>

Contenedores

2025-12-09T10:39:32Z

Pneira: /* Paso 5.1: Lanzar una terminal en el contenedor en modo interactivo (-ti) */

En esta práctica aprenderemos a utilizar [https://es.wikipedia.org/wiki/Podman podman] para desplegar contenedores.

= Paso 1: Instalar podman =

Para instalar el paquete oficial:

<syntaxhighlight lang="bash">
apt install podman
</syntaxhighlight>

podman es un clon de '''docker''.

= Paso 2: Repositorio de imágenes de contenedores DockerHub =

Docker ofrece un servicio de nube denominado ''DockerHub'' que puede ser empleado como red social para compartir tus imágenes de Podman. En ''DockerHub'' existen además imágenes de contenedores preconfiguradas de software, muchas de ellas oficiales (ofrecidas por el propio fabricante del software) que se podrán emplear como base para construir nuevas imágenes adaptadas a nuestras necesidades.

Podremos realizar búsquedas en este repositorio ''DockerHub'' puedes emplear el siguiente comando:

<syntaxhighlight lang="bash">
podman search docker.io/library/hello-world
</syntaxhighlight>

Para descargarnos la imagen de ''hello-world'' podemos usar la orden ''pull'':

<syntaxhighlight lang="bash">
podman pull hello-world
</syntaxhighlight>

También podemos publicar imágenes propias, esto require '''registro de usuario''' en la nube de ''DockerHub'', lo que '''no''' es obligatorio para la realización de esta práctica. Para subir una imagen, hay que validarse como usuario en la nube de ''DockerHub'':

<syntaxhighlight lang="bash">
podman login
</syntaxhighlight>

Tras introducir tu usuario y contraseña, puedes comenzar a publicar tus propias imágenes.

<syntaxhighlight lang="bash">
podman push MI_IMAGEN
</syntaxhighlight>

Este paso es '''opcional''', sólo en caso de que se quieran subir imágenes de contenedores a la nube de docker.io.

= Paso 4: Comprobar imágenes en nuestra máquina =

Para ver las imágenes que tenemos en nuestra máquina, utilizaremos el comando:

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Inicialmente, no tenemos imágenes en almacenamiento, podemos descargarnos la imagen oficial de Debian 13 (Trixie):

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian
</syntaxhighlight>

Ahora si, ya debería de aparecernos la imagen ''debian''.

Comentar también que cada imagen puede tener varias etiquetas, por ejemplo, la imagen Debian 12 (Bookworm), cuando la hemos visto en el listado de imágenes, venía con el tag latest, que es el tag que se descarga por defecto, pero nosotros podemos especificar otro, por ejemplo:

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian:bookworm
</syntaxhighlight>

Para traernos la versión de la imagen de Debian 12 ''Bookworm''.

Ahora tendremos dos imágenes con diferente etiqueta, que serían como las diferentes versiones de cada imagen.

= Paso 5: Lanzar un contenedor =

Un contenedor no es más que una imagen de podman ejecutándose, sería similar a
una máquina virtual, aunque mucho más liviano.

Para crear un contenedor, utilizaremos una imagen, en este caso, la imagen
hello-world. Hacemos lo siguiente:

<syntaxhighlight lang="bash">
podman run hello-world
</syntaxhighlight>

Esto nos mostrará el siguiente mensaje si todo está correcto:

<syntaxhighlight lang="bash">
Hello from Docker!
This message shows that your installation appears to be working correctly.

To generate this message, Docker took the following steps:
1. The Docker client contacted the Docker daemon.
2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
(amd64)
3. The Docker daemon created a new container from that image which runs the
executable that produces the output you are currently reading.
4. The Docker daemon streamed that output to the Docker client, which sent it
to your terminal.

To try something more ambitious, you can run an Debian container with:
$ podman run -it debian bash

Share images, automate workflows, and more with a free Docker ID:
https://hub.docker.com/

For more examples and ideas, visit:
https://docs.docker.com/get-started/
</syntaxhighlight>

Al crear los contenedores utilizando el comando 'run', tenemos varias opciones:

* Lanzar una terminal en el contenedor en modo interactivo
* Lanzar en segundo plano y conectarnos posteriormente al contenedor

== Paso 5.1: Lanzar una terminal en el contenedor en modo interactivo (-ti) ==

Para este ejemplo vamos a utilizar otra imagen diferente, en este caso vamos a utilizar una imagen de debian.

Vamos a lanzar un contenedor y ejecutar una terminal en el que se va a ejecutar el programa '''bash''' que me ofrece un interprete de órdenes:

<syntaxhighlight lang="bash">
podman run -ti debian bash
</syntaxhighlight>

La opción ''-t'' indica que se crea un terminal en el contenedor. Y la opción ''-i'' indica que el contenedor se ejecuta en modo interactivo.

Al acceder al contenedor de ''debian'' nos aparece un ''hash'' en el prompt de la shell, que identifica a la instancia del contenedor (es valor es similar al que muestra la orden ''podman container ls'').

Para salir del contenedor, escribimos 'exit' o pulsamos ''CTRL + D''

== Paso 5.2 Lanzar en segundo plano (-d) ==

<syntaxhighlight lang="bash">
podman run -d hello-world
</syntaxhighlight>

Nos mostrará el id del contenedor y se ejecutará en segundo plano, por lo que la salida que antes obtuvimos, ahora no se muestra. Para poder ver esta salida,
podemos utilizar el comando logs y el id mostrador anteriormente:

<syntaxhighlight lang="bash">
podman logs 2ec1daae4676a4e84dc04fd91399c1dfe92119544ff12ee307991fe573d3db64
</syntaxhighlight>

Otro ejemplo, con la imagen de Debian:

<syntaxhighlight lang="bash">
podman run -dti debian
</syntaxhighlight>

== Paso 5.3: Añadir variables de entorno a un contenedor ==

Utilizaremos la imagen anterior, y vamos a añadir una variable de entorno
llamada TEST que contenga el valor 'test'. A parte, también ejecutaremos la
terminal como antes, para comprobar con el comando echo, que la variable de
entorno está creada correctamente:

<syntaxhighlight lang="bash">
podman run -ti -e TEST=test debian bash
</syntaxhighlight>

Ahora, desde el contenedor podemos comprobar el valor de la variable de entorno ''$TEST''.

<syntaxhighlight lang="bash">
echo $TEST
test
</syntaxhighlight>

= Paso 6: Listar contenedores en ejecución =

Hemos estado haciendo pruebas y ejecutando contenedores en el paso anterior, vamos a ver donde se encuentran estos contenedores que hemos ejecutado, y después veremos algunas opciones más del comando run.

Tenemos dos opciones para ver los contenedores:

<syntaxhighlight lang="bash">
podman container ls -a
</syntaxhighlight>

o la versión corta:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Ambas hacen lo mismo, y debería de mostrarnos una salida similar a la siguiente:

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
e2bde5f5500c debian "bash" 6 minutes ago Exited (0) 2 seconds ago pensive_sammet
544ad27dbc3c debian "bash" 7 minutes ago Exited (0) 7 minutes ago serene_elgamal
</syntaxhighlight>

En la información veremos que el contenedor tiene el estado exited, eso quiere decir que no se está ejecutando y ya ha finalizado. Vamos a hacer una prueba para ver un contendor ejecutándose:

<syntaxhighlight lang="bash">
podman run -d debian sleep 30
</syntaxhighlight>

Con el comando sleep 30 esperamos 30 segundos hasta que termine el comando, asíque durante esos 30 segundos, el contenedor estará ejecutándose, veámoslo:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
eacceb27d52d debian "sleep 30" 12 seconds ago Up 11 seconds sharp_pasteur
</syntaxhighlight>

Vamos a ver alguna opciones más de la orden ''run''.

== Paso 6.1: Dar un nombre al contenedor (--name) ==

Por defecto, podman creará automáticamente un nombre como hemos visto en las salidas del comando ''podman ps -a''. Podemos establecer el nombre del contenedor que queramos con la opción ''--name'':

<syntaxhighlight lang="bash">
podman run -ti --name mi_debian debian
</syntaxhighlight>

== Paso 6.2: Eliminar contenedor cuando termine (--rm) ==

Vamos a mezclar todo lo visto anteriormente:

* Lanzar en segundo plano (-d)
* Ejecutar contenedor durante 30 segundos (sleep 30)
* Dar un nombre a la imagen (--name)
* Eliminar contenedor cuando termine (--rm)

<syntaxhighlight lang="bash">
podman run -d --rm --name bye-bye debian sleep 30
</syntaxhighlight>

Antes y una vez pasados los 30 segundos, podemos comprobar que el contenedor ha desaparecido.

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

= Paso 7: Parar y eliminar contenedores =

Los contenedores podemos pararlos o eliminarlos, veamos como hacerlo. Antes que
nada, borraremos todos los contenedores que estén terminados, para ello:

<syntaxhighlight lang="bash">
podman container prune
podman ps -a
</syntaxhighlight>

Ya lo hemos dejado todo limpio para seguir, ahora vamos a crear un contenedor,
utilizando un comando de linux que no termina, para que así se quede
ejecutándose el contenedor infinitamente:

<syntaxhighlight lang="bash">
podman run -d -ti --name my_container debian bash
podman ps -a
</syntaxhighlight>

Vamos a pararlo (podemos utilizar el nombre dado o el id):

<syntaxhighlight lang="bash">
podman stop my_container
podman stop e4901956f108
podman ps -a
</syntaxhighlight>

Veremos que ya ha terminado, y ahora vamos a eliminarlo, pero solo este
contenedor, no como previamente que eliminamos todos. Lo mismo que para pararlo,
podemos utilizar el nombre o el id.

<syntaxhighlight lang="bash">
podman container rm my_container
podman container rm my_container
podman ps -a
</syntaxhighlight>

Veremos que ya no tenemos el contenedor y está correctamente eliminado.

= Paso 8: Conectarnos a un contenedor que se está ejecutando en segundo plano =

Vamos a ejecutar de nuevo un contenedor que no termine:

<syntaxhighlight lang="bash">
podman run -d -ti --name to_attach debian bash
</syntaxhighlight>

Ahora, vamos a conectarnos a este contenedor que está ejecutándose en segundo
plano:

<syntaxhighlight lang="bash">
podman attach to_attach
</syntaxhighlight>

Veremos la orden bash ejecutándose, para terminar, hacemos un 'CTRL + C', y ahora, veremos que ha pasado con el contenedor:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Lo veremos parado, por que lo que hemos hecho ha sido conectarnos al contenedor
y parar el comando que se estaba ejecutando, así que ahora tenemos el contenedor
finalizado.

''Nota:'' Para salir del contenedor '''sin detenerlo''' hacemos 'CTRL + P' seguido 'CTRL + Q'

= Paso 9: Ejecutar en un contenedor otro comando =

Vamos a ver otresta vez como ejecutar un comando en un contenedor que ya está
ejecutándose:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a ejecutar un comando en ese contenedor con el nombre ''mi-contenedor''.
El comando exec es similar al comando run, pero para ejecutar un comando dentro de un contenedor:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor ls
</syntaxhighlight>

Ahora estamos dentro del contenedor creado anteriormente:

<syntaxhighlight lang="bash">
ps -a
</syntaxhighlight>

Aquí veremos en el listado de procesos que hay en ejecución.

Ahora vamos a salirnos del contenedor, escribiendo 'exit' o 'CTRL + D', y
comprobemos el estado del contenedor:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Ahora veremos que el contenedor se sigue ejecutando, no como en el paso anterior.

= Paso 10: Persistencia en contenedores =

Al hacer ''exit'' y salir de un contenedor, se pierden todos los cambios que hemos realizado. Los

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-ejemplo debian bash
</syntaxhighlight>

Ahora, vamos a crear una carpeta en el contenedor y comprobar que esa carpeta existe:

<syntaxhighlight lang="bash">
podman exec mi-ejemplo mkdir test
podman exec mi-ejemplo ls
</syntaxhighlight>

Veremos que la carpeta existe, pero, ¿qué ocurre si para el contenedor?

<syntaxhighlight lang="bash">
podman container stop mi-ejemplo
</syntaxhighlight>

Y volvemos a lanzarlo:

<syntaxhighlight lang="bash">
podman container rm mi-ejemplo
podman run -d -ti --name mi-ejemplo debian bash
podman exec mi-ejemplo ls
</syntaxhighlight>

Podemos comprobar que la carpeta creada anteriormente, no existe.

¿Qué podemos hacer para mantener la modificaciones realizadas sobre un contenedor?

== Paso 10.1: Crear una imagen derivada de la imagen base ==

Es posible crear una imagen derivada, con modificaciones, a partir de una imagen existente mediante la orden '''commit'''.

Por ejemplo, si queremos una imagen ''debian'' que incluya el programa ''ping'' ya instalado, tendríamos que lanzar un contenedor a partir de la imagen ''ubuntu'':

<syntaxhighlight lang="bash">
podman run -d -ti debian bash
</syntaxhighlight>

Suponiendo que el contenido está identificado con el ID 56ef5b312334

Instalamos el paquete ping:

<syntaxhighlight lang="bash">
podman exec 56ef5b312334 apt -y install ping
</syntaxhighlight>

Generamos la imagen derivada con el nombre ''ubuntu-con-ping'':

<syntaxhighlight lang="bash">
podman commit 56ef5b312334 ubuntu-con-ping
</syntaxhighlight>

Ya podemos para nuestro contendor:

<syntaxhighlight lang="bash">
podman stop 56ef5b312334
</syntaxhighlight>

Y lanzar un nuevo contenedor a partir de la imagen ''debian-con-ping'':

<syntaxhighlight lang="bash">
podman run -d -ti debian-con-ping bash
</syntaxhighlight>

== Paso 10.2: Mantener la persistencia mediante volúmen ==

Otra opción para mantener los datos es montar un volumen al ejecutar el contenedor.

Primero crearemos una carpeta que hará de volumen en nuestra máquina, que será la que luego montemos para podman:

<syntaxhighlight lang="bash">
mkdir /home/debian/volumen
</syntaxhighlight>

Ahora vamos a montar la carpeta al ejecutar el contenedor, lo hacemos con la
opción -v, la cual tiene 3 campos separados por ':':

# El volumen en nuestra máquina
# Donde se montará el volumen dentro del contenedor
# Opciones de mmontaje, por ejemplo rw (read and write) o ro (read only)

<syntaxhighlight lang="bash">
podman run --rm -ti -v /home/debian/volumen:/volumen:rw debian bash
mkdir /volumen/test
touch /volumen/test/file
exit
</syntaxhighlight>

Una vez nos salgamos del contenedor, podemos ver que en nuestra máquina están
los datos:

<syntaxhighlight lang="bash">
ls /home/ubuntu/volumen/
ls /home/ubuntu/volumen/test
</syntaxhighlight>

La próxima vez que ejecutemos un contenedor, si montamos ese volumen, los datos
estarán ahí, además esta forma tiene el beneficio de compartir datos entre
nuestra máquina y el contenedor de forma sencilla.

= Paso 11: Crear nuestra propia imagen podman =

Para crear una imagen de un contenedor con una aplicación de Python hug, creamos en primer lugar la carpeta que contendrá los ficheros que nos permiten crear la imagen.

<syntaxhighlight lang="bash">
mkdir miapp
cd miapp
</syntaxhighlight>

Definimos un fichero ''Dockerfile'' para definir la imagen:

<syntaxhighlight lang="bash">
FROM ubuntu

RUN apt -y update
RUN apt -y upgrade
RUN apt -y install python3-hug
RUN mkdir /app
COPY endpoint.py /app
WORKDIR /app
CMD hug -f endpoint.py
</syntaxhighlight>

Alternativamente, puedes crear un [[Creando imagen propia usando Ubuntu de base|Dockerfile empleando la imagen de Ubuntu]] como base en lugar de Alpine.

Y añadimos el fichero ''endpoint.py'' que emplea el framework Python hug con el contenido siguiente:

<syntaxhighlight lang="bash">
import hug

@hug.get('/welcome')
def welcome(username="unknown"):
""" Say welcome to username """
return "Welcome " + username
</syntaxhighlight>

Este fichero es un ejemplo de uso de Python hug. Si hacemos una petición a /welcome?username="LSO", esto nos devolverá el mensaje "Welcome LSO".

Una vez tengamos los dos ficheros creados en nuestra máquina virtual, podemos construir nuestra imagen:

<syntaxhighlight lang="bash">
podman build -t app:v1 -f Dockerfile .
</syntaxhighlight>

Vamos a explicar para que sirve cada línea:

* FROM: servirá para basarnos en una imagen existente, en este caso, una imagen de python alpine, que contiene python y no ocupa mucho espacio
* ENV: para crear variables de entorno
* RUN: para ejecutar comandos, ya sea para crear una carpeta, instalar dependencias o cualquier otra opción que necesitemos
* COPY: para copiar datos desde nuestra máquina a la imagen
* WORKDIR: para cambiar el directorio de trabajo
* CMD: este comando será ejecutado por defecto al iniciar un contenedor a partir de esta imagen

Esto construirá una imagen podman basada en python:alpine, en la cual hemos
guardado nuestra pequeña aplicación y se va a ejecutar cuando ejecutemos un
contenedor basado en esa imagen. Para comprobar que la imagen se ha creado
correctamente, listamos las imagenes, y debería de aparecernos una imagen con
nombre 'app' y tag 'v1':

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen, y vamos a añadir una nueva
opción, -p 8001:8000. Esta opción hará que el puerto interno 8000 del contenedor
sea expuesto en el puerto 8001 de nuestra máquina:

<syntaxhighlight lang="bash">
podman run --name my-app --rm -d -p 8001:8000 app:v1
</syntaxhighlight>

''Nota:'' podman supone que la redirección de puerto es TCP, para una redirección de puertos UDP, puedes usar:

<syntaxhighlight lang="bash">
... -p 8001:8000/udp
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código. En nuestra
máquina haremos:

<syntaxhighlight lang="bash">
curl -X GET http://localhost:8001/welcome?username=LSO
</syntaxhighlight>

Comprobaremos que la salida del comando curl, es "Welcome LSO".

Antes de terminar, vamos a comprobar otro pequeño detalle que añadimos en
nuestra imagen, la variable de entorno USERNAME, vamos a comprobar que funciona:

<syntaxhighlight lang="bash">
podman exec -ti my-app ash
echo $USERNAME
</syntaxhighlight>

Funciona correctamente, pero al ejecutar el contenedor, podemos cambiar esta
variable de entorno como vimos en uno de los pasos anteriores:

<syntaxhighlight lang="bash">
podman run --rm -ti -e USERNAME=me app:v1 ash
echo $USERNAME
</syntaxhighlight>

Esto nos servirá para tener opciones por defecto y que el usuario pueda
cambiarlo a su antojo, como por ejemplo contraseñas u otros detalles.

= Paso 12: Eliminar imágenes =

Veremos que después de todas las pruebas que hemos estado haciendo, tenemos
muchas imágenes, y algunas de las cuales no nos servirán o no las utilizaremos,
así que podemos borrarlas para ahorrar espacio.

Al igual que con los contenedores, tenemos una opción para borrar imágenes que
no se utilicen:

<syntaxhighlight lang="bash">
podman image prune
</syntaxhighlight>

Esto borrará imágenes intermedias que se utilizan a veces para construir
nuestras imágenes o imágenes que hemos intentado construir y nos han fallado.

La otra opción para borrar imágenes una a una, sería utilizando el comando
podman rmi y utilizar el nombre de la imagen o el id. Si esta es la salida de
'podman images':

<syntaxhighlight lang="bash">
REPOSITORY TAG IMAGE ID CREATED SIZE
app v1 18609c517d32 14 minutes ago 109MB
python alpine 39fb80313465 23 hours ago 98.7MB
debian latest 85c4fd36a543 13 days ago 114MB
hello-world latest fce289e99eb9 7 months ago 1.84kB
hello-world linux fce289e99eb9 7 months ago 1.84kB
</syntaxhighlight>

Podemos eliminar las imágenes de hello-world:

<syntaxhighlight lang="bash">
podman rmi hello-world
</syntaxhighlight>

ó

<syntaxhighlight lang="bash">
podman rmi fce289e99eb9
</syntaxhighlight>

= Paso 13: Varios podman a la vez (podman-compose) =

Antes de comenzar, vamos a parar todos los contenedores que tengamos abiertos,
para dejar el entorno de podman limpio, que nos vendrá bien para esta parte.

Cuando queremos ejecutar varios contenedores a la vez y que estén conectados
entre ellos fácilmente, utilizaremos podman-compose, donde con un fichero de
configuración simple en yaml, tendremos toda la configuración de lo que vamos a
ejecutar.

Primero vamos a instalar podman-compose:

<syntaxhighlight lang="bash">
sudo apt install podman-compose
</syntaxhighlight>

Ahora veamos un pequeño ejemplo donde explicaremos todos los detalles para crear
un podman-compose, en este caso, el nombre por defecto de los ficheros suele ser
podman-compose.yml, y el contenido será similar a:

<syntaxhighlight lang="bash">
version: '3'

services:
web:
container_name: web
restart: always
build:
context: .
ports:
- "8000:8000"
volumes:
- /home/ubuntu/volume:/volumen:rw
environment:
USERNAME: test
web2:
container_name: web2
build:
dockerfile: Dockerfile
context: .
depends_on:
- web
command: touch web2
web3:
container_name: web3
restart: on-failure
image: pstauffer/curl
depends_on:
- web
command: curl -X GET web:8000/welcome?username=web3
</syntaxhighlight>

En el podman-compose definimos diferentes servicios a ejecutar, en nuestro caso
hemos iniciado tres servicios diferentes, web, web2 y web3:

El primer servicio, web:

* container_name: para darle un nombre por defecto al contenedor cuando se cree
* restart: pueden ser:
** "no": si la máquina termina, no se vuelve a iniciar (opción por defecto)
** always: siempre que el contenedor termine, intenta iniciarse de nuevo
** on-failure: solo intenta reiniciarse si el contenedor termina con fallo
** unless-stopped: solo reinicia el contenedor si el usuario es el que lo termina
* Utilizará el fichero Dockerfile creado en el paso 11 para generar la imagen a usar.
* Expondrá el puerto 8000 del contenedor en el 8000 de nuestra máquina
* Montará un volumen, se hace de forma similar a la línea de comandos
* Creará una variable de entorno

El segundo servicio, web2:

* Utilizará el fichero Dockerfile también, la diferencia entre este y el primer servicio, es que si el nombre del Dockerfile cambia, tendremos que hacerlo de esta segunda forma, la primera por defecto solo buscará el fichero Dockerfile
* depends_on hará que para ejecutar este servicio, su dependencia tenga ya que estar iniciada
* Ejecutaremos un comando el cual sustituirá al comando de la imagen

El tercer servicio, web3:

* Utilizará la imagen ostauffer/curl que es un imagen mínima que contiene el comando curl
* restart: en este caso, hasta que el comando no se ejecute correctamente, se seguirá reiniciando el contenedor
* depends_on igual que el servicio 2, dependerá del servicio 1
* Ejecutaremos un comando para llamar desde el servicio 3 al servicio 1

== Paso 13.1: Construir podman-compose ==

En el caso de existir servicios que tengan Dockerfiles, esto hará que se construyan previamente, como hacer un podman build de cada uno de los servicios que contenga un Dockerfile:

<syntaxhighlight lang="bash">
podman-compose build
</syntaxhighlight>

Con esto se generarán las imágenes necesarias para ejecutar todos los servicios.

== Paso 13.2: Iniciar podman-compose ==

Para iniciar todos los servicios, ejecutaremos:

<syntaxhighlight lang="bash">
podman-compose up -d
</syntaxhighlight>

Después de esto podremos ver el logs de todos los servicios:

<syntaxhighlight lang="bash">
podman-compose logs -f
</syntaxhighlight>

Aquí veremos que el servicio 3 ha conseguido llamar correctamente al servicio 1.

Ahora veremos como podman-compose ha creado los contenedores:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

La salida será similar a la siguiente:

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
219a4118244c pstauffer/curl "curl -X GET web:800…" 6 seconds ago Exited (0) 3 seconds ago web3
c97e894cb3ae ubuntu_web2 "touch web2" 6 seconds ago Exited (0) 4 seconds ago web2
f35d034204fc ubuntu_web "/bin/sh -c 'hug -f …" 6 seconds ago Up 5 seconds 0.0.0.0:8000->8000/tcp web
</syntaxhighlight>

Aquí vemos varios detalles:

* El nombre que le hemos dado en el podman-compose ha funcionado correctamente
* Vemos que los comandos son los correctos también
* web2 está parado por que la política de reinicio es apagar cuando se termine de ejecutar un comando
* web 3 está parado por que el comando ha terminado con un salida correcta

Vamos a comprobar ahora que en el servicio web está todo correcto:

<syntaxhighlight lang="bash">
podman exec -ti web ash
echo $USERNAME
ls /volumen
exit
</syntaxhighlight>

Podemos comprobar que tanto cambiar la variable de entorno como crear un
volumen ha funcionado correctamente.

== Paso 13.3: Parar podman-compose ==

Para parar todos los servicios:

<syntaxhighlight lang="bash">
podman-compose down
</syntaxhighlight>

Comprobamos:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Vemos que han desaparecido todos los contenedores.

= Paso 14: Ejercicios =

== Ejercicio 1: Variante de httpd ==

Construya una imagen ''httpd-hola-mundo'' a partir de la imagen ''httpd''. El fichero de index.html de la carpeta htdocs/ tiene que mostrar el mensaje "hola mundo".

<syntaxhighlight lang="bash">
docker pull httpd
</syntaxhighlight>

Edita el fichero Dockerfile:

<syntaxhighlight lang="bash">
nano Dockerfile
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
FROM httpd

COPY index.html htdocs/index.html
</syntaxhighlight>

Edita el fichero index.html:

<syntaxhighlight lang="bash">
nano index.html
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

Construye la imagen:

<syntaxhighlight lang="bash">
docker build -t mihttpd -f Dockerfile .
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen:

<syntaxhighlight lang="bash">
sudo docker run --name mihttpd -d -p 8080:80 mihttpd
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código:
<syntaxhighlight lang="bash">
curl -X GET http://localhost:8080
</syntaxhighlight>

Tiene que salir por pantalla esto:
<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

== Ejercicio 2: aplicación flask ==

Flask es un framework python para implementar webs. Cree una imagen "miapp-flask" a partir de la imagen de "python":

* Instale flask mediante: pip install flask
* Cree la carpeta "app"
* Establezca la variable FLASK_APP a "hello.py"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"

El fichero hello.py contiene un "hola mundo" para Flask:

<syntaxhighlight lang="python">
from flask import Flask
app = Flask(__name__)

@app.route("/")
def hello():
return "Hello World!"

if __name__ == "__main__":
app.run()
</syntaxhighlight>

Solución con alpine:

<syntaxhighlight lang="bash">
FROM python:alpine

RUN mkdir /app
RUN pip install flask
ENV FLASK_APP="app/hello.py"
COPY hello.py
WORKDIR /
CMD flask run --host=0.0.0.0
</syntaxhighlight>

Solución con Ubuntu:

<syntaxhighlight lang="bash">
FROM ubuntu:bionic

RUN apt-get update
RUN apt-get -y install python python-pip wget
RUN pip install Flask
ENV FLASK_APP="app/hello.py"
RUN mkdir /app
COPY hello.py /app
CMD flask run --host=0.0.0.0
</syntaxhighlight>

== Ejercicio 3: mysql ==

'''EN LA MÁQUINA VIRTUAL:'''

mkdir miapp

cd miapp

sudo docker pull mysql

nano Dockerfile

<syntaxhighlight lang="bash">
FROM mysql
ENV MYSQL_ROOT_PASSWORD="lacontraseñaqueyoquiera"
RUN mkdir /app
WORKDIR /app

</syntaxhighlight>

CTRL+O , ENTER Y CTRL+X (para guardar Dockerfile y salir)

sudo docker build -ti mrfdocker -f Dockerfile .

sudo docker run --name mymrf --rm -p 8001:3306 mrfdocker

sudo docker images

'''EN LA TERMINAL DEL HOST:'''

''Instalación de mysql:''

sudo apt install mysql-client-core-5.7

> sudo apt-get install mysql-server

> sudo service mysql start

''Para entrar:''

sudo mysql -u root -p -P 8001

Una vez dentro de msql:

mysql> show databases;
''
Para salir:''

exit

== Ejercicio 5: python pyramid ==

Pyramid es un framework python para implementar webs. Cree una imagen "miapp-pyramid":

* Emplee la imagen de Ubuntu como referencia, instale los paquetes python y python-pip.
* Instale Pyramid mediante: pip install pyramid
* Cree la carpeta "app"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"
* La aplicación se lanza con la orden: python hello.py
* Compruebe que funciona con curl, la ruta a la web es http://127.0.0.1:8000/hello, suponiendo que ha empleado el puerto 8000 para exponer el servicio.

El fichero hello.py contiene un "hola mundo" para Pyramid:

<syntaxhighlight lang="bash">
from wsgiref.simple_server import make_server
from pyramid.config import Configurator
from pyramid.response import Response

def hello_world(request):
print('Request inbound!')
return Response('Docker works with Pyramid!')

if __name__ == '__main__':
config = Configurator()
config.add_route('hello', '/')
config.add_view(hello_world, route_name='hello')
app = config.make_wsgi_app()
server = make_server('0.0.0.0', 6543, app)
server.serve_forever()
</syntaxhighlight>

Este programa recibe peticiones en el puerto 6543.

== Ejercicio 6 ==

Cree una imagen derivada de Ubuntu, instale el paquete apache2, php y libapache2-mod-php.
Active el módulo de php para apache2 mediante la orden:

<syntaxhighlight lang="bash">
a2enmod php
</syntaxhighlight>

Cree la carpeta /var/www/php.

Cree el fichero index.php

<syntaxhighlight lang="php">
<?php
Print "Hello, World!";
?>
</syntaxhighlight>

y copielo a /var/www/php/.

Cree el fichero 000-default.conf y copielo a /etc/apache2/sites-enabled/

Dicho fichero contiene.

<syntaxhighlight lang="bash">
<VirtualHost *:80>
DocumentRoot /var/www/php

<Directory /var/www/php/>
Options Indexes FollowSymLinks MultiViews
AllowOverride All
Order deny,allow
Allow from all
</Directory>

ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>
</syntaxhighlight>

Tiene que lanzar apache con la orden: apachectl -D FOREGROUND

Tras crear la imagen, láncela mapeando el puerto 8888 al 80, pruebe que puede acceder a http://127.0.0.1:8888/php/ mediante curl

Solución:

<syntaxhighlight lang="bash">
FROM ubuntu:latest

RUN apt-get update
RUN apt-get install -y tzdata
RUN apt-get install -y apache2
RUN apt-get install -y php
RUN apt-get install -y libapache2-mod-php
RUN a2enmod php7.2
COPY index.php /var/www/php
COPY 000-default.conf /etc/apache2/sites-enabled/
CMD apachectl -D FOREGROUND
</syntaxhighlight>

Y para lanzarlo:

docker run --name my-app --rm -d -p 8001:8000 app:v1

y para probarlo:

curl -X GET http://127.0.0.1:8888/php/

== Ejercicio 7 ==

Instale el paquete ''netcat-traditional'' en una imagen de contenedor de ''ubuntu''. Lance la orden:

nc -u -l -p 8080

en el contenedor. Asegúrese de crear una redirección de puertos de 9999 desde el ''host'' al puerto 8080 en el contenedor.

Desde fuera del contenedor, pruebe a conectarse con:

nc -u 127.0.0.1 9999

== Ejercicio 8 ==

Cree una imagen derivada de "ubuntu" con un Dockerfile que incluya soporte de python y lance el siguiente código en Python:

<syntax lang="python">
from http.server import BaseHTTPRequestHandler, HTTPServer
import time

hostName = "0.0.0.0"
serverPort = 8080

class MyServer(BaseHTTPRequestHandler):
def do_GET(self):
self.send_response(200)
self.send_header("Content-type", "text/html")
self.end_headers()
self.wfile.write(bytes("<html><head><title>Welcome!</title></head>", "utf-8"))
self.wfile.write(bytes("<body>", "utf-8"))
self.wfile.write(bytes("This is an example web server.", "utf-8"))
self.wfile.write(bytes("</body></html>", "utf-8"))

if __name__ == "__main__":
webServer = HTTPServer((hostName, serverPort), MyServer)
print("Server started http://%s:%s" % (hostName, serverPort))

try:
webServer.serve_forever()
except KeyboardInterrupt:
pass

webServer.server_close()
print("Server stopped.")
</syntax>

Llame a su imagen "python-http-server". Lance una instancia de la imagen "python-http-server" mapeando el puerto 9999 al puerto 8888/tcp del contenedor. Compruebe con:

<syntax lang="bash">
curl http://127.0.0.1:9999/
</syntax>

que muestre la página HTML que ofrece el servidor, que debería ser:

<syntax lang="bash">
<html><head><title>Welcome!</title></head><body>This is an example web server.</body></html>
</syntax>

Contenedores

2025-12-09T10:37:54Z

Pneira:

En esta práctica aprenderemos a utilizar [https://es.wikipedia.org/wiki/Podman podman] para desplegar contenedores.

= Paso 1: Instalar podman =

Para instalar el paquete oficial:

<syntaxhighlight lang="bash">
apt install podman
</syntaxhighlight>

podman es un clon de '''docker''.

= Paso 2: Repositorio de imágenes de contenedores DockerHub =

Docker ofrece un servicio de nube denominado ''DockerHub'' que puede ser empleado como red social para compartir tus imágenes de Podman. En ''DockerHub'' existen además imágenes de contenedores preconfiguradas de software, muchas de ellas oficiales (ofrecidas por el propio fabricante del software) que se podrán emplear como base para construir nuevas imágenes adaptadas a nuestras necesidades.

Podremos realizar búsquedas en este repositorio ''DockerHub'' puedes emplear el siguiente comando:

<syntaxhighlight lang="bash">
podman search docker.io/library/hello-world
</syntaxhighlight>

Para descargarnos la imagen de ''hello-world'' podemos usar la orden ''pull'':

<syntaxhighlight lang="bash">
podman pull hello-world
</syntaxhighlight>

También podemos publicar imágenes propias, esto require '''registro de usuario''' en la nube de ''DockerHub'', lo que '''no''' es obligatorio para la realización de esta práctica. Para subir una imagen, hay que validarse como usuario en la nube de ''DockerHub'':

<syntaxhighlight lang="bash">
podman login
</syntaxhighlight>

Tras introducir tu usuario y contraseña, puedes comenzar a publicar tus propias imágenes.

<syntaxhighlight lang="bash">
podman push MI_IMAGEN
</syntaxhighlight>

Este paso es '''opcional''', sólo en caso de que se quieran subir imágenes de contenedores a la nube de docker.io.

= Paso 4: Comprobar imágenes en nuestra máquina =

Para ver las imágenes que tenemos en nuestra máquina, utilizaremos el comando:

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Inicialmente, no tenemos imágenes en almacenamiento, podemos descargarnos la imagen oficial de Debian 13 (Trixie):

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian
</syntaxhighlight>

Ahora si, ya debería de aparecernos la imagen ''debian''.

Comentar también que cada imagen puede tener varias etiquetas, por ejemplo, la imagen Debian 12 (Bookworm), cuando la hemos visto en el listado de imágenes, venía con el tag latest, que es el tag que se descarga por defecto, pero nosotros podemos especificar otro, por ejemplo:

<syntaxhighlight lang="bash">
podman pull docker.io/library/debian:bookworm
</syntaxhighlight>

Para traernos la versión de la imagen de Debian 12 ''Bookworm''.

Ahora tendremos dos imágenes con diferente etiqueta, que serían como las diferentes versiones de cada imagen.

= Paso 5: Lanzar un contenedor =

Un contenedor no es más que una imagen de podman ejecutándose, sería similar a
una máquina virtual, aunque mucho más liviano.

Para crear un contenedor, utilizaremos una imagen, en este caso, la imagen
hello-world. Hacemos lo siguiente:

<syntaxhighlight lang="bash">
podman run hello-world
</syntaxhighlight>

Esto nos mostrará el siguiente mensaje si todo está correcto:

<syntaxhighlight lang="bash">
Hello from Docker!
This message shows that your installation appears to be working correctly.

To generate this message, Docker took the following steps:
1. The Docker client contacted the Docker daemon.
2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
(amd64)
3. The Docker daemon created a new container from that image which runs the
executable that produces the output you are currently reading.
4. The Docker daemon streamed that output to the Docker client, which sent it
to your terminal.

To try something more ambitious, you can run an Debian container with:
$ podman run -it debian bash

Share images, automate workflows, and more with a free Docker ID:
https://hub.docker.com/

For more examples and ideas, visit:
https://docs.docker.com/get-started/
</syntaxhighlight>

Al crear los contenedores utilizando el comando 'run', tenemos varias opciones:

* Lanzar una terminal en el contenedor en modo interactivo
* Lanzar en segundo plano y conectarnos posteriormente al contenedor

== Paso 5.1: Lanzar una terminal en el contenedor en modo interactivo (-ti) ==

Para este ejemplo vamos a utilizar otra imagen diferente, en este caso vamos a utilizar una imagen de debian.

Vamos a lanzar un contenedor y ejecutar una terminal en el que se va a ejecutar el programa '''bash''' que me ofrece un interprete de órdenes:

<syntaxhighlight lang="bash">
podman run -ti debian bash
</syntaxhighlight>

La opción ''-t'' indica que se crea un terminal en el contenedor. Y la opción ''-i'' indica que el contenedor se ejecuta en modo interactivo.

Al acceder al contenedor de ''debian'' nos aparece un ''hash'' en el prompt de la shell, que identifica a la instancia del contenedor (es valor es similar al que muestra la orden ''podman container ls'').

Para salir del contenedor, escribimos 'exit' o pulsamos 'CTRL + D'

== Paso 5.2 Lanzar en segundo plano (-d) ==

<syntaxhighlight lang="bash">
podman run -d hello-world
</syntaxhighlight>

Nos mostrará el id del contenedor y se ejecutará en segundo plano, por lo que la salida que antes obtuvimos, ahora no se muestra. Para poder ver esta salida,
podemos utilizar el comando logs y el id mostrador anteriormente:

<syntaxhighlight lang="bash">
podman logs 2ec1daae4676a4e84dc04fd91399c1dfe92119544ff12ee307991fe573d3db64
</syntaxhighlight>

Otro ejemplo, con la imagen de Debian:

<syntaxhighlight lang="bash">
podman run -dti debian
</syntaxhighlight>

== Paso 5.3: Añadir variables de entorno a un contenedor ==

Utilizaremos la imagen anterior, y vamos a añadir una variable de entorno
llamada TEST que contenga el valor 'test'. A parte, también ejecutaremos la
terminal como antes, para comprobar con el comando echo, que la variable de
entorno está creada correctamente:

<syntaxhighlight lang="bash">
podman run -ti -e TEST=test debian bash
</syntaxhighlight>

Ahora, desde el contenedor podemos comprobar el valor de la variable de entorno ''$TEST''.

<syntaxhighlight lang="bash">
echo $TEST
test
</syntaxhighlight>

= Paso 6: Listar contenedores en ejecución =

Hemos estado haciendo pruebas y ejecutando contenedores en el paso anterior, vamos a ver donde se encuentran estos contenedores que hemos ejecutado, y después veremos algunas opciones más del comando run.

Tenemos dos opciones para ver los contenedores:

<syntaxhighlight lang="bash">
podman container ls -a
</syntaxhighlight>

o la versión corta:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Ambas hacen lo mismo, y debería de mostrarnos una salida similar a la siguiente:

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
e2bde5f5500c debian "bash" 6 minutes ago Exited (0) 2 seconds ago pensive_sammet
544ad27dbc3c debian "bash" 7 minutes ago Exited (0) 7 minutes ago serene_elgamal
</syntaxhighlight>

En la información veremos que el contenedor tiene el estado exited, eso quiere decir que no se está ejecutando y ya ha finalizado. Vamos a hacer una prueba para ver un contendor ejecutándose:

<syntaxhighlight lang="bash">
podman run -d debian sleep 30
</syntaxhighlight>

Con el comando sleep 30 esperamos 30 segundos hasta que termine el comando, asíque durante esos 30 segundos, el contenedor estará ejecutándose, veámoslo:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
eacceb27d52d debian "sleep 30" 12 seconds ago Up 11 seconds sharp_pasteur
</syntaxhighlight>

Vamos a ver alguna opciones más de la orden ''run''.

== Paso 6.1: Dar un nombre al contenedor (--name) ==

Por defecto, podman creará automáticamente un nombre como hemos visto en las salidas del comando ''podman ps -a''. Podemos establecer el nombre del contenedor que queramos con la opción ''--name'':

<syntaxhighlight lang="bash">
podman run -ti --name mi_debian debian
</syntaxhighlight>

== Paso 6.2: Eliminar contenedor cuando termine (--rm) ==

Vamos a mezclar todo lo visto anteriormente:

* Lanzar en segundo plano (-d)
* Ejecutar contenedor durante 30 segundos (sleep 30)
* Dar un nombre a la imagen (--name)
* Eliminar contenedor cuando termine (--rm)

<syntaxhighlight lang="bash">
podman run -d --rm --name bye-bye debian sleep 30
</syntaxhighlight>

Antes y una vez pasados los 30 segundos, podemos comprobar que el contenedor ha desaparecido.

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

= Paso 7: Parar y eliminar contenedores =

Los contenedores podemos pararlos o eliminarlos, veamos como hacerlo. Antes que
nada, borraremos todos los contenedores que estén terminados, para ello:

<syntaxhighlight lang="bash">
podman container prune
podman ps -a
</syntaxhighlight>

Ya lo hemos dejado todo limpio para seguir, ahora vamos a crear un contenedor,
utilizando un comando de linux que no termina, para que así se quede
ejecutándose el contenedor infinitamente:

<syntaxhighlight lang="bash">
podman run -d -ti --name my_container debian bash
podman ps -a
</syntaxhighlight>

Vamos a pararlo (podemos utilizar el nombre dado o el id):

<syntaxhighlight lang="bash">
podman stop my_container
podman stop e4901956f108
podman ps -a
</syntaxhighlight>

Veremos que ya ha terminado, y ahora vamos a eliminarlo, pero solo este
contenedor, no como previamente que eliminamos todos. Lo mismo que para pararlo,
podemos utilizar el nombre o el id.

<syntaxhighlight lang="bash">
podman container rm my_container
podman container rm my_container
podman ps -a
</syntaxhighlight>

Veremos que ya no tenemos el contenedor y está correctamente eliminado.

= Paso 8: Conectarnos a un contenedor que se está ejecutando en segundo plano =

Vamos a ejecutar de nuevo un contenedor que no termine:

<syntaxhighlight lang="bash">
podman run -d -ti --name to_attach debian bash
</syntaxhighlight>

Ahora, vamos a conectarnos a este contenedor que está ejecutándose en segundo
plano:

<syntaxhighlight lang="bash">
podman attach to_attach
</syntaxhighlight>

Veremos la orden bash ejecutándose, para terminar, hacemos un 'CTRL + C', y ahora, veremos que ha pasado con el contenedor:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Lo veremos parado, por que lo que hemos hecho ha sido conectarnos al contenedor
y parar el comando que se estaba ejecutando, así que ahora tenemos el contenedor
finalizado.

''Nota:'' Para salir del contenedor '''sin detenerlo''' hacemos 'CTRL + P' seguido 'CTRL + Q'

= Paso 9: Ejecutar en un contenedor otro comando =

Vamos a ver otresta vez como ejecutar un comando en un contenedor que ya está
ejecutándose:

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-contenedor debian bash
</syntaxhighlight>

Ahora, vamos a ejecutar un comando en ese contenedor con el nombre ''mi-contenedor''.
El comando exec es similar al comando run, pero para ejecutar un comando dentro de un contenedor:

<syntaxhighlight lang="bash">
podman exec -ti mi-contenedor ls
</syntaxhighlight>

Ahora estamos dentro del contenedor creado anteriormente:

<syntaxhighlight lang="bash">
ps -a
</syntaxhighlight>

Aquí veremos en el listado de procesos que hay en ejecución.

Ahora vamos a salirnos del contenedor, escribiendo 'exit' o 'CTRL + D', y
comprobemos el estado del contenedor:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Ahora veremos que el contenedor se sigue ejecutando, no como en el paso anterior.

= Paso 10: Persistencia en contenedores =

Al hacer ''exit'' y salir de un contenedor, se pierden todos los cambios que hemos realizado. Los

<syntaxhighlight lang="bash">
podman run -d -ti --name mi-ejemplo debian bash
</syntaxhighlight>

Ahora, vamos a crear una carpeta en el contenedor y comprobar que esa carpeta existe:

<syntaxhighlight lang="bash">
podman exec mi-ejemplo mkdir test
podman exec mi-ejemplo ls
</syntaxhighlight>

Veremos que la carpeta existe, pero, ¿qué ocurre si para el contenedor?

<syntaxhighlight lang="bash">
podman container stop mi-ejemplo
</syntaxhighlight>

Y volvemos a lanzarlo:

<syntaxhighlight lang="bash">
podman container rm mi-ejemplo
podman run -d -ti --name mi-ejemplo debian bash
podman exec mi-ejemplo ls
</syntaxhighlight>

Podemos comprobar que la carpeta creada anteriormente, no existe.

¿Qué podemos hacer para mantener la modificaciones realizadas sobre un contenedor?

== Paso 10.1: Crear una imagen derivada de la imagen base ==

Es posible crear una imagen derivada, con modificaciones, a partir de una imagen existente mediante la orden '''commit'''.

Por ejemplo, si queremos una imagen ''debian'' que incluya el programa ''ping'' ya instalado, tendríamos que lanzar un contenedor a partir de la imagen ''ubuntu'':

<syntaxhighlight lang="bash">
podman run -d -ti debian bash
</syntaxhighlight>

Suponiendo que el contenido está identificado con el ID 56ef5b312334

Instalamos el paquete ping:

<syntaxhighlight lang="bash">
podman exec 56ef5b312334 apt -y install ping
</syntaxhighlight>

Generamos la imagen derivada con el nombre ''ubuntu-con-ping'':

<syntaxhighlight lang="bash">
podman commit 56ef5b312334 ubuntu-con-ping
</syntaxhighlight>

Ya podemos para nuestro contendor:

<syntaxhighlight lang="bash">
podman stop 56ef5b312334
</syntaxhighlight>

Y lanzar un nuevo contenedor a partir de la imagen ''debian-con-ping'':

<syntaxhighlight lang="bash">
podman run -d -ti debian-con-ping bash
</syntaxhighlight>

== Paso 10.2: Mantener la persistencia mediante volúmen ==

Otra opción para mantener los datos es montar un volumen al ejecutar el contenedor.

Primero crearemos una carpeta que hará de volumen en nuestra máquina, que será la que luego montemos para podman:

<syntaxhighlight lang="bash">
mkdir /home/debian/volumen
</syntaxhighlight>

Ahora vamos a montar la carpeta al ejecutar el contenedor, lo hacemos con la
opción -v, la cual tiene 3 campos separados por ':':

# El volumen en nuestra máquina
# Donde se montará el volumen dentro del contenedor
# Opciones de mmontaje, por ejemplo rw (read and write) o ro (read only)

<syntaxhighlight lang="bash">
podman run --rm -ti -v /home/debian/volumen:/volumen:rw debian bash
mkdir /volumen/test
touch /volumen/test/file
exit
</syntaxhighlight>

Una vez nos salgamos del contenedor, podemos ver que en nuestra máquina están
los datos:

<syntaxhighlight lang="bash">
ls /home/ubuntu/volumen/
ls /home/ubuntu/volumen/test
</syntaxhighlight>

La próxima vez que ejecutemos un contenedor, si montamos ese volumen, los datos
estarán ahí, además esta forma tiene el beneficio de compartir datos entre
nuestra máquina y el contenedor de forma sencilla.

= Paso 11: Crear nuestra propia imagen podman =

Para crear una imagen de un contenedor con una aplicación de Python hug, creamos en primer lugar la carpeta que contendrá los ficheros que nos permiten crear la imagen.

<syntaxhighlight lang="bash">
mkdir miapp
cd miapp
</syntaxhighlight>

Definimos un fichero ''Dockerfile'' para definir la imagen:

<syntaxhighlight lang="bash">
FROM ubuntu

RUN apt -y update
RUN apt -y upgrade
RUN apt -y install python3-hug
RUN mkdir /app
COPY endpoint.py /app
WORKDIR /app
CMD hug -f endpoint.py
</syntaxhighlight>

Alternativamente, puedes crear un [[Creando imagen propia usando Ubuntu de base|Dockerfile empleando la imagen de Ubuntu]] como base en lugar de Alpine.

Y añadimos el fichero ''endpoint.py'' que emplea el framework Python hug con el contenido siguiente:

<syntaxhighlight lang="bash">
import hug

@hug.get('/welcome')
def welcome(username="unknown"):
""" Say welcome to username """
return "Welcome " + username
</syntaxhighlight>

Este fichero es un ejemplo de uso de Python hug. Si hacemos una petición a /welcome?username="LSO", esto nos devolverá el mensaje "Welcome LSO".

Una vez tengamos los dos ficheros creados en nuestra máquina virtual, podemos construir nuestra imagen:

<syntaxhighlight lang="bash">
podman build -t app:v1 -f Dockerfile .
</syntaxhighlight>

Vamos a explicar para que sirve cada línea:

* FROM: servirá para basarnos en una imagen existente, en este caso, una imagen de python alpine, que contiene python y no ocupa mucho espacio
* ENV: para crear variables de entorno
* RUN: para ejecutar comandos, ya sea para crear una carpeta, instalar dependencias o cualquier otra opción que necesitemos
* COPY: para copiar datos desde nuestra máquina a la imagen
* WORKDIR: para cambiar el directorio de trabajo
* CMD: este comando será ejecutado por defecto al iniciar un contenedor a partir de esta imagen

Esto construirá una imagen podman basada en python:alpine, en la cual hemos
guardado nuestra pequeña aplicación y se va a ejecutar cuando ejecutemos un
contenedor basado en esa imagen. Para comprobar que la imagen se ha creado
correctamente, listamos las imagenes, y debería de aparecernos una imagen con
nombre 'app' y tag 'v1':

<syntaxhighlight lang="bash">
podman images
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen, y vamos a añadir una nueva
opción, -p 8001:8000. Esta opción hará que el puerto interno 8000 del contenedor
sea expuesto en el puerto 8001 de nuestra máquina:

<syntaxhighlight lang="bash">
podman run --name my-app --rm -d -p 8001:8000 app:v1
</syntaxhighlight>

''Nota:'' podman supone que la redirección de puerto es TCP, para una redirección de puertos UDP, puedes usar:

<syntaxhighlight lang="bash">
... -p 8001:8000/udp
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código. En nuestra
máquina haremos:

<syntaxhighlight lang="bash">
curl -X GET http://localhost:8001/welcome?username=LSO
</syntaxhighlight>

Comprobaremos que la salida del comando curl, es "Welcome LSO".

Antes de terminar, vamos a comprobar otro pequeño detalle que añadimos en
nuestra imagen, la variable de entorno USERNAME, vamos a comprobar que funciona:

<syntaxhighlight lang="bash">
podman exec -ti my-app ash
echo $USERNAME
</syntaxhighlight>

Funciona correctamente, pero al ejecutar el contenedor, podemos cambiar esta
variable de entorno como vimos en uno de los pasos anteriores:

<syntaxhighlight lang="bash">
podman run --rm -ti -e USERNAME=me app:v1 ash
echo $USERNAME
</syntaxhighlight>

Esto nos servirá para tener opciones por defecto y que el usuario pueda
cambiarlo a su antojo, como por ejemplo contraseñas u otros detalles.

= Paso 12: Eliminar imágenes =

Veremos que después de todas las pruebas que hemos estado haciendo, tenemos
muchas imágenes, y algunas de las cuales no nos servirán o no las utilizaremos,
así que podemos borrarlas para ahorrar espacio.

Al igual que con los contenedores, tenemos una opción para borrar imágenes que
no se utilicen:

<syntaxhighlight lang="bash">
podman image prune
</syntaxhighlight>

Esto borrará imágenes intermedias que se utilizan a veces para construir
nuestras imágenes o imágenes que hemos intentado construir y nos han fallado.

La otra opción para borrar imágenes una a una, sería utilizando el comando
podman rmi y utilizar el nombre de la imagen o el id. Si esta es la salida de
'podman images':

<syntaxhighlight lang="bash">
REPOSITORY TAG IMAGE ID CREATED SIZE
app v1 18609c517d32 14 minutes ago 109MB
python alpine 39fb80313465 23 hours ago 98.7MB
debian latest 85c4fd36a543 13 days ago 114MB
hello-world latest fce289e99eb9 7 months ago 1.84kB
hello-world linux fce289e99eb9 7 months ago 1.84kB
</syntaxhighlight>

Podemos eliminar las imágenes de hello-world:

<syntaxhighlight lang="bash">
podman rmi hello-world
</syntaxhighlight>

ó

<syntaxhighlight lang="bash">
podman rmi fce289e99eb9
</syntaxhighlight>

= Paso 13: Varios podman a la vez (podman-compose) =

Antes de comenzar, vamos a parar todos los contenedores que tengamos abiertos,
para dejar el entorno de podman limpio, que nos vendrá bien para esta parte.

Cuando queremos ejecutar varios contenedores a la vez y que estén conectados
entre ellos fácilmente, utilizaremos podman-compose, donde con un fichero de
configuración simple en yaml, tendremos toda la configuración de lo que vamos a
ejecutar.

Primero vamos a instalar podman-compose:

<syntaxhighlight lang="bash">
sudo apt install podman-compose
</syntaxhighlight>

Ahora veamos un pequeño ejemplo donde explicaremos todos los detalles para crear
un podman-compose, en este caso, el nombre por defecto de los ficheros suele ser
podman-compose.yml, y el contenido será similar a:

<syntaxhighlight lang="bash">
version: '3'

services:
web:
container_name: web
restart: always
build:
context: .
ports:
- "8000:8000"
volumes:
- /home/ubuntu/volume:/volumen:rw
environment:
USERNAME: test
web2:
container_name: web2
build:
dockerfile: Dockerfile
context: .
depends_on:
- web
command: touch web2
web3:
container_name: web3
restart: on-failure
image: pstauffer/curl
depends_on:
- web
command: curl -X GET web:8000/welcome?username=web3
</syntaxhighlight>

En el podman-compose definimos diferentes servicios a ejecutar, en nuestro caso
hemos iniciado tres servicios diferentes, web, web2 y web3:

El primer servicio, web:

* container_name: para darle un nombre por defecto al contenedor cuando se cree
* restart: pueden ser:
** "no": si la máquina termina, no se vuelve a iniciar (opción por defecto)
** always: siempre que el contenedor termine, intenta iniciarse de nuevo
** on-failure: solo intenta reiniciarse si el contenedor termina con fallo
** unless-stopped: solo reinicia el contenedor si el usuario es el que lo termina
* Utilizará el fichero Dockerfile creado en el paso 11 para generar la imagen a usar.
* Expondrá el puerto 8000 del contenedor en el 8000 de nuestra máquina
* Montará un volumen, se hace de forma similar a la línea de comandos
* Creará una variable de entorno

El segundo servicio, web2:

* Utilizará el fichero Dockerfile también, la diferencia entre este y el primer servicio, es que si el nombre del Dockerfile cambia, tendremos que hacerlo de esta segunda forma, la primera por defecto solo buscará el fichero Dockerfile
* depends_on hará que para ejecutar este servicio, su dependencia tenga ya que estar iniciada
* Ejecutaremos un comando el cual sustituirá al comando de la imagen

El tercer servicio, web3:

* Utilizará la imagen ostauffer/curl que es un imagen mínima que contiene el comando curl
* restart: en este caso, hasta que el comando no se ejecute correctamente, se seguirá reiniciando el contenedor
* depends_on igual que el servicio 2, dependerá del servicio 1
* Ejecutaremos un comando para llamar desde el servicio 3 al servicio 1

== Paso 13.1: Construir podman-compose ==

En el caso de existir servicios que tengan Dockerfiles, esto hará que se construyan previamente, como hacer un podman build de cada uno de los servicios que contenga un Dockerfile:

<syntaxhighlight lang="bash">
podman-compose build
</syntaxhighlight>

Con esto se generarán las imágenes necesarias para ejecutar todos los servicios.

== Paso 13.2: Iniciar podman-compose ==

Para iniciar todos los servicios, ejecutaremos:

<syntaxhighlight lang="bash">
podman-compose up -d
</syntaxhighlight>

Después de esto podremos ver el logs de todos los servicios:

<syntaxhighlight lang="bash">
podman-compose logs -f
</syntaxhighlight>

Aquí veremos que el servicio 3 ha conseguido llamar correctamente al servicio 1.

Ahora veremos como podman-compose ha creado los contenedores:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

La salida será similar a la siguiente:

<syntaxhighlight lang="bash">
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
219a4118244c pstauffer/curl "curl -X GET web:800…" 6 seconds ago Exited (0) 3 seconds ago web3
c97e894cb3ae ubuntu_web2 "touch web2" 6 seconds ago Exited (0) 4 seconds ago web2
f35d034204fc ubuntu_web "/bin/sh -c 'hug -f …" 6 seconds ago Up 5 seconds 0.0.0.0:8000->8000/tcp web
</syntaxhighlight>

Aquí vemos varios detalles:

* El nombre que le hemos dado en el podman-compose ha funcionado correctamente
* Vemos que los comandos son los correctos también
* web2 está parado por que la política de reinicio es apagar cuando se termine de ejecutar un comando
* web 3 está parado por que el comando ha terminado con un salida correcta

Vamos a comprobar ahora que en el servicio web está todo correcto:

<syntaxhighlight lang="bash">
podman exec -ti web ash
echo $USERNAME
ls /volumen
exit
</syntaxhighlight>

Podemos comprobar que tanto cambiar la variable de entorno como crear un
volumen ha funcionado correctamente.

== Paso 13.3: Parar podman-compose ==

Para parar todos los servicios:

<syntaxhighlight lang="bash">
podman-compose down
</syntaxhighlight>

Comprobamos:

<syntaxhighlight lang="bash">
podman ps -a
</syntaxhighlight>

Vemos que han desaparecido todos los contenedores.

= Paso 14: Ejercicios =

== Ejercicio 1: Variante de httpd ==

Construya una imagen ''httpd-hola-mundo'' a partir de la imagen ''httpd''. El fichero de index.html de la carpeta htdocs/ tiene que mostrar el mensaje "hola mundo".

<syntaxhighlight lang="bash">
docker pull httpd
</syntaxhighlight>

Edita el fichero Dockerfile:

<syntaxhighlight lang="bash">
nano Dockerfile
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
FROM httpd

COPY index.html htdocs/index.html
</syntaxhighlight>

Edita el fichero index.html:

<syntaxhighlight lang="bash">
nano index.html
</syntaxhighlight>

Añada este contenido:

<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

Construye la imagen:

<syntaxhighlight lang="bash">
docker build -t mihttpd -f Dockerfile .
</syntaxhighlight>

Ahora vamos a crear un contenedor de nuestra imagen:

<syntaxhighlight lang="bash">
sudo docker run --name mihttpd -d -p 8080:80 mihttpd
</syntaxhighlight>

Ahora vamos a probar que funciona nuestra imagen y nuestro código:
<syntaxhighlight lang="bash">
curl -X GET http://localhost:8080
</syntaxhighlight>

Tiene que salir por pantalla esto:
<syntaxhighlight lang="bash">
<html>hola mundo</html>
</syntaxhighlight>

== Ejercicio 2: aplicación flask ==

Flask es un framework python para implementar webs. Cree una imagen "miapp-flask" a partir de la imagen de "python":

* Instale flask mediante: pip install flask
* Cree la carpeta "app"
* Establezca la variable FLASK_APP a "hello.py"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"

El fichero hello.py contiene un "hola mundo" para Flask:

<syntaxhighlight lang="python">
from flask import Flask
app = Flask(__name__)

@app.route("/")
def hello():
return "Hello World!"

if __name__ == "__main__":
app.run()
</syntaxhighlight>

Solución con alpine:

<syntaxhighlight lang="bash">
FROM python:alpine

RUN mkdir /app
RUN pip install flask
ENV FLASK_APP="app/hello.py"
COPY hello.py
WORKDIR /
CMD flask run --host=0.0.0.0
</syntaxhighlight>

Solución con Ubuntu:

<syntaxhighlight lang="bash">
FROM ubuntu:bionic

RUN apt-get update
RUN apt-get -y install python python-pip wget
RUN pip install Flask
ENV FLASK_APP="app/hello.py"
RUN mkdir /app
COPY hello.py /app
CMD flask run --host=0.0.0.0
</syntaxhighlight>

== Ejercicio 3: mysql ==

'''EN LA MÁQUINA VIRTUAL:'''

mkdir miapp

cd miapp

sudo docker pull mysql

nano Dockerfile

<syntaxhighlight lang="bash">
FROM mysql
ENV MYSQL_ROOT_PASSWORD="lacontraseñaqueyoquiera"
RUN mkdir /app
WORKDIR /app

</syntaxhighlight>

CTRL+O , ENTER Y CTRL+X (para guardar Dockerfile y salir)

sudo docker build -ti mrfdocker -f Dockerfile .

sudo docker run --name mymrf --rm -p 8001:3306 mrfdocker

sudo docker images

'''EN LA TERMINAL DEL HOST:'''

''Instalación de mysql:''

sudo apt install mysql-client-core-5.7

> sudo apt-get install mysql-server

> sudo service mysql start

''Para entrar:''

sudo mysql -u root -p -P 8001

Una vez dentro de msql:

mysql> show databases;
''
Para salir:''

exit

== Ejercicio 5: python pyramid ==

Pyramid es un framework python para implementar webs. Cree una imagen "miapp-pyramid":

* Emplee la imagen de Ubuntu como referencia, instale los paquetes python y python-pip.
* Instale Pyramid mediante: pip install pyramid
* Cree la carpeta "app"
* Añada el fichero "hello.py"
* Establezca el directorio de trabajo a "/app"
* La aplicación se lanza con la orden: python hello.py
* Compruebe que funciona con curl, la ruta a la web es http://127.0.0.1:8000/hello, suponiendo que ha empleado el puerto 8000 para exponer el servicio.

El fichero hello.py contiene un "hola mundo" para Pyramid:

<syntaxhighlight lang="bash">
from wsgiref.simple_server import make_server
from pyramid.config import Configurator
from pyramid.response import Response

def hello_world(request):
print('Request inbound!')
return Response('Docker works with Pyramid!')

if __name__ == '__main__':
config = Configurator()
config.add_route('hello', '/')
config.add_view(hello_world, route_name='hello')
app = config.make_wsgi_app()
server = make_server('0.0.0.0', 6543, app)
server.serve_forever()
</syntaxhighlight>

Este programa recibe peticiones en el puerto 6543.

== Ejercicio 6 ==

Cree una imagen derivada de Ubuntu, instale el paquete apache2, php y libapache2-mod-php.
Active el módulo de php para apache2 mediante la orden:

<syntaxhighlight lang="bash">
a2enmod php
</syntaxhighlight>

Cree la carpeta /var/www/php.

Cree el fichero index.php

<syntaxhighlight lang="php">
<?php
Print "Hello, World!";
?>
</syntaxhighlight>

y copielo a /var/www/php/.

Cree el fichero 000-default.conf y copielo a /etc/apache2/sites-enabled/

Dicho fichero contiene.

<syntaxhighlight lang="bash">
<VirtualHost *:80>
DocumentRoot /var/www/php

<Directory /var/www/php/>
Options Indexes FollowSymLinks MultiViews
AllowOverride All
Order deny,allow
Allow from all
</Directory>

ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>
</syntaxhighlight>

Tiene que lanzar apache con la orden: apachectl -D FOREGROUND

Tras crear la imagen, láncela mapeando el puerto 8888 al 80, pruebe que puede acceder a http://127.0.0.1:8888/php/ mediante curl

Solución:

<syntaxhighlight lang="bash">
FROM ubuntu:latest

RUN apt-get update
RUN apt-get install -y tzdata
RUN apt-get install -y apache2
RUN apt-get install -y php
RUN apt-get install -y libapache2-mod-php
RUN a2enmod php7.2
COPY index.php /var/www/php
COPY 000-default.conf /etc/apache2/sites-enabled/
CMD apachectl -D FOREGROUND
</syntaxhighlight>

Y para lanzarlo:

docker run --name my-app --rm -d -p 8001:8000 app:v1

y para probarlo:

curl -X GET http://127.0.0.1:8888/php/

== Ejercicio 7 ==

Instale el paquete ''netcat-traditional'' en una imagen de contenedor de ''ubuntu''. Lance la orden:

nc -u -l -p 8080

en el contenedor. Asegúrese de crear una redirección de puertos de 9999 desde el ''host'' al puerto 8080 en el contenedor.

Desde fuera del contenedor, pruebe a conectarse con:

nc -u 127.0.0.1 9999

== Ejercicio 8 ==

Cree una imagen derivada de "ubuntu" con un Dockerfile que incluya soporte de python y lance el siguiente código en Python:

<syntax lang="python">
from http.server import BaseHTTPRequestHandler, HTTPServer
import time

hostName = "0.0.0.0"
serverPort = 8080

class MyServer(BaseHTTPRequestHandler):
def do_GET(self):
self.send_response(200)
self.send_header("Content-type", "text/html")
self.end_headers()
self.wfile.write(bytes("<html><head><title>Welcome!</title></head>", "utf-8"))
self.wfile.write(bytes("<body>", "utf-8"))
self.wfile.write(bytes("This is an example web server.", "utf-8"))
self.wfile.write(bytes("</body></html>", "utf-8"))

if __name__ == "__main__":
webServer = HTTPServer((hostName, serverPort), MyServer)
print("Server started http://%s:%s" % (hostName, serverPort))

try:
webServer.serve_forever()
except KeyboardInterrupt:
pass

webServer.server_close()
print("Server stopped.")
</syntax>

Llame a su imagen "python-http-server". Lance una instancia de la imagen "python-http-server" mapeando el puerto 9999 al puerto 8888/tcp del contenedor. Compruebe con:

<syntax lang="bash">
curl http://127.0.0.1:9999/
</syntax>

que muestre la página HTML que ofrece el servidor, que debería ser:

<syntax lang="bash">
<html><head><title>Welcome!</title></head><body>This is an example web server.</body></html>
</syntax>