1:1 端口映射

此选项对遗留的游戏服务器或不支持 NAT 打洞的游戏有帮助，这意味着你的游戏可能需要外部和内部使用相同的端口。

通过使用 1:1 端口映射，每次部署应用时，容器都会被分配一个随机端口。该端口将被用于内部和外部端口。你需要检索此端口以向服务器指定其正在监听并在该端口提供服务。

创建 1:1 端口

使用仪表板

在应用版本表单中创建端口时，会有一个选项来启用 1:1 端口映射。它会自动将端口输入为 0，且你无法修改。你必须使用复选框来启用。不能手动输入 0。

使用 1:1 端口映射时，端口名称变为必填。该名称将用于在部署详细信息中方便地检索你的端口。

1:1 端口可以重复，因为会分配一个唯一的随机端口。

使用 API

要通过 API 创建 1:1 端口，你只需将端口值设为 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。它将为你提供部署的所有详细信息。你还需要在应用版本中激活 inject context 选项。

你可以混合使用 1:1 动态端口和标准的非动态端口。

验证

如果你使用端口验证选项，应确保你的服务器尽快尝试绑定其内部端口。如果服务器在端口就绪之前执行耗时操作，验证可能会因端口无响应而失败。

如果不可避免地需要执行耗时操作，请联系我们，以便我们可以为你的应用增加端口验证的最大等待时间。