教程：从软件包存储库中提取

打开 CodeCatalyst 控制台，网址为 https://codecatalyst.aws/。

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

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

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

在存储库名称中，输入：

hello-world-app

选择创建。

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

选择 “创建软件包存储库”。

在存储库名称中，输入：

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

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

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

导入lodash版本 4.17.20：

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

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

npm 导lodash入到网关存储库、 CodeCatalyst 软件包存储库和开发环境中。

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

lodash已成功导入您的开发环境的测试。输入：

npm list

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

`-- lodash@4.17.20

（可选）打开hello-world-app/package.json并验证里面的行 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.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 控制台。

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

选择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 控制台。

在导航窗格中，选择 C I/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 使用您在中创建的 CodeCatalyst 软件包存储库的名称步骤 2：创建 CodeCatalyst 和网关软件包存储库。

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

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

选择 Commit (提交)。

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

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

2. 在 “提交消息” 中，输入：

   add initial workflow file

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

4. 在 “分支名称” 中，选择 “主分支”。

5. 选择 Commit (提交)。

现在，您已经创建了一个工作流程。

在您刚刚创建的工作流程（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

此消息表明 4.17.20 lodash 版本已下载到运行工作流程操作的 Docker 镜像。

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

选择npm-publish-registry-gateway。

选择lodash。

在顶部附近，选择 O rigin 控件。

在 “上游” 下，选择 “阻止”。

选择保存。

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

切换到您的开发环境。

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

git pull

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

将lodash版本更改为 4.17.21，如中所示 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"
  }
}

现在，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

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

验证工作流程是否失败：

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

选择npm-publish-registry-gateway。

选择lodash。

在顶部附近，选择 O rigin 控件。

在 “上游” 下，选择 “允许”。

选择保存。

你现在已经解锁了的导入。lodash

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

再次运行您的工作流程。这次的工作流程应该会成功，因为 4.17.21 的导入现在应该可以正常工作了。要再次运行工作流程，请执行以下操作：

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

删除codecatalyst-package-project：

1. 在 CodeCatalyst 控制台中，如果您尚未进入该codecatalyst-package-project项目，请转到该项目。

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

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

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

删除令PAT牌：

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

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