자습서: 패키지 리포지토리에서 가져오기

https://codecatalyst.aws/에서 CodeCatalyst 콘솔을 엽니다.

codecatalyst-package-project 프로젝트로 이동합니다.

탐색 창에서 코드를 선택한 다음 소스 리포지토리를 선택합니다.

리포지토리 추가를 선택하고 리포지토리 생성을 선택합니다.

리포지토리 이름에 다음과 같이 입력합니다.

hello-world-app

생성(Create)을 선택합니다.

탐색 창에서 패키지를 선택합니다.

리포지토리 생성을 선택합니다.

리포지토리 이름에 다음과 같이 입력합니다.

codecatalyst-package-repository

+ 업스트림 리포지토리 선택을 선택합니다.

게이트웨이 리포지토리를 선택합니다.

npm-public-registry-gateway 상자에서 생성을 선택합니다.

선택을 선택하세요.

생성(Create)을 선택합니다.

CodeCatalyst는 게이트웨이 리포지토리에 연결된 codecatalyst-package-repository라는 패키지 리포지토리를 생성합니다. 게이트웨이 리포지토리는 npmjs.com 레지스트리에 연결됩니다.

탐색 창에서 코드를 선택한 다음 개발 환경을 선택합니다.

상단 근처에서 개발 환경 생성을 선택한 다음 AWS Cloud9 (브라우저에서)를 선택합니다.

리포지토리가 hello-world-app로 설정되어 있고 기존 브랜치가 main로 설정되어 있는지 확인합니다. 생성(Create)을 선택합니다.

개발 환경이 새 브라우저 탭에서 시작되고 리포지토리(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을 선택합니다.

워크플로 정의 파일은 선택한 소스 리포지토리 및 브랜치에 생성됩니다.

생성(Create)을 선택합니다.

상단 근처에서 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를 선택합니다.

상단 근처에서 원본 제어를 선택합니다.

업스트림에서 차단을 선택합니다.

저장(Save)을 선택합니다.

이제 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를 선택합니다.

상단 근처에서 원본 제어를 선택합니다.

업스트림에서 허용을 선택합니다.

저장(Save)을 선택합니다.

이제 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. 개인 액세스 토큰에서 이 자습서에서 생성한 토큰을 선택하고 삭제를 선택합니다.