# AWS Glue에서 블루프린트 업데이트
<a name="updating_blueprints"></a>

수정된 레이아웃 스크립트, 수정된 블루프린트 파라미터 집합 또는 수정된 지원 파일이 있는 경우 블루프린트를 업데이트할 수 있습니다. 블루프린트를 업데이트하면 새 버전이 생성됩니다.

블루프린트를 업데이트해도 블루프린트에서 생성된 기존 워크플로에는 영향이 없습니다.

AWS Glue 콘솔, AWS Glue API 또는 AWS Command Line Interface(AWS CLI)를 사용하여 블루프린트를 업데이트할 수 있습니다.

다음 절차에서는 AWS Glue 개발자가 업데이트된 블루프린트 ZIP 아카이브를 생성하여 Amazon S3에 업로드했다고 가정합니다.

**블루프린트를 업데이트하려면(콘솔)**

1. Amazon S3의 블루프린트 ZIP 아카이브에 대한 읽기 권한(`s3:GetObject`)이 있는지 확인합니다.

1. [https://console.aws.amazon.com/glue/](https://console.aws.amazon.com/glue/)에서 AWS Glue 콘솔을 엽니다.

   블루프린트를 업데이트할 권한이 있는 사용자로 로그인합니다. 블루프린트 ZIP 아카이브가 포함된 Amazon S3 버킷과 동일한 AWS 리전으로 전환합니다.

1. 탐색 창에서 **블루프린트(Blueprints)**를 선택합니다.

1. **블루프린트** 페이지에서 블루프린트를 선택하고 **작업(Actions)** 메뉴에서 **편집(Edit)**을 선택합니다.

1. [**블루프린터 편집(Edit a blueprint)**] 페이지에서 블루프린트 [**설명(Description)**] 또는 [**ZIP 아카이브 위치(S3)(ZIP archive location (S3))**]를 업데이트합니다. 경로에 아카이브 파일 이름을 포함해야 합니다.

1. **저장**을 선택합니다.

   **블루프린트** 페이지가 반환되고 블루프린트 상태가 `UPDATING`임을 표시합니다. 상태가 `ACTIVE` 또는 `FAILED`로 변경될 때까지 새로 고침 버튼을 선택합니다.

1. 상태가 `FAILED`인 경우 블루프린트를 선택하고 [**작업(Actions)**] 메뉴에서 [**보기(View)**]를 선택합니다.

   세부 정보 페이지에 실패 이유가 표시됩니다. 오류 메시지가 “위치의 객체에 액세스할 수 없습니다...(Unable to access object at location...)” 또는 “위치의 객체에 대한 액세스가 거부되었습니다...(Access denied on object at location...)”인 경우 다음 요구 사항을 검토합니다.
   + 로그인한 사용자는 Amazon S3의 블루프린트 ZIP 아카이브에 대한 읽기 권한이 있어야 합니다.
   + ZIP 아카이브가 포함된 Amazon S3 버킷에는 AWS 계정 ID에 객체에 대한 읽기 권한을 부여하는 버킷 정책이 있어야 합니다. 자세한 내용은 [블루프린트 게시](developing-blueprints-publishing.md) 섹션을 참조하세요.
   + 사용 중인 Amazon S3 버킷은 콘솔에서 로그인한 리전과 동일한 리전에 있어야 합니다.
**참고**  
업데이트가 실패하면 성공적으로 등록되거나 업데이트된 블루프린트의 최신 버전이 다음 블루프린트 실행에 사용됩니다.

**블루프린트를 업데이트하려면(AWS CLI)**

1. 다음 명령을 입력합니다.

   ```
   aws glue update-blueprint --name {{<blueprint-name>}} [--description {{<description>}}] --blueprint-location s3://{{<s3-path>}}/{{<archive-filename>}}
   ```

1. 다음 명령을 입력하여 블루프린트 상태를 확인합니다. 상태가 `ACTIVE` 또는 `FAILED`가 될 때까지 명령을 반복합니다.

   ```
   aws glue get-blueprint --name {{<blueprint-name>}}
   ```

   상태가 `FAILED`이고 오류 메시지가 “위치의 객체에 액세스할 수 없습니다...(Unable to access object at location...)” 또는 “위치의 객체에 대한 액세스가 거부되었습니다...(Access denied on object at location...)”인 경우 다음 요구 사항을 검토합니다.
   + 로그인한 사용자는 Amazon S3의 블루프린트 ZIP 아카이브에 대한 읽기 권한이 있어야 합니다.
   + ZIP 아카이브가 포함된 Amazon S3 버킷에는 AWS 계정 ID에 객체에 대한 읽기 권한을 부여하는 버킷 정책이 있어야 합니다. 자세한 내용은 [블루프린트 게시](developing-blueprints-publishing.md) 섹션을 참조하세요.
   + 사용 중인 Amazon S3 버킷은 콘솔에서 로그인한 리전과 동일한 리전에 있어야 합니다.

**다음 사항도 참조하세요.**  
[AWS Glue의 블루프린트 개요](blueprints-overview.md)