Compartir vía

Tutorial: Configuración de una caché binaria de vcpkg mediante la caché de acciones de GitHub

Precaución

Se ha eliminado el backend del caché de GitHub Actions para el almacenamiento en caché binario. Este tutorial ya no se mantiene.
Para obtener más información e instrucciones de migración, consulte Solicitud de incorporación de cambios de GitHub #1662.

Nota:

En esta sección se describe una característica experimental de vcpkg que puede cambiar o quitarse en cualquier momento.

vcpkg admite el uso de la caché de Acciones de GitHub como almacenamiento en caché binario cuando se ejecuta en el contexto de un flujo de trabajo de Acciones de GitHub. Si no le interesa cargar paquetes binarios en una fuente de NuGet externa, este es el método recomendado para usar el almacenamiento en caché binario en un flujo de trabajo de Acciones de GitHub. De lo contrario, lea el tutorial para usar paquetes de GitHub en un flujo de trabajo de Acciones de GitHub.

En este tutorial, aprenderá a:

Prerrequisitos

  • Un editor de código
  • Un repositorio de GitHub mediante Acciones de GitHub
  • Un proyecto con vcpkg

1 - Exportar variables de entorno necesarias de las Acciones de GitHub

vcpkg necesita que la Actions Cache URL y el Runtime Token se exporten como variables de entorno disponibles en su flujo de trabajo. Copie el paso siguiente en el archivo de flujo de trabajo:

- 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- Configuración de vcpkg para usar la caché de Acciones de GitHub

A continuación, establezca el valor de VCPKG_BINARY_SOURCES como se indica a continuación:

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

¡Y eso es todo! vcpkg cargará o restaurará paquetes desde la memoria caché de Acciones de GitHub.

Pasos siguientes

Autenticación en fuentes de NuGet privadas

Estas son otras tareas que se van a probar a continuación: