Tutoriel : extraction depuis un dépôt de packages

Ouvrez la CodeCatalyst console à l'adresse https://codecatalyst.aws/.

Accédez à votre projet,codecatalyst-package-project.

Dans le volet de navigation, choisissez Code, puis sélectionnez Référentiels sources.

Choisissez Ajouter un référentiel, puis sélectionnez Créer un référentiel.

Dans Nom du référentiel, entrez :

hello-world-app

Choisissez Créer.

Dans le panneau de navigation, choisissez Packages.

Choisissez Créer un référentiel de packages.

Dans Nom du référentiel, entrez :

codecatalyst-package-repository

Choisissez + Sélectionnez les référentiels en amont.

Choisissez les référentiels Gateway.

Dans le npm-public-registry-gatewaychamp, choisissez Create.

Choisissez Select (Sélectionner).

Choisissez Créer.

CodeCatalyst crée un référentiel de packages appelé codecatalyst-package-repository qui est connecté à un référentiel de passerelle. Le référentiel de passerelle est connecté au registre npmjs.com.

Dans le volet de navigation, choisissez Code, puis Dev Environments.

En haut, choisissez Create Dev Environment, puis choisissez AWS Cloud9 (dans le navigateur).

Assurez-vous que le référentiel est défini sur hello-world-app et que la branche existante est définie surmain. Choisissez Créer.

Votre environnement de développement s'ouvre dans un nouvel onglet du navigateur, et votre dépôt (hello-world-app) y est cloné.

Laissez les deux onglets CodeCatalyst du navigateur ouverts et passez à la procédure suivante.

Accédez à votre environnement de développement.

À l'invite du terminal, accédez au répertoire racine du référentiel hello-world-app source :

cd hello-world-app

Initialisez un projet Node.js :

npm init -y

L'initialisation crée un package.json fichier dans le répertoire racine dehello-world-app.

Connectez le client npm de votre environnement de développement à votre référentiel de CodeCatalyst packages :

lodashVersion d'importation 4.17.20 :

npm install lodash@v4.17.20 --save --save-exact

npm recherche la lodash version 4.17.20 aux emplacements suivants, dans l'ordre suivant :

npm importe lodash dans le référentiel de passerelle, le référentiel de CodeCatalyst packages et l'environnement de développement.

npm met également à jour votre package.json fichier avec la lodash dépendance et crée un node_modules répertoire contenant lodash toutes ses dépendances.

Testez qui lodash a été importé avec succès dans votre environnement de développement. Entrez :

npm list

Le message suivant s'affiche, indiquant que l'importation a été effectuée avec succès :

`-- lodash@4.17.20

(Facultatif) Ouvrez hello-world-app/package.json et vérifiez que les lignes de red boldont été ajoutés :

{
  "name": "hello-world-app",
  "version": "1.0.0",
  "description": "",
  "main": "index.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "keywords": [],
  "author": "",
  "license": "ISC",
  dependencies": {
    "lodash": "4.17.20"
  }
}

Dans/hello-world-app, créez un fichier appelé index.js avec le contenu suivant :

// Importing lodash library
const _ = require('lodash');

// Input string
const inputString = 'hello-world';

// Transforming the string using lodash
const transformedString = _.startCase(inputString.replace('-', ' '));

// Outputting the transformed string to the console
console.log(transformedString);

Passez à la CodeCatalyst console.

Dans le panneau de navigation, choisissez Packages.

Choisissez npm-public-registry-gateway.

Assurez-vous qu'lodashil est affiché. La colonne Dernière version indique4.17.20.

Répétez cette procédure pourcodecatalyst-package-repository. Il se peut que vous deviez actualiser la fenêtre du navigateur pour voir le package importé.

Passez à votre environnement de développement.

Assurez-vous que vous êtes toujours dans le hello-world-app répertoire, puis lancez l'application :

node index.js

Un Hello World message s'affiche. Node.js a exécuté l'application à l'aide lodash du package que vous avez téléchargé dans votre environnement de développement lors d'une étape précédente.

Ignorez le node_modules répertoire. Entrez :

echo "node_modules/" >> .gitignore

Il est recommandé d'éviter de valider ce répertoire. De plus, la validation de ce répertoire interférera avec les étapes ultérieures de ce didacticiel.

Ajoutez, validez et envoyez :

git add .
git commit -m "add the Hello World application"
git push

L'application « Hello World » et les fichiers de projet sont ajoutés à votre référentiel source.

Passez à la CodeCatalyst console.

Dans le volet de navigation, choisissez CI/CD, puis Workflows.

Choisissez Créer un flux de travail.

Pour Référentiel source, choisissezhello-world-app.

Pour Branch, choisissezmain.

Le fichier de définition du flux de travail sera créé dans le référentiel source et la branche choisis.

Choisissez Créer.

Choisissez YAMLprès du haut.

Supprimez l'YAMLexemple de code.

Ajoutez le YAML code suivant :

Name: codecatalyst-package-workflow
SchemaVersion: "1.0"

# Required - Define action configurations.
Actions:
  RunHelloWorldApp:
    # Identifies the action. Do not modify this value.
    Identifier: aws/build@v1
    Compute:
      Type: Lambda
    Inputs:
      Sources:
        - WorkflowSource # This specifies your source repository. 
    Configuration:
      Steps:
        - Run: npm install
        - Run: npm list
        - Run: node index.js
      Container: # This specifies the Docker image that runs the action.
        Registry: CODECATALYST
        Image: CodeCatalystLinuxLambda_x86_64:2024_03
    Packages:
      NpmConfiguration:
        PackageRegistries:
          - PackagesRepository: codecatalyst-package-repository

Dans le code précédent, remplacez codecatalyst-package-repository avec le nom du référentiel de CodeCatalyst packages dans lequel vous l'avez crééÉtape 2 : Création des référentiels de packages CodeCatalyst et de passerelle.

Pour plus d'informations sur les propriétés de ce fichier, consultez leCréez et testez des actions YAML.

(Facultatif) Choisissez Valider pour vous assurer que le YAML code est valide avant de le valider.

Choisissez Commit (Valider).

Dans la boîte de dialogue du flux de travail de validation, entrez ce qui suit :

1. Pour le nom du fichier de flux de travail, conservez la valeur par défaut,codecatalyst-package-workflow.

2. Pour le message de validation, entrez :

   add initial workflow file

3. Pour Repository, choisissez hello-world-app.

4. Pour Nom de la branche, choisissez main.

5. Choisissez Commit (Valider).

Vous venez de créer un flux de travail.

À côté du flux de travail que vous venez de créer (codecatalyst-package-workflow), choisissez Actions, puis Exécuter.

Une exécution de flux de travail démarre.

Dans la notification verte en haut à droite, choisissez le lien vers la course. Le lien ressemble àView Run-1234.

Un diagramme de flux de travail apparaît, indiquant qui a lancé l'exécution et l'RunHelloWorldAppaction.

Choisissez la case RunHelloWorldAppd'action pour suivre la progression de l'action.

Lorsque la course est terminée, passez àÉtape 5 : vérifier le flux de travail.

Dans le diagramme du flux de travail, RunHelloWorldAppcochez la case.

La liste des messages du journal s'affiche.

Développez le message du node index.js journal.

Le message suivant s'affiche :

[Container] 2024/04/24 21:15:41.545650 Running command node index.js
Hello World

L'apparition de Hello Word (au lieu dehello-world) indique que la lodash dépendance a été utilisée avec succès.

Développez le npm list journal.

Un message similaire au suivant s'affiche :

└── lodash@4.17.20

Ce message indique que lodash la version 4.17.20 a été téléchargée sur l'image Docker exécutant l'action de flux de travail.

Dans le panneau de navigation, choisissez Packages.

Choisissez npm-publish-registry-gateway.

Sélectionnez lodash.

En haut, choisissez Origin controls.

Sous Upstream, choisissez Bloquer.

Choisissez Enregistrer.

Vous avez désormais bloqué les importations dans votre référentiel de passerelle (ainsi que dans les référentiels et ordinateurs en aval) depuis npmjs.com.

Passez à votre environnement de développement.

Extrayez le codecatalyst-package-workflow.yaml fichier que vous avez créé à l'aide de la CodeCatalyst console plus tôt :

git pull

Ouvrir /hello-world-app/package.json.

Changez la lodash version en 4.17.21 comme indiqué dans red bold:

{
  "name": "hello-world-app",
  "version": "1.0.0",
  "description": "",
  "main": "index.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "keywords": [],
  "author": "",
  "license": "ISC",
  "dependencies": {
    "lodash": "4.17.21"
  }
}

Il existe désormais une incompatibilité entre la version du package.json fichier (4.17.21) et celle de la passerelle et des référentiels de CodeCatalyst packages (4.17.20).

Ajoutez, validez et envoyez :

git add .
git commit -m "update package.json to use lodash 4.17.21"
git push

Exécutez le flux de travail avec la version non correspondante :

Vérifiez que le flux de travail a échoué :

Dans le panneau de navigation, choisissez Packages.

Choisissez npm-publish-registry-gateway.

Sélectionnez lodash.

En haut, choisissez Origin controls.

Sous Upstream, sélectionnez Autoriser.

Choisissez Enregistrer.

Vous avez maintenant débloqué les importations de. lodash

Votre flux de travail peut désormais importer la version 4.17.21 de. lodash

Réexécutez votre flux de travail. Cette fois, le flux de travail devrait réussir car l'importation de la version 4.17.21 devrait désormais fonctionner. Pour réexécuter le flux de travail, procédez comme suit :

Vérifiez que la version 4.17.21 a été importée dans vos référentiels CodeCatalyst et ceux de la passerelle :

Supprimez le codecatalyst-package-project :

1. Dans la CodeCatalyst console, accédez au codecatalyst-package-project projet si ce n'est pas déjà fait.

2. Dans le volet de navigation, sélectionnez Paramètres du projet.

3. Choisissez Supprimer le projetdelete, entrez et choisissez Supprimer le projet.

   CodeCatalyst supprime toutes les ressources du projet, y compris les référentiels de source, de passerelle et de CodeCatalyst packages. L'environnement de développement est également supprimé.

Supprimez le PAT jeton :

1. Choisissez votre nom d'utilisateur sur la droite, puis sélectionnez Mes paramètres.

2. Sous Jetons d'accès personnels, choisissez le jeton que vous avez créé dans ce didacticiel, puis choisissez Supprimer.