GitHub Actions 'Self-hosted Runner' 오류와 해결법

포스팅글올 깃페이지에 올리는데 자꾸 글이 안뜨는 문제가 발생했다

뭐가 문제인가 싶어서 깃 CI/CD를 뒤져보니 빌드가 실패하는 상황

Github Actions 환경에서 CI/CD 파이프라인 관련 문제인것 같아서 찾아봤다

원인

---

자체 호스팅 러너인 current runner(ubuntu-24.04-x64)를 사용 중에

Ruby의 버전이 호환되지 않아서 발생하는 문제로 보인다

Ruby 버전을 업데이트해주면 해결 가능하다고 함

해결법

---

1. jekyll.yml 파일 수정해보기

.github/workflows/jekyll.yml 의 Ruby 버전을 ‘3.1’에서 ‘3.2’로 수정하고,

uses도 uses: ruby/setup-ruby@55283cc23133118229fd3f97f9336ee23a179fcf # v1.146.0에서

uses: ruby/setup-ruby@086ffb1a2090c870a3f881cc91ea83aa4243d408 # v1.195.0로 수정한다

jobs:
  # Build job
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v3
      - name: Setup Ruby
        uses: ruby/setup-ruby@086ffb1a2090c870a3f881cc91ea83aa4243d408 # v1.195.0
        with:
          ruby-version: '3.2' # Not needed with a .ruby-version file
          bundler-cache: true # runs 'bundle install' and caches installed gems automatically
          cache-version: 0 # Increment this number if you need to re-download cached gems
      - name: Setup Pages
        id: pages
        uses: actions/configure-pages@v3
      - name: Build with Jekyll
        # Outputs to the './_site' directory by default
        run: bundle exec jekyll build --baseurl "$"

.github/workflows/pages-deploy.yml.hook 의 버전도 마찬가지로 수정해본다

- name: Setup Ruby
    uses: ruby/setup-ruby@v1
    with:
        ruby-version: 3.2
        bundler-cache: true

이렇게 수정해주니 잘 빌드 된다

내용 추가

---

2025-02-03 기준 빌드 에러가 또 발생했다

ruby/setup-ruby@086ffb1a2090c870a3f881cc91ea83aa4243d408 는 특정 커밋(SHA)를 명시적으로 지정한 것인데

github action이 2025-01-30을 기점으로 v3 지원을 중단과 관련이 있을 가능성이 높다

이를 ruby/setup-ruby@v1으로 수정하여 버전 태그로 지정하면 이 문제를 해결할 수 있다

@v1은 브랜치의 최신 커밋을 사용한다는 뜻인데,

ruby/setup-ruby가 업데이트 되더라도, 최신 변경 사항을 자동으로 반영하도록 설정하는 것임

참조

---

Build error at Setup Ruby, need help

Faild in ubuntu-24.04 runner #595