JenkinsからGitHub Actionsへの移行: 手順ごとのガイド
最終更新
Jenkins から GitHub Actions への移行では、Jenkinsfile をワークフローの YAML に変換します。ステージはジョブまたはステップになり、agent は runs-on になり、認証情報はシークレットになり、共有ライブラリはコンポジットアクションまたは再利用可能なワークフローになります。宣言型パイプラインは比較的容易に変換できます。一方、Groovy によるロジックが多いスクリプト型パイプラインは、時間がかかる部分です。本ガイドでは、対応関係、変換の具体例、エージェントとプラグインの扱い、そして切り替えの計画について説明します。
関連ページ: Jenkins と GitHub Actions の比較、Jenkins の代替ツール。
概念の対応関係
| Jenkins | GitHub Actions |
|---|---|
Jenkinsfile | .github/workflows/*.yml |
| マルチブランチパイプライン | ワークフロー on: push / pull_request(ブランチごとに自動実行) |
agent { label 'x' } | runs-on: [label] |
agent { docker { image 'x' } } | ジョブ上の container: x |
stages / stage | jobs(デフォルトで並列)または逐次の steps |
parallel { } | 個別のジョブ、または matrix |
steps { sh '...' } | steps: - run: ... |
environment { } | ワークフロー、ジョブ、ステップの各レベルの env: |
credentials('id') | ${{ secrets.NAME }} |
when { branch 'main' } | if: github.ref == 'refs/heads/main' |
post { always { } } | if: always() を指定したステップ |
stash / unstash, archiveArtifacts | actions/upload-artifact / download-artifact |
input(手動承認) | 必須レビュアーを設定した環境 |
triggers { cron() } | on.schedule |
parameters { } | workflow_dispatch.inputs |
| 共有ライブラリ | コンポジットアクション、再利用可能なワークフロー |
| プラグイン | Marketplace のアクション、または通常のスクリプト |
| Jenkins コントローラーとエージェント | GitHub ホステッドランナー、または セルフホステッドランナー |
| ワークスペースはエージェント上に保持される | キャッシュを使わない限り、ジョブごとに新しい VM が使われる。永続ランナーを使う場合は除く |
最後の行は、多くの人が意外に感じる点です。Jenkins のエージェントは、ビルド間でワークスペース、Maven リポジトリ、Docker レイヤーを保持することが一般的です。一方、GitHub のホステッドランナーはジョブごとに空の状態から始まるため、速度を取り戻すには明示的にキャッシュを設定する必要があります。
実際のパイプラインの比較
Java サービス向けの宣言型 Jenkinsfile の例:
pipeline {
agent { label 'linux' }
options { timeout(time: 30, unit: 'MINUTES') }
environment {
REGISTRY = 'registry.example.com'
DEPLOY_KEY = credentials('deploy-key')
}
stages {
stage('Build') {
steps { sh './gradlew assemble' }
}
stage('Test') {
parallel {
stage('Unit') { steps { sh './gradlew test' } }
stage('Integration') { steps { sh './gradlew integrationTest' } }
}
post { always { junit '**/build/test-results/**/*.xml' } }
}
stage('Deploy') {
when { branch 'main' }
steps { sh './scripts/deploy.sh' }
}
}
post { failure { mail to: 'team@example.com', subject: 'Build failed' } }
}
GitHub Actions 版:
name: CI
on:
push:
branches: [main]
pull_request:
env:
REGISTRY: registry.example.com
jobs:
build:
runs-on: ubuntu-latest # or [self-hosted, Linux, compiler-ci]
timeout-minutes: 30
steps:
- uses: actions/checkout@v6
- uses: actions/setup-java@v5
with:
distribution: temurin
java-version: 21
- uses: gradle/actions/setup-gradle@v6
- run: ./gradlew assemble
test:
needs: build
runs-on: ubuntu-latest
timeout-minutes: 30
strategy:
fail-fast: false
matrix:
task: [test, integrationTest]
steps:
- uses: actions/checkout@v6
- uses: actions/setup-java@v5
with:
distribution: temurin
java-version: 21
- uses: gradle/actions/setup-gradle@v6
- run: ./gradlew ${{ matrix.task }}
- uses: actions/upload-artifact@v4
if: always()
with:
name: results-${{ matrix.task }}
path: "**/build/test-results/**/*.xml"
deploy:
needs: test
if: github.ref == 'refs/heads/main' && github.event_name == 'push'
runs-on: ubuntu-latest
environment: production
steps:
- uses: actions/checkout@v6
- run: ./scripts/deploy.sh
env:
DEPLOY_KEY: ${{ secrets.DEPLOY_KEY }}
変換に関する補足:
- GitHub の各ジョブは新しいマシン上で実行されるため、
buildとtestはワークスペースを共有しません。各ジョブで再ビルドするか(Gradle キャッシュを使えば低コストです)、アーティファクトで出力を受け渡してください。buildをテストジョブにまとめる方が簡単な場合も多くあります。 parallelステージは、マトリックスまたは個別のジョブになります。マトリックスビルドを参照してください。post { failure { mail } }は、if: failure()を使った通知ステップになります。または、GitHub に組み込まれたワークフロー失敗時の通知を利用することもできます。credentials('deploy-key')はシークレットになります。リポジトリ、Organization、または環境に作成してください。when { branch 'main' }はif:の条件になります。手動承認が必要な場合は、production環境に必須のレビュアーを追加してください。- テスト結果はアーティファクトとしてアップロードされます。プルリクエスト内にサマリーを表示するには、JUnit レポーターのアクションを使用してください。
エージェント、ラベル、セルフホスティング
多くの Jenkins 利用者は、プライベートネットワークへのアクセス、特殊なハードウェア、またはコストといった理由から、独自のエージェントを運用しています。GitHub Actions は、ラベル付きのセルフホストランナーに対応しており、Jenkins のラベルに対応させることができます。ホステッドランナーは、トンネルや、OIDC と公開エンドポイントを組み合わせた方法などを使わない限り、プライベートネットワークに到達できません。プライベートアクセスが必要な場合は、セルフホストランナーを計画し、セキュリティに関する注意事項を確認してください。信頼できないフォークのコードを、長期間稼働するランナー上で実行しないようにしてください。
GitHub ホステッドランナーに移行したあと、ビルドが Jenkins エージェントより遅くなった場合、原因は通常、既定の 2 vCPU 構成とキャッシュが空の状態にあることです。compiler.dev では、同じジョブを 8 vCPU / 16 GB のマシンで実行し、依存関係キャッシュと Docker レイヤーキャッシュを事前に用意しています。料金は 1 分あたり $0.008 です。runs-on: [self-hosted, Linux, compiler-ci] で指定でき、元のランナーへの自動フォールバックも利用できます。詳細は料金と高速ランナーをご覧ください。
プラグイン
インストール済みのプラグインを監査し、次の 3 つのグループに分類してください。
- 組み込みまたはマーケットプレイスのアクションに置き換える(SCM、JUnit、Slack 通知、認証情報、アーティファクトのアーカイブ)。
- スクリプトに置き換える(CLI をラップしていたもの)。
- 代替なし(Jenkins UI を拡張する稀なプラグイン)。引き続き必要かどうかを判断してください。
採用前にマーケットプレイスのアクションを確認してください。サードパーティのアクションは、GitHub Actions のセキュリティ強化で説明しているとおり、コミット SHA でピン留めしてください。
認証情報とシークレット
Jenkins は認証情報をコントローラーに保存しており、UI からシークレットの値をエクスポートすることはできません。パスワードマネージャーやボールトから取得し、GitHub のシークレットとして追加してください。可能な場合は、長期間有効なクラウドのキーを OIDC に置き換えてください。詳しくはAWS との GitHub Actions OIDCをご覧ください。コントローラーのグローバルスコープにあるシークレットは Organization シークレットに、フォルダー単位の認証情報はリポジトリまたは環境のシークレットになります。
キャッシュ
Jenkins のエージェントは、長期間稼働することでキャッシュされることが多くあります。Actions では、キャッシュを明示的に追加してください。
- Gradle:cache-gradle-github-actions(上記の
setup-gradleアクションが対応しています)。 - npm、pnpm、Yarn: npm、pnpm、Yarn。
- Docker:Docker レイヤーキャッシュとbuildx キャッシュ。
- 一般的なルールと 10 GB の上限については、キャッシュガイドをご覧ください。
自動変換:GitHub Actions Importer
GitHub の Importer は gh 拡張機能です。GitHub の公式ドキュメント(2026 年 10 月時点で確認)によると、Jenkins、CircleCI、GitLab CI、Azure DevOps、Bamboo、Bitbucket Pipelines、Travis CI に対応しており、Docker と GitHub CLI が必要です。
gh extension install github/gh-actions-importer
gh actions-importer configure
gh actions-importer audit jenkins --output-dir audit --source-url https://jenkins.example.com
ドキュメントに記載されているコマンドは audit、forecast、dry-run、migrate です。まず、Jenkins サーバーに対して audit を実行し、変換可能な項目と変換できない項目のレポートを確認してください。その後、dry-run でローカルにワークフローを書き出してください。共有ライブラリ、カスタムの Groovy コード、プラグイン固有のステップは、手作業で変換する必要があることを想定してください。Jenkins 向けの正確なフラグについては、GitHub の Importer の最新ドキュメントを確認してください。認証情報や URL の渡し方は、他のプラットフォームとは異なります。
切り替え計画
- インベントリ作成:ジョブ、プラグイン、認証情報、トリガー、および各ジョブへの依存関係を整理します。
- 監査:Importer で監査し、最もシンプルなパイプラインから着手します。
- 移植と並行稼働:1〜2 週間、Jenkins と並行して実行します。
- 認証情報の移行とデプロイステージの移行。
- 必須チェックの切り替え:ブランチ保護で設定を変更します。
- Jenkins ジョブの凍結(読み取り専用):履歴のため、リリースサイクル 1 回分はコントローラーを残し、その後に廃止します。
よくある質問
GitHub Actions で Jenkins を完全に置き換えることはできますか。
多くのビルド、テスト、デプロイのパイプラインについては、置き換え可能です。代替のないプラグインに依存している場合や、コントローラーレベルの機能が必要な場合は、Jenkins を残してください。
Jenkins の共有ライブラリはどのように置き換えればよいですか。
再利用可能なステップにはコンポジットアクションを、パイプライン全体にはワークフローの再利用を使用してください。Groovy のロジックは、シェルや小さなスクリプトに変換してください。
プライベートネットワーク上の Jenkins エージェントはどうすればよいですか。
そのネットワーク内に、対応するラベルを付けたセルフホストランナーを用意してください。
Jenkins のワークスペースの永続化は問題になりますか。
問題になることがあります。残っているファイルに頼るのではなく、キャッシュを追加するか、キャッシュを温かく保てるランナーを使用してください。
移行にはどのくらいの時間がかかりますか。
シンプルな宣言的パイプラインであれば数時間です。スクリプト形式のパイプラインやプラグインが数十個ある場合は、主に検証に時間がかかるため、数週間を見込んでください。
関連記事
- CircleCI から GitHub Actions への移行: ステップごとの手順概念の対応表、設定の並列比較、シークレット、キャッシュ、Importer、切り替え計画を使って、CircleCI から GitHub Actions へ移行します。
- GitLab CI から GitHub Actions への移行: ステップごとの手順.gitlab-ci.yml の対応表、並列比較による変換、変数、キャッシュ、サービス、Importer、切り替えを使って、GitLab CI から GitHub Actions へ移行します。
- Jenkins と compiler.dev ランナーを使った GitHub Actions の比較compiler.dev のランナーで見る Jenkins と GitHub Actions: ライセンス費用ゼロと実際の運用コスト、プラグインの柔軟性、Jenkinsfile からワークフローへの移行
- 2026年の Jenkins 代替ツール おすすめ2026年のおすすめ Jenkins 代替ツール: GitHub Actions、GitLab CI、Buildkite、CircleCI、Semaphore、compiler.dev。Jenkinsfile からの移行に関する注意点も紹介します。