Облачная функция обычно запускается не внутри вашей private network. Доступ к внутреннему IP появляется только после явной привязки к VPC, subnet или serverless connector — название зависит от провайдера. Поэтому проверка «VM в этой сети подключается» доказывает здоровье сервиса, но не маршрут функции.

Начните с одного адреса `host:port` и разделите ошибку на DNS, TCP и протокол. `ENOTFOUND` ведёт к резолверу, timeout — к маршруту или firewall, `ECONNREFUSED` означает, что пакет дошёл до узла, но порт не слушает или его отвергла локальная политика. HTTP 401/403 уже подтверждает сеть и переводит расследование к авторизации.

Минимальный probe показывает слой сбоя

import dns from 'node:dns/promises';
import net from 'node:net';

export async function probe(host, port) {
  const started = Date.now();
  const addresses = await dns.lookup(host, { all: true });

  await new Promise((resolve, reject) => {
    const socket = net.connect({ host, port, timeout: 3000 }, resolve);
    socket.once('timeout', () => socket.destroy(new Error('tcp_timeout')));
    socket.once('error', reject);
    socket.once('connect', () => socket.end());
  });

  return { addresses, tcpMs: Date.now() - started };
}

Логируйте только hostname, приватный IP/семейство, порт, длительность и тип ошибки. Не выводите DSN, пароль, TLS private key или query. Probe должен иметь короткий timeout и включаться временно через безопасную конфигурацию; открывать debug endpoint в интернет не нужно.

Название функции не определяет сетевой путь

ПровайдерПуть к private networkКлючевая особенность
AWS LambdaVPC configuration с subnets и security groupspublic subnet сама по себе не выдаёт функции public IP
Google Cloud Run functions 2nd genDirect VPC egress или Serverless VPC Accessрежим private-ranges-only и all выбирает egress
Yandex Cloud Functionscloud network в настройках функцииисходящие соединения поддерживаются, входящие к функции — нет
любой провайдеррегионально поддерживаемое соединениесеть, функция и connector должны удовлетворять ограничениям региона/проекта

Не переносите инструкцию буквально между облаками. В Google для новых Cloud Run services/jobs рекомендуется Direct VPC egress, если он доступен; старые или другие продукты могут использовать connector. Yandex создаёт служебные подсети при выборе пользовательской сети. AWS создаёт сетевые интерфейсы на основе указанных subnet и security groups.

DNS проверяют из функции, а не с ноутбука

Приватное имя может разрешаться только внутри VPC, private hosted zone или корпоративного DNS. Функция должна использовать совместимый резолвер и маршрут к нему. Если `dns.lookup` возвращает публичный адрес вместо private IP, проблема возникла до TCP: split-horizon zone не связана с нужной сетью либо имя переопределено некорректно.

  • Сравнить A/AAAA-ответ внутри функции и на VM в целевой VPC.
  • Проверить связь private DNS zone с той сетью/проектом, куда направлен egress функции.
  • Исключить конфликт публичной и приватной зоны с одинаковым именем.
  • Если используется custom DNS, проверить маршрут и правила UDP/TCP 53 до резолвера.
  • Для TLS обращаться по hostname из сертификата, а не заменять имя приватным IP.

Маршрут и egress — разные настройки

В Google режим `private-ranges-only` отправляет во VPC только частные диапазоны, а `all` — весь исходящий трафик; выбранный hostname должен разрешаться в ожидаемый диапазон. В AWS после привязки Lambda к VPC доступ ограничивается ресурсами этой VPC и её маршрутами. Если одновременно нужен публичный API, private subnet получает путь через NAT; подключение Lambda к public subnet само по себе интернет не даёт.

# Псевдоконфигурация: смысл важнее синтаксиса провайдера
function_network:
  network: app-prod
  subnet: serverless-eu-1
  egress: private-ranges-only

destination:
  host: orders.internal.example
  resolved_ip: 10.42.8.15
  port: 8443

expected_path:
  - serverless attachment
  - subnet or connector range
  - VPC route
  - destination firewall
  - service listener

Нарисуйте фактический путь одной стрелкой и подпишите source range на каждом участке. Если private service находится в другой VPC или проекте, может потребоваться peering, Shared VPC, Private Service Connect или эквивалент. Наличие одинаковых CIDR в двух сетях не создаёт связность и, наоборот, делает маршрутизацию неоднозначной.

Firewall разрешает источник функции, а не вашу VM

Успешный тест с bastion или VM использует другой source IP и другую security group. Правило назначения должно разрешать порт из диапазона connector/subnet либо по поддерживаемому network tag/security group. Google отдельно документирует firewall rules для Serverless VPC Access, особенно Shared VPC service projects. В AWS проверяются egress security group функции, ingress группы назначения и network ACL.

НаблюдениеВероятный слойПроверка
DNS есть, TCP timeoutroute/firewall/NACLflow logs и source range
быстрый connection refusedlistener/portbind address и service health
TLS hostname mismatchDNS/certificateSNI и SAN сертификата
только часть запусков падаетнесколько subnet/AZ или port exhaustionрезультат по зоне и connection reuse
private работает, public пересталegress/NATрежим all/private и default route

Не решайте timeout правилом allow all. Временно сопоставьте flow logs с invocation id, затем сузьте правило до нужного протокола, порта и источника. После проверки удалите диагностические широкие правила, если они создавались, и зафиксируйте итоговую политику в IaC.

Холодный старт и пул соединений дают ложную сетевую картину

Привязка к сети может увеличить холодный старт, а база имеет ограничение соединений. Если каждый invocation открывает новый TCP/TLS connection, всплеск функций истощает порты connector или лимит базы. Google рекомендует connection pooling и повторное использование соединений; при этом слишком долгоживущий socket может быть закрыт инфраструктурой, поэтому клиенту нужны health check и ограниченный retry.

  • Пул создаётся вне handler и повторно используется тёплым instance, но не считается вечным.
  • Максимум соединений согласуется с максимальным числом instances и лимитом базы.
  • Retry применяется только к безопасной идемпотентной операции и получает jitter.
  • Connect timeout отделён от query/request timeout; обе метрики видны отдельно.
  • Для массовых обращений к БД рассматривается управляемый proxy/pooler провайдера.

Проверка заканчивается с двух сторон соединения

  1. Из новой ревизии функции получить DNS-ответ и выполнить TCP probe на точный port.
  2. Подтвердить выбранные network, region, subnet/connector и egress mode в фактическом deployment.
  3. Проверить route table или peering для destination CIDR без пересекающихся диапазонов.
  4. Найти пакет в flow logs либо объяснить, на каком участке он исчезает.
  5. Проверить ingress/firewall назначения от реального serverless source, а не IP разработчика.
  6. Выполнить TLS handshake и один безопасный health request с production-like identity.
  7. Создать параллельную нагрузку в пределах лимита и убедиться, что connection pool не истощает порт/БД.
  8. Удалить probe и временные правила, сохранив dashboard по DNS, connect latency и error class.

Хороший итог расследования звучит конкретно: «функция разрешала имя в 10.42.8.15, но правило назначения не принимало диапазон connector 10.8.4.0/28; после узкого ingress TCP/8443 probe и TLS проходят». Формулировка «добавили VPC и заработало» не защищает от повторения ошибки в другой зоне или следующей ревизии.

Проверенные источники