Quickstart using the gcloud command-line tool

This page shows you how to do the following operations in Pub/Sub using the gcloud command-line tool:

  • Create a topic and subscription.
  • Publish messages to the topic.
  • Receive messages from the subscription.

For step-by-step guidance on this task directly in Google Cloud Console, click Guide me:

Guide me


The following sections take you through the same steps as clicking Guide me.

Before you begin

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
  2. Set up a Cloud Console project.

    Set up a project

    Click to:

    • Create or select a project.
    • Enable the Pub/Sub API for that project.

    You can view and manage these resources at any time in the Cloud Console.

  3. Install and initialize the Cloud SDK.
  4. Set up a Cloud Console project.

    Set up a project

    Click to:

    • Create or select a project.
    • Enable the Pub/Sub API for that project.

    You can view and manage these resources at any time in the Cloud Console.

  5. Install and initialize the Cloud SDK.

Create a topic

Create a topic with the ID my-topic:

gcloud pubsub topics create my-topic

Create a subscription

Create a subscription with the ID my-sub and attach it to my-topic:

gcloud pubsub subscriptions create my-sub --topic=my-topic

Publish messages

Publish a message to my-topic:

gcloud pubsub topics publish my-topic --message="hello"

Receive messages

Receive the message from my-sub:

gcloud pubsub subscriptions pull my-sub --auto-ack

The gcloud tool prints the message to the command line.

How did it go?

What's next