Concepts

Les mots employés dans la documentation et le tableau de bord, et la façon dont ils s’articulent. Pour le langage lui-même, voir le Mélodium Language Book  ; pour chaque traitement, modèle et fonction disponible, la Mélodium Reference .

D’un programme à ses runs

Vous lancez un programme depuis un point d’entrée. Le moteur qui démarre est le run direct. Chaque fois que le programme envoie une étape ailleurs, un run de distribution démarre sur un runner, une machine que Cadence.CI démarre dans votre compte cloud pour cette étape. Ensemble, ils forment un groupe d’exécution, affiché sous forme de hiérarchie sur la page du groupe.

Écrire des pipelines

• Programme : un projet Mélodium , un fichier Compo.toml et des fichiers source .mel. En CI/CD, il vit généralement dans .melodium-ci/ à la racine du dépôt. Cadence.CI requiert Mélodium 0.11 ou plus récent.
• Traitement : une unité de traitement , avec des entrées, des sorties et des paramètres. Les traitements sont connectés entre eux, et un traitement peut être composé d’autres traitements : build et test dans le template CI/CD sont des traitements, faits de nombreux traitements plus petits.
• Modèle : un composant configuré  que les traitements partagent, comme le moteur de dispatch qui demande des machines (CicdDispatchEngine), un serveur HTTP ou un modèle de langage distant (RemoteLlm).
• Connexion : un lien typé  d’une sortie vers une entrée. Un Stream<T> transporte un flux de valeurs, comme les octets d’un fichier ; un Block<T> transporte une valeur, comme le signal trigger (Block<void>). Connecter des types incompatibles est une erreur trouvée par la vérification, avant toute exécution.
• Point d’entrée : le traitement depuis lequel un run démarre , déclaré sous [entrypoints] dans Compo.toml. Un programme peut en avoir plusieurs, par exemple main et advanced dans le template CI/CD.
• Vérification : melodium check valide le programme entier, types, connexions et paramètres, sans rien exécuter. melodium run effectue la même vérification avant de démarrer.
• Secret : une valeur de type Secret, comme un jeton ou un mot de passe. Elle est donnée sous forme de localisateur, env:MELODIUM_SECRET_<NOM> pour une variable d’environnement ou file:<chemin> pour un fichier, et résolue par le moteur qui l’utilise. Les valeurs secrètes sont masquées dans les logs et jamais envoyées à Cadence.CI, qui ne voit que le nom et le type d’un secret.

Exécuter des pipelines

• Moteur : le processus Mélodium qui exécute un programme. Il apparaît comme le service Mélodium Engine sur la page d’un run.
• Run : l’exécution d’un moteur, telle que rapportée à Cadence.CI : son statut (planification, non planifiable, en cours, terminé), son résultat, le point d’entrée et les paramètres avec lesquels il a démarré, ses logs, ses événements de debug et son programme.
• Run direct : un run que vous lancez vous-même, par exemple avec melodium run --api-report depuis votre machine ou un job CI.
• Run de distribution : un run démarré pour recevoir du travail d’un autre run, son parent. Une étape CI/CD envoyée par CicdDispatchEngine est un run de distribution.
• Groupe d’exécution : le run direct et tous les runs de distribution qu’il a démarrés. La page du groupe les dessine sous forme de hiérarchie.
• Emplacement de travail (work_location) : là où vont les étapes envoyées. api, la valeur par défaut, demande à Cadence.CI des machines dans votre compte cloud ; compose démarre des conteneurs avec Podman ou Docker Compose sur la machine qui exécute le programme. Voir Où il s’exécute.
• Runner : là où s’exécute un run de distribution : une instance que Cadence.CI démarre dans votre compte cloud pour l’étape et arrête après, ou un conteneur quand les étapes s’exécutent en local avec compose.
• Instance : une machine virtuelle que Cadence.CI a démarrée dans l’un de vos comptes cloud connectés. Chaque compte connecté liste ses instances, avec le run que chacune a servi.
• Événements de debug : l’enregistrement de ce qu’a fait le moteur, modèles et traitements construits, démarrés et terminés, données envoyées et reçues sur chaque connexion. Au niveau detailed, ils contiennent aussi la valeur de chaque transmission, sauf les secrets, qui n’y apparaissent jamais. La page d’un run les rejoue sur une timeline.

Accès

• Organisation : l’unité qui possède les runs, les comptes cloud, les jetons et le plan. Les membres ont un rôle : Administrateur, Opérateur ou Membre.
• Jeton d’exécution : permet à un programme de rapporter des runs et de demander des machines pour le compte d’une organisation. Placez-le dans la variable d’environnement MELODIUM_API_TOKEN : --api-report l’utilise, et le template CI/CD aussi pour demander des machines.
• Compte cloud : un compte chez l’un des fournisseurs pris en charge, connecté dans Clouds, où Cadence.CI démarre des instances pour vos runs. Voir Connecter un cloud.