Java アプリをビルドする

Azure DevOps Services |Azure DevOps Server 2022 および Azure DevOps Server 2019

Azure Pipelines を使用して、Java アプリケーションのビルド、テスト、デプロイを自動化します。 この記事では、Maven、Gradle、Ant などのツールを使用して Java プロジェクトのパイプラインを設定する方法について説明します。 また、App Service、Functions、Kubernetes などの Azure サービスにアプリをデプロイする方法についても説明します。

パイプラインを使用して次の手順を実行します。

• Maven、Gradle、または Ant を使用してプロジェクトをビルドします。
• テストとコード分析ツールを実行します。
• パイプラインと Azure Artifacts を使用してアプリを発行します。
• アプリを Azure App Service、Azure Functions、またはAzure Kubernetes Service にデプロイします。

Android プロジェクトで作業する場合は、「Android アプリのビルド、テスト、デプロイ」を参照してください。

前提条件

GitHub リポジトリを作成する

GitHub アカウントに次のリポジトリをフォークします。

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

パイプラインを作成する

これで、リポジトリで YAML パイプライン (azure-pipelines.yml) が稼働し、カスタマイズできるようになりました。 パイプラインを変更するには、[パイプライン] ページでそのパイプラインを選び、 ファイルを編集しますazure-pipelines.yml。

ビルド環境

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

pool: 
  name: MyPool
  demands: maven

コードをビルドする

Maven、Gradle、Ant、またはスクリプトを使用して Java アプリをビルドできます。 次のセクションでは、各メソッドのビルド ステップをパイプラインに追加する方法について説明します。

メイヴン

Maven ビルドの場合は、 azure-pipelines.yml ファイルに次のタスクを追加します。 プロジェクトに合わせて値を置き換えます。 タスク オプションの詳細については、Maven task を参照してください。

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 の場合は、Maven タスクも使用できます。 mavenPomFile の値が pom.xml ファイルへのパスを反映していることを確認してください。 たとえば、Spring Boot サンプル リポジトリを使用している場合、パスは complete/pom.xml になります。

ビルド パスのカスタマイズ

mavenPomFile ファイルがリポジトリのルートにない場合は、pom.xml値を設定します。 ファイル パスの値は、 IdentityService/pom.xml や $(system.defaultWorkingDirectory)/IdentityService/pom.xmlなど、リポジトリのルートに対する相対パスである必要があります。

Maven の目標のカスタマイズ

goals 値には、Maven が実行する目標のスペース区切りのリストを設定します (たとえば、clean package)。 一般的な Java のフェーズと目標の詳細は、Apache の Maven ドキュメントを参照してください。

Gradle

Gradle ビルドの場合は、 azure-pipelines.yml ファイルに次のタスクを追加します。 該当するオプションの詳細については、Gradle タスクを参照してください。

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

Gradle ラッパー

gradlew ファイルがリポジトリにあることを確認します。 そうでない場合は、プロジェクトのルート ディレクトリで gradle wrapper を実行して生成します。 Gradle ラッパーの作成についての詳細は、Gradle を参照してください。

Gradle のバージョンの選択

エージェント マシンにインストールされた Gradle のバージョンが使用されますが、ビルド時に別の Gradle バージョンをダウンロードして使用するように指定するgradle/wrapper/gradle-wrapper.properties プロパティがリポジトリの distributionUrl ファイルにある場合を除きます。

ビルド パスの調整

workingDirectory ファイルがリポジトリのルートにない場合は、gradlew値を設定します。 ディレクトリの値はリポジトリのルートに相対している必要があります (IdentityService や $(system.defaultWorkingDirectory)/IdentityService など)。

リポジトリのルートに gradleWrapperFile ファイルがない場合は、gradlew の値を調整します。 ファイル パスの値はリポジトリのルートからの相対パスにする必要があります (IdentityService/gradlew や $(system.defaultWorkingDirectory)/IdentityService/gradlew など)。

Gradle タスクの調整する

Gradle で実行する必要のあるタスクの tasks の値を調整します (build や check など)。 一般的な Gradle の Java プラグイン タスクの詳細については、Gradle のドキュメントを参照してください。

蟻

Ant ビルドを使用して、azure-pipelines.yml ファイルに次のタスクを追加します。 プロジェクト構成に一致するように、build.xml ファイルへのパスなどの値を変更します。 該当するオプションの詳細については、Ant タスクを参照してください。 サンプル リポジトリを使用する場合は、リポジトリにbuild.xml ファイルを指定する必要があります。

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

スクリプト

コマンド ラインまたはスクリプトを使用してビルドするには、これらのスニペットのいずれかを azure-pipelines.yml ファイルに追加します。

[インライン スクリプト]

script:の手順では、Bash on Linux と macOS と Windows のコマンド プロンプトを使用してインライン スクリプトを実行します。 詳細については、Bash タスクまたはコマンドライン タスクを参照してください。

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

スクリプト ファイル

このタスクでは、リポジトリ内にあるスクリプト ファイルを実行します。 詳細については、シェル スクリプト タスク、バッチ スクリプト タスク、または PowerShell タスクを参照してください。

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

次のステップ

あなたのビルド出力をパイプラインに配布します。 Maven パッケージまたは .war/jar ファイルにアプリをパッケージ化して発行し、Web アプリケーションにデプロイします。