<div id="readability-page-1" class="page"><div id="main" role="main">
 <article>
 <div>
 
 
 <blockquote>
 Github Actions Matrix 사용법과 예제
</blockquote>



<h2 id="환경">환경</h2>

<ul>
 <li>Github Actions</li>
</ul>



<h2 id="배경">배경</h2>

<ul>
 <li>작업은 동일한데 일부 값들만 변경하여 CI/CD를 실행하고 싶은 경우가 있어서 찾아보고 적용하여 정리한다.</li>
 <li>자세한 사용법과 예제는 <a href="https://docs.github.com/actions/writing-workflows/choosing-what-your-workflow-does/using-a-matrix-for-your-jobs">https://docs.github.com/actions/writing-workflows/choosing-what-your-workflow-does/using-a-matrix-for-your-jobs</a>에 나와있다.</li>
</ul>



<h2 id="사용법">사용법</h2>

<ul>
 <li>문서에 나온대로 아래와 같은 방법으로 사용할 수 있다.</li>
 <li><code>jobs.&lt;job_id&gt;.strategy.matrix</code>에 행렬의 변수와 값을 정의해주면 된다.</li>
 <li>아래 예제의 경우 <code>version</code>에 해당하는 값들이 <code>[10, 12, 14]</code>이며 <code>os</code>도 마찬가지이다.</li>
</ul>

<div><pre><code>jobs:
 example_matrix:
 strategy:
 matrix:
 version: [10, 12, 14]
 os: [ubuntu-latest, windows-latest]
</code></pre></div>



<h2 id="예시">예시</h2>

Jekyll 빌드를 여러 OS에서 실행하고 싶은 경우 아래처럼 작성할 수 있다. 실제로 이 블로그에 사용하는 workflow 예제다.

<h3 id="코드">코드</h3>

<ul>
 <li>문서에 나온대로 적용했으며 다른 부분들도 포함되어 있지만 <code>jobs</code>에 있는 <code>build</code> job의 <code>strategy</code>를 보면된다.</li>
 <li><code>os: [ubuntu-22.04, ubuntu-20.04, macos-latest]</code>를 통해 사용할 os를 목록으로 정의했고 <code>runs-on: ${{ matrix.os }}</code>에서 해당 os들을 사용하도록 작성했다.</li>
</ul>

<div><pre><code>name: Jekyll Build CI

on:
 push:
 branches: [ main ]
 pull_request:
 branches: [ main ]
 workflow_dispatch:
 inputs:
 ruby-version:
 required: true
 type: string
 default: "3.2.2"
 
jobs:
 build:
 name: jekyll build
 strategy:
 matrix:
 os: [ubuntu-22.04, ubuntu-20.04, macos-latest]
 fail-fast: false
 runs-on: ${{ matrix.os }}
 steps:
 - name: Checkout Repository
 uses: actions/checkout@v4
 - name: Setup Ruby
 uses: ruby/setup-ruby@v1
 with:
 ruby-version: ${{ github.event.inputs.ruby-version }}
 - name: Install Bundler
 run: |
 gem install bundler
 - name: Install Dependencies
 run: |
 bundle install
 - name: Build Jekyll Site
 run: |
 bundle exec jekyll build
</code></pre></div>

<h3 id="결과">결과</h3>

<ul>
 <li>실행한 결과를 이미지로 보여주는게 이해하기 편해 이미지를 첨부한다</li>
</ul>

<img src="https://twpower.github.io/images/20240811_355/build-result-screenshot.png">




<h2 id="참고자료">참고자료</h2>

<ul>
 <li><a href="https://docs.github.com/actions/writing-workflows/choosing-what-your-workflow-does/using-a-matrix-for-your-jobs">https://docs.github.com/actions/writing-workflows/choosing-what-your-workflow-does/using-a-matrix-for-your-jobs</a></li>
</ul>

 
 
 
 </div>
 
 
 

 </article>
</div></div>

TWpower’s Tech Blog

Github Actions Matrix 사용법과 예제
환경
Github Actions
배경
작업은 동일한데 일부 값들만 변경하여 CI/CD를 실행하고 싶은 경우가 있어서 찾아보고 적용하여 정리한다.
자세한 사용법과 예제는 https://docs.github.com/actions/writing-workflows/choosing-what-your-workflow-does/using-a-matrix-for-your-jobs에 나와있다.
사용법
문서에 나온대로 아래와 같은 방법으로 사용할 수 있다.
jobs.<job_id>.strategy.matrix에 행렬의 변수와 값을 정의해주면 된다.
아래 예제의 경우 version에 해당하는 값들이 [10, 12, 14]이며 os도 마찬가지이다.
jobs:
 example_matrix:
 strategy:
 matrix:
 version: [10, 12, 14]
 os: [ubuntu-latest, windows-latest]
예시
Jekyll 빌드를 여러 OS에서 실행하고 싶은 경우 아래처럼 작성할 수 있다. 실제로 이 블로그에 사용하는 workflow 예제다.
코드
문서에 나온대로 적용했으며 다른 부분들도 포함되어 있지만 jobs에 있는 build job의 strategy를 보면된다.
os: [ubuntu-22.04, ubuntu-20.04, macos-latest]를 통해 사용할 os를 목록으로 정의했고 runs-on: ${{ matrix.os }}에서 해당 os들을 사용하도록 작성했다.
name: Jekyll Build CI
on:
 push:
 branches: [ main ]
 pull_request:
 branches: [ main ]
 workflow_dispatch:
 inputs:
 ruby-version:
 required: true
 type: string
 default: "3.2.2"
 
jobs:
 build:
 name: jekyll build
 strategy:
 matrix:
 os: [ubuntu-22.04, ubuntu-20.04, macos-latest]
 fail-fast: false
 runs-on: ${{ matrix.os }}
 steps:
 - name: Checkout Repository
 uses: actions/checkout@v4
 - name: Setup Ruby
 uses: ruby/setup-ruby@v1
 with:
 ruby-version: ${{ github.event.inputs.ruby-version }}
 - name: Install Bundler
 run: |
 gem install bundler
 - name: Install Dependencies
 run: |
 bundle install
 - name: Build Jekyll Site
 run: |
 bundle exec jekyll build
결과
실행한 결과를 이미지로 보여주는게 이해하기 편해 이미지를 첨부한다
참고자료
https://docs.github.com/actions/writing-workflows/choosing-what-your-workflow-does/using-a-matrix-for-your-jobs

[CI/CD] Github Actions Matrix 사용법과 예제

댓글