Freigeben über

Verwenden Sie die Unterstützung für Go-Installationsbefehle in Azure Repos Git

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Von Bedeutung

Erwägen Sie die Verwendung der sichereren Microsoft Entra-Token gegenüber den risikoreicheren persönlichen Zugriffstoken. Weitere Informationen finden Sie unter Reduzieren der PAT-Verwendung. Überprüfen Sie die Authentifizierungsanleitungen , um den richtigen Authentifizierungsmechanismus für Ihre Anforderungen auszuwählen.

Go ist eine Open Source-Programmiersprache, die auch als Golang bezeichnet wird. In Go können Sie den install Befehl verwenden, um Pakete und Abhängigkeiten herunterzuladen und zu installieren. Azure Repos Git bietet Unterstützung von go install innerhalb eines Azure Repos Git-Repositorys. Mit go install, können Sie Pakete mit ihren Abhängigkeiten herunterladen, die von den Importpfaden benannt sind. Sie können auch das import Schlüsselwort in einer Go-Datei verwenden, um den Importpfad anzugeben, wobei die gleiche Syntax verwendet wird, die in den folgenden Abschnitten beschrieben ist.

Gehen Sie zur Installation mit öffentlichen Projekten

Wenn sich Ihr Azure Repos Git-Repository in einem öffentlichen Projekt befindet, können Sie die Web-Repository-URL im folgenden Format verwenden go install . Für die Version können Sie latest oder eine bestimmte Version verwenden.

go install dev.azure.com/<organization>/<project>/_git/<repo>.git@<version>

Sie können ein Go-Paket auch in einem Unterordner eines Repositorys installieren, indem Sie die Unterordnernamen anfügen, wie in den folgenden Beispielen gezeigt.

go install dev.azure.com/<organization>/<project>/_git/<repo>.git/subfolder1@<version>

go install dev.azure.com/<organization>/<project>/_git/<repo>.git/subfolder1/subfolder2@<version>

Gehen Sie zur Installation mit privaten Projekten

Wenn Ihr Azure Repos Git-Repository privat ist, können Sie sich mit SSH-Schlüsseln, Microsoft Entra-ID-Token (empfohlen) oder persönlichen Zugriffstoken (PATs) authentifizieren.

Von Bedeutung

Um über go install auf private Azure Repos Git-Repositories zugreifen zu können, müssen Sie zunächst die Umgebungsvariable GOPRIVATE=dev.azure.com festlegen. Sie können diese Umgebungsvariable vor dem Erstellen oder Ausführen lokal festlegen.

SSH

Um SSH mit go install zu verwenden, müssen Sie SSH-Schlüssel für Azure DevOps einrichten, wie unter SSH-Schlüsselauthentifizierung verwenden beschrieben.

Wenn Sie SSH-Schlüssel eingerichtet haben, fügen Sie diesen Eintrag zu Ihrer GITCONFIG-Datei hinzu:

[url "git@ssh.dev.azure.com:v3/<organization>/<project>/<repo>"]
	insteadOf = https://dev.azure.com/<organization>/<project>/<repo>

Mit diesem Eintrag und einem bestimmten URL-Format können Sie jetzt verwenden go install.

Hinweis

Achten Sie darauf, nach dem Namen des Repositorys zu verwenden .git . Außerdem ist _git nicht in der Paket-URL enthalten, die Sie an go install übergeben, da Sie die SSH-URL verwenden.

go install dev.azure.com/<organization>/<project>/<repo>.git

HTTPS

Um HTTPS mit go installzu verwenden, können Sie sich entweder mit Microsoft Entra ID-Token (empfohlen) oder mit persönlichen Zugriffstoken (PATs) authentifizieren.

Microsoft Entra-ID-Token bieten eine bessere Sicherheit und sind die empfohlene Authentifizierungsmethode. Sie können diese Token über Folgendes abrufen:

  • Azure CLI (für Entwicklung/Tests):

    az account get-access-token --resource 499b84ac-1321-427f-aa17-267ca6975798 --query "accessToken" --output tsv

  • Service Principal (für Produktions-/automatisierte Szenarien):

    • Registrieren einer Anwendung in Microsoft Entra ID
    • Erstellen eines geheimen Clientschlüssels für die Anwendung
    • Erteilen der anwendung entsprechenden Berechtigungen in Azure DevOps
    • Verwenden Sie die Anmeldeinformationen des Dienstprinzipals, um Token programmgesteuert abzurufen.

Weitere Informationen finden Sie unter Microsoft Entra-Authentifizierung.

Nachdem Sie das Microsoft Entra-ID-Token abgerufen haben, fügen Sie diesen Eintrag zu Ihrer .gitconfig Datei hinzu:

[url "https://<user>:<token>@dev.azure.com/<organization>/<project>/_git/<repo>"]
	insteadOf = https://dev.azure.com/<organization>/<project>/_git/<repo>

Der <user> Teil kann eine beliebige nichtleere Zeichenfolge sein. Erwägen Sie, entra und Ihren Benutzernamen zu verwenden.

Tipp

Rufen Sie ein einmaliges Microsoft Entra-Token von Azure CLI ab: Sie können schnell ein Microsoft Entra-ID-Token für Git-Vorgänge mithilfe der Azure CLI abrufen, das für Entwicklungs- und Testszenarien nützlich ist. Stellen Sie beim Generieren von Token im Namen eines Dienstprinzipals sicher, dass Sie sich zuerst als Dienstprinzipal anmelden .

Tokenverwaltung: Microsoft Entra-ID-Token weisen Ablaufzeiten auf, daher müssen Sie sie möglicherweise regelmäßig aktualisieren. Bei automatisierten Workflows sollten Sie Dienstprinzipale mit geeigneten Tokenaktualisierungsmechanismen verwenden.

Persönliche Zugriffstoken (alternative)

Wenn Sie PATs verwenden möchten, erstellen Sie einen PAT, wie unter "Authentifizieren des Zugriffs mit persönlichen Zugriffstoken" beschrieben. Für diese PAT ist nur der UmfangCode (schreibgeschützt) erforderlich.

Nachdem Sie das PAT erstellt haben, fügen Sie diesen Eintrag zu Ihrer .gitconfig Datei hinzu:

[url "https://<user>:<token>@dev.azure.com/<organization>/<project>/_git/<repo>"]
	insteadOf = https://dev.azure.com/<organization>/<project>/_git/<repo>

Der <user> Teil kann eine beliebige nicht-leere Zeichenfolge sein. Erwägen Sie die Verwendung pat.

Mit diesem Eintrag und einem bestimmten URL-Format können Sie jetzt verwenden go install.

Hinweis

Achten Sie darauf, nach dem Namen des Repositorys zu verwenden .git .

go install dev.azure.com/<organization>/<project>/_git/<repo>.git@<version>

Sie können ein Go-Paket auch in einem Unterordner eines Repositorys installieren, indem Sie die Unterordnernamen anfügen, wie in den folgenden Beispielen gezeigt.

go install dev.azure.com/<organization>/<project>/_git/<repo>.git/subfolder1@<version>

go install dev.azure.com/<organization>/<project>/_git/<repo>.git/subfolder1/subfolder2@<version>
  • Last updated on