{"id":19474113,"url":"https://github.com/manufosela/introduccion-docker","last_synced_at":"2025-04-25T12:31:42.432Z","repository":{"id":146941444,"uuid":"157129920","full_name":"manufosela/introduccion-docker","owner":"manufosela","description":"tutorial introducción a docker y docker-compose creando un api node con mongo","archived":false,"fork":false,"pushed_at":"2025-03-27T20:47:04.000Z","size":859,"stargazers_count":49,"open_issues_count":0,"forks_count":18,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-04-03T22:23:38.834Z","etag":null,"topics":["docker","express","mongodb","nodejs","tutorial"],"latest_commit_sha":null,"homepage":null,"language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/manufosela.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-11-11T23:02:44.000Z","updated_at":"2025-03-27T20:47:01.000Z","dependencies_parsed_at":null,"dependency_job_id":"91d2d2ab-2b63-4f1d-9ab7-f562e54eafd1","html_url":"https://github.com/manufosela/introduccion-docker","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manufosela%2Fintroduccion-docker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manufosela%2Fintroduccion-docker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manufosela%2Fintroduccion-docker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manufosela%2Fintroduccion-docker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/manufosela","download_url":"https://codeload.github.com/manufosela/introduccion-docker/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250817740,"owners_count":21492211,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["docker","express","mongodb","nodejs","tutorial"],"created_at":"2024-11-10T19:23:32.079Z","updated_at":"2025-04-25T12:31:42.355Z","avatar_url":"https://github.com/manufosela.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Introduccion a Docker\nTutorial de introducción a docker y docker-compose creando una aplicación fullstack, con un contenedor node-express para el api, otro con mongodb y otro con nginx para servir los ficheros estáticos.\n\n[NOTAS] \n* Para este ejemplo se ha utilizado un sistema operativo Ubuntu, por lo que todos los ejemplos de instalación de programas se harán para este entorno. Puedes cambiarlo por los de tu sistema operativo.\n* El sistema operativo tiene instalado node 8 y npm\n* Cuidado con el copy-paste desde el README que puede hacer que no funcione, es preferible bajar el fichero del repo.\n\n## ¿Qué es docker?\n\nDocker es un proyecto de código abierto que automatiza el despliegue\nde aplicaciones dentro de contenedores de software, proporcionando\nuna capa adicional de abstracción y automatización de virtualización de\naplicaciones en múltiples sistemas operativos [Fuente Wikipedia](https://es.wikipedia.org/wiki/Docker_(software))\n\nDocker es un \"emulador\" de entornos aislado para poder ejecutar programas sin que afecte a mi sistema operativo (SO) y pudiendose llevar y replicar en otros SS.OO. o entornos.\nParecido a VirtualBox o VMWare, pero mucho más ligero y a nivel de sistema operativo. Básicamente no vas a tener más de un sistema operativo completo corriendo en tu máquina. ![virtualización vs contenedores](https://i.ytimg.com/vi/TvnZTi_gaNc/maxresdefault.jpg)\nDocker consta de imágenes y contenedores:\n1. Una **imagen** es la especificación inerte, inmmutable, una foto del estado y de unas piezas de software que incluyen desde la aplicación que queremos ejecutar hasta las librerias y todo lo necesario para que corra encima del sistema operativo en el cual se ejecuta.\n2. Un **contenedor** es un entorno aislado con la instanciación de una imagen, el cual\nse puede configurar.\n\nUna analogía sería que la imagen es la clase y el contenedor el objeto de la clase.\n\n# Instalación de Docker en ubuntu\n1. Instalamos docker y docker-compose:\n```shell\nsudo apt install docker docker-compose\n```\n2. Añadimos al usuario de ubuntu al grupo docker\n```shell\nsudo usermod -aG docker $USER\nsudo systemctl restart docker\n```\n3. En https://hub.docker.com/ podemos buscar imagenes de docker ya preparadas\n4. Podemos comprobar qué imágenes tenemos con:\n```shell\n  docker images\n```\nSi te diera el error: **\"Got permission denied while trying to connect to the Docker daemon socket...\"** será necesario reiniciar el sistema operativo.\n\nSi te diera el error: **\"cannot connect to the docker daemon\"** es porque hay que arrancar el servicio.\nSigue los siguientes pasos para solucionarlo: \n```shell\nsystemctl is-active docker\nsystemctl start docker\nsystemctl enable docker\n```\nSi necesitas mas información sobre cuestiones de docker en https://www.configserverfirewall.com/docker/ puedes encontrarla.\nSi no en la página oficial de docker https://www.docker.com/\n\n# Comandos Docker\n## Básicos\nListado de imágenes de docker instaladas:\n```shell\n  docker images\n```\nListado de contenedores de docker creados:\n```shell\n  docker container ls\n```\no su alias\n```shell\n  docker ps\n```\n\nPara bajar una de imágen de docker del [docker hub](https://hub.docker.com/):\n```shell\n  docker pull IMAGEN\n```\n\n## Registros de imágenes públicos populares\nA parte del repositorio oficial de docker tenemos más repositorios de imágenes publicadas por proveedores, donde podemos encontrar una amplia librería de imágenes de las aplicaciones más populares.\n\n- El [Google Container Registry](https://cloud.google.com/container-registry/)\n- [Quay](https://quay.io/)\n- [Amazon Container Registry](https://aws.amazon.com/it/ecr/)\n\n\n## Más comandos\n```shell\n  docker build -t NOMBRE_IMAGEN .\n  docker run NOMBRE_IMAGEN\n  docker inspect CONTENEDOR-ID\n  docker logs CONTENEDOR-ID\n  docker exec -it CONTENEDOR /bin/bash\n  docker start / stop / restart CONTENEDOR-ID\n  docker stop CONTENEDOR-ID\n  docker rm CONTENEDOR-ID\n  docker rmi IMAGEN\n```\n\n* **build** se utiliza para generar/contruir una imagen a partir del Dockerfile\n* **run** se utiliza para lanzar el contenedor a partir de una imagen\n* **inspect** se utiliza para obtener información a bajo nivel del contenedor\n* **logs** se utiliza para ver la salida generada por consola al ejecutar el contenedor\n* **exec** se utiliza para ejecutar comandos en un contenedor que está ejecutandose\n* **stop** se utiliza para parar la ejecución de un contenedor que está ejecutandose\n* **rm** se utiliza para borrar un contenedor\n* **rmi** para borrar una imagen creada\n\n# Pasos para crear y lanzar un contenedor Docker\n1. Crear el directorio de trabajo\n2. Entrar en el directorio de trabajo\n3. Crear el fichero Dockerfile\n4. Crear el contenedor: `docker build`\n5. Lanzar el contenedor creado: `docker run`\n6. Comprobar que está lanzado: `docker ps`\n7. Comprobar logs del contenedor: `docker logs`\n\n# Ejemplo: Creando un contenedor nginx\n\n## Levantando el contenedor nginx básico:\n```shell\n  mkdir docker_example\n  cd docker_example\n  docker pull nginx\n  docker images\n  docker ps\n  docker run -d --name \"web\" -p 80:80 nginx;\n  docker ps\n  docker logs [CONTENEDOR-ID]\n  docker inspect [CONTENEDOR-ID]\n```\nSi no tenemos ningún otro proceso corriendo en el puerto 80 podremos entrar en http://localhost y ver la página por defecto de nginx.\n\n## Montando una carpeta compartida entre un directorio local y un directorio dentro del contenedor Docker\n```shell\n  mkdir www\n  cd www\n  echo “\u003ch1\u003eMI CONTENEDOR NGINX CON DOCKER\u003c/h1\u003e” \u003e index.html\n  cd ..\n  docker stop web\n  docker ps\n  docker run -d --name \"web\" -p 80:80 -v $(pwd)/www:/usr/share/nginx/html nginx;\n  docker ps\n```\nPara comprobar mas contenedores que se hayan podido quedar \"zombies\" podemos usar la opción -a (--all)\n```shell\n  docker ps -a\n```\nPara eliminar un contenedor \"zombie\" podemos usar el comando rm\n```shell\n  docker rm [CONTENEDOR-ID]\n  docker ps -a\n```\n\nAnalicemos el comando de ejecución del contenedor con sus parámetros:\n```shell\n  docker run -d --name \"web\" -p 80:80 -v $(pwd)/www:/usr/share/nginx/html nginx\n```\nCOMANDO: **run** Sirve para lanzar un contenedor de la imagen nginx, llamado \"web\"\nPARAMETROS:\n* **-d** o --detach, ejecuta el contenedor en segundo plano (background).\n* **--name** para darle un nombre a nuestro contenedor y sea mas sencillo referenciarlo e identificarlo.\n* **-v** le indicamos que monte un [volumen](http://www.alegsa.com.ar/Dic/volumen.php) que enlaza desde la ruta local *$(pwd)/www*  a la ruta dentro del contenedor */usr/share/nginx/html* nginx que es la que utiliza este programa para servir\n* **-p** conectamos el puerto 80 de nuestra máquina con el puerto 80 del contenedor, que como tiene el servidor nginx corriendo en dicho puerto, estaremos dando acceso al puerto del contenedor desde nuestro puerto, siempre y cuando este esté libre, si no deberemos ponerlo en un puerto libre de nuestro equipo.\n\nPodemos comprobarlo:\n* Comprobamos http://localhost en un navegador\n* Modificamos index.html\n* Comprobamos http://localhost en un navegador\n\n# Ejercicios\n1. Clonar un componente Polymer y hacer que se muestre la demo en un contenedor de nginx\n2. Arrancar tres contenedores de nginx en los puertos 80, 8080 y 8081\n\n# Haciendo más cosas con Docker\n\n## ¿Y si necesito crear un servidor express en node para exponer un api que se alimente de mongodb?\nPues lo ideal es separar el servidor node-express del servidor de mongodb.\nDe esta manera si necesito escalar o cambiar uno de los dos, el otro no tiene por qué verse afectado. Seguiremos los siguientes pasos:\n\n1. Vamos a crear un contenedor con node-express\n2. Vamos a crear un contenedor con un servidor de mongodb\n3. Vamos a conectar los dos contenedores: node-express y mongodb\n\nPreviamente creamos la carpeta de la aplicación, iniciamos el proyecto node e instalando mongodb:\n```shell\n  mkdir api (dentro de docker_example)\n  cd api\n  npm init\n  npm install --save express mongodb\n```\n\n## 1. Servidor con express\n\nVamos a crear un fichero index.js con un servidor express mínimo:\n```javascript\n  const express = require('express');\n  const app = express();\n  const PORT = 3000;\n  app.get('/', function(req, res) {\n  \tres.json({\"hello\": \"express with mongo\"});\n  });\n  app.listen(PORT, function(){\n    console.log('Your node js server is running on PORT:',PORT);\n  });\n```\n\nEjecutamos:\n```shell\n  node index.js\n```\nProbamos http://localhost:3000 y comprobamos que muestra el json: {\"hello\": \"express with mongo\"}\n\nLo siguiente será dockerizarlo.\n\n## Comandos de Dockerfile\n* *FROM* nos permite especificar desde qué imagen base de Docker Hub\n(https://hub.docker.com/) queremos construir.\n* *RUN* nos permite ejecutar un comando.\n* *WORKDIR* establece un directorio como el directorio de trabajo para las\ninstrucciones COPY, RUN y CMD.\n* *COPY* y *ADD* permite copiar archivos o un directorio completo desde una fuente fuera\ndel contenedor a un destino dentro del contenedor.\n* *EXPOSE* expone el puerto en el que el contenedor escuchará.\n* *CMD* establece el comando predeterminado para ejecutar nuestro contenedor.Nuestro Dockerfile para el api node-express\n\n## Creamos el fichero Dockerfile con la configuración de nuestra imagen:\n\nDentro de la carpeta docker_example creamos con un editor un fichero llamado **Dockerfile** y en el añadimos el siguiente contenido:\n\n```shell\n  FROM node:8\n  WORKDIR /usr/src/app\n  COPY package*.json ./\n  RUN npm install\n  COPY . .\n  EXPOSE 3000\n  CMD [ \"node\", \"index.js\" ]\n```\n\nTodos estas órdenes se ejecutan en nuestro contenedor cuando usemos el comando \"build\" de Docker.\n\nAnalicemos el contenido del fichero Dockerfile:\n* **FROM node:8** le indica que se baje la imagen node, versión 8, de docker hub.\n* **WORKDIR /usr/src/app** le indica que haga un \"cd\" para trabajar en esa ruta, dentro del contenedor. Si no existiese antes del \"cd\" haría un \"mkdir\". Piensa que el contenedor tiene una estructura de un sistema operativo linux.\n* **COPY pagacke*.json ./** copia desde nuestro directorio donde se encuentre el Dockerfile los ficheros que cumplan la expresión al directorio que se encuentre el contenedor, que definimos con WORKDIR\n* **RUN npm install** ejecuta la instalación del package.json y package-lock.json que hemos copiado en /usr/src/app\n* **COPY . .** copia todos los archivos desde nuestro directorio donde se encuentra el Dockerfile, excepto los indicados en el fichero .dockerignore y los copia en el directorio actual de trabajo indicado por WORKDIR\n* **EXPOSE 3000** abre el puerto 3000 del contenedor\n* **CMD [\"node\", \"index.js\"]* es el comando que se queda lanzado en el contenedor.\n\n## Fichero .dockerignore\n\nCreamos el fichero '.dockerignore' para evitar copiar a la imagen los ficheros que no queramos copiar en ella.\n```shell\n  node_modules\n  *.log\n  docker-compose.yml\n  Dockerfile\n  data\n```\n\n## Construyendo y corriendo el contenedor node\n\nConstruimos la imagen según le indica Dockerfile:\n```shell\n  docker build -t manufosela:api .\n  docker images\n```\nLanzamos el contenedor:\n```shell\n  docker run -p 3000:3000 -d manufosela:api\n  docker ps\n```\n\n### Pregunta\n#### ¿Si cambio algo en el index.js se refleja en http://localhost:3000?\n#### ¿Por qué?\nNo se refleja puesto que en el Dockerfile hemos indicado con *COPY . .* que copiemos toda la carpeta, a excepción de lo indicado en el fichero .dockerignore, en la carpeta de trabajo de la imagen. Una vez copiado ya no es posible alterar su contenido.\nEsto es lo que querremos hacer cuando subamos a producción nuestra aplicación, pero no cuando estamos desarrollando.\n\n#### ¿Cómo podemos hacer para que cualquier cambio en mi local se refleje en el servidor node-express?\nComo hemos visto antes con el parámetro -v podemos referenciar volumenes de tu equipo dentro del contenedor.\n\n```shell\n  docker run -p 3000:3000 -d -v $(pwd)/index.js:/usr/src/app/index.js manufosela:api\n```\n\nModificamos index.js\nTendremos que borrar el contenedor y volver a construirlo y volver a ejecutar el contenedor para que el servidor node-express lea los cambios.\n\n```shell\n\tdocker stop [CONTENEDOR_ID]\n\tdocker rm [CONTENEDOR_ID]\n\tdocker build -t manufosela:api .\n\tdocker run -p 3000:3000 -d manufosela:api\n```\n\nAhora sí se ven reflejados los cambios en http://localhost:3000\n\nPodemos utilizar paquetes de npm, como forever, que detectan cambios en el index.js relanzando el servidor node-express.\nSería necesario por un lado instalar el paquete forever y por otro cambiar el comando CMD para que ejecute forever.\nLo dejo como ejercicio :)\n\n## 2. Docker de mongodb\nVamos a utilizar la imagen ya hecha de mongodb de docker hub:\n```shell\n  docker pull mongo\n  docker images\n  docker run -it -d mongo\n  docker ps\n```\nCon esto tenemos corriendo un servidor mongodb que expone el puerto 27017, que es el puerto por defecto de mongo, de manera que tenemos una base de datos mongo corriendo en nuestro equipo, pero sin haber tenido que instalar ni configurar nada y sin que haya \"ensuciado\" nuestro sistema operativo instalando dependencias o librerias.\n\n### Interactuamos para probar mongodb\nPara poder probarlo, primero debemos averiguar la IP del servidor mongodb, para ello ejecutamos:\n\n```shell\n  docker ps\n```\nNos fijamos, al final, en el nombre aleatorio que le ha dado al contenedor de mongo que serán dos nombres separados por un guion bajo. Usamos dicho nombre para ejecutar lo siguiente:\n\n```shell\n  docker run -it --link=[NOMBRE_CONT]:mongo mongo /bin/bash\n```\nCon esto creamos un contenedor temporal que enlaza con la consola del contenedor que está corriendo el servidor de mongo y entramos en su consola. Lo veremos porque cambia el prompt.\n\nAhora ejecutamos:\n\n```shell\n  env\n```\nQue nos muestra todas las variables de entorno.\nNos fijamos en la línea que nos muestra **MONGO_PORT_27017_TCP_ADDR** para obtener la ip del contenedor:\n\n```shell\n[...]\nHOME=/root\nSHLVL=1\nMONGO_PORT_27017_TCP_ADDR=172.17.0.3\nMONGO_ENV_JSYAML_VERSION=3.10.0\nMONGO_MAJOR=4.0\n[...]\n```\n\nCerramos la consola con `exit`\n\nEl comando para ejecutar el cliente de mongodb es `mongo` para lo que deberemos tener instalado el cliente de mongodb en nuestro equipo llamado `mongodb-clients`\n\nPara saber si lo tenemos instalado podemos ejecutar:\n```shell\nsudo dpkg --get-selections | grep mongo\n```\nSi no lo está lo podemos instalar con:\n```shell\nsudo apt install mongodb-clients\n```\n\nSi lo ejecutamos simplemente `mongo` y no tenemos un servidor mongodb local corriendo, obtendremos este error: `couldn't connect to server 127.0.0.1:27017, connection attempt failed: SocketException: Error connecting to 127.0.0.1:27017 :: caused by :: Connection refused`\n\nPara poder conectar con el servidor mongodb de nuestro contenedor deberemos indicar la ip y el puerto al que conectarnos:\n\n```shell\nmongo 172.17.0.3:27017\n```\n\nEsto nos conectará con la línea de comandos de mongo que se caracteriza por tener el prompt **\u003e**\nPara interactuar con la base de datos podemos ejecutar algunos comandos de mongo:\n\n```shell\n \u003e show dbs\n \u003e use local\n \u003e show collections\n \u003e db.startup_log.find({})\n \u003e db.startup_log.find({}).pretty()\n \u003e use midb\n \u003e db.micoleccion.insert({elemento:\"uno\"})\n \u003e show collections\n \u003e db.micoleccion.find()\n```\n\nUsamos CTRL+C para salir de la consola de mongo.\n\n## Entendiendo como se crea una imagen de docker\n\n![layered-file-system](https://raw.githubusercontent.com/manufosela/introduccion-docker/master/images/docker_images_example.png)\n\nTanto en la **Image 1** como en la **Image 2** podemos ver que tienen en común en su Dockerfile la base de node:8, la copia de los ficheros package.json y package-lock.json y la instalación del package.json con **npm install**\n\nA la derecha de cada orden, vemos un \"hash\", que es el identificador de las imagenes temporales que va creando, conforme va ejecutando cada orden.\n\nCuando ejecutamos **docker images -a** podemos ver todas las imagenes intermedias que se han creado.\n\nCuando borramos la imagen \"padre\", todas las que dependen de esta se borraran tambien.\n\n## 3. Conectar docker node-express con docker mongodb\n\nPara facilitar y conectar el contenedor de node-express con el contenedor de mongodb vamos a valernos de *docker-compose*\n\n![Docker y Docker-compose](http://i66.tinypic.com/2ura0pi.png)\n\n\n**Docker-compose** nos facilita la orquestación de contenedores para que se relacionen e interactuen entre ellos.\nSe configura mediante un archivo *.yml* llamado *docker-compose.yml*\nEn dicho fichero se indica qué contenedores se enlazan con quien, de manera\nque de una sola llamada podemos arrancar, parar y relacionar varios contenedores.\n\n### Creamos el fichero docker-compose.yml\n```yml\nversion: \"2\"\nservices:\n  app:\n    container_name: app\n    restart: always\n    build: .\n    ports:\n    - \"3000:3000\"\n    links:\n      - mongo\n  mongo:\n    container_name: mongo\n    image: mongo\n    volumes:\n      - ./data:/data/db\n    ports:\n      - \"27017:27017\"\n```\n\n# Docker-compose\n\n## Paramos los contenedores de node-express y mongodb\nAntes de continuar y para poder utilizar docker-compose debemos parar los contenedores que hemos lanzado manualmente.\nPara ello ejecutamos:\n```shell\ndocker ps\n```\nY anotamos los CONTAINER_ID del contenedor de mongo y node-express, el de nginx podemos dejarlo corriendo.\nUna vez tengamos los dos ids ejecutamos:\n```shell\ndocker stop [CONTAINER_ID_NODE] [CONTAINER_ID_MONGO]\n```\n\nCon esto los paramos, pero los contenedores siguen lanzados, por lo que ahora deberemos borrarlos:\n```shell\ndocker rm [CONTAINER_ID_NODE] [CONTAINER_ID_MONGO]\n```\n\n## Probando docker-compose\n\nEjecutamos:\n```shell\n  docker-compose build\n  docker-compose up -d\n  docker-compose ps\n```\nPodemos probar que tenemos servidor de node y de mongo corriendo, entrando en [http:localhost:3000] y ejecutando el comando `mongo`, esta vez sin IP ni puerto, ya que docker-compose conecta automaticamente localhost con la IP del contenedor mongo.\n\nPodemos parar y borrar todos los contenedores de una vez.\n\n```shell\n  docker-compose down\n```\nLo podemos comprobar con:\n```shell\n  docker-compose ps\n  docker ps\n```\n\n## Usando mongo en nuestro api\n\nModificamos el fichero index.js que quedara como sigue:\n```javascript\nconst express = require('express');\nconst app = express();\nconst PORT = 3000;\n\nconst mongodb = require('mongodb');\nconst DB = {\n\tconfig: 'mongodb://mongo:27017'\n};\nlet dbo;\n\napp.get('/', function (req, res) {\n\tres.json({ \"hello\": \"express with mongo\" });\n});\n\nconst client = mongodb.MongoClient;\nclient.connect(DB.config, function (err, db) {\n\tif (err) {\n\t\tconsole.log('database is not connected')\n\t}\n\telse {\n\t\tconsole.log('connected!!');\n\t\tdbo = db.db(\"midb\");\n\t}\n});\napp.get('/misdatos', function (req, res) {\n\tlet data = dbo.collection(\"micoleccion\").find({}).toArray((err, result) =\u003e {\n\t\tif (err) throw err;\n\t\tres.json(result);\n\t});\n});\napp.listen(PORT, function () {\n\tconsole.log('Your node js server is running on PORT:', PORT);\n});\n```\n\nAhora para que los cambios tengan efecto debemos parar todo, volver a construir los contenedores y volver a lanzarlos:\n```shell\n  docker-compose down\n  docker-compose build\n  docker-compose up -d\n  docker-compose ps\n```\n\nPara poder probar el api debemos cargar con datos la base de datos llamada mibd y la colección de esa base de datos micoleccion\n\n## Probamos los entry-point\nMediante la consola de mongo podemos crear alguna entrada en la base de datos:\n```shell\n  mongo\n  \u003e use midb\n  \u003e db.micoleccion.insert({“titulo”: “primero de prueba”})\n  \u003e exit\n```\no bien importar un fichero con los datos\n\n```shell\nmongoimport --db midb --collection micoleccion --file datos.json\n```\nEl fichero datos.json contendrá información de esta manera:\n\n{ \"_id\" : 1, \"titulo\": \"primero de prueba\"}\n{ \"_id\" : 2, \"titulo\": \"segundo de prueba\"}\n\nProbamos en [http://localhost:3000/misdatos] y veremos como nos muestra el json de la información que se recupera.\n\n# Usar Nginx para servir los estaticos y el API\n\nYa que tenemos la imagen de nginx instalada y el contenedor corriendo, en vez de tener que usar el puerto 3000 para llamar a nuestro API, podemos facilitarlo con nginx que haga de proxy y redirija una url del puerto 80 al puerto 3000.\n\n## Creando la configuración de nginx\n\nSeguimos dentro de nuestro directorio `docker_example/api` y creamos el directorio config y entramos en él:\n```shell\nmkdir config\ncd config\n```\nCreamos un archivo llamado **api.conf** con el siguiente contenido:\n```shell\n    server {\n        listen          80;\n        server_name     localhost;\n\n        location / {\n                root /usr/share/nginx/html;\n                index index.html index.htm;\n        }\n\n        location /api/ {\n            resolver app;\n            proxy_pass http://app:3000/;\n            proxy_set_header  X-Real-IP  $remote_addr;\n            proxy_set_header  X-Forwarded-For $proxy_add_x_forwarded_for;\n            proxy_set_header  Host $http_host;\n            proxy_redirect    off;\n        }\n    }\n```\n\nEste fichero de configuración reemplazará al que trae por defecto nginx.\nLo único que hemos hecho ha sido añadir el apartado \"location /api/\" para indicar que cuando se llame a http://localhost/api queremos que haga un \"proxy_pass\" a \"localhost:3000\", enmascarando las llamadas a nuestro API.\n\n```html\n\u003cACLARACION\u003e: Fijate que **app** en la configuración del proxy_pass de nginx \nen las dos primeras lineas hace referencia al nombre del servicio \"app\"\nque corre nuestro api rest por el puerto 3000. Docker hace de DNS \nresolviendo la IP del contenedor, evitando un error 502. \nSi cambias el nombre del servicio, debes cambiarlo en la configuración\nde nginx.\n```\n\n## Añadiendo nginx a la configuracion de docker-compose\nAhora hay que modificar el fichero docker-compose para que tambien lance el contenedor de nginx:\n\n```yml\nversion: \"2\"\nservices:\n  app:\n    container_name: app\n    restart: always\n    build: .\n    ports:\n      - \"3000:3000\"\n    links:\n      - mongo\n  mongo:\n    container_name: mongo\n    image: mongo\n    volumes:\n      - ./data:/data/db\n    ports:\n      - \"27017:27017\"\n  web:\n    container_name: web\n    image: nginx\n    volumes:\n      - ./config/api.conf:/etc/nginx/conf.d/default.conf\n      - ../www:/usr/share/nginx/html\n    ports:\n      - \"80:80\"\n    links:\n      - app\n\n```\n\nComo podemos apreciar por la sintaxis del bloque \"web\", usamos la imagen de nginx, montamos el volumen api.conf dentro de la configuración por defecto de nginx y exponemos el puerto 80 con el del contenedor.\nAhora vamos a probar.\n\n## Probamos la nueva configuración: contenedor node-express, contenedor mongodb, contenedor nginx\n\n```shell\ndocker-compose build\ndocker-compose up -d\ndocker-compose ps\n```\n\nPodemos entrar en http://localhost y ver como sirve la pagina index.html que creamos en la carpeta /www\n\nPodemos entrar en http://localhost/api y ver como sirve el mensaje que devuelve el servidor node-express cuando accedemos a http://localhost:3000\n\nPodemos entrar en http://localhost/api/misdatos y ver como sirve el json de la base de datos que sirve tambien cuando accedemos a http://localhost:3000/misdatos\n\n\n# Resumiendo\n\nCon **docker** podemos crear entornos de ejecución aislados y configurarlos a nuestro antojo sin romper nada y asegurando compatiblidad\n\nCon **docker-compose** podemos orquestar todos los contenedores creados, comunicarlos e iniciarlo y pararlos fácilmente.\n\n# Bonus Tricks\n\nPara ver los volumenes, contenedores e imagenes\n```shell\ndocker system info\n```\nPara obtener el listado de volumenes\n```shell\n\"docker volume ls\n```\nPara obtener la lista de contenedores arrancados y parados\n```shell\ndocker container ls -a\n```\nPara borrar contenedores parados\n```shell\ndocker container prune\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmanufosela%2Fintroduccion-docker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmanufosela%2Fintroduccion-docker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmanufosela%2Fintroduccion-docker/lists"}