# Desarrolla tu aplicación Rust ## Prerrequisitos - Has instalado la última versión de [Docker Desktop](/get-started/get-docker/). - Has completado las guías en el [Centro de aprendizaje](/desktop/use-desktop/) de Docker Desktop para conocer los conceptos de Docker. - Tienes un [cliente git](https://git-scm.com/downloads). Los ejemplos de esta sección utilizan un cliente git basado en la línea de comandos, pero puedes utilizar cualquier cliente. ## Resumen En esta sección, aprenderás cómo utilizar volúmenes y redes en Docker. También utilizarás Docker para compilar tus imágenes y Docker Compose para hacer todo mucho más fácil. Primero, veremos cómo ejecutar una base de datos en un contenedor y cómo utilizar volúmenes y redes para persistir tus datos y permitir que tu aplicación se comunique con la base de datos. Luego, lo reuniremos todo en un archivo Compose que te permitirá configurar y ejecutar un entorno de desarrollo local con un solo comando. ## Ejecuta una base de datos en un contenedor En lugar de descargar PostgreSQL, instalarlo, configurarlo y luego ejecutar la base de datos PostgreSQL como un servicio, puedes utilizar la Imagen Oficial de Docker para PostgreSQL y ejecutarla en un contenedor. Antes de ejecutar PostgreSQL en un contenedor, crea un volumen que Docker pueda administrar para almacenar tus datos y configuración persistentes. Utiliza la función de volúmenes con nombre (named volumes) que proporciona Docker en lugar de utilizar montajes de tipo bind (bind mounts). Ejecuta el siguiente comando para crear tu volumen. ```console $ docker volume create db-data ``` Ahora crea una red que tu aplicación y la base de datos utilizarán para comunicarse entre sí. La red se llama red puente definida por el usuario (user-defined bridge network) y te proporciona un servicio de resolución DNS útil que puedes utilizar al crear tu cadena de conexión. ```console $ docker network create postgresnet ``` Ahora puedes ejecutar PostgreSQL en un contenedor y conectarlo al volumen y a la red que creaste anteriormente. Docker descargará la imagen desde Hub y la ejecutará localmente por ti. En el siguiente comando, la opción `--mount` sirve para iniciar el contenedor con un volumen. Para obtener más información, consulta [Volúmenes de Docker](/engine/storage/volumes/). ```console $ docker run --rm -d --mount \ "type=volume,src=db-data,target=/var/lib/postgresql" \ -p 5432:5432 \ --network postgresnet \ --name db \ -e POSTGRES_PASSWORD=mysecretpassword \ -e POSTGRES_DB=example \ postgres:18 ``` Ahora, asegúrate de que tu base de datos PostgreSQL esté en funcionamiento y de que puedas conectarte a ella. Conéctate a la base de datos PostgreSQL en ejecución dentro del contenedor. ```console $ docker exec -it db psql -U postgres ``` Deberías ver una salida como la siguiente. ```console psql (15.3 (Debian 15.3-1.pgdg110+1)) Type "help" for help. postgres=# ``` En el comando anterior, iniciaste sesión en la base de datos PostgreSQL pasando el comando `psql` al contenedor `db`. Presiona `ctrl-d` para salir de la terminal interactiva de PostgreSQL. ## Obtén y ejecuta la aplicación de muestra Para la aplicación de muestra, utilizarás una variante del backend de la aplicación react-rust-postgres de [Awesome Compose](https://github.com/docker/awesome-compose/tree/master/react-rust-postgres). 1. Clona el repositorio de la aplicación de muestra utilizando el siguiente comando. ```console $ git clone https://github.com/docker/docker-rust-postgres ``` 2. En el directorio del repositorio clonado, ejecuta `docker init` para crear los archivos de Docker necesarios. Consulta el siguiente ejemplo para responder a las preguntas de `docker init`. ```console $ docker init Welcome to the Docker Init CLI! This utility will walk you through creating the following files with sensible defaults for your project: - .dockerignore - Dockerfile - compose.yaml - README.Docker.md Let's get started! ? What application platform does your project use? Rust ? What version of Rust do you want to use? 1.70.0 ? What port does your server listen on? 8000 ``` 3. En el directorio del repositorio clonado, abre el `Dockerfile` en un IDE o editor de texto para actualizarlo. `docker init` se encargó de crear la mayoría de las instrucciones en el Dockerfile, pero tendrás que actualizarlo para tu aplicación específica. Además de un directorio `src`, esta aplicación incluye un directorio `migrations` para inicializar la base de datos. Agrega un montaje de tipo bind para el directorio `migrations` en la etapa de compilación en el Dockerfile. El siguiente es el Dockerfile actualizado. ```dockerfile {hl_lines="28"} # syntax=docker/dockerfile:1 # Los comentarios se proporcionan a lo largo de este archivo para ayudarte a empezar. # Si necesitas más ayuda, visita la guía de referencia de Dockerfile en # https://docs-docker.esdocu.com/reference/dockerfile/ ################################################################################ # Crea una etapa para compilar la aplicación. ARG RUST_VERSION=1.70.0 ARG APP_NAME=react-rust-postgres FROM rust:${RUST_VERSION}-slim-bullseye AS build ARG APP_NAME WORKDIR /app # Compila la aplicación. # Aprovecha un montaje de caché en /usr/local/cargo/registry/ # para las dependencias descargadas y un montaje de caché en /app/target/ para # las dependencias compiladas, lo que acelerará las compilaciones posteriores. # Aprovecha un montaje de tipo bind al directorio src para evitar tener que copiar el # código fuente dentro del contenedor. Una vez compilado, copia el ejecutable a un # directorio de salida antes de que se desmonte el /app/target montado en caché. RUN --mount=type=bind,source=src,target=src \ --mount=type=bind,source=Cargo.toml,target=Cargo.toml \ --mount=type=bind,source=Cargo.lock,target=Cargo.lock \ --mount=type=cache,target=/app/target/ \ --mount=type=cache,target=/usr/local/cargo/registry/ \ --mount=type=bind,source=migrations,target=migrations \ <