Docker-asennus

Avaa ChatGPT:ssä

Tässä asiakirjan osassa käsitellään vaiheita, jotka tarvitaan käyttäjille, jotka haluavat kehittää käyttämällä Dockeria. Muutokset koodissasi tehdään kehityskoneellasi, ja lopullinen sovellus käynnistetään 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

Suositellaan lataamaan uusin versio Windows Subsystem for Linuxista. Lisätietoja löytyy tästä linkistä.

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 asennusvelhoa ja varmista, että olet ottanut Hyper-V:n käyttöön (jos sitä pyydetään), sillä 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:

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

2. Asenna Docker Desktop:

• Suorita lataamasi 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 uusin webforJ- kuva, joka on tällä hetkellä nimellä webforj/sandbox.

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

Valitse "rc" viimeiselle rakennukselle

Hae kuva aloittaaksesi säiliön

Kun lataus on valmis, napsauta käynnistä-painiketta, joka avaa kokoonpanon asetukset

Avaa "Valinnaiset asetukset" -valikko

Valitse haluttu isäntäportti, jolla voit nähdä sovelluksesi toimivan Dockerissa

Napsauta "Käynnistä" säiliön käynnistämiseksi

Tärkeä

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

3. Sovelluksesi käynnistäminen

Kun säiliö on luotu, webforJ-sovelluksia voidaan suorittaa säiliössä sen sijaan, että niitä suoritetaan paikallisesti. Ensin 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-säiliössä vaatii webforJ Install Pluginin käyttöä, joka voidaan konfiguroida POM-tiedostosi avulla:

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

important

Jos POM-tiedostosi ei sisällä <plugins>-osaa, luo yksi.

<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ä olevan kaltainen merkintä on luotu, personoi seuraavat tiedot:

• Muuta <deployurl>-merkintä käyttämään porttinumeroa, joka vastaa Isäntäporttia, jonka määritit säiliöllesi edellisessä vaiheessa.

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

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

Käynnistäjäprojektin käyttäminen

Luodaksesi ja rakentaaksesi uuden bbj-hello-world-projektin, seuraa näitä vaiheita:

1. Siirry oikeaan hakemistoon: Avaa terminaali ja siirry kansioon, johon haluat luoda uuden projektisi.
2. Suorita archetype:generate-komento: Käytä alla olevaa Maven-komentoa ja mukauta groupId, artifactId ja version projektisi tarpeiden 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	Arkityypin ryhmätunnus: com.webforJ
archetypeArtifactId	Määrittää käytettävän arkkityypin nimen.
archetypeVersion	Määritä arkkityypin versio. LATEST valitsee uusimman version.
groupId	Edustaa luodun projektin nimiavaruutta. Tyypillisesti rakennettu Java-paketin tapaan, kuten org.example, ja sitä käytetään organisaatiosi tai projektialueesi yksilölliseen tunnistamiseen.
artifactId	Määrittää luodun projektin nimen. Tästä tulee tuloksena olevan artefaktin ja projektikansion nimi.
version	Määritä versionumero (MAJOR.MIINOR-SNAPSHOT, esim. 1.0-SNAPSHOT).
appName	Valinnainen parametri, jota voidaan käyttää luodun projektin POM-tiedostossa. Käytetyn webforJ-arkkityypin mukaan sitä voidaan käyttää sovelluksen oletusotsikkona.

Komennon suorittamisen jälkeen Maven luo projektin suorittamiseen tarvittavat projektitiedostot.

Sovelluksen käynnistäminen

Kun tämä on tehty, suorita mvn install projektisi hakemistossa. Tämä suorittaa webforJ-installointi pluginin ja mahdollistaa pääsyn sovellukseesi. Näet sovelluksen siirtymällä seuraavaan URL-osoitteeseen:

http://localhost:YourHostPort/webapp/YourPublishName

Korvaa YourHostPort Dockerille määrittämällä isäntäportilla, ja YourPublishName korvataan POM:in <publishname>-tagin sisällöllä. Jos kaikki on oikein tehty, sinun pitäisi nähdä sovelluksesi renderöitynä.