Para conectarte a una instancia principal, de grupo de lectura o secundaria de AlloyDB para PostgreSQL desde varias redes de nube privada virtual (VPC) que pertenezcan a organizaciones, grupos, equipos o proyectos diferentes sin configurar el intercambio de tráfico entre redes de VPC, puedes configurar Private Service Connect.
Roles obligatorios
Según si configuras la infraestructura de Private Service Connect o te conectas como cliente de base de datos, otorga los roles de Identity and Access Management (IAM) adecuados:
| Tarea | Rol | Descripción |
|---|---|---|
| Configura extremos y adjuntos de red de Private Service Connect | Administrador de red de Compute (roles/compute.networkAdmin) |
Otorga control total sobre la red de VPC del consumidor que inicia una conexión a una instancia de AlloyDB. Si te conectas desde varias redes de VPC, cada red es administrada por su propio administrador. |
| Crea extremos de Private Service Connect o recursos de cliente en proyectos de servicio de VPC compartida | Usuario de la red de Compute (roles/compute.networkUser) |
Otorga permisos en el proyecto host de la VPC compartida o en las subredes compartidas para que los administradores de proyectos de servicio y los agentes de servicio en los proyectos de servicio adjuntos puedan crear extremos de Private Service Connect o VMs de cliente que usen la red y las subredes de la VPC compartida del proyecto host. |
| Configura zonas y registros del DNS privados | Administrador de DNS (roles/dns.admin) |
Otorga control total sobre los recursos de Cloud DNS, lo que incluye zonas del DNS privadas y conjuntos de registros. |
| Crea y administra clústeres e instancias de AlloyDB | Administrador de AlloyDB (roles/alloydb.admin) |
Proporciona control total de los clústeres y las instancias de AlloyDB durante su ciclo de vida. Si usas un rol personalizado, otorga alloydb.clusters.create (para habilitar Private Service Connect en un clúster), alloydb.instances.create y alloydb.instances.update (para configurar los proyectos de consumidores y los URIs de adjuntos de red permitidos). |
| Conéctate a una instancia como cliente | Cliente de AlloyDB (roles/alloydb.client) y Consumidor de Service Usage (roles/serviceusage.serviceUsageConsumer) (opcional) |
Es obligatorio si te conectas a través del proxy de autenticación de AlloyDB o los conectores de lenguajes para AlloyDB. Si también usas la autenticación de la base de datos de IAM, otorga el rol de usuario de la base de datos de AlloyDB (roles/alloydb.databaseUser). Si te conectas directamente con la autenticación de la base de datos integrada, no se requieren roles de IAM para la conexión del cliente. |
Crear un extremo de Private Service Connect
Los extremos de Private Service Connect son direcciones IP internas en una red de VPC de consumidor a la que pueden acceder directamente los clientes de esa red para conectarse a las instancias de AlloyDB.
Para que AlloyDB cree el extremo de Private Service Connect automáticamente, haz lo siguiente:
- Reutiliza una política de conexión de servicio existente o crea una política de conexión de servicio en tus redes de VPC. Con esta política, puedes aprovisionar extremos de Private Service Connect de forma automática.
- Crea un clúster y una instancia de AlloyDB con Private Service Connect habilitado para la instancia y configúrala para que cree extremos de Private Service Connect automáticamente.
- Recupera el extremo de la instancia. Esto te permite usar el extremo para conectarte a la instancia.
- Opcional: Actualiza un clúster y una instancia de AlloyDB existentes con Private Service Connect habilitado para generar extremos automáticamente.
También puedes crear el extremo de Private Service Connect de forma manual o configurar extremos en una VPC compartida de varios proyectos o en una red de concentrador y radio.
Crea el extremo automáticamente
Para configurar tu instancia de modo que AlloyDB cree el extremo de Private Service Connect automáticamente, sigue estos pasos de alto nivel:
- Crea una política de conexión de servicio.
- Crea una instancia de AlloyDB.
- Recupera el extremo.
- Actualiza una instancia para crear extremos automáticamente.
- Configura la conectividad saliente.
Crea una política de conexión de servicio
Puedes reutilizar una política de conexión de servicio existente o crear una con la consola de Google Cloud o la Google Cloud CLI.
Una política de conexión de servicio te permite autorizar una clase de servicio específica para crear un extremo de Private Service Connect en tu red de VPC de consumidor. Puedes usar la política de conexión de servicio para permitir que AlloyDB cree extremos de Private Service Connect de forma automática.
Console
En la consola de Google Cloud , ve a la página Private Service Connect.
Haz clic en la pestaña Políticas de conexión.
Haz clic en Crear política de conexión.
Ingresa un Nombre para la política de conexión.
En la sección Detalles del servicio, en Clase de servicio, selecciona
google-cloud-alloydb.En la sección Alcance de los extremos, selecciona una Red y una Región a las que se aplicará esta política.
En la sección Configuración de extremos, selecciona una o más subredes en el menú Subredes. Las subredes se usan para asignar direcciones IP a los extremos.
Especifica un Límite de conexión para la política (opcional). El límite determina cuántos extremos puede crear AlloyDB para esta política de conexión. Si no especificas un límite de conexiones, no habrá límite.
Haz clic en Crear política.
gcloud
Para crear una política de conexión de servicio, usa el
comando service-connection-policies create.
gcloud network-connectivity service-connection-policies create POLICY_NAME \
--network=NETWORK \
--project=PROJECT_ID \
--region=REGION \
--service-class=SERVICE_CLASS \
--subnets=https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/subnetworks/SUBNETS \
--psc-connection-limit=LIMIT \
--description="DESCRIPTION" \
--producer-instance-location=PRODUCER_INSTANCE_LOCATION \
--allowed-google-producers-resource-hierarchy-level=LIST_OF_NODES
Reemplaza lo siguiente:
POLICY_NAME: el nombre de la política de conexión del servicio.NETWORK: la red a la que se aplica esta política.PROJECT_ID: el ID del proyecto o el número del proyecto de la red de VPC. En el caso de las redes de VPC compartida, debes implementar políticas de conexión de servicio en el proyecto host, ya que estas políticas no son compatibles con los proyectos de servicio.REGION: Es la región a la que se aplica esta política. Debe existir la misma política para cada región en la que desees automatizar la conectividad del servicio.SERVICE_CLASS: el identificador de recursos proporcionado por el productor de la clase de servicio. Para AlloyDB, la clase de servicio esgoogle-cloud-alloydb.SUBNETS: una o más subredes de consumidor regulares que se usan para asignar direcciones IP a los extremos de Private Service Connect. Estas direcciones IP se asignan automáticamente y se devuelven al grupo de la subred a medida que se crean y borran las instancias de servicio administrado. Las subredes deben estar en la misma región que la política de conexión de servicio. Si varias políticas de conexión comparten la misma región, puedes volver a usar la misma subred en estas políticas. Puedes ingresar varias subredes en una lista separada por comas.LIMIT: Es la cantidad máxima de extremos que puedes crear con esta política. Si no especificas un límite, no habrá ninguno.DESCRIPTION: Es una descripción opcional de la política de conexión de servicio.PRODUCER_INSTANCE_LOCATION: Especifica si la política automatiza las conexiones a las instancias de AlloyDB. Puedes establecer este valor en una de las siguientes opciones:none(predeterminado): la instancia de AlloyDB está en el mismo proyecto que la política de conexión de servicio. En un entorno de VPC compartida, si la instancia de AlloyDB reside en un proyecto de servicio y creas la política de conexión en el proyecto host, debes establecer este parámetro encustom-resource-hierarchy-levels.custom-resource-hierarchy-levels: requiere que configures la ruta de acceso de la ubicación de Resource Manager para los proyectos en los que deseas automatizar la conectividad a través del parámetroallowed-google-producers-resource-hierarchy-level.
LIST_OF_NODES: Establece este parámetro si la ubicación de la instancia de productor se establece encustom-resource-hierarchy-levels. Este parámetro es una lista de proyectos, carpetas y organizaciones en los que residen las instancias para las que deseas automatizar la conectividad. La lista tiene el formatoprojects/PROJECT_ID,folders/FOLDER_IDoorganizations/ORGANIZATION_ID.
Por ejemplo, el siguiente comando crea una política de conexión de servicio para la clase de servicio google-cloud-alloydb que asigna direcciones IP desde la subred managed-service-subnet. Se puede crear un máximo de 10
extremos de Private Service Connect con
esta política. Los extremos deben crearse en proyectos que se encuentren en la misma organización que la instancia de servicio administrado. La instancia de AlloyDB
se encuentra en el proyecto myproject.
gcloud network-connectivity service-connection-policies create alloydb-policy \
--network=default \
--project=my-project \
--region=us-central1 \
--service-class=google-cloud-alloydb \
--subnets=managed-service-subnet \
--psc-connection-limit=10 \
--producer-instance-location=custom-resource-hierarchy-levels \
--allowed-google-producers-resource-hierarchy-level=projects/myproject
Crea una instancia de AlloyDB
Puedes crear una instancia con Private Service Connect habilitado y configurarla para que cree extremos automáticamente con la consola de Google Cloud , gcloud CLI o Terraform.
Console
En la consola de Google Cloud , ve a la página Clústeres.
Haga clic en Crear clúster.
En ID del clúster, ingresa
my-cluster.Ingresa una contraseña. Toma nota de esta contraseña, ya que la usarás en esta guía de inicio rápido.
Conserva la versión predeterminada de la base de datos.
Selecciona la región
us-central1 (Iowa).Conserva el ID de instancia predeterminado,
my-cluster-primary.En Disponibilidad zonal, conserva Zona única como la opción seleccionada. Si bien no recomendamos una instancia de zona única para la producción, usarás una zona única en esta guía de inicio rápido para minimizar los costos. Para obtener más información, consulta Reduce los costos con instancias básicas.
Selecciona el tipo de máquina
2 vCPU, 16 GB.Conservar la conectividad de IP privada
- Selecciona Private Service Connect (PSC).
- Haz clic en Agregar un extremo.
- Selecciona el proyecto en el que deseas crear el extremo.
- Selecciona la Red.
- Haz clic en Verificar política para obtener información sobre la política de conexión de servicio.
Conserva la configuración predeterminada en Seguridad de redes.
No realices cambios en Mostrar opciones avanzadas.
Haga clic en Crear clúster. AlloyDB puede tardar varios minutos en crear el clúster y mostrarlo en la página Descripción general del clúster principal.
gcloud
Para crear el clúster, usa el comando gcloud alloydb clusters
create.
gcloud alloydb clusters create CLUSTER_ID \
--password=PASSWORD \
--region=REGION_ID \
--project=PROJECT_ID \
--enable-private-service-connectReemplaza lo siguiente:
CLUSTER_ID: Es el ID del clúster que estás creando. Debe comenzar con una letra minúscula y puede contener letras minúsculas, números y guiones.PASSWORD: Es la contraseña que se usará para el usuariopostgrespredeterminado.REGION_ID: Es la región en la que se encuentra el clúster.PROJECT_ID: Es el ID del proyecto en el que se encuentra el clúster.
Este comando inicia una operación de larga duración y, luego, muestra un ID de operación.
Para crear la instancia de AlloyDB, ya sea principal o un grupo de lectura para usar Private Service Connect, usa el comando gcloud alloydb instances create. Incluye el parámetro --allowed-psc-projects para especificar qué proyectos de consumidor pueden crear extremos para conectarse a esta instancia.
gcloud alloydb instances create INSTANCE_ID \
--instance-type=PRIMARY \
--cpu-count=CPU_COUNT \
--availability-type=AVAILABILITY \
--region=REGION_ID \
--cluster=CLUSTER_ID \
--project=PROJECT_ID \
--allowed-psc-projects=ALLOWED_PROJECT_LIST \
--psc-network-attachment-uri=NETWORK_ATTACHMENT_URI \
--psc-auto-connections=network=CONSUMER_NETWORK,project=CONSUMER_PROJECTReemplaza lo siguiente:
INSTANCE_ID: Es el ID de la instancia que estás creando. Debe comenzar con una letra minúscula y puede contener letras minúsculas, números y guiones.CPU_COUNT: Es la cantidad de CPUs virtuales que deseas para la instancia. Los valores válidos incluyen lo siguiente:2: 2 CPU virtuales, 16 GB de RAM4: 4 CPU virtuales, 32 GB de RAM8: 8 CPU virtuales, 64 GB de RAM16: 16 CPUs virtuales, 128 GB de RAM32: 32 CPU virtuales, 256 GB de RAM64: 64 CPU virtuales, 512 GB de RAM96: 96 CPUs virtuales, 768 GB de RAM128: 128 CPU virtuales, 864 GB de RAM
AVAILABILITY: Indica si esta instancia debe tener alta disponibilidad (HA) con nodos en varias zonas. Estos son algunos de los valores válidos:REGIONAL: Crea una instancia de alta disponibilidad con nodos activos y en espera independientes, y conmutación por error automática entre ellos. Este es el valor predeterminado, adecuado para entornos de producción.ZONAL: Crea una instancia básica, que contiene solo un nodo y no tiene conmutación por error automatizada.
REGION_ID: Es la región en la que se encuentra la instancia.CLUSTER_ID: Es el ID del clúster que creaste antes.ALLOWED_PROJECT_LIST: Es la lista separada por comas de los ID del proyecto o números de proyectos a los que deseas permitir el acceso a la instancia, por ejemplo,my-project-1,12345,my-project-n.NETWORK_ATTACHMENT_URI(opcional): Es el nombre completo del recurso del URI del adjunto de red que creas para la conectividad de salida. Por ejemplo:projects/PROJECT_ID/regions/REGION_ID/networkAttachments/NETWORK_ATTACHMENT_ID.CONSUMER_NETWORK: Es la ruta de acceso a la red de VPC en la que se crean los extremos de Private Service Connect. Por ejemplo:projects/my-host-project/global/networks/default. Esta opción se aplica cuando creas extremos automáticamente. Asegúrate de que se cree la política de conexión de servicio. Puedes crear la política antes o después de crear la instancia.CONSUMER_PROJECT: el proyecto en el que se crea el extremo de Private Service Connect. Si usas una red de VPC compartida, puede ser el proyecto host o el proyecto de servicio. Todos los proyectos que especifiques en los parámetros de conexión automática se agregarán automáticamente a tus proyectos permitidos. De manera opcional, para cualquier proyecto en el que quieras crear extremos de Private Service Connect de forma manual, puedes agregar estos proyectos a tu lista de proyectos permitidos.
Un clúster secundario creado para un clúster principal habilitado para Private Service Connect hereda automáticamente la configuración de Private Service Connect. Para obtener más información, consulta Crea un clúster secundario.
Terraform
Para crear un clúster y una instancia de AlloyDB con Private Service Connect habilitado, usa los recursos de Terraform google_alloydb_cluster y google_alloydb_instance:
resource "google_alloydb_cluster" "default" {
cluster_id = "alloydb-cluster"
location = "us-central1"
psc_config {
psc_enabled = true
}
}
resource "google_alloydb_instance" "default" {
cluster = google_alloydb_cluster.default.name
instance_id = "alloydb-instance"
instance_type = "PRIMARY"
machine_config {
cpu_count = 2
}
psc_instance_config {
allowed_consumer_projects = [data.google_project.project.number]
psc_auto_connections {
consumer_network = google_compute_network.default.id
consumer_project = data.google_project.project.project_id
}
psc_interface_configs {
network_attachment_resource = google_compute_network_attachment.default.id
}
}
}
resource "google_compute_network" "default" {
name = "alloydb-network"
auto_create_subnetworks = false
}
resource "google_compute_subnetwork" "default" {
name = "alloydb-subnetwork"
region = "us-central1"
network = google_compute_network.default.id
ip_cidr_range = "10.0.0.0/16"
}
resource "google_compute_network_attachment" "default" {
name = "alloydb-network-attachment"
region = "us-central1"
connection_preference = "ACCEPT_AUTOMATIC"
subnetworks = [
google_compute_subnetwork.default.self_link
]
}
data "google_project" "project" {}
Si deseas obtener más información para aplicar o quitar una configuración de Terraform, consulta los comandos básicos de Terraform.
Recupera el extremo
Si recuperas la dirección IP interna, que es el extremo de Private Service Connect de una instancia, puedes usar este extremo para conectarte a la instancia.
Para ver información sobre una instancia, incluida la dirección IP que es el extremo de Private Service Connect de la instancia, usa el comando gcloud alloydb instances describe:
gcloud alloydb instances describe INSTANCE_NAME \ --project=PROJECT_ID \ --cluster=CLUSTER_ID \ --region=REGION_ID \ --format='json(pscInstanceConfig.pscAutoConnections)'
Reemplaza lo siguiente:
- INSTANCE_NAME: Es el nombre de la instancia de AlloyDB. Si esta instancia tiene Private Service Connect habilitado para ella, los extremos de Private Service Connect en las redes de VPC pueden conectarse a ella.
- PROJECT_ID: el ID o el número del proyecto de Google Cloud que contiene la instancia.
- CLUSTER_ID: Es el ID del clúster.
- REGION_ID: Es la región en la que se encuentra la instancia.
En la respuesta, toma nota del valor que aparece junto al campo pscInstanceConfig.pscAutoConnections.ipAddress. Este valor es la dirección IP interna que también es el extremo de Private Service Connect para la instancia.
Actualiza una instancia para crear extremos automáticamente
Para actualizar una instancia y crear extremos automáticamente, usa el comando
gcloud alloydb instances update
con el parámetro --psc-auto-connections:
gcloud alloydb instances update INSTANCE_ID \
--cluster=CLUSTER_ID \
--region=REGION_ID \
--project=PROJECT_ID \
--psc-auto-connections=network=CONSUMER_NETWORK,project=CONSUMER_PROJECTReemplaza lo siguiente:
INSTANCE_ID: Es el ID de la instancia que estás actualizando.CLUSTER_ID: Es el ID del clúster.REGION_ID: Es la región en la que se encuentra la instancia.PROJECT_ID: Es el ID del proyecto en el que se encuentra la instancia.CONSUMER_NETWORK: Es la ruta de acceso a la red de VPC en la que se crean los extremos de Private Service Connect, por ejemplo,projects/my-host-project/global/networks/default.CONSUMER_PROJECT: el proyecto en el que se crea el extremo de Private Service Connect.
Configura la conectividad saliente
Para habilitar la conectividad saliente de tu instancia de AlloyDB con Private Service Connect habilitado, debes establecer el URI del adjunto de red para la instancia. Para obtener más información, consulta Configura la conectividad de salida.
Crea el extremo de forma manual
En las siguientes secciones, se explica cómo crear un extremo de Private Service Connect de forma manual.
Crea una instancia de AlloyDB
Puedes crear una instancia con Private Service Connect habilitado con la consola de Google Cloud , gcloud CLI o Terraform.
Console
En la consola de Google Cloud , ve a la página Clústeres.
Haga clic en Crear clúster.
En ID del clúster, ingresa
my-cluster.Ingresa una contraseña. Toma nota de esta contraseña, ya que la usarás en esta guía de inicio rápido.
Conserva la versión predeterminada de la base de datos.
Selecciona la región
us-central1 (Iowa).Conserva el ID de instancia predeterminado,
my-cluster-primary.En Disponibilidad zonal, conserva Zona única como la opción seleccionada. Si bien no recomendamos una instancia de zona única para la producción, usarás una zona única en esta guía de inicio rápido para minimizar los costos. Para obtener más información, consulta Reduce los costos con instancias básicas.
Selecciona el tipo de máquina
2 vCPU, 16 GB.Conserva la conectividad de IP privada y selecciona Private Service Connect (PSC).
En Proyectos de consumidor permitidos, ingresa los IDs o números de los proyectos que deseas permitir que se conecten a la instancia.
Conserva la configuración predeterminada en Seguridad de redes.
No realices cambios en Mostrar opciones avanzadas.
Haga clic en Crear clúster. AlloyDB puede tardar varios minutos en crear el clúster y mostrarlo en la página Descripción general del clúster principal.
gcloud
Para crear el clúster, usa el comando gcloud alloydb clusters
create.
gcloud alloydb clusters create CLUSTER_ID \
--password=PASSWORD \
--region=REGION_ID \
--project=PROJECT_ID \
--enable-private-service-connectReemplaza lo siguiente:
CLUSTER_ID: Es el ID del clúster que estás creando. Debe comenzar con una letra minúscula y puede contener letras minúsculas, números y guiones.PASSWORD: Es la contraseña que se usará para el usuariopostgrespredeterminado.REGION_ID: Es la región en la que se encuentra el clúster.PROJECT_ID: Es el ID del proyecto en el que se encuentra el clúster.
Este comando inicia una operación de larga duración y, luego, muestra un ID de operación.
Para crear la instancia principal, usa el comando gcloud alloydb instances create.
gcloud alloydb instances create INSTANCE_ID \
--instance-type=PRIMARY \
--cpu-count=CPU_COUNT \
--availability-type=AVAILABILITY \
--region=REGION_ID \
--cluster=CLUSTER_ID \
--project=PROJECT_ID \
--allowed-psc-projects=ALLOWED_PROJECT_LIST \
--psc-network-attachment-uri=NETWORK_ATTACHMENT_URIReemplaza lo siguiente:
INSTANCE_ID: Es el ID de la instancia que estás creando. Debe comenzar con una letra minúscula y puede contener letras minúsculas, números y guiones.CPU_COUNT: Es la cantidad de CPUs virtuales que deseas para la instancia. Los valores válidos incluyen lo siguiente:2: 2 CPU virtuales, 16 GB de RAM4: 4 CPU virtuales, 32 GB de RAM8: 8 CPU virtuales, 64 GB de RAM16: 16 CPUs virtuales, 128 GB de RAM32: 32 CPU virtuales, 256 GB de RAM64: 64 CPU virtuales, 512 GB de RAM96: 96 CPUs virtuales, 768 GB de RAM128: 128 CPU virtuales, 864 GB de RAM
AVAILABILITY: Indica si esta instancia debe tener alta disponibilidad (HA) con nodos en varias zonas. Estos son algunos de los valores válidos:REGIONAL: Crea una instancia de alta disponibilidad con nodos activos y en espera independientes, y conmutación por error automática entre ellos. Este es el valor predeterminado, adecuado para entornos de producción.ZONAL: Crea una instancia básica, que contiene solo un nodo y no tiene conmutación por error automatizada.
REGION_ID: Es la región en la que se encuentra la instancia.CLUSTER_ID: Es el ID del clúster que creaste antes.ALLOWED_PROJECT_LIST: Es la lista separada por comas de los ID del proyecto o números de proyectos a los que deseas permitir el acceso a la instancia, por ejemplo,my-project-1,12345,my-project-n.NETWORK_ATTACHMENT_URI(opcional): Es el nombre completo del recurso del URI del adjunto de red que creas para la conectividad de salida. Por ejemplo:projects/PROJECT_ID/regions/REGION_ID/networkAttachments/NETWORK_ATTACHMENT_ID.
Un clúster secundario creado para un clúster principal habilitado para Private Service Connect hereda automáticamente la configuración de Private Service Connect. Para obtener más información, consulta Crea un clúster secundario.
Terraform
Para crear un clúster y una instancia de AlloyDB con Private Service Connect habilitado, usa los recursos de Terraform google_alloydb_cluster y google_alloydb_instance:
resource "google_alloydb_cluster" "default" {
cluster_id = "alloydb-cluster"
location = "us-central1"
psc_config {
psc_enabled = true
}
}
resource "google_alloydb_instance" "default" {
cluster = google_alloydb_cluster.default.name
instance_id = "alloydb-instance"
instance_type = "PRIMARY"
machine_config {
cpu_count = 2
}
psc_instance_config {
allowed_consumer_projects = [data.google_project.project.number]
psc_interface_configs {
network_attachment_resource = google_compute_network_attachment.default.id
}
}
}
resource "google_compute_network" "default" {
name = "alloydb-network"
auto_create_subnetworks = false
}
resource "google_compute_subnetwork" "default" {
name = "alloydb-subnetwork"
region = "us-central1"
network = google_compute_network.default.id
ip_cidr_range = "10.0.0.0/16"
}
resource "google_compute_network_attachment" "default" {
name = "alloydb-network-attachment"
region = "us-central1"
connection_preference = "ACCEPT_AUTOMATIC"
subnetworks = [
google_compute_subnetwork.default.self_link
]
}
data "google_project" "project" {}
Si deseas obtener más información para aplicar o quitar una configuración de Terraform, consulta los comandos básicos de Terraform.
Obtén el adjunto del servicio
Después de crear una instancia de AlloyDB con Private Service Connect habilitado, obtén la URL del adjunto de servicio y úsala para crear el extremo de Private Service Connect.
Para ver los detalles de una instancia, usa el comando gcloud alloydb instances describe.
gcloud alloydb instances describe INSTANCE_ID \
--cluster=CLUSTER_ID \
--region=REGION_IDReemplaza lo siguiente:
INSTANCE_ID: el ID de la instanciaCLUSTER_ID: Es el ID del clúster.REGION_ID: Es la región en la que se implementa el clúster de AlloyDB.
A continuación, se muestra una respuesta de ejemplo para el comando:
{
"pscInstanceConfig": {
"serviceAttachmentLink": "https://www.googleapis.com/compute/v1/projects/my-project/regions/my-region/serviceAttachments/my-service-attachment-id",
"allowedConsumerProjects": [
"45678",
"12345",
"67890"
],
"pscDnsName": "015f5524-0555-4a0a-ac5a-0d15d64b15cb.008225d5-070a-4566-aaad-fcb3c87c5901.us-east4.alloydb-psc.goog."
}
}
El parámetro serviceAttachmentLink contiene el valor de la URL del adjunto de servicio.
Crear un extremo de Private Service Connect
Para crear un extremo de Private Service Connect, pasa la URL del adjunto de servicio junto con un nombre de extremo único. Para obtener más información sobre cómo crear un extremo de Private Service Connect, consulta Crea un extremo.
También puedes reservar una dirección IP interna para el extremo de Private Service Connect con el comando gcloud compute addresses create y, luego, usar la dirección IP reservada cuando crees el extremo, o aprovisionar la dirección IP interna y la regla de reenvío con Terraform:
resource "google_compute_address" "psc_endpoint_ip" {
name = "alloydb-psc-endpoint-ip"
region = "us-central1"
subnetwork = google_compute_subnetwork.default.id
address_type = "INTERNAL"
}
resource "google_compute_forwarding_rule" "psc_endpoint" {
name = "alloydb-psc-endpoint"
region = "us-central1"
network = google_compute_network.default.id
ip_address = google_compute_address.psc_endpoint_ip.self_link
load_balancing_scheme = ""
target = google_alloydb_instance.default.psc_instance_config[0].service_attachment_link
}
Configura extremos en una red de VPC compartida o de concentrador y radio de varios proyectos
En una arquitectura de varios proyectos, puedes implementar un extremo de Private Service Connect centralizado en un proyecto host o concentrador. Los clientes de bases de datos en varios proyectos de servicio o de radio pueden conectarse a una instancia de AlloyDB a través de ese extremo.
La forma en que los clientes de los proyectos de radio alcanzan el extremo centralizado depende de tu topología de red:
VPC compartida: El proyecto host y los proyectos de servicio conectados comparten una sola red de VPC. Los clientes de la base de datos en cualquier proyecto de servicio adjunto pueden acceder al extremo en la misma región o en varias regiones cuando el acceso global está habilitado.
Topología de concentrador y radio de varias VPC con Network Connectivity Center: Los proyectos de radio usan redes de VPC independientes que se conectan a un concentrador de Network Connectivity Center. Los clientes de otros radios de VPC pueden llegar a un extremo de Private Service Connect en el radio de VPC del concentrador cuando habilitas la propagación de conexiones de Private Service Connect en el concentrador.
Concentrador y radio de varias VPC con intercambio de tráfico entre redes de VPC: No se puede acceder de forma transitiva a los extremos de Private Service Connect a través del intercambio de tráfico entre redes de VPC. En su lugar, implementa un extremo de Private Service Connect independiente en cada red de VPC con intercambio de tráfico.
Te recomendamos que crees una política de conexión de servicio en el proyecto host para aprovisionar el extremo automáticamente. Si no puedes crear una política de conexión de servicio, puedes crear un extremo de Private Service Connect de forma manual en un proyecto host de VPC compartida como alternativa completando los siguientes pasos:
Permite el proyecto que posee el extremo en la configuración de la instancia de AlloyDB.
Incluye el ID del proyecto en el que creas el extremo en la marca
--allowed-psc-projectsde la instancia de AlloyDB. Cuando implementes un extremo centralizado en el proyecto host, incluye el ID del proyecto host. No es necesario que se incluyan en la lista los proyectos de servicio que solo ejecutan cargas de trabajo de cliente que se conectan al extremo del proyecto host. Para permitir que los proyectos de servicio implementen sus propios extremos de forma local, incluye también esos IDs de proyectos de servicio. Para actualizar los proyectos permitidos en una instancia existente, ejecuta el comandogcloud alloydb instances updatecon la marca--allowed-psc-projects. La marca--allowed-psc-projectsreemplaza la lista existente de proyectos permitidos en lugar de agregarla a ella. Incluye todos los IDs de proyectos permitidos existentes junto con el ID del proyecto host nuevo para que no se desconecten los extremos existentes.En el proyecto host, reserva una dirección IP interna para el extremo con el comando
gcloud compute addresses create:gcloud compute addresses create ADDRESS_NAME \ --project=HOST_PROJECT_ID \ --region=REGION_ID \ --subnet=HOST_SUBNETReemplaza lo siguiente:
ADDRESS_NAME: Es el nombre que se asignará a la dirección IP reservada.HOST_PROJECT_ID: el ID del proyecto host de la VPC compartida.REGION_ID: Es la región de la dirección IP del extremo. Esta región debe ser la misma que contiene la instancia de AlloyDB.HOST_SUBNET: Es el nombre de la subred del proyecto host que proporciona la dirección IP del extremo.
En el proyecto host, crea la regla de reenvío para el extremo con el comando
gcloud compute forwarding-rules create:gcloud compute forwarding-rules create ENDPOINT_NAME \ --project=HOST_PROJECT_ID \ --region=REGION_ID \ --network=HOST_NETWORK \ --address=ADDRESS_NAME \ --target-service-attachment=SERVICE_ATTACHMENT_URLReemplaza lo siguiente:
ENDPOINT_NAME: nombre que se asignará al extremo.HOST_PROJECT_ID: el ID del proyecto host de la VPC compartida.REGION_ID: Es la región para el extremo.HOST_NETWORK: Es el nombre de la red de VPC host.ADDRESS_NAME: el nombre de la dirección IP reservada del paso anterior.SERVICE_ATTACHMENT_URL: Es la URL del adjunto de servicio que recuperaste de la instancia de AlloyDB.
Para permitir que los clientes de cualquier región de la red de VPC compartida lleguen al extremo, incluye la marca opcional
--allow-psc-global-access.Verifica que el estado de la conexión del extremo sea
ACCEPTEDcon el comandogcloud compute forwarding-rules describe:gcloud compute forwarding-rules describe ENDPOINT_NAME \ --project=HOST_PROJECT_ID \ --region=REGION_ID \ --format="value(pscConnectionStatus)"Otorga el rol de usuario de red de Compute (
roles/compute.networkUser) en la subred compartida a los administradores y agentes de servicio de cada proyecto de servicio.Las cargas de trabajo de cliente en una red de VPC compartida no necesitan el rol
roles/compute.networkUseren la subred del extremo para enviar tráfico de red a un extremo del proyecto host. Sin embargo, un administrador de VPC compartida debe otorgar el rolroles/compute.networkUseren el proyecto host o en las subredes compartidas para que los administradores de proyectos de servicio y los agentes de servicio puedan aprovisionar VMs de Compute Engine o clústeres de Google Kubernetes Engine (GKE) en subredes compartidas.Para otorgar el rol
roles/compute.networkUseren una subred compartida, ejecuta el comandogcloud compute networks subnets add-iam-policy-binding:gcloud compute networks subnets add-iam-policy-binding SHARED_SUBNET \ --project=HOST_PROJECT_ID \ --region=SUBNET_REGION_ID \ --member=PRINCIPAL \ --role=roles/compute.networkUserReemplaza lo siguiente:
SHARED_SUBNET: Es el nombre de la subred compartida en el proyecto host en el que el proyecto de servicio implementa recursos de cliente, como VMs de Compute Engine o nodos de GKE. No es necesario que esta subred sea la subredHOST_SUBNETen la que reservaste la dirección IP del extremo.HOST_PROJECT_ID: el ID del proyecto host de la VPC compartida.SUBNET_REGION_ID: Es la región de la subred compartida.PRINCIPAL: Es la principal en el proyecto de servicio, comouser:admin@example.comoserviceAccount:SERVICE_PROJECT_NUMBER@cloudservices.gserviceaccount.com.
Si las cargas de trabajo de los clientes en un proyecto de servicio o de radio se conectan con el proxy de autenticación de AlloyDB, los conectores de lenguaje de AlloyDB o la autenticación de la base de datos de IAM, otorga los roles de cliente de AlloyDB requeridos (
roles/alloydb.clientyroles/alloydb.databaseUser) a la cuenta de servicio de la carga de trabajo en el proyecto que contiene el clúster de AlloyDB, en lugar de en el proyecto host o de concentrador.Configura una zona del DNS y un registro privados en el proyecto host y asocia la zona con la red de VPC compartida.
En la VPC compartida, todos los proyectos de servicio conectados comparten la red de VPC del host y resuelven automáticamente el nombre de host
pscDnsNamede la instancia sin zonas del DNS independientes en cada proyecto de servicio. En una topología de concentrador y radio de varias VPC en la que los proyectos de radio usan redes de VPC independientes, vincula la zona del DNS privada a las redes de VPC de radio con la vinculación entre proyectos o las zonas de intercambio de tráfico de Cloud DNS.
Como alternativa, para permitir que los administradores de proyectos de servicio creen y administren sus propios extremos directamente en sus respectivos proyectos de servicio con subredes compartidas, consulta Crea un extremo en un proyecto de servicio de VPC compartida.
Configura la conectividad saliente
Para habilitar la conectividad saliente, establece el URI del adjunto de red cuando crees o actualices una instancia de AlloyDB. Este URI permite la conectividad segura entre tu proyecto y la instancia de AlloyDB durante las operaciones salientes, como las migraciones.
Crea el adjunto de red
Puedes crear un adjunto de red que acepte conexiones de forma automática (ACCEPT_AUTOMATIC) o manual (ACCEPT_MANUAL). Para obtener más información sobre cómo crear un adjunto de red, consulta Crea y administra adjuntos de red.
Si eliges crear un adjunto de red que acepte conexiones de forma automática, no necesitas establecer una lista de proyectos aceptados de forma explícita. Para aceptar conexiones de forma manual, debes agregar el número del proyecto de servicio en el que se encuentra tu instancia de AlloyDB a la lista de proyectos aceptados.
Para encontrar el número de proyecto que pertenece al servicio, ejecuta el siguiente comando:
gcloud alloydb clusters describe CLUSTER_ID --region=REGION_IDA continuación, se muestra una respuesta de ejemplo:
pscConfig:
pscEnabled: true
serviceOwnedProjectNumber: 123456789012
Después de identificar el número de proyecto de propiedad del servicio, agrega el proyecto a la lista de proyectos aceptados y, luego, crea el adjunto de red.
Asegúrate de que la región del adjunto de red sea la misma que la de la instancia de AlloyDB. Además, la subred que se usa para crear el adjunto de red debe pertenecer a los rangos de IP de RFC 1918, que son 10.0.0.0/8, 172.16.0.0/12 y 192.168.0.0/16.
Actualiza una instancia para la conectividad saliente
Para habilitar la conectividad saliente en una instancia de AlloyDB existente
con Private Service Connect habilitado, usa el
comando gcloud alloydb instances update
con el parámetro --psc-network-attachment-uri:
gcloud alloydb instances update INSTANCE_ID \
--cluster=CLUSTER_ID \
--region=REGION_ID \
--project=PROJECT_ID \
--psc-network-attachment-uri=NETWORK_ATTACHMENT_URIReemplaza lo siguiente:
INSTANCE_ID: el ID de la instanciaCLUSTER_ID: Es el ID del clúster.REGION_ID: Es la región en la que se encuentra la instancia.PROJECT_ID: Es el ID del proyecto en el que se encuentra la instancia.NETWORK_ATTACHMENT_URI: Es el nombre completo del recurso del URI del adjunto de red que creas para la conectividad saliente, por ejemplo,projects/PROJECT_ID/regions/REGION_ID/networkAttachments/NETWORK_ATTACHMENT_ID.
Las instancias de AlloyDB creadas antes del 1 de marzo de 2025 no se pueden actualizar para habilitar las conexiones salientes. Como enfoque alternativo, te recomendamos que uses cualquiera de las siguientes opciones:
- Crea una réplica regional de replicación entre regiones (CRR) de tu instancia principal con la conectividad de salida habilitada. Luego, realiza un cambio para designar la instancia de réplica como la nueva instancia principal.
- Realiza una copia de seguridad de tu clúster y tu instancia principal de AlloyDB existentes. Luego, crea un clúster y una instancia principal de AlloyDB nuevos con la conectividad de salida habilitada. Por último, restablece la copia de seguridad creada antes en el clúster nuevo.
Desactiva la conectividad saliente
Para desactivar la conectividad de salida en una instancia de AlloyDB
existente, usa el comando gcloud alloydb instances update
con el parámetro --clear-psc-network-attachment-uri:
gcloud alloydb instances update INSTANCE_ID \
--cluster=CLUSTER_ID \
--region=REGION_ID \
--project=PROJECT_ID \
--clear-psc-network-attachment-uriReemplaza lo siguiente:
INSTANCE_ID: el ID de la instanciaCLUSTER_ID: Es el ID del clúster.REGION_ID: Es la región en la que se encuentra la instancia.PROJECT_ID: Es el ID del proyecto en el que se encuentra la instancia.
Conéctate a una instancia de AlloyDB
Puedes conectarte a una instancia de AlloyDB con Private Service Connect habilitado con una de las siguientes opciones:
- Conéctate directamente con un registro DNS
- Usa el proxy de AlloyDB Auth con un registro DNS
- Usa los conectores de lenguajes para AlloyDB con un registro DNS
- Conéctate directamente con una dirección IP interna
pscDnsName generado previamente de la instancia a la dirección IP interna del extremo de Private Service Connect cuando te conectes con el proxy de autenticación de AlloyDB o los conectores de lenguaje de AlloyDB.En el caso de los métodos que usan un registro DNS, debes crear el registro en una zona del DNS privado en la red de VPC del consumidor correspondiente. El pscDnsName que devuelve la API de AlloyDB es una cadena de nombre de host generada previamente y no se resuelve hasta que creas una zona del DNS privada y un registro A en tu red de VPC de consumidor.
Configura una zona administrada de DNS y un registro DNS
Para configurar una zona administrada de DNS y un registro DNS en tu red de consumidor, sigue estos pasos:
gcloud
Para ver información resumida sobre una instancia de AlloyDB, incluido el
pscDnsNamegenerado previamente de la instancia, usa el comandogcloud alloydb instances describe:gcloud alloydb instances describe INSTANCE_ID \ --cluster=CLUSTER_ID \ --region=REGION_ID \ --format='json(pscInstanceConfig)'Reemplaza lo siguiente:
INSTANCE_ID: el ID de la instanciaCLUSTER_ID: Es el ID del clúster.REGION_ID: Es la región en la que se encuentra la instancia.
En la respuesta, verifica que aparezca el campo
pscDnsName. El nombre de DNS tiene el patrónINSTANCE_UID.CLUSTER_UID.REGION_NAME.alloydb-psc.goog., por ejemplo,015f5524-0555-4a0a-ac5a-0d15d64b15cb.008225d5-070a-4566-aaad-fcb3c87c5901.us-east4.alloydb-psc.goog.Para crear una zona del DNS privada, usa el comando
gcloud dns managed-zones create. Esta zona está asociada con la red de VPC que se usa para conectarse a la instancia de AlloyDB a través del extremo de Private Service Connect.gcloud dns managed-zones create ZONE_NAME \ --project=PROJECT_ID \ --description=DESCRIPTION \ --dns-name=DNS_NAME \ --networks=NETWORK_NAME \ --visibility=privateReemplaza lo siguiente:
ZONE_NAME: Es el nombre de la zona del DNS.PROJECT_ID: el ID o el número del proyecto de Google Cloud que contiene la zona.DESCRIPTION: Es una descripción de la zona (por ejemplo,DNS zone for the AlloyDB instance).DNS_NAME: el nombre de DNS para la zona, comoINSTANCE_UID.CLUSTER_UID.REGION_NAME.alloydb-psc.goog.(o el dominio superioralloydb-psc.goog.).NETWORK_NAME: Es el nombre de la red de VPC del consumidor. En el caso de una red de VPC compartida, establece este valor en la ruta de acceso completamente calificada de la red de VPC, por ejemplo,projects/cymbal-project/global/networks/shared-vpc-network.
Después de crear el extremo de Private Service Connect, crea un registro DNS
Aen la zona con el comandogcloud dns record-sets create:gcloud dns record-sets create DNS_NAME \ --project=PROJECT_ID \ --type=RRSET_TYPE \ --rrdatas=RR_DATA \ --zone=ZONE_NAMEReemplaza lo siguiente:
DNS_NAME: Es elpscDnsNameque recuperaste antes en este procedimiento.RRSET_TYPE: el tipo de registro de recursos del conjunto de registros DNS (A).RR_DATA: la dirección IP interna asignada para el extremo de Private Service Connect (por ejemplo,198.51.100.5).
Terraform
Para crear una zona privada de Cloud DNS y un registro A que asigne el pscDnsName de la instancia a la dirección IP interna del extremo de Private Service Connect, usa los recursos de Terraform google_dns_managed_zone y google_dns_record_set:
resource "google_dns_managed_zone" "psc_dns_zone" {
name = "alloydb-psc-zone"
dns_name = google_alloydb_instance.default.psc_instance_config[0].psc_dns_name
description = "Private DNS zone for AlloyDB PSC endpoint"
visibility = "private"
private_visibility_config {
networks {
network_url = google_compute_network.default.id
}
}
}
resource "google_dns_record_set" "psc_dns_record" {
name = google_alloydb_instance.default.psc_instance_config[0].psc_dns_name
type = "A"
ttl = 300
managed_zone = google_dns_managed_zone.psc_dns_zone.name
rrdatas = [google_compute_address.psc_endpoint_ip.address]
}
Conéctate directamente con un registro DNS
Después de crear un extremo de Private Service Connect y configurar un registro DNS privado A para el pscDnsName de la instancia, puedes conectarte directamente desde un cliente en la red de VPC del consumidor con el nombre de DNS (sin el punto final):
psql -U USERNAME -h DNS_NAME -d DATABASE_NAMEReemplaza lo siguiente:
USERNAME: Es el nombre del usuario de la base de datos que se conecta a la instancia.DNS_NAME: Es el nombre del registro DNS (como elpscDnsNamede la instancia sin el punto final) que se resuelve en el extremo de Private Service Connect.DATABASE_NAME: Es el nombre de la base de datos a la que te conectarás (por ejemplo,postgres).
Conéctate con el proxy de autenticación de AlloyDB
El proxy de autenticación de AlloyDB es un conector que te permite establecer conexiones autorizadas y encriptadas con bases de datos de AlloyDB. El proxy de autenticación de AlloyDB funciona con un cliente local que se ejecuta en el entorno local. La aplicación se comunica con el proxy de autenticación de AlloyDB a través del protocolo de base de datos estándar que usa tu base de datos.
Cuando configuras la marca --psc mientras inicias el cliente del proxy de autenticación, el proxy de autenticación de AlloyDB resuelve el pscDnsName de la instancia con el registro DNS privado que creaste para conectarte a la instancia habilitada para Private Service Connect.
Inicia el cliente del proxy de autenticación pasando el URI de la instancia que recuperas con el comando gcloud alloydb instances describe y establece la marca --psc.
Para obtener más información sobre cómo conectarte a una instancia con el proxy de autenticación, consulta Conéctate con el proxy de autenticación de AlloyDB.
Conéctate con los conectores de lenguajes para AlloyDB
Los conectores de lenguajes para AlloyDB son bibliotecas que proporcionan mTLS automatizada con TLS 1.3 y autorización de IAM cuando se conectan a una instancia de AlloyDB.
Después de configurar el conector de lenguaje para Private Service Connect, este resuelve el pscDnsName de la instancia con el registro DNS privado que creaste para conectarte a la instancia.
Java
Si usas Private Service Connect para conectarte a tu instancia de AlloyDB, incluye lo siguiente:
config.addDataSourceProperty("alloydbIpType", "PSC");
Para obtener más información sobre cómo usar un extremo de Private Service Connect en el conector de Java para AlloyDB, consulta el repositorio de GitHub.
Python (pg8000)
Si usas Private Service Connect para conectarte a tu instancia de AlloyDB, incluye lo siguiente:
def getconn() -> pg8000.dbapi.Connection:
conn: pg8000.dbapi.Connection = connector.connect(
inst_uri,
"pg8000",
user=user,
password=password,
db=db,
# use ip_type to specify PSC
ip_type=IPTypes.PSC,
)
return conn
Para obtener más información sobre cómo usar un extremo de Private Service Connect en el conector de AlloyDB para Python, consulta el repositorio de GitHub.
Python (asyncpg)
Si usas Private Service Connect para conectarte a tu instancia de AlloyDB, incluye lo siguiente:
async def getconn() -> asyncpg.Connection:
conn: asyncpg.Connection = await connector.connect(
inst_uri,
"asyncpg",
user=user,
password=password,
db=db,
# use ip_type to specify PSC
ip_type=IPTypes.PSC,
)
return conn
Para obtener más información sobre cómo usar un extremo de Private Service Connect en el conector de AlloyDB para Python, consulta el repositorio de GitHub.
Go (pgx)
Si usas Private Service Connect para conectarte a tu instancia de AlloyDB, incluye lo siguiente:
d.Dial(ctx, instURI, alloydbconn.WithPSC())
Para obtener más información sobre cómo usar un extremo de Private Service Connect en el conector de Go para AlloyDB, consulta el repositorio de GitHub.
Go (database/sql)
Si usas Private Service Connect para conectarte a tu instancia de AlloyDB, incluye lo siguiente:
cleanup, err := postgres.RegisterDriver(
"alloydb",
alloydbconn.WithDefaultDialOptions(alloydbconn.WithPSC()),
)
Para obtener más información sobre cómo usar un extremo de Private Service Connect en el conector de Go para AlloyDB, consulta el repositorio de GitHub.
Conéctate directamente a través de una dirección IP interna
Después de crear un extremo de Private Service Connect, puedes conectarte directamente a una instancia de AlloyDB con la dirección IP interna del extremo sin configurar un registro DNS.
Para recuperar la dirección IP de un extremo de Private Service Connect creado de forma manual, usa el comando
gcloud compute addresses describe:gcloud compute addresses describe ADDRESS_NAME \ --project=PROJECT_ID \ --region=REGION_NAMEReemplaza lo siguiente:
ADDRESS_NAME: el nombre del recurso de dirección IP reservada del extremo.PROJECT_ID: Es el ID o el número del proyecto de Google Cloud que contiene el extremo.REGION_NAME: es el nombre de la región para el extremo.
Para conectarte a la instancia de AlloyDB, usa la dirección IP interna:
psql -U USERNAME -h IP_ADDRESSReemplaza lo siguiente:
USERNAME: Es el nombre del usuario que se conecta a la instancia.IP_ADDRESS: Es la dirección IP interna del extremo.
Limitaciones
- Puedes configurar hasta 20 extremos de Private Service Connect que se conecten al adjunto de servicio de una instancia de AlloyDB con Private Service Connect habilitado.
- No puedes usar la marca
--networkcuando creas un clúster habilitado para Private Service Connect porque está asociada con el acceso privado a servicios. - No puedes activar ni desactivar Private Service Connect en una instancia existente.
- No puedes configurar una instancia que tenga Private Service Connect habilitado para usar el acceso privado a servicios.