Gestion des versions et des journaux de modifications avec un accent sur les monorepos

Le flux de travail est conçu pour aider les personnes à apporter des modifications, jusqu’à la publication. Il permet aux contributeurs de déclarer comment leurs modifications doivent être publiées, puis nous automatisons la mise à jour des versions des packages, des journaux de modifications et la publication de nouvelles versions de packages en fonction des informations fournies.

Changesets se concentre sur la résolution de ces problèmes pour les monorepos, en maintenant à jour les packages qui dépendent les uns des autres au sein du monorepo, tout en facilitant les modifications apportées à des groupes de packages.

Comment faisons-nous cela ?

Un changeset est une intention de publier un ensemble de packages à une date particulière avec un résumé des modifications apportées.

Le package @changesets/cli vous permet d’écrire des fichiers de changesets au fur et à mesure que vous apportez des modifications, puis de combiner un nombre quelconque de changesets en une publication, qui aplatit les types d’augmentation en une seule publication par package, gère les dépendances internes dans un monorepo, met à jour les journaux de modifications, ainsi que publie tous les packages mis à jour à partir d’un monorepo avec une seule commande.

Comment commencer ?

Si vous voulez simplement commencer à utiliser changesets, les docs sont l’endroit où vous devriez vous diriger.

Si vous souhaitez une explication détaillée des concepts derrière changesets, ou comprendre comment vous pourriez construire au-dessus de changesets, consultez notre guide.

Nous avons également un exemple.

Intégration avec CI

Bien que changesets puisse être un processus entièrement manuel, nous recommandons de l’intégrer à votre CI.

Pour vérifier que les PR contiennent un changeset, nous recommandons d’utiliser [outil], ou si vous souhaitez échouer les builds en cas d’échec de changesets, exécutez [commande] dans CI.

Pour faciliter la publication, vous pouvez utiliser [outil] pour automatiser la création de pull requests de version, et éventuellement la publication des packages.

Documentation

• [Lien_vers_la_documentation_1]
• [Lien_vers_la_documentation_2]

Projets intéressants utilisant déjà Changesets pour la gestion des versions et des journaux de modifications

• Projet 1
• Projet 2
• Projet 3
• Projet 4

Remerciements/Inspiration

• [Nom_de_la_personne_1] : Nous a apporté un concept solide sur la façon dont les packages dans un monorepo devraient pouvoir interagir, et a fourni l’infrastructure initiale pour obtenir des informations inter-packages.
• [Nom_de_la_personne_2] : L’idée originale/sponsor du code changesets, et où bon nombre des idées et des processus ont été élaborés. Il a été initialement mis en œuvre par l’équipe derrière [Projet].
• [Nom_de_la_personne_3] : A posé bon nombre des premiers modèles autour de la mise à jour des packages au sein d’un monorepo, et nous a fait réfléchir à la manière de gérer les packages dépendants.
• [Nom_de_la_personne_4] : Pour avoir sponsorisé la mise en open source ciblée de ce projet, et la réarchitecture de la version deux.

Source de l’article