Une seule lecture rassemble ce qui se règle sur un service, et trois écritures le
changent. Ces routes ne valent que pour ce qui tourne sur notre daemon : serveurs de jeu
et applications, bases de données comprises.
Tout lire
kind vaut image quand l’image vient du registre ou du catalogue, runtime quand
c’est une édition maison (un serveur de jeu). Les bornes cpuMin…storageMaxGb sont
celles du nœud qui héberge : elles décident ce que PUT /scale acceptera.
Réseau
Fermé, le service garde son port réservé et reste joignable par ses voisins du projet
sous son alias — rien n’est publié sur le nœud. Ouvert, il répond sur
publicIp:publicPort.
Ouvrir alors qu’aucun port n’est encore réservé en prend un sur l’IP partagée du nœud.
S’il n’y en a plus, la route rend un 409.
Un changement de réseau refait le conteneur : le service s’arrête et redémarre, parce
que Docker fige les ports publiés à la création. La route ne rend la main qu’une fois
l’opération faite. Un service déjà arrêté n’est pas démarré pour l’occasion : il prendra
le réglage à son prochain démarrage.
Taille
Les trois champs sont obligatoires : envoie la taille voulue en entier, pas un delta.
- Les valeurs doivent tenir dans les bornes du nœud, sinon
400.
- Le disque ne se réduit pas : tes fichiers y sont. Demander moins rend un
400.
- Le tarif est recalculé aux tarifs du nœud et court dès l’instant de l’appel. La
facturation en cours est soldée à l’ancien tarif avant l’écriture, pour que la tranche
non facturée ne change pas de prix rétroactivement.
- Un service gratuit ou suspendu ne se retaille pas :
scale.lockedReason dit pourquoi.
Processeur et mémoire s’appliquent à chaud, sans redémarrage. Un processus qui a lu
sa mémoire à son démarrage — une JVM et son -Xmx, par exemple — garde son idée jusqu’à
son prochain redémarrage : c’est la limite du cgroup qui bouge, pas ce qu’il en a déduit.
Commande de démarrage
La ligne lancée dans le conteneur, appliquée au prochain démarrage. Une chaîne vide
rétablit celle d’origine — deploy.defaultCommand la donne quand elle existe.
Changer de projet
Le service rejoint le réseau privé du projet visé et quitte l’ancien. Son alias ne change
pas, mais ses anciens voisins ne le joignent plus. 
