Docker-installatie

Openen in ChatGPT

Verwijderd en zal worden verwijderd

De Docker-installatie met de webforj/sandbox afbeelding is verouderd en zal in een toekomstige release worden verwijderd. Begin geen nieuwe projecten hiermee. Verplaatsen bestaande projecten naar BBjShip, dat webforJ-apps in BBjServices installeert, implementeert en uitvoert. Bestaande projecten vermeldt de wijzigingen die een project nodig heeft.

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

1. Docker downloaden

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

Windows

info

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

1. Download Docker Desktop:

• Bezoek de download pagina voor Docker Desktop voor Windows: Docker Desktop voor Windows
• Klik op de knop "Get Docker Desktop for Windows" om de installer te downloaden.

2. Installeer Docker Desktop:

• Voer de gedownloade installer uit.
• Volg de installatieassistent en zorg ervoor dat Hyper-V is ingeschakeld (als daarom wordt 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 download pagina 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 bekijken

Voor de recentste build, selecteer "rc"

Haal de afbeelding op om uw container te starten

Zodra de download is voltooid, klikt u op de knop 'Run', waarmee de configuratie-instellingen worden geopend

Open het menu "Optionele instellingen"

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

Klik op "Run" 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 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.

Uw POM-bestand configureren

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

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

important

Als uw POM-bestand geen <plugins>-sectie heeft, maak er dan één 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 invoer vergelijkbaar met de bovenstaande is aangemaakt, pas dan de volgende informatie aan:

• Verander de <deployurl>-invoer om het poortnummer te gebruiken dat u overeen laat komen met de Host poort die u heeft geconfigureerd voor uw container in de vorige stap.

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

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

Het starterproject gebruiken

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 starten

Nadat dit is gedaan, voert u een mvn install uit in uw projectdirectory. Dit zal de webforJ-installatieplugin uitvoeren en u toegang geven 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 heeft geconfigureerd, en YourPublishName door de tekst binnen de <publishname>-tag van de POM. Als dit correct is gedaan, zou u uw app moeten zien renderen.