Contenedores: retoques

Author: alejrot

docs/contenedores/compose.md

@@ -17,7 +17,18 @@ lo que lo hace muy fácil de interpretar visualmente.
 Este archivo es llamado en muchos proyectos como `docker-compose.yml`.
 También puede ponérsele la extensión `.yaml`.
 
+## Nombre de proyecto
 
+El campo `name` asigna un nombre al proyecto,
+el cual será leído por el gestor de contenedores
+y suele ser usado para nombrar a los elementos internos del proyecto.
+Si este campo no se indica explícitamente
+entonces se asigna automáticamente
+el nombre de la carpeta que contiene al archivo.
+
+```yaml title="compose.yml - nombre"
+name: mi_proyecto
+```
 
 ## Sección `services`
 
@@ -123,24 +134,12 @@ services:
 ```
 
 
-
 ## Secciones opcionales
 
+A veces se necesitan crear secciones adicionales en el proyecto.
+Algunas de ellas son:
 
 
-## `name`
-
-El campo `name` asigna un nombre al proyecto,
-el cual será leído por el gestor de contenedores
-y suele ser usado para nombrar a los elementos internos del proyecto.
-Si este campo no se indica explícitamente
-entonces se asigna automáticamente
-el nombre de la carpeta que contiene al archivo.
-
-```yaml title="compose.yml - nombre"
-name: mi_proyecto
-```
-
 ### `volumes`
 
 Los [volumenes](volumenes.md) son elementos usados

docs/contenedores/despliegue.md

@@ -57,35 +57,25 @@ Todos estos pueden ser sobreescritos.
 
 ### `compose.yml`
 
-El archivo `compose.yml` sirve para definir
-los parámetros de creación y funcionamiento
-del contenedor (o los contenedores)
-del proyecto.
+
+Para este ejemplo se crea un único servicio
+y se le indica que el Dockerfile
+es aledaño al archivo `compose.yml`:
 
 
 ```yaml title="compose.yml - construir imagen"
+name: contar-python
+
 services:
 
   demo-contador:    # nombre de servicio - arbitrario
-    build: .        # ruta relativa al archivo Dockerfile
+    # necesarios
+    build: .        # Dockerfile en el mismo directorio
+    # opcionales
+    image: imagen-contador:v1
+    container_name: contenedor-contador
 ```
 
-Los contenedores del proyecto se crean debajo de la sección `services`.
-A cada contenedor se le pone un "nombre de servicio"
-y estos tienen varios parámetros configurables.
-En este caso sólo se especifica el parámetro `build`,
-que es el encargado de indicar
-la ruta relativa en el sistema anfitrión al archivo Dockerfile.
-
-<!-- 
-Algunos de ellos son:
-
-- El parámetro `build` es el encargado de indicar
-la ruta relativa en el sistema anfitrión al archivo Dockerfile;
-- El parámetro `image` asigna un nombre y una etiqueta de versión a la imagen a crear;
-- El parámetro `container_name` asigna un nombre al contenedor.
-Este nombre servirá para releer los logs, ordenar su arranque, etc.
- -->
 
 
 ## Puesta en marcha

docs/contenedores/volumenes.md

@@ -7,6 +7,13 @@ Son necesarios para prevenir
 la pérdida de los datos internos de los contenedores
 cada vez que éstos son borrados o recreados.
 
+Algunos usos habituales:
+
+- bases de datos;
+- archivos de los usuarios;
+- reportes de funcionamiento;
+- etc.
+
 
 ## Archivos en Python