Что делать, если не можешь обратиться к API внутри Docker?

Диагностика и решение проблемы доступа к API из Docker контейнера

Это частая проблема при работе с Docker. Я покажу систематический подход к диагностике и решению.

Шаг 1: Диагностика сетевого соединения

Сначала нужно понять, где именно проблема:

docker exec <container_name> curl -v https://api.example.com
docker exec <container_name> nslookup api.example.com
docker exec <container_name> ping -c 5 api.example.com

Основные причины и решения

1. Проблема с DNS внутри Docker

Доcker может использовать неправильный DNS сервер. Решение:

services:
  app:
    dns:
      - 8.8.8.8
      - 8.8.4.4

Или при запуске контейнера:

docker run --dns 8.8.8.8 my-app

2. Неверный URL/Hostname

Если обращаетесь к API на локальной машине:

# Неправильно
api_url = "http://localhost:8000/api"

# Правильно (для Docker на Linux)
api_url = "http://host.docker.internal:8000/api"

# В docker-compose для сервиса
api_url = "http://api-service:8000/api"

3. Проблемы с Docker Network

Когда используете несколько контейнеров:

version: '3'
services:
  app:
    build: .
    networks:
      - my-network
  api:
    image: api:latest
    networks:
      - my-network

networks:
  my-network:
    driver: bridge

Тогда внутри app контейнера обращаетесь к api по hostname:

import requests
response = requests.get('http://api:8000/api/data')

4. Firewall и Port issues

Убедитесь, что port открыт в host машине:

docker ps
docker run -p 8000:8000 my-app

5. Проблемы с SSL/TLS сертификатами

import requests

# Игнорируем сертификаты (только для разработки)
response = requests.get(url, verify=False)

# Или подключаем CA сертификаты
response = requests.get(url, verify='/path/to/ca-bundle.crt')

Комплексная диагностика

import socket
import requests
from urllib.parse import urlparse

def diagnose_api_connection(api_url):
    parsed = urlparse(api_url)
    hostname = parsed.hostname
    port = parsed.port or (443 if parsed.scheme == 'https' else 80)
    
    print(f"Диагностика подключения к {api_url}")
    
    # DNS разрешение
    try:
        ip = socket.gethostbyname(hostname)
        print(f"DNS: {hostname} -> {ip}")
    except socket.gaierror as e:
        print(f"DNS ошибка: {e}")
        return
    
    # Соединение на TCP уровне
    sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
    result = sock.connect_ex((hostname, port))
    if result == 0:
        print(f"TCP соединение успешно: {hostname}:{port}")
    else:
        print(f"Ошибка подключения: {hostname}:{port}")
    sock.close()
    
    # HTTP запрос
    try:
        response = requests.get(api_url, timeout=5)
        print(f"HTTP ответ: {response.status_code}")
    except requests.exceptions.Timeout:
        print(f"Timeout при подключении")
    except requests.exceptions.ConnectionError as e:
        print(f"Connection ошибка: {e}")

Best Practices

• Используйте health checks в docker-compose
• Логируйте URL и параметры запроса
• Используйте переменные окружения для URL
• Добавьте retry логику с backoff
• Тестируйте локально перед Docker

Production-ready подход

import os
import requests
from requests.adapters import HTTPAdapter
from requests.packages.urllib3.util.retry import Retry

API_URL = os.getenv('API_URL', 'http://api:8000')

def create_session_with_retries():
    session = requests.Session()
    retry_strategy = Retry(
        total=3,
        backoff_factor=1,
        status_forcelist=[429, 500, 502, 503, 504]
    )
    adapter = HTTPAdapter(max_retries=retry_strategy)
    session.mount('http://', adapter)
    session.mount('https://', adapter)
    return session

session = create_session_with_retries()
response = session.get(f'{API_URL}/api/data')

Заключение

При диагностике идите от простого к сложному: сначала DNS, потом TCP, потом HTTP. Используйте логирование и retry механизмы для production окружения.