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.
For step-by-step guidance on this task directly in Google Cloud console, click Guide me:
The following sections take you through the same steps as clicking 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.
- Install and initialize the Google Cloud CLI.
-
Create or select a Google Cloud project.
-
Create a Cloud project:
gcloud projects create PROJECT_ID
-
Select a Cloud project:
gcloud config set project PROJECT_ID
-
-
Make sure that billing is enabled for your Cloud project. Learn how to check if billing is enabled on a project.
-
Enable the Pub/Sub API.
gcloud services enable pubsub
- Install and initialize the Google Cloud CLI.
-
Create or select a Google Cloud project.
-
Create a Cloud project:
gcloud projects create PROJECT_ID
-
Select a Cloud project:
gcloud config set project PROJECT_ID
-
-
Make sure that billing is enabled for your Cloud project. Learn how to check if billing is enabled on a project.
-
Enable the Pub/Sub API.
gcloud services enable pubsub
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 CLI prints the message to the command line.
How did it go?
What's next
Learn how to manage topics and subscriptions.
Learn more about publishing messages to topics and receiving messages from subscriptions.
Refer to the Pub/Sub overview.
Work through an end-to-end example of a Pub/Sub system.
Look through the gcloud CLI reference for Pub/Sub.