Pubblica e ricevi messaggi in Pub/Sub utilizzando le librerie client
In questa pagina viene illustrato come:
Crea un progetto, abilita la fatturazione e abilita 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 come 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.
- 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.
-
-
Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.
-
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_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.
-
-
Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.
-
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_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
. 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
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 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 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.
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 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
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 API Pub/Sub Lite Java 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.
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 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.
Dopo che il sottoscrittore riceve un messaggio, egli stampa il relativo ID e i dati dei messaggi.
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 per
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 Abbonamenti Lite.
- Scopri di più sull'invio e ricezione messaggi.
- Esplora esempi di codice per la libreria client.