Dela via

Binär cachelagring

De flesta portar i det offentliga registret vcpkg skapas från källan. Genom att skapa från källan kan vcpkg säkerställa maximal kompatibilitet med hjälp av samma miljö, byggverktyg, kompilatorflaggor, länkflaggor och andra konfigurationer som du använder i projektet för att skapa dina beroenden.

När binär cachelagring är aktiverat skapar vcpkg ett binärt paket när varje paket har skapats från källan. Binära paket innehåller byggutdata för ett paket: binärfiler, byggsystemintegreringsfiler, användningsdokumentation, licens och andra filer. Om en senare körning kräver att ett cachelagrat paket installeras avgör vcpkg om det cachelagrade binära paketet ska återställas eller utlösa ett bygge från källan.

På så sätt minskar binär cachelagring effekten av följande nackdelar med att skapa från källa:

  • Duplicerad insats: Genom att minska antalet gånger som ett paket måste skapas från källan.
  • Långa byggtider: Att återställa ett binärt paket är vanligtvis en mycket snabb åtgärd som tar sekunder att slutföra.

Binär cachelagring är särskilt effektivt i CI-scenarier där tillfälliga containrar eller byggagenter tvingar vcpkg att arbeta med en ren skiffer varje gång. Genom att använda en molnbaserad binär cache (till exempel GitHub Packages eller Azure DevOps Artifacts) kan du spara binära paket mellan körningar för att säkerställa maximal hastighet eftersom återskapanden endast sker när du gör ändringar i dina beroenden eller konfiguration.

Tips/Råd

Vi rekommenderar att du skapar en binär cache med läs- och skrivbehörigheter för varje pipeline eller arbetsflöde för kontinuerlig integrering. Enskilda utvecklare bör ha skrivskyddad åtkomst till den CI-producerade binära cachen.

Binära cacheminnen kan hanteras i en mängd olika miljöer. Den mest grundläggande formen av en binär cache är en mapp på den lokala datorn eller en nätverksfilresurs. Cacheminnen kan också lagras i alla NuGet-feeds (till exempel GitHub Packages eller Azure DevOps Artifacts), Azure Blob Storage, Google Cloud Storage och många andra tjänster.

Om din CI-provider erbjuder en intern "cachelagringsfunktion" rekommenderar vi att du använder både vcpkg binär cachelagring och den interna metoden för de mest högpresterande resultaten.

Återanvända en binär cache för utveckling

Även om det inte rekommenderas som en binär distributionsmekanism kan binär cachelagring användas för att återanvända build-utdata från flera system. Utvecklare kan till exempel använda de binära paket som produceras av en CI-körning på sina lokala datorer. Om du vill använda andra metoder för att återanvända och integrera vcpkg-producerade binärfiler kan du titta på vcpkg export.

Du kan till exempel konfigurera ett NuGet-flöde som finns på Azure Artifacts för att acceptera binära paket som skapats från din CI-pipeline och återanvända dem i en utvecklingsmiljö.

Du måste konfigurera Ditt Azure Artifacts-flöde för att bevilja läs- och skrivbehörighet till din Azure DevOps-pipeline samt bevilja skrivskyddade behörigheter för värdar i utvecklingsteamet.

Standard binär cache

Binär cachning är aktiverad som standard med en files leverantör på den första giltiga platsen.

  • Windows
  1. %VCPKG_DEFAULT_BINARY_CACHE%
  2. %LOCALAPPDATA%\vcpkg\archives
  3. %APPDATA%\vcpkg\archives
  • Icke-Windows
  1. $VCPKG_DEFAULT_BINARY_CACHE
  2. $XDG_CACHE_HOME/vcpkg/archives
  3. $HOME/.cache/vcpkg/archives

Begränsad hjälp i verktyget är tillgänglig via vcpkg help binarycaching.

Binär cachelagring omfattar endast binärfiler som du skapar. Information om hur du cachelagr källfiler och fördefinierade verktyg finns i Cachelagring av tillgångar.

Nästa steg

Läs guiderna för att lära dig hur du konfigurerar en binär cache och konfigurationssyntaxreferensen:

  • Last updated on