Docker-installatie

Open in ChatGPT

Deze sectie van de documentatie behandelt de stappen die nodig zijn voor gebruikers die met Docker willen ontwikkelen. Wijzigingen aan uw code worden gemaakt op uw ontwikkelingsmachine en de resulterende app zal worden uitgevoerd in Docker.

1. Docker downloaden

Het installatieproces voor Docker verschilt iets tussen Windows-, Mac- en Linux-gebruikers. Bekijk de onderstaande sectie die overeenkomt met uw besturingssysteem.

Windows

informatie

Het wordt aanbevolen om de nieuwste versie van Windows Subsystem for Linux te downloaden. Meer informatie is te vinden op deze link

1. Docker Desktop downloaden:

• Bezoek de downloadpagina voor Docker Desktop voor Windows: Docker Desktop voor Windows
• Klik op de knop "Docker Desktop voor Windows krijgen" om de installer te downloaden.

2. Docker Desktop installeren:

• Voer de gedownloade installer uit.
• Volg de installatiewizard en zorg ervoor dat Hyper-V is ingeschakeld (indien gevraagd), aangezien Docker voor Windows Hyper-V gebruikt voor virtualisatie.
• Zodra de installatie is voltooid, wordt Docker Desktop automatisch gestart.

3. Installatie verifiëren:

• Open een terminal en voer de opdracht docker --version uit om te verifiëren dat Docker correct is geïnstalleerd en werkt.

Mac

1. Docker Desktop downloaden:

• Bezoek de downloadpagina voor Docker Desktop voor Mac: Docker Desktop voor Mac

2. Docker Desktop installeren:

• Voer de gedownloade installer uit.
• Zodra de installatie is voltooid, wordt Docker Desktop automatisch gestart.

3. Installatie verifiëren:

• Open een terminal en voer de opdracht docker --version uit om te verifiëren dat Docker correct is geïnstalleerd en werkt.

2. Configuratie

Zodra Docker Desktop is gedownload, zoekt u naar de nieuwste webforJ-image, die momenteel onder de naam webforj/sandbox valt.

Klik op de lijst met tags om de beschikbare opties te bekijken

Voor de meest recente build, selecteer "rc"

Haal de image op om uw container te starten

Zodra de download is voltooid, klikt u op de startknop, waarmee de configuratie-instellingen worden geopend

Open het menu "Optionele instellingen"

Selecteer een gewenste hostpoort waar u uw app binnen Docker kunt zien draaien

Klik op "Uitvoeren" om de container te starten

Belangrijk

Zorg ervoor dat u het aangepaste Host-poortnummer dat u opgeeft, noteert, aangezien dit later nodig zal zijn.

3. Uw app uitvoeren

Zodra de container is gemaakt, kunnen webforJ-applicaties binnen de container worden uitgevoerd in plaats van lokaal. Eerst is het nodig om het POM-bestand van uw project correct te configureren. Zodra dit is gedaan, zal naar een specifieke URL in de browser gaan de app tonen.

Configureren van uw POM-bestand

Het draaien van een webforJ-project in de Docker-container vereist het gebruik van de webforJ Install Plugin, die kan worden geconfigureerd via uw POM-bestand:

Maak een nieuwe <plugin>-invoer in de sectie <plugins> van de POM. De volgende code toont een startinvoer die kan worden gebruikt en aangepast zoals nodig voor uw project:

important

Als uw POM-bestand geen <plugins>-sectie heeft, creëer er dan een.

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

Zodra een invoer vergelijkbaar met de bovenstaande is gemaakt, kunt u de volgende informatie aanpassen:

• Wijzig de invoer <deployurl> zodat deze het poortnummer gebruikt dat overeenkomt met de Host-port die u in de vorige stap voor uw container hebt geconfigureerd.

• Zorg ervoor dat de invoer <classname> overeenkomt met de naam van de app die u wilt uitvoeren.

• Als uw <username> en <password> inloggegevens verschillen voor uw installatie van BBj, wijzig deze dan.

Gebruik maken van het starterproject

Om een nieuw bbj-hello-world project te maken en op te zetten, volg deze stappen:

1. Navigeer naar de juiste directory: Open een terminal en ga naar de map waar u uw nieuwe project wilt maken.
2. Voer het archetype:generate commando uit: Gebruik het Maven commando hieronder en pas groupId, artifactId en version aan naar behoefte voor uw project.

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	Uitleg
archetypeGroupId	De groep ID van het archetype is com.webforj voor webforJ archetypes.
archetypeArtifactId	Specificeert de naam van het te gebruiken archetype.
archetypeVersion	Specificeert de versie van het te gebruiken archetype. Dit zorgt ervoor dat het gegenereerde project compatibel is met een specifieke archetype versie. LATEST selecteert de meest recente beschikbare versie.
groupId	Namespace voor het project.
artifactId	Specificeert de naam van het gegenereerde project. Dit wordt de naam van het resulterende artefact en de projectmap.
version	Definieer projectversie: MAJOR.MINOR-SNAPSHOT, bijv. 1.0-SNAPSHOT
appName	Optionele parameter voor het POM-bestand; kan dienen als standaardtitel voor de applicatie, afhankelijk van het gebruikte webforJ-archetype.

Na het uitvoeren van het commando zal Maven de benodigde projectbestanden genereren om het project uit te voeren.

De app starten

Zodra dit gedaan is, voert u een mvn install uit in uw projectdirectory. Dit zal de webforJ-installatieplugin uitvoeren en u in staat stellen om toegang te krijgen tot uw app. Om de app te zien, gaat u naar de volgende URL:

http://localhost:YourHostPort/webapp/YourPublishName

Vervang YourHostPort door de Host-poort die u met Docker hebt geconfigureerd, en YourPublishName wordt vervangen door de tekst in de <publishname>-tag van de POM. Als alles correct is gedaan, zou u uw app moeten kunnen weergeven.