Käyttöönotto 26.03

Avaa ChatGPT:ssä

webforJ Maven -laajennus ottaa sovelluksen käyttöön BBjShipissä kolmella tavoitteella:

Tavoite	Suoritetaan	Toiminto
bbj-package	package-vaiheen yhteydessä	Kirjoittaa käyttöönottoarkiston target/bbj/<publish name>.zip
bbj-deploy	install-vaiheen yhteydessä	Kirjoittaa arkiston ja ottaa sovelluksen käyttöön BBjShipissä
bbj-undeploy	manuaalisesti	Poistaa sovelluksen BBjServicesistä

Vaiheet ovat käytössä, kun laajennus on määritetty asetuksilla <extensions>true</extensions> ja <bbj>-lohkolla. Katso Projektin määrittäminen.

Ota käyttöön

mvn install

Jos laajennus ei ole käytössä, suorita mvn package webforj:bbj-deploy. Tavoite tulostaa sovelluksen osoitteen, kun käyttöönotto on valmis:

[INFO] BBj deployment of inventory completed at http://localhost:8888/webapp/inventory

Jos käyttöönotto epäonnistuu, edellinen versio jatkaa toimintaansa.

Korvaa sovelluksen

Käyttöönotto korvaa sovelluksen, jolla on sama julkaisu nimi. Edellinen käyttöönottokansio poistetaan, ja sovelluksen käynnissä olevat istunnot päättyvät. Säilytä edellisen version arkisto, jos saatat haluta palata siihen.

Ongelmien vianmääritys sisältää epäonnistuneen käyttöönoton viestit ja ohjeet niiden käsittelyyn.

Pakkaa ottamatta käyttöön

bbj-package kirjoittaa saman arkiston ilman käyttöönoton URL-osoitetta tai tunnistetietoja. CI-työ voi liittää tiedoston target/bbj/<publish name>.zip koontiversioon, minkä jälkeen BBj-järjestelmänvalvoja ottaa sen käyttöön BBj-koneella komennolla bbjship apps deploy.

Poista käyttöönotosta

mvn webforj:bbj-undeploy

Sovellus pysäytetään ja poistetaan Enterprise Managerista tiedostoineen.

Toimintoa ei voi perua

bbj-undeploy päättää sovelluksen käynnissä olevat istunnot ja poistaa sen käyttöönottokansion. Tätä ei voi perua. Säilytä arkisto target/bbj/<publish name>.zip, jos saatat ottaa sovelluksen uudelleen käyttöön.

Julkaisunimet

Julkaisunimi on oletusarvoisesti koontiversion lopullinen nimi, ja se näkyy sovelluksen osoitteessa. Nimen on alettava kirjaimella tai numerolla, ja se voi sisältää vain kirjaimia, numeroita sekä merkit _, . ja -. Nimi ei saa päättyä pisteeseen. Varatut nimet, kuten BBjServicesin polut webapp ja files tai Windowsin laitteen nimi con, hylätään ennen arkiston kirjoittamista.

Jokainen aloitusluokka kuuluu yhteen käyttöönotettuun sovellukseen. Sen käyttöönotto toisella nimellä epäonnistuu seuraavasti:

BBj deployment failed with HTTP 409. Entry class com.example.Application is already published as inventory. Undeploy inventory first

Käyttöönotto toiselta koneelta

Käyttöönotto toiselta koneelta, kuten CI-palvelimelta, käyttää valtuutustunnusta HTTPS-yhteyden kautta:

1. Ota käyttöönottopäätepiste käyttöön BBj-koneella SSL-porttia käyttäen.
2. Luo Enterprise Managerissa tunnus kohdassa Security, Authentication Tokens. Voit uusia ja mitätöidä tunnuksen samassa paikassa.
3. Välitä tunnus koontiversiolle:

mvn package webforj:bbj-deploy \
  -Dwebforj.bbj.deployment.url=https://bbj.example.com:8443/webforj-bbjship \
  -Dwebforj.bbj.admin.token="$BBJ_ADMIN_TOKEN"

BBjServices-verkkopalvelimen varmenteen on vastattava URL-osoitteen isäntänimeä tai sen on oltava koontiversion Javan luottamusvarastossa. Java ei luota BBj:n oletusvarmenteeseen, koska se on itse allekirjoitettu.

Toiseen koneeseen osoittava http://-URL hylätään molemmissa päissä. Tavoite pysähtyy ennen kuin se lähettää mitään, ja BBjShip vastaa HTTP 403 -virheellä pyyntöön, joka saapuu HTTP:n kautta toiselta koneelta. BBj-koneeseen itseensä osoittava URL, kuten localhost tai jokin sen omista osoitteista, toimii HTTP:n kautta.

Jos haluat silti ottaa sovelluksen käyttöön HTTP:n kautta toisella koneella, esimerkiksi omalla tietokoneellasi olevassa virtuaalikoneessa, salli se molemmissa päissä. Suorita BBj-koneella bbjship remote enable --allow-unencrypted käyttäen päätepisteen portteja. Aseta koontiversiossa <deployment><allowUnencrypted>true</allowUnencrypted> tai välitä seuraava ominaisuus:

mvn package webforj:bbj-deploy \
  -Dwebforj.bbj.deployment.url=http://bbj.example.com:8888/webforj-bbjship \
  -Dwebforj.bbj.deployment.allowUnencrypted=true

Tavoite tulostaa tällöin varoituksen ja ottaa sovelluksen käyttöön. Tunnistetiedot kulkevat kyseisen yhteyden kautta verkossa luettavassa muodossa.

Sovellusasetukset

BBjShip lukee sovelluksen webforj.conf-tiedoston jokaisen käyttöönoton yhteydessä ja määrittää sen ominaisuudet sovellukselle Enterprise Managerissa. Uudelleenkäyttöönotto ottaa muuttuneen arvon käyttöön. Jos ominaisuutta ei ole asetettu, käyttöön jää BBjServicesin oletusarvo.

webforj.conf

webforj.assetsSource = packaged
webforj.disallowConsole = true
webforj.programArguments = ["mode=demo", "region eu"]

Ominaisuus	Oletusarvo	Kuvaus
webforj.assetsSource	Ei asetettu	packaged tarjoaa sovelluksesta ws://-staattiset tiedostot ja icons://-kuvakkeet polussa /webforj/<publish name>/. Ilman tätä asetusta icons://-osoitteita käyttävän sovelluksen käynnistys epäonnistuu.
webforj.showClientConfirmationDialog	false	Kysyykö selain vahvistusta ennen sivun sulkemista.
webforj.disallowConsole	true	Onko konsolin käyttö sovelluksessa estetty.
webforj.secure	BBjServicesin oletusarvo	Suoritetaanko sovellus suojatun yhteyden kautta.
webforj.configFile	BBjServicesin oletusarvo	Sen BBj-määritystiedoston polku, jonka kanssa sovellus suoritetaan. BBjServices lukee tiedoston BBj-koneella. Polku välitetään sellaisenaan, joten se voi osoittaa tiedostoon, joka on olemassa vain palvelimella.
webforj.programArguments	Ei mitään	Sovelluksen ohjelma-argumentit merkkijonoluettelona tai yhtenä merkkijonona.

Virheellinen webforj.conf aiheuttaa käyttöönoton epäonnistumisen HTTP 400 -virheellä ja syyn sisältävällä viestillä.

Asetukset

Asetukset määritetään webforj-maven-plugin-laajennuksen <bbj>-lohkossa, kuten kohdassa Koontilaajennus näytetään. Kukin ominaisuus ohittaa komentoriviltä annetun arvon.

Maven-elementti	Maven-ominaisuus	Oletusarvo	Kuvaus
<home>	webforj.bbj.home	Tunnistetaan automaattisesti	BBj-asennuskansio, jota bbj-setup ja watch käyttävät.
<publishName>	webforj.bbj.publishName	Koontiversion lopullinen nimi	Nimi, jolla sovellus julkaistaan. Katso Julkaisunimet.
<deployment><url>	webforj.bbj.deployment.url	Ei ole, pakollinen	BBjShipin osoite: http://<host>:<HTTP port>/webforj-bbjship tai https://<host>:<SSL port>/webforj-bbjship.
<deployment><allowUnencrypted>	webforj.bbj.deployment.allowUnencrypted	false	Sallii komentojen bbj-deploy ja bbj-undeploy lähettää tunnistetiedot http://-URL-osoitteeseen toisella koneella. Katso Käyttöönotto toiselta koneelta.
<admin><username>	webforj.bbj.admin.username	admin, jos sekä käyttäjänimi että salasana puuttuvat	BBj-järjestelmänvalvojan käyttäjänimi.
<admin><password>	webforj.bbj.admin.password	admin123, jos sekä käyttäjänimi että salasana puuttuvat	BBj-järjestelmänvalvojan salasana.
<admin><token>	webforj.bbj.admin.token	Tyhjä	bbj-deploy- ja bbj-undeploy-komentojen valtuutustunnus. Ohittaa käyttäjänimen ja salasanan.
<properties>	webforj.bbj.properties	<home>/cfg/BBj.properties	BBjServicesin ominaisuustiedosto, johon kehitysajossa kirjoitetaan hot swap -asetukset.
<development><classFolder>	—	Koontiversion tulostehakemisto	Kehitysajon luokkakansio sellaisena kuin BBjServices sen lukee.
—	webforj.bbj.force	false	Sallii bbj-setup-komennon korvata asennetun, eri versiota olevan BBjShipin. Vain ominaisuus.

Jos käyttäjänimi annetaan ilman salasanaa tai salasana ilman käyttäjänimeä, tavoite pysähtyy.