Build Steps · Substitutions · Artifacts

Cloud Build JSON to YAML
Converter

Convert JSON into a cloudbuild.yaml definition in seconds. Ideal for turning generated build config into the YAML Google Cloud Build expects. Free, instant, and browser-based.

JSON
YAML

How to Convert JSON to cloudbuild.yaml

1

Paste your build JSON

Drop in the JSON describing your steps, substitutions, and artifacts.

2

Get cloudbuild.yaml

Valid Cloud Build YAML appears instantly, with build steps correctly structured.

3

Submit the build

Copy or download as cloudbuild.yaml and run gcloud builds submit --config cloudbuild.yaml.

Why Cloud Build Uses YAML

Google Cloud Build defines build pipelines in cloudbuild.yaml, listing the ordered steps, their container images, arguments, and any artifacts to store.

Build definitions are often generated as JSON by tooling. Cloud Build accepts both JSON and YAML, but YAML is the readable default; converting gives you a config you can review and commit.

Benefits for Cloud Build Pipelines

Build-Ready

Output is valid cloudbuild.yaml you can submit with gcloud builds submit, steps intact.

Readable Steps

Ordered build steps and their args are far clearer in YAML than in nested JSON during review.

Comment Your Build

Explain why a step uses a specific image or substitution. YAML supports # comments; JSON does not.

Private Processing

Build configs reference substitutions and secrets. Conversion is local to your browser, so nothing is uploaded.

Frequently Asked Questions

Will the YAML work with gcloud builds submit?
Yes, provided your JSON matches Cloud Build structure (steps, optional substitutions and artifacts). Save it as cloudbuild.yaml and submit with --config.
Are build steps preserved?
Yes. The ordered steps array, including each step's name and args, converts exactly into the YAML Cloud Build expects.
How are substitutions handled?
Substitution variables like ${_MY_VAR} are strings and convert verbatim, keeping your parameterized build intact.
Why are some values quoted?
YAML quotes values that could be misread, such as numeric tags or timeouts. Cloud Build interprets the quoted values correctly.
Is my build config private?
Completely. Conversion runs in your browser, so substitutions and secret references never leave your machine.

Related Tools & Resources

© 2026 JSON YAML Converter