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, writeou readwrite (o padrão é ).read

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 Blob do Azure (x-azurl)

Sintaxe:

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

<url>:Necessário. A URL de conexão do Armazenamento de Blobs do Azure. Ele deve incluir o caminho do contêiner e um trailing /.

<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. Desde que possam responder aos pedidos 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 desta fonte de ativos é:

1. Tentativa de ler a partir do espelho
2. (Se o passo 1 falhar) Leia a partir do url original
3. (Se a etapa 2 for bem-sucedida) Escreva de volta ao espelho

Você pode ativar/desativar as etapas 1 e 3 através do especificador, e você pode desativar a etapa 2 através abaixo <rw>x-block-origin .

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

Desabilita 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>:Necessá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 conectar-se ao ponto de extremidade de armazenamento de cache são responsabilidade do comando fornecido no modelo.

vcpkg substituirá estes argumentos ao executar o comando:

• {url}: o 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 dentro do ambiente de compilação do vcpkg; Isso significa que algumas variáveis de ambiente como PATH podem ser modificadas pelo trio.

Próximo passo