Neste documento, explicamos como usar e gerenciar reservas do Pub/Sub Lite. Este documento também explica o conceito de unidades de capacidade e como determinar quantas são necessárias para acomodar a capacidade de processamento do seu aplicativo.
Visão geral das reservas do Lite
As reservas do Lite provisionam e compartilham dinamicamente a capacidade de processamento entre um ou vários tópicos do Lite em uma região. Esses tópicos podem ser tópicos do Lite regionais ou zonais. Usar as reservas do Lite é uma opção melhor do que definir a capacidade de tópicos individuais do Lite. Com as reservas do Lite, você gerencia e monitora menos recursos. Além disso, você não precisa escolher a capacidade de processamento de tópicos individuais do Lite.
Para usar uma reserva do Lite, anexe um tópico do Lite que esteja na mesma região à reserva específica do Lite. É possível anexar uma única reserva do Lite a tópicos zonais e regionais do Lite. Todas as partições em um tópico do Lite anexado a uma reserva do Lite consomem dinamicamente a capacidade de processamento provisionada na reserva do Lite. Se você especificar uma reserva do Lite para um tópico do Lite, também poderá incluir limites de taxa para limitar a capacidade de processamento de cada partição do tópico do Lite.
Visão geral das unidades de capacidade
A capacidade de uma reserva do Lite é provisionada em unidades de capacidade.
Uma unidade de capacidade corresponde à seguinte capacidade:
Tipo de tópico do Lite | Capacidade de publicação em MiBps | Capacidade de processamento de assinatura em MiBps |
---|---|---|
Zonal | 1 | 2 |
Regional | 0,25 | 0,5 |
Diretrizes para nomear uma reserva
Um nome de recurso do Pub/Sub Lite identifica exclusivamente um recurso do Pub/Sub Lite, como um tópico, uma assinatura ou uma reserva. O nome do recurso precisa ter o seguinte formato:
projects/project-identifier/collection/ID
project-identifier
: precisa ser o ID ou número do projeto, disponível no console do Google Cloud. Por exemplo,my-cool-project
é um ID do projeto.123456789123
é um número de projeto.collection
: precisa sertopics
,subscriptions
oureservations
.ID
: precisa obedecer às seguintes diretrizes:- não começar com a string
goog
; - Começar com uma letra
- conter entre 3 e 255 caracteres;
- Conter apenas os seguintes caracteres: letras
[A-Za-z]
, números[0-9]
, traços-
, sublinhados_
, pontos.
, tils~
, sinais de adição+
e sinais de porcentagem%
É possível usar os caracteres especiais da lista anterior em nomes de recursos sem codificação para URL. No entanto, é preciso garantir que todos os outros caracteres especiais sejam codificados ou decodificados corretamente ao usá-los em URLs. Por exemplo,
mi-tópico
é um ID inválido. No entanto,mi-t%C3%B3pico
é válido. Esse formato é importante quando você faz chamadas REST.- não começar com a string
Diretrizes para usar uma reserva do Lite
O provisionamento da capacidade de processamento com reservas do Lite é obrigatório para tópicos regionais do Lite e opcional para tópicos zonais do Lite. Uma reserva do Lite é um recurso regional.
Lembre-se do seguinte ao planejar configurar uma reserva do Lite:
O número de unidades de capacidade necessárias para uma reserva do Lite precisa ser igual à capacidade de pico esperada em um determinado minuto em todos os tópicos e assinaturas nessa reserva do Lite.
Quando a capacidade combinada de todos os tópicos do Lite em uma reserva do Lite atingir a capacidade, a publicação e a exibição são limitadas. Os servidores do Pub/Sub Lite param de enviar mensagens aos clientes, e as mensagens são armazenadas em buffer no cliente do editor. É possível configurar um alerta para
reservation/throughput_capacity/utilization
a fim de informar quando a reserva corre o risco de ser limitada, assim você pode aumentar o tamanho dela.Atualize a capacidade de processamento das reservas sempre que quiser. As alterações entram em vigor em menos de um minuto. No entanto, se você diminuir a capacidade de uma reserva, continuará recebendo cobranças pelo valor mais alto por um período de 24 horas. O Pub/Sub Lite é inerentemente um sistema de pagamento por capacidade, em que os escalonamentos verticais são instantâneos e os reduções são possíveis.
Todos os tópicos do Lite anexados a uma reserva do Lite consomem o mesmo pool de capacidade de processamento. Portanto, é possível que um tópico do Lite use repentinamente uma grande quantidade de capacidade de processamento, privando outros tópicos do Lite e impedindo que eles publiquem ou recebam mensagens. Se você precisar de isolamento completo entre tópicos do Lite, anexe-os a reservas independentes.
Impacto das partições em uma reserva do Lite
O número total de partições em todos os tópicos do Lite em uma reserva do Lite não pode ser maior que o número de unidades de capacidade reservadas. Por exemplo, não é possível anexar uma reserva do Lite de 10 unidades de capacidade a um tópico do Lite ou um conjunto de tópicos do Lite com um número total de partições maior que 10.
Calcular unidades de capacidade para uma reserva do Lite
O tamanho de uma reserva do Lite é definido pelo número de unidades de capacidade. Os exemplos a seguir ilustram como estimar a capacidade necessária para tópicos individuais do Lite.
Determine o pico da capacidade de processamento de publicação.
Estime o pico na capacidade de processamento de todos os tópicos do Lite anexados à reserva do Lite. Uma estimativa aproximada da capacidade de processamento é suficiente, porque é possível atualizar o tamanho da reserva a qualquer momento.
Determine o pico da capacidade de processamento de assinatura.
O pico da capacidade de processamento de assinatura é calculado de forma semelhante ao pico da capacidade de publicação. No entanto, considere que os assinantes não precisam necessariamente receber mensagens na taxa de pico dos editores. Se atrasos no processamento forem aceitáveis, o Pub/Sub Lite permite armazenar mensagens em buffer e processá-las em uma taxa estável. Ao mesmo tempo, talvez você queira ter mais capacidade de assinatura do que de publicação para acomodar a inatividade ocasional dos assinantes.
Determine o número total de unidades de capacidade necessárias.
A tabela na seção anterior especifica o número de MiBps que uma unidade de capacidade pode acomodar para diferentes operações. Confira a fórmula abaixo para calcular as unidades de capacidade necessárias para uma reserva de amostra do Lite:
- Pico da capacidade de processamento de publicação dos tópicos zonais do Lite =
Pz MiBps
- Pico da capacidade de processamento de publicação dos tópicos regionais do Lite =
Pr MiBps
- Pico da capacidade de processamento de assinatura dos tópicos zonais do Lite =
Sz MiBps
Pico da capacidade de processamento de assinatura dos tópicos regionais do Lite =
Sr MiBps
Número de unidades de capacidade necessárias =
(Pz / 1 MiBps) + (Pr/0.25 MiBps) + (Sz/2 MiBps) + (Sr/0.5 MiBps)
Se o número não for inteiro, arredonde o valor.
- Pico da capacidade de processamento de publicação dos tópicos zonais do Lite =
Configure a capacidade de processamento sem uma reserva do Lite
Capacidade de publicação de tópicos: é possível especificar de 4 a 16 MiBps de capacidade de processamento, e o valor precisa ser um número inteiro.
Capacidade de assinatura do tópico: é possível especificar de 4 a 32 MiBps de capacidade de processamento, e o valor precisa ser um número inteiro.
Para a capacidade de processamento de assinatura, recomendamos que você provisione sua capacidade para ser igual ao produto da capacidade de publicação esperada e ao número de assinaturas no seu tópico.
A capacidade do editor e do assinante provisionada para um tópico individual não é intercambiável. Por esse motivo, recomendamos que você use sempre as reservas.
Há diferenças no faturamento ao provisionar capacidade diretamente para tópicos, em vez de usar reservas. Consulte a página de preços do Pub/Sub Lite para mais detalhes.
Criar uma reserva do Lite
Uma reserva do Lite precisa estar no mesmo projeto e região que qualquer tópico do Lite anexado a ela. Para uma lista das zonas e regiões disponíveis, consulte Locais do Pub/Sub Lite.
É possível criar uma reserva do Lite com o console do Google Cloud, a Google Cloud CLI ou a API Pub/Sub Lite.
Console
Acesse a página Reservas do Lite.
Clique em Criar reserva do Lite.
Selecione uma região.
Insira um ID de reserva do Lite.
Provisione a quantidade de unidades de capacidade.
Clique em Criar.
gcloud
Para criar uma reserva do Lite, use o
comando
gcloud pubsub lite-reservations create
:
gcloud pubsub lite-reservations create myRes \ --location=us-central1 \ --throughput-capacity=INTEGER_NUMBER_OF_UNITS
gcloud pubsub lite-topics create myTopic \ --throughput-reservation=myRez \ --zone=ZONE \ --location=us-central1a \ --partitions \ --storage
Go
Antes de executar esta amostra, siga as instruções de configuração do Go nas Bibliotecas de cliente do Pub/Sub Lite.
Java
Antes de executar esta amostra, siga as instruções de configuração do Java nas Bibliotecas de cliente do Pub/Sub Lite.
Python
Antes de executar esta amostra, siga as instruções de configuração do Python em Bibliotecas de cliente do Pub/Sub Lite.
Atualizar uma reserva do Lite
É possível atualizar o número de unidades de capacidade configuradas para uma reserva do Lite.
É possível atualizar uma reserva do Lite com o console do Google Cloud, a Google Cloud CLI ou a API Pub/Sub Lite.
Console
Acesse a página Reservas do Lite.
Clique no ID da reserva do Lite.
Na página de detalhes da reserva do Lite, clique em Editar.
gcloud
Para atualizar uma reservado Lite, use o
comando
gcloud pubsub lite-reservations update
:
gcloud pubsub lite-reservations update RESERVATION_ID \ --location=REGION \ --throughput-capacity=THROUGHPUT_CAPACITY
Substitua:
- RESERVATION_ID: o ID da reserva do Lite
- REGION: a região da reserva
- THROUGHPUT_CAPACITY: a capacidade de processamento de reserva.
Go
Antes de executar esta amostra, siga as instruções de configuração do Go nas Bibliotecas de cliente do Pub/Sub Lite.
Java
Antes de executar esta amostra, siga as instruções de configuração do Java nas Bibliotecas de cliente do Pub/Sub Lite.
Python
Antes de executar esta amostra, siga as instruções de configuração do Python em Bibliotecas de cliente do Pub/Sub Lite.
Mais detalhes da reserva do Lite
É possível ver detalhes sobre uma reserva do Lite usando o console do Google Cloud, a Google Cloud CLI ou a API Pub/Sub Lite.
Console
Acesse a página Reservas do Lite.
Clique no ID da reserva do Lite.
gcloud
Para ver detalhes sobre uma reserva do Lite, use o
comando
gcloud pubsub lite-reservations describe
:
gcloud pubsub lite-reservations describe RESERVATION_ID \ --location=REGION
Substitua:
- RESERVATION_ID: o ID da reserva do Lite
- REGION: a região da reserva
Go
Antes de executar esta amostra, siga as instruções de configuração do Go nas Bibliotecas de cliente do Pub/Sub Lite.
Java
Antes de executar esta amostra, siga as instruções de configuração do Java nas Bibliotecas de cliente do Pub/Sub Lite.
Python
Antes de executar esta amostra, siga as instruções de configuração do Python em Bibliotecas de cliente do Pub/Sub Lite.
Listar reservas do Lite
Console
Acesse a página Reservas do Lite.
gcloud
Para visualizar uma lista das reservas do Lite em um projeto, use o comando gcloud pubsub lite-reservations list
:
gcloud pubsub lite-reservations list \ --location=REGION
Substitua:
- REGION: a região da reserva
Go
Antes de executar esta amostra, siga as instruções de configuração do Go nas Bibliotecas de cliente do Pub/Sub Lite.
Java
Antes de executar esta amostra, siga as instruções de configuração do Java nas Bibliotecas de cliente do Pub/Sub Lite.
Python
Antes de executar esta amostra, siga as instruções de configuração do Python em Bibliotecas de cliente do Pub/Sub Lite.
Excluir uma reserva do Lite
É possível excluir reservas do Lite com o console do Google Cloud, a Google Cloud CLI ou a API Pub/Sub Lite. Para excluir uma reserva, ela não pode conter tópicos. É possível anexar tópicos atuais a uma reserva diferente e, em seguida, excluir a reserva.
Console
Acesse a página Reservas do Lite.
Clique no ID da reserva do Lite.
Na página de detalhes da reserva do Lite, clique em Excluir.
Na caixa de diálogo exibida, clique em Excluir para confirmar a exclusão da reserva do Lite.
gcloud
Para excluir uma reserva do Lite, use o
comando
gcloud pubsub lite-reservations delete
:
gcloud pubsub lite-reservations delete RESERVATION_ID \ --location=REGION
Substitua:
- RESERVATION_ID: o ID da reserva do Lite
- REGION: a região da reserva
Go
Antes de executar esta amostra, siga as instruções de configuração do Go nas Bibliotecas de cliente do Pub/Sub Lite.
Java
Antes de executar esta amostra, siga as instruções de configuração do Java nas Bibliotecas de cliente do Pub/Sub Lite.
Python
Antes de executar esta amostra, siga as instruções de configuração do Python em Bibliotecas de cliente do Pub/Sub Lite.
A seguir
- Saiba mais sobre os preços do Pub/Sub Lite.
- Crie um tópico do Lite.