Solución de problemas de ejecuciones de canalización

Azure Pipelines | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 - TFS 2015

En este tema se proporcionan instrucciones generales para la solución de problemas. Para obtener una solución de problemas específica sobre .NET Core, consulte Solución de problemas de .NET Core.

Puede usar las siguientes secciones de solución de problemas para ayudar a diagnosticar problemas con la canalización. La mayoría de los errores de canalización se divide en una de estas categorías.

• La canalización no se desencadenará
• Colas de canalización, pero nunca obtiene un agente
• No se puede completar la canalización

La canalización no se desencadenará

Si una canalización no se inicia en absoluto, compruebe los siguientes problemas comunes relacionados con los desencadenadores.

• Configuración de la interfaz de usuario que invalida la configuración del desencadenador YAML
• Los desencadenadores de solicitud de extracción no se admiten Azure Repos
• Filtros de rama mal configurados en desencadenadores de CI y PR
• Conversiones de zona horaria de desencadenador programadas
• La configuración de la interfaz de usuario invalida los desencadenadores programados de YAML

Configuración de la interfaz de usuario que invalida la configuración del desencadenador YAML

Las canalizaciones YAML pueden invalidar su configuración de desencadenador y y en la interfaz de usuario triggerpr de configuración de canalización. Si los triggerpr desencadenadores o no parecen activarse, compruebe esa configuración. Al editar la canalización, elija ... y, a continuación, Desencadenadores.

Compruebe la opción Invalidar el desencadenador YAML desde aquí para ver los tipos de desencadenador (integración continua o validación de solicitudes de incorporación de incorporación de recursos) disponibles para el repositorio.

Los desencadenadores de solicitud de extracción no se admiten con Azure Repos

Si el desencadenador no se activa y usa Azure Repos, se debe a que los desencadenadores no se admiten prpr para Azure Repos. En Azure Repos Git, las directivas de rama se usan para implementar la validación de compilación de solicitudes de extracción. Para más información, consulte Directiva de rama para la validación de solicitudes de extracción.

Filtros de rama mal configurados en desencadenadores de CI y PR

Conversiones de zona horaria de desencadenador programadas

Los desencadenadores programados de YAML se establecen mediante la zona horaria UTC. Si los desencadenadores programados no parecen activarse a la hora adecuada, confirme las conversiones entre utc y la zona horaria local, teniendo en cuenta también la configuración del día. Para obtener más información, vea Desencadenadores programados.

La configuración de la interfaz de usuario invalida los desencadenadores programados de YAML

Si la canalización de YAML tiene desencadenadores programados yaml y desencadenadores programados definidos por la interfaz de usuario, solo se ejecutan los desencadenadores programados definidos por la interfaz de usuario. Para ejecutar los desencadenadores programados definidos por YAML en la canalización de YAML, debe quitar los desencadenadores programados definidos en la interfaz de usuario de configuración de canalización.

Para acceder a la interfaz de usuario de configuración de canalización desde una canalización yaml, edite la canalización, elija ... y, a continuación, Desencadenadores.

Quite todos los desencadenadores programados.

Una vez que se quitan todos los desencadenadores programados de la interfaz de usuario, se debe realizar una inserción para que los desencadenadores programados de YAML empiecen a ejecutarse. Para obtener más información, vea Desencadenadores programados.

Colas de canalización, pero nunca obtiene un agente

Si la canalización se pone en cola pero nunca obtiene un agente, compruebe los siguientes elementos.

Límites de trabajos paralelos: no hay agentes disponibles o se han alcanzado los límites gratuitos.

Demandas que no coinciden con las funcionalidades de un agente

Si la canalización tiene demandas que no cumplen las funcionalidades de ninguno de los agentes, la canalización no se iniciará. Si solo algunos de los agentes tienen las funcionalidades deseadas y actualmente están ejecutando otras canalizaciones, la canalización se detendrá hasta que uno de esos agentes esté disponible.

Para comprobar las funcionalidades y demandas especificadas para los agentes y las canalizaciones, consulte la sección Funcionalidades.

Testing agent connection.
VS30063: You are not authorized to access http://<SERVER>:8080/tfs

The job has been abandoned because agent did not renew the lock. Ensure agent is running, not sleeping, and has not lost communication with the service.

No se puede completar la canalización

Si la canalización obtiene un agente pero no se completa, compruebe los siguientes problemas comunes. Si el problema no parece coincidir con uno de estos, consulte Obtener registros para diagnosticar problemas.

• Tiempo de espera del trabajo
• Problemas al descargar código
• Mi canalización está fallando en un paso de línea de comandos, como MSBUILD.
• Errores de archivo o carpeta en uso
• Errores de MSBuild intermitentes o incoherentes
• El proceso deja de responder
• Finales de línea para varias plataformas
• Variables que tienen anexado ' (comilla simple)
• Problemas relacionados con la conexión de servicio

Tiempo de espera del trabajo

Una canalización puede ejecutarse durante mucho tiempo y, a continuación, producir un error debido al tiempo de espera del trabajo. El tiempo de espera del trabajo depende en gran medida del agente que se esté utilizando. Los agentes hospedados de Microsoft gratuitos tienen un tiempo de espera máximo de 60 minutos por trabajo para un repositorio privado y de 360 minutos para un repositorio público. Para aumentar el tiempo de espera máximo de un trabajo, puede optar por cualquiera de las opciones siguientes.

• Compre un agente hospedado por Microsoft que le dará 360 minutos para todos los trabajos, independientemente del repositorio usado.
• Usar un agente auto hospedado para descartar los problemas de tiempo de espera debidos al agente

Obtenga más información sobre el tiempo de espera del trabajo.

Problemas al descargar código

• Mi canalización está fallando en un paso de desprotección
• Control de versiones de Team Foundation problemas de Control de versiones de Team Foundation (TFVC)

Mi canalización está fallando en un paso de desprotección

Si usa un paso en un repositorio de Git de Azure Repos de su organización que se encuentra en un proyecto diferente al de la canalización, asegúrese de que la configuración Limitar el ámbito de autorización de trabajo al proyecto actual está deshabilitada o siga los pasos descritos en Identidades de compilación con ámbito para asegurarse de que la canalización tiene acceso al checkout repositorio. checkout

Cuando la canalización no pueda acceder al repositorio debido a un ámbito limitado de autorización de trabajo, recibirá el error y los registros contendrán una entrada Git fetch failed with exit code 128 similar a Remote: TF401019: The Git repository with name or identifier <your repo name> does not exist or you do not have permissions for the operation you are attempting.

Si la canalización está fallando inmediatamente con , asegúrese de que el nombre del proyecto y el repositorio son correctos en el paso o en la Could not find a project that corresponds with the repository declaración de recursos del checkout repositorio.

Control de versiones de Team Foundation (TFVC)

• Obtener orígenes que no descargan algunos archivos
• Obtener orígenes a través de Team Foundation Proxy

Obtener orígenes que no descargan algunos archivos

Esto puede caracterizarse por un mensaje en el registro "Todos los archivos actualizados" del comando tf get. Compruebe que la identidad de servicio integrada tiene permiso para descargar los orígenes. El servicio de compilación Project recopilación de identidades o Project Build Service necesitará permiso para descargar los orígenes, en función del ámbito de autorización seleccionado en la pestaña General de la canalización de compilación. En la interfaz de usuario web del control de versiones, puede examinar los archivos del proyecto en cualquier nivel de la jerarquía de carpetas y comprobar la configuración de seguridad.

Obtener orígenes a través de Team Foundation Proxy

La manera más fácil de configurar el agente para obtener orígenes a través de un proxy de Team Foundation es establecer una variable de entorno que apunte al servidor proxy TFVC para que el agente se ejecute TFSPROXY como usuario.

Windows:

    set TFSPROXY=http://tfvcproxy:8081
    setx TFSPROXY=http://tfvcproxy:8081 // If the agent service is running as NETWORKSERVICE or any service account you can't easily set user level environment variable

macOS y Linux:

    export TFSPROXY=http://tfvcproxy:8081

Mi canalización está fallando en un paso de línea de comandos como MSBUILD.

Resulta útil restringir si un error de compilación o versión es el resultado de un problema de producto Azure Pipelines/TFS (agente o tareas). Los errores de compilación y versión también pueden deber a comandos externos.

Compruebe los registros de la línea de comandos exacta ejecutada por la tarea con errores. Si intenta ejecutar el comando localmente desde la línea de comandos, puede reproducir el problema. Puede resultar útil ejecutar el comando localmente desde su propia máquina o iniciar sesión en la máquina y ejecutar el comando como cuenta de servicio.

Por ejemplo, ¿el problema se produce durante la MSBuild parte de la canalización de compilación (por ejemplo, usa la tarea de compilación MSBuild o Visual Studio compilación)? Si es así, intente ejecutar el mismo comando MSBuild en una máquina local con los mismos argumentos. Si puede reproducir el problema en un equipo local, los pasos siguientes son investigar el problema MSBuild problema.

# Script for Linux and macOS
pool: { vmImage: ubuntu-latest } # or whatever pool you use
steps:
- checkout: none
- bash: |
    SEARCH_PATH=$PATH  # or any colon-delimited list of paths
    IFS=':' read -r -a PathDirs <<< "$SEARCH_PATH"
    echo "##[debug] Found directories"
    for element in "${PathDirs[@]}"; do
        echo "$element"
    done;
    echo;
    echo;  
    echo "##[debug] Found files"
    for element in "${PathDirs[@]}"; do
        find "$element" -type f
    done

# Script for Windows
pool: { vmImage: windows-2019 } # or whatever pool you use
steps:
- checkout: none
- powershell: |
    $SEARCH_PATH=$Env:Path
    Write-Host "##[debug] Found directories"
    ForEach ($Dir in $SEARCH_PATH -split ";") {
      Write-Host "$Dir"
    }
    Write-Host ""
    Write-Host ""
    Write-Host "##[debug] Found files"
    ForEach ($Dir in $SEARCH_PATH -split ";") {
      Get-ChildItem $Dir -File -ErrorAction Continue | ForEach-Object -Process {
        Write-Host $_.FullName
      }
    }

Diferencias entre el símbolo del sistema local y el agente

Tenga en cuenta que hay algunas diferencias en vigor al ejecutar un comando en un equipo local y cuando se ejecuta una compilación o una versión en un agente. Si el agente está configurado para ejecutarse como un servicio en Linux, macOS o Windows, no se ejecuta dentro de una sesión interactiva de sesión iniciada. Sin una sesión interactiva de sesión iniciada, existe interacción con la interfaz de usuario y otras limitaciones.

Errores de archivos o carpetas en uso

Los errores de archivos o carpetas en uso a menudo se indican mediante mensajes de error como:

• Access to the path [...] is denied.
• The process cannot access the file [...] because it is being used by another process.
• Access is denied.
• Can't move [...] to [...]

Pasos para solucionar problemas:

• Detección de archivos y carpetas en uso
• Exclusión antivirus
• MSBuild y /nodeReuse:false
• MSBuild y /maxcpucount:[n]

Detección de archivos y carpetas en uso

En Windows, herramientas como Monitor de procesos pueden ser capturar un seguimiento de eventos de archivo en un directorio específico. O bien, para una instantánea a tiempo, se pueden usar herramientas como explorador de procesos o identificador.

Exclusión antivirus

El examen de software antivirus de los archivos puede provocar errores de archivo o carpeta en uso durante una compilación o versión. Agregar una exclusión antivirus para el directorio del agente y la "carpeta de trabajo" configurada puede ayudar a identificar el software antivirus como el proceso de interferencia.

MSBuild y /nodeReuse:false

Si invoca MSBuild durante la compilación, asegúrese de pasar el argumento /nodeReuse:false (forma corta /nr:false ). De lo MSBuild los procesos seguirán ejecutándose una vez completada la compilación. Los procesos permanecen durante algún tiempo en previsión de una posible compilación posterior.

Esta característica de MSBuild puede interferir con los intentos de eliminar o mover un directorio, debido a un conflicto con el directorio de trabajo del MSBuild procesos.

Las MSBuild y Visual Studio build ya se agregan /nr:false a los argumentos pasados a MSBuild. Sin embargo, si invoca MSBuild desde su propio script, deberá especificar el argumento .

MSBuild y /maxcpucount:[n]

De forma predeterminada, las tareas de compilación MSBuild y Visual Studio compilación se MSBuild con el modificador . En algunos casos, esto puede causar problemas como varios problemas de acceso a archivos de proceso.

Intente agregar el argumento a las tareas de compilación para /m:1 forzar MSBuild ejecutar solo un proceso a la vez.

Los problemas de archivo en uso pueden producirse al aprovechar la característica de proceso simultáneo de MSBuild. No especificar el argumento (forma corta) indica a /maxcpucount:[n] MSBuild que use un solo /m:[n] proceso. Si usa las tareas de compilación MSBuild o Visual Studio, es posible que tenga que especificar "/m:1" para invalidar el argumento "/m" que se agrega de forma predeterminada.

Errores de MSBuild intermitentes o incoherentes

Si experimenta errores de MSBuild intermitentes o incoherentes, intente indicar a MSBuild que use un solo proceso. Los errores intermitentes o incoherentes pueden indicar que la configuración de destino no es compatible con la característica de proceso simultáneo de MSBuild. Vea MSBuild y /maxcpucount:[n].

El proceso deja de responder

El proceso deja de responder a las causas y a los pasos de solución de problemas:

• Esperando la entrada
• Volcado de proceso
• Proyecto de WiX

Esperando la entrada

Un proceso que deja de responder puede indicar que un proceso está esperando la entrada.

La ejecución del agente desde la línea de comandos de una sesión interactiva que ha iniciado sesión puede ayudar a identificar si un proceso solicita entradas con un cuadro de diálogo.

La ejecución del agente como servicio puede ayudar a evitar que los programas soliciten entradas. Por ejemplo, en .NET, los programas pueden basarse en el valor booleano System.Environment.UserInteractive para determinar si se debe preguntar. Cuando se ejecuta como Windows servicio, el valor es false.

Volcado de proceso

Analizar un volcado del proceso puede ayudar a identificar en qué espera un proceso interbloqueado.

Proyecto de WiX

La creación de un proyecto de WiX cuando MSBuild personalizados están habilitados, puede hacer que WiX interbloquee la espera en el flujo de salida. Si agrega el argumento MSBuild /p:RunWixToolsOutOfProc=true adicional, se solucionará el problema.

Finales de línea para varias plataformas

Al ejecutar canalizaciones en varias plataformas, a veces puede encontrar problemas con distintos finales de línea. Históricamente, Linux y macOS usaban caracteres de linefeed (LF) mientras que Windows un retorno de carro más un linefeed (CRLF). Git intenta compensar la diferencia haciendo que las líneas terminen automáticamente en LF en el repositorio, pero CRLF en el directorio de trabajo en Windows.

La mayoría Windows herramientas están bien con los finales solo LF, y este comportamiento automático puede causar más problemas de los que resuelve. Si tiene problemas basados en finales de línea, se recomienda configurar Git para que prefiera LF en todas partes. Para ello, agregue un archivo a .gitattributes la raíz del repositorio. En ese archivo, agregue la línea siguiente:

* text eol=lf

Variables que tienen anexado ' (comilla simple)

Si la canalización incluye un script de Bash que establece variables mediante el comando , es posible que vea un adicional anexado al valor de ##vso' la variable que estableció. Esto se produce debido a una interacción con set -x . La solución es deshabilitar set -x temporalmente antes de establecer una variable. La sintaxis de Bash para hacerlo es set +x .

set +x
echo ##vso[task.setvariable variable=MY_VAR]my_value
set -x

¿Por qué ocurre esto?

Muchos scripts de Bash incluyen set -x el comando para ayudar con la depuración. Bash realizará un seguimiento exacto del comando que se ejecutó y lo hará eco en stdout. Esto hará que el agente vea el comando dos veces y, la segunda ##vso vez, Bash habrá agregado el ' carácter al final.

Por ejemplo, considere esta canalización:

steps:
- bash: |
    set -x
    echo ##vso[task.setvariable variable=MY_VAR]my_value

En stdout, el agente verá dos líneas:

##vso[task.setvariable variable=MY_VAR]my_value
+ echo '##vso[task.setvariable variable=MY_VAR]my_value'

Cuando el agente ve la primera línea, MY_VAR se establecerá en el valor correcto, "my_value". Sin embargo, cuando vea la segunda línea, el agente procesará todo hasta el final de la línea. MY_VAR se establecerá en "my_value".

Las bibliotecas no se instalan para la aplicación de Python cuando se ejecuta el script

Cuando se implementa una aplicación de Python, en algunos casos, se ejecuta una canalización de CI/CD y el código se implementa correctamente, pero el archivo requirements.txt responsable de instalar todas las bibliotecas de dependencias no se ejecuta.

Para instalar las dependencias, use un script posterior a la implementación en la App Service de implementación. En el ejemplo siguiente se muestra el comando que debe usar en el script posterior a la implementación. Puede actualizar el script para su escenario.

D:\home\python364x64\python.exe -m pip install -r requirements.txt

Problemas relacionados con la conexión de servicio

Para solucionar problemas relacionados con las conexiones de servicio, consulte Solución de problemas de conexión de servicio.

Habilite Explorador de Storage para implementar contenido estático como .css y .js en un sitio web estático desde Azure DevOps a través de Azure Pipelines

En este escenario, puede usar la tarea Copia de archivos de Azure para cargar contenido en el sitio web. Puede usar cualquiera de las herramientas descritas en Carga de contenido para cargar contenido en el contenedor web.

Obtener registros para diagnosticar problemas

Si ninguna de las sugerencias anteriores coincide con el problema, puede usar la información de los registros para diagnosticar la canalización con errores.

Empiece por ver los registros de la compilación o versión completadas. Para ver los registros, vaya al resumen de ejecución de canalización y seleccione el trabajo y la tarea. Si se ha generado un error en una tarea determinada, compruebe los registros de esa tarea.

Además de ver los registros en el resumen de la compilación de la canalización, puede descargar registros completos que incluyen información de diagnóstico adicional y puede configurar registros más detallados para ayudar con la solución de problemas.

Para obtener instrucciones detalladas sobre cómo configurar y usar registros, consulte Revisión de registros para diagnosticar problemas de canalización.

Necesito más ayuda. He encontrado un error. Tengo una sugerencia. ¿Dónde puedo ir?

Obtener suscripción, facturación y soporte técnico

Informe de cualquier problema o envíe comentarios en Developer Community.

Agradecemos sus sugerencias: