Pubblica e ricevi messaggi in Pub/Sub utilizzando le librerie client
Questa pagina illustra come:
Crea un progetto, attiva la fatturazione e l'API Pub/Sub Lite utilizzando Google Cloud CLI.
Crea prenotazioni Lite, argomenti Lite e iscrizioni Lite utilizzando Google Cloud CLI.
Invia e ricevi messaggi utilizzando la libreria client Pub/Sub Lite per come Go, Java e Python.
Prima di iniziare
- 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 the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
Create or select a Google Cloud project.
-
Create a Google Cloud project:
gcloud projects create PROJECT_ID
Replace
PROJECT_ID
with a name for the Google Cloud project you are creating. -
Select the Google Cloud project that you created:
gcloud config set project PROJECT_ID
Replace
PROJECT_ID
with your Google Cloud project name.
-
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Pub/Sub Lite API:
gcloud services enable pubsublite.googleapis.com
-
Create local authentication credentials for your user account:
gcloud auth application-default login
-
Grant roles to your user account. Run the following command once for each of the following IAM roles:
roles/pubsublite.admin
gcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE
- Replace
PROJECT_ID
with your project ID. -
Replace
USER_IDENTIFIER
with the identifier for your user account. For example,user:myemail@example.com
. - Replace
ROLE
with each individual role.
- Replace
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
Create or select a Google Cloud project.
-
Create a Google Cloud project:
gcloud projects create PROJECT_ID
Replace
PROJECT_ID
with a name for the Google Cloud project you are creating. -
Select the Google Cloud project that you created:
gcloud config set project PROJECT_ID
Replace
PROJECT_ID
with your Google Cloud project name.
-
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Pub/Sub Lite API:
gcloud services enable pubsublite.googleapis.com
-
Create local authentication credentials for your user account:
gcloud auth application-default login
-
Grant roles to your user account. Run the following command once for each of the following IAM roles:
roles/pubsublite.admin
gcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE
- Replace
PROJECT_ID
with your project ID. -
Replace
USER_IDENTIFIER
with the identifier for your user account. For example,user:myemail@example.com
. - Replace
ROLE
with each individual role.
- Replace
installa la libreria client
Go
go get cloud.google.com/go/pubsublite
Java
If you are using Maven, add
the following to your pom.xml
file. For more information about
BOMs, see The Google Cloud Platform Libraries BOM.
If you are using Gradle, add the following to your dependencies:
If you are using sbt, add the following to your dependencies:
If you're using Visual Studio Code, IntelliJ, or Eclipse, you can add client libraries to your project using the following IDE plugins:
The plugins provide additional functionality, such as key management for service accounts. Refer to each plugin's documentation for details.
Python
pip install --upgrade google-cloud-pubsublite
Crea una prenotazione Lite
Per creare una prenotazione Lite, utilizza il metodo
gcloud pubsub lite-reservations create
. Nell'esempio seguente viene creata una prenotazione denominata testRes
.
gcloud pubsub lite-reservations create testRes \ --location=us-central1 \ --throughput-capacity=1
Crea un argomento Lite a livello di regione
Per creare un argomento Lite a livello di regione, utilizza il comando gcloud pubsub lite-topics create
. L'esempio seguente crea un argomento denominato testTopic
.
gcloud pubsub lite-topics create testTopic \ --location=us-central1 \ --partitions=1 \ --per-partition-bytes=30GiB \ --throughput-reservation=projects/PROJECT_ID/locations/us-central1/reservations/testRes \
Sostituisci quanto segue:
PROJECT_ID: l'ID del progetto
Creare una sottoscrizione Lite
Per creare un abbonamento Lite, utilizza il comando
gcloud pubsub lite-subscriptions create
. L'esempio seguente crea un abbonamento denominato testSub
.
gcloud pubsub lite-subscriptions create testSub \ --location=us-central1 \ --topic=testTopic \ --delivery-requirement=deliver-immediately
Inviare messaggi
Invia messaggi all'argomento Lite utilizzando la seguente applicazione del publisher:
Go
Prima di provare questo esempio, segui le istruzioni per la configurazione di Go nel Guida rapida di Pub/Sub Lite con librerie client. Per ulteriori informazioni, consulta API Pub/Sub Lite Go documentazione di riferimento.
Per eseguire l'autenticazione su Pub/Sub Lite, configura le credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Java
Python
Prima di provare questo esempio, segui le istruzioni per la configurazione di Python nel Guida rapida di Pub/Sub Lite con librerie client. Per ulteriori informazioni, consulta API Pub/Sub Lite Python documentazione di riferimento.
Per autenticarti a Pub/Sub Lite, configura le credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Il publisher invia 100 messaggi a un argomento Lite e stampa il numero e i messaggi ricevuti dal servizio Pub/Sub Lite.
Ricevere messaggi
Ricevi messaggi dalla sottoscrizione Lite utilizzando il seguente sottoscrittore applicazione:
Go
Prima di provare questo esempio, segui le istruzioni di configurazione di Go riportate nella guida rapida di Pub/Sub Lite che utilizza le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Pub/Sub Lite Go.
Per autenticarti a Pub/Sub Lite, configura le credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Java
Prima di provare questo esempio, segui le istruzioni per la configurazione di Java nel Guida rapida di Pub/Sub Lite con librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Pub/Sub Lite Java.
Per autenticarti a Pub/Sub Lite, configura le credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Prima di provare questo esempio, segui le istruzioni per la configurazione di Python nel Guida rapida di Pub/Sub Lite con librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Pub/Sub Lite Python.
Per autenticarti a Pub/Sub Lite, configura le credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Dopo aver ricevuto un messaggio, l'abbonato stampa l'ID messaggio e i dati del messaggio.
Esegui la pulizia
Per evitare che al tuo account Google Cloud vengano addebitati costi per le risorse utilizzate in questa pagina, elimina il progetto Google Cloud Google Cloud.
- Per evitare che al tuo account Google Cloud vengano addebitati costi relativi alla
utilizzate in questa guida, elimina l'argomento e la sottoscrizione.
gcloud pubsub lite-subscriptions delete testSub --location=us-central1 gcloud pubsub lite-topics delete testTopic --location=us-central1
-
Optional: Revoke the authentication credentials that you created, and delete the local credential file.
gcloud auth application-default revoke
-
Optional: Revoke credentials from the gcloud CLI.
gcloud auth revoke
Passaggi successivi
- Scopri di più sugli argomenti Lite e sulle sottoscrizioni Lite.
- Scopri di più su come inviare e ricevere messaggi.
- Consulta gli esempi di codice per la libreria client.