Générer avec l’IA

Si vous avez déjà un pipeline GitLab CI, vous pouvez utiliser un assistant de code IA pour obtenir le pipeline Mélodium équivalent en quelques minutes, sans avoir à apprendre le langage au préalable.

Ce dont vous avez besoin

Votre fichier .gitlab-ci.yml existant (l’agent le lira directement).
Un assistant de code IA fonctionnant localement dans votre projet (Claude Code, Cursor, Zed, ou similaire).
La compétence Mélodium installée dans votre outil IA. Voir Installer la compétence Mélodium.

Étape 1 : Vérifier que la référence de migration est incluse

La compétence Mélodium générale couvre le langage et la structure de projet. Pour une migration depuis GitLab CI, l’IA a également besoin de skills/melodium/references/gitlab-migration.md, qui contient les patterns exacts pour simpleStep, le streaming d’artefacts, l’ordre des stages, allow_failure, when: always, et la remontée d’état.

Avec Claude Code, cela est inclus automatiquement lorsque la compétence est installée sous ~/.claude/skills/melodium. La compétence charge ses fichiers de référence à la demande.

Avec Cursor ou Zed, vérifiez que votre fichier de règle l’inclut :


# Cursor
cat skills/melodium/SKILL.md \
    skills/melodium/references/gitlab-migration.md \
    skills/melodium/references/projects.md \
    > .cursor/rules/melodium.md
 
# Zed
cat skills/melodium/SKILL.md \
    skills/melodium/references/gitlab-migration.md \
    skills/melodium/references/projects.md \
    > .rules

Étape 2 : Demander la migration

Votre agent IA fonctionne déjà dans votre projet et peut lire votre fichier de pipeline directement. Un prompt simple suffit :


Lis .gitlab-ci.yml et migre-le vers Mélodium.
Génère un projet complet sous .melodium-ci/ avec Compo.toml et des fichiers .mel.
Utilise simpleStep pour les jobs conteneurisés, localStep pour les jobs self-hosted.
Remonte l'état vers GitLab en utilisant le token et les paramètres de projet.

Si votre pipeline utilise include: pour importer des fichiers locaux, indiquez leur emplacement :


Lis aussi les templates dans ci/templates/ qui sont inclus par le pipeline.

L’IA produira un projet Mélodium prêt à l’emploi avec :

Un Compo.toml déclarant les bonnes dépendances.
Un fichier .mel par pipeline ou groupe logique de jobs.
L’ordre des stages exprimé sous forme de câblage séquentiel entre traitements.
Des instances parallèles pour les jobs parallel:.
Un passage d’artefacts direct par flux d’octets entre jobs, sans stockage intermédiaire.
La remontée d’état des commits GitLab.

Étape 3 : Relire et ajuster

Lisez le code généré avant de l’exécuter. Points utiles à vérifier :

Dimensionnement des ressources : les paramètres cpu, memory et storage dans simpleStep ont des valeurs par défaut qui peuvent ne pas correspondre à votre charge de travail. Ajustez-les en fonction de vos besoins réels.
Secrets et tokens : vérifiez que gitlab_token, gitlab_project_id, gitlab_sha, gitlab_ref et gitlab_pipeline_id sont connectés aux bons paramètres du point d’entrée.
before_script / after_script : l’IA les fusionne dans la liste commands. Contrairement à GitLab CI, ils partagent le même environnement shell, vérifiez donc que cela correspond à votre intention.
Conditions rules: : vérifiez que le câblage filterBlock reproduit correctement la logique de vos règles d’origine.
Chemins d’artefacts : confirmez que les noms out_file et in_file dans simpleStep / simpleStepWithInput correspondent aux chemins que vos scripts écrivent et lisent réellement.

Référence des concepts

Si vous souhaitez comprendre ce que l’IA a produit, ou l’ajuster vous-même, ce tableau montre comment les concepts GitLab CI se mappent vers Mélodium :

GitLab CI	Mélodium
Pipeline (`.gitlab-ci.yml`)	Traitement `.mel`
Job	Traitement avec `simpleStep` ou `localStep`
`image:`	Paramètre `image` de `simpleStep`
`script:` / `before_script:` / `after_script:`	Liste `commands` dans `simpleStep`
Ordre des stages	Câblage séquentiel entre traitements
`needs:` / `dependencies:`	Câblage séquentiel ; artefacts via flux `data`
`artifacts:`	`out_file` + flux `data` ; `simpleStepWithInput` pour consommer
`rules:` / `only:` / `except:`	`filterBlock<void>()` sur le déclencheur
`when: always`	`one<void>()` regroupant les sorties succès et échec
`allow_failure: true`	Gérer la sortie `error` sans interrompre la chaîne
`parallel:`	Plusieurs instances de traitements parallèles avec `one<void>()`
`interruptible: true`	Variante `simpleStepTerminable`
Remontée d’état	`postGitlabState` / `setServiceState`

La documentation complète de l’API est disponible sur doc.melodium.tech .

Pour aller plus loin

Le code généré est un bon point de départ et peut être étendu avec n’importe quel élément Mélodium. Pour la distribution sur plusieurs machines et la parallélisation avancée, consultez Implémentation CI/CD Simple et Implémentation CI/CD Avancée.

Workflows Réutilisables Composants CI/CD