GitHub Actions での Eclipse Temurin の使用

actions/setup-java アクションは、GitHub Actions ワークフローで Eclipse Temurin をインストールするための推奨方法です。このアクションはランナー上での JDK のダウンロード、キャッシュ、設定を処理します。

基本的な使用方法

ワークフローで Eclipse Temurin をセットアップするには、次のステップを追加します:

Note

これらの例に示されているアクションのバージョンは、常に最新リリースを反映しているわけではありません。最新バージョンについては actions/setup-java リリースおよび actions/checkout リリースを確認してください。Adoptium プロジェクトは、セキュリティと再現性を向上させるために、バージョンタグではなく完全なコミット SHA にアクションをピン留めすることを推奨しています。

steps:
  - uses: actions/checkout@v6
  - uses: actions/setup-java@v5
    with:
      distribution: 'temurin'
      java-version: '25'
  - run: java --version

distributiontemurin に設定し、java-version でインストールするメジャーバージョンを指定します。

複数の Java バージョンに対するテスト

マトリックス戦略を使用して、複数の Java バージョンに対してプロジェクトをテストします:

jobs:
  build:
    runs-on: ubuntu-latest
    strategy:
      matrix:
        java: [ '11', '17', '25' ]
    name: Java ${{ matrix.java }}
    steps:
      - uses: actions/checkout@v6
      - uses: actions/setup-java@v5
        with:
          distribution: 'temurin'
          java-version: ${{ matrix.java }}
      - run: java --version

依存関係のキャッシュ

setup-java アクションには Maven、Gradle、sbt によって管理される依存関係のキャッシュのサポートが組み込まれています。

Maven 依存関係のキャッシュ

steps:
  - uses: actions/checkout@v6
  - uses: actions/setup-java@v5
    with:
      distribution: 'temurin'
      java-version: '25'
      cache: 'maven'
  - run: mvn -B package

Gradle 依存関係のキャッシュ

steps:
  - uses: actions/checkout@v6
  - uses: actions/setup-java@v5
    with:
      distribution: 'temurin'
      java-version: '25'
      cache: 'gradle'
  - run: ./gradlew build

sbt 依存関係のキャッシュ

steps:
  - uses: actions/checkout@v6
  - uses: actions/setup-java@v5
    with:
      distribution: 'temurin'
      java-version: '25'
      cache: 'sbt'
  - run: sbt package

完全なワークフローの例

複数の Java バージョンで Eclipse Temurin を使用して Maven プロジェクトをビルドおよびテストする完全なワークフローを以下に示します:

name: Build and Test

on:
  push:
    branches: [ main ]
  pull_request:
    branches: [ main ]

permissions:
  contents: read

jobs:
  build:
    runs-on: ubuntu-latest
    strategy:
      matrix:
        java: [ '11', '17', '25' ]
    name: Build with Java ${{ matrix.java }}
    steps:
      - uses: actions/checkout@v6
      - name: Set up JDK ${{ matrix.java }}
        uses: actions/setup-java@v5
        with:
          distribution: 'temurin'
          java-version: ${{ matrix.java }}
          cache: 'maven'
      - name: Build with Maven
        run: mvn -B package --file pom.xml

最新バージョンの使用

check-latest: true を設定すると、ランナーにキャッシュされたバージョンではなく、常に最新の利用可能なバージョンをダウンロードします:

- uses: actions/setup-java@v5
  with:
    distribution: 'temurin'
    java-version: '25'
    check-latest: true

Note

check-latesttrue に設定するとパフォーマンスへの影響があります。JDK のダウンロードはキャッシュされたバージョンの使用よりも低速です。

複数の JDK のインストール

1 つのジョブに複数の JDK バージョンをインストールできます。最後に設定されたバージョンが PATH のデフォルトになります:

steps:
  - uses: actions/setup-java@v5
    with:
      distribution: 'temurin'
      java-version: |
        11
        17
        25

他の Java バージョンには JAVA_HOME_11_X64JAVA_HOME_17_X64 などの環境変数を通じてアクセスできます。

edit icon

このドキュメントの改善にご協力ください!

すべてのAdoptiumドキュメントはオープンソースです。誤りや不明な点がありましたらお知らせください。

ドキュメント著者
gdams
Join our Slack channel to discuss and reach out to maintainers.Join Slack