Docker installatie

Openen in ChatGPT

Dit gedeelte van de documentatie behandelt de stappen die vereist zijn voor gebruikers die willen ontwikkelen met Docker. Wijzigingen aan uw code worden aangebracht op uw ontwikkelingsmachine, en de resulterende app wordt uitgevoerd in Docker.

1. Docker downloaden

Het installatieproces voor Docker verschilt licht tussen Windows-, Mac- en Linux-gebruikers. Zie het onderstaande gedeelte dat overeenkomt met uw besturingssysteem.

Windows

info

Het wordt aanbevolen de nieuwste versie van Windows Subsystem for Linux te downloaden. Meer informatie vindt u op deze link

1. Download Docker Desktop:

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

2. Installeer Docker Desktop:

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

3. Verifieer de installatie:

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

Mac

1. Download Docker Desktop:

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

2. Installeer Docker Desktop:

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

3. Verifieer de installatie:

• 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, zoek naar de nieuwste webforJ afbeelding, die momenteel onder de naam webforj/sandbox staat.

Klik op de lijst met tags om de beschikbare opties te zien.

Kies voor de meest recente build "rc".

Haal de afbeelding op om uw container te starten.

Zodra de download is voltooid, klikt u op de knop uitvoeren, 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 hostpoortnummer dat u opgeeft, noteert, aangezien dit later nodig zal zijn.

3. Uw app uitvoeren

Zodra de container is aangemaakt, kunnen webforJ-applicaties binnen de container worden uitgevoerd in plaats van lokaal. Eerst is het noodzakelijk om het POM-bestand van uw project correct te configureren. Zodra dit is gedaan, zal het bezoeken van een specifieke URL in de browser de app weergeven.

Configureren van uw POM-bestand

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

Maak een nieuwe <plugin>-vermelding in de <plugins>-sectie van de POM. De volgende code toont een startvermelding die kan worden gebruikt en verder kan worden aangepast naar behoefte voor uw project:

important

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

<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 vermelding vergelijkbaar met de bovenstaande is gemaakt, past u de volgende informatie aan:

• Verander de <deployurl>-vermelding naar het poortnummer dat overeenkomt met de Host port die u voor uw container hebt geconfigureerd in de vorige stap.

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

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

Gebruik maken van het starterproject

Om een nieuw bbj-hello-world project te creëren en te scaffolden, volg deze stappen:

1. Navigeer naar de juiste map: Open een terminal en ga naar de map waar je je nieuwe project wilt maken.
2. Voer het archetype:generate commando uit: Gebruik de onderstaande Maven-opdracht en pas groupId, artifactId en versie aan zoals nodig voor jouw 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"

Argumenten	Uitleg
archetypeGroupId	De groeps-ID van de archetype is com.webforj voor webforJ archetypes.
archetypeArtifactId	Geeft de naam van het te gebruiken archetype op.
archetypeVersion	Geeft de versie van de archetype op die gebruikt moet worden. Dit zorgt ervoor dat het gegenereerde project compatibel is met een specifieke versie van de archetype. Het gebruik van LATEST selecteert de meest recente beschikbare versie.
groupId	Geeft de naamruimte voor het gegenereerde project weer. Typisch gestructureerd als een Java-pakket, zoals org.example, en wordt gebruikt om uw organisatie of projectdomein uniek te identificeren.
artifactId	Geeft de naam op van het gegenereerde project. Dit zal de naam zijn van het resulterende artifact en de projectmap.
version	Definieert de versie van het gegenereerde project. Een gangbare conventie is MAJOR.MINOR-SNAPSHOT, zoals 1.0-SNAPSHOT, waarbij SNAPSHOT aangeeft dat het project nog in ontwikkeling is.
appName	Een optionele parameter die kan worden gebruikt in het POM-bestand van het gegenereerde project. Afhankelijk van de gebruikte webforJ-archetype kan het worden gebruikt als een standaardtitel voor de applicatie.

Na het uitvoeren van de opdracht genereert Maven de projectbestanden die nodig zijn om het project uit te voeren.

De app lanceren

Zodra dit is gedaan, voert u een mvn install uit in uw projectmap. Dit zal de webforJ install-plugin uitvoeren en u in staat stellen uw app te openen. Om de app te zien, wilt u naar de volgende URL gaan:

http://localhost:YourHostPort/webapp/YourPublishName

Vervang YourHostPort door de Host-port die u met Docker hebt geconfigureerd, en YourPublishName wordt vervangen door de tekst binnen de <publishname>-tag van de POM. Als dit correct is gedaan, zou u uw app moeten zien renderen.