> For the complete documentation index, see [llms.txt](https://docs.edgegap.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.edgegap.com/fr/learn/orchestration/deployments.md).

# Déploiements

Comprenez le cycle de vie d’un déploiement Edgegap : comment les instances de serveur de jeu démarrent, fonctionnent, montent en charge et s’arrêtent, ainsi que les bonnes pratiques pour les gérer.

Découvrez les déploiements et leur cycle de vie - concepts et bonnes pratiques pour une compréhension approfondie.

## 🗺️ Orchestration

Démarrez de nouveaux serveurs en quelques secondes pour répondre aux besoins de capacité grâce à notre approche d'edge computing native au cloud. Nous traitons les serveurs comme [du bétail plutôt que des animaux de compagnie](https://cloudscaling.com/blog/cloud-computing/the-history-of-pets-vs-cattle/) - en remplaçant entièrement les instances défaillantes au lieu de les choyer manuellement une par une.

{% hint style="info" %}
Votre choix d'orchestration va **avoir un impact sur vos coûts DevOps, vos coûts serveur et votre évolutivité**.
{% endhint %}

{% hint style="success" %}
[Contactez-nous sur Discord](https://discord.gg/MmJf8fWjnt) pour en savoir plus sur les options d'orchestration hybride et l'optimisation de vos coûts d'hébergement.
{% endhint %}

Pour bien comprendre tous les avantages et inconvénients, comparons différentes méthodes d'orchestration. Certains jeux utiliseront plusieurs méthodes d'orchestration selon la conception de la boucle de jeu.

### Lié au match

Les serveurs à durée de vie courte (limitée dans le temps) se mettent à l'échelle vers le bas à la fin du match, offrant **le meilleur rapport coût-performance**.

Les sessions sont généralement automatisées via un [Matchmaking](https://docs.edgegap.com/fr/unity/matchmaking.md) service, qui déploie des serveurs juste à temps selon des règles strictes, et permet éventuellement de remplir les serveurs en cours de route pour [augmenter le taux de remplissage des parties](https://edgegap.com/blog/how-session-fill-rate-affects-your-multiplayer-hosting-costs).

👍 **Avantages**

* Meilleure rentabilité - mise à l'échelle en temps réel pour répondre à la demande des joueurs minute par minute.
* Coût DevOps le plus faible grâce à un hébergement sans région, Edgegap automatise 99 % des tâches.
* Ping le plus faible grâce à plus de 615 sites dans l'infrastructure cloud publique d'Edgegap.
* Montée en charge la plus rapide (capacité de pic) en cas de pic de trafic inattendu.
* Le plus haut niveau de sécurité et de prévention de la triche des joueurs (autorité du serveur).
* Impact minimal d'une panne serveur imprévue sur les joueurs, n'affectant qu'un seul match.

👎 **Inconvénients**

* L'adoption d'un nouveau modèle mental d'orchestration demande un certain effort de montée en compétence au départ.
* Les serveurs fonctionnant plus de 24 heures seront automatiquement arrêtés.

🧩 **Mieux adapté pour**

* Jeux sensibles à la latence - **quand l'optimisation du netcode ne peut pas compenser un ping élevé :**
  * Jeux de tir à la première personne, jeux de combat, VR et XR (réalité virtuelle et réalité étendue), …
* Jeux avec une **limite supérieure de durée de match par conception**,
  * Battle Royale, PvPvE[^1], jeux de tir coopératifs, MOBA, jeux de sport, ARPG et dungeon crawlers, …

{% hint style="info" %}
Edgegap ajuste automatiquement à la hausse/à la baisse toutes les plus de 615 emplacements de serveur en fonction de l'activité des joueurs dans chaque région. Préparez-vous au succès - [passez sans effort à 14 millions d'utilisateurs simultanés en 60 minutes](https://edgegap.com/resources/performance-benchmark).
{% endhint %}

### Veille régionale

Jeu MMO persistant de monde ouvert et social **la durée de vie du serveur dépasse souvent les sessions individuelles des joueurs**.

Les sessions sont généralement attribuées via un [Navigateur de serveurs](https://docs.edgegap.com/fr/learn/navigateur-de-serveurs.md) en fonction des préférences des joueurs (automatisé par région ou recherche personnalisée), avec une pré-mise à l'échelle horizontale des déploiements basée sur la capacité régionale.

👍 **Avantages**

* Approche familière et facile à comprendre, à l'ancienne, pour les vétérans aguerris.
* Le plus haut niveau de sécurité et de prévention de la triche des joueurs (autorité du serveur).
* Coût facilement prévisible basé sur un engagement mensuel.

👎 **Inconvénients**

* Coût d'hébergement plus élevé - chaque région nécessite un ou plusieurs serveurs de veille inactifs (capacité de pic).
* Coût DevOps plus élevé - mise à l'échelle, opérations et maintenance dupliquées par région.
* Les régions avec une base de joueurs plus réduite subissent un ping élevé car elles rejoignent des serveurs éloignés.

🧩 **Mieux adapté pour**

* Des mondes persistants avec du contenu généré par les utilisateurs stocké sur le serveur même lorsque les joueurs sont hors ligne.
  * MMO, sandbox avec construction de base ou placement d'objets, extraction shooters, ...
* jeux tolérants à la latence - **lorsque la physique temps réel avec autorité du serveur n'est pas requise**:
  * jeux mobiles, jeux coopératifs, JCC/JCE, stratégies au tour par tour, …
* Multijoueur asynchrone, **où les pannes serveur ont un impact minimal sur l'expérience des joueurs :**
  * courir après des fantômes, piller la base ennemie, jeux de construction/d'agriculture à minuterie, …
* applications avec un processus d'initialisation lourd - lorsque la préparation des serveurs prend plusieurs minutes.

### Peer to Peer

Déplacez les efforts de développement des ~~serveurs dédiés~~ vers **le netcode relais pour les jeux non compétitifs**.

Sujets connexes : listen servers, autorité hébergée par le joueur, traversée de NAT.

👍 **Avantages**

* Coût d'hébergement le plus faible, ne nécessitant que des serveurs de relais pour résoudre la traversée de NAT.
* Coût DevOps le plus faible - maintenance requise uniquement pour les builds clients et les canaux de distribution.
* Impact minimal d'une panne serveur imprévue sur les joueurs, n'affectant qu'un seul match.
* Facile à mettre en œuvre et rapide à prototyper, sans aucun développement backend requis.

👎 **Inconvénients**

* Effort de développement du netcode peer-to-peer accru, nécessitant des compétences en programmation concurrente.
* Pires temps de ping et plus sensible aux conditions réseau défavorables (par ex. internet mobile).
* Sécurité la plus faible, vulnérable aux attaques de l'homme du milieu et au détournement de session.
* Risque de déconnexion des sessions lorsque l'hôte quitte, sauf si vous implémentez une migration d'hôte personnalisée.

🧩 **Mieux adapté pour**

* Jeux coopératifs et casual - **quand la triche ne gâche pas le plaisir ni ne casse le jeu**,
  * Jeux pour enfants, jeux d'exploration, aventures, …

{% hint style="success" %}
Découvrez nos [Relais distribués](https://docs.edgegap.com/docs/distributed-relay-manager) pour un service permettant le peer to peer avec une latence et une sécurité de premier ordre.
{% endhint %}

## 📍 Placement des serveurs

Quelle que soit la méthode d'orchestration choisie, sélectionner le bon emplacement de serveur pour un groupe de joueurs est essentiel pour garantir le meilleur ping possible et une expérience de jeu optimale. Découvrez les différentes stratégies de placement des serveurs et leur impact sur vos joueurs.

{% hint style="info" %}
Votre stratégie de placement des serveurs va **avoir un impact sur l'expérience de vos joueurs, leur fidélisation et les avis sur votre jeu**.
{% endhint %}

{% hint style="success" %}
**Edgegap déploie dans le** [**meilleur emplacement possible**](#server-score) **avec capacité disponible**, pour des matchs rapides et à faible latence.
{% endhint %}

<figure><img src="https://3008966946-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2FjiPRa6gGEku2oGm3qW5s%2Fimage.png?alt=media&amp;token=306897d4-8ab1-4766-bc90-5d02882b573c" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Voir [#deployment-balance-points](#deployment-balance-points "mention") vers **analyser le placement des serveurs en temps réel**, à grande échelle.
{% endhint %}

### Score du serveur

La stratégie de score du serveur utilise la méthodologie brevetée d'Edgegap, qui **optimise individuellement le placement des serveurs pour chaque match**. Effectue une télémétrie non intrusive pour approximer la proximité réseau de chaque joueur par rapport à nos emplacements de serveurs et choisir le serveur qui offre le meilleur :

* **réactivité** - offre le ping le plus faible en moyenne pour tous les joueurs,
* **équité** - offre un ping équilibré et équitable pour tous les joueurs.

{% hint style="success" %}
Notre [Matchmaker](https://docs.edgegap.com/fr/learn/matchmaking.md) utilise **par défaut la stratégie de Score du serveur, pour garantir la meilleure expérience possible**. Pour utiliser cette stratégie avec les [API de déploiement](https://docs.edgegap.com/api/#tag/Deployments), saisissez les IP publiques des joueurs ou leurs coordonnées géographiques dans votre demande de déploiement.
{% endhint %}

**Placement peu réactif** - le serveur est loin, ping élevé pour tous les joueurs :

<figure><img src="https://3008966946-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2FNszxk3uRY78L7V6nLPlp%2Fimage.png?alt=media&amp;token=904b9b3d-7499-45d3-81c6-cc2b5cb6dd32" alt=""><figcaption></figcaption></figure>

**Placement inéquitable** - ping inégal, un joueur est désavantagé à cause d'une latence plus élevée :

<figure><img src="https://3008966946-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2FxjsD6ijYWHljBAVuV57w%2Fimage.png?alt=media&amp;token=ab477e89-4afe-4203-9b7f-b85b035dc9eb" alt=""><figcaption></figcaption></figure>

**Exemple de bon placement** - ping réactif et équitable pour tous les joueurs :

<figure><img src="https://3008966946-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2FQfSd4uo9twyxEWCkPLqu%2Fimage.png?alt=media&amp;token=8d3cd64b-9527-48fe-886b-96393c15449d" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Cette stratégie est **particulièrement efficace pour héberger un groupe de joueurs éloignés les uns des autres** (Amérique du Nord vs Amérique du Sud, ou côte ouest vs côte est), cas fréquent avec une base de joueurs plus réduite.
{% endhint %}

### Géolocalisation

Sinon, **fournissez les coordonnées latitude et longitude de l'emplacement de serveur souhaité :**

⭐ **Recommandé :** Trouvez la sonde de ping la plus rapide et envoyez ses coordonnées, ou son IP, dans le champ utilisateur.

⚙️ **Personnalisé**: définissez des régions (avec coordonnées) dans le backend de votre jeu, récupérez-les via une API personnalisée.

👉 **Le plus simple pour tester :** Définissez des régions (avec coordonnées) en dur dans les builds de développement du client de jeu.

{% hint style="warning" %}
Cette stratégie n'est pas recommandée pour [#match-bound](#match-bound "mention") l'orchestration, sauf pour les applications soumises à des exigences réglementaires strictes en matière de transferts de données interrégionaux, ou lorsque l'adresse IP du joueur n'est pas disponible.
{% endhint %}

{% hint style="success" %}
Alternativement, laissez les joueurs **choisir un serveur persistant (toujours en ligne)** d'une liste avec [Navigateur de serveurs](https://docs.edgegap.com/fr/learn/navigateur-de-serveurs.md).
{% endhint %}

### Verrouillage de région

Certains studios préfèrent verrouiller des emplacements stables et prévisibles (par ex. des MMO avec [Persistance](https://docs.edgegap.com/fr/learn/orchestration/persistance.md)). Envisagez [Navigateur de serveurs](https://docs.edgegap.com/fr/learn/navigateur-de-serveurs.md) avec [des politiques de mise à l'échelle régionales](https://docs.edgegap.com/fr/learn/navigateur-de-serveurs.md#automated-scaling) et [des réservations attribuées automatiquement](https://docs.edgegap.com/fr/learn/navigateur-de-serveurs.md#auto-assigned-reservation).

{% hint style="warning" %}
Cette stratégie n'est pas recommandée pour [#match-bound](#match-bound "mention") l'orchestration, sauf pour les applications soumises à des exigences réglementaires strictes en matière de transferts de données interrégionaux, ou lorsque l'adresse IP du joueur n'est pas disponible.
{% endhint %}

## 🟢 Qualité de connexion

Certains jeux (et joueurs) sont plus sensibles que d'autres à la latence ou au lag. Bien que les rapports des joueurs soient un excellent indicateur d'incidents ou de bugs de régression à grande échelle, **les joueurs peuvent manquer d'une compréhension approfondie des concepts réseau** et attribuent rapidement la faute aux studios, au netcode ou aux serveurs.

La cause profonde de certains problèmes peut être cachée aux joueurs, de sorte que la coopération entre le studio et le fournisseur d'hébergement peut être cruciale. **La priorité d'Edgegap est toujours de fournir le meilleur service possible.**

Si vous recevez de nombreux signalements de joueurs, si vous subissez des pannes généralisées ou des problèmes répétés, veuillez nous contacter immédiatement via un ticket de support sur notre plateforme.

{% hint style="info" %}
Si vous avez besoin d’aide, [veuillez nous contacter sur Discord](https://discord.gg/MmJf8fWjnt). Pour l’assistance aux jeux en direct, consultez notre [système de tickets](https://edgegap.atlassian.net/servicedesk/customer/portal/3).
{% endhint %}

#### Faible latence

La latence des joueurs est une combinaison des latences dues au transfert de données entre :

* **Dispositifs physiques -** le signal physique voyageant à travers [la topologie du réseau Internet](https://en.wikipedia.org/wiki/Internet#Routing).
* **Hôte à hôte** - résultant des mesures de protocole, de transport et de sécurité.
* **Processus à processus** - résultant de la mise en (dé)marche et du traitement des données côté client/serveur.

Edgegap réduit la latence physique en rapprochant les serveurs de vos joueurs pour des réponses plus rapides et un nombre réduit de sauts réseau. Avec des emplacements répartis sur 17 fournisseurs cloud et bare metal, vous obtenez **un ping de premier ordre pour les joueurs partout dans le monde**.

La couverture mondiale des serveurs et d'Internet (pas seulement avec Edgegap) est limitée par des facteurs tels que :

* **Disponibilité de l'infrastructure** - la qualité de la connexion Internet dans une région donnée peut ne pas être suffisante.
* **Facteurs naturels** - les serveurs comprennent des composants sensibles, nécessitant de la stabilité (pas de tremblements de terre).

#### Haute disponibilité

La disponibilité des serveurs dans divers emplacements à travers le monde varie dans le temps, changeant de nombreuses fois au cours de la journée. Edgegap **adapte automatiquement à la hausse/à la baisse** les emplacements **à la demande**, en tenant compte de :

* **Trafic de pointe** - les déploiements effectués sur une période de 15 minutes informent les tendances de mise à l'échelle.
* **Exigences en ressources** - la demande totale en vCPU dans chaque emplacement informe le rythme de mise à l'échelle.
* **Alternatives de fournisseurs** - certains emplacements éloignés disposent de moins d'options de fournisseurs.
* **Capacité du fournisseur** - certains emplacements n'offrent peut-être que des machines 4 vCPU ou 8 vCPU.
* **Qualité de service** - certains fournisseurs offrent une meilleure qualité réseau à travers les FAI de la même zone.
* **Calendrier du studio** - demandes spéciales pour les tests et l'assurance qualité, bêtas fermées ou tournois.

Toutes les demandes de déploiement des applications sont combinées pour évaluer la demande dans chaque emplacement. Toutes les organisations ont par défaut la même priorité d'allocation. **Les studios ont la possibilité d'ajouter des** [Flottes privées](https://docs.edgegap.com/fr/learn/orchestration/flottes-privees.md).

{% hint style="success" %}
Veuillez **nous contacter pour planifier une sortie**ou si vous avez des demandes concernant la disponibilité des emplacements.
{% endhint %}

#### Résolution des problèmes des joueurs

Les problèmes des joueurs peuvent parfois être causés par des bugs du serveur ou de l'hébergement, mais ils n'y sont souvent pas liés - prenez aussi en compte les problèmes de connexion câble/wifi, de fournisseur d'accès Internet, de services backend, ou de bugs dans les bibliothèques bas niveau client/serveur.

Lors du dépannage des signalements ou incidents des joueurs, prenez en compte les facteurs :

* **Qualité du matchmaking** - optimisez autant que possible pour des matchs dans la même région :
  * [Matchmaking](https://docs.edgegap.com/fr/learn/matchmaking.md) et [Balises de ping](https://docs.edgegap.com/fr/learn/orchestration/ping-beacons.md) pour nos recommandations,
  * [Analyse approfondie](https://docs.edgegap.com/fr/learn/matchmaking/matchmaker-in-depth.md#player-tracing) pour trouver les journaux serveur liés aux signalements des joueurs.
* **Problèmes régionaux de réseau et de FAI :**
  * les fournisseurs d'accès Internet (FAI) localisés peuvent être en train de résoudre un incident momentanément,
  * certaines régions (par ex. la Chine, la Russie) peuvent être restreintes en raison de sanctions localisées.
* **Niveau de cache** - sans cache, vos sessions peuvent expirer en raison de déploiements plus lents :
  * [activez le cache pour déployer vos serveurs en quelques secondes](https://docs.edgegap.com/fr/learn/orchestration/application-and-versions.md#other-parameters-optional).
* **Temps maximum de déploiement** - les déploiements peuvent échouer en raison d'un processus d'initialisation lent et lourd :
  * voir [Applications et versions](https://docs.edgegap.com/fr/learn/orchestration/application-and-versions.md#safety-guardrails) pour augmenter le délai d'expiration.
* **Problèmes d'image serveur ou d'intégration** dans les premières itérations des pipelines de build personnalisés.

{% hint style="success" %}
**Afficher les ID de déploiement dans l'UI de l'historique des matchs du client** pour tracer les signalements des joueurs lors du dépannage.
{% endhint %}

{% hint style="info" %}
Informer les utilisateurs des bugs généralisés, des problèmes temporaires et des pannes afin d'atténuer le sentiment négatif.
{% endhint %}

## 🔄 Cycle de vie du déploiement

Les déploiements Edgegap passent par plusieurs étapes de cycle de vie, indiquées par l'état du déploiement.

#### 1. Démarrer un déploiement

Un déploiement pour **des fins de test** peut être démarré avec :

* [Unreal Engine](https://docs.edgegap.com/fr/unreal-engine.md) - l'extension Docker ou le plugin EGIK pour les projets Unreal Engine.
* [Unity](https://docs.edgegap.com/fr/unity.md) - le plugin de démarrage rapide d'hébergement pour les projets Unity.
* [Godot](https://docs.edgegap.com/fr/godot.md) - le plugin de démarrage rapide d'hébergement pour les projets Godot.
* [Interface Web du tableau de bord](https://app.edgegap.com/deployment-management/deployments/list) - interface web facile pour des tests rapides des serveurs et des itérations.

Lors des tests de nouvelles versions avec des développeurs ou des équipes QA, l’étape de session est souvent ignorée et les joueurs se connectent directement aux déploiements, tout en codant en dur ou en désactivant les fonctionnalités liées à la session. Cela permet d’accélérer l’itération de développement et d’isoler les effets secondaires de la session des fonctionnalités du serveur.

{% hint style="warning" %}
**Démarrer vos déploiements manuellement et coller les URL et les ports ne suffira pas pour un jeu en direct.**
{% endhint %}

Automatisez les flux de jeu populaires pour [Sessions de joueur](https://docs.edgegap.com/fr/learn/orchestration/sessions-de-joueur.md) et la montée en charge des serveurs avec l’une des options suivantes :

{% columns %}
{% column width="33.33333333333333%" %}
[Matchmaking](https://docs.edgegap.com/fr/learn/matchmaking.md):

* Jeux compétitifs
* Matchs à la demande
* Classement de compétence et/ou\
  Règles personnalisées
  {% endcolumn %}

{% column width="33.33333333333333%" %}
[Navigateur de serveurs](https://docs.edgegap.com/fr/learn/navigateur-de-serveurs.md):

* Persistant ou social
* Sessions longues
* Affectation automatique et/ou\
  Recherche personnalisée
  {% endcolumn %}

{% column width="33.33333333333333%" %}
Back-end personnalisé :

* Migrer des jeux en direct
* [Déployer avec l’API v2](https://docs.edgegap.com/fr/docs/api/serveurs-dedies.md)
* [Observer les webhooks](https://docs.edgegap.com/fr/learn/orchestration/deployments.md#webhooks)
  {% endcolumn %}
  {% endcolumns %}

{% hint style="success" %}
**Enregistrer** `request_id`  **(ID de déploiement) et taguez les déploiements** pour identifier et dépanner les problèmes plus tard.
{% endhint %}

#### 2. Déploiement en cours

Une fois un déploiement lancé, notre système exécute un certain nombre d'étapes en succession rapide :

* Télémétrie - nous mesurons la réactivité réseau entre les centres de données disponibles et chaque joueur,
* Déploiement - nous réservons de la capacité et préparons le démarrage de votre conteneur serveur,
* Démarrage du conteneur - nous démarrons le conteneur, installons les dépendances et initialisons,
* Post-traitement - nous ajoutons le stockage des journaux, la surveillance et finalisons le déploiement.

{% hint style="success" %}
Activer [Activer la mise en cache dans la version de votre application](https://docs.edgegap.com/fr/learn/orchestration/application-and-versions.md#active-caching) pour déployer des serveurs en quelques secondes.
{% endhint %}

{% hint style="warning" %}
**Trop de requêtes 429** - pour garantir la stabilité et éviter les factures surprises, nous limitons le débit de votre organisation à **40 requêtes/s**. [Contactez-nous](mailto:info@edgegap.com) pour planifier les sorties, estimer le trafic au lancement et préparer le succès.
{% endhint %}

#### 3. Déploiement prêt

Une fois qu'un déploiement est prêt, votre moteur a encore du travail à faire. Les moteurs initialisent les sous-systèmes et les frameworks, puis chargent les ressources, y compris les cartes, en mémoire. Cela se produit après que votre déploiement devient prêt, et prend généralement jusqu'à 1 minute selon votre degré d'optimisation.

{% hint style="success" %}
**Réessayer la connexion du joueur plusieurs fois**, jusqu'à ce qu'un délai d'attente prédéfini soit écoulé, avant de se retirer et de démarrer une nouvelle session. Les serveurs n'acceptent généralement pas de nouvelles connexions de joueurs tant qu'ils ne sont pas entièrement initialisés.
{% endhint %}

{% hint style="danger" %}
**La gestion des plantages du serveur dépend de votre** [**politique de redémarrage du processus**](https://docs.edgegap.com/fr/learn/orchestration/application-and-versions.md#safety-guardrails)**.** [L'état du serveur peut être perdu](https://docs.edgegap.com/fr/learn/orchestration/persistance.md#state-management).
{% endhint %}

Selon le [Applications et versions](https://docs.edgegap.com/fr/learn/orchestration/application-and-versions.md#active-caching) statut de la version, vous pouvez recevoir :

🟢 **Cache Hit**

Le cache est activé. Le déploiement a été plus rapide grâce à la réutilisation de l'image préchargée sur cette machine.

🟡 **Warm Start**

Le cache est désactivé. Le déploiement a été plus rapide grâce à la réutilisation de l'image téléchargée pour un déploiement précédent sur la même machine. Activez le cache pour obtenir des déploiements toujours rapides dans le monde entier.

🔴 **Cache Miss**

Le cache est activé. Le déploiement a été plus lent en raison d'une brusque hausse du trafic avant la fin de la propagation du cache. L'activation de « exiger des emplacements mis en cache » dans votre demande de déploiement empêchera cela, mais peut entraîner davantage de déploiements non traitables lors de pics de trafic inattendus.

🔴 **Démarrage à froid**

Le cache est désactivé. Le déploiement a été plus lent, l'image a été téléchargée au moment du déploiement. Activez le cache pour un déploiement plus rapide.

#### 4. Erreur de déploiement

Votre déploiement peut à tout moment se retrouver à l'état Non traitable, pour des raisons inattendues. Cela est plus probable lors des tests de votre intégration ou des nouveaux builds serveur.

**Vous n'êtes pas facturé pour les déploiements en erreur, qui sont automatiquement arrêtés après 24 heures.**

Étapes de dépannage :

* Vérifiez l'état du service Edgegap avec [notre page de surveillance de disponibilité](https://status.edgegap.com/).
* Essayez de tester votre conteneur serveur localement avec Docker Desktop pour écarter les problèmes liés à Edgegap.

{% hint style="info" %}
Si vous avez besoin d’aide, [veuillez nous contacter sur Discord](https://discord.gg/MmJf8fWjnt). Pour l’assistance aux jeux en direct, consultez notre [système de tickets](https://edgegap.atlassian.net/servicedesk/customer/portal/3).
{% endhint %}

{% hint style="success" %}
**Lorsque vous demandez de l'aide,** **incluez l'ID de votre déploiement et tout détail utile** afin que nous puissions enquêter rapidement !
{% endhint %}

#### 5. Déploiement arrêté

**Les déploiements cloud seront arrêtés après 24 heures d'exécution** conformément à notre politique de nettoyage des serveurs pour la maintenance de l'infrastructure, et afin d'éviter des coûts inattendus lorsque le déploiement n'a pas été arrêté correctement à cause d'un bug imprévu.

Pour les serveurs de longue durée de plus de 24 heures, envisagez d'utiliser [Flottes privées](https://docs.edgegap.com/fr/learn/orchestration/flottes-privees.md) avec [Persistance](https://docs.edgegap.com/fr/learn/orchestration/persistance.md).

Optimisez vos coûts et arrêtez plus tôt les déploiements inactifs à l'aide de méthodes :

* **Version de l'application** [**Politique de redémarrage**](https://docs.edgegap.com/fr/learn/orchestration/application-and-versions.md#safety-guardrails) - empêcher le redémarrage automatique à l'arrêt ou en cas de panne.
* **Durée maximale du jeu** - le temps alloué dans votre [Applications et versions](https://docs.edgegap.com/fr/learn/orchestration/application-and-versions.md#safety-guardrails) expiré.
* **Arrêt automatique via** [**DELETE\_URL**](https://docs.edgegap.com/fr/learn/orchestration/deployments.md#injected-environment-variables) - le déploiement s'est arrêté de lui-même après le départ des joueurs et la fin du match.
  * Voir [Unreal Engine](https://docs.edgegap.com/fr/unreal-engine.md#stop-deployments) et [Unity](https://docs.edgegap.com/fr/unity.md#stop-deployments) guides pour les utilitaires SDK et une intégration facile, ou utilisez l'API.
* **Arrêt depuis un backend personnalisé** - votre orchestration de session personnalisée peut utiliser [API de déploiements](https://docs.edgegap.com/api/#tag/Deployments/operation/deployment-delete).
* [Flottes privées](https://docs.edgegap.com/fr/learn/orchestration/flottes-privees.md) L'hôte exécutant votre déploiement a été supprimé via une action planifiée.

{% hint style="info" %}
Une fois qu'un déploiement est arrêté, **nous déclenchons une terminaison en douceur** en envoyant `SIGTERM` signal à votre processus principal, permettant une courte période de terminaison. Une fois celle-ci expirée, un signal `SIGKILL` est envoyé pour arrêter le déploiement.
{% endhint %}

## 👀 Observabilité

Permettre aux serveurs de jeu d'interopérer avec des tiers et d'obtenir des informations opérationnelles.

{% hint style="info" %}
**Vous vous inquiétez des coûts cloud inattendus ?** [Configurer des alertes cloud](https://app.edgegap.com/notifications?notification-table-limit=10\&notification-table-page=1#alarms) pour être averti lorsque des seuils de facturation personnalisés sont atteints, ou [contactez-nous](https://discord.com/invite/NgCnkHbsGp) au sujet de mesures de sécurité automatisées.
{% endhint %}

### Découvrabilité

Une fois prêt, le déploiement se voit attribuer une URL ([fqdn](https://en.wikipedia.org/wiki/Fully_qualified_domain_name)) et un port externe pour chaque port interne.

{% hint style="success" %}
Utilisez **les tags de déploiement (jusqu'à 40 caractères) pour marquer facilement vos déploiements** afin de les retrouver plus tard.
{% endhint %}

{% hint style="info" %}
**Le trafic sortant (vers les clients ou le backend) depuis vos serveurs de jeu n'est jamais bloqué** ni filtré.
{% endhint %}

#### **WebSockets (WS) et WebSockets sécurisés (WSS)**

Pour utiliser un netcode basé sur les websockets avec Edgegap, vous avez deux options :

* **certificat géré**, configuré en 1 minute sans écrire une seule ligne de code :
  * configurez votre [Applications et versions](https://docs.edgegap.com/fr/learn/orchestration/application-and-versions.md) vers **utilisez WebSocket (WS) et activez la mise à niveau TLS,**
  * utilisez l'URL Edgegap pour connecter les clients (par ex. `https://5fa53fa00a57.pr.edgegap.net/`)
* **certificat auto-géré**, si vous souhaitez utiliser votre propre domaine personnalisé :
  * configurez votre [Applications et versions](https://docs.edgegap.com/fr/learn/orchestration/application-and-versions.md) vers **utiliser le WebSocket sécurisé (WSS)**,
  * configurez votre propre flux de certificat TLS avec un enregistrement DNS personnalisé (par ex. sur [Cloudflare](https://www.cloudflare.com/application-services/products/ssl/)).

{% hint style="danger" %}
Les exceptions serveur non capturées entraîneront le redémarrage du conteneur du déploiement et invalideront la sécurité TLS. Dans ce cas, [arrêtez votre serveur](#id-5.-deployment-stopped) et [faites correspondre les joueurs à un nouveau déploiement](https://docs.edgegap.com/fr/learn/matchmaking.md#custom-lobby). [L'état du serveur peut être perdu](https://docs.edgegap.com/fr/learn/orchestration/persistance.md#state-management).
{% endhint %}

### Variables injectées <a href="#injected-environment-variables" id="injected-environment-variables"></a>

Les serveurs de jeu ont souvent besoin d'informations supplémentaires, telles que l'adresse IP du serveur, les valeurs de port interne ou autres. L'injection de variables d'environnement en lecture seule est un moyen fiable et indépendant du cloud de transmettre des paramètres.

{% hint style="success" %}
Obtenez les valeurs des variables avec [SDK Unity](https://docs.edgegap.com/fr/unity/developer-tools.md#software-development-kit), [Unreal EGIK](https://docs.edgegap.com/fr/unreal-engine/developer-tools.md#integration-kit), ou avec les méthodes de variables d'environnement de votre runtime.
{% endhint %}

{% hint style="info" %}
Voir [Variables de version d'application](https://docs.edgegap.com/fr/learn/orchestration/application-and-versions.md#injected-variables) et [Variables du matchmaking](https://docs.edgegap.com/fr/learn/matchmaking/matchmaker-in-depth.md#injected-variables) en plus des variables de déploiement ci-dessous.
{% endhint %}

#### **Variables personnalisées**

Définissez jusqu'à 20 variables personnalisées pour chaque déploiement, chacune contenant jusqu'à 4 Ko de données de chaîne.

{% hint style="warning" %}
**Évitez d'utiliser des noms réservés (ci-dessous), sinon vos variables personnalisées seront écrasées !**
{% endhint %}

Accédez aux informations importantes en lisant les variables injectées dans vos serveurs par Edgegap :

#### **Identifiants**

* **`ARBITRIUM_REQUEST_ID`**  - par ex. `f68e011bfb01` .
  * Identifiant de déploiement unique, également appelé identifiant de requête. Utilisé pour récupérer plus d'informations.
  * Les URL de déploiement ont toujours le format `{ARBITRIUM_REQUEST_ID}.pr.edgegap.net`.
* **`ARBITRIUM_PUBLIC_IP`**  - par ex. `162.254.141.66` .
  * Adresse IP publique de cet hôte, peut être utilisée pour se connecter à la place de l'URL.
* **`ARBITRIUM_HOST_ID`**  - par ex. `alpha-north-america-70364ef8` .
  * Identifiant unique de la machine hébergeant votre déploiement, partagé avec d'autres déploiements.
* **`ARBITRIUM_DEPLOYMENT_TAGS`**  - par ex. `tag1,tag2` .
  * Tags de déploiement définis par l'utilisateur, séparés par des virgules, [utiles pour faciliter la recherche et le filtrage](#filter-deployments).
* **`ARBITRIUM_PRIVATE_FLEET_ID`** - par ex. `PUBLIC_CLOUD` , ou l'ID de la flotte si hébergé sur [Flottes privées](https://docs.edgegap.com/fr/learn/orchestration/flottes-privees.md).

#### Spécifications des ressources

* **`ARBITRIUM_HOST_IN_PRIVATE_FLEET`** - par ex. `false` , indiquant s'il est hébergé sur [Flottes privées](https://docs.edgegap.com/fr/learn/orchestration/flottes-privees.md).
* **`ARBITRIUM_HOST_BASE_CLOCK_FREQUENCY`**  - par ex. `2300` , fréquence du processeur en MHz.
* **`ARBITRIUM_DEPLOYMENT_VCPU_UNITS`**  - par ex. `256`, unités vCPU allouées (1024 = 1 vCPU).
* **`ARBITRIUM_DEPLOYMENT_MEMORY_MB`**  - par ex. `512`, RAM allouée en Mo (1024 = 1 Go).

#### **Gestion du cycle de vie**

* **`ARBITRIUM_DELETE_URL`**  - par ex. `https://api.edgegap.com/v1/self/stop/9f511e17/660`.
  * Appelable depuis le déploiement, [le déploiement sera arrêté proprement](#id-5.-deployment-stopped).
  * Nécessite un jeton unique à usage unique `ARBITRIUM_DELETE_TOKEN` dans `l'en-tête Authorization` .
* **`ARBITRIUM_DELETE_TOKEN`**  - par ex. `7df4cd933df87084b34ae80d8abde293`.
* **`ARBITRIUM_CONTEXT_URL`**  - par ex. `https://api.edgegap.com/v1/context/9170f5211e17/17`.
  * Appelable uniquement depuis le déploiement, renvoie davantage de détails sur le déploiement.
  * Nécessite un `ARBITRIUM_CONTEXT_TOKEN` dans `l'en-tête Authorization` .
* **`ARBITRIUM_CONTEXT_TOKEN`**  - par ex. `dfaf50b9333b9ee07b22ed247e4a17e6`.

#### **Découvrabilité**

* **`ARBITRIUM_PORT_GAMEPORT_INTERNAL`**  - par ex. `7777` , port interne pour l'écoute du serveur.
* **`ARBITRIUM_PORT_GAMEPORT_EXTERNAL`**  - par ex. `31504` , port externe pour les connexions client.
  * Les valeurs de port externe sont randomisées pour chaque déploiement à des fins de sécurité.
* **`ARBITRIUM_PORT_GAMEPORT_PROTOCOL`**  - par ex. `UDP` , protocole de votre transport netcode.

{% hint style="success" %}
Les exemples supposent que vous avez nommé votre port `gameport` (par défaut). **Chaque port ajoute un ensemble supplémentaire de** [Applications et versions](https://docs.edgegap.com/fr/learn/orchestration/application-and-versions.md#port-mapping) **variables :** `@Super Port!` ⇒ `ARBITRIUM_PORT_SUPER_PORT_INTERNAL` .
{% endhint %}

* **`ARBITRIUM_BEACON_ENABLED`**  - par ex. `true`, si déployé sur [Flottes privées](https://docs.edgegap.com/fr/learn/orchestration/flottes-privees.md) avec [Balises de ping](https://docs.edgegap.com/fr/learn/orchestration/ping-beacons.md).
* **`ARBITRIUM_HOST_BEACON_PUBLIC_IP`**  - par ex. `139.177.198.69` , IP publique de la balise la plus proche.
* **`ARBITRIUM_HOST_BEACON_PORT_UDP_EXTERNAL`**  - par ex. `30199`, pour la mesure du ping via UDP.
* **`ARBITRIUM_HOST_BEACON_PORT_TCP_EXTERNAL`**  - par ex. `30456`, pour la mesure du ping via TCP.

#### **Informations structurées (JSON sous forme de chaîne)**

{% hint style="info" %}
Les variables d'environnement sont **stockées sous forme de JSON sérialisé en chaîne**, analysez-les à l'aide d'un SDK ou d'une méthode personnalisée.
{% endhint %}

<details>

<summary><strong><code>ARBITRIUM_DEPLOYMENT_LOCATION</code></strong></summary>

```json
ARBITRIUM_DEPLOYMENT_LOCATION="{
  "city": "Montreal",
  "country": "Canada",
  "continent": "North America",
  "administrative_division": "Quebec",
  "timezone": "Eastern Time",
  "latitude": 45.513707,
  "longitude": -73.619073
}"
```

</details>

<details>

<summary><strong><code>ARBITRIUM_PORTS_MAPPING</code></strong></summary>

```json
ARBITRIUM_PORTS_MAPPING="{
  "ports": {
    "gameport": {
      "name": "Port de jeu",
      "internal": 7777,
      "external": 31504,
      "protocol": "UDP"
    },
    "webport": {
      "name": "Port Web",
      "internal": 8888,
      "external": 31553,
      "protocol": "TCP"
    }
  }
}"
```

</details>

### Supervision du tableau de bord

Notre [Tableau de bord](https://app.edgegap.com/) fournit des utilitaires pour surveiller la scalabilité de votre serveur et aider aux opérations.

#### Analyses

{% hint style="success" %}
Retrouvez [les tableaux de bord d'analytique dans le menu latéral](https://app.edgegap.com/analytics/dashboards/list) sous la catégorie Hébergement et orchestration de serveurs.
{% endhint %}

:star2: [**Passez au niveau Pay as You Go**](https://app.edgegap.com/user-settings?tab=memberships) **pour débloquer des métriques et informations détaillées sur les performances du serveur :**

* **Aperçus généraux :** suivez les versions avec le nombre de serveurs en direct par version + aperçu de l'utilisation des ressources,
* **Aperçus CPU**: dépannez les serveurs ralentis en raison d'opérations gourmandes en processeur,
* **Aperçus mémoire**: atténuez les redémarrages de serveur dus au dépassement de la mémoire allouée,
* **Aperçus réseau :** détectez les schémas réseau inefficaces et optimisez le netcode.

<figure><img src="https://3008966946-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2FLxDp1yFvkj5kB6AC4xVb%2Fimage.png?alt=media&amp;token=c0eff5f1-a374-41e0-a49a-9b3ecf0bfd1b" alt=""><figcaption></figcaption></figure>

#### Carte de déploiement

{% hint style="success" %}
Trouvez la carte de déploiement dans [la page des détails de votre déploiement sur le tableau de bord](https://app.edgegap.com/deployment-management/deployments/list).
{% endhint %}

Prévisualisez sur la carte l'emplacement de déploiement, les emplacements disponibles et les emplacements estimés des joueurs :

<figure><img src="https://3008966946-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2FM4h0itPU5ntPaV5N5ZlW%2Fimage.png?alt=media&amp;token=98028901-9a40-4a2d-969e-db5f990e334f" alt=""><figcaption></figcaption></figure>

#### Points d'équilibre du déploiement

{% hint style="success" %}
Trouvez la carte thermique des points d'équilibre du déploiement dans [la page des détails de votre application sur le tableau de bord](https://app.edgegap.com/application-management/applications/list).
{% endhint %}

Prévisualisez la carte thermique des points d'équilibre du déploiement et filtrez par [Applications et versions](https://docs.edgegap.com/fr/learn/orchestration/application-and-versions.md). Les points d'équilibre sont des emplacements approximatifs avec une proximité réseau égale pour chaque joueur dans un déploiement donné :

<figure><img src="https://3008966946-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2FfDpIQxoFUJZNE77LJIwZ%2Fimage.png?alt=media&amp;token=94e730ad-3907-486b-8a06-0f469acd19ea" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Les points chauds des points d'équilibre dans des endroits étranges (par ex. le Groenland) indiquent un matchmaking de joueurs éloignés les uns des autres. En savoir plus sur [#connection-quality](#connection-quality "mention") et [Balises de ping](https://docs.edgegap.com/fr/learn/orchestration/ping-beacons.md) pour optimiser votre matchmaking.
{% endhint %}

#### Journaux de déploiement

{% hint style="success" %}
Trouvez les journaux de déploiement dans [la page des détails de votre déploiement sur le tableau de bord](https://app.edgegap.com/deployment-management/deployments/list).
{% endhint %}

Les journaux de déploiement affichent des informations sur [#deployment-lifecycle](#deployment-lifecycle "mention"):

<figure><img src="https://3008966946-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2FfkyAYtylnOFmSp3yyiId%2Fimage.png?alt=media&amp;token=6a4f6ac4-5780-46a7-bcdd-1d8829c4abd7" alt=""><figcaption></figcaption></figure>

#### Journaux du conteneur

{% hint style="success" %}
Trouvez les journaux du conteneur dans [la page des détails de votre déploiement sur le tableau de bord](https://app.edgegap.com/deployment-management/deployments/list).
{% endhint %}

Inspectez les journaux de votre serveur de jeu en cas de problème, ou lors du débogage :

<figure><img src="https://3008966946-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2Fpzg50T3fCNQ4Q8brGsQ4%2Fimage.png?alt=media&amp;token=f248fe9a-4f34-4f97-b549-cf271332ea3c" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
**Une fois le déploiement arrêté, les journaux du conteneur sont supprimés.** Configurez [un stockage de journaux S3 tiers](https://docs.edgegap.com/fr/docs/endpoint-storage.md) pour enregistrer les journaux.
{% endhint %}

#### Métriques du conteneur

{% hint style="success" %}
Trouvez les métriques du conteneur dans [la page des détails de votre déploiement sur le tableau de bord](https://app.edgegap.com/deployment-management/deployments/list).
{% endhint %}

Examinez les métriques du conteneur (processeur, mémoire, réseau) pour :

* identifier les problèmes de connexion courants lorsque [#troubleshooting](#troubleshooting "mention"),
* détecter des schémas d'implémentation inefficaces provoquant des pics d'utilisation des ressources,
* identifier une utilisation inefficace des ressources dans des scénarios particuliers,
* vérifier les changements dans l'utilisation des ressources de votre serveur pendant l'optimisation,
* étalonner la consommation de ressources et la durée d'initialisation de votre serveur.

Les métriques historiques affichent des moyennes de valeurs avec une période de 1 minute, disponibles dans le niveau Gratuit.

:star2: [**Passez au niveau Pay as You Go**](https://app.edgegap.com/user-settings?tab=memberships) **pour débloquer des métriques précises avec des intervalles de 1 seconde.**

<figure><img src="https://3008966946-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2FoIpCR3x9ibiXMEIWFgKG%2Fimage.png?alt=media&amp;token=86dcd914-db9f-4e81-8444-6c83805be9b6" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
[Contactez-nous](mailto:info@edgegap.com) avant votre lancement pour demander une assistance d'hébergement en direct pour les lancements à grande échelle.
{% endhint %}

### Contexte et statut

Des informations supplémentaires sur le déploiement peuvent être récupérées au format JSON :

* depuis l'intérieur du déploiement (serveur de jeu), en utilisant [API de contexte de déploiement](https://docs.edgegap.com/api/#tag/Context/operation/context-get),
* depuis l'extérieur du déploiement (backend / tiers), en utilisant [API d'état du déploiement](https://docs.edgegap.com/api/#tag/Deployments/operation/deployment-status-get).

{% hint style="info" %}
L'API de contexte (depuis le déploiement) nécessite le jeton de l'API Context, tandis que l'API d'état utilise votre jeton Edgegap.
{% endhint %}

{% hint style="danger" %}
**Trop de requêtes 429 - les API Context et Status sont limitées à 20 requêtes/s par organisation.** Ces API sont destinées à être utilisées pendant des opérations spéciales, et non pour l'orchestration automatisée de sessions.
{% endhint %}

{% hint style="success" %}
**Utilisez** [#webhooks](#webhooks "mention") **pour l'orchestration personnalisée des sessions afin d'éviter la limitation de débit et garantir l'évolutivité.**
{% endhint %}

### Filtrer les déploiements

Pour rechercher rapidement parmi tous les déploiements, vous pouvez [utiliser notre tableau de bord](https://app.edgegap.com/deployment-management/deployments/list):

<figure><img src="https://3008966946-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2F42IaKG0pFQXSkvPCRH1T%2Fimage.png?alt=media&amp;token=6aba8781-13c9-4c0f-87e9-2d9612a57342" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
Alternativement, laissez les joueurs **choisir un serveur persistant (toujours en ligne)** d'une liste avec [Navigateur de serveurs](https://docs.edgegap.com/fr/learn/navigateur-de-serveurs.md).
{% endhint %}

[Lister les déploiements avec l'API](https://docs.edgegap.com/api/#tag/Deployments/operation/deployments-get) et appliquer des filtres avec les intégrations backend :

<table><thead><tr><th width="237">Attribut de déploiement</th><th width="193">Opérateurs</th><th>Exemple de valeur</th></tr></thead><tbody><tr><td><a href="https://docs.edgegap.com/fr/learn/orchestration/deployments.md#deployment-lifecycle"><code>status</code></a></td><td><a data-footnote-ref href="#user-content-fn-2"><code>eq</code></a>  ou <a data-footnote-ref href="#user-content-fn-3"><code>neq</code></a></td><td><code>"ready"</code> ou <code>"error"</code></td></tr><tr><td><a href="#observability"><code>request_id</code></a></td><td><a data-footnote-ref href="#user-content-fn-2"><code>eq</code></a> </td><td><a data-footnote-ref href="#user-content-fn-4"><code>"7e709a0d8efd"</code></a></td></tr><tr><td></td><td><a data-footnote-ref href="#user-content-fn-5"><code>dans</code></a>  ou <a data-footnote-ref href="#user-content-fn-6"><code>nin</code></a></td><td><a data-footnote-ref href="#user-content-fn-4"><code>[ "7e709a0d8efd", "4ba353100b4b" ]</code></a></td></tr><tr><td><a href="#discoverability"><code>tags</code></a></td><td><a data-footnote-ref href="#user-content-fn-2"><code>eq</code></a>  ou <a data-footnote-ref href="#user-content-fn-3"><code>neq</code></a></td><td><code>"tagA"</code></td></tr><tr><td></td><td><a data-footnote-ref href="#user-content-fn-5"><code>dans</code></a>  ou <a data-footnote-ref href="#user-content-fn-6"><code>nin</code></a></td><td><code>[ "tagA", "tagB" ]</code></td></tr><tr><td><a href="#id-1.-start-a-deployment"><code>created_at</code></a></td><td><a data-footnote-ref href="#user-content-fn-2"><code>eq</code></a>  ou <a data-footnote-ref href="#user-content-fn-7"><code>lte</code></a>  ou <a data-footnote-ref href="#user-content-fn-8"><code>gte</code></a></td><td><a href="https://en.wikipedia.org/wiki/ISO_8601"><code>2025-05-12T20:03:20Z</code></a></td></tr><tr><td><a href="https://docs.edgegap.com/fr/learn/orchestration/application-and-versions.md"><code>application</code></a></td><td><a data-footnote-ref href="#user-content-fn-2"><code>eq</code></a>  ou <a data-footnote-ref href="#user-content-fn-3"><code>neq</code></a></td><td><code>"my-app"</code></td></tr><tr><td></td><td><a data-footnote-ref href="#user-content-fn-5"><code>dans</code></a>  ou <a data-footnote-ref href="#user-content-fn-6"><code>nin</code></a></td><td><code>[ "my-app", "my-other-app" ]</code></td></tr><tr><td><a href="https://docs.edgegap.com/fr/learn/orchestration/application-and-versions.md"><code>version</code></a></td><td><a data-footnote-ref href="#user-content-fn-2"><code>eq</code></a>  ou <a data-footnote-ref href="#user-content-fn-3"><code>neq</code></a></td><td><code>"1.0.0"</code></td></tr><tr><td></td><td><a data-footnote-ref href="#user-content-fn-9"><code>dans</code></a>  ou <a data-footnote-ref href="#user-content-fn-6"><code>nin</code></a></td><td><code>[ "1.0.0", "prod" ]</code></td></tr><tr><td><a href="https://docs.edgegap.com/fr/learn/orchestration/flottes-privees.md"><code>fleet_name</code></a></td><td><a data-footnote-ref href="#user-content-fn-2"><code>eq</code></a>  ou <a data-footnote-ref href="#user-content-fn-3"><code>neq</code></a></td><td><code>"my-app-fleet-europe"</code></td></tr><tr><td></td><td><a data-footnote-ref href="#user-content-fn-5"><code>dans</code></a>  ou <a data-footnote-ref href="#user-content-fn-6"><code>nin</code></a></td><td><code>[ "fleet-eu", "fleet-us" ]</code></td></tr><tr><td></td><td><a data-footnote-ref href="#user-content-fn-10"><code>ilike</code></a></td><td><code>"%-eu%"</code></td></tr><tr><td><a href="https://docs.edgegap.com/fr/learn/orchestration/flottes-privees.md"><code>host_name</code></a></td><td><a data-footnote-ref href="#user-content-fn-2"><code>eq</code></a>  ou <a data-footnote-ref href="#user-content-fn-3"><code>neq</code></a></td><td><code>"alpha-north-america-95fab093"</code></td></tr><tr><td></td><td><a data-footnote-ref href="#user-content-fn-5"><code>dans</code></a>  ou <a data-footnote-ref href="#user-content-fn-6"><code>nin</code></a></td><td><code>[ "alpha-north-america-95fab093" ]</code></td></tr><tr><td></td><td><a data-footnote-ref href="#user-content-fn-10"><code>ilike</code></a></td><td><code>"%north-america%"</code></td></tr></tbody></table>

{% hint style="info" %}
Chaque attribut peut avoir au maximum 1 opérateur de filtre dans une seule requête. Voir [Référence de l’API](https://docs.edgegap.com/fr/docs/api.md) pour plus d'informations.
{% endhint %}

Triez les résultats par plusieurs champs dans l'ordre dans lequel ils apparaissent dans la requête :

| Attribut de déploiement                                                                | Ordre                                                                   |
| -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------- |
| [`created_at`](#id-1.-start-a-deployment)                                              | [`asc`](#user-content-fn-11)[^11] ou [`desc`](#user-content-fn-12)[^12] |
| [`available_session_sockets`](broken://pages/dd71be7f2a95f8fbefe2dda78022306ba0259251) | [`asc`](#user-content-fn-13)[^13] ou [`desc`](#user-content-fn-14)[^14] |

Exemples de requêtes de filtre :

<details>

<summary>Lister <a href="#id-4.-deployment-error">Déploiements en erreur</a> pour dépanner et supprimer.</summary>

URL encodée :

```
https://api.edgegap.com/v1/deployments?query={"filters":[{"field":"status","operator":"eq","value":"error"},{"field":"application","operator":"eq","value":"my-app"},{"field":"version","operator":"eq","value":"green"}],"order_by":[{"field":"created_at","order":"desc"}]}
```

Requête JSON formatée :

```json
{
  "filters": [
    {
      "field": "status",
      "operator": "eq",
      "value": "error"
    },
    {
      "field": "application",
      "operator": "eq",
      "value": "my-app"
    },
    {
      "field": "version",
      "operator": "eq",
      "value": "green"
    }
  ],
  "order_by": [
    {
      "field": "created_at",
      "order": "desc"
    }
  ]
}
```

</details>

<details>

<summary>Lister <a href="https://docs.edgegap.com/fr/learn/matchmaking/matchmaker-in-depth.md#rolling-updates-and-ab-tests">Déploiements avec une version d'application obsolète</a> pour confirmer qu'une version est terminée.</summary>

URL encodée :

```
https://api.edgegap.com/v1/deployments?query={"filters":[{"field":"status","operator":"eq","value":"ready"},{"field":"application","operator":"eq","value":"my-app"},{"field":"version","operator":"eq","value":"blue"}],"order_by":[{"field":"created_at","order":"desc"}]}
```

Requête JSON formatée :

```json
{
  "filters": [
    {
      "field": "status",
      "operator": "eq",
      "value": "ready"
    },
    {
      "field": "application",
      "operator": "eq",
      "value": "my-app"
    },
    {
      "field": "version",
      "operator": "eq",
      "value": "blue"
    }
  ],
  "order_by": [
    {
      "field": "created_at",
      "order": "desc"
    }
  ]
}
```

</details>

{% hint style="success" %}
N'oubliez pas d'ajouter le `l'en-tête Authorization` en-tête avec votre jeton API Edgegap dans la requête.
{% endhint %}

### Webhooks

Recevez de simples notifications HTTP dans le backend de votre jeu pour les changements de [#deployment-lifecycle](#deployment-lifecycle "mention") en spécifiant une URL de webhook dans votre [requête API de déploiement](https://docs.edgegap.com/fr/docs/api/serveurs-dedies.md#post-deployments). Disponible pour :

* À l'état Prêt : conteneur de déploiement [démarré avec succès](#id-1.-start-a-deployment) (le serveur commence son initialisation après cela).
* En cas d'erreur : le déploiement n'a pas pu être lancé et une [#id-4.-deployment-error](#id-4.-deployment-error "mention") s'est produite.
* À la terminaison : [#id-5.-deployment-stopped](#id-5.-deployment-stopped "mention") et le serveur de jeu n'est plus joignable.

Les webhooks Ready et Error ne seront jamais déclenchés pour le même déploiement.

<details>

<summary>Exemple de charge utile de webhook</summary>

```json
{
  "request_id": "f68e011bfb01",
  "application": "my-game-server",
  "version": "2024.01.30-16.23.00-UTC",
  "fqdn": "f68e011bfb01.pr.edgegap.net",
  "public_ip": "162.254.141.66",
  "deployed_at": "2026-02-10T20:35:48Z",
  "termination_scheduled_at": "2026-02-10T21:35:48Z",
  "ports": {
    "gameport": {
      "external": 31504,
      "internal": 7777,
      "protocol": "UDP",
      "name": "gameport",
      "tls_upgrade": false,
      "link": "f68e011bfb01.pr.edgegap.net:31504",
      "proxy": null
    }
  },
  "location": {
    "city": "Montreal",
    "country": "Canada",
    "continent": "North America",
    "administrative_division": "Quebec",
    "timezone": "Eastern Time",
    "latitude": 45.513707,
    "longitude": -73.619073
  },
  "tags": [
    "tag1",
    "tag2"
  ],
  "host_id": "alpha-north-america-70364ef8",
  "host_in_private_fleet": false,
  "private_fleet_id": "PUBLIC_CLOUD",
  "vcpu_units": 256,
  "memory_mib": 512
}
```

</details>

{% hint style="success" %}
**Les webhooks sont la méthode principale recommandée pour les intégrations de déploiement backend personnalisées.**
{% endhint %}

{% hint style="warning" %}
**Les webhooks ne sont pas relancés**et peuvent être perdus si votre backend ne traite pas la requête en raison d’une limitation de débit ou d’une erreur. Revenez à l’API Status au cas où vous ne recevriez pas de webhook dans le délai attendu.
{% endhint %}

{% hint style="info" %}
Les webhooks suivent le cycle de vie du déploiement, mais ne connaissent pas l’état d’initialisation de votre scène/niveau. Pour suivre la progression du chargement de votre scène/niveau, implémentez un webhook personnalisé dans votre serveur de jeu.
{% endhint %}

## 🚨 Dépannage

Lors du dépannage des déploiements :

1. vérifiez qu’il n’y a aucune erreur dans votre [#deployment-logs](#deployment-logs "mention") et [#container-logs](#container-logs "mention"),
2. exécutez votre serveur localement pour éliminer les bugs d’intégration,
3. consultez les étapes de dépannage sur cette page,
4. contactez-nous sur [Discord de la communauté](https://discord.gg/MmJf8fWjnt) et incluez l’ID de votre déploiement.

{% hint style="info" %}
Voir [#player-issue-resolution](#player-issue-resolution "mention") pour découvrir nos recommandations sur la gestion des retours de la communauté des joueurs.
{% endhint %}

<details>

<summary>Impossible de connecter les clients au serveur - <code>Délai de requête dépassé.</code>, <code>请求超时</code> , <code>Connexion échouée</code> , ou <code>Vérification du port échouée</code>.</summary>

* Tout d’abord, assurez-vous que le déploiement est prêt et qu’il n’y a aucune exception d’exécution ni erreur dans le journal de votre déploiement. Si votre déploiement s’est arrêté, inspectez les journaux dans notre [Tableau de bord](https://app.edgegap.com/deployment-management/deployments/list).
* Si vous utilisez le netcode Mirror, vous devez avoir [« Auto Start Server »](https://mirror-networking.gitbook.io/docs/hosting/edgegap-hosting-plugin-guide#build-and-push) sélectionné dans votre `NetworkManager` puis reconstruisez, envoyez et redéployez votre serveur.
* Si vous utilisez le netcode FishNet, vous devez activer [« Start on Headless »](https://fish-networking.gitbook.io/docs/manual/components/managers/server-manager#settings-are-general-settings-related-to-the-servermanager) dans votre `ServerManager`puis reconstruisez, envoyez et redéployez votre serveur.
* Si vous utilisez le netcode Photon Fusion 2, veuillez vous assurer que votre serveur transmet l’IP publique du déploiement, le port externe et le `roomCode` sur le serveur, ainsi que le même code de salle dans le client dans le [« NeworkRunner.StartGame »](https://doc.photonengine.com/fusion/current/manual/network-runner#creating-or-joining-a-room) paramètre `StartGameArgs`. L’ID de déploiement (par ex. `b63e6003b19f`) est un excellent choix, car il est globalement unique et facilement accessible au client via [Matchmaker](https://docs.edgegap.com/fr/learn/matchmaking/matchmaker-in-depth.md) l’affectation et à [Analyse approfondie](https://docs.edgegap.com/fr/learn/matchmaking/matchmaker-in-depth.md#injected-environment-variables).
* Ensuite, veuillez vérifier que le paramètre de port dans les réglages de netcode de votre build serveur correspond au port interne dans votre [version de l’application](https://app.edgegap.com/application-management/applications/list). Vous pouvez modifier le mappage des ports en éditant le [version de l’application](https://app.edgegap.com/application-management/applications/list) sans reconstruire. Trouvez votre protocole dans votre intégration de netcode.
* Veuillez vous assurer que votre client de jeu se connecte au **port externe** indiqué sur la page des détails de votre déploiement ; cette valeur sera toujours randomisée pour des raisons de sécurité.
* Si vous utilisez le protocole Secure Websocket (WSS) dans votre intégration de netcode, veuillez vous assurer que votre [version de l’application](https://app.edgegap.com/application-management/applications/list) configuration de port pour le port WSS a la mise à niveau TLS activée.
* Êtes-vous situé en Chine et utilisez-vous [Smart Fleets](https://docs.edgegap.com/docs/deployment/session/fleet-manager/fleet)? Votre connexion peut être bloquée par le Grand Pare-feu. Envisagez d’ajouter à votre flotte un serveur situé en Chine, ou d’utiliser un VPN pour vous connecter.

</details>

<details>

<summary>Mon déploiement s’est arrêté/redémarré et je ne peux plus accéder à ses journaux.</summary>

* Si le processus du serveur plante à cause d’une exception, notre système tentera de redémarrer automatiquement le serveur. Envisagez de tester votre serveur localement pour en découvrir la cause racine.
* Nous conservons les journaux uniquement pendant la durée du déploiement ; si vous souhaitez consulter les journaux après l’arrêt du déploiement, veuillez [intégrer un stockage de journaux tiers](https://docs.edgegap.com/docs/deployment/endpoint-storage).
* Voir [#id-5.-deployment-stopped](#id-5.-deployment-stopped "mention") pour découvrir toutes les causes de l’arrêt de votre déploiement.

</details>

<details>

<summary>Mon déploiement s’est arrêté automatiquement après X minutes.</summary>

* Les déploiements du niveau gratuit ont une limite de 60 minutes ; veuillez envisager de mettre à niveau votre compte.
* Les déploiements cloud seront arrêtés après 24 heures d’exécution, conformément à notre politique de nettoyage des serveurs, pour la maintenance de l’infrastructure, et afin d’éviter d’engendrer des coûts inattendus lorsqu’un déploiement n’a pas été arrêté correctement. Pour les serveurs longue durée de plus de 24 heures, envisagez d’utiliser [Flottes privées](https://docs.edgegap.com/fr/learn/orchestration/flottes-privees.md) avec [Persistance](https://docs.edgegap.com/fr/learn/orchestration/persistance.md).
* Voir [#id-5.-deployment-stopped](#id-5.-deployment-stopped "mention") pour découvrir toutes les causes de l’arrêt de votre déploiement.

</details>

<details>

<summary>Mon déploiement est prêt, mais je ne peux pas me connecter pendant plusieurs minutes ensuite.</summary>

* Une fois qu’un déploiement est prêt, l’initialisation de votre moteur de jeu commence. Ce processus peut prendre de quelques secondes à quelques minutes, et le serveur n’accepte pas les connexions des joueurs pendant cette période.
* Envisagez d’optimiser l’initialisation de votre serveur pour réduire cette durée.
* Les clients de jeu doivent retenter la connexion toutes les 1 seconde pendant une durée limitée (selon la durée de votre initialisation), après quoi ils reviennent au matchmaking.
* Envisagez d’ajouter une scène de chargement afin que le serveur puisse effectuer l’initialisation (et le déplacement dans le cas d’Unreal Engine) en même temps que les clients, tout en synchronisant l’état des deux.

</details>

<details>

<summary>Mon appareil Meta Quest renvoie <code>HTTP 0 : impossible de résoudre l’hôte de destination</code> .</summary>

* Lors de la création de versions Unity pour la cible Android, l’autorisation d’accès à Internet peut être supprimée automatiquement de l’artefact APK de build du client en sortie.
* Réajoutez les autorisations dans (nécessite de reconstruire le client ensuite) :
  * Paramètres du projet / OpenXR / :gear: Support Meta Quest / Forcer la suppression des autorisations Internet (décocher).
  * Paramètres du joueur / Accès à Internet (définir sur requis).

</details>

<details>

<summary>Que se passera-t-il si un joueur quitte mon déploiement ?</summary>

* Par défaut, les serveurs ne rejettent pas les connexions des joueurs. L’authentification des joueurs dépend de vos développeurs, car de nombreuses méthodes et de nombreux fournisseurs d’authentification des joueurs peuvent être utilisés.
* Les clients de jeu peuvent stocker localement les informations de connexion afin de tenter une reconnexion en cas de plantage inattendu du client.
* Pour permettre aux joueurs de rejoindre des parties en cours, envisagez d’utiliser [Analyse approfondie](https://docs.edgegap.com/fr/learn/matchmaking/matchmaker-in-depth.md#backfill) ou [Sessions](https://docs.edgegap.com/docs/deployment/session).

</details>

<details>

<summary>Mon serveur affiche une utilisation du CPU de 100 % après être devenu prêt.</summary>

* Ce n’est peut-être pas un problème, car les moteurs de jeu ont tendance à effectuer des opérations gourmandes en CPU lors de l’initialisation du serveur. Si l’utilisation du CPU ne redescend pas après 2 à 3 minutes suivant le démarrage du déploiement, vous devrez peut-être optimiser votre serveur ou augmenter les ressources de la version de l’application.
* Réduire le tick rate peut avoir un impact sur l’utilisation du CPU, car le serveur effectue moins d’opérations de messagerie.
* Si vous utilisez le netcode Mirror, vous devez avoir [« Auto Start Server »](https://mirror-networking.gitbook.io/docs/hosting/edgegap-hosting-plugin-guide#build-and-push) sélectionné dans votre `NetworkManager` puis reconstruisez, envoyez et redéployez votre serveur.
* Si vous utilisez le netcode FishNet, vous devez activer [« Start on Headless »](https://fish-networking.gitbook.io/docs/manual/components/managers/server-manager#settings-are-general-settings-related-to-the-servermanager) dans votre `ServerManager`puis reconstruisez, envoyez et redéployez votre serveur.
* Vous êtes limité à 1,5 vCPU et 3 Go de mémoire (RAM) dans le niveau gratuit.
* Vous pouvez augmenter les ressources allouées lors de la création d’une nouvelle version de l’application. Vous pouvez dupliquer votre version de l’application dans notre tableau de bord et ajuster ces valeurs selon vos besoins, sans reconstruire votre serveur ou votre image.

</details>

<details>

<summary>Mon déploiement redémarre en boucle et affiche l’erreur `OOM kill` .</summary>

* Ce comportement est causé par le dépassement de la quantité de mémoire allouée. Envisagez d’optimiser l’utilisation de la mémoire avec du pooling d’objets, de la compression ou la suppression des objets inutiles dans votre scène.
* Assurez-vous que votre projet charge la scène par défaut contenant votre `NetworkManager` et que la scène est incluse dans les Build Settings de Unity.
* Vous êtes limité à 1,5 vCPU et 3 Go de mémoire (RAM) dans le niveau gratuit.
* Vous pouvez augmenter les ressources allouées lors de la création d’une nouvelle version de l’application. Vous pouvez dupliquer votre version de l’application dans notre tableau de bord et ajuster ces valeurs selon vos besoins, sans reconstruire votre serveur ou votre image.

</details>

<details>

<summary>Parfois, l’utilisation de la mémoire (RAM) de mon serveur grimpe à une valeur élevée, est-ce un problème ?</summary>

* Tant que vous restez dans la quantité de mémoire allouée à la version de l’application, ce n’est pas un problème.&#x20;
* Dépasser la quantité de mémoire allouée à la version de l’application entraînera un \`OOM kill\` (voir ci-dessus).

</details>

<details>

<summary>Les performances de mon serveur seront-elles affectées par d’autres serveurs exécutés sur la même machine ?</summary>

* Non, notre plateforme garantit que les ressources allouées ne seront pas utilisées par d’autres studios, ni par d’autres serveurs sur une infrastructure partagée. Avec Edgegap, il n’y a pas de voisins bruyants.

</details>

[^1]: les sessions peuvent durer jusqu'à 24 heures

[^2]: égal à

[^3]: différent de

[^4]: request\_id (identifiant de déploiement)

[^5]: dans un tableau

[^6]: pas dans un tableau

[^7]: inférieur ou égal à

[^8]: supérieur ou égal à

[^9]: &#x20;dans un tableau

[^10]: correspondance de modèle insensible à la casse :

    * utilisez `%`  pour n'importe quelle séquence
    * utilisez `_`  pour n'importe quel caractère

[^11]: croissant, les plus anciens d'abord

[^12]: décroissant, les plus récents d'abord

[^13]: croissant, les plus pleins d'abord

[^14]: décroissant, les plus vides d'abord
