Azure Pipelines
Azure DevOps Pipelines errors - resolved.
Fix Azure Pipelines failures: YAML syntax, tasks, agent pools, variable groups, service connections, and artifact errors.
YAML & tasks
Pipeline YAML, tasks, templates.
"Input required"Fix Azure Pipelines "##[error]Input required: <name>" - a task ran without a value for a required input becau…
"No space left on device"Fix Azure Pipelines "##[error]No space left on device" - the agent disk filled mid-run, usually from build ou…
"This task is deprecated"Fix Azure Pipelines "##[warning]This task is deprecated" - a task version or runner is end-of-life; the run s…
"command not found"Fix Azure Pipelines "<tool>: command not found" - a script called a CLI that is not installed or not on PATH…
"${{ }}" vs "$[ ]" vs "$( )"Fix Azure Pipelines expression-syntax mistakes - compile-time ${{ }} reading a runtime value, $[ ] used outsi…
"${{ each }}" failsFix Azure Pipelines "${{ each }}" loop errors - iterating a parameter that is a string instead of an object/s…
"A mapping was not expected"Fix the Azure Pipelines "A mapping was not expected" / "Unexpected value" YAML error caused by indentation th…
"template expression not allowed"Fix Azure Pipelines "A template expression is not allowed in this context" - using compile-time ${{ }} where…
"artifact publish failed"Fix Azure Pipelines artifact publish errors - "Path does not exist", duplicate artifact name, or empty publis…
"Bash exited with code 1"Fix Azure Pipelines "##[error]Bash exited with code 1" - a script step failed because a command returned non-…
"targetType is required"Fix Azure Pipelines Bash@3 input errors - a missing targetType, inline script absent for inline, or filePath…
"Cache restore failed"Fix transient Azure Pipelines Cache@2 errors - cache restore/save failures from a key mismatch, a too-large c…
"Cannot connect to the Docker daemon"Fix Azure Pipelines "Cannot connect to the Docker daemon at unix:///var/run/docker.sock" - the agent has the…
"Container failed to initialize"Fix Azure Pipelines "Container X failed to initialize" - a bad container image, a private-registry pull failu…
"Could not find any file matching the pattern"Fix Azure Pipelines "Could not find any file matching the pattern" - a download, copy, or publish task got a…
"dependsOn ... not found"Fix the Azure Pipelines error where a stage or job dependsOn references a name that does not exist, breaking…
"error(s) while parsing"Fix Azure Pipelines "Encountered error(s) while parsing pipeline YAML" - a structural YAML problem such as ba…
"MSB1009: Project file does not exist"Fix Azure Pipelines "error MSB1009: Project file does not exist" - MSBuild or the VSBuild/DotNet task pointed…
"pipeline must extend a template"Fix Azure Pipelines "Pipeline must extend a template" - a required-template approval/check forces pipelines t…
"depends on unknown job"Fix Azure Pipelines "Job X depends on unknown job Y" - a dependsOn that names a job that does not exist or li…
"mapping values are not allowed"Fix Azure Pipelines "mapping values are not allowed here" in azure-pipelines.yml - a YAML indentation or colo…
"PowerShell exited with code '1'"Fix Azure Pipelines "##[error]PowerShell exited with code '1'" - a PowerShell task failed because a cmdlet th…
"stage depends on unknown stage"Fix Azure Pipelines "Stage X depends on unknown stage Y" - a stage-level dependsOn that names a stage that do…
"Stage name X appears more than once"Fix the Azure Pipelines error where two stages or jobs share the same name, which the schema requires to be u…
"references undefined variable"Fix Azure Pipelines "Step input references undefined variable" - a task input or macro that names a variable…
"task ... not found"Fix Azure Pipelines "Job failed: The task X is not found" - a misspelled task name, missing major version, or…
"Template file could not be found"Fix the Azure Pipelines "template file X could not be found" error caused by a wrong path or a missing reposi…
"Template file not found"Fix Azure Pipelines "Template file X not found" / "could not resolve template" - a wrong path, missing reposi…
"nested task can not be used"Fix Azure Pipelines "The nested task X can not be used" - a meta/orchestration task placed inside a context w…
"The pipeline is not valid"Fix the Azure Pipelines "The pipeline is not valid" umbrella error - read the full validation list, which col…
"failed with exit code"Fix Azure Pipelines "##[error]The process '/usr/bin/...' failed with exit code N" - a wrapped tool (dotnet, g…
"task ... is ambiguous"Fix Azure Pipelines "The task X is ambiguous. Specify one of the following identifiers" - two installed exten…
"Unable to process command '##vso'"Fix Azure Pipelines "Unable to process command '##vso[...]'" - a logging command was malformed, so the agent…
"Unexpected value"Fix Azure Pipelines "Unexpected value 'X'" schema errors - a misspelled or misplaced property the pipeline sc…
"Unrecognized value"Fix the Azure Pipelines "Unrecognized value" error where a variable or expression token is not recognized at…
"image ... is deprecated"Fix Azure Pipelines hosted image errors - a deprecated/removed vmImage label like ubuntu-18.04 or vs2017-win2…
"existing checkout in the directory"Fix Azure Pipelines "You have an existing checkout in the current job directory" - multiple checkout steps or…
Condition always skipsFix Azure Pipelines conditions that always skip - a missing succeeded(), an overwritten implicit dependency,…
"container job" options invalidFix Azure Pipelines container job errors - a Windows container on a Linux host, missing volume mounts/options…
Cross-stage output emptyFix Azure Pipelines cross-stage output variables that come back empty - a missing isOutput=true, wrong stageD…
"Unexpected value" hookFix Azure Pipelines deployment lifecycle hook errors - a misspelled preDeploy/deploy/routeTraffic/postRouteTr…
"Unexpected value" in strategyFix Azure Pipelines deployment job strategy errors - using steps directly under deployment, a misspelled runO…
"environment resource not found"Fix Azure Pipelines "environment resource not found" - a deployment targeting a resource (VM/Kubernetes names…
"$( )" prints literallyFix Azure Pipelines macro variables that print literally instead of expanding - a variable not yet set, a sec…
"matrix ... must be a mapping"Fix Azure Pipelines "matrix must be a mapping" - the strategy.matrix block was written as a list or with wron…
Parameter type mismatchFix Azure Pipelines template parameter errors - "Unexpected parameter", a required parameter not provided, or…
"pipeline resource ... could not be found"Fix Azure Pipelines "pipeline resource could not be found" - a `resources.pipelines` reference names a source…
Artifact name mismatchFix Azure Pipelines DownloadPipelineArtifact failures - a download name that does not match what was publishe…
"No test result files"Fix Azure Pipelines PublishTestResults@2 "no test result files matching" - a searchFolder/testResultsFiles gl…
"is not a valid value"Fix Azure Pipelines typed template parameter validation - a value outside the declared `values:` list, or the…
"did not match any version"Fix Azure Pipelines "Version spec ... did not match" from UseDotNet or UsePythonVersion - the requested runti…
"Unexpected value 'X'"Fix Azure Pipelines "Unexpected value X" schema errors - a key the pipeline schema does not allow at that pos…
"pipeline is not valid"Fix the Azure Pipelines "azure-pipelines.yml schema validation" error where the YAML uses an unknown property…
Agents & pools
Agent pools, demands, capabilities.
No space left on Azure PipelinesFix "No Space Left on Device" on Azure Pipelines: why it happens and the Azure Pipelines-specific way to give…
"The operation was canceled"Fix Azure Pipelines "##[error]The operation was canceled" - the job was canceled by a timeout, a newer run su…
"lost communication with the server"Fix Azure Pipelines "The agent ... lost communication with the server" - a self-hosted agent dropped its conn…
"All ... agents are in use"Fix the Azure Pipelines wait where "all potential agents are in use" because the self-hosted pool has no free…
"Artifact not found"Fix Azure Pipelines "Artifact not found for download" - a DownloadPipelineArtifact/download step naming an ar…
"exited with code 1"Fix Azure Pipelines "Bash exited with code 1" and "Cmd.exe exited with code 1" - a script step whose command…
"depends on unknown job"Fix Azure Pipelines "Job X depends on unknown job Y" - a job-level dependsOn naming a job id that does not ex…
"No agent satisfies demands"Fix Azure Pipelines "No agent found in pool X which satisfies the specified demands" - a demand no agent in t…
"No agent found ... matches the demands"Fix the Azure Pipelines "No agent found in pool that satisfies the demands" error where no agent advertises t…
"No hosted parallelism"Fix Azure Pipelines "No hosted parallelism has been purchased or granted" - the org has zero Microsoft-hosted…
"No hosted parallelism purchased"Fix the Azure Pipelines "No hosted parallelism has been purchased or granted" error that blocks Microsoft-hos…
"No space left on device"Fix the Azure Pipelines "No space left on device" error where the agent ran out of disk during checkout, buil…
"pool ... not found"Fix Azure Pipelines "The pool X does not exist or has not been authorized" - a misnamed pool, a project that…
"ran longer than the maximum time"Fix Azure Pipelines "The job running on agent ... ran longer than the maximum time" - the job hit its timeout…
"ran longer than the maximum time"Fix the Azure Pipelines timeout where a job ran longer than its maximum time and was canceled, from slow work…
"agent did not connect"Handle Azure Pipelines "The agent did not connect within the allocated time" - a self-hosted or container age…
"pipeline is not valid"Fix Azure Pipelines "The pipeline is not valid" - an umbrella compile error that aggregates one or more struc…
"We stopped hearing from agent"Fix the Azure Pipelines "We stopped hearing from agent" error where the service lost communication with the a…
"tar failed / restore failed"Handle Azure Pipelines Cache@2 "tar failed" and "cache restore failed" - an archive error or transient backen…
Cache service timeoutHandle transient Azure Pipelines Cache@2 service timeouts during restore/save - backend blips that clear on r…
"image pull failed"Handle Azure Pipelines container job "image pull failed" - a registry timeout, rate limit, or missing endpoin…
No available agentFix Azure Pipelines jobs that sit queued then time out waiting for a free agent - every self-hosted agent is…
"tool not found"Fix Azure Pipelines "tool not found" for npm/dotnet tasks - the required SDK/tool is not installed on the age…
"Out of memory / process killed"Fix the Azure Pipelines out-of-memory failure where a build step or the agent was killed because the host ran…
Parallelism grant pendingHandle Azure Pipelines runs that sit queued while a hosted parallelism grant is still pending - a transient b…
Agent offlineFix Azure Pipelines jobs stuck queued because the self-hosted agent is offline - the agent service stopped, l…
capabilities vs demandsFix Azure Pipelines self-hosted "capabilities do not match demands" - a job whose demands no agent satisfies…
Self-hosted demands mismatchFix Azure Pipelines self-hosted demands that no agent meets - a custom capability value, a -equals/-gtVersion…
Registry timeout on Azure PipelinesFix Dependency Download Timeout / Registry 5xx on Azure Pipelines: why it happens and the Azure Pipelines-spe…
Exit code 137 on Azure PipelinesFix Exit Code 137 (Out of Memory) on Azure Pipelines: why it happens and the Azure Pipelines-specific way to…
Job timeout on Azure PipelinesFix Job Timeout / Exceeded Maximum Time on Azure Pipelines: why it happens and the Azure Pipelines-specific w…
Auth & connections
Service connections, variable groups.
"az login ... failed"Fix the Azure Pipelines "az login" service principal failure where AzureCLI authentication is rejected due to…
"Authentication failed" on pushFix Azure Pipelines git push-back failures - checkout did not persist credentials, so a later git push from t…
"Could not get an access token"Fix the Azure Pipelines "Could not get an access token" OIDC error where workload identity federation failed…
"does not have permissions"Fix Azure Pipelines "Pipeline does not have permissions to use the protected resource" - a service connection…
"resource not authorized"Fix Azure Pipelines "resource not authorized" for a declared pipeline/repository resource - a `resources:` re…
"TF400813: not authorized"Fix the Azure Pipelines TF400813 / 401 Unauthorized error where the user or identity is not authorized to acc…
"TF400813: not authorized"Fix Azure DevOps "TF400813: The user X is not authorized to access this resource" - a permissions gap for the…
"remote certificate is invalid"Fix the Azure Pipelines "The remote certificate is invalid according to the validation procedure" error from…
"secure file ... could not be downloaded"Fix Azure Pipelines "##[error]The secure file could not be downloaded" - DownloadSecureFile failed because th…
"does not have permission"Fix the Azure Pipelines "user does not have permission" error caused by a personal access token whose scopes…
"scriptType is not valid"Fix Azure Pipelines AzureCLI@2 input errors - a bad scriptType (bash/pscore/ps/batch), wrong scriptLocation,…
"Key Vault secret not found"Fix Azure Pipelines AzureKeyVault@2 errors - a secret name that does not exist, a Key Vault access policy mis…
Waiting for approvalFix Azure Pipelines deployment jobs stuck "Waiting for approval" or failing on an environment check - a requi…
"requires approval"Understand Azure Pipelines deployments that pause for an environment approval check - the run waits for an ap…
Environment check failedFix Azure Pipelines deployment runs blocked by a failed environment check - an Invoke REST API gate, an Azure…
Multi-repo checkout deniedFix Azure Pipelines multi-repo checkout failures - a second repository resource not declared, not authorized,…
"npm ERR! code ENEEDAUTH"Fix Azure Pipelines "npm ERR! code ENEEDAUTH" - npm reached an Azure Artifacts feed but had no auth token, be…
"NU1101: Unable to find package"Fix Azure Pipelines "error NU1101: Unable to find package X" - restore reached its sources but none of them,…
"Unable to load the service index for source"Fix Azure Pipelines "Unable to load the service index for source" - dotnet/NuGet restore hit a private Azure…
"nuget restore failed"Fix Azure Pipelines NuGet restore failures from feed authentication - a missing/expired service connection fo…
"not authorized to use the repository"Fix Azure Pipelines "the pipeline is not authorized to use the repository" - a resources.repositories referen…
Connection approval pendingFix Azure Pipelines runs paused on a service connection approval or check - a protected-resource Approvals/ch…
"service connection ... not authorized"Fix the Azure Pipelines service connection authorization error where a pipeline is not permitted to use the r…
Service connection expiredFix Azure Pipelines AzureCLI@2 auth failures from an expired service-connection secret or a service principal…
Service connection not authorizedFix Azure Pipelines "The pipeline is not authorized to use the service connection" - approve pipeline access…
"variable group not authorized"Fix Azure Pipelines "variable group not authorized" - a `variables: group:` reference the pipeline has not be…
Variable group not authorizedFix Azure Pipelines "Variable group X could not be found or is not authorized for use by this pipeline" - aut…
Explore other topics
GitHub ActionsWorkflow, runner, and YAML errors - diagnosed and fixed.
Node.js & npmnpm, yarn, and pnpm failures in CI - solved.
DockerBuild, run, compose, and registry errors - explained.
Pythonpip, poetry, venv, and pytest failures - fixed.
Java & JVMMaven, Gradle, and JVM failures in CI - resolved.
GoGo build, module, and test failures - diagnosed.