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:

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.

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:

    • Az Azure CLI használata egy fürt létrehozásához
    • Memóriaoptimalizált támogatott virtuális gépméretek

• 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.

   

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.

   

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ó.

   

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

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

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.

oc delete -f openlibertyapplication.yaml
oc delete -f db-secret.yaml

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:

• Open Liberty
• Azure Red Hat OpenShift
• Open Liberty Operátor
• A Liberty Server konfigurációjának megnyitása
• Liberty Maven beépülő modul
• Open Liberty Container Images
• WebSphere Liberty-tárolórendszerképek

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 .