{"id":2523,"date":"2017-02-03T18:46:36","date_gmt":"2017-02-03T18:46:36","guid":{"rendered":"https:\/\/www.couchbase.com\/blog\/?p=2523"},"modified":"2023-06-19T03:58:42","modified_gmt":"2023-06-19T10:58:42","slug":"microservice-using-docker-stack-deploy-wildfly-javaee-couchbase","status":"publish","type":"post","link":"https:\/\/www.couchbase.com\/blog\/es\/microservice-using-docker-stack-deploy-wildfly-javaee-couchbase\/","title":{"rendered":"Microservicio usando Docker stack deploy - WildFly, Java EE y Couchbase"},"content":{"rendered":"

Hay mucho material sobre microservicios, s\u00f3lo buscar en google<\/a>\u00a1! Hice una presentaci\u00f3n sobre refactorizaci\u00f3n de monolito a microservicios en Devoxx B\u00e9lgica hace un par de a\u00f1os y tiene buenas cr\u00edticas:\n<\/p>\n

Este blog mostrar\u00e1 c\u00f3mo Docker simplifica la creaci\u00f3n y el cierre de un microservicio. Todo el c\u00f3digo utilizado en este blog est\u00e1 en\u00a0github.com\/arun-gupta\/couchbase-javaee<\/a>.<\/p>\n

Definici\u00f3n de microservicios con Compose<\/h2>\n

Docker 1.13 introdujo un v3 de Docker Compose<\/a>. Los cambios en la sintaxis son m\u00ednimos, pero la diferencia clave es la adici\u00f3n de despliegue<\/a> atributo. Este atributo permite especificar r\u00e9plicas, rolling update y pol\u00edtica de reinicio para el contenedor. Nuestro microservicio iniciar\u00e1 un servidor de aplicaciones WldFly con una aplicaci\u00f3n Java EE pre-desplegada. Esta aplicaci\u00f3n hablar\u00e1 con una base de datos Couchbase para CRUD los datos de la aplicaci\u00f3n. Aqu\u00ed est\u00e1 la definici\u00f3n de Compose:<\/p>\n

\r\nversion: '3'\r\nservices:\r\n  web:\r\n    image: arungupta\/couchbase-javaee:travel\r\n    environment:\r\n      - COUCHBASE_URI=db\r\n    ports:\r\n      - 8080:8080\r\n      - 9990:9990\r\n    depends_on:\r\n      - db\r\n  db:\r\n    image: arungupta\/couchbase:travel\r\n    ports:\r\n      - 8091:8091\r\n      - 8092:8092 \r\n      - 8093:8093 \r\n      - 11210:11210<\/pre>\n
En este archivo Compose:<\/p>\n
    \n
  1. En este Compose se definen dos servicios con el nombre db<\/code> y web<\/code> atributos<\/li>\n
  2. Nombre de imagen para cada servicio definido mediante imagen<\/code> atributo<\/li>\n
  3. En arungupta\/couchbase:viaje<\/code> inicia el servidor Couchbase, lo configura utilizando API REST de Couchbase<\/a>y cargas\u00a0viaje-muestra<\/code> con ~32k documentos JSON.<\/li>\n
  4. En arungupta\/couchbase-javaee:travel<\/code> inicia WildFly y despliega el archivo WAR de la aplicaci\u00f3n creado a partir de https:\/\/github.com\/arun-gupta\/couchbase-javaee<\/a>. Clona ese proyecto si quieres construir tu propia imagen.<\/li>\n
  5. medio ambiente<\/code> define variables de entorno accesibles por la aplicaci\u00f3n desplegada en WildFly. COUCHBASE_URI<\/code> se refiere al servicio de base de datos. Esto se utiliza en el c\u00f3digo de la aplicaci\u00f3n como se muestra en https:\/\/github.com\/arun-gupta\/couchbase-javaee\/blob\/master\/src\/main\/java\/org\/couchbase\/sample\/javaee\/Database.java<\/a>.<\/li>\n
  6. El reenv\u00edo de puertos se realiza mediante puertos<\/code> atributo<\/li>\n
  7. \n
    depende_de<\/code> en el archivo de definici\u00f3n Compose garantiza el orden de inicio del contenedor. Pero las aplicaciones que se ejecutan dentro del contenedor deben garantizar el arranque a nivel de aplicaci\u00f3n. En nuestro caso, WildFly se inicia con bastante rapidez, pero la base de datos tarda unos segundos en iniciarse. Esto significa que la aplicaci\u00f3n Java EE desplegada en WildFly no puede comunicarse con la base de datos. Esto pone de manifiesto una pr\u00e1ctica recomendada al crear aplicaciones de microservicios: debe codificar de forma defensiva y asegurarse en la inicializaci\u00f3n de la aplicaci\u00f3n de que los microservicios de los que depende se han iniciado, sin asumir el orden de inicio. Esto se muestra en el c\u00f3digo de inicializaci\u00f3n de la base de datos en https:\/\/github.com\/arun-gupta\/couchbase-javaee\/blob\/master\/src\/main\/java\/org\/couchbase\/sample\/javaee\/Database.java<\/a>. Realiza las siguientes comprobaciones:<\/p>\n
      \n
    1. El cubo existe<\/li>\n
    2. El servicio de consulta de Couchbase ya funciona<\/li>\n
    3. El cubo de muestras est\u00e1 completamente cargado<\/li>\n<\/ol><\/div>\n<\/li>\n<\/ol>\n
      Esta aplicaci\u00f3n puede iniciarse mediante docker-compose up -d<\/code> en un \u00fanico host. O un cl\u00faster de motores Docker en modo enjambre utilizando docker stack deploy<\/code> mando.<\/p>\n
      Configurar el modo enjambre de Docker<\/h2>\n
      Inicialice el modo Enjambre utilizando el siguiente comando:<\/p>\n
      \r\ndocker swarm init<\/pre>\n
      Esto inicia un Gestor de Enjambre. Por defecto, los nodos gestores son tambi\u00e9n trabajadores, pero pueden configurarse para ser s\u00f3lo gestores.<\/div>\n
      Encuentre informaci\u00f3n sobre este cluster de un nodo utilizando el comando informaci\u00f3n de docker<\/code> mando:<\/p>\n
      \r\nContainers: 0\r\n Running: 0\r\n Paused: 0\r\n Stopped: 0\r\nImages: 17\r\nServer Version: 1.13.0\r\nStorage Driver: overlay2\r\n Backing Filesystem: extfs\r\n Supports d_type: true\r\n Native Overlay Diff: true\r\nLogging Driver: json-file\r\nCgroup Driver: cgroupfs\r\nPlugins:\r\n Volume: local\r\n Network: bridge host ipvlan macvlan null overlay\r\nSwarm: active\r\n NodeID: 92mydh0e09ba5hx3wtmcmvktz\r\n Is Manager: true\r\n ClusterID: v68ikyaff7rdxpaw1j0c9i60s\r\n Managers: 1\r\n Nodes: 1\r\n Orchestration:\r\n  Task History Retention Limit: 5\r\n Raft:\r\n  Snapshot Interval: 10000\r\n  Number of Old Snapshots to Retain: 0\r\n  Heartbeat Tick: 1\r\n  Election Tick: 3\r\n Dispatcher:\r\n  Heartbeat Period: 5 seconds\r\n CA Configuration:\r\n  Expiry Duration: 3 months\r\n Node Address: 192.168.65.2\r\n Manager Addresses:\r\n  192.168.65.2:2377\r\nRuntimes: runc\r\nDefault Runtime: runc\r\nInit Binary: docker-init\r\ncontainerd version: 03e5862ec0d8d3b3f750e19fca3ee367e13c090e\r\nrunc version: 2f7393a47307a16f8cee44a37b262e8b81021e3e\r\ninit version: 949e6fa\r\nSecurity Options:\r\n seccomp\r\n  Profile: default\r\nKernel Version: 4.9.5-moby\r\nOperating System: Alpine Linux v3.5\r\nOSType: linux\r\nArchitecture: x86_64\r\nCPUs: 4\r\nTotal Memory: 1.952 GiB\r\nName: moby\r\nID: SGCM:KDRD:G3M7:PZHN:J4RL:VFFR:G2SR:EKD5:JV4J:RL3X:LF7T:XF6V\r\nDocker Root Dir: \/var\/lib\/docker\r\nDebug Mode (client): false\r\nDebug Mode (server): true\r\n File Descriptors: 31\r\n Goroutines: 124\r\n System Time: 2017-01-27T08:25:58.032295342Z\r\n EventsListeners: 1\r\nNo Proxy: *.local, 169.254\/16\r\nUsername: arungupta\r\nRegistry: https:\/\/index.docker.io\/v1\/\r\nExperimental: true\r\nInsecure Registries:\r\n 127.0.0.0\/8\r\nLive Restore Enabled: false<\/pre>\n
      Este cluster tiene 1 nodo, y ese es el manager. Alternativamente, un cluster multi-host puede ser f\u00e1cilmente configurado usando Docker para AWS<\/a>.<\/p>\n
      Despliegue de microservicios<\/h2>\n
      El microservicio se puede iniciar como:<\/p>\n
      \r\ndocker stack deploy --compose-file=docker-compose.yml webapp<\/pre>\n
      Esto muestra la salida:<\/p><\/div>\n
      \r\nCreating network webapp_default\r\nCreating service webapp_web\r\nCreating service webapp_db<\/pre>\n
      Los servicios WildFly y Couchbase se inician en este nodo. Cada servicio tiene un \u00fanico contenedor. Si el modo Enjambre est\u00e1 habilitado en varios nodos, los contenedores se distribuir\u00e1n entre varios nodos.<\/div>\n
      Se crea una nueva red superpuesta. Esto permite que varios contenedores en diferentes hosts se comuniquen entre s\u00ed.<\/div>\n
      Compruebe que los servicios WildFly y Couchbase se est\u00e1n ejecutando mediante docker service ls<\/code>:<\/p>\n
      \r\nID            NAME        MODE        REPLICAS  IMAGE\r\na9pkiziw3vgw  webapp_db   replicated  1\/1       arungupta\/couchbase:travel\r\nhr5s6ue54kwj  webapp_web  replicated  1\/1       arungupta\/couchbase-javaee:travel<\/pre>\n
      Los registros del servicio pueden consultarse mediante docker service logs -f webapp_web<\/code>:<\/div>\n
      \n
      \r\nwebapp_web.1.wby0b04t7bap@moby    | =========================================================================\r\nwebapp_web.1.wby0b04t7bap@moby    |\r\nwebapp_web.1.wby0b04t7bap@moby    |   JBoss Bootstrap Environment\r\nwebapp_web.1.wby0b04t7bap@moby    |\r\nwebapp_web.1.wby0b04t7bap@moby    |   JBOSS_HOME: \/opt\/jboss\/wildfly\r\nwebapp_web.1.wby0b04t7bap@moby    |\r\nwebapp_web.1.wby0b04t7bap@moby    |   JAVA: \/usr\/lib\/jvm\/java\/bin\/java\r\nwebapp_web.1.wby0b04t7bap@moby    |\r\nwebapp_web.1.wby0b04t7bap@moby    |   JAVA_OPTS:  -server -Xms64m -Xmx512m -XX:MetaspaceSize=96M -XX:MaxMetaspaceSize=256m -Djava.net.preferIPv4Stack=true -Djboss.modules.system.pkgs=org.jboss.byteman -Djava.awt.headless=true\r\nwebapp_web.1.wby0b04t7bap@moby    |\r\nwebapp_web.1.wby0b04t7bap@moby    | =========================================================================\r\n\r\n. . .\r\n\r\nwebapp_web.1.wby0b04t7bap@moby    | 23:14:15,811 INFO  [org.jboss.as.server] (ServerService Thread Pool -- 34) WFLYSRV0010: Deployed \"airlines.war\" (runtime-name : \"airlines.war\")\r\nwebapp_web.1.wby0b04t7bap@moby    | 23:14:16,076 INFO  [org.jboss.as] (Controller Boot Thread) WFLYSRV0060: Http management interface listening on https:\/\/127.0.0.1:9990\/management\r\nwebapp_web.1.wby0b04t7bap@moby    | 23:14:16,077 INFO  [org.jboss.as] (Controller Boot Thread) WFLYSRV0051: Admin console listening on https:\/\/127.0.0.1:9990\r\nwebapp_web.1.wby0b04t7bap@moby    | 23:14:16,077 INFO  [org.jboss.as] (Controller Boot Thread) WFLYSRV0025: WildFly Full 10.1.0.Final (WildFly Core 2.2.0.Final) started in 98623ms - Started 443 of 691 services (404 services are lazy, passive or on-demand)<\/pre>\n
      Aseg\u00farese de esperar a que aparezca la \u00faltima declaraci\u00f3n de registro.<\/p><\/div>\n
      Microservicio de acceso<\/h2>\n
      Obtener 10 aerol\u00edneas del microservicio:<\/p>\n
      \r\ncurl -v https:\/\/localhost:8080\/airlines\/resources\/airline<\/pre>\n
      Esto muestra los resultados como:<\/p>\n
      \r\n*   Trying ::1...\r\n* Connected to localhost (::1) port 8080 (#0)\r\n> GET \/airlines\/resources\/airline HTTP\/1.1\r\n> Host: localhost:8080\r\n> User-Agent: curl\/7.43.0\r\n> Accept: *\/*\r\n> \r\n< HTTP\/1.1 200 OK\r\n< Connection: keep-alive\r\n< X-Powered-By: Undertow\/1\r\n< Server: WildFly\/10\r\n< Content-Type: application\/octet-stream\r\n< Content-Length: 1402\r\n< Date: Fri, 03 Feb 2017 17:02:45 GMT\r\n< \r\n* Connection #0 to host localhost left intact\r\n[{"travel-sample":{"country":"United States","iata":"Q5","callsign":"MILE-AIR","name":"40-Mile Air","icao":"MLA","id":10,"type":"airline"}}, {"travel-sample":{"country":"United States","iata":"TQ","callsign":"TXW","name":"Texas Wings","icao":"TXW","id":10123,"type":"airline"}}, {"travel-sample":{"country":"United States","iata":"A1","callsign":"atifly","name":"Atifly","icao":"A1F","id":10226,"type":"airline"}}, {"travel-sample":{"country":"United Kingdom","iata":null,"callsign":null,"name":"Jc royal.britannica","icao":"JRB","id":10642,"type":"airline"}}, {"travel-sample":{"country":"United States","iata":"ZQ","callsign":"LOCAIR","name":"Locair","icao":"LOC","id":10748,"type":"airline"}}, {"travel-sample":{"country":"United States","iata":"K5","callsign":"SASQUATCH","name":"SeaPort Airlines","icao":"SQH","id":10765,"type":"airline"}}, {"travel-sample":{"country":"United States","iata":"KO","callsign":"ACE AIR","name":"Alaska Central Express","icao":"AER","id":109,"type":"airline"}}, {"travel-sample":{"country":"United Kingdom","iata":"5W","callsign":"FLYSTAR","name":"Astraeus","icao":"AEU","id":112,"type":"airline"}}, {"travel-sample":{"country":"France","iata":"UU","callsign":"REUNION","name":"Air Austral","icao":"REU","id":1191,"type":"airline"}}, {"travel-sample":{"country":"France","iata":"A5","callsign":"AIRLINAIR","name":"Airlinair","icao":"RLA","id":1203,"type":"airline"}}]<\/pre>\n
      Taller sobre Docker para desarrolladores Java<\/a> es un laboratorio pr\u00e1ctico a su propio ritmo y le permite iniciarse en Docker f\u00e1cilmente. Consigue un \u00fanico recurso:<\/p>\n
      \r\ncurl -v https:\/\/localhost:8080\/airlines\/resources\/airline\/137<\/pre>\n
      Crea un nuevo recurso:<\/p>\n
      \r\ncurl -v -H \"Content-Type: application\/json\" -X POST -d '{\"country\":\"France\",\"iata\":\"A5\",\"callsign\":\"AIRLINAIR\",\"name\":\"Airlinair\",\"icao\":\"RLA\",\"type\":\"airline\"}' https:\/\/localhost:8080\/airlines\/resources\/airline<\/pre>\n
      Actualizar un recurso:<\/p>\n
      \r\ncurl -v -H \"Content-Type: application\/json\" -X PUT -d '{\"country\":\"France\",\"iata\":\"A5\",\"callsign\":\"AIRLINAIR\",\"name\":\"Airlin Air\",\"icao\":\"RLA\",\"type\":\"airline\",\"id\": \"19810\"}' https:\/\/localhost:8080\/airlines\/resources\/airline\/19810\r\n<\/pre>\n
      Borrar un recurso:<\/p>\n
      \r\ncurl -v -X DELETE https:\/\/localhost:8080\/airlines\/resources\/airline\/19810<\/pre>\n
      Los resultados detallados de cada uno de estos comandos se encuentran en\u00a0github.com\/arun-gupta\/couchbase-javaee<\/a>.<\/p>\n
      Eliminar microservicio<\/h2>\n
      El microservicio puede eliminarse mediante el comando\u00a0docker stack rm webapp<\/code>:<\/span><\/p>\n
      \r\nRemoving service webapp_web\r\nRemoving service webapp_db\r\nRemoving network webapp_default<\/pre>\n
      \u00bfQuieres empezar a usar Couchbase? Mira en Kits de inicio de Couchbase<\/a>. \u00bfQuieres saber m\u00e1s sobre c\u00f3mo ejecutar Couchbase en contenedores?<\/p>\n