Vytváření aplikací v Javě

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

Využijte Azure Pipelines k automatizaci sestavení, testování a nasazení aplikací v Javě. Tento článek vysvětluje, jak nastavit kanál pro projekty Java pomocí nástrojů, jako jsou Maven, Gradle nebo Ant. Dozvíte se také, jak nasadit aplikaci do služeb Azure, jako jsou App Service, Functions nebo Kubernetes.

Pomocí pipeline můžete:

• Sestavte projekt pomocí Mavenu, Gradle nebo Antu.
• Spouštění testů a nástrojů pro analýzu kódu
• Publikujte aplikaci pomocí pipeline a Azure Artifacts.
• Nasaďte aplikaci do služby Aplikace Azure Service, Azure Functions nebo Azure Kubernetes Service.

Pokud pracujete na projektech pro Android, přečtěte si téma Sestavení, testování a nasazení aplikací pro Android.

Požadavky

produkt	Požadavky
Azure DevOps	– projekt Azure DevOps. – Možnost spouštět potrubí na Microsoftem hostovaných agentech. Můžete si buď koupit paralelní úlohu, nebo požádat o bezplatnou úroveň. – Základní znalost YAML a Azure Pipelines. Další informace viz Vytvoření první pipeline. - Oprávnění:      – Chcete-li vytvořit pipelinu: Musíte být ve skupině Přispěvatelé a skupina musí mít oprávnění Vytvořit pipelinu sestavení nastaveno na Povolit. Členové skupiny Správci projektů můžou spravovat kanály.     - Chcete-li vytvořit připojení služeb: Musíte mít roli Správce nebo Tvůrce pro připojení služeb .
GitHub	– účet GitHubu. – připojení ke službě GitHub k autorizaci Azure Pipelines.
Azurový	Předplatné služby Azure.

Vytvoření úložiště GitHub

Vytvořte fork následujícího úložiště na svůj účet GitHub.

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

Vytvořit potrubí

1. Přihlaste se ke své organizaci Azure DevOps a přejděte do svého projektu.

2. Přejděte na Kanály a pak vyberte Nový kanál nebo Vytvořit kanál , pokud vytváříte první kanál v projektu.

3. Postupujte podle pokynů průvodce a začněte tím, že jako umístění zdrojového kódu vyberete GitHub . Můžete být přesměrováni na GitHub kvůli přihlášení. Pokud ano, zadejte svoje přihlašovací údaje GitHubu.

4. Vyberte úložiště. K instalaci aplikace Azure Pipelines můžete být přesměrováni na GitHub. Pokud ano, pokračujte výběrem možnosti Schválit a nainstalovat .

5. Když se zobrazí karta Konfigurace kanálu , vyberte Maven, Gradle nebo Ant podle toho, jak chcete vytvořit kód.

6. Ve vašem azure-pipelines.yml úložišti se vytvoří soubor obsahující definici potrubí a tento soubor se otevře v editoru YAML. Kanál můžete přizpůsobit přidáním dalších úloh nebo úpravou existujících úloh. Další informace o úlohách sestavení najdete v tématu Sestavení kódu.

7. Až úpravy azure-pipelines.ymldokončíte, vyberte Uložit a spustit.

8. Chcete-li soubor azure-pipelines.yml potvrdit do svého úložiště, vyberte Uložit a spustit znovu.

Vyberte Úlohu pro sledování vašeho procesu v provozu.

Teď máte v úložišti funkční YAML sestavu azure-pipelines.yml, která je připravená k přizpůsobení. Pokud chcete v kanálu udělat změny, vyberte ho na stránce Pipelines (Kanály ) a pak upravteazure-pipelines.yml soubor.

Sestavení prostředí

Pomocí Azure Pipelines můžete vytvářet aplikace v Javě bez nastavení infrastruktury. Vytvářejte image založené na Windows, Linuxu nebo macOS. Agenti hostovaní Microsoftem v Azure Pipelines mají předinstalované moderní sady JDK a další nástroje pro Javu. Pokud chcete zkontrolovat, které verze Javy jsou nainstalované, podívejte se na agenty hostované Microsoftem.

Aktualizujte následující úryvek ve vašem souboru azure-pipelines.yml výběrem příslušného obrázku.

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

Úplný seznam imagí najdete v agentech hostovaných Microsoftem.

Jako alternativu k agentům hostovaným Microsoftem nastavte agenty v místním prostředí s nainstalovanou javou. Používejte vlastní hostované agenty k úspoře času, pokud máte velké úložiště nebo sestavujete přírůstkově.

Sestavte svůj kód

Aplikaci v Javě můžete sestavit pomocí Mavenu, Gradle, Antu nebo skriptu. Následující části ukazují, jak přidat krok sestavení do pipeline pro jednotlivé metody.

Znalec

Pro sestavení Maven přidejte do azure-pipelines.yml souboru následující úlohy. Nahraďte hodnoty odpovídající projektu. Další informace o možnostech úkolu najdete v úloze Maven.

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

Pro Spring Boot můžete také použít úlohu Maven. Ujistěte se, že hodnota mavenPomFile odpovídá cestě k pom.xml souboru. Pokud například používáte ukázkové úložiště Spring Boot, vaše cesta je .

Přizpůsobte cestu sestavení

mavenPomFile Nastavte hodnotu, pokud pom.xml soubor není v kořenovém adresáři úložiště. Hodnota cesty k souboru musí být relativní vzhledem ke kořenovému adresáři úložiště, například IdentityService/pom.xml nebo $(system.defaultWorkingDirectory)/IdentityService/pom.xml.

Přizpůsobení cílů Mavenu

Nastavte hodnotu cílů na seznam cílů oddělených mezerami, které Má Maven provést, například clean package. Podrobnosti o běžných fázích a cílech Javy najdete v dokumentaci k Apache Mavenu.

Gradle

Pro sestavení Gradle přidejte do azure-pipelines.yml souboru následující úlohu. Další informace o těchto možnostech najdete v úkolu Gradle .

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

Obálka Gradle

Ujistěte se, že gradlew je soubor v úložišti. Pokud ne, vygenerujte ho spuštěním gradle wrapper v kořenovém adresáři projektu. Informace o vytvoření obálky Gradle najdete v gradle.

Vyberte verzi Gradle

Verze Gradle nainstalovaná na počítači agenta se používá, pokud soubor úložiště gradle/wrapper/gradle-wrapper.properties nemá distributionUrl vlastnost, která určuje jinou verzi Gradle ke stažení a použití během sestavení.

Upravit cestu sestavení

workingDirectory Nastavte hodnotu, pokud gradlew soubor není v kořenovém adresáři úložiště. Hodnota adresáře by měla být relativní vzhledem ke kořenovému adresáři úložiště, například IdentityService nebo $(system.defaultWorkingDirectory)/IdentityService.

Upravte hodnotu gradleWrapperFile, je-li váš gradlew soubor není v kořenovém adresáři úložiště. Hodnota cesty k souboru by měla být relativní vzhledem ke kořenovému adresáři úložiště, například IdentityService/gradlew nebo $(system.defaultWorkingDirectory)/IdentityService/gradlew.

Úprava úkolů Gradle

Upravte hodnotu úkolů pro úkoly, které má Gradle provést, například build .check Další informace o běžných úlohách modulu plug-in Java pro Gradle najdete v dokumentaci k Gradle.

Mravenec

Se sestavením Ant přidejte do azure-pipelines.yml souboru následující úlohu. Změňte hodnoty, například cestu k build.xml souboru, aby odpovídaly konfiguraci projektu. Další informace o těchto možnostech najdete v úloze Ant . Pokud používáte ukázkové úložiště, musíte do úložiště zadat build.xml soubor.

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

Skript

Pokud chcete vytvořit příkazový řádek nebo skript, přidejte do souboru jeden z těchto fragmentů azure-pipelines.yml kódu.

Vložený skript

Tento script: krok spustí vložený skript pomocí Bash v Linuxu a macOS a příkazového řádku ve Windows. Podrobnosti najdete v úloze Bash nebo úloze příkazového řádku.

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

Soubor skriptu

Tato úloha spustí soubor skriptu, který je v úložišti. Podrobnosti najdete v úloze Shell Script, Batch script nebo PowerShell.

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

Další kroky

Publikujte výstup sestavení do vaší pipeline. Zabalte a publikujte aplikaci v balíčku Maven nebo v souboru .war/jar a nasaďte ji do webové aplikace.

Další informace o vytvoření CI/CD potrubí pro váš cíl nasazení:

• Azure App Service
• Azure Functions
• Služba Azure Kubernetes