Administrar el estado de la instancia en AlloyDB para PostgreSQL te permite reducir los costos de procesamiento durante los períodos de inactividad, restablecer las conexiones de la base de datos o recuperarte de problemas transitorios. Puedes iniciar, detener o reiniciar una instancia principal o una instancia de grupo de lectura, y puedes reiniciar una instancia secundaria o nodos individuales en un grupo de lectura.
Estas operaciones no cambian la dirección IP pública entrante ni el URI de Private Service Connect de la instancia.
Antes de comenzar
El proyecto Google Cloud que usas debe estar habilitado para acceder a AlloyDB.
Debes tener uno de los siguientes roles de IAM en el proyecto Google Cloud que usas:
- (
roles/alloydb.admin) (el rol de IAM predefinido de administrador de AlloyDB) - (
roles/owner) (el rol básico de IAM de propietario) - (
roles/editor) (el rol básico de IAM de Editor)
Si no tienes ninguno de estos roles, comunícate con el administrador de tu organización para solicitar acceso.
- (
El clúster de AlloyDB está en estado
READY.
Política de activación
Cuando inicias o detienes una instancia, se debe establecer la política de activación para indicar la operación que realizas. La política de activación indica si la instancia está activada para aceptar solicitudes de conexión.
Las opciones de la política de activación son las que se mencionan a continuación:
ALWAYS: La instancia siempre está en funcionamiento.NEVER: La instancia está inactiva y no acepta conexiones.
Para iniciar la instancia, configura la política de activación en ALWAYS. Para detener tu instancia y evitar cargos por ella, establece tu política de activación en NEVER.
Detener una instancia
Puedes detener manualmente una instancia principal o de grupo de lectura cuando sea necesario. Cuando detienes una instancia, esta permanece detenida y no responde a las conexiones de la aplicación hasta que la vuelves a iniciar. No puedes detener una instancia secundaria.
Detener una instancia detiene temporalmente las actualizaciones automáticas. Los datos almacenados en el clúster no se ven afectados, y la configuración de copia de seguridad del clúster permanece activa.
Las instancias detenidas no generan cargos de procesamiento asociados a la instancia. Si la IP pública está habilitada en la instancia, se te cobrarán cargos por IP externa estática inactiva.
Para detener una instancia, sigue estos pasos:
Console
En la consola de Google Cloud , ve a la página Clústeres.
Haz clic en un clúster en la columna Nombre del recurso.
En la página Descripción general que se abre, ve a la sección Instancias en tu clúster y consulta los detalles de tu instancia.
En ¿Deseas detener la instancia de base de datos?, haz clic en Detener.
La política de activación de la instancia se establece en NEVER y la instancia se detiene.
gcloud
Para usar gcloud CLI, puedes instalar y, luego, inicializar Google Cloud CLI, o bien usar Cloud Shell.
Usa el comando gcloud alloydb instances update para detener una instancia.
gcloud alloydb instances update INSTANCE_ID \ --region=REGION_ID \ --cluster=CLUSTER_ID \ --activation-policy=NEVER ```Replace the following:
- INSTANCE_ID: El ID de la instancia.
- REGION_ID: Es el ID de la región de la instancia.
- CLUSTER_ID: Es el ID del clúster de la instancia.
Iniciar una instancia
Cuando inicias la instancia, AlloyDB aplica la versión secundaria más reciente de la base de datos. Como iniciar una instancia no es una actividad de mantenimiento, se ignoran los períodos de rechazo de mantenimiento configurados para la instancia.
Para iniciar una instancia detenida, haz lo siguiente:
Console
En la consola de Google Cloud , ve a la página Clústeres.
Haz clic en un clúster en la columna Nombre del recurso.
En la página Descripción general que se abre, ve a la sección Instancias en tu clúster y consulta los detalles de tu instancia.
En ¿Deseas iniciar la instancia de base de datos?, haz clic en Iniciar.
La política de activación de la instancia se establece en ALWAYS y se inicia la instancia.
gcloud
Para usar gcloud CLI, puedes instalar y, luego, inicializar Google Cloud CLI, o bien usar Cloud Shell.
Usa el comando gcloud alloydb instances update para iniciar una instancia.
gcloud alloydb instances update INSTANCE_ID \ --region=REGION_ID \ --cluster=CLUSTER_ID \ --activation-policy=ALWAYS ```Replace the following:
- INSTANCE_ID: El ID de la instancia.
- REGION_ID: Es el ID de la región de la instancia.
- CLUSTER_ID: Es el ID del clúster de la instancia.
Reinicia una instancia
Cuando inicias el reinicio de una instancia, se interrumpen todas las conexiones disponibles en ella. Después de que se reinicia la instancia y está lista para aceptar conexiones nuevas. Reiniciar una instancia no cambia su dirección IP privada.
Reinicia una instancia principal, secundaria o de grupo de lectura
Console
- En la consola de Google Cloud , ve a la página Clústeres.
- Haz clic en un clúster en la columna Nombre del recurso.
- En la página Descripción general, ve a la sección Instancias en tu clúster, elige la instancia principal o una instancia del grupo de lectura y haz clic en Reiniciar.
gcloud
Para usar gcloud CLI, puedes instalar y, luego, inicializar Google Cloud CLI, o bien usar Cloud Shell.
Reinicia la instancia:
gcloud alloydb instances restart INSTANCE_ID \
--cluster=CLUSTER_ID \
--region=REGION_ID \
--project=PROJECT_ID \
[--async]
- INSTANCE_ID: el ID de la instancia
- CLUSTER_ID: Es el ID del clúster en el que está disponible la instancia.
- REGION_ID: Es la región en la que se coloca la instancia.
- PROJECT_ID: Es el ID del proyecto en el que se coloca el clúster.
async: Es una marca opcional para mostrar el resultado de inmediato, sin esperar a que se complete la operación en curso.
Reinicia nodos específicos de un grupo de lectura
Puedes usar gcloud CLI para reiniciar uno o más nodos de un grupo de lectura.
En el siguiente comando, se muestra cómo puedes reiniciar un nodo de un grupo de lectura:
gcloud alloydb instances restart INSTANCE_ID \
--cluster=CLUSTER_ID \
--region=REGION_ID \
--node-ids=NODE_ID \
- INSTANCE_ID: Es el ID de la instancia de readpool.
- CLUSTER_ID: Es el ID del clúster en el que está disponible la instancia.
- NODE_ID: Es el ID del nodo que necesita reiniciarse, por ejemplo,
j71a-read-pool-054b8861-2ln8. - PROJECT_ID: Es el ID del proyecto en el que se coloca el clúster.
--async: Es una marca opcional para mostrar el resultado de inmediato, sin esperar a que se complete la operación en curso.
En el siguiente ejemplo, se muestra cómo puedes reiniciar varios nodos:
gcloud alloydb instances restart INSTANCE_ID \
--cluster=CLUSTER_ID \
--region=REGION_ID \
--node-ids=NODE_ID1,NODE_ID2 \
- INSTANCE_ID: Es el ID de la instancia de readpool.
- CLUSTER_ID: Es el ID del clúster en el que está disponible la instancia.
- NODE_ID1,NODE_ID2: Es la lista de nodos que necesitan un reinicio.
- PROJECT_ID: Es el ID del proyecto en el que se coloca el clúster.
--async: Es una marca opcional para mostrar el resultado de inmediato, sin esperar a que se complete la operación en curso.
¿Qué sigue?
- Obtén más información para crear una instancia principal
- Actualiza la configuración del clúster y de la instancia