{"meta":{"title":"Jenkins から GitHub Actions への移行","intro":"GitHub Actions と Jenkins は複数の類似点を共有しているため、 GitHub Actions への移行は比較的簡単です。","product":"GitHub Actions","breadcrumbs":[{"href":"/ja/actions","title":"GitHub Actions"},{"href":"/ja/actions/tutorials","title":"チュートリアル"},{"href":"/ja/actions/tutorials/migrate-to-github-actions","title":"GitHub Actions に移行する"},{"href":"/ja/actions/tutorials/migrate-to-github-actions/manual-migrations","title":"手動移行"},{"href":"/ja/actions/tutorials/migrate-to-github-actions/manual-migrations/migrate-from-jenkins","title":"Jenkins からの移行"}],"documentType":"article"},"body":"# Jenkins から GitHub Actions への移行\n\nGitHub Actions と Jenkins は複数の類似点を共有しているため、 GitHub Actions への移行は比較的簡単です。\n\n## はじめに\n\nJenkins と GitHub Actions の両方を使用すると、コードを自動的にビルド、テスト、発行、リリース、デプロイするワークフローを作成できます。 Jenkins と GitHub Actions は、ワークフロー構成でいくつかの類似点を共有します。\n\n* Jenkins は、\\_\\_ ワークフロー ファイルに似たGitHub Actionsを使用してワークフローを作成します。\n* Jenkins では *ステージ* を使用して一連のステップを実行し、 GitHub Actions はジョブを使用して 1 つ以上のステップまたは個々のコマンドをグループ化します。\n* Jenkins と GitHub Actions では、コンテナー ベースのビルドがサポートされます。 詳しくは、「[Docker コンテナーのアクションを作成する](/ja/actions/tutorials/use-containerized-services/create-a-docker-container-action)」をご覧ください。\n* ステップもしくはタスクは、再利用とコミュニティとの共有が可能です。\n\n詳しくは、「[GitHub Actionsについて](/ja/actions/get-started/understand-github-actions)」をご覧ください。\n\n## 主要な相違点\n\n* Jenkinsには、パイプラインの作成用の構文として、宣言的パイプラインとスクリプトパイプラインの2種類があります。\n  GitHub Actions は YAML を使用してワークフローと構成ファイルを作成します。 詳しくは、「[GitHub Actions　のワークフロー構文](/ja/actions/reference/workflows-and-actions/workflow-syntax)」をご覧ください。\n* Jenkinsのデプロイメントは通常セルフホストであり、ユーザが自身のデータセンター内のサーバーをメンテナンスします。\n  GitHub Actions は、ジョブの実行に使用できる独自のランナーをホストし、セルフホステッド ランナーもサポートすることで、ハイブリッド クラウド アプローチを提供します。 詳しくは、「[セルフホステッド ランナー](/ja/actions/concepts/runners/self-hosted-runners)」をご覧ください。\n\n## 機能の比較\n\n### ビルドの配布\n\nJenkinsでは、ビルドを単一のビルドエージェントに送信することも、複数のエージェントに対して分配することもできます。 それらのエージェントを、オペレーティングシステムの種類などの様々な属性に従って分類することもできます。\n\n同様に、 GitHub Actions は GitHubホスト型ランナーまたはセルフホステッド ランナーにジョブを送信でき、ラベルを使用してさまざまな属性に従ってランナーを分類できます。 詳細については、「[GitHub Actionsについて](/ja/actions/get-started/understand-github-actions#runners)」および「[セルフホステッド ランナー](/ja/actions/concepts/runners/self-hosted-runners)」を参照してください。\n\n### セクションによるパイプラインの整理\n\nJenkinsは、宣言的パイプラインを複数のセクションに分割します。 同様に、 GitHub Actions はワークフローを別々のセクションに編成します。 次の表は、Jenkins セクションと GitHub Actions ワークフローを比較したものです。\n\n| Jenkinsのディレクティブ                                                 | GitHub Actions                                                                                                                                                                                                             |\n| --------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| [`agent`](https://jenkins.io/doc/book/pipeline/syntax/#agent)   | [`jobs.<job_id>.runs-on`](/ja/actions/reference/workflows-and-actions/workflow-syntax#jobsjob_idruns-on) <br> [`jobs.<job_id>.container`](/ja/actions/reference/workflows-and-actions/workflow-syntax#jobsjob_idcontainer) |\n| [`post`](https://jenkins.io/doc/book/pipeline/syntax/#post)     | なし                                                                                                                                                                                                                         |\n| [`stages`](https://jenkins.io/doc/book/pipeline/syntax/#stages) | [`jobs`](/ja/actions/reference/workflows-and-actions/workflow-syntax#jobs)                                                                                                                                                 |\n| [`steps`](https://jenkins.io/doc/book/pipeline/syntax/#steps)   | [`jobs.<job_id>.steps`](/ja/actions/reference/workflows-and-actions/workflow-syntax#jobsjob_idsteps)                                                                                                                       |\n\n## ディレクティブの使用\n\nJenkins では、*宣言的パイプライン* を管理するためにディレクティブを使います。 それらのディレクティブは、ワークフローの特徴と、その実行方法を定義します。 次の表は、これらのディレクティブが GitHub Actions内の概念にどのようにマップされるかを示しています。\n\n| Jenkinsのディレクティブ                                                                                                       | GitHub Actions                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |\n| --------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| [`environment`](https://jenkins.io/doc/book/pipeline/syntax/#environment)                                             | [`jobs.<job_id>.env`](/ja/actions/reference/workflows-and-actions/workflow-syntax#env) <br> [`jobs.<job_id>.steps[*].env`](/ja/actions/reference/workflows-and-actions/workflow-syntax#jobsjob_idstepsenv)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |\n| [`options`](https://jenkins.io/doc/book/pipeline/syntax/#options)                                                     | [`jobs.<job_id>.strategy`](/ja/actions/reference/workflows-and-actions/workflow-syntax#jobsjob_idstrategy) <br> [`jobs.<job_id>.strategy.fail-fast`](/ja/actions/reference/workflows-and-actions/workflow-syntax#jobsjob_idstrategyfail-fast) <br> [`jobs.<job_id>.timeout-minutes`](/ja/actions/reference/workflows-and-actions/workflow-syntax#jobsjob_idtimeout-minutes)                                                                                                                                                                                                                                                                                                                       |\n| [`parameters`](https://jenkins.io/doc/book/pipeline/syntax/#options)                                                  | [`inputs`](/ja/actions/reference/workflows-and-actions/metadata-syntax#inputs) <br> [`outputs`](/ja/actions/reference/workflows-and-actions/metadata-syntax#outputs-for-docker-container-and-javascript-actions)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |\n| [`triggers`](https://jenkins.io/doc/book/pipeline/syntax/#triggers)                                                   | [`on`](/ja/actions/reference/workflows-and-actions/workflow-syntax#on) <br> [`on.<event_name>.types`](/ja/actions/reference/workflows-and-actions/workflow-syntax#onevent_nametypes) <br> [<code>on.\\<push>.\\<branches\\|tags></code>](/ja/actions/reference/workflows-and-actions/workflow-syntax#onpushbranchestagsbranches-ignoretags-ignore) <br> [<code>on.\\<pull\\_request>.\\<branches></code>](/ja/actions/reference/workflows-and-actions/workflow-syntax#onpull_requestpull_request_targetbranchesbranches-ignore) <br> [<code>on.\\<push\\|pull\\_request>.paths</code>](/ja/actions/reference/workflows-and-actions/workflow-syntax#onpushpull_requestpull_request_targetpathspaths-ignore) |\n| [`triggers { upstreamprojects() }`](https://jenkins.io/doc/book/pipeline/syntax/#triggers)                            | [`jobs.<job_id>.needs`](/ja/actions/reference/workflows-and-actions/workflow-syntax#jobsjob_idneeds)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |\n| [Jenkins の cron 構文](https://jenkins.io/doc/book/pipeline/syntax/#cron-syntax)                                         | [`on.schedule`](/ja/actions/reference/workflows-and-actions/workflow-syntax#onschedule)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |\n| [`stage`](https://jenkins.io/doc/book/pipeline/syntax/#stage)                                                         | [`jobs.<job_id>`](/ja/actions/reference/workflows-and-actions/workflow-syntax#jobsjob_id) <br> [`jobs.<job_id>.name`](/ja/actions/reference/workflows-and-actions/workflow-syntax#jobsjob_idname)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |\n| [`tools`](https://jenkins.io/doc/book/pipeline/syntax/#tools)                                                         |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |\n| \\[                                                                                                                    |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |\n| GitHub ホステッド ランナーの仕様]\\(/actions/concepts/runners/github-hosted-runners#preinstalled-software-for-github-owned-images) |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |\n| [`input`](https://jenkins.io/doc/book/pipeline/syntax/#input)                                                         | [`inputs`](/ja/actions/reference/workflows-and-actions/metadata-syntax#inputs)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |\n| [`when`](https://jenkins.io/doc/book/pipeline/syntax/#when)                                                           | [`jobs.<job_id>.if`](/ja/actions/reference/workflows-and-actions/workflow-syntax#jobsjob_idif)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |\n\n## 連続段階の利用\n\n### 並列なジョブの処理\n\nJenkins では、 `stages` と `steps` を並列で実行できます。\nGitHub Actions はジョブを並列で実行し、ステップ レベルの構文を使用してジョブ内で同時にステップを実行することもできます。 詳細については、「 [GitHub Actions　のワークフロー構文](/ja/actions/reference/workflows-and-actions/workflow-syntax#jobsjob_idstepsbackground).\n\n| Jenkinsの並列処理                                                        | GitHub Actions                                                                                                                      |\n| ------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |\n| [`parallel`](https://jenkins.io/doc/book/pipeline/syntax/#parallel) | [`jobs.<job_id>.strategy.max-parallel`](/ja/actions/reference/workflows-and-actions/workflow-syntax#jobsjob_idstrategymax-parallel) |\n\n### Matrix\n\nGitHub Actionsと Jenkins の両方で、マトリックスを使用してさまざまなシステムの組み合わせを定義できます。\n\n| Jenkins                                                                  | GitHub Actions                                                                                                                                                                                      |\n| ------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| [`axis`](https://jenkins.io/doc/book/pipeline/syntax/#matrix-axes)       | [`strategy/matrix`](/ja/actions/how-tos/write-workflows/choose-what-workflows-do/run-job-variations#about-matrix-strategies) <br> [`context`](/ja/actions/reference/workflows-and-actions/contexts) |\n| [`stages`](https://jenkins.io/doc/book/pipeline/syntax/#matrix-stages)   | [`steps-context`](/ja/actions/reference/workflows-and-actions/contexts#steps-context)                                                                                                               |\n| [`excludes`](https://jenkins.io/doc/book/pipeline/syntax/#matrix-stages) | なし                                                                                                                                                                                                  |\n\n### ステップを使ったタスクの実行\n\nJenkins は `steps` で `stages` をグループ化します。 それらの各ステップは、スクリプト、関数、コマンドなどです。 同様に、 GitHub Actions では、 `jobs` を使用して特定のグループの `steps`を実行します。\n\n| Jenkins                                                       | GitHub Actions                                                                                       |\n| ------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |\n| [`steps`](https://jenkins.io/doc/book/pipeline/syntax/#steps) | [`jobs.<job_id>.steps`](/ja/actions/reference/workflows-and-actions/workflow-syntax#jobsjob_idsteps) |\n\n## 一般的なタスクの例\n\n### `cron` で実行するパイプラインのスケジュール設定\n\n#### `cron` を含む Jenkins パイプライン\n\n```yaml\npipeline {\n  agent any\n  triggers {\n    cron('H/15 * * * 1-5')\n  }\n}\n```\n\n#### GitHub Actions`cron` を使用したワークフロー\n\n```yaml\non:\n  schedule:\n    - cron: '*/15 * * * 1-5'\n```\n\n`schedule` イベントと使用できる cron 構文の詳細については、「[ワークフローをトリガーするイベント](/ja/actions/reference/workflows-and-actions/events-that-trigger-workflows#schedule)」を参照してください。\n\n### パイプライン中での環境変数の設定\n\n#### 環境変数を含む Jenkins パイプライン\n\n```yaml\npipeline {\n  agent any\n  environment {\n    MAVEN_PATH = '/usr/local/maven'\n  }\n}\n```\n\n#### GitHub Actions 環境変数を含むワークフロー\n\n```yaml\njobs:\n  maven-build:\n    env:\n      MAVEN_PATH: '/usr/local/maven'\n```\n\n### 上流プロジェクトからの構築\n\n#### 上流のプロジェクトからビルドされる Jenkins パイプライン\n\n```yaml\npipeline {\n  triggers {\n    upstream(\n      upstreamProjects: 'job1,job2',\n      threshold: hudson.model.Result.SUCCESS\n    )\n  }\n}\n```\n\n#### GitHub Actions アップストリーム プロジェクトからビルドするワークフロー\n\n```yaml\njobs:\n  job1:\n  job2:\n    needs: job1\n  job3:\n    needs: [job1, job2]\n```\n\n### 複数のオペレーティングシステムでのビルド\n\n#### 複数のオペレーティング システムでビルドされる Jenkins パイプライン\n\n```yaml\npipeline {\n  agent none\n  stages {\n    stage('Run Tests') {\n      matrix {\n        axes {\n          axis {\n            name: 'PLATFORM'\n            values: 'macos', 'linux'\n          }\n        }\n        agent { label \"${PLATFORM}\" }\n        stages {\n          stage('test') {\n            tools { nodejs \"node-20\" }\n            steps {\n              dir(\"scripts/myapp\") {\n                sh(script: \"npm install -g bats\")\n                sh(script: \"bats tests\")\n              }\n            }\n          }\n        }\n      }\n    }\n  }\n}\n```\n\n#### GitHub Actions 複数のオペレーティング システムを使用してビルドするワークフロー\n\n```yaml\nname: demo-workflow\non:\n  push:\njobs:\n  test:\n    runs-on: ${{ matrix.os }}\n    strategy:\n      fail-fast: false\n      matrix:\n        os: [macos-latest, ubuntu-latest]\n    steps:\n      - uses: actions/checkout@v6\n      - uses: actions/setup-node@v7\n        with:\n          node-version: 20\n      - run: npm install -g bats\n      - run: bats tests\n        working-directory: ./scripts/myapp\n```"}