Publish and receive messages in Pub/Sub by using the gcloud CLI

This page shows you how to do the following operations in Pub/Sub using the Google Cloud CLI:

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

To follow step-by-step guidance for this task directly in the Google Cloud console, click Guide me:

Before you begin

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.

Set up a Google 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 Google Cloud console.

Install the Google Cloud CLI.

If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

To initialize the gcloud CLI, run the following command:

gcloudinit

Set up a Google 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 Google Cloud console.

Install the Google Cloud CLI.

If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

To initialize the gcloud CLI, run the following command:

gcloudinit

Create a topic

Create a topic with the ID my-topic:

gcloudpubsubtopicscreatemy-topic

Create a subscription

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

gcloudpubsubsubscriptionscreatemy-sub--topic=my-topic

Publish messages

Publish a message to my-topic:

gcloudpubsubtopicspublishmy-topic--message="hello"

Receive messages

Receive the message from my-sub:

gcloudpubsubsubscriptionspullmy-sub--auto-ack

The gcloud CLI prints the message to the command line.

How did it go?

What's next

See all the available gCloud CLI commands for Pub/Sub
Learn more about the Pub/Sub concepts discussed in this page.
Read the basics of the Pub/Sub service.
Work through an end-to-end example of a Pub/Sub system.
Try another Pub/Sub quickstart that uses client libraries or the console.
Learn how to create topics and publish messages.
Choose a subscription type.
Learn more about Pub/Sub APIs.