Protocoles internes · 0.1.0
Frontières des services internes
Les protocoles d’analyseur, de mise à jour et de connecteur Advisor sont documentés séparément de l’API de contrôle.
La référence de l’API est en anglais.
Ces protocoles relient les composants de l’installation. Ce sont des interfaces d’implémentation, pas des endpoints d’intégration tiers pris en charge. Utilisez l’API de contrôle avec les droits client prévus pour les workflows applicatifs.
Donner une responsabilité précise à chaque service
Coordinateur
- Worker de jobs
Possède l’opération durable côté contrôle et les liaisons exactes aux services.
Protocoles distincts
- Protocole d’analyseur
Runs bornés, constats paginés et acquittement explicite du résultat.
- Protocole de mise à jour
Préparation et réconciliation de composants examinés sans accès aux sources de projet.
- Protocole du connecteur Advisor
Travail fournisseur lié aux autorisations, destinations et états d’annulation exacts.
Connexions
Worker de jobs vers Protocole d’analyseur
Collecter et persister le résultat exact avant d’autoriser son nettoyage.
Worker de jobs vers Protocole de mise à jour
Suivre identité d’opération et digest pendant préparation et récupération.
Worker de jobs vers Protocole du connecteur Advisor
Accorder seulement les droits fournisseur nécessaires à la requête Advisor prévue.
| Service | Appelant et ressources | Responsabilité |
|---|---|---|
| Analyseur | Worker ; sources autorisées, instantanés et cache validé en lecture seule | Admission des runs, état, constats bornés, acquittement exact et annulation. |
| Mise à jour des données | API/worker ; cache inscriptible et téléchargements examinés | Préparation durable et publication de générations complètes sans accès aux sources de projet. |
| Connecteur Advisor | Worker ; autorisation fournisseur dédiée et routes réseau approuvées | Tests, génération, observation et annulation précisément autorisés. |
Le noyau ne publie que son relais d’entrée loopback. Ces services ne sont pas des endpoints du site public. Réseau interne de l’analyseur, sortie de mise à jour et sortie Advisor sont distincts dans Compose. Vérifiez montages et réseaux dans les images et conteneurs déployés avant de les présenter comme une isolation observée.
Analyseur d’exécution
Le worker lance un run stable avec POST /runs, observe son état et lit ses résultats par pages bornées. Identité du run et digest de requête empêchent une autre commande de remplacer celle d’un run existant. Le manifeste scellé ajoute digest du résultat, comptes, identité du stream, résumé et déclarations d’artefacts.
Les curseurs lient run, requête, résultat et position exacte. Le worker valide tout le stream avant publication en base. POST /runs/{run_id}/result/ack libère le résultat temporaire exact après persistance durable. Annulation et nettoyage par DELETE /runs/{run_id} préservent la liaison appropriée ; ce ne sont pas des commandes arbitraires de suppression de fichiers.
Registre des runs et spool de récupération sont locaux au processus et limités dans le temps. Un redémarrage ne conserve pas le spool comme preuve durable. La réponse de santé ne prouve pas non plus la disponibilité des binaires, règles et bases choisis. Lisez routes, contrôle des runs et validation avant ACK.
Mise à jour sans accès aux sources
Le service reçoit des opérations durables liées à un UUID et un digest de requête. L’exécuteur récupère leur état et gère le travail actif/en attente borné. Les handlers résolvent les composants examinés, préparent des candidats privés, les valident et scellent, puis publient une génération complète. Chemins arbitraires de dépôt, URL de téléchargement ou commandes shell ne remplacent pas le catalogue examiné.
La frontière HTTP privée exige un Host autorisé et refuse les en-têtes forwarded-host/protocol. C’est une frontière supplémentaire, pas une raison d’exposition publique. Le service n’a pas de montage de projet ; l’analyseur consomme son cache validé en lecture seule.
Activation et annulation ont des issues distinctes. Après entrée dans l’étape protégée de commit, l’annulation ne peut interrompre la publication ni revenir sur la sélection. Le rollback est une opération séparée validée qui exige encore des données antérieures compatibles et fraîches. Voir démarrage et frontière, routes d’opérations et architecture de préparation.
Connecteur Advisor
Le travail Advisor local et distant passe par le connecteur. Le worker réserve ou admet une opération bornée, présente l’autorisation d’exécution et demande la génération. Le connecteur vérifie route et modèle autorisés puis valide la réponse. Il possède ses propres données d’autorisation et aucun montage de projet ; le worker fournit le paquet de constat admis.
La génération distante exige le parcours séparément confirmé pour un constat. La confirmation lie configuration, autorisation, transport, destination, modèle, révision du constat et hash du prompt. La sélection automatique et à l’échelle d’une analyse reste locale. Le transport distant prend en charge les routes Ollama directes ou SSH examinées, pas tout fournisseur de modèle.
Admission, observation et annulation possèdent des endpoints explicites. L’annulation peut arrêter la suite, mais ne rappelle pas un contenu déjà envoyé. Le worker revalide le conseil et le jette si le constat a changé pendant la génération. Il ne change pas automatiquement cycle de vie ou politique.
Voir opérations et génération du connecteur, intégration worker et liaison de divulgation.
Lire le protocole avec son implémentation
La référence interne décrit les déclarations de son instantané API explicitement identifié. Certains handlers lisent et valident directement le JSON : un schéma large généré ne décrit pas toutes les clés, liaisons ou conditions d’autorisation. Lisez ensemble handler et appelant lors d’un changement.
Les schémas seuls ne prouvent ni démarrage, ni accès réseau, ni autorisation fournisseur, ni récupération, ni prise en charge d’intégration. Les changements de protocole exigent validation coordonnée appelant/service et tests de refus et récupération. Une intégration publique ne doit pas dépendre de la stabilité de ces endpoints internes.