Conectarse a una instancia mediante Private Service Connect

Consola

1. En la Google Cloud consola, ve a la página Private Service Connect.

   Ir a Private Service Connect

2. Haga clic en la pestaña Políticas de conexión.

3. Haz clic en Crear política de conexión.

4. Introduce un Nombre para la política de conexión.

5. Para especificar la clase de servicio, haz lo siguiente:

   1. En Clase de servicio de origen, selecciona Servicios de Google.
   2. En el menú Clase de servicio, selecciona google-cloud-alloydb, ya que AlloyDB es el servicio gestionado de la política de conexión.

6. En la sección Ámbito de los endpoints de destino, selecciona una red y una región a las que se aplique esta política.

7. En la sección Política, seleccione una o varias subredes en el menú Subredes. Las subredes se usan para asignar direcciones IP a los endpoints.

8. Opcional: Especifica un límite de conexión para la política. El límite determina cuántos endpoints puede crear AlloyDB para esta política de conexión. Si no especificas un límite de conexiones, no habrá ninguno.

9. 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

Haz los cambios siguientes:

• POLICY_NAME: el nombre de tu política de conexión de servicio.
• NETWORK: la red a la que se aplica esta política.
• PROJECT_ID: el ID o el número del proyecto de la red 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 se admiten en los proyectos de servicio.
• REGION: la región a la que se aplica esta política. Debe haber una política igual en todas las regiones en las que quiera automatizar la conectividad de los servicios.
• SERVICE_CLASS: identificador de recurso de la clase de servicio proporcionado por el productor. En el caso de AlloyDB, la clase de servicio es google-cloud-alloydb.
• SUBNETS: una o varias subredes de consumidor normales que se usan para asignar direcciones IP a los puntos finales 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 se eliminan instancias de servicio gestionado. 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 reutilizar la misma subred en estas políticas. Puede introducir varias subredes en una lista separada por comas.
• LIMIT: número máximo de endpoints que puede crear con esta política. Si no especificas ningún límite, no habrá ninguno.
• DESCRIPTION: una descripción opcional de la política de conexión de servicios.

• PRODUCER_INSTANCE_LOCATION: especifica si la política automatiza las conexiones a las instancias de AlloyDB. Puede definir este valor de una de las siguientes formas:

  • none (predeterminado): la instancia de AlloyDB está en el mismo proyecto que la política de conexión de servicio (o, en el caso de la VPC compartida, en los proyectos conectados).
  • custom-resource-hierarchy-levels: requiere que definas la ruta de ubicación de Resource Manager de los proyectos para los que quieras automatizar la conectividad mediante el parámetro allowed-google-producers-resource-hierarchy-level.

• LIST_OF_NODES: defina este parámetro si la ubicación de su instancia de productor es custom-resource-hierarchy-levels. Este parámetro es una lista de proyectos, carpetas y organizaciones en los que residen las instancias para las que quieres automatizar la conectividad. La lista tiene el formato projects/PROJECT_ID, folders/FOLDER_ID o organizations/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 de la subred managed-services. Se pueden crear un máximo de 10 endpoints de Private Service Connect con esta política. Los endpoints deben crearse en proyectos que estén en la misma organización que la instancia de servicio gestionado. 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

Consola

1. En la Google Cloud consola, ve a la página Clusters.

   Ir a Clústeres

2. Haz clic en Crear clúster.

3. En ID de clúster, introduzca my-cluster.

4. Introduce una contraseña. Anota esta contraseña, ya que la usarás en esta guía de inicio rápido.

5. Conserva la versión predeterminada de la base de datos.

6. Selecciona la región us-central1 (Iowa).

7. Conserva el ID de instancia predeterminado, my-cluster-primary.

8. En Disponibilidad zonal, mantén Una sola zona como opción seleccionada. Aunque no recomendamos usar una instancia de una sola zona en producción, en este inicio rápido se utiliza una sola zona para minimizar los costes. Para obtener más información, consulta Reducir costes con instancias básicas.

9. Selecciona el tipo de máquina 2 vCPU, 16 GB.

10. Mantener la conectividad de IP privada.

    1. Selecciona Private Service Connect (PSC).
    2. Haz clic en Añadir un endpoint.
    3. Selecciona el proyecto en el que quieras crear el endpoint.
    4. Selecciona la red.
    5. Haz clic en Comprobar política para ver información sobre la política de conexión de servicios.

11. Mantenga los ajustes predeterminados en Seguridad de red.

12. No hagas cambios en Mostrar opciones avanzadas.

13. Haz clic en Crear clúster. AlloyDB puede tardar varios minutos en crear el clúster y mostrarlo en la página Resumen 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-connect

Haz los cambios siguientes:

• CLUSTER_ID: el ID del clúster que vas a crear. Debe empezar por una letra minúscula y puede contener letras minúsculas, números y guiones.

• PASSWORD: la contraseña que se usará para el usuario postgres predeterminado.

• REGION_ID: la región en la que quieras colocar el clúster.

• PROJECT_ID: el ID del proyecto en el que quieres colocar el clúster.

Este comando inicia una operación de larga duración y devuelve un ID de operación.

Para crear la instancia de AlloyDB, ya sea la principal o un grupo de lectura para usar Private Service Connect, usa el comando gcloud alloydb instances create. Asegúrate de incluir el parámetro --allowed-psc-projects para especificar qué proyectos de consumidor pueden crear endpoints 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_PROJECT

Haz los cambios siguientes:

• INSTANCE_ID: el ID de la instancia que vas a crear. Debe empezar por una letra minúscula y puede contener letras minúsculas, números y guiones.
• CPU_COUNT: el número de vCPUs que quieres asignar a la instancia. Estos son algunos de los valores válidos:
  • 2: 2 vCPUs, 16 GB de RAM
  • 4: 4 vCPUs, 32 GB de RAM
  • 8: 8 vCPUs, 64 GB de RAM
  • 16: 16 vCPUs y 128 GB de RAM
  • 32: 32 vCPUs, 256 GB de RAM
  • 64: 64 vCPUs, 512 GB de RAM
  • 96: 96 vCPUs, 768 GB de RAM
  • 128: 128 vCPUs, 864 GB de RAM
• AVAILABILITY: indica si esta instancia debe tener alta disponibilidad (HA) con nodos en varias zonas. Los valores válidos son los siguientes:
  • REGIONAL: crea una instancia de alta disponibilidad con nodos activos y en espera independientes, así como una conmutación por error automatizada 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 automática.
• REGION_ID: la región en la que quieres que se coloque la instancia.
• CLUSTER_ID: el ID del clúster que has creado anteriormente.
• ALLOWED_PROJECT_LIST: lista de IDs de proyecto separados por comas o números de proyecto a los que quieres permitir el acceso a la instancia (por ejemplo, my-project-1, 12345,my-project-n).
• NETWORK_ATTACHMENT_URI (Opcional): el nombre completo del recurso del URI de adjunto de red que crees para la conectividad saliente. Por ejemplo: projects/PROJECT_ID/regions/REGION_ID/networkAttachments/NETWORK_ATTACHMENT_ID.
• CONSUMER_NETWORK: la ruta a la red de VPC en la que se deben crear los endpoints de Private Service Connect. Por ejemplo: projects/my-host-project/global/networks/default. Esta opción se aplica cuando creas endpoints automáticamente. Asegúrate de que se haya creado la política de conexión de servicio. Puedes crear la política antes o después de crear la instancia.
• CONSUMER_PROJECT: proyecto en el que se crea el endpoint de Private Service Connect. Si utilizas una red de VPC compartida, puede ser el proyecto del host o el proyecto de servicio. Los proyectos que especifiques en los parámetros de conexión automática se añadirán automáticamente a tus proyectos permitidos. Si quieres crear manualmente puntos finales de Private Service Connect en algún proyecto, puedes añadirlo a tu lista de proyectos permitidos.

Un clúster secundario creado para un clúster principal con Private Service Connect habilitado hereda automáticamente la configuración de Private Service Connect. Para obtener más información, consulta Crear un clúster secundario.

Terraform

Para crear una instancia en tu clúster de base de datos, usa un recurso de Terraform.

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 = ["123456789"]
  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" {}

Para saber cómo aplicar o quitar una configuración de Terraform, consulta Comandos básicos de Terraform.

Consola

1. En la Google Cloud consola, ve a la página Clusters.

   Ir a Clústeres

2. Haz clic en Crear clúster.

3. En ID de clúster, introduzca my-cluster.

4. Introduce una contraseña. Anota esta contraseña, ya que la usarás en esta guía de inicio rápido.

5. Conserva la versión predeterminada de la base de datos.

6. Selecciona la región us-central1 (Iowa).

7. Conserva el ID de instancia predeterminado, my-cluster-primary.

8. En Disponibilidad zonal, mantén Una sola zona como opción seleccionada. Aunque no recomendamos usar una instancia de una sola zona en producción, en este inicio rápido se utiliza una sola zona para minimizar los costes. Para obtener más información, consulta Reducir costes con instancias básicas.

9. Selecciona el tipo de máquina 2 vCPU, 16 GB.

10. Mantener la conectividad de IP privada.

    1. Selecciona Private Service Connect(PSC).
    2. Haz clic en Añadir un endpoint.
    3. Selecciona el proyecto en el que quieras crear el endpoint.
    4. Selecciona la red.
    5. Haz clic en Comprobar política para ver información sobre la política de conexión de servicios.

11. Mantenga los ajustes predeterminados en Seguridad de red.

12. No hagas cambios en Mostrar opciones avanzadas.

13. Haz clic en Crear clúster. AlloyDB puede tardar varios minutos en crear el clúster y mostrarlo en la página Resumen 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-connect

Haz los cambios siguientes:

• CLUSTER_ID: el ID del clúster que vas a crear. Debe empezar por una letra minúscula y puede contener letras minúsculas, números y guiones.

• PASSWORD: la contraseña que se usará para el usuario postgres predeterminado.

• REGION_ID: la región en la que quieras colocar el clúster.

• PROJECT_ID: el ID del proyecto en el que quieres colocar el clúster.

Este comando inicia una operación de larga duración y devuelve 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_URI \

Haz los cambios siguientes:

• INSTANCE_ID: el ID de la instancia que vas a crear. Debe empezar por una letra minúscula y puede contener letras minúsculas, números y guiones.
• CPU_COUNT: el número de vCPUs que quieres asignar a la instancia. Estos son algunos de los valores válidos:
  • 2: 2 vCPUs, 16 GB de RAM
  • 4: 4 vCPUs, 32 GB de RAM
  • 8: 8 vCPUs, 64 GB de RAM
  • 16: 16 vCPUs y 128 GB de RAM
  • 32: 32 vCPUs, 256 GB de RAM
  • 64: 64 vCPUs, 512 GB de RAM
  • 96: 96 vCPUs, 768 GB de RAM
  • 128: 128 vCPUs, 864 GB de RAM
• AVAILABILITY: indica si esta instancia debe tener alta disponibilidad (HA) con nodos en varias zonas. Los valores válidos son los siguientes:
  • REGIONAL: crea una instancia de alta disponibilidad con nodos activos y en espera independientes, así como una conmutación por error automatizada 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 automática.
• REGION_ID: la región en la que quieres que se coloque la instancia.
• CLUSTER_ID: el ID del clúster que has creado anteriormente.
• ALLOWED_PROJECT_LIST: la lista de IDs de proyecto o números de proyecto separados por comas a los que quieres permitir el acceso a la instancia. Por ejemplo, my-project-1, 12345,my-project-n.
• NETWORK_ATTACHMENT_URI (Opcional): el nombre completo del recurso del URI de adjunto de red que crees para la conectividad saliente. Por ejemplo: projects/PROJECT_ID/regions/REGION_ID/networkAttachments/NETWORK_ATTACHMENT_ID.
• CONSUMER_NETWORK: la ruta a la red de VPC desde la que se deben crear los puntos finales de Private Service Connect. Por ejemplo: projects/my-host-project/global/networks/default. Esta opción se aplica cuando creas endpoints automáticamente. Asegúrate de que se haya creado la política de conexión de servicio. Puedes crear la política antes o después de crear la instancia.
• CONSUMER_PROJECT: proyecto en el que se crea el endpoint de Private Service Connect. Si utilizas una red de VPC compartida, puede ser el proyecto del host o el proyecto de servicio. Los proyectos que especifiques en los parámetros de conexión automática se añadirán automáticamente a tus proyectos permitidos. Si quieres crear manualmente puntos finales de Private Service Connect en algún proyecto, puedes añadirlo a tu lista de proyectos permitidos.

Un clúster secundario creado para un clúster principal con Private Service Connect habilitado hereda automáticamente la configuración de Private Service Connect. Para obtener más información, consulta Crear un clúster secundario.

Terraform

Para crear una instancia en tu clúster de base de datos, usa un recurso de Terraform.

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 = ["123456789"]
  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" {}

Para saber cómo aplicar o quitar una configuración de Terraform, consulta Comandos básicos de Terraform.

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 el endpoint de Private Service Connect en conectores de lenguaje Java, 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 el endpoint de Private Service Connect en conectores de lenguaje 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 el endpoint de Private Service Connect en conectores de lenguaje 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 el punto final de Private Service Connect en conectores de lenguaje Go, 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 := pgxv5.RegisterDriver(
    "alloydb",
    alloydbconn.WithDefaultDialOptions(alloydbconn.WithPSC())
)

Para obtener más información sobre cómo usar el punto final de Private Service Connect en conectores de lenguaje Go, consulta el repositorio de GitHub.