Share via


Tutorial: Configurar um cache binário vcpkg usando o Cache de Ações do GitHub

Observação

Esta seção cobre uma característica experimental do vcpkg que pode mudar ou ser removida a qualquer momento.

vcpkg oferece suporte ao uso do cache de Ações do GitHub como armazenamento de cache binário ao ser executado no contexto de um fluxo de trabalho de Ações do GitHub. Se você não se importa em carregar pacotes binários para um feed NuGet externo, esse é o método recomendado para usar o cache binário em um fluxo de trabalho de Ações do GitHub. Caso contrário, leia o tutorial para usar Pacotes do GitHub em um fluxo de trabalho de Ações do GitHub.

Neste tutorial, você aprenderá como:

Pré-requisitos

  • Um editor de código
  • Um repositório do GitHub usando ações do GitHub
  • Um projeto usando vcpkg

1 - Exportar variáveis de ambiente necessárias do GitHub Actions

vcpkg precisa que a URL do Cache de Ações e o Token de Tempo de Execução sejam exportados como variáveis de ambiente disponíveis em seu fluxo de trabalho. Copie a seguinte etapa no arquivo de fluxo de trabalho:

- name: Export GitHub Actions cache environment variables
  uses: actions/github-script@v7
  with:
    script: |
      core.exportVariable('ACTIONS_CACHE_URL', process.env.ACTIONS_CACHE_URL || '');
      core.exportVariable('ACTIONS_RUNTIME_TOKEN', process.env.ACTIONS_RUNTIME_TOKEN || '');

2 - Configure vcpkg para usar o cache de Ações do GitHub

Em seguida, defina o valor da VCPKG_BINARY_SOURCES seguinte maneira:

env: 
    VCPKG_BINARY_SOURCES: "clear;x-gha,readwrite"

Pronto! O vcpkg agora carregará ou restaurará pacotes do cache do GitHub Actions.

Próximas etapas

Aqui estão outras tarefas para tentar em seguida: