Megosztás a következőn keresztül:


Java-alkalmazás manuális telepítése Open Liberty/WebSphere Liberty használatával egy Azure Red Hat OpenShift-klaszteren

Ez a cikk részletes útmutatót nyújt az Open/WebSphere Liberty Azure Red Hat OpenShift-fürtön való futtatásához. Végigvezeti egy Liberty-alkalmazás előkészítésén, az alkalmazás Docker-rendszerképének elkészítésén és a tárolóalapú alkalmazás Azure Red Hat OpenShift-fürtön való futtatásán.

Pontosabban a következő feladatok elvégzését sajátíthatja el:

  • A Liberty alkalmazás előkészítése
  • Az alkalmazás lemezképének létrehozása
  • A tárolóalapú alkalmazás futtatása egy Azure Red Hat OpenShift-fürtön a grafikus felhasználói felület és a parancssori felület használatával

Az Azure Red Hat OpenShift-fürtre való áttérést felgyorsító automatizáltabb megoldásért tekintse meg az IBM WebSphere Liberty és az Open Liberty üzembe helyezését az Azure Red Hat OpenShiften az Azure Marketplace-ajánlattal.

Az Open Libertyről további információt az Open Liberty projekt oldalán talál. A WebSphere Liberty szolgáltatással kapcsolatos további információkért tekintse meg a WebSphere Liberty termékoldalát.

Ez a cikk segítséget nyújt az üzembe helyezés gyors elvégzéséhez. Mielőtt éles környezetbe lépnél, érdemes megismerkedned a Tuning Liberty-t.

Ha szeretne visszajelzést küldeni vagy szorosan együttműködni a migrálási forgatókönyvekkel a WebSphere Azure-megoldásokon fejlesztő mérnöki csapatával, töltse ki ezt a rövid felmérést a WebSphere migrálásáról , és adja meg a kapcsolattartási adatait. A programmenedzserek, építészek és mérnökök csapata azonnal kapcsolatba lép Önnel, hogy szoros együttműködést kezdeményezze.

Fontos

Bár az Azure Red Hat OpenShiftet a Red Hat és a Microsoft közösen tervezi, üzemelteti és támogatja, hogy integrált támogatási élményt nyújtson, az Azure Red Hat OpenShiften futtatott szoftverekre, beleértve a jelen cikkben ismertetetteket, a saját támogatási és licencfeltételei vonatkoznak. Az Azure Red Hat OpenShift támogatásáról további információt az Azure Red Hat OpenShift 4 támogatási életciklusában talál. Az ebben a cikkben ismertetett szoftverek támogatásával kapcsolatos további információkért tekintse meg a szoftver fő lapjait a cikkben felsoroltak szerint.

Feljegyzés

Az Azure Red Hat OpenShift legalább 40 magot igényel egy OpenShift-fürt létrehozásához és futtatásához. Az új Azure-előfizetés alapértelmezett Azure-erőforráskvótája nem felel meg ennek a követelménynek. Ha növelni szeretné az erőforráskorlátot, olvassa el a Standard kvóta: Korlátok növelése virtuálisgép-sorozatok szerint című témakört. Vegye figyelembe, hogy az ingyenes próbaverziós előfizetés nem jogosult kvótanövelésre, mielőtt kvótanövelést kérne, frissítsen használatalapú fizetéses előfizetésre .

Előfeltételek

  • Helyi gép Unix-szerű operációs rendszerrel – például Ubuntu, macOS vagy Linuxos Windows-alrendszer.

  • Java Standard kiadás (SE) implementáció, 17-es verzió – például Eclipse Open J9.

  • Maven, 3.9.8-es vagy újabb verzió.

  • Docker az operációs rendszerhez.

  • Azure CLI, 2.61.0-s vagy újabb verzió.

  • Egy Azure Red Hat OpenShift 4-fürt. A fürt létrehozásához kövesse az Azure Red Hat OpenShift 4-fürt létrehozása utasításait, közben alkalmazza az alábbiakat is:

    • Bár a "Red Hat lekérési titkos kulcs megszerzése" lépés opcionálisként van megjelölve, erre a lépésre szükség van ebben a cikkben. A lekéréses titkos kód lehetővé teszi, hogy az Azure Red Hat OpenShift-fürt megkeresse az Open Liberty Operátort.

    • Az alábbi környezeti változók, amelyeket az Azure Red Hat OpenShift 4-fürt létrehozása során definiáltunk, a cikk későbbi részében kerülnek felhasználásra:

      • RESOURCEGROUP - annak az erőforráscsoportnak a neve, amelyben a fürt telepítve van.
      • CLUSTER- a klaszter neve.
    • Ha memóriaigényes alkalmazásokat szeretne futtatni a fürtön, adja meg a feldolgozó csomópontok megfelelő virtuálisgép-méretét a --worker-vm-size paraméterrel. További információért tekintse át az alábbi cikkeket:

  • Csatlakozzon a fürthöz az Azure Red Hat OpenShift 4-fürthöz való csatlakozási útmutató lépéseinek követésével, az alábbi utasítások szerint:

    • Feltétlenül kövesse az "OpenShift parancssori felület telepítése" lépéseit, mert a oc parancsot a cikk későbbi részében használja.
    • Jegyezze meg a fürtkonzol URL-címét. Úgy kell kinéznie, mint https://console-openshift-console.apps.<random>.<region>.aroapp.io/.
    • Jegyezze fel a kubeadmin hitelesítő adatokat.
    • A hitelesítő adatokkal mindenképpen kövesse a "Csatlakozás az OpenShift parancssori felület használatával kubeadmin " című témakörben leírt lépéseket.

Az Open Liberty OpenShift operátor telepítése

Miután létrehozta a fürtöt és csatlakozott hozzá, az alábbi lépésekkel telepítse az Open Liberty Operátort. Az Open Liberty Operátor fő kezdőoldala a GitHubon található.

  1. Jelentkezzen be az OpenShift webkonzolra a böngészőből a kubeadmin hitelesítő adatok használatával.

  2. Lépjen az OperátorHub> oldalra, és keressen rá az Open Liberty kifejezésre.

  3. A keresési eredmények közül válassza Open Liberty.

  4. Válassza a Telepítés lehetőséget.

  5. Az Operátor telepítése lapon kövesse az alábbi lépéseket:

    1. Frissítési csatorna esetén válassza ki a legújabb 1.4-es csatornát.
    2. Telepítési módesetén válassza a fürt összes névterét (alapértelmezett).
    3. A frissítés jóváhagyásához válassza az Automatikus lehetőséget.

    Képernyőkép az OpenShift webkonzolról, amelyen az Operátor telepítése lap látható.

  6. Válassza a Telepítés lehetőséget, és várjon néhány percet, amíg a telepítés befejeződik.

  7. Figyelje meg, hogy az Open Liberty operátor telepítése sikeresen megtörtént, és használatra kész. Ha még nem áll készen, a folytatás előtt diagnosztizálja és oldja meg a problémát.

    Képernyőkép az OpenShift webkonzolról, amelyen a Telepített operátor párbeszédpanel látható.

Feljegyzés

Ez az útmutató telepíti az Open Liberty Operátort a Liberty-alkalmazások Azure Red Hat OpenShift-fürtön való kezeléséhez. Ha a WebSphere Liberty Operátort szeretné használni, kövesse a WebSphere Liberty Operátor telepítésének lépéseit a WebSphere Liberty Operátor fürtre történő telepítéséhez.

OpenShift-névtér létrehozása a Java-alkalmazáshoz

Az alábbi lépéseket követve hozzon létre egy OpenShift-névteret az alkalmazással való használatra:

  1. Győződjön meg arról, hogy a hitelesítő adatok használatával bejelentkezett az OpenShift webkonzolra a kubeadmin böngészőből.

  2. Lépjen a Felügyelet>Névterek>Névtér létrehozása pontra.

  3. Töltse ki a open-liberty-demo helyet a Név számára, és válassza a Létrehozás lehetőséget, ahogyan az alább látható.

    Képernyőkép az OpenShift webkonzolról, amelyen a Névtér létrehozása párbeszédpanel látható.

Azure Database for MySQL rugalmas kiszolgáló létrehozása

A rugalmas Azure Database for MySQL-kiszolgáló üzembehelyezési modellje egy olyan üzembehelyezési mód, amely részletesebb vezérlést és rugalmasságot biztosít az adatbázis-kezelési funkciók és konfigurációs beállítások felett, mint az önálló Azure Database for MySQL-kiszolgáló üzembe helyezési módja. Ez a szakasz bemutatja, hogyan hozhat létre rugalmas Azure Database for MySQL-kiszolgálópéldányt az Azure CLI használatával. További információ : Rövid útmutató: Az Azure Database for MySQL rugalmas kiszolgáló példányának létrehozása az Azure CLI használatával.

Futtassa a következő parancsot a terminálon egy rugalmas Azure Database for MySQL-kiszolgálópéldány létrehozásához. Cserélje le <server-admin-password> olyan jelszóra, amely megfelel a rugalmas Azure Database for MySQL-kiszolgáló jelszó-összetettségi követelményeinek.

az mysql flexible-server create \
    --name ${CLUSTER} \
    --resource-group ${RESOURCEGROUP} \
    --admin-user admin${RESOURCEGROUP} \
    --admin-password '<server-admin-password>' \
    --database-name ${RESOURCEGROUP}db \
    --public-access 0.0.0.0 \
    --yes

Feljegyzés

Ez a cikk egy rugalmas Azure Database for MySQL-kiszolgáló létrehozását ismerteti MySQL-hitelesítéssel. Biztonságosabb eljárás a Microsoft Entra-hitelesítés használata az adatbázis-kiszolgáló kapcsolatának hitelesítéséhez. Az Azure Red Hat OpenShift jelenleg nem támogatja a Microsoft Entra Workload ID szolgáltatást, ezért a MySQL-hitelesítés az egyetlen elérhető lehetőség.

Ha hibaüzenetet No available SKUs in this locationkap, adjon meg egy másik helyet a --location paraméterrel, és próbálkozzon újra. Az alábbi paranccsal listázhatja az elérhető termékváltozatokat egy adott helyen:

az mysql flexible-server list-skus --location <location>

Keresse meg a rendelkezésre álló termékváltozatokat tartalmazó helyet, majd ismételje meg az előző az mysql flexible-server create parancsot, de fűzze hozzá a megfelelő --location <location> paramétert, így az összes többi paraméter változatlan marad.

Néhány percet vesz igénybe a kiszolgálói, adatbázis-, rendszergazdai és tűzfalszabály létrehozása, amely minden Azure-erőforrásból fogad kapcsolatokat. Ha a parancs sikeres, a kimenet az alábbi példához hasonlóan néz ki:

{
  "connectionString": "mysql <database-name> --host <server-name>.mysql.database.azure.com --user <server-admin-username> --password=<server-admin-password>",
  "databaseName": "<database-name>",
  "firewallName": "AllowAllAzureServicesAndResourcesWithinAzureIps_2024-7-10_16-22-8",
  "host": "<server-name>.mysql.database.azure.com",
  "id": "/subscriptions/REDACTED/resourceGroups/<resource-group-of-the-OpenShift-cluster>/providers/Microsoft.DBforMySQL/flexibleServers/<server-name>",
  "location": "West US",
  "password": "<server-admin-password>",
  "resourceGroup": "<resource-group-of-the-OpenShift-cluster>",
  "skuname": "Standard_B1ms",
  "username": "<server-admin-username>",
  "version": "5.7"
}

A Liberty alkalmazás előkészítése

Ebben az útmutatóban egy Java EE 8-alkalmazást használunk példaként. Az Open Liberty egy Java EE 8 teljes profillal kompatibilis kiszolgáló, így könnyen futtatható az alkalmazás. Az Open Liberty a Jakarta EE 8 teljes profiljával kompatibilis is.

Az alkalmazás futtatása az Open Libertyben

Az alkalmazás Open Liberty-en való futtatásához létre kell hoznia egy Open Liberty-kiszolgáló konfigurációs fájlját, hogy a Liberty Maven beépülő modul becsomagolni tudja az alkalmazást az üzembe helyezéshez. A Liberty Maven beépülő modul nem szükséges az alkalmazás OpenShiftben való üzembe helyezéséhez. Ebben a példában azonban az Open Liberty fejlesztői (fejlesztői) módjával használjuk. A fejlesztői mód lehetővé teszi az alkalmazás helyi futtatását. Ha többet szeretne megtudni a webalkalmazásról, olvassa el a liberty-maven-pluginWebalkalmazás létrehozása a Mavennel című témakört.

Az ebben a szakaszban leírt lépéseket követve készítse elő a mintaalkalmazást a jelen cikkben szereplő későbbi használatra. Ezek a lépések a Mavent és a liberty-maven-plugin-t használják.

Nézd meg az alkalmazást

Az alábbi parancsokkal klónozza az útmutató mintakódját. A minta a GitHubon található.

git clone https://github.com/Azure-Samples/open-liberty-on-aro.git
cd open-liberty-on-aro
export BASE_DIR=$PWD
git checkout 20240920
cd ${BASE_DIR}/3-integration/connect-db/mysql

Ha megjelenik egy üzenet arról, hogy detached HEAD állapotban van, ezt az üzenetet nyugodtan figyelmen kívül hagyhatja. Ez csak azt jelenti, hogy megnézett egy címkét.

Van néhány minta az adattárban. A open-liberty-on-aro/3-integration/connect-db/mysql programot használjuk. Az alkalmazás fájlstruktúrája a következő:

open-liberty-on-aro/3-integration/connect-db/mysql
├─ src/main/
│  ├─ aro/
│  │  ├─ db-secret.yaml
│  │  ├─ openlibertyapplication.yaml
│  ├─ liberty/config/
│  │  ├─ server.xml
│  ├─ java/
│  ├─ resources/
│  ├─ webapp/
├─ Dockerfile
├─ Dockerfile-wlp
├─ pom.xml

A java, az erőforrások és a webalkalmazás könyvtárai tartalmazzák a mintaalkalmazás forráskódját. A kód deklarál és használ egy nevű jdbc/JavaEECafeDBadatforrást.

Az aro könyvtárban két üzembehelyezési fájlt helyeztünk el. db-secret.xml az adatbázis-kapcsolat hitelesítő adataival rendelkező titkos kulcsok létrehozására szolgál. Az openlibertyapplication.yaml fájl az alkalmazás lemezképének üzembe helyezésére szolgál.

A gyökérkönyvtárban két Docker-fájlt helyeztünk el. A Dockerfile és a Dockerfile-wlp a helyi hibakereséshez, valamint az Open Liberty és a WebSphere Liberty használatával történő Azure Red Hat OpenShift-üzembe helyezés rendszerképének létrehozásához használatos.

A liberty/config könyvtárban a server.xml fájl az Open Liberty és a WebSphere Liberty fürt adatbázis-kapcsolatának beállítására szolgál.

A projekt felépítése

A korábban definiált környezeti változók használatával futtassa a következő parancsokat a terminálban a projekt létrehozásához. A projekt POM-fájlja számos tulajdonságot olvas be a környezetből.

cd ${BASE_DIR}/3-integration/connect-db/mysql

# The following variables are used for deployment file generation
export DB_SERVER_NAME=$CLUSTER.mysql.database.azure.com
export DB_PORT_NUMBER=3306
export DB_NAME=${RESOURCEGROUP}db
export DB_USER=admin${RESOURCEGROUP}
export DB_PASSWORD='<server-admin-password>'
export NAMESPACE=open-liberty-demo

mvn clean install

(Nem kötelező) Az alkalmazás helyi tesztelése

Ha szükséges, helyileg futtathatja az alkalmazást annak ellenőrzéséhez, hogy az a várt módon működik-e. Először hozzá kell adnia egy tűzfalszabályt, amely lehetővé teszi a helyi gép számára, hogy csatlakozzon a rugalmas Azure Database for MySQL-kiszolgálópéldányhoz. A tűzfalszabály hozzáadásához kövesse az alábbi lépéseket:

  1. Jelentkezzen be az Azure Portalra, és keresse meg a korábban létrehozott rugalmas Azure Database for MySQL-kiszolgálópéldányt.
  2. A bal oldali panelen válassza a Beállítások>hálózatkezelés lehetőséget.
  3. Válassza az Aktuális ügyfél IP-címének hozzáadása lehetőséget.
  4. Válassza a Mentés lehetőséget , és várja meg a tűzfalszabály hozzáadását.

A következő lépésekkel futtathatja a parancsot a liberty:devc projekt és a tároló lemezképének helyi futtatásához és teszteléséhez, mielőtt bármilyen Azure-összetettséggel foglalkozna. További információkért liberty:devclásd a Liberty beépülő modul dokumentációját.

  1. Szükség esetén indítsa el a helyi Docker-környezetet. A környezet indítására vonatkozó utasítások a gazdagép operációs rendszerétől függően változnak.

  2. Az alábbi parancsokkal indítsa el az alkalmazást liberty:devc módban:

    cd ${BASE_DIR}/3-integration/connect-db/mysql
    
    # If you are running with Open Liberty
    mvn liberty:devc -DcontainerRunOpts="-e DB_SERVER_NAME=${DB_SERVER_NAME} -e DB_PORT_NUMBER=${DB_PORT_NUMBER} -e DB_NAME=${DB_NAME} -e DB_USER=${DB_USER} -e DB_PASSWORD=${DB_PASSWORD}" -Dcontainerfile=Dockerfile
    
    # If you are running with WebSphere Liberty
    mvn liberty:devc -DcontainerRunOpts="-e DB_SERVER_NAME=${DB_SERVER_NAME} -e DB_PORT_NUMBER=${DB_PORT_NUMBER} -e DB_NAME=${DB_NAME} -e DB_USER=${DB_USER} -e DB_PASSWORD=${DB_PASSWORD}" -Dcontainerfile=Dockerfile-wlp
    
  3. Ellenőrizze, hogy az alkalmazás a várt módon működik-e. Ha sikeres, a parancs kimenetében hasonló [INFO] [AUDIT] CWWKZ0003I: The application javaee-cafe updated in 1.930 seconds. üzenetnek kell megjelennie. Nyissa meg https://localhost:9443/ a böngészőben, és ellenőrizze, hogy az alkalmazás elérhető-e, és minden függvény működik-e.

  4. A mód leállításához nyomja le a Control és C billentyűket.

Az alkalmazás lemezképének előkészítése

A Liberty-alkalmazás Azure Red Hat OpenShift-fürtön való üzembe helyezéséhez és futtatásához tárolóba helyezheti az alkalmazást Docker-rendszerképként Open Liberty-tárolórendszerképek vagy WebSphere Liberty-tárolórendszerképek használatával.

Az alkalmazás felépítése és feltöltése az képstreambe.

Mivel már sikeresen futtatta az alkalmazást a Liberty Docker-tárolóban a liberty:devc paranccsal, a rendszerképet távolról fogja létrehozni a fürtön az alábbi lépések végrehajtásával:

  1. Győződjön meg arról, hogy bejelentkezik az OpenShift CLI-be a kubeadmin hitelesítő adatokkal.

  2. A forráskönyvtár és a Dockerfile azonosításához használja a következő parancsokat:

    cd ${BASE_DIR}/3-integration/connect-db/mysql
    
    # If you are building with the Open Liberty base image, the existing Dockerfile is ready for you
    
    # If you are building with the WebSphere Liberty base image, uncomment and execute the following two commands to rename Dockerfile-wlp to Dockerfile
    # mv Dockerfile Dockerfile.backup
    # mv Dockerfile-wlp Dockerfile
    
  3. A projekt open-liberty-demomódosításához használja a következő parancsot:

    oc project open-liberty-demo
    
  4. Képstream létrehozásához használja a következő parancsot:

    oc create imagestream javaee-cafe-mysql
    
  5. Az alábbi paranccsal hozzon létre egy buildkonfigurációt, amely megadja a buildkimenet képstream-címkéjét:

    oc new-build --name javaee-cafe-mysql-config --binary --strategy docker --to javaee-cafe-mysql:v1
    
  6. Az alábbi parancsot használja az építés elindításához, hogy feltöltse a helyi tartalmakat, konténerizálja, és a kimenetet a korábban megadott képstream címkére irányítsa:

    oc start-build javaee-cafe-mysql-config --from-dir . --follow
    

Alkalmazás üzembe helyezése az Azure Red Hat OpenShift-fürtön

Most már üzembe helyezheti a Liberty-mintaalkalmazást a korábban létrehozott Azure Red Hat OpenShift-fürtön az előfeltételek teljesítésekor.

Az alkalmazás üzembe helyezése a webkonzolról

Mivel az Open Liberty Operátort használjuk a Liberty-alkalmazások kezeléséhez, létre kell hoznunk a OpenLibertyApplicationtípusú egyéni erőforrásdefiníció egy példányát. Az operátor gondoskodik az üzembe helyezéshez szükséges OpenShift-erőforrások kezelésének minden aspektusáról. A példány létrehozásához kövesse az alábbi lépéseket:

  1. Jelentkezzen be az OpenShift webkonzolra a böngészőből a kubeadmin hitelesítő adatok használatával.

  2. Válassza ki a projektet a Home>Projektek>open-liberty-demo felkeresésével.

  3. Navigáljon a Feladatok>Titkos kulcsok menüpontba.

  4. Válassza a Létrehozás>YAML-ből lehetőséget.

  5. Cserélje le a létrehozott YAML-t a sajátjára, amely a <elérési út>/3-integration/connect-db/mysql/target/db-secret.yaml helyen található.

  6. Válassza a Létrehozás lehetőséget. Ez a választás visszavisz a Titkos részletek oldalra.

  7. Lépjen a Operátorok>Telepített operátorok pontra.

  8. A lap közepén megjelenik az Open Liberty.

  9. A megadott API-k közül válassza az OpenLibertyApplication lehetőséget. A felhasználói felületen található elemek navigációja a használt technológiák tényleges elszigetelési hierarchiáját tükrözi.

    Az Azure Red Hat OpenShift Java-elszigetelésének diagramja.

  10. Válassza az OpenLibertyApplication létrehozása lehetőséget.

  11. Válassza a YAML-nézetet a konfiguráláshoz.

  12. Cserélje le a létrehozott yaml-t a sajátoddal, amely a path-to-repo/3-integration/connect-db/mysql/target/openlibertyapplication.yaml helyen található.

  13. Válassza a Létrehozás lehetőséget. Ön visszakerül az OpenLibertyApplications listájára.

  14. Navigáljon a Operátorok>Telepített operátorok>Open Liberty>OpenLibertyApplication.

  15. Válassza a javaee-cafe-mysql lehetőséget.

  16. A lap közepén válassza az Erőforrások lehetőséget.

  17. A táblázatban válassza ki a javaee-cafe-mysql hivatkozást a ÚtvonalTípus szerint.

  18. A megnyíló lapon válassza a Hely alatti hivatkozást.

Megnyílik az alkalmazás kezdőlapja a böngészőben.

Az alkalmazás törlése a webkonzolról

Ha végzett az alkalmazással, az alábbi lépésekkel törölheti az alkalmazást az Open Shiftből:

  1. A bal oldali navigációs panelen bontsa ki az Operátorok bejegyzést.
  2. Válassza a Telepített operátorok lehetőséget.
  3. Válassza az Open Liberty lehetőséget.
  4. A lap közepén válassza az OpenLibertyApplication lehetőséget.
  5. A javaee-cafe-mysql esetében válassza a három függőleges pontot, majd az OpenLibertyApplication törlése lehetőséget.
  6. Az alkalmazás törléséhez válassza a Törlés lehetőséget.

A titkos kód az Open Shiftből való törléséhez kövesse az alábbi lépéseket:

  1. Navitáljon a Számítási feladatok>Titkok menüpontra.
  2. Válassza a db-secret-mysql lehetőséget.
  3. Válassza a Műveletek>Titkos eltávolítása.
  4. A titkos kód törléséhez válassza a Törlés lehetőséget.

Az erőforrások megtisztítása

Törölje az Azure Red Hat OpenShift-fürtöt az oktatóanyag lépéseit követve: Azure Red Hat OpenShift 4-fürt törlése. Győződjön meg arról, hogy az adatbázis és a kapcsolódó erőforrások is törlődnek.

Következő lépések

Az útmutatóban használt hivatkozásokból többet is megtudhat:

A WebSphere-termékek Azure-beli futtatásának lehetőségeiről további információt a WebSphere termékcsalád Azure-beli futtatására vonatkozó megoldások című témakörben talál .