教學課程：從套裝程式儲存區域取

開啟主 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 客戶端 Connect 到您的 CodeCatalyst 軟件包存儲庫：

匯入lodash版本：

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 控台。

在瀏覽窗格中，選擇 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 使用您在中建立的 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。

在頂部附近，選擇「原點控制項」。

在「上游」下選擇「封鎖」。

選擇儲存。

您現在已封鎖從 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"
  }
}

現在檔案中的版本 (4.17.21) 與閘道和 CodeCatalyst 套package.json件儲存庫 (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。

在頂部附近，選擇「原點控制項」。

在「上游」下選擇「允許」。

選擇儲存。

您現在已解除封鎖的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. 在「個人存取權杖」下，選擇您在本教學課程中建立的權杖，然後選擇「刪除」