Skip to content
Latchkey
Bitbucket Pipelines

Bitbucket Pipelines errors - fixed.

Resolve Bitbucket Pipelines failures: bitbucket-pipelines.yml config, runners, caches, deployments, and pipe errors.

Config & steps

bitbucket-pipelines.yml, steps, parallel.

"after-script"Understand Bitbucket after-script behavior - it runs even when the step fails, and its own exit code does not… "Allocated memory"Fix Bitbucket service/step memory allocation errors - when service containers request more than the step memo… "condition" changesetsFix Bitbucket step condition changesets - when includePaths globs never match (step always skipped) or match… "exceeded memory limit"Fix Bitbucket "Container 'Build' exceeded memory limit" - the build container was OOM-killed. Raise step size… custom cache pathFix Bitbucket custom cache definitions that never restore - a `definitions: caches:` path that does not exist… "Failed to pull image"Fix Bitbucket Pipelines image pull failures - a wrong build image name/tag, or a private registry image with… "mapping values not allowed"Fix Bitbucket "mapping values are not allowed here" - an unquoted value containing a colon, or a misindented… "Maximum number of ... services"Fix Bitbucket "maximum number of services" - when a step declares more service containers than Bitbucket allo… "maximum number of steps"Fix Bitbucket "maximum number of steps" - when a pipeline declares more steps than Bitbucket allows. Consolid… "parallel" stepsFix Bitbucket parallel step grouping - wrong indentation that serializes steps, or one failing branch cancell… "exited with code 1"Fix Bitbucket "The command ... exited with code 1" - a real failure in your build command, not a Pipelines bu… "stage" groupingFix Bitbucket "stage" configuration errors - a stage with no steps, steps placed outside the stage, or a depl… "pipeline ... is not configured"Fix Bitbucket "The <name> pipeline is not configured" - when a push or custom run finds no matching pipeline… "couldn't parse your yml"Fix Bitbucket "We couldn't parse your bitbucket-pipelines.yml" - a structural YAML error (bad indentation, ta… "couldn't parse"Fix Bitbucket "We couldn't parse your bitbucket-pipelines.yml" - raw YAML syntax errors like bad indentation,… "exceeded the maximum build time"Fix Bitbucket "Your build exceeded the maximum build time" - when a step runs past the build-time limit and i… "did not match any files"Fix Bitbucket "artifact path did not match any files" - an artifacts paths glob that points at the wrong dire… artifacts pathsFix Bitbucket artifacts not appearing downstream - an artifacts paths glob that matches nothing, or download:… "cache not defined"Fix Bitbucket "cache X is not defined" - a step that lists a cache name with no matching definitions: caches:… custom pipeline triggerUnderstand Bitbucket custom pipelines that never auto-run - they live under pipelines: custom: and only start… service not definedFix Bitbucket "service ... is not defined" - when a step references a custom service that has no entry under… docker service memoryFix Bitbucket docker-in-pipelines builds killed for memory - the docker service has a small default budget th… "max number of steps"Fix Bitbucket "max number of steps exceeded" - a pipeline with more steps than the per-pipeline limit, often… "variable not set"Fix Bitbucket scripts that fail because a pipeline variable is not set - a repository/workspace/deployment va… "Configuration error"Fix Bitbucket Pipelines "Configuration error" - when bitbucket-pipelines.yml is structurally invalid and the… shallow cloneFix Bitbucket Pipelines shallow-clone failures - missing history or tags because the default clone depth is t… service failed to startFix Bitbucket service containers that never become ready - a database or queue service crashes or is not list… "max-time"Fix Bitbucket steps stopped by a too-low max-time - a per-step minute cap below the work it needs, cutting th… "size: 4x/8x"Fix Bitbucket "size" errors - requesting 4x/8x memory the plan or runner does not offer, so the step cannot b… YAML anchorFix Bitbucket YAML anchor and alias errors - referencing an alias (*name) before its anchor (&name) is define…

Runners & caches

Self-hosted runners, caches, artifacts.

No space left on Bitbucket PipelinesFix "No Space Left on Device" on Bitbucket Pipelines: why it happens and the Bitbucket Pipelines-specific way… "Cache ... not found"Understand Bitbucket "Cache not found" - a cold cache or changed key is expected on first runs, but a persist… "docker exceeded memory"Handle Bitbucket "Container docker exceeded memory limit" - the docker service ran out of its memory budget d… "docker: not enabled"Fix Bitbucket Docker errors - "Cannot connect to the Docker daemon" / docker not available - by adding the do… "No runner matched the labels"Fix Bitbucket "No runner matched the labels" - when a step requires runner labels that no online self-hosted… "Artifact ... not found"Fix Bitbucket artifacts not passing between steps - a downstream step misses files because the producer never… clone lfsFix Bitbucket Pipelines where Git LFS files are pointer files, not real content - enable clone: lfs so LFS ob… exit code 137Handle Bitbucket exit code 137 - a process killed by the out-of-memory killer (SIGKILL) when it exceeded the… runs-on labelsFix Bitbucket runs-on label matching - a step’s labels must be a subset of a runner’s; extra step labels or a… runner offlineFix Bitbucket self-hosted runner offline - when the runner lost connectivity or stopped, leaving steps queued… runner setup incompleteFix Bitbucket self-hosted runners that never come online after setup - missing Docker/permissions, wrong OAut… service start (memory)Handle Bitbucket "service failed to start" caused by memory - a service container with too small a budget tha… "step exceeded memory"Handle Bitbucket "step exceeded memory limit" - the build container ran out of its allocated memory, fixable… Registry timeout on Bitbucket PipelinesFix Dependency Download Timeout / Registry 5xx on Bitbucket Pipelines: why it happens and the Bitbucket Pipel… Exit code 137 on Bitbucket PipelinesFix Exit Code 137 (Out of Memory) on Bitbucket Pipelines: why it happens and the Bitbucket Pipelines-specific… Job timeout on Bitbucket PipelinesFix Job Timeout / Exceeded Maximum Time on Bitbucket Pipelines: why it happens and the Bitbucket Pipelines-sp…

Deploys & pipes

Deployments, pipes, variables.

"branches:" / "default:"Fix Bitbucket branch pipeline selection - a branch glob that overlaps default, or no default catch-all, so th… "custom:" pipelineFix Bitbucket custom pipelines that do not appear or fail to trigger - missing custom: section, required vari… "must happen in order"Fix Bitbucket "you can't deploy to X because deployments must happen in order" - promoting to a later environ… "Invalid credentials"Fix Bitbucket Pipelines "Invalid credentials" / repository access denied - bad app password, token, or SSH ke… "no basic auth credentials"Fix Bitbucket "no basic auth credentials" on docker push - pushing an image to a registry without first loggi… "pipe failed"Fix Bitbucket "pipe X failed" - a pipe step that returned non-zero from a missing required variable, a downst… "pull-requests:" pipelineFix Bitbucket pull-request pipelines that never run - the pull-requests section is missing, the branch glob d… "pull rate limit"Handle Bitbucket Docker Hub pull rate limit errors - anonymous image pulls hitting Docker Hub limits, fixable… "exceeded the max time"Handle Bitbucket "your build exceeded the max time" - a pipeline that ran past the overall build time limit,… BITBUCKET_* env varsFix scripts relying on BITBUCKET_* variables - values like BITBUCKET_PR_ID or BITBUCKET_TAG that only exist o… build minutes exhaustedFix Bitbucket Pipelines blocked because the workspace ran out of build minutes - top up, upgrade the plan, or… deployment gatedFix Bitbucket deployments blocked by environment restrictions - admin-only deploys, required approvals, or br… "environment locked"Handle Bitbucket "deployment environment locked" - a deploy held because another deployment to the same envir… environment not foundFix Bitbucket "deployment environment not found" / not configured - when a step references a deployment that… LFS over quotaFix Bitbucket clone failures from Git LFS over quota - the repository's LFS storage/bandwidth budget is exhau… oidc: trueFix Bitbucket OIDC failures - BITBUCKET_STEP_OIDC_TOKEN empty because the step lacks oidc: true, or the cloud… pipe authFix Bitbucket pipe authentication failures - a deploy pipe rejected by the cloud provider because credentials… "Error: ... pipe"Fix Bitbucket pipe failures - when a pipe (e.g. atlassian/aws-s3-deploy) errors due to missing variables, bad… pipe variablesFix Bitbucket pipe variable errors - array-typed pipe variables passed as a scalar, or multiline values not f… variable not setFix Bitbucket Pipelines empty/undefined variables - when a deployment or step variable is unset, wrongly scop… secured variableFix Bitbucket secrets appearing in logs - a variable not marked secured, or a transformed value (base64, JSON…
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.