Eseguire i comandi Git in uno script

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Per alcuni flussi di lavoro, è necessario che la pipeline di compilazione esegua comandi Git. Ad esempio, al termine di una compilazione CI in un ramo di funzionalità, il team potrebbe voler unire il ramo a al ramo principale.

Git è disponibile in agenti ospitati da Microsoft e in agenti locali.

Abilitare gli script per eseguire comandi Git

Nota

Prima di iniziare, assicurarsi che l'identità predefinita dell'account sia impostata con il codice seguente. Questa operazione deve essere eseguita come primo passaggio dopo aver estratto il codice.

git config --global user.email "you@example.com"
git config --global user.name "Your Name"

Concedere le autorizzazioni di controllo della versione al servizio di compilazione

1. Passare alla pagina delle impostazioni del progetto per l'organizzazione in Organization Impostazioni> General>Projects (Progetti generali).

   

2. Selezionare il progetto da modificare.

   

3. In Project Impostazioni selezionare Repository. Selezionare il repository in cui si vogliono eseguire i comandi Git.

4. Selezionare Sicurezza per modificare la sicurezza del repository.

   

5. Cercare Project Collection Build Service( Servizio di compilazione raccolta progetti). Scegliere l'identità {{nome progetto}} Build Service ({organizzazione}) (non gli account del servizio di compilazione raccolta progetti ({organizzazione})). Per impostazione predefinita, questa identità può leggere dal repository, ma non può eseguire il push delle modifiche. Concedere le autorizzazioni necessarie per i comandi Git da eseguire. In genere si vuole concedere:

   • Crea ramo: Consenti
   • Contribuire: Consenti
   • Lettura: Consenti
   • Crea tag: Consenti

Consentire agli script di accedere al token di sistema

YAML

Aggiungere una checkout sezione con persistCredentials impostato su true.

steps:
- checkout: self
  persistCredentials: true

Altre informazioni su checkout.

Classico

Nella scheda opzioni selezionare Consenti agli script di accedere al token OAuth.

Assicurarsi di pulire il repository locale

Alcuni tipi di modifiche al repository locale non vengono puliti automaticamente dalla pipeline di compilazione. Assicurarsi quindi di:

• Eliminare i rami locali creati.
• Annullare le modifiche alla configurazione Git.

Se si verificano problemi con un agente locale, assicurarsi che il repository sia pulito:

YAML

Assicurarsi di checkout aver clean impostato su true.

steps:
- checkout: self
  clean: true

Classico

• Nella scheda repository impostare Pulisci su true.

Esempi

Elencare i file nel repository

Nella scheda Compilazione aggiungere questa attività:

Attività	Argomenti
Utilità: riga di comando Elencare i file nel repository Git.	Strumento: git Argomenti: ls-files

Unire un ramo di funzionalità a main

Se la compilazione ha esito positivo, si vuole che una compilazione CI venga unione a main.

Nella scheda Trigger selezionare Integrazione continua (CI) e includere i rami da compilare.

Creare merge.bat nella radice del repository:

@echo off
ECHO SOURCE BRANCH IS %BUILD_SOURCEBRANCH%
IF %BUILD_SOURCEBRANCH% == refs/heads/main (
   ECHO Building main branch so no merge is needed.
   EXIT
)
SET sourceBranch=origin/%BUILD_SOURCEBRANCH:refs/heads/=%
ECHO GIT CHECKOUT MAIN
git checkout main
ECHO GIT STATUS
git status
ECHO GIT MERGE
git merge %sourceBranch% -m "Merge to main"
ECHO GIT STATUS
git status
ECHO GIT PUSH
git push origin
ECHO GIT STATUS
git status

Nella scheda di compilazione aggiungere questa opzione come ultima attività:

Attività	Argomenti
Utilità: Script batch Eseguire merge.bat.	Percorso: merge.bat

Domande frequenti

È possibile eseguire comandi Git se il repository remoto si trova in GitHub o in un altro servizio Git, ad esempio Bitbucket Cloud?

Sì

Quali attività è possibile usare per eseguire comandi Git?

Script Batch

Riga di comando

PowerShell

Script della shell

Ricerca per categorie evitare di attivare una compilazione CI quando lo script esegue il push?

Aggiungere [skip ci] al messaggio o alla descrizione del commit. Ecco alcuni esempi:

• git commit -m "This is a commit message [skip ci]"
• git merge origin/features/hello-world -m "Merge to main [skip ci]"

È anche possibile usare una di queste varianti per i commit in Git Azure Repos, Bitbucket Cloud, GitHub ed GitHub Enterprise Server.

• [skip ci] oppure [ci skip]
• skip-checks: true oppure skip-checks:true
• [skip azurepipelines] oppure [azurepipelines skip]
• [skip azpipelines] oppure [azpipelines skip]
• [skip azp] oppure [azp skip]
• ***NO_CI***

È necessario un agente?

È necessario almeno un agente per eseguire la compilazione o il rilascio.

Ho problemi. Come è possibile risolvere i problemi?

Vedere Risolvere i problemi di compilazione e rilascio.

Non è possibile selezionare un pool di agenti predefinito e non è possibile accodamento della build o del rilascio. Come lo risolvo?

Vedere Pool di agenti.

L'attività push NuGet ha esito negativo con l'errore seguente: "Errore: impossibile ottenere il certificato dell'autorità di certificazione locale". Come si risolve questo problema?

Questo errore può essere corretto mediante l'aggiunta di un certificato radice attendibile. È possibile aggiungere la variabile di ambiente NODE_EXTRA_CA_CERTS=file all'agente di compilazione oppure aggiungere la variabile di attività NODE.EXTRA.CA.CERTS=file nella pipeline. Per altre informazioni su questa variabile, vedere la documentazione di Node.js. Per istruzioni sull'impostazione di una variabile nella pipeline, vedere Impostare le variabili in una pipeline.