Compartilhar via

Tutorial: Configurar um cache de ativos vcpkg

  • Artigo

Todos os caches de ativos são configurados por meio da X_VCPKG_ASSET_SOURCES variável de ambiente. O valor de X_VCPKG_ASSET_SOURCES segue uma sintaxe de configuração específica.

Neste tutorial, você aprenderá a:

Pré-requisitos

  • Um terminal
  • vcpkg

1 - Crie um diretório de cache de ativos

Você pode usar o back-end do Armazenamento de Blobs do Azure "x-azurl", para armazenar ativos. Como alternativa, você pode usar diretórios do sistema de arquivos para armazenar seus ativos de download, incluindo locais de rede. Para fazer isso, você precisa usar o file:// protocolo no URL do cache de ativos.

Neste tutorial, você criará um local de cache de ativos local para armazenar artefatos baixados. Se você tiver um Armazenamento de Blobs do Azure DevOps que deseja usar, substitua a URL e forneça um token SAS como o segundo parâmetro na cadeia de caracteres de configuração.

  1. Crie um diretório para servir como um local de cache de ativos (substitua por qualquer local de sua escolha):
mkdir D:\vcpkg\asset-cache

mkdir /home/vcpkg/asset-cache

2 - Configurar X_VCPKG_ASSET_SOURCES

Em seguida, defina o valor da X_VCPKG_ASSET_SOURCES seguinte maneira:

$env:X_VCPKG_ASSET_SOURCES="clear;x-azurl,file://D:/vcpkg/asset-cache,,readwrite"

Observação

Definir variáveis de ambiente dessa maneira afeta apenas a sessão de terminal atual. Para tornar essas alterações permanentes em todas as sessões, defina-as por meio do painel Variáveis de Ambiente do Sistema do Windows.

set "X_VCPKG_ASSET_SOURCES=clear;x-azurl,file://D:/vcpkg/asset-cache,,readwrite"

Observação

Definir variáveis de ambiente dessa maneira afeta apenas a sessão de terminal atual. Para tornar essas alterações permanentes em todas as sessões, defina-as por meio do painel Variáveis de Ambiente do Sistema do Windows.

Essa X_VCPKG_ASSET_SOURCES configuração adiciona as seguintes strings de origem:

  • clear, desativa qualquer cache de ativos configurado anteriormente
  • x-azurl,file://C:/vcpkg/asset-cache,,readwrite, define um cache de ativos do sistema de arquivos, localizado em D:\vcpkg\asset-cache, com permissões de leitura/gravação.
export X_VCPKG_ASSET_SOURCES="clear;x-azurl,file:///home/vcpkg/asset-cache,,readwrite"

Observação

A configuração de variáveis de ambiente usando o export comando afeta apenas a sessão atual do shell. Para tornar essa alteração permanente entre as sessões, adicione o export comando ao script de perfil do shell (por exemplo, ~/.bashrc ou ~/.zshrc).

Essa X_VCPKG_ASSET_SOURCES configuração adiciona as seguintes strings de origem:

  • clear, desativa qualquer cache de ativos configurado anteriormente
  • x-azurl,file:///home/vcpkg/asset-cache,,readwrite, define um cache de ativos do sistema de arquivos, localizado em home/vcpkg/asset-cache, com permissões de leitura/gravação.

Próximas etapas

Aqui estão outras tarefas para tentar a seguir: