Configuração de cache de ativos
Fontes
O <rw> parâmetro é opcional e comum à maioria das fontes descritas abaixo. Ele controla as permissões de acesso para a fonte específica e aceita os valores read, , ou readwrite (o padrão é readwrite).
Use um acento grave (') para escapar caracteres dentro das strings 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 desativar todas as fontes de cache de ativos provenientes da X_VCPKG_ASSET_SOURCES variável de ambiente.
Azure Blob Storage (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 /.
<sas>: opcional. Para pontos de extremidade que usam a validação de Assinatura de Acesso Compartilhado, use esse parâmetro para fornecer a SAS gerada.
Os pontos de extremidade que não são do Azure podem fornecer um token de acesso usando esse parâmetro. Contanto que eles possam responder às solicitações GET e PUT do formulário <url>/<sha512>?<sas>.
Por exemplo, uma fonte configurada da seguinte forma: azurl,https://mydomain.com/vcpkg/,token=abc123,readwrite, produz uma solicitação no formato: 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 origem de ativos é:
- Tente ler do espelho
- (Se a etapa 1 falhar) Ler a partir do URL original
- (Se a etapa 2 for bem-sucedida) Escreva de volta para o espelho
Você pode ativar/desativar as etapas 1 e 3 por meio do especificador e pode desabilitar a etapa 2 por meio x-block-origin da <rw> página 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 fonte.
x-block-origin
Sintaxe: x-block-origin
Desativa o retorno ao 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 o 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 and {dst} .
A lógica para restaurar e fazer upload de ativos e conectar-se ao ponto de extremidade de armazenamento em cache é responsabilidade do comando fornecido no modelo.
vcpkg substituirá esses argumentos ao executar o comando:
{url}: o URL de download original do ativo.{sha512}: o SHA512 esperado do ativo transferido por download.{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 de ambiente podem PATH ser modificadas pelo trigêmeo.
