Ejecución de comandos Git en un script

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

Para algunos flujos de trabajo, necesitará la canalización de compilación para ejecutar comandos de Git. Por ejemplo, después de realizar una compilación de CI en una rama de características, es posible que el equipo quiera combinar la rama en la main.

Git está disponible en agentes hospedados por Microsoft y en agentes locales.

Habilitación de scripts para ejecutar comandos de Git

Nota:

Antes de comenzar, asegúrese de que la identidad predeterminada de la cuenta esté establecida con el código siguiente. Esto debe hacerse como primer paso después de restaurar el código.

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

Conceder permisos de control de versiones al servicio de compilación

1. Vaya a la página de configuración de proyectos de su organización en Configuración de la organización>General>Proyectos.

   

2. Selección del proyecto que quiere editar.

   

3. En Configuración del proyecto, seleccione Repositorios. Seleccione el repositorio en el que desea ejecutar comandos de Git.

4. Seleccione Seguridad para editar la seguridad del repositorio.

   

5. Busque Servicio de compilación de colección de proyectos. Elija el servicio de compilación de {{nombre del proyecto}} ({su organización}) de identidades (no las cuentas de servicio de compilación de la colección de proyectos ({su organización}) del grupo). De forma predeterminada, esta identidad puede leer desde el repositorio, pero no puede volver a insertar ningún cambio en él. Conceda los permisos necesarios para los comandos de Git que desea ejecutar. Normalmente, querrá conceder lo siguiente:

   • Crear rama: permitir
   • Contribuir: permitir
   • Leer: permitir
   • Crear etiqueta: permitir

Permitir que los scripts accedan al token del sistema

YAML

Agregue una sección checkout con persistCredentials establecido en true.

steps:
- checkout: self
  persistCredentials: true

Más información acerca de checkout.

Clásico

En la pestaña opciones, seleccione Permitir que los scripts accedan al token de OAuth.

Asegúrese de limpiar el repositorio local.

La canalización de compilación no limpia automáticamente ciertos tipos de cambios en el repositorio local. Por lo tanto, asegúrese de:

• Eliminar las ramas locales que cree.
• Deshacer los cambios de configuración de Git.

Si tiene problemas con un agente local, asegúrese de que el repositorio está limpio:

YAML

Asegúrese de que checkout tiene clean establecido en true.

steps:
- checkout: self
  clean: true

Clásico

• En la pestaña repositorio, establezca Limpiar en true.

Ejemplos

Enumeración de los archivos del repositorio

En la pestaña de compilación, agregue esta tarea:

Tarea	Argumentos
Utilidad: línea de comandos Enumere los archivos del repositorio de Git.	Herramienta: git Argumentos: ls-files

Combinación de una rama de características con la principal

Quiere que una compilación de CI se combine con la principal si la compilación se realiza correctamente.

En la pestaña Desencadenadores, seleccione Integración continua (CI) e incluya las ramas que desea compilar.

Cree merge.bat en la raíz del repositorio:

@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

En la pestaña compilación, agregue esto como la última tarea:

Tarea	Argumentos
Utilidad: script por lotes Ejecute merge.bat.	Ruta de acceso: merge.bat

Preguntas más frecuentes

¿Puedo ejecutar comandos de Git si mi repositorio remoto está en GitHub u otro servicio de Git, como Bitbucket Cloud?

Sí

¿Qué tareas puedo usar para ejecutar comandos de Git?

Script de Batch

Línea de comandos

PowerShell

Script de shell

¿Cómo evitar que se desencadene una compilación de CI con una inserción de script?

Agregue [skip ci] al mensaje de confirmación o la descripción. Estos son unos ejemplos:

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

También puede usar cualquiera de estas variantes para las confirmaciones en Git de Azure Repos, Bitbucket Cloud, GitHub y GitHub Enterprise Server.

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

¿Necesito un agente?

Necesita al menos un agente para ejecutar la compilación o versión.

Tengo problemas. ¿Cómo puedo solucionarlos?

Vea Solución de problemas de compilación y versión.

No se puede seleccionar un grupo de agentes predeterminado y no se puede poner en cola la compilación o versión. ¿Cómo puedo corregirlo?

Vea Grupos de agentes.

La tarea de envío de cambios de NuGet genera el error siguiente: "Error: no se puede obtener el certificado del emisor local". ¿Cómo lo puedo corregir?

Esto se puede corregir si se añade un certificado raíz de confianza. Puede agregar la variable de entorno NODE_EXTRA_CA_CERTS=file al agente de compilación, o bien la variable de tarea NODE.EXTRA.CA.CERTS=file en la canalización. Vea la documentación de Node.js para obtener más detalles sobre esta variable. Consulte Establecimiento de variables en una canalización para obtener instrucciones sobre cómo establecer una variable en la canalización.