Referência de cache de ativos
Origens
O <rw>
parâmetro é opcional e comum à maioria das fontes descritas abaixo. Ele controla as permissões de acesso para a origem específica e aceita os valores read
, write
ou readwrite
(o read
padrão é ).
Use um backtick (') para escapar de caracteres dentro das cadeias de caracteres de origem.
clear
Sintaxe: clear
Remove todas as fontes anteriores na cadeia de caracteres de configuração. Útil em combinação com o --x-asset-sources
parâmetro para desabilitar todas as fontes de cache de ativos provenientes da X_VCPKG_ASSET_SOURCES
variável de ambiente.
Armazenamento de Blobs do Azure (x-azurl
)
Sintaxe:
x-azurl,<url>[,<sas>[,<rw>]]
x-azurl,file://<network-location>[,,<rw>]
<url>
: obrigatório. A URL de conexão do Armazenamento de Blobs do Azure. Ele deve incluir o caminho do contêiner e um arquivo à direita /
.
<sas>
: opcional. Para pontos de extremidade usando a validação de Assinatura de Acesso Compartilhado, use esse parâmetro para fornecer o SAS gerado.
Os pontos de extremidade que não são do Azure podem fornecer um token de acesso usando esse parâmetro. Desde que eles possam responder às solicitações GET e PUT do formulário <url>/<sha512>?<sas>
.
Por exemplo, uma origem configurada da seguinte maneira: , produz uma solicitação no formato: azurl,https://mydomain.com/vcpkg/,token=abc123,readwrite
https://mydomain.com/vcpkg/<sha512>?token=abc123
.
Como alternativa, você pode usar um local do sistema de arquivos como o ponto de extremidade usando o x-azurl,file://<filesystem-location>[,,<rw>]
padrão.
Por exemplo, x-azurl,file:///Z:/vcpkg/assetcache/,,readwrite
configura um cache na Z:/
pasta de rede.
O fluxo de trabalho dessa fonte de ativos é:
- Tente ler a partir do espelho
- (Se a etapa 1 falhou) Leia a partir do URL original
- (Se a etapa 2 for bem-sucedida) Escrever de volta no espelho
Você pode ativar/desativar as etapas 1 e 3 através do especificador, e você pode desativar a <rw>
etapa 2 via x-block-origin
abaixo.
Consulte também a documentação de cache binário do Armazenamento de Blobs do Azure para obter mais informações sobre como configurar uma x-azurl
origem.
x-block-origin
Sintaxe: x-block-origin
Desativa o retorno à URL de download original quando um ativo não é encontrado em nenhuma das fontes configuradas.
x-script
Sintaxe: x-script,<template>
Despacha para uma ferramenta externa para buscar o ativo.
<template>
: obrigatório. Um modelo de comando que vcpkg executa para adquirir um ativo. Por exemplo: x-script,curl -L {url} --output {dst}
configura vcpkg para executar curl
e fornecer os {url}
parâmetros e {dst}
.
A lógica para restaurar e carregar ativos e para se conectar ao ponto de extremidade de armazenamento de cache é de responsabilidade do comando fornecido no modelo.
vcpkg substituirá esses argumentos ao executar o comando:
{url}
: a URL de download original do ativo.{sha512}
: o SHA512 esperado do ativo baixado.{dst}
: o local onde o ativo baixado é esperado.
O comando template é executado no ambiente de compilação do vcpkg; Isso significa que algumas variáveis do ambiente podem PATH
ser modificadas pelo triplete.
Próxima etapa
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de