Docker-asennus

Avaa ChatGPT:ssä

Tässä asiakirjan osassa käsitellään vaiheita, jotka käyttäjien on suoritettava, jos he haluavat kehittää Dockerin avulla. Muutokset koodiisi 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

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

1. Lataa Docker Desktop:

• Vieraile Docker Desktop for Windows -lataussivulla: Docker Desktop for Windows
• Napsauta "Get Docker Desktop for Windows" -painiketta ladataksesi asennustiedoston.

2. Asenna Docker Desktop:

• Suorita lataamasi asennustiedosto.
• Seuraa asennusohjelman ohjeita ja varmista, että otat käyttöön Hyper-V (jos kehotetaan), koska Docker Windowsille käyttää Hyper-V:tä virtualisointiin.
• Kun asennus on valmis, Docker Desktop alkaa käynnistyä automaattisesti.

3. Tarkista asennus:

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

Mac

1. Lataa Docker Desktop:

• Vieraile Docker Desktop for Mac -lataussivulla: Docker Desktop for Mac

2. Asenna Docker Desktop:

• Suorita lataamasi asennustiedosto.
• Kun asennus on valmis, Docker Desktop alkaa käynnistyä automaattisesti.

3. Tarkista 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 -image, joka on tällä hetkellä nimellä webforj/sandbox.

Napsauta tagilistaa nähdäksesi käytettävissä olevat vaihtoehdot

Valitse "rc" uusimmalle rakennelmalle

TPullaa kuva aloittaaksesi säilösi

Kun lataus on valmis, napsauta suorituspainiketta, joka avaa konfigurointiasetukset

Avaa "Valinnaiset asetukset" -valikko

Valitse haluttu isäntäsatama, josta voit nähdä sovelluksesi toimivan Dockerissa

Napsauta "Suorita" aloittaaksesi säilön

Tärkeä

Muista ottaa talteen antamasi mukautettu isäntäsataman numero, sillä sitä tarvitaan myöhemmin.

3. Sovelluksesi suorittaminen

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

POM-tiedoston konfigurointi

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

Luo uusi <plugin>-merkintä POM-tiedoston <plugins>-osioon. Seuraava koodi esittää aloitusmerkinnän, jota voidaan käyttää ja muokata tarpeen mukaan projektiasi varten:

important

Jos POM-tiedostossasi ei ole <plugins>-osuutta, 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 olet luonut edellä olevan kaltaisen merkinnän, mukauta seuraavat tiedot:

• Muuta <deployurl>-merkintä käyttämään porttinumeroa, joka vastaa Isäntäsatamaa, jonka olet määrittänyt säilöllesi edellisessä vaiheessa.

• Varmista, että <classname>-merkintä vastaa haluamasi sovelluksen nimeä.

• Jos <username>- ja <password>-tunnuksesi ovat erilaiset BBj-asennuksessasi, 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-lisäosan ja sallii sinun käyttää sovellustasi. Näet sovelluksen menemällä seuraavaan URL-osoitteeseen:

http://localhost:YourHostPort/webapp/YourPublishName

Vaihda YourHostPort Dockerin avulla määrittämääsi isäntäsatamaan ja YourPublishName on vaihdettu POM-tiedoston <publishname>-tagin sisällä olevaan tekstiin. Jos kaikki on tehty oikein, sinun pitäisi nähdä sovelluksesi näyttävän.