영어로 읽기

다음을 통해 공유


자산 캐싱 구성

원본

매개 <rw> 변수는 선택 사항이며 아래에 설명된 대부분의 원본에 공통적으로 적용됩니다. 특정 원본에 대한 액세스 권한을 제어하고 값 read또는 writereadwrite (기본값은 )을 read허용합니다.

원본 문자열 내에서 문자를 이스케이프하려면 백틱(')을 사용합니다.

clear

구문: clear

구성 문자열에서 이전 원본을 모두 제거합니다. 환경 변수에서 오는 X_VCPKG_ASSET_SOURCES 모든 자산 캐싱 원본을 사용하지 않도록 설정하는 매개 변수와 --x-asset-sources 함께 유용합니다.

Azure Blob Storage(x-azurl)

구문:

  1. x-azurl,<url>[,<sas>[,<rw>]]
  2. x-azurl,file://<network-location>[,,<rw>]

<url>: 필수 사항입니다. Azure Blob Storage 연결 URL입니다. 컨테이너 경로와 후행 /을 포함해야 합니다.

<sas>:선택적. 공유 액세스 서명 유효성 검사를 사용하는 엔드포인트의 경우 이 매개 변수를 사용하여 생성된 SAS를 제공합니다.

비 Azure 엔드포인트는 이 매개 변수를 사용하여 액세스 토큰을 제공할 수 있습니다. 양식 <url>/<sha512>?<sas>의 GET 및 PUT 요청에 응답할 수 있는 한.

예를 들어 다음과 azurl,https://mydomain.com/vcpkg/,token=abc123,readwrite같이 구성된 원본은 다음 형식 https://mydomain.com/vcpkg/<sha512>?token=abc123으로 요청을 생성합니다.

또는 패턴을 사용하여 파일 시스템 위치를 엔드포인트로 사용할 x-azurl,file://<filesystem-location>[,,<rw>] 수 있습니다.

예를 들어 x-azurl,file:///Z:/vcpkg/assetcache/,,readwrite 네트워크 폴더에서 캐시를 Z:/ 구성합니다.

이 자산 원본의 워크플로는 다음과 같습니다.

  1. 미러에서 읽으려고 시도합니다.
  2. (1단계가 실패한 경우) 원래 URL에서 읽기
  3. (2단계에 성공한 경우) 미러에 다시 쓰기

지정자를 통해 1단계와 3단계를 <rw> 사용하거나 사용하지 않도록 설정할 수 있으며 아래를 통해 2단계를 x-block-origin 사용하지 않도록 설정할 수 있습니다.

원본을 설정하는 x-azurl 방법에 대한 자세한 내용은 Azure Blob Storage에 대한 이진 캐싱 설명서도 참조하세요.

x-block-origin

구문: x-block-origin

구성된 원본에서 자산을 찾을 수 없는 경우 원래 다운로드 URL로 대체하지 않도록 설정합니다.

x-script

구문: x-script,<template>

외부 도구로 디스패치하여 자산을 가져옵니다.

<template>: 필수 사항입니다. vcpkg가 자산을 획득하기 위해 실행하는 명령 템플릿입니다. 예를 들어 x-script,curl -L {url} --output {dst} vcpkg를 실행하고 curl 매개 {dst} 변수를 {url} 제공하도록 구성합니다.

자산을 복원 및 업로드하고 캐시 스토리지 엔드포인트에 연결하는 논리는 템플릿 내에서 제공되는 명령의 책임입니다.

vcpkg는 다음 명령을 실행할 때 이러한 인수를 대체합니다.

  • {url}: 자산의 원래 다운로드 URL입니다.
  • {sha512}: 다운로드한 자산의 예상 SHA512입니다.
  • {dst}: 다운로드한 자산이 필요한 위치입니다.

템플릿 명령은 vcpkg의 빌드 환경 내에서 실행됩니다. 즉, 같은 PATH 일부 환경 변수는 트리플렛에 의해 수정될 수 있습니다.

다음 단계