Skip to Content
DocsGitLabGénérer avec l'IA

Générer avec l’IA

Si vous avez déjà un pipeline GitLab CI, un assistant de code IA peut produire le pipeline Mélodium équivalent en quelques minutes, sans que vous ayez à 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, le serveur MCP Mélodium connecté à celui-ci, ou les deux. Voir Installer la compétence Mélodium. Le serveur MCP fournit le même guide de migration via get_cicd_migration_guide, et permet à l’IA de vérifier le programme qu’elle écrit.

É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 aussi 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, c’est inclus automatiquement dès que la compétence est installée sous ~/.claude/skills/melodium, elle 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 : un Compo.toml déclarant les bonnes dépendances, un fichier .mel par pipeline ou groupe logique de jobs, l’ordre des stages exprimé en câblage séquentiel entre traitements, des instances parallèles pour les jobs parallel:, un passage d’artefacts direct par flux d’octets sans stockage intermédiaire, et la remontée d’état des commits GitLab.

Étape 3 : relire et ajuster

Lisez le code généré avant de l’exécuter. Les paramètres cpu, memory et storage dans simpleStep ont des valeurs par défaut génériques, ajustez-les à vos besoins réels de build. Vérifiez que gitlab_project_id, gitlab_sha, gitlab_ref et gitlab_pipeline_id sont connectés aux bons paramètres du point d’entrée, et que le token est lu depuis le bon secret : gitlab_token vaut par défaut "env:MELODIUM_SECRET_GITLAB_TOKEN", une variable CI/CD décrite dans Composants CI/CD. L’IA fusionne before_script / after_script dans la liste commands, mais contrairement à GitLab CI ils partagent alors le même environnement shell, vérifiez donc que cela correspond à votre intention. Vérifiez aussi que le câblage filterBlock reproduit correctement la logique de vos conditions rules: d’origine, et que les noms out_file / 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 CIMélodium
Pipeline (.gitlab-ci.yml)Traitement .mel
JobTraitement avec simpleStep ou localStep
image:Paramètre image de simpleStep
script: / before_script: / after_script:Liste commands dans simpleStep
Ordre des stagesCâblage séquentiel entre traitements
needs: / dependencies:Câblage séquentiel ; artefacts via flux data
artifacts:out_file + flux data ; simpleStepWithInput pour consommer ; paramètre artifacts de simpleStep pour les garder comme artefacts de run
cache:Paramètre cache de simpleStep, ou work/cache dans les programmes (voir Caches)
rules: / only: / except:filterBlock<void>() sur le déclencheur
when: alwaysone<void>() regroupant les sorties succès et échec
allow_failure: trueGérer la sortie error sans interrompre la chaîne
parallel:Plusieurs instances de traitements parallèles avec one<void>()
interruptible: trueVariante simpleStepTerminable
Remontée d’étatpostGitlabState / 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 une parallélisation plus avancée, consultez Implémentation CI/CD Simple et Implémentation CI/CD Avancée.