Vytváření aplikací v Javě

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

Kanál můžete použít k automatickému:

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

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

Požadavky

Pokud chcete spustit následující příklad, musíte mít:

• Účet GitHubu, kde můžete vytvořit úložiště. Vytvořte si ho zdarma.
• Organizace Azure DevOps. Vytvořte si ho zdarma.
• Projekt Azure DevOps. Pokud ho nemáte, vytvořte projekt .

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

Na účet GitHubu forkujte následující úložiště:

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

Vytvořit kanál

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. Kroky průvodce proveďte tak, že nejprve vyberete GitHub jako umístění zdrojového kódu. 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, vyberte 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. V azure-pipelines.yml úložišti se vytvoří soubor obsahující definici kanálu a otevře se 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. Pokud chcete soubor potvrdit azure-pipelines.yml do úložiště, vyberte Uložit a spusťte znovu.

Vyberte Úlohu a sledujte kanál v akci.

Teď máte v úložišti funkční kanál YAML,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 upravte azure-pipelines.yml soubor.

Sestavení prostředí

Azure Pipelines můžete použít k vytváření aplikací v Javě, aniž byste museli nastavovat vlastní infrastrukturu. Můžete sestavovat na imagích windows, Linuxu nebo macOS. Agenti hostovaní Microsoftem v Azure Pipelines mají předinstalované moderní sady JDK a další nástroje pro Javu. Informace o nainstalovaných verzích Javy najdete v tématu Agenti hostovaní Microsoftem.

Pokud chcete vybrat příslušný obrázek, aktualizujte azure-pipelines.yml v souboru následující fragment kódu.

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

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

Jako alternativu k používání agentů hostovaných Microsoftem můžete nastavit agenty v místním prostředí s nainstalovanou javou. Pokud máte velké úložiště nebo spouštíte přírůstkové sestavení, můžete také využít agenty v místním prostředí, abyste ušetřili více času.

Sestavení kódu

Aplikaci v Javě můžete sestavit pomocí Mavenu, Gradle, Antu nebo skriptu. Následující části ukazují, jak přidat krok sestavení do kanálu pro každou metodu.

Maven

Při sestavení Mavenu se do azure-pipelines.yml souboru přidají 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 použít také ú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, cesta je complete/pom.xml.

Přizpůsobení cesty sestavení

mavenPomFile Upravte hodnotu, pokud pom.xml 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/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

Při sestavení Gradle se do azure-pipelines.yml souboru přidá následující úloha. Další informace o těchto možnostech najdete v úkolu Gradle .

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

Obálka Gradle

V úložišti musíte mít gradlew soubor. Pokud ho nemáte, můžete ho vygenerovat spuštěním gradle wrapper v kořenovém adresáři projektu. Informace o vytvoření obálky Gradle najdete v gradle.

Volba verze 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í.

Úprava cesty sestavení

workingDirectory Upravte 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.

gradleWrapperFile Upravte hodnotu, pokud 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.

Ant

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 azure-pipelines.yml souboru jeden z následujících fragmentů kódu.

Vložený skript

Tento script: krok spustí vložený skript pomocí Bash v Linuxu a macOS a příkazovém řádku ve Windows. Podrobnosti najdete v úloze Bash nebo 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 nebo PowerShellu.

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

Další kroky

Výstup sestavení můžete publikovat do kanálu. Aplikaci můžete zabalit a publikovat v balíčku Maven nebo v souboru .war/jar , který se má nasadit do webové aplikace.

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

• Azure App Service
• Azure Functions
• Azure Kubernetes Service