Sélectionner vos préférences de cookies

Nous utilisons des cookies essentiels et des outils similaires qui sont nécessaires au fonctionnement de notre site et à la fourniture de nos services. Nous utilisons des cookies de performance pour collecter des statistiques anonymes afin de comprendre comment les clients utilisent notre site et d’apporter des améliorations. Les cookies essentiels ne peuvent pas être désactivés, mais vous pouvez cliquer sur « Personnaliser » ou « Refuser » pour refuser les cookies de performance.

Si vous êtes d’accord, AWS et les tiers approuvés utiliseront également des cookies pour fournir des fonctionnalités utiles au site, mémoriser vos préférences et afficher du contenu pertinent, y compris des publicités pertinentes. Pour accepter ou refuser tous les cookies non essentiels, cliquez sur « Accepter » ou « Refuser ». Pour effectuer des choix plus détaillés, cliquez sur « Personnaliser ».

Gestion des dépendances, des incohérences et de l'outillage

Mode de mise au point
Gestion des dépendances, des incohérences et de l'outillage - Amazon CodeCatalyst

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Une gestion incorrecte des dépendances peut entraîner des échecs de compilation et des problèmes d'exécution pour les utilisateurs de vos plans personnalisés. Les outils et composants obsolètes peuvent empêcher les utilisateurs du Blueprint d'accéder aux dernières fonctionnalités et corrections de bogues. Vous pouvez gérer les dépendances, gérer les incohérences de dépendance, ainsi que mettre à niveau les outils et les composants pour garantir que toutes les dépendances reposent sur les mêmes versions de composants et que les composants sont synchronisés.

Ajouter des dépendances

En tant qu'auteur de plan, vous devrez peut-être ajouter des packages à votre plan, tels que. @amazon-codecatalyst/blueprint-component.environments Vous devez mettre à jour le projen.ts fichier avec ce package, puis régénérer la configuration de votre projet avec Projen. Projen sert de modèle de projet pour chaque base de code de plan, ce qui permet de mettre à jour les outils rétrocompatibles en modifiant la façon dont le modèle affiche les fichiers de configuration. Le package.json fichier est un fichier qui appartient partiellement au modèle Projen. Projen reconnaît les versions de dépendance incluses dans le fichier package.json, mais les autres options doivent provenir du modèle.

Pour ajouter une dépendance et mettre à jour un projenrc.ts fichier

  1. Dans le projen.ts fichier, accédez à la section deps.

  2. Ajoutez la dépendance que vous souhaitez utiliser dans votre plan.

  3. Utilisez la commande suivante pour régénérer la configuration de votre projet :

    yarn projen && yarn

Gestion des incohérences entre les types de dépendance

Après une mise à jour de Yarn, l'erreur suivante peut s'afficher concernant un paramètre de dépôt :

Type 'SourceRepository' is missing the following properties from type 'SourceRepository': synthesisSteps, addSynthesisStep

L'erreur est due à une incompatibilité de dépendance qui se produit lorsqu'un composant repose sur une version plus récente d'un autre composant, mais que le composant de base est épinglé à une version plus ancienne. L'erreur peut être corrigée en faisant en sorte que tous vos composants reposent sur la même version afin que la version soit synchronisée entre eux. Il est préférable de conserver tous les packages fournis par Blueprint sous la même dernière version (0.0.x), sauf si vous êtes certain de la façon dont vous gérez les versions. L'exemple suivant montre comment le package.json fichier peut être configuré de telle sorte que toutes les dépendances reposent sur la même version :

... "@caws-blueprint-component/caws-environments": "^0.1.12345", "@caws-blueprint-component/caws-source-repositories": "^0.1.12345", "@caws-blueprint-component/caws-workflows": "^0.1.12345", "@caws-blueprint-component/caws-workspaces": "^0.1.12345", "@caws-blueprint-util/blueprint-utils": "^0.1.12345", ... "@caws-blueprint/blueprints.blueprint": "*",

Après avoir configuré les versions pour toutes les dépendances, utilisez la commande suivante :

yarn install

Utiliser du fil et du npm

Les plans utilisent du fil pour l'outillage. L'utilisation de npm et de Yarn posera des problèmes d'outillage car la manière dont les arbres de dépendance sont résolus par chacun est différente. Pour éviter de tels problèmes, il est préférable d'utiliser uniquement du fil.

Si vous avez accidentellement installé des dépendances à l'aide de npm, vous pouvez supprimer le package-lock.json fichier généré et vous assurer que votre .projenrc.ts fichier est mis à jour avec les dépendances dont vous avez besoin. Vous régénérez la configuration de votre projet avec Projen.

Utilisez ce qui suit pour effectuer une régénération à partir du modèle :

yarn projen

Après avoir vérifié que votre fichier .projenrc.ts est mis à jour avec les dépendances nécessaires, utilisez la commande suivante :

yarn

Mise à niveau de l'outillage et des composants

De temps en temps, vous souhaiterez peut-être mettre à niveau votre outillage et vos composants pour intégrer les nouvelles fonctionnalités disponibles. Il est recommandé de conserver tous les composants sur la même version, sauf si vous êtes certain de la façon dont vous gérez les versions. Les versions sont synchronisées entre les composants, de sorte que les mêmes versions pour tous les composants garantissent une bonne dépendance entre eux.

Utilisation du monorepo de l'espace de travail Yarn

Utilisez la commande suivante pour mettre à niveau les utilitaires et les composants à partir de la racine du référentiel d'un plan personnalisé :

yarn upgrade @amazon-codecatalyst/*

Utilisez la commande suivante si vous n'utilisez pas de monorepo :

yarn upgrade —pattern @amazon-codecatalyst/*

Autres options que vous pouvez utiliser pour mettre à niveau l'outillage et les composants :

  • Utilisez npm view @caws-blueprint-component/<some-component> pour obtenir la dernière version.

  • Passez manuellement à la dernière version en définissant la version dans votre fichier package.json et en utilisant la commande suivante : yarn Tous les composants et utilitaires doivent avoir la même version.

ConfidentialitéConditions d'utilisation du sitePréférences de cookies
© 2025, Amazon Web Services, Inc. ou ses affiliés. Tous droits réservés.