Cloud Build Quickstart

Quickstart for using the Cloud Build API

Documentation pages that include this code sample

To view the code sample used in context, see the following documentation:

Code sample


async function quickstart(
  projectId = 'YOUR_PROJECT_ID', // Your Google Cloud Platform project ID
  triggerId = 'YOUR_TRIGGER_ID', // UUID for build trigger.
  branchName = 'BRANCH_TO_BUILD' // Branch to run build against.
) {
  // Imports the Google Cloud client library
  const {CloudBuildClient} = require('@google-cloud/cloudbuild');

  // Creates a client
  const cb = new CloudBuildClient();

  // Starts a build against the branch provided.
  const [resp] = await cb.runBuildTrigger({
    source: {
      dir: './',
  });`triggered build for ${triggerId}`);
  const [build] = await resp.promise();

  const STATUS_LOOKUP = [
  for (const step of build.steps) {
      `step:\n\tname: ${}\n\tstatus: ${STATUS_LOOKUP[build.status]}`


import google.auth
from import cloudbuild_v1

def quickstart():
    """Create and execute a simple Google Cloud Build configuration,
    print the in-progress status and print the completed status."""

    # Authorize the client with Google defaults
    credentials, project_id = google.auth.default()
    client =

    build = cloudbuild_v1.Build()

    # The following build steps will output "hello world"
    # For more information on build configuration, see
    build.steps = [{"name": "ubuntu",
                    "entrypoint": "bash",
                    "args": ["-c", "echo hello world"]}]

    operation = client.create_build(project_id=project_id, build=build)
    # Print the in-progress operation
    print("IN PROGRESS:")

    result = operation.result()
    # Print the completed status
    print("RESULT:", result.status)

What's next

To search and filter code samples for other Google Cloud products, see the Google Cloud sample browser