Dockerin asennus

Avaa ChatGPT:ssä

Tässä asiakirjan osassa käsitellään vaiheita, jotka käyttäjien tulee käydä läpi, jos he haluavat kehittää käyttäen Dockeria. Muutokset koodissasi tehdään kehityskoneellasi, ja tuloksena oleva sovellus suoritetaan Dockerissa.

1. Dockerin lataaminen

Dockerin asennusprosessi vaihtelee hieman Windows-, Mac- ja Linux-käyttäjien välillä. Katso alla oleva osio, joka vastaa käyttöjärjestelmääsi.

Windows

tiedot

Suosittelemme lataamaan Windows Subsystem for Linuxin uusimman version. Lisätietoja löytyy tästä linkistä

1. Lataa Docker Desktop:

• Siirry Docker Desktop for Windows lataussivulle: Docker Desktop for Windows
• Napsauta "Get Docker Desktop for Windows" -painiketta ladataksesi asennustiedoston.

2. Asenna Docker Desktop:

• Suorita ladattu asennustiedosto.
• Seuraa asennusvelhoa ja varmista, että Hyper-V on käytössä (jos sitä kysytään), koska Docker for Windows käyttää Hyper-V:tä virtualisointiin.
• Kun asennus on valmis, Docker Desktop käynnistyy automaattisesti.

3. Vahvista asennus:

• Avaa terminaali ja suorita komento docker --version varmistaaksesi, että Docker on asennettu ja toimii oikein.

Mac

1. Lataa Docker Desktop:

• Siirry Docker Desktop for Mac lataussivulle: Docker Desktop for Mac

2. Asenna Docker Desktop:

• Suorita ladattu asennustiedosto.
• Kun asennus on valmis, Docker Desktop käynnistyy automaattisesti.

3. Vahvista asennus:

• Avaa terminaali ja suorita komento docker --version varmistaaksesi, että Docker on asennettu ja toimii oikein.

2. Konfigurointi

Kun Docker Desktop on ladattu, etsi uusinta webforJ-kuvaa, joka on tällä hetkellä nimellä webforj/sandbox.

Napsauta tag-listaa nähdäksesi käytettävissä olevat vaihtoehdot

Valitse "rc" viimeisimmän version vuoksi

Hae kuva käynnistääksesi konttisi

Kun lataus on valmis, napsauta suorituspainiketta, joka avaa konfigurointiasetukset

Avaa "Valinnaiset asetukset" -valikko

Valitse haluamasi isäntäportti, josta voit nähdä sovelluksesi toimivan Dockerissa

Napsauta "Suorita" käynnistääksesi kontin

Tärkeää

Varmista, että muistat antamasi mukautetun isäntäportin numeron, koska sitä tarvitaan myöhemmin.

3. Sovelluksesi suorittaminen

Kun kontti on luotu, webforJ-sovelluksia voidaan suorittaa kontin sisällä sen sijaan, että ne suoritettaisiin paikallisesti. Ensinnäkin on tarpeen konfiguroida projektisi POM-tiedosto oikein. Kun tämä on tehty, siirtyminen tiettyyn URL-osoitteeseen selaimessa näyttää sovelluksen.

POM-tiedostosi konfigurointi

WebforJ-projektin suorittaminen Docker-kontissa vaatii webforJ Install Pluginin käyttöä, joka voidaan konfiguroida POM-tiedostosi avulla:

Luo uusi <plugin>-merkintä <plugins>-osioon POM-tiedostossa. Alla oleva koodi näyttää aloitusmerkinnän, jota voidaan käyttää ja muokata tarpeen mukaan projektisi vaatimusten mukaiseksi:

important

Jos POM-tiedostossasi ei ole <plugins>-osaa, luo sellainen.

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

Kun yllä olevaan kaltaista merkintää on muokattu, mukauta seuraavat tiedot:

• Muuta <deployurl>-merkintä käyttämään porttinumeroa, joka vastaa Isäntäporttia, jonka konfigurointi tehtiin edellisessä vaiheessa.

• Varmista, että <classname>-merkintä vastaa sen sovelluksen nimeä, jonka haluat suorittaa.

• Jos <username> ja <password> -tunnuksesi ovat erilaiset BBj-asennuksellesi, muuta nämä.

Aloitusprojektin käyttäminen

Luo ja rakenna uusi bbj-hello-world projekti seuraamalla näitä vaiheita:

1. Siirry oikeaan hakemistoon: Avaa pääte ja siirry kansioon, johon haluat luoda uuden projektin.
2. Suorita komento: archetype:generate: Käytä alla olevaa Maven-komentoa ja mukauta groupId, artifactId ja versio tarpeidesi mukaan.

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"

Argumentti	Selitys
archetypeGroupId	Archetyypin ryhmätunnus on com.webforj webforJ-archetyypeille.
archetypeArtifactId	Määritä käytettävän arkkityypin nimi.
archetypeVersion	Määritä käytettävän arkkityypin versio. Tämä varmistaa, että luotu projekti on yhteensopiva tietyn arkkityypin version kanssa. LATEST valitsee saatavilla olevan uusimman version.
groupId	Edustaa generoituun projektiin liittyvää nimiavaruutta. Tyypillisesti rakennettu Java-paketin kaltaisesti, kuten org.esimerkki, ja käytetään organisaatiosi tai projektisi alueen ainutlaatuisen tunnistamisen tueksi.
artifactId	Määrittelee luodun projektin nimen. Tämä on lopullisen artefaktin ja projektikansion nimi.
version	Määrittelee luodun projektin version. Yleinen käytäntö on MAJOR.MINOR-SNAPSHOT, kuten 1.0-SNAPSHOT, missä SNAPSHOT viittaa siihen, että projekti on edelleen kehitysvaiheessa.
appName	Valinnainen parametri, jota voidaan käyttää generoituessa projektin POM-tiedostossa. Voidaan käyttää oletustittelinä sovellukselle käytetyn webforJ-archetypen mukaan.

Maven luo komennon suorittamisen jälkeen projektille tarvittavat tiedostot.

Sovelluksen käynnistäminen

Kun tämä on tehty, suorita mvn install projektikansiossasi. Tämä suorittaa webforJ-install-pluginin ja mahdollistaa sovelluksesi käyttämisen. Näet sovelluksen siirtymällä seuraavaan URL-osoitteeseen:

http://localhost:YourHostPort/webapp/YourPublishName

Korvaa YourHostPort Dockerille konfiguroimallasi isäntäportilla ja YourPublishName korvataan POMin <publishname>-tagin sisältämällä tekstillä. Jos kaikki on tehty oikein, sinun pitäisi nähdä sovelluksesi renderöityvän.