Сопоставление портов 1:1

Этот параметр полезен для устаревших игровых серверов или игр, которые не поддерживают NAT punching, что означает, что вашей игре, вероятно, нужен один и тот же порт для внешнего и внутреннего соединений.

При использовании сопоставления портов 1:1 каждый раз при развертывании приложения вашему контейнеру будет назначаться случайный порт. Этот порт будет использоваться и для внутреннего, и для внешнего портов. Вам нужно будет получить этот порт, чтобы указать вашему серверу, что он слушает и обслуживает на нём.

Создать порт 1:1

Через панель управления

При создании портов в форме версии приложения появится опция активации сопоставления портов 1:1. Она автоматически введёт 0 как порт, и вы не сможете изменить его. Вы должны использовать флажок. Вы не можете вручную ввести 0.

При использовании сопоставления портов 1:1 имя порта становится обязательным. Это имя будет использоваться для удобного получения вашего порта позже в деталях развертывания.

Порты 1:1 можно дублировать, так как будет назначен уникальный случайный порт.

Через API

Чтобы создать порт 1:1 через API, вам нужно лишь указать 0 в качестве значения порта.

При использовании сопоставления портов 1:1 имя порта становится обязательным. Это имя будет использоваться для удобного получения вашего порта позже в деталях развертывания.

Порты 1:1 можно дублировать, так как будет назначен уникальный случайный порт.

{
  "name": "v1",
  "docker_repository": "docker.io",
  "docker_image": "edgegap/tutorial",
  "docker_tag": "0.2.37",
  "req_cpu": 128,
  "req_memory": 256,
  "ports": [
    {
      "port": 0,
      "protocol": "TCP",
      "to_check": true,
      "name": "game_port"
    }
  ]
}

Получение ваших портов

Поскольку эта опция назначает уникальный случайный порт, вам понадобится способ получить назначенный порт.

В ваше развертывание будут внедрены переменные окружения ARBITRIUM_PORTS_MAPPING и ARBITRIUM_PUBLIC_IP. Сопоставление портов представляет собой JSON-строку с таким форматом:

{
  "ports": {
    "game_port": {
      "name": "game_port",
      "internal": 31000,
      "external": 31000,
      "protocol": "TCP"
    },
    "5000": {
      "name": null,
      "internal": 5000,
      "external": 31500,
      "protocol": "HTTP"
    }
  }
}

Вы также можете выполнить API-вызов внутри вашего контейнера, используя ARBITRIUM_CONTEXT_URL. Он даст вам все детали по вашему развертыванию. Вам также нужно будет активировать опцию внедрения контекста в вашей версии приложения.

Вы можете использовать комбинацию 1:1 и стандартных нединамических портов.

Проверка

Если вы используете опцию проверки порта, вам следует убедиться, что ваш сервер пытается как можно скорее назначить свой внутренний порт. Если ваш сервер выполняет длительную операцию перед поднятием портов, проверка может завершиться неудачей из‑за того, что порт не отвечает.

Если выполнение длительной операции неизбежно, пожалуйста, свяжитесь с нами, чтобы мы могли увеличить максимальное время для проверки порта для вашего приложения.