Tutorial: Aus einem Paket-Repository abrufen

Öffnen Sie die CodeCatalyst Konsole unter https://codecatalyst.aws/.

Navigieren Sie zu Ihrem Projekt,codecatalyst-package-project.

Wählen Sie im Navigationsbereich Code und dann Quell-Repositories aus.

Wählen Sie Repository hinzufügen und anschließend Repository erstellen aus.

Geben Sie im Feld Repository-Name Folgendes ein:

hello-world-app

Wählen Sie Erstellen.

Wählen Sie im Navigationsbereich Packages (Pakete) aus.

Wählen Sie Paket-Repository erstellen.

Geben Sie im Feld Repository-Name Folgendes ein:

codecatalyst-package-repository

Wählen Sie + Upstream-Repositorys auswählen.

Wählen Sie Gateway-Repositorys.

Wählen Sie in dem npm-public-registry-gatewayFeld Create aus.

Wählen Sie Select (Auswählen).

Wählen Sie Erstellen.

CodeCatalyst erstellt ein Paket-Repository namenscodecatalyst-package-repository, das mit einem Gateway-Repository verbunden ist. Das Gateway-Repository ist mit der Registrierung npmjs.com verbunden.

Wählen Sie im Navigationsbereich Code und dann Dev Environments aus.

Wählen Sie oben Create Dev Environment und dann AWS Cloud9 (im Browser) aus.

Vergewissern Sie sich, dass Repository auf hello-world-app und Existing Branch auf eingestellt istmain. Wählen Sie Erstellen.

Ihre Entwicklungsumgebung wird in einem neuen Browser-Tab gestartet, in den Ihr Repository (hello-world-app) geklont wird.

Lassen Sie beide CodeCatalyst Browser-Tabs geöffnet und fahren Sie mit dem nächsten Verfahren fort.

Gehen Sie zu Ihrer Entwicklungsumgebung.

Wechseln Sie an der Terminal-Eingabeaufforderung zum Stammverzeichnis des hello-world-app Quell-Repositorys:

cd hello-world-app

Initialisieren Sie ein Node.js -Projekt:

npm init -y

Die Initialisierung erstellt eine package.json Datei im Stammverzeichnis von. hello-world-app

Connect den npm-Client in Ihrer Entwicklungsumgebung mit Ihrem CodeCatalyst Paket-Repository:

lodashVersion 4.17.20 importieren:

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

npm sucht an den folgenden Orten in der folgenden Reihenfolge nach lodash Version 4.17.20:

npm lodash importiert in das Gateway-Repository, das CodeCatalyst Paket-Repository und die Entwicklungsumgebung.

npm aktualisiert Ihre package.json Datei auch mit der lodash Abhängigkeit und erstellt ein node_modules Verzeichnis, das all seine Abhängigkeiten enthält. lodash

Testen Sie, der erfolgreich in Ihre Entwicklungsumgebung importiert lodash wurde. Geben Sie ein:

npm list

Die folgende Meldung weist auf einen erfolgreichen Import hin:

`-- lodash@4.17.20

(Optional) Öffnen Sie hello-world-app/package.json und überprüfen Sie, ob die Zeilen in red boldwurden hinzugefügt:

{
  "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"
  }
}

Erstellen Sie in /hello-world-app eine Datei namens index.js mit dem folgenden Inhalt:

// 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);

Wechseln Sie zur Konsole. CodeCatalyst

Wählen Sie im Navigationsbereich Packages (Pakete) aus.

Wähle npm-public-registry-gateway.

Stellen Sie sicher, dass angezeigt lodash wird. Die Spalte Letzte Version zeigt an4.17.20.

Wiederholen Sie diesen Vorgang für diecodecatalyst-package-repository. Möglicherweise müssen Sie das Browserfenster aktualisieren, um das importierte Paket zu sehen.

Wechseln Sie zu Ihrer Entwicklungsumgebung.

Stellen Sie sicher, dass Sie sich immer noch im hello-world-app Verzeichnis befinden, und führen Sie dann die Anwendung aus:

node index.js

Eine Hello World Meldung wird angezeigt. Node.js hat die Anwendung mit dem lodash Paket ausgeführt, das Sie in einem vorherigen Schritt in Ihre Entwicklungsumgebung heruntergeladen haben.

Ignoriere das Verzeichnis. node_modules Geben Sie ein:

echo "node_modules/" >> .gitignore

Es hat sich bewährt, zu vermeiden, dass dieses Verzeichnis festgeschrieben wird. Außerdem beeinträchtigt die Übertragung dieses Verzeichnisses die späteren Schritte in diesem Tutorial.

Hinzufügen, Festschreiben und Push:

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

Die Anwendung und die Projektdateien von „Hello World“ werden Ihrem Quell-Repository hinzugefügt.

Wechseln Sie zur Konsole. CodeCatalyst

Wählen Sie im Navigationsbereich CI/CD und dann Workflows aus.

Wählen Sie Workflow erstellen aus.

Wählen Sie für Quell-Repository die Optionhello-world-app.

Wählen Sie für Branch die Optionmain.

Die Workflow-Definitionsdatei wird im ausgewählten Quell-Repository und Branch erstellt.

Wählen Sie Erstellen.

Wählen YAMLSie ganz oben aus.

Löschen Sie den YAML Beispielcode.

Fügen Sie den folgenden YAML Code hinzu:

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

Ersetzen Sie im vorherigen Code codecatalyst-package-repository durch den Namen des CodeCatalyst Paket-Repositorys, in dem Sie es erstellt habenSchritt 2: Erstellen Sie die CodeCatalyst Paket-Repositorys und das Gateway.

Informationen zu den Eigenschaften in dieser Datei finden Sie unterAktionen erstellen und testen YAML.

(Optional) Wählen Sie „Validieren“, um sicherzustellen, dass der YAML Code gültig ist, bevor Sie ihn bestätigen.

Wählen Sie Commit (Übergeben).

Geben Sie im Dialogfeld „Workflow bestätigen“ Folgendes ein:

1. Behalten Sie als Workflow-Dateiname die Standardeinstellung beicodecatalyst-package-workflow.

2. Geben Sie für Commit-Nachricht Folgendes ein:

   add initial workflow file

3. Wählen Sie für Repository hello-world-app.

4. Wählen Sie als Branch-Name die Option main aus.

5. Wählen Sie Commit (Übergeben).

Sie haben jetzt einen Workflow erstellt.

Wählen Sie neben dem Workflow, den Sie gerade erstellt haben (codecatalyst-package-workflow), Aktionen und dann Ausführen aus.

Eine Workflow-Ausführung wird gestartet.

Wählen Sie in der grünen Benachrichtigung oben rechts den Link zum Lauf aus. Der Link sieht ähnlich aus wieView Run-1234.

Es wird ein Workflow-Diagramm angezeigt, das zeigt, wer den Lauf und die RunHelloWorldAppAktion gestartet hat.

Wählen Sie das RunHelloWorldAppAktionsfeld aus, um den Fortschritt der Aktion zu verfolgen.

Wenn der Lauf beendet ist, gehe zuSchritt 5: Überprüfen Sie den Workflow.

Wählen Sie im Workflow-Diagramm das RunHelloWorldAppFeld aus.

Eine Liste mit Protokollmeldungen wird angezeigt.

Erweitern Sie die node index.js Protokollnachricht.

Die folgende Meldung wird angezeigt:

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

Das Erscheinen von Hello Word (anstelle vonhello-world) weist darauf hin, dass die lodash Abhängigkeit erfolgreich verwendet wurde.

Erweitern Sie das npm list Protokoll.

Eine Meldung ähnlich der folgenden wird angezeigt:

└── lodash@4.17.20

Diese Meldung weist darauf hin, dass lodash Version 4.17.20 auf das Docker-Image heruntergeladen wurde, auf dem die Workflow-Aktion ausgeführt wird.

Wählen Sie im Navigationsbereich Packages (Pakete) aus.

Wählen Sie npm-publish-registry-gateway.

Wählen Sie lodash.

Wähle ganz oben Origin Controls aus.

Wähle unter Upstream die Option Blockieren aus.

Wählen Sie Speichern.

Sie haben jetzt Importe von npmjs.com in Ihr Gateway-Repository (und Downstream-Repositorys und Computer) blockiert.

Wechseln Sie zu Ihrer Entwicklungsumgebung.

Rufen Sie die codecatalyst-package-workflow.yaml Datei ab, die Sie zuvor mit der CodeCatalyst Konsole erstellt haben:

git pull

Öffnen Sie /hello-world-app/package.json.

Ändern Sie die lodash Version auf 4.17.21, wie in 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"
  }
}

Es besteht jetzt eine Diskrepanz zwischen der Version in der package.json Datei (4.17.21) und der Version in den Gateway- und CodeCatalyst Paket-Repositorys (4.17.20).

Hinzufügen, Festschreiben und Push:

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

Führen Sie den Workflow mit dem Versionskonflikt aus:

Stellen Sie sicher, dass der Workflow fehlgeschlagen ist:

Wählen Sie im Navigationsbereich Packages (Pakete) aus.

npm-publish-registry-gatewayWählen Sie.

Wählen Sie lodash.

Wähle ganz oben Origin Controls aus.

Wähle unter Upstream die Option Zulassen aus.

Wählen Sie Speichern.

Sie haben jetzt Importe von lodash entsperrt.

Ihr Workflow kann jetzt Version 4.17.21 von importieren. lodash

Führen Sie Ihren Workflow erneut aus. Diesmal sollte der Workflow erfolgreich sein, da der Import von 4.17.21 jetzt funktionieren sollte. Um den Workflow erneut auszuführen:

Stellen Sie sicher, dass Version 4.17.21 in Ihre und Ihre CodeCatalyst Gateway-Repositorys importiert wurde:

Löschen Sie dascodecatalyst-package-project:

1. Navigieren Sie in der CodeCatalyst Konsole zu dem codecatalyst-package-project Projekt, falls Sie noch nicht dort sind.

2. Wählen Sie im Navigationsbereich die Option Projekteinstellungen aus.

3. Wählen Sie Projekt löschendelete, geben Sie ein und wählen Sie Projekt löschen.

   CodeCatalyst löscht alle Projektressourcen, einschließlich der Quell-, Gateway- und CodeCatalyst Paket-Repositorys. Die Entwicklungsumgebung wird ebenfalls gelöscht.

Löschen Sie das PAT Token:

1. Wählen Sie rechts Ihren Benutzernamen und dann Meine Einstellungen.

2. Wählen Sie unter Persönliche Zugriffstoken das Token aus, das Sie in diesem Tutorial erstellt haben, und wählen Sie Löschen aus.