GitHub Action, upload-artifact v3 오류 해결법
1. 원인
깃 페이지를 관리하던 중, 2025년 1월 30일 이후로 글이 올라가지 않는 문제가 발생했다
깃허브의 CI/CD를 확인해보니 빌드에서 실패가 발생하는 것을 확인
Error: This request has been automatically failed because it uses a deprecated version of
actions/upload-artifact: v3.
Learn more: https://github.blog/changelog/2024-04-16-deprecation-notice-v3-of-the-artifact-actions/
에러 로그를 보니 Github Actions 에서
actions/upload-artifact@v3 또는 actions/download-artifact@v3 버전이
더 이상 지원되지 않아 발생하는 문제라고 한다
에러 로그의 링크를 보면 v3 아티팩트 작업이 왜 중단되었는지 자세히 설명되어있다
v4로 업데이트 하면서, 업로드 및 다운로드 속도를 개선했고 여러 새로 기능들을 추가했다고 함
Github Actions
Github 저장소에서 자동화된 워크플로우를 실행할 수 있는 CI/CD 도구
코드가 변경될 때 마다 자동으로 빌드, 테스트, 배포 등의 작업을 수행한다
upload-artifact, download-artifact
여기서 말하는 artifact는 워크플로우 실행 중 생성된 파일들(빌드 결과물, 로그 파일)을 의미한다
actions/upload-artifact는 이를 업로드하는 것이고
actions/download-artifact는 업로드되어있는 아티팩트를 가져와 활용하는 것이다
보통 글을 작성하여 업로드할때만 사용하지만, 둘 다 지원 종료했다니 모두 업데이트 해줘야 한다
나는 Chirpy 테마를 사용해서 GitPage를 관리하고 있는데,
이 중 자동으로 빌드, 배포해주는 과정에 Github actions를 사용하는 과정이 있었다
테마를 별도로 업데이트하지 않고 계속 사용하다보니 지원중단 문제가 발생 한 것
2. 해결 방법 : actions@v3 업데이트
먼저, 빌드와 배포를 담당하는 .github\workflow 폴더에서 CI/CD와 관련된 파일을 찾는다
그 중에서 artifact 키워드로 검색하면 나오는 파일을 수정한다
꽤 오래전 Chirpy 테마를 사용하고 있어서 jekyll.yml 파일에서 찾을 수 있었다
최근 버전에서는 starter\pages-deploy.yml 에 있는 모양
그 파일 내에서 다음 변수들을 새 값으로 수정한다
| Old value | New value |
|---|---|
actions/cache@v3 | actions/cache@v4 |
actions/configure-pages@v3 | actions/configure-pages@v5 |
actions/deploy-pages@v2 | actions/deploy-pages@v4 |
actions/upload-pages-artifact@v2 | actions/upload-pages-artifact@v3 |
peaceiris/actions-hugo@v2 | peaceiris/actions-hugo@v3 |
- Setup Pages 의
actions/configure-pages@v3를actions/configure-pages@v5로 - Upload artifact의
actions/upload-pages-artifact@v2를actions/upload-pages-artifact@v3로 - 배포의 Deploy to Github Pages의
actions/deploy-pages@v2를actions/deploy-pages@v4로
배포 결과 성공!
3. 앞으로 어떻게??
블로그가 아닌 gitpage를 운영하기로 했을때 부터 어느정도 예상하고 있었지만
직접 배포까지 관리하려니 골치가 아팠다
또한 Chirpy 테마가 gitpage 개설 시 복사해온 버전 그대로 쓰고있어서
앞으로 계속 이런 문제가 터질것 같은데
일단은 Chirpy 테마를 최신버전으로 업데이트 하고,
어떻게 할 지 고려해봐야겠다
만약 테마 자체가 업데이트가 중단된다면, 진짜 골치아파질 것 같다