Pubblica e ricevi messaggi in Pub/Sub utilizzando le librerie client
In questa pagina viene illustrato come:
Creare un progetto, abilitare la fatturazione e abilitare l'API Pub/Sub Lite utilizzando Google Cloud CLI.
Creare prenotazioni e argomenti e sottoscrizioni Lite utilizzando Google Cloud CLI.
Invia e ricevi messaggi utilizzando la libreria client Pub/Sub Lite per Go, Java e Python.
Prima di iniziare
- Accedi al tuo account Google Cloud. Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.
- Installa Google Cloud CLI.
-
Per initialize gcloud CLI, esegui questo comando:
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.
-
-
Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.
-
Attiva Pub/Sub Lite API.
gcloud services enable pubsublite.googleapis.com
-
Crea credenziali di autenticazione locali per il tuo Account Google:
gcloud auth application-default login
-
Concedi i ruoli al tuo Account Google. Esegui questo comando una volta per ciascuno dei seguenti ruoli IAM:
roles/pubsublite.admin
gcloud projects add-iam-policy-binding PROJECT_ID --member="user:EMAIL_ADDRESS" --role=ROLE
- Sostituisci
PROJECT_ID
con l'ID progetto. - Sostituisci
EMAIL_ADDRESS
con il tuo indirizzo email. - Sostituisci
ROLE
con ogni singolo ruolo.
- Sostituisci
- Installa Google Cloud CLI.
-
Per initialize gcloud CLI, esegui questo comando:
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.
-
-
Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.
-
Attiva Pub/Sub Lite API.
gcloud services enable pubsublite.googleapis.com
-
Crea credenziali di autenticazione locali per il tuo Account Google:
gcloud auth application-default login
-
Concedi i ruoli al tuo Account Google. Esegui questo comando una volta per ciascuno dei seguenti ruoli IAM:
roles/pubsublite.admin
gcloud projects add-iam-policy-binding PROJECT_ID --member="user:EMAIL_ADDRESS" --role=ROLE
- Sostituisci
PROJECT_ID
con l'ID progetto. - Sostituisci
EMAIL_ADDRESS
con il tuo indirizzo email. - Sostituisci
ROLE
con ogni singolo ruolo.
- Sostituisci
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 comando 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
. Nell'esempio seguente viene creato 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
Crea una sottoscrizione Lite
Per creare una sottoscrizione Lite, utilizza il comando gcloud pubsub lite-subscriptions create
. Nell'esempio seguente viene creata una sottoscrizione denominata 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 nella guida rapida di Pub/Sub Lite sull'utilizzo delle librerie client. Per maggiori informazioni, consulta la documentazione di riferimento dell'API Go Pub/Sub Lite.
Per eseguire l'autenticazione su Pub/Sub Lite, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Java
Python
Prima di provare questo esempio, segui le istruzioni per la configurazione di Python nella guida rapida di Pub/Sub Lite sull'utilizzo delle librerie client. Per maggiori informazioni, consulta la documentazione di riferimento dell'API Python Pub/Sub Lite.
Per eseguire l'autenticazione su 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 di messaggi ricevuti dal servizio Pub/Sub Lite.
Ricevere messaggi
Ricevi messaggi dalla sottoscrizione Lite utilizzando la seguente applicazione del sottoscrittore:
Go
Prima di provare questo esempio, segui le istruzioni per la configurazione di Go nella guida rapida di Pub/Sub Lite sull'utilizzo delle librerie client. Per maggiori informazioni, consulta la documentazione di riferimento dell'API Go Pub/Sub Lite.
Per eseguire l'autenticazione su 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 nella guida rapida di Pub/Sub Lite sull'utilizzo delle librerie client. Per maggiori informazioni, consulta la documentazione di riferimento dell'API Java Pub/Sub Lite.
Per eseguire l'autenticazione su Pub/Sub Lite, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Prima di provare questo esempio, segui le istruzioni per la configurazione di Python nella guida rapida di Pub/Sub Lite sull'utilizzo delle librerie client. Per maggiori informazioni, consulta la documentazione di riferimento dell'API Python Pub/Sub Lite.
Per eseguire l'autenticazione su Pub/Sub Lite, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Dopo che il sottoscrittore riceve un messaggio, stampa l'ID messaggio e i dati del messaggio.
Esegui la pulizia
Per evitare che al tuo account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questa pagina, elimina il progetto Google Cloud con le risorse.
- Per evitare che al tuo account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questa guida, elimina l'argomento e l'abbonamento.
gcloud pubsub lite-subscriptions delete testSub --location=us-central1 gcloud pubsub lite-topics delete testTopic --location=us-central1
-
Facoltativo: revoca le credenziali di autenticazione che hai creato ed elimina il file delle credenziali locale.
gcloud auth application-default revoke
-
Facoltativo: revoca le credenziali dallgcloud 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.
- Esamina gli esempi di codice per la libreria client.