From 29af4a54380cca003ed49e63bc416c6e1b7e93a2 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Carlos=20Alberto=20=20Arg=C3=BCello=20Ram=C3=ADrez?= Date: Mon, 21 Jul 2025 01:28:55 +0000 Subject: [PATCH 1/2] update: devcontainer for use Docker in Docker --- .devcontainer/devcontainer.json | 11 +++---- docs/RUNNING.md | 53 +++++++++++++++++++++++++++++++++ 2 files changed, 59 insertions(+), 5 deletions(-) create mode 100644 docs/RUNNING.md diff --git a/.devcontainer/devcontainer.json b/.devcontainer/devcontainer.json index 9c6b93e..6388802 100644 --- a/.devcontainer/devcontainer.json +++ b/.devcontainer/devcontainer.json @@ -1,6 +1,6 @@ { "name": "Ubuntu DevContainer", - "image": "ubuntu:24.04", + "image": "ubuntu:24.04-minimal", "customizations": { "jetbrains": { @@ -26,17 +26,18 @@ "features": { "ghcr.io/devcontainers/features/git": {}, - "ghcr.io/devcontainers/features/common-utils": {}, - "ghcr.io/devcontainers/features/java:1": { + "ghcr.io/devcontainers/features/common-utils": {}, + "ghcr.io/devcontainers/features/java:1": { "version": "21", "jdkDistro": "amzn", "gradleVersion": "latest" - } + }, + "ghcr.io/devcontainers/features/docker-in-docker:2": {} }, "remoteUser": "ubuntu", - "forwardPorts": [3000, 8000], + "forwardPorts": [3000, 8000, 8080], "postCreateCommand": "sdk version" } diff --git a/docs/RUNNING.md b/docs/RUNNING.md new file mode 100644 index 0000000..bc66487 --- /dev/null +++ b/docs/RUNNING.md @@ -0,0 +1,53 @@ +# Cómo lanzar la aplicación OpenArc + +## 1. Lanzar la app usando Docker (desde el devcontainer) + +Asegúrate de estar en el devcontainer y que Docker esté disponible (Docker-in-Docker). Ejecuta: + +```bash +# Construye la imagen Docker desde la carpeta deployment +cd /workspaces/open-arc + +docker build -t openarc-app deployment/ + +# Lanza el contenedor exponiendo el puerto 8080 + +docker run -p 8080:8080 openarc-app +``` + +## 2. Lanzar la app directamente con Gradle + +Si prefieres no usar Docker, puedes lanzar la app usando Gradle: + +```bash +cd /workspaces/open-arc/applications/app-service +./gradlew bootRun +``` + +## 3. Acceder al único endpoint disponible + +Una vez la app esté corriendo (por Docker o Java), accede al endpoint desde tu navegador o con `curl`: + +``` +http://localhost:8080/api/usecase/path +``` + +Ejemplo usando curl: + +```bash +curl http://localhost:8080/api/usecase/path +``` + +La respuesta esperada es: + +``` +Open Arc Rocks!!! +``` + +--- + +Para abrir la URL en el navegador del host desde el devcontainer, puedes usar: + +```bash +"$BROWSER" http://localhost:8080/api/usecase/path +``` From daeda2084f4ec14e1726c2d0093de9513036a216 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Carlos=20Alberto=20=20Arg=C3=BCello=20Ram=C3=ADrez?= Date: Mon, 21 Jul 2025 01:29:30 +0000 Subject: [PATCH 2/2] update: docs --- docs/RUNNING.md | 7 +------ 1 file changed, 1 insertion(+), 6 deletions(-) diff --git a/docs/RUNNING.md b/docs/RUNNING.md index bc66487..371fba1 100644 --- a/docs/RUNNING.md +++ b/docs/RUNNING.md @@ -5,13 +5,8 @@ Asegúrate de estar en el devcontainer y que Docker esté disponible (Docker-in-Docker). Ejecuta: ```bash -# Construye la imagen Docker desde la carpeta deployment cd /workspaces/open-arc - docker build -t openarc-app deployment/ - -# Lanza el contenedor exponiendo el puerto 8080 - docker run -p 8080:8080 openarc-app ``` @@ -24,7 +19,7 @@ cd /workspaces/open-arc/applications/app-service ./gradlew bootRun ``` -## 3. Acceder al único endpoint disponible +## 3. Acceder al endpoint de ejemplo Una vez la app esté corriendo (por Docker o Java), accede al endpoint desde tu navegador o con `curl`: