Conectarse a una red de VPC
En esta página, se muestra cómo usar el acceso a VPC sin servidores para conectar Cloud Functions directamente a tu red de VPC, permitir el acceso a instancias de VM de Compute Engine, instancias de Memorystore y cualquier otro recurso con una dirección IP interna.
Antes de comenzar
Si aún no tienes una red de VPC en tu proyecto, crea una.
Si usas una VPC compartida, proporciona acceso al conector y consulta Conéctate a una red de VPC compartida.
En la consola de Google Cloud, asegúrate de que la API de Acceso a VPC sin servidores esté habilitada para tu proyecto.
Creación de un conector de acceso a VPC sin servidores
Para enviar solicitudes a tu red de VPC y recibir las respuestas correspondientes sin usar la Internet pública, puedes usar un conector de Acceso a VPC sin servidores.
Si el conector se encuentra en el mismo proyecto que su red de VPC, puedes crear un conector con una subred existente o crear un conector y una subred nueva.
Si el conector se encuentra en un proyecto de servicio y usa una red de VPC compartida, el conector y su red de VPC asociada están en proyectos diferentes. Cuando un conector y su red de VPC están en proyectos diferentes, un administrador de red de VPC compartida debe crear la subred del conector en la red de VPC compartida antes de que puedas crear el conector, y debes crear el conector con una subred existente.
Para obtener más información acerca de los requisitos de subred, consulta Requisitos de subred del conector.
Para obtener información sobre la capacidad de procesamiento del conector, incluidos el tipo de máquina y el escalamiento, consulta Capacidad de procesamiento y escalamiento.
Puedes crear un conector con la consola de Google Cloud, Google Cloud CLI o Terraform:
Console
Dirígete a la página de descripción general de acceso a VPC sin servidores.
Haz clic en Crear conector.
En el campo Nombre, ingresa un nombre para tu conector, que coincida con las convenciones de nombres de Compute Engine, con los requisitos adicionales que debe cumplir el nombre. Debe tener menos de 21 caracteres y esos guiones (-) cuentan como dos caracteres.
En el campo Región, selecciona una región para el conector. Debe coincidir con la región del servicio sin servidores.
Si tu servicio o trabajo se encuentran en la región
us-central
oeurope-west
, usaus-central1
oeurope-west1
.En el campo Red, selecciona la red de VPC a la que conectarás el conector.
En el campo Subred, selecciona una de las siguientes opciones:
Crea un conector con una subred existente: Selecciona la subred existente en el campo Subred.
Crea un conector y una subred nueva: Selecciona Rango de IP personalizado en el campo Subred. Luego, ingresa la primera dirección en un CIDR
/28
sin usar (por ejemplo,10.8.0.0/28
) para usarla como rango de direcciones IPv4 principal de una subred nueva que Google Cloud crea en la red de VPC del conector. Asegúrate de que el rango de IP no entre en conflicto con ninguna ruta existente en la red de VPC del conector. El nombre de la subred nueva comienza con el prefijo “aet-”.
(Opcional) Si deseas configurar las opciones de escalamiento para tener control adicional del conector, haz clic en Mostrar la configuración de escalamiento a fin de mostrar el formulario de escalamiento:
- Configura la cantidad mínima y máxima de instancias para tu conector o usa los valores predeterminados, que son 2 (mínimo) y 10 (máximo). El conector se escala horizontalmente al máximo especificado si el uso del tráfico lo requiere, pero el conector no se reduce cuando el tráfico disminuye. Debes usar valores que se encuentren entre
2
y10
. - En el menú Tipo de instancia, elige el tipo de máquina que se usará para el conector o usa el tipo
e2-micro
predeterminado. Observa la barra lateral de costos a la derecha cuando elijas el tipo de instancia, en la que se muestran las estimaciones de costo y ancho de banda.
- Configura la cantidad mínima y máxima de instancias para tu conector o usa los valores predeterminados, que son 2 (mínimo) y 10 (máximo). El conector se escala horizontalmente al máximo especificado si el uso del tráfico lo requiere, pero el conector no se reduce cuando el tráfico disminuye. Debes usar valores que se encuentren entre
Haz clic en Crear.
Aparecerá una marca de verificación verde junto al nombre del conector cuando esté listo para usar.
gcloud
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
Actualiza los componentes de
gcloud
a la versión más reciente:gcloud components update
Asegúrate de que esté habilitada la API de Acceso a VPC sin servidores en el proyecto:
gcloud services enable vpcaccess.googleapis.com
Crea el conector con una de las siguientes opciones:
Para obtener más detalles y ver los argumentos opcionales, consulta la referencia de
gcloud
.Crea un conector con una subred existente:
gcloud compute networks vpc-access connectors create CONNECTOR_NAME \ --region REGION \ --subnet SUBNET_NAME \ --subnet-project HOST_PROJECT_ID \ --min-instances MIN \ --max-instances MAX \ --machine-type MACHINE_TYPE
Reemplaza lo siguiente:
CONNECTOR_NAME
: un nombre para el conector, que coincide con las convenciones de nombres de Compute Engine, con los requisitos adicionales de que el nombre debe tener menos de 21 caracteres y que los guiones (-) cuentan como dos caracteres.REGION
: una región para el conector que coincide con la región del trabajo o servicio sin servidores. Si tu servicio o trabajo están enus-central
oeurope-west
, usaus-central1
oeurope-west1
.SUBNET_NAME
: el nombre de la subred existente.HOST_PROJECT_ID
: El ID del proyecto host de VPC compartida Si el conector y la subred existente se encuentran en el mismo proyecto, omite la marca--subnet-project
.MIN
: Es la cantidad mínima de instancias que se usarán para el conector. Usa un número entero que se encuentre entre2
(el valor predeterminado) y9
.MAX
: Es la cantidad máxima de instancias que se usarán para el conector. Usa un número entero que se encuentre entre3
y10
(el valor predeterminado). Si el conector escala verticalmente al número máximo de instancias, no se reduce la escala.MACHINE_TYPE
debe ser una de las siguientes opciones:f1-micro
,e2-micro
oe2-standard-4
.
Crea un conector y una subred nueva:
gcloud compute networks vpc-access connectors create CONNECTOR_NAME \ --region REGION \ --network VPC_NETWORK \ --range IP_RANGE --min-instances MIN \ --max-instances MAX \ --machine-type MACHINE_TYPE
Reemplaza lo siguiente:
CONNECTOR_NAME
: un nombre para el conector, que coincide con las convenciones de nombres de Compute Engine, con los requisitos adicionales de que el nombre debe tener menos de 21 caracteres y que los guiones (-) cuentan como dos caracteres.REGION
: una región para el conector que coincide con la región del trabajo o servicio sin servidores. Si tu servicio o trabajo están enus-central
oeurope-west
, usaus-central1
oeurope-west1
.VPC_NETWORK
: el nombre de la red de VPC a la que enchufarás el conector. El conector y la red de VPC deben encontrarse en el mismo proyecto.IP_RANGE
: Proporciona un CIDR/28
sin usar (por ejemplo10.8.0.0/28
) para usar como el rango de direcciones IPv4 principal de una subred nueva que Google Cloud crea en la red de VPC del conector. Asegúrate de que el rango de IP no entre en conflicto con ninguna ruta existente en la red de VPC del conector. El nombre de la subred nueva comienza con el prefijo “aet-”.MIN
: Es la cantidad mínima de instancias que se usarán para el conector. Usa un número entero que se encuentre entre2
(el valor predeterminado) y9
.MAX
: Es la cantidad máxima de instancias que se usarán para el conector. Usa un número entero que se encuentre entre3
y10
(el valor predeterminado). Si el conector escala verticalmente al número máximo de instancias, no se reduce la escala.MACHINE_TYPE
debe ser una de las siguientes opciones:f1-micro
,e2-micro
oe2-standard-4
.
Verifica que tu conector tenga el estado
READY
antes de usarlo:gcloud compute networks vpc-access connectors describe CONNECTOR_NAME \ --region REGION
Reemplaza lo siguiente:
CONNECTOR_NAME
: Es el nombre de tu conector. Este es el nombre que especificaste en el paso anterior.REGION
: Es la región del conector. Esta es la región que especificaste en el paso anterior.
El resultado debe contener la línea
state: READY
.
Terraform
Puedes usar un recurso de Terraform
para habilitar la API de vpcaccess.googleapis.com
.
Puedes usar módulos de Terraform para crear una red y subred de VPC y, luego, crear el conector.
Configura tu función para conectarte a una red de VPC
Debes configurar cada función para usar un conector de Acceso a VPC sin servidores para conectarte a tu red de VPC para enviar tráfico de salida. Puedes configurar una función para usar un conector de la consola de Google Cloud o de Google Cloud CLI:
Console
Haz clic en Crear función si estás configurando una función nueva. Si quieres configurar una función existente, haz clic en la función y, luego, en Editar.
Si configuras una función nueva, completa la página de configuración de funciones iniciales según lo desees, luego haz clic en Entorno de ejecución, compilación... para expandir la página de configuración de funciones.
Haz clic en la pestaña Conexiones y, en Configuración de salida, elige una de las siguientes opciones del menú Red de VPC:
- Para desconectar la función de una red de VPC, selecciona Ninguna.
- Para usar un conector existente, elígelo de la lista desplegable o selecciona Personalizado para usar un conector existente que no se muestra en la lista desplegable.
- Para crear un conector nuevo, selecciona Agregar un nuevo conector de VPC. (Vista previa)
Consulta Crea un conector de Acceso a VPC sin servidores para obtener detalles sobre la creación de un conector.
Haz clic en Siguiente.
gcloud
Usa el comando gcloud functions deploy
para implementar la función y especifica la marca --vpc-connector
:
gcloud functions deploy FUNCTION_NAME \ --vpc-connector CONNECTOR_NAME \ FLAGS...
donde:
FUNCTION_NAME
es el nombre de la función.CONNECTOR_NAME
es el nombre del conector.FLAGS...
se refiere a otras marcas que pasas durante la implementación de la función.
Usa la marca --clear-vpc-connector
para desconectar la función de una red de VPC:
gcloud functions deploy FUNCTION_NAME \ --clear-vpc-connector \ FLAGS...
Para tener más control sobre qué solicitudes se enrutan a través del conector, consulta Configuración de salida.
Acceso a recursos VPC
Permite la entrada de infraestructura sin servidores al conector
Las VMs de conector deben poder recibir paquetes del rango de direcciones IP externas de Google Cloud 35.199.224.0/19
. La infraestructura sin servidores de Google usa este rango para garantizar que los servicios de Cloud Run, Cloud Functions y App Engine puedan enviar paquetes al conector.
El Acceso a VPC sin servidores crea una regla de firewall de permiso de entrada que se aplica a las VMs del conector y permite los paquetes de 35.199.224.0/19
cuando el conector está en el mismo proyecto que la red de VPC a la que se orienta. El conector y su red de VPC de destino están en el mismo proyecto cuando cualquier conector se orienta a una red de VPC independiente o cuando este se dirige a una red de VPC compartida y el conector se encuentra en el proyecto host.
Si creas un conector en un proyecto de servicio de VPC compartida, un Administrador de seguridad o propietario del proyecto host de la VPC compartida debe crear una regla de firewall de permiso de entrada aplicable a las VMs del conector que permiten paquetes de 35.199.224.0/19
. El siguiente es un ejemplo de una regla de firewall de VPC de permiso de entrada:
gcloud compute firewall-rules create RULE_NAME \ --action=ALLOW \ --rules=TCP \ --source-ranges=35.199.224.0/19 \ --target-tags=VPC_CONNECTOR_NETWORK_TAG \ --direction=INGRESS \ --network=VPC_NETWORK \ --priority=PRIORITY \ --project=PROJECT_ID
Reemplaza lo siguiente:
- RULE_NAME: Es el nombre de la regla de firewall nueva. Por ejemplo,
allow-vpc-connector-ingress
- VPC_CONNECTOR_NETWORK_TAG: La etiqueta de red del conector universal
vpc-connector
se puede usar para que la regla se aplique a todos los conectores de la red de VPC. Como alternativa, puedes usar una etiqueta de red específica del conector. La etiqueta de red específica tiene el siguiente formato:vpc-connector-
REGION-
CONNECTOR_NAME, en el que REGION es la región de Google Cloud del conector y CONNECTOR_NAME es su nombre. - VPC_NETWORK: es el nombre de la red de VPC a la que se orienta el conector.
- PRIORITY: un número entero entre 0 y 65535. Por ejemplo, 0 establece la prioridad más alta.
- PROJECT_ID: el ID del proyecto que contiene la red de VPC a la que se orienta el conector.
Restringe el acceso de la VM del conector a los recursos de la red de VPC
Puedes restringir el acceso de tu conector a los recursos en la red de VPC de destino mediante las reglas de firewall de VPC o las reglas en las políticas de firewall. Puedes aplicar estas restricciones mediante una de las siguientes estrategias:
- Crea reglas de entrada cuyos objetivos representen los recursos a los que deseas limitar el acceso de la VM del conector y cuyos orígenes representen las VMs del conector.
- Crea reglas de salida cuyos objetivos representen las VMs del conector y cuyos destinos representen los recursos a los que deseas limitar el acceso de la VM del conector.
En los siguientes ejemplos, se ilustra cada estrategia.
Restringe el acceso con reglas de entrada
Elige las etiquetas de red o los rangos de CIDR que sirven para controlar el tráfico de entrada a tu red de VPC:
Etiquetas de red
En los siguientes pasos, se muestra cómo crear reglas de entrada que restrinjan el acceso de un conector a tu red de VPC en función de las etiquetas de red del conector.
Asegúrate de tener los permisos necesarios para insertar reglas de firewall. Debes contar con una de las siguientes funciones de Identity and Access Management (IAM):
- Función de administrador de seguridad de Compute
- Función de IAM personalizada con el permiso
compute.firewalls.create
habilitado
Deniega el tráfico del conector en toda tu red de VPC.
Crea una regla de firewall de entrada con una prioridad inferior a 1,000 en la red de VPC para denegar la entrada de la etiqueta de red del conector. Esto anula la regla de firewall implícita que crea el acceso a VPC sin servidores en la red de VPC de forma predeterminada.
gcloud compute firewall-rules create RULE_NAME \ --action=DENY \ --rules=PROTOCOL \ --source-tags=VPC_CONNECTOR_NETWORK_TAG \ --direction=INGRESS \ --network=VPC_NETWORK \ --priority=PRIORITY
Reemplaza lo siguiente:
RULE_NAME: Es el nombre de la regla de firewall nueva. Por ejemplo,
deny-vpc-connector
PROTOCOL: Uno o más protocolos que deseas permitir desde tu conector de VPC. Los protocolos compatibles son
tcp
oudp
. Por ejemplo,tcp:80,udp
permite el tráfico de TCP a través del puerto 80 y el tráfico de UDP. Para obtener más información, consulta la documentación de la marcaallow
.Por razones de seguridad y validación, también puedes configurar reglas de denegación para bloquear el tráfico de los siguientes protocolos no compatibles:
ah
,all
,esp
,icmp
,ipip
ysctp
.VPC_CONNECTOR_NETWORK_TAG: Es la etiqueta de red del conector universal si quieres restringir el acceso a todos los conectores (incluidos los que se creen en el futuro) o la etiqueta de red única si deseas restringir el acceso a un conector específico.
- Etiqueta de red universal:
vpc-connector
Etiqueta de red única:
vpc-connector-REGION-CONNECTOR_NAME
Reemplaza lo siguiente:
- REGION: Es la región del conector que quieres restringir.
- CONNECTOR_NAME: Es el nombre del conector que quieres restringir.
Para obtener más información sobre las etiquetas de red del conector, consulta Etiquetas de red.
- Etiqueta de red universal:
VPC_NETWORK es el nombre de tu red de VPC.
PRIORITY: un número entero entre 0 y 65535. Por ejemplo, 0 establece la prioridad más alta.
Permite el tráfico del conector al recurso que debe recibir tráfico del conector.
Usa las marcas
allow
ytarget-tags
para crear una regla de firewall de entrada orientada al recurso en tu red de VPC a la que deseas que acceda el conector de VPC. Establece la prioridad para que esta regla sea un valor inferior a la prioridad de la regla que estableciste en el paso anterior.gcloud compute firewall-rules create RULE_NAME \ --allow=PROTOCOL \ --source-tags=VPC_CONNECTOR_NETWORK_TAG \ --direction=INGRESS \ --network=VPC_NETWORK \ --target-tags=RESOURCE_TAG \ --priority=PRIORITY
Reemplaza lo siguiente:
RULE_NAME: Es el nombre de la regla de firewall nueva. Por ejemplo,
allow-vpc-connector-for-select-resources
PROTOCOL: Uno o más protocolos que deseas permitir desde tu conector de VPC. Los protocolos compatibles son
tcp
oudp
. Por ejemplo,tcp:80,udp
permite el tráfico de TCP a través del puerto 80 y el tráfico de UDP. Para obtener más información, consulta la documentación de la marcaallow
.VPC_CONNECTOR_NETWORK_TAG: Es la etiqueta de red del conector universal si quieres restringir el acceso a todos los conectores (incluidos los que se creen en el futuro) o la etiqueta de red única si deseas restringir el acceso a un conector específico. Debe coincidir con la etiqueta de red que especificaste en el paso anterior.
- Etiqueta de red universal:
vpc-connector
Etiqueta de red única:
vpc-connector-REGION-CONNECTOR_NAME
Reemplaza lo siguiente:
- REGION: Es la región del conector que quieres restringir.
- CONNECTOR_NAME: Es el nombre del conector que quieres restringir.
Para obtener más información sobre las etiquetas de red del conector, consulta Etiquetas de red.
- Etiqueta de red universal:
VPC_NETWORK es el nombre de tu red de VPC.
RESOURCE_TAG: la etiqueta de red para el recurso de VPC al que deseas que acceda tu conector de VPC.
PRIORITY: un número entero inferior a la prioridad que estableciste en el paso anterior. Por ejemplo, si estableces la prioridad para la regla que creaste en el paso anterior en 990, prueba con 980.
A fin de obtener más información sobre las marcas obligatorias y opcionales para la creación de reglas de firewall, consulta la documentación de gcloud compute firewall-rules create
.
Rango de CIDR
En los siguientes pasos, se muestra cómo crear reglas de entrada que restrinjan el acceso de un conector a tu red de VPC en función del rango de CIDR del conector.
Asegúrate de tener los permisos necesarios para insertar reglas de firewall. Debes contar con una de las siguientes funciones de Identity and Access Management (IAM):
- Función de administrador de seguridad de Compute
- Función de IAM personalizada con el permiso
compute.firewalls.create
habilitado
Deniega el tráfico del conector en toda tu red de VPC.
Crea una regla de firewall de entrada con una prioridad inferior a 1,000 en tu red de VPC para denegar la entrada desde el rango de CIDR del conector. Esto anula la regla de firewall implícita que crea el acceso a VPC sin servidores en la red de VPC de forma predeterminada.
gcloud compute firewall-rules create RULE_NAME \ --action=DENY \ --rules=PROTOCOL \ --source-ranges=VPC_CONNECTOR_CIDR_RANGE \ --direction=INGRESS \ --network=VPC_NETWORK \ --priority=PRIORITY
Reemplaza lo siguiente:
RULE_NAME: Es el nombre de la regla de firewall nueva. Por ejemplo,
deny-vpc-connector
PROTOCOL: Uno o más protocolos que deseas permitir desde tu conector de VPC. Los protocolos compatibles son
tcp
oudp
. Por ejemplo,tcp:80,udp
permite el tráfico de TCP a través del puerto 80 y el tráfico de UDP. Para obtener más información, consulta la documentación de la marcaallow
.Por razones de seguridad y validación, también puedes configurar reglas de denegación para bloquear el tráfico de los siguientes protocolos no compatibles:
ah
,all
,esp
,icmp
,ipip
ysctp
.VPC_CONNECTOR_CIDR_RANGE: El rango de CIDR del conector cuyo acceso estás restringiendo
VPC_NETWORK es el nombre de tu red de VPC.
PRIORITY: un número entero entre 0 y 65535. Por ejemplo, 0 establece la prioridad más alta.
Permite el tráfico del conector al recurso que debe recibir tráfico del conector.
Usa las marcas
allow
ytarget-tags
para crear una regla de firewall de entrada orientada al recurso en tu red de VPC a la que deseas que acceda el conector de VPC. Establece la prioridad para que esta regla sea un valor inferior a la prioridad de la regla que estableciste en el paso anterior.gcloud compute firewall-rules create RULE_NAME \ --allow=PROTOCOL \ --source-ranges=VPC_CONNECTOR_CIDR_RANGE \ --direction=INGRESS \ --network=VPC_NETWORK \ --target-tags=RESOURCE_TAG \ --priority=PRIORITY
Reemplaza lo siguiente:
RULE_NAME: Es el nombre de la regla de firewall nueva. Por ejemplo,
allow-vpc-connector-for-select-resources
PROTOCOL: Uno o más protocolos que deseas permitir desde tu conector de VPC. Los protocolos compatibles son
tcp
oudp
. Por ejemplo,tcp:80,udp
permite el tráfico de TCP a través del puerto 80 y el tráfico de UDP. Para obtener más información, consulta la documentación de la marcaallow
.VPC_CONNECTOR_CIDR_RANGE: El rango de CIDR del conector cuyo acceso estás restringiendo
VPC_NETWORK es el nombre de tu red de VPC.
RESOURCE_TAG: la etiqueta de red para el recurso de VPC al que deseas que acceda tu conector de VPC.
PRIORITY: un número entero inferior a la prioridad que estableciste en el paso anterior. Por ejemplo, si estableces la prioridad para la regla que creaste en el paso anterior en 990, prueba con 980.
A fin de obtener más información sobre las marcas obligatorias y opcionales para la creación de reglas de firewall, consulta la documentación de gcloud compute firewall-rules create
.
Restringe el acceso con reglas de salida
En los siguientes pasos, se muestra cómo crear reglas de salida para restringir el acceso al conector.
Asegúrate de tener los permisos necesarios para insertar reglas de firewall. Debes contar con una de las siguientes funciones de Identity and Access Management (IAM):
- Función de administrador de seguridad de Compute
- Función de IAM personalizada con el permiso
compute.firewalls.create
habilitado
Rechaza el tráfico de salida proveniente de tu conector.
Crea una regla de firewall de salida en tu conector de acceso a VPC sin servidores para evitar que envíe tráfico de salida, con la excepción de las respuestas establecidas, a cualquier destino.
gcloud compute firewall-rules create RULE_NAME \ --action=DENY \ --rules=PROTOCOL \ --direction=EGRESS \ --target-tags=VPC_CONNECTOR_NETWORK_TAG \ --network=VPC_NETWORK \ --priority=PRIORITY
Reemplaza lo siguiente:
RULE_NAME: Es el nombre de la regla de firewall nueva. Por ejemplo,
deny-vpc-connector
PROTOCOL: Uno o más protocolos que deseas permitir desde tu conector de VPC. Los protocolos compatibles son
tcp
oudp
. Por ejemplo,tcp:80,udp
permite el tráfico de TCP a través del puerto 80 y el tráfico de UDP. Para obtener más información, consulta la documentación de la marcaallow
.Por razones de seguridad y validación, también puedes configurar reglas de denegación para bloquear el tráfico de los siguientes protocolos no compatibles:
ah
,all
,esp
,icmp
,ipip
ysctp
.VPC_CONNECTOR_NETWORK_TAG: Es la etiqueta de red del conector de VPC universal si deseas que la regla se aplique para todos los conectores de VPC existentes y futuros. O bien, es la etiqueta de red del conector de VPC única si deseas controlar un conector específico.
VPC_NETWORK es el nombre de tu red de VPC.
PRIORITY: un número entero entre 0 y 65535. Por ejemplo, 0 establece la prioridad más alta.
Permite el tráfico de salida cuando el destino se encuentra en el rango CIDR al que deseas que acceda tu conector.
Usa las marcas
allow
ydestination-ranges
a fin de crear una regla de firewall que permita el tráfico de salida desde el conector para un rango específico de destinos. Establece el rango de destinos en el rango de CIDR del recurso en tu red de VPC a la que deseas que tu conector pueda acceder. Establece la prioridad para que esta regla sea un valor inferior a la prioridad de la regla que estableciste en el paso anterior.gcloud compute firewall-rules create RULE_NAME \ --allow=PROTOCOL \ --destination-ranges=RESOURCE_CIDR_RANGE \ --direction=EGRESS \ --network=VPC_NETWORK \ --target-tags=VPC_CONNECTOR_NETWORK_TAG \ --priority=PRIORITY
Reemplaza lo siguiente:
RULE_NAME: Es el nombre de la regla de firewall nueva. Por ejemplo,
allow-vpc-connector-for-select-resources
PROTOCOL: Uno o más protocolos que deseas permitir desde tu conector de VPC. Los protocolos compatibles son
tcp
oudp
. Por ejemplo,tcp:80,udp
permite el tráfico de TCP a través del puerto 80 y el tráfico de UDP. Para obtener más información, consulta la documentación de la marcaallow
.RESOURCE_CIDR_RANGE: El rango de CIDR del conector cuyo acceso estás restringiendo
VPC_NETWORK es el nombre de tu red de VPC.
VPC_CONNECTOR_NETWORK_TAG: Es la etiqueta de red del conector de VPC universal si deseas que la regla se aplique para todos los conectores de VPC existentes y futuros. O bien, es la etiqueta de red del conector de VPC única si deseas controlar un conector específico. Si usaste la etiqueta de red única en el paso anterior, usa la etiqueta de red única.
PRIORITY: un número entero inferior a la prioridad que estableciste en el paso anterior. Por ejemplo, si estableces la prioridad para la regla que creaste en el paso anterior en 990, prueba con 980.
A fin de obtener más información sobre las marcas obligatorias y opcionales para la creación de reglas de firewall, consulta la documentación de gcloud compute firewall-rules create
.
Administra tu conector
Desconecta una función de una red de VPC
Puedes desconectar una función de tu red de VPC con la consola de Google Cloud o Google Cloud CLI:
Console
Ve a la página de Descripción general de Cloud Functions en la consola de Google Cloud:
Haz clic en una función existente para ir a la página de detalles y haz clic en Editar.
Haz clic en Entorno de ejecución, compilación... para expandir la configuración avanzada.
En la pestaña Conexiones, en la configuración de salida, ingresa el nombre de tu conector en el campo Conector de VPC, o borra el campo para desconectar tu función de la red de VPC.
gcloud
Usa la marca --clear-vpc-connector
para desconectar la función de tu red de VPC:
gcloud functions deploy FUNCTION_NAME \ --clear-vpc-connector \ FLAGS...
Donde:
FUNCTION_NAME
es el nombre de la función.CONNECTOR_NAME
es el nombre del conector.FLAGS...
se refiere a otras marcas que pasas durante la implementación de la función.
Los conectores continúan generando cargos, incluso si no tienen tráfico y están desconectados. Para obtener detalles, consulta Precios. Si ya no necesitas el conector, asegúrate de borrarlo para evitar que se te siga facturando.
Actualiza un conector
Puedes actualizar y supervisar los siguientes atributos de tu conector a través de la consola de Google Cloud, Google Cloud CLI o la API:
- Tipo de máquina (instancia)
- Cantidad mínima y máxima de instancias
- Capacidad de procesamiento, cantidad de instancias y uso de CPU recientes
Actualizar tipo de máquina
Console
Dirígete a la página de descripción general de acceso a VPC sin servidores.
Selecciona el conector que quieres editar y haz clic en Editar.
En la lista Tipo de instancia, selecciona el tipo de máquina (instancia) que prefieras. Para obtener información sobre los tipos de máquinas disponibles, consulta la documentación sobre Capacidad de procesamiento y escalamiento.
gcloud
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
Para actualizar el tipo de máquina del conector, ejecuta el siguiente comando en la terminal:
gcloud beta compute networks vpc-access connectors update CONNECTOR_NAME --region=REGION --machine-type=MACHINE_TYPE
Reemplaza lo siguiente:CONNECTOR_NAME
: el nombre del conectorREGION
: el nombre de la región del conectorMACHINE_TYPE
: el tipo de máquina que prefieras. Para obtener información sobre los tipos de máquinas disponibles, consulta la documentación sobre Capacidad de procesamiento y escalamiento.
Disminuye la cantidad mínima y máxima de instancias
Para disminuir la cantidad mínima y máxima de instancias, debes hacer lo siguiente:
- Crea un conector nuevo con tus valores preferidos.
- Actualiza tu servicio o función para usar el conector nuevo.
- Borra el conector anterior cuando hayas movido su tráfico.
Para obtener más información, consulta Crea un conector de acceso a VPC sin servidores.
Aumenta la cantidad mínima y máxima de instancias
Console
Dirígete a la página de descripción general de acceso a VPC sin servidores.
Selecciona el conector que quieres editar y haz clic en Editar.
En el campo Cantidad mínima de instancias, selecciona la cantidad mínima de instancias que prefieras.
El valor más pequeño posible para este campo es el valor actual. El valor más alto posible para este campo es el valor actual en el campo Cantidad máxima de instancias menos 1. Por ejemplo, si el valor en el campo Cantidad máxima de instancias es 8, el valor más alto posible para el campo Cantidad mínima de instancias es 7.
En el campo Cantidad máxima de instancias, selecciona la cantidad máxima de instancias que prefieras.
El valor más pequeño posible para este campo es el valor actual. El valor más alto posible para este campo es 10.
gcloud
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
Para aumentar la cantidad mínima o máxima de instancias del conector, ejecuta el siguiente comando en la terminal:
gcloud beta compute networks vpc-access connectors update CONNECTOR_NAME --region=REGION --min-instances=MIN_INSTANCES --max-instances=MAX_INSTANCES
Reemplaza lo siguiente:
CONNECTOR_NAME
: el nombre del conectorREGION
: el nombre de la región del conectorMIN_INSTANCES
: la cantidad mínima de instancias que prefieras.- El valor más pequeño posible para este campo es el valor actual de
min_instances
. Para buscar el valor actual, consulta Busca los valores de los atributos actuales. - El valor más alto posible para este campo es el valor
max_instances
actual menos 1, porquemin_instances
debe ser menor quemax_instances
. Por ejemplo, simax_instances
es 8, el valor más alto posible para este campo es 7. Si el conector usa el valor predeterminadomax-instances
de 10, el valor más alto posible de este campo es 9. Para buscar el valor demax-instances
, consulta Busca los valores de los atributos actuales.
- El valor más pequeño posible para este campo es el valor actual de
MAX_INSTANCES
:- El valor más pequeño posible para este campo es el valor actual de
max_instances
. Para buscar el valor actual, consulta Busca los valores de los atributos actuales. - El valor más alto posible para este campo es 10.
Si solo deseas aumentar la cantidad mínima de instancias, pero no la máxima, debes especificar la cantidad máxima de instancias. Por el contrario, si solo deseas actualizar la cantidad máxima de instancias, pero no la mínima, debes especificar la cantidad mínima de instancias. Para mantener la cantidad mínima o máxima de instancias en el valor actual, especifica su valor actual. Para buscar el valor actual, consulta Busca los valores de los atributos actuales.
- El valor más pequeño posible para este campo es el valor actual de
Busca los valores de los atributos actuales
Para buscar los valores de los atributos actuales para tu conector, ejecuta lo siguiente en la terminal:
gcloud compute networks vpc-access connectors describe CONNECTOR_NAME --region=REGION --project=PROJECTReemplaza lo siguiente:
CONNECTOR_NAME
: el nombre del conectorREGION
: el nombre de la región del conectorPROJECT
: el nombre de tu proyecto de Google Cloud
Supervisa el uso del conector
La supervisión del uso en el tiempo puede ayudarte a determinar cuándo ajustar la configuración de un conector. Por ejemplo, si el uso de CPU aumenta, puedes intentar aumentar la cantidad máxima de instancias para obtener mejores resultados. O si alcanzas el máximo de la capacidad de procesamiento, puedes decidir cambiar a un tipo de máquina más grande.
Para mostrar gráficos de la capacidad de procesamiento del conector, la cantidad de instancias y las métricas de uso de CPU con el tiempo a través de la consola de Google Cloud, haz lo siguiente:
Dirígete a la página de descripción general de Acceso a VPC sin servidores.
Haz clic en el nombre del conector que quieres supervisar.
Selecciona la cantidad de días que deseas mostrar entre 1 y 90 días.
En el gráfico Capacidad de procesamiento, coloca el cursor sobre el gráfico para ver la capacidad de procesamiento reciente del conector.
En el gráfico Cantidad de instancias, coloca el cursor sobre el gráfico para ver la cantidad de instancias que el conector usó recientemente.
En el gráfico Uso de CPU, coloca el cursor sobre el gráfico para ver el uso de CPU reciente del conector. En el gráfico, se muestra el uso de CPU distribuido entre las instancias para los percentiles 50, 95 y 99.
Borra un conector
Antes de borrar un conector, asegúrate de que ningún servicio o trabajo siga conectado a él.
Para los usuarios de VPC compartida que configuraron conectores en el proyecto host de la VPC compartida (ya no se recomienda), puedes usar el comando gcloud compute networks vpc-access connectors describe
para enumerar los proyectos, que son servicios o trabajos que usan un conector determinado.
Para borrar un conector, usa la consola de Google Cloud o la CLI de Google Cloud:
Console
Ve a la página de descripción general de Acceso a VPC sin servidores en la consola de Google Cloud:
Selecciona el conector que quieres borrar.
Haz clic en Borrar.
gcloud
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
Usa el siguiente comando de
gcloud
para borrar un conector:gcloud compute networks vpc-access connectors delete CONNECTOR_NAME --region=REGION
Reemplaza lo siguiente:
- CONNECTOR_NAME es el nombre del conector que quieres borrar.
- REGION es la región donde se encuentra el conector.
Soluciona problemas
Permisos de las cuentas de servicio
Para realizar operaciones en el proyecto de Google Cloud, el servicio de Acceso a VPC sin servidores usa la cuenta de servicio del agente de servicio de Acceso a VPC sin servidores. La dirección de correo electrónico de esta cuenta de servicio tiene el siguiente formato:
service-PROJECT_NUMBER@gcp-sa-vpcaccess.iam.gserviceaccount.com
De forma predeterminada, esta cuenta de servicio tiene la función de agente de servicio de Acceso a VPC sin servidores (roles/vpcaccess.serviceAgent
). Las operaciones del Acceso a VPC sin servidores pueden fallar si cambias los permisos de esta cuenta.
Errores
Error de que la cuenta de servicio necesita el rol de agente de servicio
Si usas la restricción de la política de la organización Restringir el uso de servicios del recurso para bloquear Cloud Deployment Manager (deploymentmanager.googleapis.com
), es posible que veas el siguiente mensaje de error:
Serverless VPC Access service account (service-<PROJECT_NUMBER>@gcp-sa-vpcaccess.iam.gserviceaccount.com) needs Serverless VPC Access Service Agent role in the project.
Configura la política de la organización para quitar Deployment Manager de la lista de bloqueo o agregarla a la lista de entidades permitidas.
Error de creación del conector
Si la creación de un conector produce un error, prueba lo siguiente:
- Especifica un rango de IP internas de RFC 1918 que no se superponga con ninguna reserva de dirección IP existente en la red de VPC.
- Otorga al proyecto permiso para usar las imágenes de VM de Compute Engine del proyecto con el ID
serverless-vpc-access-images
. Para obtener más información sobre cómo actualizar las políticas de la organización según corresponda, consulta Configura restricciones de acceso a imágenes.
No se puede acceder a los recursos
Si especificaste un conector, pero aún no puedes acceder a los recursos de la red de VPC, asegúrate de que no haya reglas de firewall en la red de VPC que tengan una prioridad inferior a 1,000 que rechacen la entrada desde el rango de direcciones IP del conector.
Si configuras un conector en un proyecto de servicio de VPC compartida, asegúrate de que las reglas de firewall permitan la entrada de la infraestructura sin servidores al conector.
Error de conexión rechazada
Si recibes errores connection refused
o connection timeout
que degradan el rendimiento de la red, es posible que las conexiones crezcan sin límite en las invocaciones de la aplicación sin servidores. Para limitar la cantidad máxima de conexiones de cada instancia, usa una biblioteca cliente que admita grupos de conexiones. Para obtener ejemplos detallados sobre cómo usar los grupos de conexiones, consulta Administra conexiones de bases de datos.
Error de recurso no encontrado
Cuando borres una red de VPC o una regla de firewall, es posible que veas un mensaje similar al siguiente: The resource
"aet-uscentral1-subnet--1-egrfw" was not found.
Para obtener información sobre este error y su solución, consulta Error de recurso no encontrado en la documentación de reglas de firewall de VPC.
Falta el permiso vpcaccess.connectors.use necesario para la cuenta de servicio…
Primero, asegúrate de que el rol roles/vpcaccess.user
esté asignado a la cuenta de servicio.
Si tienes problemas de permisos con el conector de VPC, verifica si es una VPC compartida. En ese caso, se requiere una configuración adicional en el proyecto host.
Próximos pasos
- Conéctate a Memorystore desde Cloud Functions.
- Establece la configuración de red para Cloud Functions.
- Supervisa la actividad del administrador con los registros de auditoría de Acceso a VPC sin servidores.
- Protege los recursos y los datos mediante la creación de un perímetro de servicio con los Controles del servicio de VPC.
- Obtén más información sobre las funciones de la Identity and Access Management (IAM) asociadas con el Acceso a VPC sin servidores. Consulta Funciones de Acceso a VPC sin servidores en la documentación de IAM para obtener una lista de permisos asociados con cada función.