Changer les ports
Les trois interfaces HTTPS ont des ports indépendants, configurables dans les YAML des composants :
| Interface | Clé YAML | Port par défaut | Exemple ci-dessous |
|---|---|---|---|
| Frontend | smartagt.http.server.port dans le YAML du Frontend |
9000 |
19000 |
| API Publique | smartagt.http.public.port dans le YAML du Backend |
8000 |
18000 |
| AI Gateway | smartagt.gateway.server.port dans le YAML du Backend |
8001 |
18001 |
Un changement de port conserve les certificats : leur SAN porte sur le nom DNS ou l'adresse IP, pas sur le port. Pour changer aussi les certificats, voir Installer vos certificats.
Prérequis
- Composants installés et accès à leurs fichiers YAML.
- Ports choisis libres sur les adresses d'écoute, entre
1et65535, et autorisés par le système pour les comptes des services. - Accès aux règles de pare-feu et aux éventuels proxies ou load balancers.
Sauvegardez les YAML avant modification. L'exemple modifie les trois ports ; appliquez seulement les changements souhaités et fusionnez les clés dans les blocs existants.
Procédure
1. Modifier les YAML
Dans /app/config/backend/smartagt-backend-core.yaml :
smartagt:
http:
public:
port: 18000
gateway:
server:
port: 18001
Dans /app/config/bff/smartagt-bff-core.yaml :
smartagt:
http:
server:
port: 19000
backend:
base_url: "https://localhost:18000"
cors:
allow_origins:
- "https://smartagt.example.test:19000"
Sous Windows, les fichiers sont sous C:\app\config\backend\ et C:\app\config\bff\. Conservez les réglages d'adresse d'écoute et TLS déjà adaptés à votre installation.
backend.base_url désigne l'API Publique utilisée pour le rattachement et la découverte du lien interne. Si elle est sur un autre serveur, remplacez localhost par son nom joignable depuis le Frontend. Si son port public est conservé derrière un load balancer, conservez cette URL.
L'origine CORS correspond à l'adresse vue par le navigateur. Si un reverse proxy reste sur 443, conservez https://smartagt.example.test, même si le Frontend passe à 19000 derrière lui. Si l'accès direct change, adaptez l'origine, en conservant les autres accès nécessaires : CORS.
Résultat attendu : chaque port souhaité est déclaré une seule fois, dans le YAML du bon composant.
2. Adapter les accès et redémarrer
| Élément concerné | Action |
|---|---|
| Pare-feu | Autoriser les nouveaux ports pour leurs seuls clients prévus. |
| Proxy ou load balancer | Adapter les ports des nœuds et des contrôles de santé. Un port interne peut changer sans modifier le port public. |
| Adresse publique du Frontend | Si elle change, actualiser l'URL publique de l'installation et les accès utilisateurs. Pour le SSO, vérifier aussi la liste d'origines du Backend et les URL de retour du fournisseur : CORS. |
| Clients de l'API Publique | Reporter son nouveau port dans leur URL et dans http.backend.base_url des Frontends concernés. |
| Clients AI Gateway | Si l'adresse publique change, adapter l'URL publique dans IA Factory > AI Gateway, ainsi que les URL des outils raccordés. |
Redémarrez les services modifiés : Exploitation. En cluster, reportez les YAML sur les nœuds concernés et coordonnez leur redémarrage avec la modification des ports dans les load balancers.
Les interfaces internes 8010 et 8011 suivent une configuration distincte. Cette procédure ne les modifie pas : voir Configuration.
3. Vérifier
Ouvrez le Frontend à sa nouvelle adresse dans Chrome et Edge : certificat reconnu, connexion, rechargement de la page et déconnexion doivent fonctionner. Testez ensuite un appel authentifié à l'API Publique et à AI Gateway, avec leurs nouvelles adresses et la validation TLS active.
Vérifiez que les services n'écoutent plus sur leurs anciens ports, puis retirez les anciennes règles réseau devenues inutiles. Une page accessible suivie d'un refus à la connexion appelle un contrôle de l'origine CORS.
Pour revenir aux anciens ports, restaurez les YAML sauvegardés, les adresses publiques, les URL clientes et les règles réseau correspondantes. Redémarrez les services concernés et rejouez ces vérifications.