Partager via

Tutoriel : Configurer un cache binaire vcpkg à l’aide du cache GitHub Actions

  • Article

Remarque

Cette section décrit une fonctionnalité expérimentale de vcpkg qui peut changer ou être supprimée à tout moment.

vcpkg prend en charge l’utilisation du cache GitHub Actions comme stockage de mise en cache binaire lors de l’exécution dans le contexte d’un flux de travail GitHub Actions. Si vous ne vous souciez pas du chargement de packages binaires dans un flux NuGet externe, il s’agit de la méthode recommandée pour utiliser la mise en cache binaire dans un workflow GitHub Actions. Sinon, lisez le tutoriel pour utiliser GitHub Packages dans un workflow GitHub Actions.

Ce didacticiel vous montre comment effectuer les opérations suivantes :

Prérequis

  • Éditeur de code
  • Dépôt GitHub à l’aide de GitHub Actions
  • Un projet utilisant vcpkg

1 - Exporter les variables d’environnement GitHub Actions requises

vcpkg a besoin de l’URL du cache d’actions et du jeton d’exécution pour être exportés en tant que variables d’environnement disponibles dans votre flux de travail. Copiez l’étape suivante dans votre fichier de flux de travail :

- 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 - Configurer vcpkg pour utiliser le cache GitHub Actions

Définissez ensuite la valeur comme VCPKG_BINARY_SOURCES suit :

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

C’est tout ! vcpkg chargera ou restaure désormais des packages à partir de votre cache GitHub Actions.

Étapes suivantes

S’authentifier auprès des flux NuGet privés

Voici d’autres tâches à essayer ensuite :