Instalación de Docker

Abrir en ChatGPT

Esta sección de la documentación cubrirá los pasos necesarios para los usuarios que deseen desarrollar utilizando Docker. Los cambios en tu código se realizarán en tu máquina de desarrollo, y la aplicación resultante se ejecutará en Docker.

1. Descargando Docker

El proceso de instalación de Docker variará ligeramente entre usuarios de Windows, Mac y Linux. Consulta la sección a continuación que corresponde a tu sistema operativo.

Windows

info

Se recomienda descargar la versión más reciente de Windows Subsystem for Linux. Más información se puede encontrar en este enlace

1. Descarga Docker Desktop:

• Visita la página de descarga de Docker Desktop para Windows: Docker Desktop para Windows
• Haz clic en el botón "Obtener Docker Desktop para Windows" para descargar el instalador.

2. Instala Docker Desktop:

• Ejecuta el instalador que descargaste.
• Sigue el asistente de instalación y asegúrate de habilitar Hyper-V (si se solicita) ya que Docker para Windows utiliza Hyper-V para la virtualización.
• Una vez completada la instalación, Docker Desktop se iniciará automáticamente.

3. Verifica la instalación:

• Abre una terminal y ejecuta el comando docker --version para verificar que Docker está instalado y funcionando correctamente.

Mac

1. Descarga Docker Desktop:

• Visita la página de descarga de Docker Desktop para Mac: Docker Desktop para Mac

2. Instala Docker Desktop:

• Ejecuta el instalador que descargaste.
• Una vez completada la instalación, Docker Desktop se iniciará automáticamente.

3. Verifica la instalación:

• Abre una terminal y ejecuta el comando docker --version para verificar que Docker está instalado y funcionando correctamente.

2. Configuración

Una vez que Docker Desktop ha sido descargado, busca la imagen más reciente de webforJ, que actualmente tiene el nombre webforj/sandbox.

Haz clic en la lista de etiquetas para ver las opciones disponibles.

Para la última compilación, selecciona "rc".

Obtén la imagen para iniciar tu contenedor.

Una vez que la descarga esté completa, haz clic en el botón de ejecutar, que abrirá la configuración.

Abre el menú "Configuraciones opcionales".

Selecciona un puerto de host deseado donde podrás ver tu aplicación en ejecución dentro de Docker.

Haz clic en "Ejecutar" para iniciar el contenedor.

Importante

Asegúrate de tomar nota del número de puerto de host personalizado que proporcionas, ya que será necesario más adelante.

3. Ejecutando tu aplicación

Una vez que el contenedor ha sido creado, las aplicaciones de webforJ se pueden ejecutar dentro del contenedor en lugar de localmente. Primero, es necesario configurar correctamente el archivo POM de tu proyecto. Una vez hecho esto, ir a una URL específica en el navegador mostrará la aplicación.

Configurando tu archivo POM

Ejecutar un proyecto de webforJ en el contenedor de Docker requerirá el uso del Plugin de Instalación de webforJ, que se puede configurar utilizando tu archivo POM:

Crea una nueva entrada <plugin> en la sección <plugins> del POM. El siguiente código muestra una entrada de inicio que se puede usar y ajustar según sea necesario para tu proyecto:

important

Si tu archivo POM no tiene una sección <plugins>, crea una.

<plugin>
<groupId>com.webforj</groupId>
<artifactId>webforj-install-maven-plugin</artifactId>
<version>${webforj.version}</version>
<executions>
  <execution>
  <goals>
    <goal>install</goal>
  </goals>
  </execution>
</executions>
<configuration>
  <deployurl>http://localhost:8888/webforj-install</deployurl>
  <classname>samples.HelloWorldApp</classname>
  <publishname>hello-world</publishname>
  <debug>true</debug>
</configuration>
</plugin>

Una vez que se haya creado una entrada similar a la anterior, personaliza la siguiente información:

• Cambia la entrada <deployurl> para que use el número de puerto que coincida con el Host port que configuraste para tu contenedor en el paso anterior.

• Asegúrate de que la entrada <classname> coincida con el nombre de la aplicación que deseas ejecutar.

• Si tus credenciales <username> y <password> son diferentes para tu instalación de BBj, cámbialas.

Usando el proyecto inicial

Para crear y estructurar un nuevo proyecto bbj-hello-world, sigue estos pasos:

1. Navegar al directorio adecuado: Abre una terminal y muévete a la carpeta donde deseas crear tu nuevo proyecto.
2. Ejecutar el comando archetype:generate: Utiliza el comando Maven a continuación y personaliza el groupId, artifactId y versión según sea necesario para tu proyecto.

Bash/Zsh

mvn -B archetype:generate \
-DarchetypeGroupId=com.webforj \
-DarchetypeArtifactId=webforj-archetype-bbj-hello-world \
-DarchetypeVersion=LATEST \
-DgroupId=org.example \
-DartifactId=my-app \
-Dversion=1.0-SNAPSHOT \
-DappName=MyApp

PowerShell

mvn -B archetype:generate `
-DarchetypeGroupId="com.webforj" `
-DarchetypeArtifactId="webforj-archetype-bbj-hello-world" `
-DarchetypeVersion="LATEST" `
-DgroupId="org.example" `
-DartifactId="my-app" `
-Dversion="1.0-SNAPSHOT" `
-DappName="MyApp"

Command Prompt

mvn -B archetype:generate ^
-DarchetypeGroupId="com.webforj" ^
-DarchetypeArtifactId="webforj-archetype-bbj-hello-world" ^
-DarchetypeVersion="LATEST" ^
-DgroupId="org.example" ^
-DartifactId="my-app" ^
-Dversion="1.0-SNAPSHOT" ^
-DappName="MyApp"

Argumento	Explicación
archetypeGroupId	El ID del grupo del arquetipo es com.webforj para los arquetipos de webforJ.
archetypeArtifactId	Especifica el nombre del arquetipo a usar.
archetypeVersion	Especifica la versión del arquetipo a utilizar. Esto asegura que el proyecto generado sea compatible con una versión específica del arquetipo. Usar LATEST selecciona la versión más reciente disponible.
groupId	Representa el espacio de nombres para el proyecto generado. Típicamente estructurado como un paquete de Java, como org.example, y se utiliza para identificar de manera única su organización o dominio del proyecto.
artifactId	Especifica el nombre del proyecto generado. Este será el nombre del artefacto resultante y la carpeta del proyecto.
version	Define la versión del proyecto generado. Una convención común es MAYOR.MENOR-SNAPSHOT, como 1.0-SNAPSHOT, donde SNAPSHOT indica que el proyecto aún está en desarrollo.
appName	Un parámetro opcional que se puede usar en el archivo POM del proyecto generado. Dependiendo del arquetipo webforJ utilizado, se puede utilizar como título predeterminado para la aplicación.

Después de ejecutar el comando, Maven generará los archivos del proyecto necesarios para ejecutar el proyecto.

Lanzando la aplicación

Una vez hecho esto, ejecuta un mvn install en el directorio de tu proyecto. Esto ejecutará el plugin de instalación de webforJ y te permitirá acceder a tu aplicación. Para ver la aplicación, querrás ir a la siguiente URL:

http://localhost:YourHostPort/webapp/YourPublishName

Reemplaza YourHostPort con el puerto de host que configuraste con Docker, y YourPublishName se reemplaza por el texto dentro de la etiqueta <publishname> del POM. Si se hizo correctamente, deberías ver renderizada tu aplicación.