Mappage de ports 1:1

Cette option est utile pour les serveurs de jeu hérités ou les jeux qui ne prennent pas en charge le NAT punching, ce qui signifie que votre jeu a probablement besoin du même port pour les ports externes et internes.

En utilisant le mappage de ports 1:1, chaque fois que vous déployez votre application, votre conteneur se verra attribuer un port aléatoire. Ce port sera utilisé pour les ports interne et externe. Vous devrez récupérer ce port pour indiquer à votre serveur qu'il écoute et sert dessus.

Créer un port 1:1

Avec le tableau de bord

Lors de la création de ports dans le formulaire de version de l'application, il y aura une option pour activer le mappage de ports 1:1. Elle saisira automatiquement 0 comme port, et vous ne pourrez pas le modifier. Vous devez utiliser la case à cocher. Vous ne pouvez pas saisir manuellement 0.

Lorsque vous utilisez le mappage de ports 1:1, le nom du port devient obligatoire. Le nom sera utilisé pour récupérer facilement votre port plus tard dans les détails du déploiement.

Les ports 1:1 peuvent être dupliqués car un port aléatoire unique sera attribué.

Avec l'API

Pour créer un port 1:1 via l'API, vous devez simplement mettre 0 comme valeur du port.

Lorsque vous utilisez le mappage de ports 1:1, le nom du port devient obligatoire. Le nom sera utilisé pour récupérer facilement votre port plus tard dans les détails du déploiement.

Les ports 1:1 peuvent être dupliqués car un port aléatoire unique sera attribué.

{
  "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"
    }
  ]
}

Récupérer vos ports

Puisque cette option attribuera un port aléatoire unique, vous aurez besoin d'un moyen pour obtenir le port fourni.

Votre déploiement aura des variables d'environnement injectées ARBITRIUM_PORTS_MAPPING et ARBITRIUM_PUBLIC_IP. Le mappage de ports est une chaîne JSON avec ce format :

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

Vous pouvez également effectuer un appel API depuis votre conteneur en utilisant le ARBITRIUM_CONTEXT_URL. Il vous donnera tous les détails de votre déploiement. Vous devrez également activer le inject context option dans votre version d'application.

Vous pouvez utiliser un mélange de ports 1:1 et de ports standard non dynamiques.

Vérification

Si vous utilisez l'option de vérification de port, vous devez vous assurer que votre serveur tente d'assigner son port interne le plus rapidement possible. Si votre serveur effectue une opération longue avant d'ouvrir ses ports, la vérification peut échouer en raison d'un port ne répondant pas.

Si effectuer une opération longue est inévitable, veuillez nous contacter afin que nous puissions augmenter le temps maximum pour effectuer la vérification du port pour votre application.