En este documento, se explica cómo usar y administrar las reservas de Pub/Sub Lite. En este documento, también se explica el concepto de unidades de capacidad y cómo determinar cuántas necesitas para adaptarse a la capacidad de procesamiento de tu aplicación.
Descripción general de las reservas de Lite
Las reservas de Lite aprovisionan y comparten de forma dinámica la capacidad de procesamiento entre uno o varios temas de Lite en una región. Estos temas pueden ser regionales o zonales de Lite. Usar reservas de Lite es una mejor opción que configurar la capacidad de procesamiento de los temas individuales de Lite. Con las reservas de Lite, puedes administrar y supervisar menos recursos. Además, no tienes que elegir la capacidad de procesamiento de los temas de Lite individuales.
Para usar una reserva de Lite, debes adjuntar un tema de Lite que se encuentre en la misma región a la reserva de Lite específica. Puedes adjuntar una sola reserva de Lite a los temas de Lite zonales y regionales. Todas las particiones de un tema de Lite que está conectado a una reserva de Lite consumen de forma dinámica la capacidad de procesamiento aprovisionada en la reserva de Lite. Si especificas una reserva de Lite para un tema Lite, también puedes incluir límites de frecuencia para limitar la capacidad de procesamiento de cada partición del tema de Lite.
Descripción general de las unidades de capacidad
La capacidad de procesamiento de una reserva de Lite se aprovisiona en unidades de capacidad.
Una unidad de capacidad corresponde a la siguiente capacidad de procesamiento:
Tipo de tema Lite | Capacidad de procesamiento de publicación en MiBps | Capacidad de procesamiento de suscripción en MiBps |
---|---|---|
Zonal | 1 | 2 |
Regional | 0.25 | 0.5 |
Lineamientos para asignar un nombre a una reserva
El nombre de un recurso de Pub/Sub Lite identifica de forma única a un recurso de Pub/Sub Lite, como un tema, una suscripción o una reserva. El nombre del recurso debe tener el siguiente formato:
projects/project-identifier/collection/ID
project-identifier
: Debe ser el ID o número del proyecto, disponible en la consola de Google Cloud. Por ejemplo,my-cool-project
es un ID del proyecto.123456789123
es un número de proyecto.collection
: Debe sertopics
,subscriptions
oreservations
.ID
: Debe cumplir con los siguientes lineamientos:- No debe comenzar con la cadena
goog
. - Comenzar con una letra
- tener entre 3 y 255 caracteres
- Contener solo los siguientes caracteres: letras
[A-Za-z]
, números[0-9]
, guiones-
, guiones bajos_
, puntos.
, virgulillas~
, signos más+
y signos de porcentaje%
Puedes usar los caracteres especiales de la lista anterior en los nombres de recursos sin codificación de URL. Sin embargo, debes asegurarte de que los demás caracteres especiales estén codificados o decodificados de forma correcta cuando los uses en las URLs. Por ejemplo,
mi-tópico
no es un ID no válido. Sin embargo,mi-t%C3%B3pico
es válido. Este formato es importante cuando realizas llamadas a REST.- No debe comenzar con la cadena
Lineamientos para usar una reserva de Lite
El aprovisionamiento de la capacidad de procesamiento con reservas de Lite es obligatorio para los temas regionales de Lite y es opcional para los temas Lite zonales. Una reserva de Lite es un recurso regional.
Ten en cuenta lo siguiente cuando planifiques configurar una reserva Lite:
La cantidad de unidades de capacidad necesarias para una reserva de Lite debe ser igual a la capacidad de procesamiento máxima que esperas en un minuto determinado para todos los temas y suscripciones de esa reserva de Lite.
Cuando la capacidad de procesamiento combinada de todos los temas de Lite en una reserva de Lite alcanza su capacidad máxima, la publicación y la entrega se limitan. Los servidores de Pub/Sub Lite dejan de enviar mensajes a los clientes, y los mensajes se almacenan en búfer en el cliente publicador. Puedes configurar una alerta para
reservation/throughput_capacity/utilization
que te avise cuando la reserva está en riesgo de ser limitada, de modo que puedas aumentar el tamaño de la reserva.Puedes actualizar la capacidad de procesamiento de las reservas tantas veces como quieras. Los cambios se aplicarán en menos de un minuto. Sin embargo, si disminuyes la capacidad de procesamiento de una reserva, se te seguirá cobrando la cantidad más alta durante un período de 24 horas. Pub/Sub Lite es inherentemente un sistema de pago por capacidad, en el que los escalamientos son instantáneos y se pueden reducir la escala verticalmente.
Todos los temas de Lite adjuntos a una reserva de Lite consumen el mismo grupo de capacidad de procesamiento. Por lo tanto, es posible que un tema de Lite use repentinamente una gran cantidad de capacidad de procesamiento, lo que evita que otros temas de Lite publiquen o reciban mensajes. Si necesitas un aislamiento completo entre temas Lite, puedes adjuntarlos a reservas independientes.
Impacto de particiones en una reserva de Lite
La cantidad total de particiones en todos los temas de Lite en una reserva de Lite no debe ser mayor que la cantidad de unidades de capacidad reservadas. Por ejemplo, no puedes adjuntar una reserva de Lite de 10 unidades de capacidad a un tema de Lite ni a un conjunto de temas de Lite cuya cantidad total de particiones sea superior a 10.
Calcula las unidades de capacidad para una reserva de Lite
El tamaño de una reserva de Lite se define por la cantidad de unidades de capacidad. En los siguientes ejemplos, se muestra cómo estimar la capacidad necesaria para temas individuales de Lite.
Determinar la capacidad de procesamiento máxima de publicación
Estima el máximo en la capacidad de procesamiento de todos los temas de Lite adjuntos a la reserva de Lite. Una estimación aproximada de la capacidad de procesamiento es suficiente, ya que siempre puedes actualizar el tamaño de la reserva.
Determinar la capacidad de procesamiento de suscripción máxima
La capacidad de procesamiento máxima de suscripción se calcula de manera similar a la capacidad de procesamiento máxima de publicación. Sin embargo, ten en cuenta que no es necesario que los suscriptores reciban mensajes a la tasa máxima de los publicadores. Si las demoras en el procesamiento son aceptables, Pub/Sub Lite te permite almacenar los mensajes en búfer y procesarlos a un ritmo constante. Al mismo tiempo, es posible que quieras tener más capacidad de suscripción que capacidad de publicación para adaptarse al tiempo de inactividad ocasional de los suscriptores.
Determina la cantidad total de unidades de capacidad necesarias.
En la tabla de la sección anterior, se especifica la cantidad de MiBps que una unidad de capacidad puede admitir para diferentes operaciones. La siguiente es la fórmula para calcular las unidades de capacidad necesarias para una reserva Lite de muestra:
- Capacidad de procesamiento máxima de publicación de los temas Lite zonales =
Pz MiBps
- Capacidad de procesamiento máxima de publicación de los temas regionales de Lite =
Pr MiBps
- Capacidad de procesamiento máxima de suscripción de los temas Lite zonales =
Sz MiBps
Capacidad de procesamiento máxima de suscripción de los temas regionales de Lite =
Sr MiBps
Cantidad de unidades de capacidad requeridas =
(Pz / 1 MiBps) + (Pr/0.25 MiBps) + (Sz/2 MiBps) + (Sr/0.5 MiBps)
Si el número no es un número entero, debes redondear el valor.
- Capacidad de procesamiento máxima de publicación de los temas Lite zonales =
Configura la capacidad de procesamiento sin una reserva de Lite
Capacidad de procesamiento de publicación de temas: Puedes especificar entre 4 y 16 MiBps de capacidad de procesamiento, y el valor debe ser un número entero.
Capacidad de procesamiento de suscripción a temas: Puedes especificar entre 4 y 32 MiBps de capacidad de procesamiento, y el valor debe ser un número entero.
Para la capacidad de procesamiento de suscripción, te recomendamos que aprovisiones tu capacidad de procesamiento de modo que sea igual al producto de la capacidad de procesamiento de publicación esperada y la cantidad de suscripciones de tu tema.
La capacidad del publicador y el suscriptor aprovisionada para un tema individual no es intercambiable. Por este motivo, te recomendamos que siempre uses las reservas.
Existen diferencias en la facturación cuando se aprovisiona la capacidad directamente para los temas, en lugar de usar reservas. Consulta la página de precios de Pub/Sub Lite para obtener más detalles.
Crea una reserva de Lite
Una reserva de Lite debe estar en el mismo proyecto y la misma región que cualquier tema de Lite que esté conectado a ella. Para obtener una lista de las zonas y regiones disponibles, consulta Ubicaciones de Pub/Sub Lite.
Puedes crear una reserva de Lite con la consola de Google Cloud, Google Cloud CLI o la API de Pub/Sub Lite.
Console
Ve a la página Reservas de Lite.
Haz clic en Crear reserva de Lite.
Selecciona una región.
Ingresa un ID de reserva de Lite.
Aprovisiona la cantidad de unidades de capacidad de procesamiento.
Haz clic en Crear.
gcloud
Para crear una reserva de Lite, usa el 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 ejecutar esta muestra, sigue las instrucciones de configuración de Go en las bibliotecas cliente de Pub/Sub Lite.
Java
Antes de ejecutar esta muestra, sigue las instrucciones de configuración de Java en las bibliotecas cliente de Pub/Sub Lite.
Python
Antes de ejecutar esta muestra, sigue las instrucciones de configuración para Python en las bibliotecas cliente de Pub/Sub Lite.
Actualiza una reserva de Lite
Puedes actualizar la cantidad de unidades de capacidad configuradas para una reserva de Lite.
Puedes actualizar una reserva de Lite con la consola de Google Cloud, Google Cloud CLI o la API de Pub/Sub Lite.
Console
Ve a la página Reservas de Lite.
Haz clic en el ID de la reserva de Lite.
En la página Detalles de la reserva de Lite, haz clic en Editar.
gcloud
Para actualizar una reserva de Lite, usa el comando gcloud pubsub lite-reservations update
:
gcloud pubsub lite-reservations update RESERVATION_ID \ --location=REGION \ --throughput-capacity=THROUGHPUT_CAPACITY
Reemplaza lo siguiente:
- RESERVATION_ID: Es el ID de la reserva de Lite.
- REGION: Es la región de la reserva.
- THROUGHPUT_CAPACITY: Es la capacidad de procesamiento de la reserva.
Go
Antes de ejecutar esta muestra, sigue las instrucciones de configuración de Go en las bibliotecas cliente de Pub/Sub Lite.
Java
Antes de ejecutar esta muestra, sigue las instrucciones de configuración de Java en las bibliotecas cliente de Pub/Sub Lite.
Python
Antes de ejecutar esta muestra, sigue las instrucciones de configuración para Python en las bibliotecas cliente de Pub/Sub Lite.
Obtener detalles de la reserva de Lite
Puedes obtener detalles sobre una reserva de Lite con la consola de Google Cloud, Google Cloud CLI o la API de Pub/Sub Lite.
Console
Ve a la página Reservas de Lite.
Haz clic en el ID de la reserva de Lite.
gcloud
Para obtener detalles sobre una reserva de Lite, usa el comando gcloud pubsub lite-reservations describe
:
gcloud pubsub lite-reservations describe RESERVATION_ID \ --location=REGION
Reemplaza lo siguiente:
- RESERVATION_ID: Es el ID de la reserva de Lite.
- REGION: Es la región de la reserva.
Go
Antes de ejecutar esta muestra, sigue las instrucciones de configuración de Go en las bibliotecas cliente de Pub/Sub Lite.
Java
Antes de ejecutar esta muestra, sigue las instrucciones de configuración de Java en las bibliotecas cliente de Pub/Sub Lite.
Python
Antes de ejecutar esta muestra, sigue las instrucciones de configuración para Python en las bibliotecas cliente de Pub/Sub Lite.
Enumerar reservas de Lite
Console
Ve a la página Reservas de Lite.
gcloud
Para ver una lista de las reservas de Lite en un proyecto, usa el comando gcloud pubsub lite-reservations list
:
gcloud pubsub lite-reservations list \ --location=REGION
Reemplaza lo siguiente:
- REGION: Es la región de la reserva.
Go
Antes de ejecutar esta muestra, sigue las instrucciones de configuración de Go en las bibliotecas cliente de Pub/Sub Lite.
Java
Antes de ejecutar esta muestra, sigue las instrucciones de configuración de Java en las bibliotecas cliente de Pub/Sub Lite.
Python
Antes de ejecutar esta muestra, sigue las instrucciones de configuración para Python en las bibliotecas cliente de Pub/Sub Lite.
Borrar una reserva de Lite
Puedes borrar reservas de Lite con la consola de Google Cloud, Google Cloud CLI o la API de Pub/Sub Lite. Para borrar una reserva, no debe contener temas. Puedes adjuntar temas existentes a una reserva diferente y, luego, borrarla.
Console
Ve a la página Reservas de Lite.
Haz clic en el ID de la reserva de Lite.
En la página Detalles de la reserva de Lite, haz clic en Borrar.
En el cuadro de diálogo que aparece, haz clic en Borrar para confirmar que deseas borrar la reserva de Lite.
gcloud
Para borrar una reserva de Lite, usa el comando gcloud pubsub lite-reservations delete
:
gcloud pubsub lite-reservations delete RESERVATION_ID \ --location=REGION
Reemplaza lo siguiente:
- RESERVATION_ID: Es el ID de la reserva de Lite.
- REGION: Es la región de la reserva.
Go
Antes de ejecutar esta muestra, sigue las instrucciones de configuración de Go en las bibliotecas cliente de Pub/Sub Lite.
Java
Antes de ejecutar esta muestra, sigue las instrucciones de configuración de Java en las bibliotecas cliente de Pub/Sub Lite.
Python
Antes de ejecutar esta muestra, sigue las instrucciones de configuración para Python en las bibliotecas cliente de Pub/Sub Lite.
¿Qué sigue?
- Obtén más información sobre los precios de Pub/Sub Lite.
- Crea un tema Lite.