Contenedores: ARG, ENV, ENTRY

Author: alejrot

demos/contenedores/entorno/.env

@@ -1 +1 @@
-VARIABLE="Vengo del archivo ENV"
+# VARIABLE="Vengo del archivo ENV"

demos/contenedores/entorno/Dockerfile

@@ -2,11 +2,15 @@
 # imagen de referencia
 FROM python:alpine
 
+
 # directorio de trabajo (se crea automáticamente)
 WORKDIR /code
 
 # copia de rutinas al directorio de trabajo
 COPY demo/ ./
 
+# variable de entorno local
+ENV VARIABLE_PYTHON="Me definieron en el Dockerfile"
+
 # comandos 
 CMD ["python", "main.py"]

demos/contenedores/entorno/compose.yml

@@ -7,31 +7,40 @@ services:
     build: .
     image: demo_entornos 
 
+
+
+
   # cada contenedor pone a prueba distintas interpolaciones
-  entornos:
+  entornos_interna:
     image: demo_entornos 
-    environment:
-      VARIABLE_PYTHON: "${VARIABLE}"
     depends_on:
       crear_imagen:
         condition: service_completed_successfully
 
-  entornos_default:
+  entornos_exterior:
     image: demo_entornos 
     environment:
-      VARIABLE_PYTHON: "${VARIABLE:-'valor predefinido'}"
+      VARIABLE_PYTHON: "${VARIABLE}"
     depends_on:
       crear_imagen:
         condition: service_completed_successfully
 
-  entornos_error:
+  entornos_default:
     image: demo_entornos 
     environment:
-      VARIABLE_PYTHON: "${VARIABLE?'Error: variable no inicializada'}"
+      VARIABLE_PYTHON: "${VARIABLE:-'valor predefinido'}"
     depends_on:
       crear_imagen:
         condition: service_completed_successfully
 
+  # entornos_error:
+  #   image: demo_entornos 
+  #   environment:
+  #     VARIABLE_PYTHON: "${VARIABLE?'Error: variable no inicializada'}"
+  #   depends_on:
+  #     crear_imagen:
+  #       condition: service_completed_successfully
+
   entornos_sustituir:
     image: demo_entornos 
     environment:

docs/blog/posts/v2.md

@@ -18,8 +18,12 @@ social:
     - Anexo de permisos de usuario movido desde Pathlib;
 
 - Sección [Contenedores](../../contenedores/index.md):
+    - Sobreescritura de comandos (`CMD` y `ENTRYPOINT`) reexplicados.
+    - Argumentos de contrucción (`ARG`) explicados.
+    - Variables de entorno explicadas.
     - Networks explicadas.
     - Port mapping agregado.
+    - Variables de entorno reexplicadas.
     - Contenidos básicos revisados y reordenados.
     - Nuevos demos.
 
@@ -30,6 +34,7 @@ social:
     - Empaquetado agregado (resumido);
     - Agregado de dependencias mejorado.
 
+- Sección Paralelismo renombrada como [Ejecución paralela](../../paralelismo/index.md)
 <!-- mas -->
 
 ## Versión 2.9

docs/contenedores/args.md

@@ -0,0 +1,109 @@
+---
+status: new
+date:
+    created: 2025-09-23
+    updated: 2025-09-23
+---
+
+
+# Argumentos de construcción
+
+
+Dentro del Dockerfile
+se permite pasar argumentos
+para modificar los parámetros
+de construcción de las imágenes.
+Estos argumentos son borrados
+cuando la construcción está completada.
+
+
+## Creación
+
+La cláusula reservada
+para crear los argumentos de imagen es `ARG`.
+Tras ella se define el nombre de argumento
+y se le asigna un valor:
+
+```Dockerfile title="Dockerfile - Argumentos"
+ARG ARGUMENTO=valor_default
+```
+
+Un uso habitual
+es la elección de la versión
+de una imagen de referencia.
+Por ejemplo se puede definir 
+el argumento `TAG_IMAGEN`
+para elegir el *tag* de la versión de Python:
+
+```Dockerfile title="Dockerfile - Tags como argumentos"
+# definicion de argumento
+ARG TAG_IMAGEN=3.13-alpine3.21
+# asignacion como default
+FROM python:${TAG_IMAGEN}
+```
+
+entonces la versión elegida
+para la contrucción de la imagen final
+será el intérprete 3.13
+instalada en Alpine Linux
+salvo indicación contraria.
+
+
+## Modificación
+
+Con el pàrámetro
+`args` del campo `build`
+se elige un nuevo valor
+para el arguimento.
+
+La asignación
+se puede hacer
+por mapeo:
+
+```yaml title="compose.yml - Argumentos" hl_lines="6-7"
+services:
+
+  contenedor: 
+    build:
+      context: .    # ruta al Dockerfile
+      args:
+        ARGUMENTO: valor_custom
+```
+
+La asignación
+se puede hacer
+también como lista:
+
+```yaml title="compose.yml - Argumentos" hl_lines="6-7"
+services:
+
+  contenedor: 
+    build:
+      context: .    # ruta al Dockerfile
+      args:
+        - ARGUMENTO=valor_custom
+```
+
+En ambos casos se necesita indicar
+la ruta al Dockerfile
+con el campo `context`.
+
+Retomando el ejemplo previo,
+para elegir como referencia
+la imagen reducida de Python 3.13
+instalada en Debian Trixie:
+
+```yaml
+services:
+
+  contenedor_python: 
+    build:
+      context: .    # ruta al Dockerfile
+      args:
+        TAG_IMAGEN: 3.13-slim-trixie
+```
+
+
+
+
+

docs/contenedores/comandos.md

@@ -1,46 +1,90 @@
 ---
-status: deprecated
+status: new
 date:
     created: 2025-07-01
     updated: 2025-08-26
 ---
 
 
 
-# Cambiar comandos 
+# Fijar y modificar comandos 
+
+En esta sección se ve cómo
+se pueden cambiar los comandos elegidos
+para las imágenes
+desde el archivo `compose.yml`
+y también como los comandos
+pueden ser fijados
+desde el Dockerfile.
 
-En esta sección se ve cómo se pueden
-cambiar los comandos elegidos en el archivo Dockerfile
-y también como éstos pueden ser fijados.
 
-## Elegir comandos
 
+## Elegir comandos
+<!-- 
 El comando a ser ejecutado por el contenedor
 se puede reemplazar desde el archivo `compose.yml`
 con ayuda del parámetro `command`.
 
-Algunos ejemplos:
+ -->
+
+El parámetro `command` del archivo `compose.yml`
+sirve para sobreescribir el comando definido
+con la cláusula `CMD` del Dockerfile.
+
+En el ejemplo del [primer despliegue](despliegue_demo.md)
+el demo se ejecuta desde la *sell* Bash
+con la sentencia:
+
+```bash title="Bash - ejecución de rutina"
+python contar.py 4
+```
+
+El comando fue adaptado al Dockerfile
+con la cláusula `CMD`.
+
+```Dockerfile title="Dockerfile - comando sobreescribible"
+# comando, opciones y argumentos (sobreescribibles)
+CMD ["python", "contar.py", "4"]
+``` 
+
+Este comando puede ser ignorado
+definiendo el campo `command`.
+Por ejemplo, para cambiar la cuenta final
+de 4 a 10:
 
+```yaml hl_lines="5" title="compose.yml - sobreescribir cuenta"
+services:
 
-```yaml hl_lines="5" title="compose.yml - sobreescribir comandos"
+  demo-contador:
+    build: .
+    command: "python contar.py 10"  # cuenta máxima alterada
+```
+
+
+También se puede ignorar la rutina interna de la imagen,
+por ejemplo para consultar
+la versión del intérprete Python instalada:
+
+```yaml hl_lines="5" title="compose.yml - omitir rutina interna"
 services:
 
   demo-contador:
     build: .
     command: "python --version" # versión de Python
 ```
 
+También se pueden ejecutar otros programas incluidos en la imagen
+por ejemplo para conocer qué versión del kernel Linux
+se incluyó internamente:
 
-```yaml hl_lines="5" title="compose.yml - sobreescribir comandos"
+```yaml hl_lines="5" title="compose.yml - cambiar de comando"
 services:
 
   demo-contador:
     build: .
     command: "uname -a"     # info sobre el kernel usado
 ```
 
-
-
 ## Fijar comandos
 
 
@@ -56,7 +100,7 @@ se delega en la cláusula `CMD`.
 
 Por ejemplo, si el comando original es:
 
-```Dockerfile title="Dcokerfile - comando sobreescribible"
+```Dockerfile title="Dockerfile - comando sobreescribible"
 # comando, opciones y argumentos (sobreescribibles)
 CMD ["python", "contar.py", "4"]
 ``` 
@@ -74,7 +118,7 @@ CMD ["4"]
 y en el archivo Compose sólo se podrán asignar
 los argumentos de la rutina:
 
-```yaml hl_lines="5" title="compose.yml - sobreescribir argumentos"
+```yaml hl_lines="5" title="compose.yml - comando fijo"
 services:
 
   demo-contador:

docs/contenedores/compose.md

@@ -2,7 +2,6 @@
 date:
     created: 2025-07-01
     updated: 2025-08-26
-status: new
 ---
 
 # Compose
@@ -56,6 +55,8 @@ con otros proyectos
 ni tampoco
 con el sistema anfitrión.
 
+Este es un esquema típico: 
+
 ```mermaid
 ---
 title: "Servicios - idea básica"

docs/contenedores/dependencia.md

@@ -1,5 +1,4 @@
 ---
-status: new
 date:
     created: 2025-07-01
     updated: 2025-09-12