자습서: GitHub Actions Cache를 사용하여 vcpkg 이진 캐시 설정

vcpkg는 GitHub Actions 워크플로의 컨텍스트에서 실행할 때 GitHub Actions 캐시를 이진 캐싱 스토리지로 사용할 수 있습니다. 외부 NuGet 피드에 이진 패키지를 업로드하는 데 신경 쓰지 않는 경우 GitHub Actions 워크플로에서 이진 캐싱을 사용하는 것이 좋습니다. 그렇지 않으면 GitHub Actions 워크플로에서 GitHub 패키지를 사용하려면 자습서를 읽어주세요.

이 자습서에서는 다음 작업을 수행하는 방법을 알아봅니다.

필수 조건

• 코드 편집기
• GitHub Actions를 사용하는 GitHub 리포지토리
• vcpkg를 사용하는 프로젝트

1 - 필요한 GitHub Actions 환경 변수 내보내기

vcpkg는 작업 캐시 URL 및 런타임 토큰을 워크플로에서 사용할 수 있는 환경 변수로 내보내야 합니다. 워크플로 파일에서 다음 단계를 복사합니다.

- name: Export GitHub Actions cache environment variables
  uses: actions/github-script@v7
  with:
    script: |
      core.exportVariable('ACTIONS_CACHE_URL', process.env.ACTIONS_CACHE_URL || '');
      core.exportVariable('ACTIONS_RUNTIME_TOKEN', process.env.ACTIONS_RUNTIME_TOKEN || '');

2 - GitHub Actions 캐시를 사용하도록 vcpkg 구성

다음으로 값을 VCPKG_BINARY_SOURCES 다음과 같이 설정합니다.

env: 
    VCPKG_BINARY_SOURCES: "clear;x-gha,readwrite"

이게 전부입니다! 이제 vcpkg는 GitHub Actions 캐시에서 패키지를 업로드하거나 복원합니다.

다음 단계

다음에 시도할 다른 작업은 다음과 같습니다.

• 기본 이진 캐시 위치 변경
• 로컬 이진 캐시 설정
• NuGet 피드를 사용하여 이진 캐시 설정
• GitHub 패키지를 사용하여 GitHub Actions 워크플로에서 이진 캐시 설정