
GitHub Actions에서 uvx를 캐시 친화적으로 사용하는 방법
요약
본 글은 GitHub Actions 워크플로우에서 `uvx tool-name`을 캐시 친화적으로 사용하는 방법을 제시합니다. 핵심은 특정 날짜를 환경 변수(`UV_EXCLUDE_NEWER`)로 설정하고 이를 캐시 키에 포함하여, 매번 PyPI 접속 및 의존성 다운로드를 방지하는 것입니다.
핵심 포인트
- GitHub Actions에서 uvx 사용 시 캐싱 최적화 방법 제시
- 환경 변수 UV_EXCLUDE_NEWER를 활용하여 날짜 기반 캐시 무효화 가능
- PyPI 재접속을 막아 워크플로우 실행 속도 및 효율성 향상
2026년 7월 14일

저는 GitHub Actions 워크플로우에서 uvx tool-name을 사용할 수 있는, 마음에 드는 캐시 친화적인 방법을 찾았습니다.
핵심은 워크플로우 시작 부분에 UV_EXCLUDE_NEWER: "2026-07-12" 환경 변수를 설정하고, 이를 GitHub Actions 캐시 키의 일부로 사용하는 것입니다. 이 방법은 모든 uvx tool-name 명령이 해당 날짜 기준 가장 최신 버전으로 해결되도록 하며, 미래에 날짜를 변경하여 캐시를 무효화하고 도구를 업그레이드할 수 있게 합니다.
여기서 제 목표는 GitHub Actions에서 Python 도구들을 사용할 때마다 워크플로우 실행 시 PyPI에 접속하여 도구와 그 의존성(dependencies)의 새 복사본을 다운로드하는 것을 방지하는 것입니다.
최근 기사
- GPT-5.6 패밀리: Luna, Terra, Sol - 2026년 7월 9일
- sqlite-utils 4.0, 이제 데이터베이스 스키마 마이그레이션 기능 추가 - 2026년 7월 7일
- sqlite-utils 4.0rc2, 주로 Claude Fable에 의해 작성됨 (약 $149.25) - 2026년 7월 5일
AI 자동 생성 콘텐츠
본 콘텐츠는 Simon Willison Blog의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기