Docker-asennus

Avaa ChatGPT:ssä

Tässä asiakirjan osassa käsitellään vaiheita, jotka käyttäjien on suoritettava, jos he haluavat kehittää käyttäen Dockeria. Koodisi muutokset tehdään kehityskoneellasi, ja tuloksena oleva sovellus suoritetaan Dockerissa.

1. Dockerin lataaminen

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

Windows

tiedot

On suositeltavaa ladata uusin versio Windows Subsystem for Linuxista. Lisätietoja löytyy tästä linkistä

1. Lataa Docker Desktop:

• Siirry Docker Desktop for Windows lataussivulle: Docker Desktop for Windows
• Napsauta "Hanki Docker Desktop for Windows" -painiketta ladataksesi asennusohjelman.

2. Asenna Docker Desktop:

• Suorita lataamasi asennusohjelma.
• Seuraa asennus aihetta ja varmista, että Hyper-V on käytössä (jos kehotetaan), sillä Docker for Windows käyttää Hyper-V:tä virtualisointiin.
• Kun asennus on valmis, Docker Desktop käynnistyy automaattisesti.

3. Varmista 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 lataamasi asennusohjelma.
• Kun asennus on valmis, Docker Desktop käynnistyy automaattisesti.

3. Varmista asennus:

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

2. Konfigurointi

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

Napsauta tagiluetteloa nähdäksesi saatavilla olevat vaihtoehdot

Valitse "rc" uusimmasta versiosta

Hae kuva aloittaaksesi säilön

Kun lataus on valmis, napsauta Suorita-painiketta, joka avaa konfigurointiasetukset

Avaa "Valinnaiset asetukset" -valikko

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

Napsauta "Suorita" aloittaaksesi säilön

Tärkeää

Muista merkitä antamasi mukautettu isäntäportti, sillä sitä tarvitaan myöhemmin.

3. Sovelluksen suorittaminen

Kun säilö on luotu, webforJ-sovellukset voidaan suorittaa säilössä sen sijaan, että ne suoritettaisiin paikallisesti. Ensin on tarpeen konfiguroida projektisi POM-tiedosto oikein. Kun tämä on tehty, tiettyyn URL-osoitteeseen siirtyminen selaimessa näyttää sovelluksen.

POM-tiedoston konfigurointi

webforJ-projektin suorittaminen Docker-säilössä vaatii webforJ Asennuspluginin käyttöä, joka voidaan konfiguroida POM-tiedostosi avulla:

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

important

Jos POM-tiedostossasi ei ole <plugins>-osiota, 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 vastaava merkintä on luotu, muokkaa seuraavia tietoja:

• Muuta <deployurl>-merkintä käyttämään porttinumeroa, joka vastaa aiemmin säilyttävää Isäntäporttia, jonka määritit säilöllesi.

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

• Jos <username> ja <password> -todistustiedot eroavat BBjn asennuksestasi, 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 julkaiseminen

Kun tämä on tehty, suorita mvn install projektisi hakemistossa. Tämä suorittaa webforJ-asennuspluginin ja antaa sinun käyttää sovellustasi. Näet sovelluksen siirtymällä seuraavaan URL-osoitteeseen:

http://localhost:YourHostPort/webapp/YourPublishName

Korvaa YourHostPort Dockerilla määrittämälläsi isäntäportilla ja YourPublishName on korvattu POM-tiedoston <publishname>-tagin sisällä olevalla tekstillä. Jos kaikki on tehty oikein, näet sovelluksesi renderöitynä.