Amazon CodeCatalyst는 더 이상 신규 고객에게 공개되지 않습니다. 기존 고객은 정상적으로 서비스를 계속 이용할 수 있습니다. 자세한 내용은 [CodeCatalyst에서 마이그레이션하는 방법](migration.md) 단원을 참조하십시오.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 블루프린트 도구 및 CLI 작업
<a name="bp-cli"></a>

[블루프린트 CLI](https://www.npmjs.com/package/@amazon-codecatalyst/blueprint-util.cli)는 사용자 지정 블루프린트를 관리하고 작업할 수 있는 도구를 제공합니다.

**Topics**
+ [블루프린트 도구 작업](#working-with-bp-cli)
+ [이미지 업로드 도구](#image-upload-tool)

## 블루프린트 도구 작업
<a name="working-with-bp-cli"></a>

**블루프린트 도구로 작업하려면**

1. [https://codecatalyst.aws/](https://codecatalyst.aws/)에서 CodeCatalyst 콘솔을 엽니다.

1. 개발 환경을 재개합니다. 자세한 내용은 [개발 환경 재개](devenvironment-resume.md) 섹션을 참조하세요.

   개발 환경이 없는 경우 먼저 환경을 생성해야 합니다. 자세한 내용은 [개발 환경 생성](devenvironment-create.md) 섹션을 참조하세요.

1. 작동 중인 터미널에서 다음 명령을 실행하여 블루프린트 CLI를 설치합니다.

   ```
   npm install -g @amazon-codecatalyst/blueprint-util.cli
   ```

1. `blueprint.ts` 파일에서 사용할 도구를 다음 형식으로 가져옵니다.

   ```
   import { {{<tooling-function-name>}} } from '@amazon-codecatalyst/blueprint-util.cli/lib/{{<tooling-folder-name>}}/{{<tooling-file-name>}};
   ```
**작은 정보**  
[https://github.com/aws/codecatalyst-blueprints/tree/main/packages/utils/blueprint-cli](https://github.com/aws/codecatalyst-blueprints/tree/main/packages/utils/blueprint-cli)에서 사용하려는 도구의 이름을 찾을 수 있습니다.

   **이미지 업로드 도구를 사용하려면 스크립트에 다음을 추가합니다.**

   ```
   import { uploadImagePublicly } from '@amazon-codecatalyst/blueprint-util.cli/lib/image-upload-tool/upload-image-to-aws';
   ```

   **예시**
   + **게시 함수를 사용하려면 스크립트에 다음을 추가합니다.**

     ```
     import { publish } from '@amazon-codecatalyst/blueprint-util.cli/lib/publish/publish';
     ```
   + **이미지 업로드 도구를 사용하려면 스크립트에 다음을 추가합니다.**

     ```
     import { uploadImagePublicly } from '@amazon-codecatalyst/blueprint-util.cli/lib/image-upload-tool/upload-image-to-aws';
     ```

1. 함수를 직접적으로 호출합니다.

   **예시:**
   + **게시 함수를 사용하려면 스크립트에 다음을 추가합니다.**

     ```
     await publish(logger, config.publishEndpoint, {{{<your publishing options>}}});
     ```
   + **이미지 업로드 도구를 사용하려면 스크립트에 다음을 추가합니다.**

     ```
     const {imageUrl, imageName} = await uploadImagePublicly(logger, 'path/to/image'));
     ```

## 이미지 업로드 도구
<a name="image-upload-tool"></a>

이미지 업로드 도구를 사용하면 AWS 계정의 S3 버킷에 이미지를 업로드한 다음 CloudFront 뒤에 해당 이미지를 공개적으로 배포할 수 있습니다. 도구는 로컬 스토리지(및 선택적 버킷 이름)의 이미지 경로를 입력으로 가져와서 공개적으로 사용할 수 있는 이미지에 URL을 반환합니다. 자세한 내용은 [Amazon CloudFront란?](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/Introduction.html) 및 [ Amazon S3란?](https://docs.aws.amazon.com/AmazonS3/latest/userguide/Welcome.html)을 참조하세요.

**이미지 업로드 도구로 작업하려면**

1. 블루프린트 SDK 및 샘플 블루프린트에 대한 액세스를 제공하는 [오픈 소스 블루프린트 GitHub 리포지토리](https://github.com/aws/codecatalyst-blueprints)를 복제합니다. 작업 중인 터미널에서 다음 명령을 실행합니다.

   ```
   git clone https://github.com/aws/codecatalyst-blueprints.git
   ```

1. 다음 명령을 실행하여 블루프린트 GitHub 리포지토리로 이동합니다.

   ```
   cd codecatalyst-blueprints
   ```

1. 다음 명령을 실행하여 종속성을 설치합니다.

   ```
   yarn && yarn build
   ```

1. 다음 명령을 실행하여 최신 블루프린트 CLI 버전이 설치되어 있는지 확인합니다.

   ```
   yarn upgrade @amazon-codecatalyst/blueprint-util.cli
   ```

1. 이미지를 업로드하려는 S3 버킷을 사용하여 AWS 계정에 로그인합니다. 자세한 내용은 [AWS CLI 구성하기](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html) 및 [AWS 명령줄 인터페이스를 통해 로그인하기](https://docs.aws.amazon.com/signin/latest/userguide/command-line-sign-in.html)를 참조하세요.

1. CodeCatalyst 리포지토리의 루트에서 다음 명령을 실행하여 블루프린트 CLI를 사용하여 디렉터리로 이동합니다.

   ```
   cd packages/utils/blueprint-cli
   ```

1. 다음 명령을 실행하여 S3 버킷에 이미지를 업로드합니다.

   ```
   yarn blueprint upload-image-public {{<./path/to/your/image>}} 
         {{<optional:optional-bucket-name>}}
   ```

이미지의 URL이 생성됩니다. CloudFront 배포를 배포하는 데 시간이 다소 걸리므로 URL을 즉시 사용할 수 없습니다. 배포 상태를 확인하여 최신 배포 상태를 가져옵니다. 자세한 내용은 [배포 작업](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-working-with.html)을 참조하세요.