Configurar IP privada

Organízate con las colecciones Guarda y clasifica el contenido según tus preferencias.

Consola

1. En el Google Cloud consola, vaya a la página Instancias de Cloud SQL .

   Ir a Instancias de Cloud SQL

2. Haga clic en Crear instancia .
3. Expandir Mostrar opciones de configuración .
4. Expandir conexiones .
5. Seleccione IP privada .

   Una lista desplegable muestra las redes de VPC disponibles en su proyecto. Si su proyecto es el proyecto de servicio de una VPC compartida , también se muestran las redes de VPC del proyecto host.

6. Seleccione la red VPC que desea utilizar.

Si ve un mensaje que indica que necesita configurar una conexión de servicio privada, haga lo siguiente:

1. Haga clic en Configurar conexión .
2. En la sección Asignar un rango de IP , seleccione una de las siguientes opciones:
   • Seleccione uno o más rangos de IP existentes o cree uno nuevo en el menú desplegable. Este menú incluye los rangos previamente asignados, si los hay, o puede seleccionar "Asignar un nuevo rango de IP" e introducir un nuevo rango y un nombre.
   • Utilice un rango de IP asignado automáticamente en su red .
3. Haga clic en Continuar .
4. Haga clic en Crear conexión .
5. Verifique que vea el mensaje: Private service connection for network VPC_NETWORK_NAME has been successfully created .
7. Opcionalmente, puede especificar un rango de IP asignado para que sus instancias lo utilicen para las conexiones.
   1. Expandir la opción Mostrar rango de IP asignado .
   2. Seleccione un rango de IP del menú desplegable.
8. Opcional. Si desea permitir otros Google Cloud servicios, como BigQuery, para acceder a datos en Cloud SQL y realizar consultas sobre estos datos a través de una conexión IP privada; luego, seleccione Habilitar ruta privada .
9. Termine de configurar su instancia.
10. Haga clic en Crear instancia .

nube g

Antes de crear una instancia utilizando una dirección IP privada, asegúrese de que su proyecto esté configurado para el acceso a servicios privados .

Antes de utilizar cualquiera de los datos solicitados, realice las siguientes sustituciones:

• INSTANCE_ID : El ID de la instancia
• PROJECT_ID : El ID del proyecto

• NETWORK_PROJECT_ID : El ID del proyecto de la red VPC

• VPC_NETWORK_NAME : El nombre de la red VPC
• RANGE_NAME : Opcional. Si se especifica, establece un nombre de rango para el cual se asigna un rango IP. El nombre del rango debe cumplir con RFC-1035 y contener entre 1 y 63 caracteres.
• DATABASE_VERSION : La versión de la base de datos PostgreSQL (por ejemplo, POSTGRES_14 )
• NUMBER_OF_CPU : El número de CPU
• MEMORY_IN_GB : La cantidad de memoria (en GB)
• REGION_NAME : El nombre de la región

Además, opcionalmente, utilice el parámetro --enable-google-private-path para permitir otros Google Cloud Servicios como BigQuery para acceder a datos en Cloud SQL y realizar consultas sobre estos datos a través de una conexión IP privada. Este parámetro solo es válido si:

• Utilice el parámetro --no-assign-ip .
• Utilice el parámetro --network para especificar el nombre de la red VPC que desea utilizar para crear una conexión privada.

gcloud beta sql instances create INSTANCE_ID \
--project=PROJECT_ID \
--network=projects/NETWORK_PROJECT_ID/global/networks/VPC_NETWORK_NAME \
--no-assign-ip \
--allocated-ip-range-name=RANGE_NAME \
--enable-google-private-path \
--database-version=DATABASE_VERSION \
--cpu=NUMBER_OF_CPU \
--memory=MEMORY_IN_GB \
--region=REGION_NAME

Terraformar

Para configurar una IP privada para una nueva instancia, utilice los siguientes recursos de Terraform:

• google_compute_network
• google_compute_global_address
• google_service_networking_connection
• google_sql_database_instance

resource "google_compute_network" "peering_network" {
  name                    = "private-network"
  auto_create_subnetworks = "false"
}

resource "google_compute_global_address" "private_ip_address" {
  name          = "private-ip-address"
  purpose       = "VPC_PEERING"
  address_type  = "INTERNAL"
  prefix_length = 16
  network       = google_compute_network.peering_network.id
}

resource "google_service_networking_connection" "default" {
  network                 = google_compute_network.peering_network.id
  service                 = "servicenetworking.googleapis.com"
  reserved_peering_ranges = [google_compute_global_address.private_ip_address.name]
}

resource "google_sql_database_instance" "default" {
  name             = "private-ip-sql-instance"
  region           = "us-central1"
  database_version = "POSTGRES_14"

  depends_on = [google_service_networking_connection.default]

  settings {
    tier = "db-custom-2-7680"
    ip_configuration {
      ipv4_enabled    = "false"
      private_network = google_compute_network.peering_network.id
    }
  }
}

resource "google_compute_network_peering_routes_config" "peering_routes" {
  peering              = google_service_networking_connection.default.peering
  network              = google_compute_network.peering_network.name
  import_custom_routes = true
  export_custom_routes = true
}

# [START  cloud_sql_postgres_instance_private_ip_dns]

## Uncomment this block after adding a valid DNS suffix

# resource "google_service_networking_peered_dns_domain" "default" {
#   name       = "example-com"
#   network    = google_compute_network.peering_network.id
#   dns_suffix = "example.com."
#   service    = "servicenetworking.googleapis.com"
# }

Aplicar los cambios

Para aplicar su configuración de Terraform en un Google Cloud proyecto, complete los pasos de las siguientes secciones.

Preparar Cloud Shell

1. Inicie Cloud Shell .

2. Establecer el valor predeterminado Google Cloud Proyecto donde desea aplicar sus configuraciones de Terraform.

   Solo necesitas ejecutar este comando una vez por proyecto y puedes ejecutarlo en cualquier directorio.

   export GOOGLE_CLOUD_PROJECT=PROJECT_ID

   Las variables de entorno se anulan si establece valores explícitos en el archivo de configuración de Terraform.

Preparar el directorio

Cada archivo de configuración de Terraform debe tener su propio directorio (también llamado módulo raíz ).

1. En Cloud Shell , cree un directorio y un nuevo archivo dentro de él. El nombre del archivo debe tener la extensión .tf ; por ejemplo, main.tf En este tutorial, el archivo se denomina main.tf

   mkdir DIRECTORY && cd DIRECTORY && touch main.tf

2. Si está siguiendo un tutorial, puede copiar el código de muestra en cada sección o paso.

   Copie el código de muestra en el main.tf recién creado.

   Opcionalmente, copie el código de GitHub. Esto se recomienda cuando el fragmento de Terraform forma parte de una solución integral.

3. Revise y modifique los parámetros de muestra para aplicarlos a su entorno.
4. Guarde sus cambios.
5. Inicialice Terraform. Solo necesita hacerlo una vez por directorio.

   terraform init

   Opcionalmente, para utilizar la última versión del proveedor de Google, incluya la opción -upgrade :

   terraform init -upgrade

Aplicar los cambios

1. Revise la configuración y verifique que los recursos que Terraform va a crear o actualizar coincidan con sus expectativas:

   terraform plan

   Realice correcciones en la configuración según sea necesario.

2. Aplique la configuración de Terraform ejecutando el siguiente comando e ingresando yes en el indicador:

   terraform apply

   Espere hasta que Terraform muestre el mensaje "¡Aplicación completada!"

3. Abre tu Google Cloud proyecto para ver los resultados. En el Google Cloud consola, navegue a sus recursos en la interfaz de usuario para asegurarse de que Terraform los haya creado o actualizado.

Eliminar los cambios

Para eliminar sus cambios, haga lo siguiente:

1. Para deshabilitar la protección contra eliminación, en el archivo de configuración de Terraform configure el argumento deletion_protection en false .

   deletion_protection =  "false"

2. Aplique la configuración actualizada de Terraform ejecutando el siguiente comando e ingresando yes en el mensaje:

   terraform apply

3. Elimine los recursos aplicados previamente con su configuración de Terraform ejecutando el siguiente comando e ingresando yes en el mensaje:

   terraform destroy

REST versión 1

Cree una nueva instancia con una dirección IP privada:

Antes de utilizar cualquiera de los datos solicitados, realice las siguientes sustituciones:

• PROJECT_ID: El ID del proyecto
• INSTANCE_ID: El ID de la instancia
• VPC_NETWORK_NAME: Especifique el nombre de la red de nube virtual privada (VPC) que desea usar para esta instancia. El acceso a servicios privados debe estar configurado previamente para la red.
• RANGE_NAME: Opcional. Si se especifica, establece un nombre de rango para el cual se asigna un rango IP. El nombre del rango debe cumplir con RFC-1035 y contener entre 1 y 63 caracteres.
• AUTHORIZED_NETWORKS: Para conexiones IP públicas, especifique las conexiones de redes autorizadas que pueden conectarse a su instancia.

Para el parámetro ipv4Enabled , establezca el valor en true si está usando una dirección IP pública para su instancia o false si su instancia tiene una dirección IP privada.

Si establece el parámetro enablePrivatePathForGoogleCloudServices en true , entonces permite otros Google Cloud Servicios como BigQuery para acceder a datos en Cloud SQL y realizar consultas sobre estos datos a través de una conexión IP privada. Al establecer este parámetro en false , otros... Google Cloud Los servicios no pueden acceder a los datos en Cloud SQL a través de una conexión IP privada.

Método HTTP y URL:

POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances

Cuerpo JSON de la solicitud:

{
  "name": "INSTANCE_ID",
  "region": "region",
  "databaseVersion": "database-version",
  "settings": {
    "tier": "machine-type",
    "ipConfiguration": {
      "ipv4Enabled": false,
      "privateNetwork": "projects/PROJECT_ID/global/networks/VPC_NETWORK_NAME",
      "allocatedIpRange": "RANGE_NAME"
      "authorizedNetworks": [AUTHORIZED_NETWORKS],
      
      "enablePrivatePathForGoogleCloudServices": true
      
    }
  }
}

Para enviar su solicitud, expanda una de estas opciones:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances" | Select-Object -Expand Content

Debería recibir una respuesta JSON similar a la siguiente:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "[email protected]",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "CREATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta4

Cree una nueva instancia con una dirección IP privada:

Antes de utilizar cualquiera de los datos solicitados, realice las siguientes sustituciones:

• PROJECT_ID: El ID del proyecto
• INSTANCE_ID: El ID de la instancia
• VPC_NETWORK_NAME: Especifique el nombre de la red de nube virtual privada (VPC) que desea usar para esta instancia. El acceso a servicios privados debe estar configurado previamente para la red.
• RANGE_NAME: Opcional. Si se especifica, establece un nombre de rango para el cual se asigna un rango IP. El nombre del rango debe cumplir con RFC-1035 y contener entre 1 y 63 caracteres.
• AUTHORIZED_NETWORKS: Para conexiones IP públicas, especifique las conexiones de redes autorizadas que pueden conectarse a su instancia.

Para el parámetro ipv4Enabled , establezca el valor en true si está usando una dirección IP pública para su instancia o false si su instancia tiene una dirección IP privada.

Si establece el parámetro enablePrivatePathForGoogleCloudServices en true , entonces permite otros Google Cloud Servicios como BigQuery para acceder a datos en Cloud SQL y realizar consultas sobre estos datos a través de una conexión IP privada. Al establecer este parámetro en false , otros... Google Cloud Los servicios no pueden acceder a los datos en Cloud SQL a través de una conexión IP privada.

Método HTTP y URL:

POST https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances

Cuerpo JSON de la solicitud:

{
  "name": "INSTANCE_ID",
  "region": "region",
  "databaseVersion": "database-version",
  "settings": {
    "tier": "machine-type",
    "ipConfiguration": {
      "ipv4Enabled": false,
      "privateNetwork": "projects/PROJECT_ID/global/networks/VPC_NETWORK_NAME",
      "allocatedIpRange": "RANGE_NAME"
      "authorizedNetworks": [AUTHORIZED_NETWORKS],
      
      "enablePrivatePathForGoogleCloudServices": true
      
    }
  }
}

Para enviar su solicitud, expanda una de estas opciones:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances" | Select-Object -Expand Content

Debería recibir una respuesta JSON similar a la siguiente:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "[email protected]",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "CREATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Consola

1. En el Google Cloud consola, vaya a la página Instancias de Cloud SQL .

   Ir a Instancias de Cloud SQL

2. Para abrir la página Descripción general de una instancia, haga clic en el nombre de la instancia.
3. Seleccione Conexiones en el menú de navegación de Cloud SQL.
4. En la pestaña Redes , seleccione la casilla de verificación IP privada .

   Una lista desplegable muestra las redes disponibles en su proyecto.

5. Seleccione la red VPC que desea utilizar:

Si ve Se requiere conexión a servicio privado :

1. Haga clic en Configurar conexión .
2. En la sección Asignar un rango de IP , elija una de las siguientes opciones:
   • Seleccione uno o más rangos de IP existentes o cree uno nuevo en el menú desplegable. Este menú incluye los rangos previamente asignados, si los hay, o puede seleccionar "Asignar un nuevo rango de IP" e introducir un nuevo rango y un nombre.
   • Utilice un rango de IP asignado automáticamente en su red.
3. Haga clic en Continuar .
4. Haga clic en Crear conexión .
5. Verifique que vea el estado La conexión de servicio privado para la red VPC_NETWORK_NAME se ha creado correctamente .
6. Opcional. Si desea permitir otros Google Cloud servicios, como BigQuery, para acceder a datos en Cloud SQL y realizar consultas sobre estos datos a través de una conexión IP privada, luego seleccione la casilla de verificación Habilitar ruta privada .
7. Haga clic en Guardar .

nube g

Asegúrese de que su proyecto esté configurado para acceso a servicios privados .

Actualice su instancia de Cloud SQL utilizando el parámetro --network para especificar el nombre de la red VPC seleccionada.

gcloud beta sql instances patch INSTANCE_ID \
--project=PROJECT_ID \
--network=projects/NETWORK_PROJECT_ID/global/networks/VPC_NETWORK_NAME \
--no-assign-ip \
--enable-google-private-path

REST versión 1

Cree una nueva instancia con una dirección IP privada:

Antes de utilizar cualquiera de los datos solicitados, realice las siguientes sustituciones:

• PROJECT_ID: El ID del proyecto
• INSTANCE_ID: El ID de la instancia
• VPC_NETWORK_NAME: Especifique el nombre de la red de nube virtual privada (VPC) que desea usar para esta instancia. El acceso a servicios privados debe estar configurado previamente para la red.
• RANGE_NAME: Opcional. Si se especifica, establece un nombre de rango para el cual se asigna un rango IP. El nombre del rango debe cumplir con RFC-1035 y contener entre 1 y 63 caracteres.
• AUTHORIZED_NETWORKS: Para conexiones IP públicas, especifique las conexiones de redes autorizadas que pueden conectarse a su instancia.

Para el parámetro ipv4Enabled , establezca el valor en true si está usando una dirección IP pública para su instancia o false si su instancia tiene una dirección IP privada.

Si establece el parámetro enablePrivatePathForGoogleCloudServices en true , entonces permite otros Google Cloud Servicios como BigQuery para acceder a datos en Cloud SQL y realizar consultas sobre estos datos a través de una conexión IP privada. Al establecer este parámetro en false , otros... Google Cloud Los servicios no pueden acceder a los datos en Cloud SQL a través de una conexión IP privada.

Método HTTP y URL:

PATCH https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/instances/INSTANCE_ID

Cuerpo JSON de la solicitud:

{
  "settings":
  {
    "ipConfiguration": {
      "ipv4Enabled": false,
      "privateNetwork": "projects/PROJECT_ID/global/networks/VPC_NETWORK_NAME",
      "allocatedIpRange": "RANGE_NAME"
      "authorizedNetworks": [AUTHORIZED_NETWORKS],
      
      "enablePrivatePathForGoogleCloudServices": true
      
    }
  }
}

Para enviar su solicitud, expanda una de estas opciones:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/instances/INSTANCE_ID"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

Debería recibir una respuesta JSON similar a la siguiente:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "[email protected]",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta4

Cree una nueva instancia con una dirección IP privada:

Antes de utilizar cualquiera de los datos solicitados, realice las siguientes sustituciones:

• PROJECT_ID: El ID del proyecto
• INSTANCE_ID: El ID de la instancia
• VPC_NETWORK_NAME: Especifique el nombre de la red de nube virtual privada (VPC) que desea usar para esta instancia. El acceso a servicios privados debe estar configurado previamente para la red.
• RANGE_NAME: Opcional. Si se especifica, establece un nombre de rango para el cual se asigna un rango IP. El nombre del rango debe cumplir con RFC-1035 y contener entre 1 y 63 caracteres.
• AUTHORIZED_NETWORKS : para conexiones IP públicas, especifique las conexiones de redes autorizadas que pueden conectarse a su instancia.

Para el parámetro ipv4Enabled , establezca el valor en true si está usando una dirección IP pública para su instancia o false si su instancia tiene una dirección IP privada.

Si establece el parámetro enablePrivatePathForGoogleCloudServices en true , entonces permite otros Google Cloud Servicios como BigQuery para acceder a datos en Cloud SQL y realizar consultas sobre estos datos a través de una conexión IP privada. Al establecer este parámetro en false , otros... Google Cloud Los servicios no pueden acceder a los datos en Cloud SQL a través de una conexión IP privada.

Método HTTP y URL:

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID

Cuerpo JSON de la solicitud:

{
  "settings":
  {
    "ipConfiguration": {
      "ipv4Enabled": false,
      "privateNetwork": "projects/PROJECT_ID/global/networks/VPC_NETWORK_NAME",
      "allocatedIpRange": "RANGE_NAME"
      "authorizedNetworks": [AUTHORIZED_NETWORKS],
      
      "enablePrivatePathForGoogleCloudServices": true
      
    }
  }
}

Para enviar su solicitud, expanda una de estas opciones:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

Debería recibir una respuesta JSON similar a la siguiente:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "[email protected]",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}