Введение: Анатомия классического сетевого тупика в ECS

Миграция приложений в контейнеры под управлением Amazon Elastic Container Service (ECS) часто сопровождается неожиданными архитектурными головоломками. Одна из самых распространенных проблем, с которыми сталкиваются DevOps-инженеры и разработчики — это ситуация, когда трафик из внешнего мира или от балансировщика нагрузки упирается в глухую стену из-за банального несоответствия сетевых портов. Классический симптом этой проблемы выглядит следующим образом: в конфигурации вашей задачи (ECS Task Definition) прописано маппинг-правило portMapping = 9200, однако само веб-приложение или сервис внутри контейнера слушает запросы исключительно на порту 8080.

В результате пользователи получают ошибки вроде Connection Refused или 502 Bad Gateway, мониторинг фиксирует падение health check-проверок, а инженеры тратят часы на поиск мифических проблем с сетевыми группами безопасности (Security Groups) или таблицами маршрутизации (Route Tables). На самом же деле корень проблемы кроется в понимании того, как именно работает сетевой стек Docker и Amazon ECS, а также в разнице между портами хоста (Host), контейнера (Container) и целевой группы балансировщика (Target Group).

В этой статье мы подробно разберем, почему возникает этот разрыв между портом 9200 и 8080, как функционирует механизм проброса портов в ECS (как в режиме Fargate, так и в EC2), и пошагово устраним эту конфигурационную ошибку раз и навсегда.

Понимание механизма portMapping в архитектуре ECS

Прежде чем исправлять конфигурацию, давайте четко разберем, за что отвечает параметр portMapping в терминах AWS ECS. Конфигурация задачи (Task Definition) определяет шаблон, по которому запускаются ваши контейнеры. Когда вы задаете секцию portMappings, вы настраиваете мост между виртуальной сетью контейнера и сетевым окружением ноды (или среды Fargate).

В мире Docker и ECS существует два ключевых понятия:

  • containerPort: Порт, на котором запущено само приложение внутри контейнерного пространства имен (namespace). Это тот порт, который ваш код (например, Node.js, Spring Boot, Go или Python-приложение) слушает программно (например, через app.listen(8080)).
  • hostPort: Порт на уровне хост-инстанса (актуально для режима EC2) или порт, открываемый для связи с эластичным сетевым интерфейсом ENI (в режиме Fargate), который принимает входящий трафик снаружи.

Когда вы пишете в Task Definition конфигурацию с portMapping = 9200, вы говорите AWS: «Я хочу, чтобы внешний мир (или Application Load Balancer) отправлял запросы на порт 9200». Если при этом ваше приложение внутри контейнера жестко завязано на порт 8080 и не слушает порт 9200, то пакеты, доходящие до контейнера, просто падают в никуда, так как на порту 9200 внутри контейнера никто не «сидит».

Понимание этого принципа сразу отсекает половину неверных предположений. Проблема заключается не в том, что ECS «неправильно пересылает» трафик, а в несогласованности контракта между внешним интерфейсом задачи и внутренним интерфейсом запущенного бинарного файла.

Диагностика симптомов: почему приложение недоступно

Прежде чем переходить к исправлениям, важно уметь точно диагностировать симптомы. Когда ваш ECS Task настроен с портом 9200, а приложение работает на 8080, вы столкнетесь с определенной цепочкой событий при развертывании:

  1. Успешный старт контейнера: ECS успешно скачивает образ из Elastic Container Registry (ECR), запускает контейнер, и Docker сообщает статус RUNNING. На этом этапе ECS считает задачу здоровой, так как сам контейнер запустился без сбоев.
  2. Провал Health Check: Если вы используете Application Load Balancer (ALB) с целевой группой (Target Group), настроенной на проверку здоровья (Health Check) по порту 9200 или по дефолтному пути приложения, ALB начинает отправлять запросы.
  3. Таймауты и ошибки: Поскольку внутреннее приложение ждет запросы на порту 8080, а трафик приходит на порт 9200 (или наоборот, в зависимости от того, как настроена Target Group), соединения сбрасываются. Балансировщик переводит таргет в статус Unhealthy.
  4. Циклическое пересоздание (CrashLoop / Replacement): Если у вас настроен ECS Service с деплоями, сервис может начать циклически убивать и пересоздавать задачи, фиксируя, что приложение не проходит проверки работоспособности.

Для точной проверки загляните в логи контейнера через Amazon CloudWatch Logs. Если ваше приложение выводит в консоль строку вроде "Server started on port 8080", а вы отчаянно пытаетесь достучаться до него через порт 9200, вы мгновенно найдете логическое противоречие.

Вариант решения 1: Исправление конфигурации portMapping в Task Definition

Первый и самый очевидный способ решить проблему — привести сетевую карту в Task Definition в соответствие с тем, как написано ваше приложение. Если код жестко запрограммирован слушать порт 8080, и у вас нет возможности (или желания) перекомпилировать его или менять переменные окружения, единственно верным шагом будет изменить portMapping в конфигурации ECS на 8080.

Давайте посмотрим на пример правильного JSON-фрагмента Task Definition для режима AWSVPC (Fargate):

{
  "family": "my-application-task",
  "networkMode": "awsvpc",
  "containerDefinitions": [
    {
      "name": "my-app",
      "image": "123456789012.dkr.ecr.us-east-1.amazonaws.com/my-app:latest",
      "portMappings": [
        {
          "containerPort": 8080,
          "hostPort": 8080,
          "protocol": "tcp"
        }
      ],
      "essential": true,
      "environment": [
        {
          "name": "PORT",
          "value": "8080"
        }
      ]
    }
  ],
  "requiresCompatibilities": [
    "FARGATE"
  ],
  "cpu": "256",
  "memory": "512"
}

Обратите внимание на ключевой момент: в режиме сети awsvpc параметры containerPort и hostPort должны быть равны друг другу, так как каждый контейнер получает собственный сетевой интерфейс (ENI) с уникальным IP-адресом. Изменив containerPort с 9200 на 8080, мы заставляем ECS ожидать входящий трафик именно на том порту, который слушает наше приложение.

Вариант решения 2: Настройка приложения на динамический или требуемый порт через Environment Variables

Второй подход является более гибким и профессиональным с точки зрения облачной архитектуры. Вместо того чтобы жестко прописывать порт 8080 в коде вашего приложения, заставьте его считывать номер порта из переменных окружения (Environment Variables). Это позволит вам использовать порт 9200 (или любой другой, который требует ваша корпоративная инфраструктура) без изменения исходного кода приложения.

Большинство современных веб-фреймворков поддерживают конфигурацию через переменные окружения из коробки. Рассмотрим пример на Node.js / Express:

const express = require('express');
const app = express();
const PORT = process.env.PORT || 8080;

app.get('/health', (req, res) => {
    res.status(200).send('OK');
});

app.listen(PORT, '0.0.0.0', () => {
    console.log(`Application is running smoothly on port ${PORT}`);
});

Теперь, имея такой код, вы можете управлять портом прямо из манифеста ECS Task Definition, передавая нужное значение через секцию environment:

"environment": [
  {
    "name": "PORT",
    "value": "9200"
  }
]

В этом случае в блоке portMappings вы смело указываете containerPort: 9200 и hostPort: 9200. Приложение прочитает переменную PORT=9200, запустится на нужном порту, и сетевой маппинг в ECS совпадет с реальностью на 100%. Это избавит вас от жесткой привязки к конкретным цифрам в коде.

Связка с Application Load Balancer (ALB) и Target Groups

Часто путаница с портами 9200 и 8080 возникает тогда, когда в уравнение добавляется балансировщик нагрузки (ALB). Важно четко понимать путь прохождения сетевого пакета, чтобы правильно настроить Target Group:

Клиент отправляет запрос на балансировщик (например, порт 80 или 443) -> ALB перенаправляет запрос на целевую группу (Target Group), которая настроена на отправку трафика на порт задачи ECS (например, 9200) -> Задача принимает трафик на своем сетевом интерфейсе и передает его контейнеру -> Контейнер должен слушать этот порт внутри себя.

Если вы решили оставить порт приложения равным 8080, вам необходимо убедиться, что:

  • В Task Definition параметр containerPort = 8080.
  • В Target Group балансировщика нагрузки порт для регистрации таргетов также установлен на 8080.
  • Security Group вашей ECS-задачи разрешает входящий трафик с портов балансировщика на порт 8080.

Если же вы хотите использовать порт 9200 снаружи (например, ваша система мониторинга или API клиенты привыкли стучаться именно на 9200, как в случае с Elasticsearch), то правильная цепочка выглядит так: ALB принимает запросы на 9200 -> перенаправляет на порт 9200 задачи ECS -> а внутри задачи переменная окружения PORT=9200 заставляет приложение слушать именно 9200.

Заключение

Проблема несоответствия портов, когда в ECS Task Definition указан portMapping = 9200, а приложение работает на 8080 — это классический пример нарушения сетевого контракта между инфраструктурой и кодом контейнера. Она не решается простой перезагрузкой сервиса или изменением правил безопасности, так как лежит на уровне логики запуска процессов.

Подводя итог, у вас есть два надежных пути решения этой архитектурной задачи:

  1. Привести инфраструктурный конфиг (Task Definition) в соответствие с приложением, изменив порт маппинга на 8080.
  2. Сделать приложение гибким, научив его принимать номер порта через переменные окружения (например, process.env.PORT), и передать значение 9200 через секцию environment в ECS.

Внедрение второго подхода является более масштабируемым и профессиональным решением для облачных сред, так как позволяет гибко управлять конфигурацией развертывания без пересборки Docker-образов. Убедитесь, что ваши Target Groups и Security Groups настроены согласованно с выбранным вариантом, и ваши сервисы в Amazon ECS будут работать стабильно и предсказуемо.