Docker-Installation

ChatGPT öffnen

Dieser Abschnitt der Dokumentation behandelt die Schritte, die erforderlich sind, um mit Docker zu entwickeln. Änderungen an Ihrem Code werden auf Ihrem Entwicklungsrechner vorgenommen, und die resultierende Anwendung wird in Docker ausgeführt.

1. Docker herunterladen

Der Installationsprozess für Docker variiert leicht zwischen Windows-, Mac- und Linux-Benutzern. Siehe den untenstehenden Abschnitt, der Ihrem Betriebssystem entspricht.

Windows

Info

Es wird empfohlen, die neueste Version des Windows Subsystem für Linux herunterzuladen. Weitere Informationen finden Sie unter diesem Link

1. Docker Desktop herunterladen:

• Besuchen Sie die Download-Seite für Docker Desktop für Windows: Docker Desktop für Windows
• Klicken Sie auf die Schaltfläche "Docker Desktop für Windows herunterladen", um den Installer herunterzuladen.

2. Docker Desktop installieren:

• Führen Sie den heruntergeladenen Installer aus.
• Folgen Sie dem Installationsassistenten und stellen Sie sicher, dass Sie Hyper-V aktivieren (falls aufgefordert), da Docker für Windows Hyper-V für die Virtualisierung verwendet.
• Nach Abschluss der Installation wird Docker Desktop automatisch gestartet.

3. Installation überprüfen:

• Öffnen Sie ein Terminal und führen Sie den Befehl docker --version aus, um zu überprüfen, ob Docker installiert und korrekt funktioniert.

Mac

1. Docker Desktop herunterladen:

• Besuchen Sie die Download-Seite für Docker Desktop für Mac: Docker Desktop für Mac

2. Docker Desktop installieren:

• Führen Sie den heruntergeladenen Installer aus.
• Nach Abschluss der Installation wird Docker Desktop automatisch gestartet.

3. Installation überprüfen:

• Öffnen Sie ein Terminal und führen Sie den Befehl docker --version aus, um zu überprüfen, ob Docker installiert und korrekt funktioniert.

2. Konfiguration

Nachdem Docker Desktop heruntergeladen wurde, suchen Sie nach dem neuesten webforJ-Image, das derzeit unter dem Namen webforj/sandbox geführt wird.

Klicken Sie auf die Liste der Tags, um die verfügbaren Optionen zu sehen

Wählen Sie für den aktuellsten Build "rc"

Ziehen Sie das Image, um Ihren Container zu starten

Sobald der Download abgeschlossen ist, klicken Sie auf die Schaltfläche "Ausführen", um die Konfigurationseinstellungen zu öffnen

Öffnen Sie das Menü "Optionale Einstellungen"

Wählen Sie einen gewünschten Host-Port, unter dem Sie Ihre Anwendung in Docker sehen können

Klicken Sie auf "Ausführen", um den Container zu starten

Wichtig

Stellen Sie sicher, dass Sie sich an die angegebene Hostportnummer erinnern, da Sie diese später benötigen.

3. Ihre App ausführen

Sobald der Container erstellt wurde, können webforJ-Anwendungen innerhalb des Containers anstelle von lokal ausgeführt werden. Zunächst ist es notwendig, die POM-Datei Ihres Projekts korrekt zu konfigurieren. Nachdem dies geschehen ist, wird das Aufrufen einer bestimmten URL im Browser die App anzeigen.

Konfigurieren Ihrer POM-Datei

Das Ausführen eines webforJ-Projekts im Docker-Container erfordert die Verwendung des webforJ Install-Plugins, das über Ihre POM-Datei konfiguriert werden kann:

Erstellen Sie einen neuen <plugin>-Eintrag im <plugins>-Bereich der POM. Der folgende Code zeigt einen Startbeitrag, der verwendet und nach Bedarf für Ihr Projekt angepasst werden kann:

important

Wenn Ihre POM-Datei keinen Abschnitt <plugins> enthält, erstellen Sie einen.

<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>

Nachdem ein ähnlicher Eintrag wie der oben dargestellte erstellt wurde, passen Sie die folgenden Informationen an:

• Ändern Sie den <deployurl>-Eintrag, um die Portnummer zu verwenden, die mit dem Host-Port übereinstimmt, den Sie für Ihren Container im vorherigen Schritt konfiguriert haben.

• Stellen Sie sicher, dass der <classname>-Eintrag dem Namen der Anwendung entspricht, die Sie ausführen möchten.

• Wenn Ihre <username>- und <password>-Anmeldeinformationen für Ihre Installation von BBj unterschiedlich sind, ändern Sie diese.

Verwendung des Starterprojekts

Um ein neues bbj-hello-world-Projekt zu erstellen und zu strukturieren, folgen Sie diesen Schritten:

1. Zum richtigen Verzeichnis navigieren: Öffnen Sie ein Terminal und navigieren Sie zum Ordner für Ihr neues Projekt.
2. Den archetype:generate Befehl ausführen: Maven-Befehl verwenden und groupId, artifactId und Version anpassen.

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"

Argument	Erklärung
archetypeGroupId	Die Gruppen-ID des Archetyps ist com.webforJ.
archetypeArtifactId	Gibt den Namen des zu verwendenden Archetypes an.
archetypeVersion	Gibt die Version des zu verwendenden Archetypes an. Dies stellt sicher, dass das generierte Projekt mit einer bestimmten Archetype-Version kompatibel ist. LATEST wählt die neueste verfügbare Version.
groupId	Repräsentiert den Namespace für das generierte Projekt. Typischerweise wie ein Java-Paket strukturiert, z.B. org.example, und wird verwendet, um Ihre Organisation oder Projektdomäne eindeutig zu identifizieren.
artifactId	Gibt den Namen des generierten Projekts an. Dies wird der Name des resultierenden Artefakts und des Projektordners sein.
version	Versionsnummer festlegen. Gängige Konvention: MAJOR.MINOR-SNAPSHOT, z. B. 1.0-SNAPSHOT.
appName	Optionaler POM-Parameter für Standardtitel.

Maven generiert nach Ausführung des Befehls die notwendigen Projektdateien.

Starten der App

Sobald dies erledigt ist, führen Sie in Ihrem Projektverzeichnis mvn install aus. Dies wird das webforJ Install-Plugin ausführen und es Ihnen ermöglichen, auf Ihre App zuzugreifen. Um die App zu sehen, gehen Sie zu folgender URL:

http://localhost:YourHostPort/webapp/YourPublishName

Ersetzen Sie YourHostPort durch den Host-Port, den Sie mit Docker konfiguriert haben, und YourPublishName wird durch den Text im <publishname>-Tag der POM ersetzt. Wenn alles korrekt gemacht wurde, sollten Sie Ihre App sehen können.