Java-alkalmazások készítése

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022 | Azure DevOps Server 2020

Az Azure Pipelines használatával automatizálhatja a Java-alkalmazások összeállítását, tesztelését és üzembe helyezését. Ez a cikk bemutatja, hogyan állíthat be folyamatokat Java-projektekhez olyan eszközökkel, mint a Maven, a Gradle vagy az Ant. Azt is megtudhatja, hogyan helyezheti üzembe az alkalmazást olyan Azure-szolgáltatásokban, mint az App Service, a Functions vagy a Kubernetes.

Folyamat használata a következőhöz:

• Készítse el a projektet a Maven, a Gradle vagy az Ant használatával.
• Teszteket és kódelemzési eszközöket futtathat.
• Az alkalmazást egy pipeline és az Azure Artifacts használatával tegye közzé.
• Alkalmazásának üzembe helyezése az Azure App Service-ben, Azure Functions-ben, vagy Azure Kubernetes Service-ben.

Ha Android-projekteken dolgozik, tekintse meg az Android-alkalmazások összeállítását, tesztelését és üzembe helyezését.

Előfeltételek

termék	Követelmények
Azure DevOps	- Egy Azure DevOps-projekt. – Képes futtatni folyamatokat a Microsoft által üzemeltetett ügynökökön. Vásárolhat párhuzamos feladatot , vagy ingyenes szintet kérhet. - A YAML és az Azure Pipelines alapszintű ismerete. További információért lásd Az első adatfolyam létrehozása. - engedélyek:      – Egy folyamat létrehozásához a Közreműködők csoport tagjának kell lennie, és a csoportnak engedélyezni kell a build pipeline létrehozása jogosultságot. A Projektgazdák csoport tagjai kezelhetik a folyamatokat.     - Szolgáltatáskapcsolatok létrehozásához: rendszergazdai vagy létrehozói szerepkörrel kell rendelkeznie szolgáltatáskapcsolatok.
GitHub	- Egy GitHub--fiók. - Egy GitHub-szolgáltatáskapcsolat az Azure Pipelines engedélyezéséhez.
Kék	Egy Azure-előfizetés.

GitHub-adattár létrehozása

Forkold a következő tárhelyet a GitHub-fiókodhoz:

https://github.com/MicrosoftDocs/pipelines-java

Folyamat létrehozása

1. Jelentkezzen be az Azure DevOps-szervezetbe, és lépjen a projektjéhez.

2. Lépjen a Folyamatok elemre, majd válassza az Új folyamat vagy a Folyamat létrehozása lehetőséget, ha az első folyamatot hozza létre a projektben.

3. Kövesse a varázsló lépéseit, először válassza ki a GitHubot a forráskód helyeként. Előfordulhat, hogy a rendszer átirányítja a GitHubra a bejelentkezéshez. Ha igen, adja meg a GitHub hitelesítő adatait.

4. Válassza ki az adattárat. Előfordulhat, hogy a Rendszer átirányítja a GitHubra az Azure Pipelines alkalmazás telepítéséhez. Ha igen, válassza a Jóváhagyás > telepítés lehetőséget a folytatáshoz.

5. Amikor megjelenik a Folyamat konfigurálása lap, válassza a Maven, a Gradle vagy az Ant lehetőséget attól függően, hogy hogyan szeretné létrehozni a kódot.

6. A azure-pipelines.yml folyamatdefiníciót tartalmazó fájl az adattárban jön létre, és a YAML-szerkesztőben nyílik meg. A folyamatot testre szabhatja további tevékenységek hozzáadásával vagy a meglévő tevékenységek módosításával. A buildelési feladatokról további információt a kód összeállítása című témakörben talál.

7. Ha végzett a szerkesztéssel, válassza a azure-pipelines.ymlMentés és futtatás lehetőséget.

8. Ha véglegesíteni szeretné a fájlt az azure-pipelines.yml adattárban, válassza a Mentés és futtatás lehetőséget.

Válassza a Feladat lehetőséget a folyamat megtekintéséhez.

Már van egy YAML-folyamat a tárházában (azure-pipelines.yml), amely működőképes és készen áll a testreszabásra! A folyamat módosításához jelölje ki azt a Folyamatok lapon, majd szerkessze a azure-pipelines.yml fájlt.

Környezet létrehozása

Az Azure Pipelines használatával Java-alkalmazásokat hozhat létre infrastruktúra beállítása nélkül. Készítsen Windows, Linux vagy macOS képeket. Az Azure Pipelines Microsoft által üzemeltetett ügynökei modern JDK-kkal és egyéb java-eszközökkel rendelkeznek előre telepítve. A Java telepített verzióinak ellenőrzéséhez tekintse meg a Microsoft által üzemeltetett ügynököket.

Válassza ki a megfelelő képet a következő kódrészlet frissítésével a azure-pipelines.yml fájlban.

pool:
  vmImage: 'ubuntu-latest' # other options: 'macOS-latest', 'windows-latest'

A képek teljes listáját a Microsoft által üzemeltetett ügynökökben találja.

A Microsoft által üzemeltetett ügynökök alternatívaként állítsa be a saját üzemeltetésű ügynököket a Java telepítésével. A saját üzemeltetésű ügynökökkel időt takaríthat meg, ha nagy adattárral rendelkezik, vagy növekményes buildeket futtat.

A kód összeállítása

A Java-alkalmazást a Maven, a Gradle, az Ant vagy egy szkript használatával is létrehozhatja. Az alábbi szakaszok bemutatják, hogyan adhat hozzá buildelési lépést a folyamathoz az egyes metódusokhoz.

Maven

Egy Maven-build esetében adja hozzá a következő feladatokat a azure-pipelines.yml fájlhoz. Cserélje le a projektnek megfelelő értékeket. A tevékenységbeállításokról további információt a Maven-tevékenységben talál.

steps:
- task: Maven@4
  inputs:
    mavenPomFile: 'pom.xml'
    mavenOptions: '-Xmx3072m'
    javaHomeOption: 'JDKVersion'
    jdkVersionOption: 'default'
    jdkArchitectureOption: 'x64'
    publishJUnitResults: true
    testResultsFiles: '**/TEST-*.xml'
    goals: 'package'

Spring Boot esetén a Maven-feladatot is használhatja. Győződjön meg arról, hogy az mavenPomFile érték tükrözi a pom.xml fájl elérési útját. Ha például a Spring Boot példatárolót használja, az elérési út a következő complete/pom.xml.

A buildelési útvonal testreszabása

Állítsa be az mavenPomFile értéket, ha a pom.xml fájl nincs az adattár gyökerében. A fájl elérési útja értékének az adattár gyökeréhez kell viszonyítani, például IdentityService/pom.xml vagy $(system.defaultWorkingDirectory)/IdentityService/pom.xml.

A Maven céljainak testreszabása

Állítsa be a célok értékét a Maven által végrehajtandó célok szóközzel elválasztott listájára, például clean package. A Java gyakori fázisairól és céljairól az Apache Maven dokumentációjában olvashat.

Gradle

Gradle-build esetén adja hozzá a következő feladatot a azure-pipelines.yml fájlhoz. Ezekről a lehetőségekről további információt a Gradle-feladatban talál.

steps:
- task: Gradle@3
  inputs:
    workingDirectory: ''
    gradleWrapperFile: 'gradlew'
    gradleOptions: '-Xmx3072m'
    javaHomeOption: 'JDKVersion'
    jdkVersionOption: 'default'
    jdkArchitectureOption: 'x64'
    publishJUnitResults: true
    testResultsFiles: '**/TEST-*.xml'
    tasks: 'build'

Gradle csomagoló

Győződjön meg arról, hogy a gradlew fájl az adattárban van. Ha nem, hozza létre azt a projekt gyökérkönyvtárában, futtassa a következő parancsot: gradle wrapper. A Gradle-burkoló létrehozásáról a Gradle-ben talál további információt.

Válassza ki a Gradle verzióját

Az ügynökgépre telepített Gradle-verziót használja a rendszer, kivéve ha az adattár gradle/wrapper/gradle-wrapper.properties fájlja rendelkezik egy distributionUrl tulajdonsággal, amely másik Gradle-verziót határoz meg letöltésre és használatra az építés során.

A buildelési útvonal módosítása

Állítsa be az workingDirectory értéket, ha a gradlew fájl nincs az adattár gyökerében. A könyvtárértéknek az adattár gyökeréhez kell viszonyítani, például IdentityService vagy $(system.defaultWorkingDirectory)/IdentityService.

Módosítsa az gradleWrapperFile értéket, ha a gradlew fájl nincs az adattár gyökerében. A fájl elérési útja értékének az adattár gyökeréhez kell viszonyítani, például IdentityService/gradlew vagy $(system.defaultWorkingDirectory)/IdentityService/gradlew.

Gradle-tevékenységek módosítása

Módosítsa a végrehajtandó tevékenységek értékét, hogy a Gradle végrehajtsa azokat, például build vagy check. A Gradle gyakori Java plugin feladataival kapcsolatos további információkért tekintse meg a Gradle dokumentációját.

Hangya

Az Ant buildben adja hozzá a következő feladatot a azure-pipelines.yml fájlhoz. Módosítsa a projektkonfigurációnak megfelelő értékeket, például a build.xml fájl elérési útját. Ezekről a lehetőségekről további információt az Ant tevékenységben talál. Ha a mintaadattárat használja, meg kell adnia egy build.xml fájlt az adattárban.

steps:
- task: Ant@1
  inputs:
    workingDirectory: ''
    buildFile: 'build.xml'
    javaHomeOption: 'JDKVersion'
    jdkVersionOption: 'default'
    jdkArchitectureOption: 'x64'
    publishJUnitResults: false
    testResultsFiles: '**/TEST-*.xml'

Szkript

Ha parancssort vagy szkriptet szeretne létrehozni, adja hozzá az alábbi kódrészletek egyikét a azure-pipelines.yml fájlhoz.

Beágyazott szkript

A script: lépés egy beágyazott szkriptet futtat Linuxon és macOS rendszeren Bash-sel, valamint Windows alatt a Parancssorral. Részletekért lásd a Bash vagy a parancssori feladatot.

steps:
- script: |
    echo Starting the build
    mvn package
  displayName: 'Build with Maven'

Szkriptfájl

Ez a feladat futtat egy szkriptfájlt, amely az adattárban található. Részletekért tekintse meg a Shell-szkriptet, a Batch-szkriptet vagy a PowerShell-feladatot.

steps:
- task: ShellScript@2
  inputs:
    scriptPath: 'build.sh'

Következő lépések

Tegye közzé a buildkimenetet a folyamaton. Csomagolja és tegye közzé az alkalmazást Egy Maven-csomagban vagy egy .war/jar fájlban, hogy üzembe helyezze azt egy webalkalmazásban.

További információ a CI/CD-folyamat üzembehelyezési célhoz való létrehozásáról:

• Azure App Service
• Azure Functions
• Azure Kubernetes Service