Compartilhar via

Use o suporte ao comando Go install no Git do Azure Repos

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

Importante

Considere usar os tokens do Microsoft Entra mais seguros em vez dos tokens de acesso pessoal de maior risco. Para obter mais informações, consulte Reduzir o uso do PAT. Examine as diretrizes de autenticação para escolher o mecanismo de autenticação correto para suas necessidades.

Go é uma linguagem de programação de software livre, também conhecida como Golang. No Go, você pode usar o install comando para baixar e instalar pacotes e dependências. O Git do Azure Repos oferece suporte para go install dentro de um repositório Git do Azure Repos. Com go install, você pode baixar pacotes com suas dependências nomeadas pelos caminhos de importação. Você também pode usar a import palavra-chave dentro de um arquivo go para especificar o caminho de importação, usando a mesma sintaxe descrita nas seções a seguir.

Go install com projetos públicos

Se o repositório Git do Azure Repos estiver em um projeto público, você pode usar a URL do repositório no formato a seguir. Para versão, você pode usar latest ou uma versão específica.

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

Você também pode instalar um pacote Go em uma subpasta de um repositório acrescentando os nomes de subpasta, conforme mostrado nos exemplos a seguir.

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>

Go install com projetos privados

Se o repositório Git do Azure Repos for privado, você poderá autenticar usando chaves SSH, tokens de ID do Microsoft Entra (recomendado) ou PATs (tokens de acesso pessoal).

Importante

Para acessar repositórios Git privados do Azure Repos usando go install, primeiro você deve definir a variável GOPRIVATE=dev.azure.comde ambiente. Você pode definir essa variável de ambiente localmente antes de criar ou executar.

SSH

Para usar o SSH com go install, tenha chaves SSH configuradas para o Azure DevOps, conforme descrito em Usar autenticação por chave SSH.

Quando você tiver as chaves SSH configuradas, adicione essa entrada ao arquivo .gitconfig:

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

Com essa entrada e um formato de URL específico, agora você pode usar go install.

Observação

Certifique-se de usar .git após o nome do repositório. Além disso, o _git não está incluído na URL do pacote que você está passando para o go install porque está usando a URL SSH.

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

HTTPS

Para usar HTTPS com go install, você pode autenticar usando tokens de ID do Microsoft Entra (recomendado) ou PATs (tokens de acesso pessoal).

Os tokens de ID do Microsoft Entra fornecem melhor segurança e são o método de autenticação recomendado. Você pode obter esses tokens por meio de:

  • CLI do Azure (para desenvolvimento/teste):

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

  • Principal do Serviço (para cenários de produção/automatizados):

    • Registre um aplicativo no Microsoft Entra ID
    • Criar um segredo do cliente para o aplicativo
    • Conceder permissões apropriadas ao aplicativo no Azure DevOps
    • Usar as credenciais da entidade de serviço para programaticamente obter tokens

Para obter mais informações, consulte Autenticação do Microsoft Entra.

Depois de obter o token de ID do Microsoft Entra, adicione esta entrada ao arquivo .gitconfig :

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

A <user> parte pode ser qualquer cadeia de caracteres não vazia. Considere usar entra ou seu nome de usuário.

Dica

Obtenha um token de uso único do Microsoft Entra a partir do Azure CLI: É possível obter rapidamente um token de ID do Microsoft Entra para operações do Git, usando o Azure CLI, que é útil em cenários de desenvolvimento e teste. Ao criar tokens em nome de uma entidade de serviço, certifique-se de fazer login como a entidade de serviço primeiro.

Gerenciamento de tokens: os tokens de ID do Microsoft Entra têm tempos de expiração, portanto, talvez seja necessário atualizá-los periodicamente. Para fluxos de trabalho automatizados, considere o uso de princípios de serviço com mecanismos de atualização de token apropriados.

Tokens de acesso pessoal (alternativa)

Se você preferir usar PATs, crie um PAT conforme descrito em Autenticar acesso com tokens de acesso pessoal. Esse PAT requer apenas o escopode Código (leitura).

Depois de criar o PAT, adicione essa entrada ao arquivo .gitconfig :

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

A <user> parte pode ser qualquer cadeia de caracteres não vazia. Considere usar pat.

Com essa entrada e um formato de URL específico, agora você pode usar go install.

Observação

Certifique-se de usar .git após o nome do repositório.

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

Você também pode instalar um pacote Go em uma subpasta de um repositório acrescentando os nomes de subpasta, conforme mostrado nos exemplos a seguir.

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