Облачная функция обычно запускается не внутри вашей 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 Lambda | VPC configuration с subnets и security groups | public subnet сама по себе не выдаёт функции public IP |
| Google Cloud Run functions 2nd gen | Direct VPC egress или Serverless VPC Access | режим private-ranges-only и all выбирает egress |
| Yandex Cloud Functions | cloud 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 timeout | route/firewall/NACL | flow logs и source range |
| быстрый connection refused | listener/port | bind address и service health |
| TLS hostname mismatch | DNS/certificate | SNI и 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 провайдера.
Проверка заканчивается с двух сторон соединения
- Из новой ревизии функции получить DNS-ответ и выполнить TCP probe на точный port.
- Подтвердить выбранные network, region, subnet/connector и egress mode в фактическом deployment.
- Проверить route table или peering для destination CIDR без пересекающихся диапазонов.
- Найти пакет в flow logs либо объяснить, на каком участке он исчезает.
- Проверить ingress/firewall назначения от реального serverless source, а не IP разработчика.
- Выполнить TLS handshake и один безопасный health request с production-like identity.
- Создать параллельную нагрузку в пределах лимита и убедиться, что connection pool не истощает порт/БД.
- Удалить probe и временные правила, сохранив dashboard по DNS, connect latency и error class.
Хороший итог расследования звучит конкретно: «функция разрешала имя в 10.42.8.15, но правило назначения не принимало диапазон connector 10.8.4.0/28; после узкого ingress TCP/8443 probe и TLS проходят». Формулировка «добавили VPC и заработало» не защищает от повторения ошибки в другой зоне или следующей ревизии.