Network

La section network definit comment l’application est exposee sur Internet.

Configuration de base

network:
  - name: app
    services:
      - name: web
        port: 8080
        path: /

Si network est omis, le deployer cree automatiquement un reseau par defaut a partir du port expose par l’image Docker.

Proprietes

Champ	Type	Defaut	Description
name	string	requis	Nom du reseau (utilise dans les noms de ressources)
isPublic	boolean	false	Acces public (pas de whitelist IP). Force false en non-prod.
host	string	—	Hostname complet (utilise en prod). Ex: api.homeserve.fr
hostPrefix	string	—	Prefixe DNS personnalise. Ex: www, api
fromToWWW	boolean	true	Active la redirection www (www <-> non-www)
aliases	string[]	[]	Hostnames supplementaires
services	object[]	—	Services backend (port, path)
whitelistRange	object[]	[]	Plages IP autorisees (en plus des IPs Homeserve globales)
seo4ajax	object	—	Configuration SEO4Ajax (pre-rendering pour bots)
cors	object	—	Override CORS (voir CORS & Securite)
timeout	object	—	Override timeouts (voir Gateway API)
rateLimit	object	—	Rate limiting par route
retry	object	—	Politique de retry automatique
loadBalancer	string	—	Algorithme de load balancing
responseHeaders	object	—	Manipulation des headers de reponse
requestHeaders	object	—	Manipulation des headers de requete
urlRewrite	object	—	Reecriture d’URL
urlRedirects	object[]	[]	Redirections d’URL (path)
dnsRedirections	string[]	[]	Domaines rediriges vers ce reseau

Services

Chaque reseau contient un ou plusieurs services backend :

network:
  - name: app
    services:
      - name: web
        port: 8080        # Port du container
        path: /            # Path prefix pour le routing

Champ	Type	Defaut	Description
name	string	requis	Nom du service
port	integer	80	Port du container (80-65534)
path	string	/	Prefix de path pour le routing

Visibilite publique

# App privee (defaut) -- accessible uniquement depuis les IPs Homeserve
network:
  - name: app
    isPublic: false

# App publique -- accessible depuis Internet
network:
  - name: app
    isPublic: true

En non-prod, isPublic est toujours force a false.

Whitelist IP personnalisee

network:
  - name: app
    whitelistRange:
      - name: partenaire-x
        cidrs:
          - 203.0.113.0/24
          - 198.51.100.42

Les CIDRs sont additionnes aux IPs Homeserve globales (chargees depuis Vault).

Hostname personnalise (production)

network:
  - name: app
    host: api.homeserve.fr         # Utilise en prod
    hostPrefix: api                 # Utilise en preview/staging
    aliases:
      - api.homeserve.be

• Preview/Staging : {name}-{branch}.homeserve.io ou {hostPrefix}-{name}-{branch}.homeserve.io
• Production : host directement

SEO4Ajax

Pre-rendering pour les moteurs de recherche :

network:
  - name: app
    seo4ajax:
      key: "votre-cle-api"
      path: "/questions-frequentes"   # Optionnel -- prefixe de path

---

Voir aussi : Toutes les proprietes | Gateway API | CORS & Securite