Conéctate a una instancia mediante Private Service Connect

Console

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

   Ir a Private Service Connect

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

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

4. Ingresa 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 porque AlloyDB es el servicio administrado para la política de conexión.

6. En la sección Alcance de los extremos de destino, selecciona una Red y una Región a las que se aplicará esta política.

7. En la sección Política, selecciona una o más subredes en el menú Subredes. Las subredes se usan para asignar direcciones IP a los extremos.

8. 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 conexión, no habrá límite.

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

Reemplaza lo siguiente:

• POLICY_NAME: el nombre de la política de conexión del servicio.
• NETWORK: Es 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. En el caso de AlloyDB, la clase de servicio es google-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 esas 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á límite.
• 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 de una de las siguientes maneras:

  • none (predeterminado): La instancia de AlloyDB se encuentra en el mismo proyecto que la política de conexión de servicio (o, en el caso de la VPC compartida, en proyectos conectados).
  • custom-resource-hierarchy-levels: Requiere que establezcas la ruta de ubicación de Resource Manager para los proyectos para los que deseas automatizar la conectividad a través del parámetro allowed-google-producers-resource-hierarchy-level.

• LIST_OF_NODES: Establece este parámetro si la ubicación de tu instancia de productor está establecida en custom-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 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 desde la subred managed-services. 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

Console

1. En la consola de Google Cloud , ve a la página Clústeres.

   Ir a los clústeres

2. Haga clic en Crear clúster.

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

4. Ingresa una contraseña. Toma nota de esta contraseña porque la usarás en esta guía de inicio rápido.

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

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

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

8. En Disponibilidad zonal, conserva Zona única como la opción seleccionada. Si bien no recomendamos una instancia de una sola zona para la producción, en esta guía de inicio rápido se usa una sola zona para minimizar los costos. Para obtener más información, consulta Reduce los costos con instancias básicas.

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

10. Conserva la conectividad de IP privada.

    1. Selecciona Private Service Connect (PSC).
    2. Haz clic en Agregar un extremo.
    3. Selecciona el proyecto en el que deseas crear el extremo.
    4. Selecciona la Red.
    5. Haz clic en Check policy para obtener información sobre la política de conexión de servicio.

11. Conserva la configuración predeterminada en Seguridad de red.

12. No realices cambios en Mostrar opciones avanzadas.

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

Reemplaza lo siguiente:

• CLUSTER_ID: Es el ID del clúster que creas. 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 usuario postgres predeterminado.

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

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

Este comando inicia una operación de larga duración y 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. Asegúrate de incluir 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_PROJECT

Reemplaza 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 CPU virtuales que deseas para la instancia. Los valores válidos incluyen lo siguiente:
  • 2: 2 CPU virtuales, 16 GB de RAM
  • 4: 4 CPUs virtuales y 32 GB de RAM
  • 8: 8 CPU virtuales, 64 GB de RAM
  • 16: 16 CPU virtuales, 128 GB de RAM
  • 32: 32 CPU virtuales y 256 GB de RAM
  • 64: 64 CPU virtuales y 512 GB de RAM
  • 96: 96 CPU virtuales, 768 GB de RAM
  • 128: 128 CPU virtuales y 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 HA con nodos activos y en espera separados, y 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: Es la región en la que deseas colocar la instancia.
• CLUSTER_ID: Es el ID del clúster que creaste antes.
• ALLOWED_PROJECT_LIST: Es la lista separada por comas de los IDs de proyectos o los 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 de adjunto de red que creas para la conectividad saliente. 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 deben crear 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 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: Es 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 los proyectos en los que desees crear extremos de Private Service Connect de forma manual, puedes agregarlos 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 una instancia dentro de tu clúster de bases 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 obtener más información sobre cómo aplicar o quitar una configuración de Terraform, consulta Comandos básicos de Terraform.

Console

1. En la consola de Google Cloud , ve a la página Clústeres.

   Ir a los clústeres

2. Haga clic en Crear clúster.

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

4. Ingresa una contraseña. Toma nota de esta contraseña porque la usarás en esta guía de inicio rápido.

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

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

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

8. En Disponibilidad zonal, conserva Zona única como la opción seleccionada. Si bien no recomendamos una instancia de una sola zona para la producción, en esta guía de inicio rápido se usa una sola zona para minimizar los costos. Para obtener más información, consulta Reduce los costos con instancias básicas.

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

10. Conserva la conectividad de IP privada.

    1. Selecciona Private Service Connect(PSC).
    2. Haz clic en Agregar un extremo.
    3. Selecciona el proyecto en el que deseas crear el extremo.
    4. Selecciona la Red.
    5. Haz clic en Check policy para obtener información sobre la política de conexión de servicio.

11. Conserva la configuración predeterminada en Seguridad de red.

12. No realices cambios en Mostrar opciones avanzadas.

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

Reemplaza lo siguiente:

• CLUSTER_ID: Es el ID del clúster que creas. 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 usuario postgres predeterminado.

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

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

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

Reemplaza 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 CPU virtuales que deseas para la instancia. Los valores válidos incluyen lo siguiente:
  • 2: 2 CPU virtuales, 16 GB de RAM
  • 4: 4 CPUs virtuales y 32 GB de RAM
  • 8: 8 CPU virtuales, 64 GB de RAM
  • 16: 16 CPU virtuales, 128 GB de RAM
  • 32: 32 CPU virtuales y 256 GB de RAM
  • 64: 64 CPU virtuales y 512 GB de RAM
  • 96: 96 CPU virtuales, 768 GB de RAM
  • 128: 128 CPU virtuales y 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 HA con nodos activos y en espera separados, y 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: Es la región en la que deseas colocar la instancia.
• CLUSTER_ID: Es el ID del clúster que creaste antes.
• ALLOWED_PROJECT_LIST: Es la lista separada por comas de los IDs de proyectos o el número de proyecto al 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 de adjunto de red que creas para la conectividad saliente. Por ejemplo: projects/PROJECT_ID/regions/REGION_ID/networkAttachments/NETWORK_ATTACHMENT_ID.
• CONSUMER_NETWORK: Es la ruta de acceso a la red de VPC desde la que se deben crear 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 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: Es 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 los proyectos en los que desees crear extremos de Private Service Connect de forma manual, puedes agregarlos 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 una instancia dentro de tu clúster de bases 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 obtener más información sobre 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 el uso del extremo de Private Service Connect en los conectores de lenguaje de 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 el uso del extremo de Private Service Connect en los conectores de lenguaje de 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 el uso del extremo de Private Service Connect en los conectores de lenguaje de 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 el uso del extremo de Private Service Connect en los conectores del 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 el uso del extremo de Private Service Connect en los conectores del lenguaje Go, consulta el repositorio de GitHub.