vcpkg in Fortlaufenden Integrationsumgebungen

In diesem Artikel wird beschrieben, wie vcpkg effektiv in einer CI-Umgebung (Continuous Integration) verwendet wird. Entweder weil Sie vcpkg zum Verwalten der Abhängigkeiten Ihres Projekts verwenden oder über eine benutzerdefinierte vcpkg-Registrierung verfügen und CI-Tests für Ihre Ports hinzufügen möchten.

vcpkg erwerben

Die Schritte zum Abrufen von vcpkg in einer CI-Umgebung entsprechen denen zum Abrufen von vcpkg in Ihrer Entwicklungsumgebung. Sie müssen einen Klon des vcpkg-Repositorys https://github.com/microsoft/vcpkg erwerben und das Bootstrap-Skript ausführen, um eine vcpkg-ausführbare Datei zu erhalten.

Unabhängig von der von Ihnen befolgten Kaufmethode wird dringend empfohlen, dass Ihre vcpkg-Instanz über einen vollständigen Git-Verlauf verfügt. Das Versionsverwaltungsfeature von vcpkg basiert auf einem vollständigen Commitverlauf zum Abrufen bestimmter Portversionen.

Verwenden von vcpkg als Untermodul

Eine einfache Möglichkeit zum Abrufen von vcpkg in Ihrer CI-Umgebung besteht darin, das vcpkg-Repository als Untermodule Ihres Repositorys zu deklarieren.

git submodule init
./vcpkg/vcpkg-bootstrap.sh

Verwenden der Git CLI

Eine sekundäre Methode besteht darin, einen Git-Befehl als Teil Ihrer CI-Skripts auszuführen, um eine Instanz des vcpkg-Repositorys zu klonen.

git clone http://github.com/Microsoft/vcpkg
./vcpkg/vcpkg-bootstrap.sh

Verwenden einer Drittanbieteraktion/eines Skripts

Je nach Anbieter, den Sie zum Ausführen Ihrer CI-Umgebung verwenden, stehen möglicherweise skripts von Drittanbietern zur Verfügung, die vcpkg in einem einzigen Schritt erwerben können. Das vcpkg-Team behält keines dieser Drittanbieterskripts bei, und Sie sollten die richtige Vorsicht walten lassen, wenn Sie eines dieser Skripts verwenden möchten.

Andere Erwerbsmethoden

Die folgenden Methoden werden für CI-Umgebungen nicht empfohlen.

  • Das einzeilige Installationsskript: iex (iwr -useb https://aka.ms/vcpkg-init.ps1) oder . <(curl https://aka.ms/vcpkg-init.sh -L). Dies ist eine vcpkg-Verteilungsmethode, die das experimentelle Feature "Artefakte" aktiviert und für die meisten Benutzer nicht empfohlen wird.

Einrichten des Binären Caches

Es wird dringend empfohlen, einen binären Cache zu aktivieren, um die Neuerstellung der Abhängigkeiten Ihres Projekts für jede CI-Ausführung zu vermeiden.

Weitere Informationen zum binären Zwischenspeichern finden Sie in den folgenden Artikeln:

Einrichten eines Objektcaches

Das Einrichten eines Ressourcencaches macht Ihre CI-Umgebung stabiler für Fehler, die durch externe Dienste verursacht werden.

Weitere Informationen zum Zwischenspeichern von Objekten finden Sie in den folgenden Artikeln:

Beispiele

Diese Artikel zeigen Ihnen Beispiele dafür, wie alles zusammen funktioniert: