教程：从程序包存储库中拉取

通过访问 https://codecatalyst.aws/ 打开 CodeCatalyst 控制台。

导航到您的项目 codecatalyst-package-project。

在导航窗格中，选择代码，然后选择源存储库。

选择添加存储库，然后选择创建存储库。

在存储库名称中，输入：

hello-world-app

选择创建。

在导航窗格中，选择程序包。

选择创建程序包存储库。

在存储库名称中，输入：

codecatalyst-package-repository

选择 + 选择上游存储库。

选择网关存储库。

在 npm-public-registry-gateway 框中，选择创建。

选定选择。

选择创建。

CodeCatalyst 创建一个名为 codecatalyst-package-repository 的软件包存储库，该存储库连接到网关存储库。网关存储库将连接到 npmjs.com 注册表。

在导航窗格中，选择代码，然后选择开发环境。

在顶部附近，选择创建开发环境，然后选择 AWS Cloud9 (在浏览器中)。

确保存储库设置为 hello-world-app，并且现有分支设置为 main。选择创建。

您的开发环境将在新的浏览器标签页中启动，并且您的存储库（hello-world-app）将克隆到其中。

将 CodeCatalyst 浏览器标签页保持打开状态，然后转到下一个过程。

转到您的开发环境。

在终端提示符下，更改为 hello-world-app 源存储库根目录：

cd hello-world-app

初始化一个 Node.js 项目：

npm init -y

初始化过程将在 hello-world-app 的根目录中创建一个 package.json 文件。

将开发环境中的 npm 客户端连接到 CodeCatalyst 程序包存储库：

导入 lodash 版本 4.17.20：

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

npm 按以下顺序在以下位置查找 lodash 版本 4.17.20：

npm 将 lodash 导入网关存储库、CodeCatalyst 程序包存储库和开发环境中。

npm 还使用 lodash 依赖项更新 package.json 文件，并创建一个包含 lodash 其所有依赖项的 node_modules 目录。

测试是否已将 lodash 成功导入开发环境中。输入：

npm list

这将显示以下消息，表示已成功导入：

`-- lodash@4.17.20

（可选）打开 hello-world-app/package.json 并验证是否添加了红色粗体行：

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

在 /hello-world-app 中，创建一个名为 index.js 的包含以下内容的文件：

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

切换到 CodeCatalyst 控制台。

在导航窗格中，选择程序包。

选择 npm-public-registry-gateway。

确保已显示 lodash。最新版本列指示 4.17.20。

对 codecatalyst-package-repository 重复此过程。您可能需要刷新浏览器窗口才能看到已导入的程序包。

切换到您的开发环境。

确保您仍在 hello-world-app 目录中，然后运行应用程序：

node index.js

这将显示 Hello World 消息。Node.js 使用您在上一步中下载到开发环境的 lodash 程序包运行应用程序。

忽略 node_modules 目录。输入：

echo "node_modules/" >> .gitignore

最佳实践是避免提交此目录。此外，提交此目录会干扰本教程中的后续步骤。

添加、提交和推送：

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

“Hello World”应用程序和项目文件将添加到源存储库中。

切换到 CodeCatalyst 控制台。

在导航窗格中，选择 CI/CD，然后选择工作流。

选择创建工作流。

对于源存储库，选择 hello-world-app。

对于分支，选择 main。

这将在选定的源存储库和分支中创建工作流定义文件。

选择创建。

在顶部附近选择 YAML。

删除 YAML 示例代码。

添加以下 YAML 代码：

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

在前面的代码中，将 codecatalyst-package-repository 替换为您在步骤 2：创建 CodeCatalyst 和网关程序包存储库中创建的 CodeCatalyst 程序包存储库的名称。

有关此文件中的属性的信息，请参阅构建和测试操作 YAML。

（可选）选择验证，确保 YAML 代码在提交之前有效。

选择提交。

在提交工作流对话框中，输入以下内容：

1. 对于工作流文件名，保留默认值 codecatalyst-package-workflow。

2. 对于提交消息，输入：

   add initial workflow file

3. 对于存储库，选择 hello-world-app。

4. 对于分支名称，选择主。

5. 选择提交。

现在，您已创建工作流。

在您刚刚创建的工作流（codecatalyst-package-workflow）旁边，选择操作，然后选择运行。

工作流运行将开始。

在右侧顶部的绿色通知中，选择运行的链接。该链接看起来类似于 View Run-1234。

这将显示一个工作流图表，其中显示谁启动了运行和 RunHelloWorldApp 操作。

选中 RunHelloWorldApp 操作框以查看操作的进度。

运行完成后，转至步骤 5：验证工作流。

在工作流图表中，选中 RunHelloWorldApp 框。

这将显示日志消息列表。

展开 node index.js 日志消息。

这将显示以下消息：

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

显示 Hello Word（而不是 hello-world）指明已成功使用 lodash 依赖项。

展开 npm list 日志。

这将显示一条与以下内容类似的消息：

└── lodash@4.17.20

此消息指示 lodash 版本 4.17.20 已下载到运行工作流操作的 Docker 映像。

在导航窗格中，选择程序包。

选择 npm-publish-registry-gateway。

选择 lodash。

在顶部附近，选择源控制。

在上游下，选择阻止。

选择保存。

现在，您已阻止从 npmjs.com 导入网关存储库（以及下游存储库和计算机）中。

切换到您的开发环境。

拉取您之前使用 CodeCatalyst 控制台创建的 codecatalyst-package-workflow.yaml 文件：

git pull

打开 /hello-world-app/package.json。

将 lodash 版本更改为 4.17.21，如红色粗体所示：

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

现在，package.json 文件中的版本（4.17.21）与网关和 CodeCatalyst 程序包存储库中的版本（4.17.20）不匹配。

添加、提交和推送：

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

在版本不匹配的情况下运行工作流：

验证工作流是否已失败：

在导航窗格中，选择程序包。

选择 npm-publish-registry-gateway。

选择 lodash。

在顶部附近，选择源控制。

在上游下，选择允许。

选择保存。

您现在已解除阻止导入 lodash。

您的工作流现在可以导入 lodash 的版本 4.17.21。

再次运行工作流。这次工作流应成功，因为现在应已能够导入版本 4.17.21。要再次运行工作流，请执行以下操作：

验证版本 4.17.21 是否已导入 CodeCatalyst 和网关存储库中：

删除 codecatalyst-package-project：

1. 在 CodeCatalyst 控制台中，导航到 codecatalyst-package-project 项目（如果您尚未这样做）。

2. 在导航窗格中，选择项目设置。

3. 选择删除项目，输入 delete，然后选择删除项目。

   CodeCatalyst 会删除所有项目资源，包括源、网关和 CodeCatalyst 程序包存储库。也将删除开发环境。

删除 PAT 令牌：

1. 在右侧选择您的用户名，然后选择我的设置。

2. 在个人访问令牌下，选择您在本教程中创建的令牌，然后选择删除。