Amazon CodeCatalyst는 더 이상 신규 고객에게 공개되지 않습니다. 기존 고객은 정상적으로 서비스를 계속 이용할 수 있습니다. 자세한 내용은 [CodeCatalyst에서 마이그레이션하는 방법](migration.md) 단원을 참조하십시오.
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 워크플로를 사용하여 AWS CDK 앱 부트스트래핑
이 섹션에서는 CodeCatalyst 워크플로를 사용하여 AWS CDK 애플리케이션을 부트스트랩하는 방법을 설명합니다. 이렇게 하려면 워크플로에 **AWS CDK 부트스트랩** 작업을 추가해야 합니다. **AWS CDK 부트스트랩** 작업은 [최신 템플릿](https://docs.aws.amazon.com/cdk/v2/guide/bootstrapping.html#bootstrapping-template)을 사용하여 AWS 환경의 부트스트랩 스택을 프로비저닝합니다. 부트스트랩 스택이 이미 있는 경우 필요한 경우 작업이 해당 스택을 업데이트합니다. 에 부트스트랩 스택 AWS 이 있으면 AWS CDK 앱을 배포하기 위한 사전 조건입니다.
부트스트래핑에 대한 자세한 내용은 *AWS Cloud Development Kit (AWS CDK) 개발자 안내서*의 [부트스트래핑](https://docs.aws.amazon.com/cdk/v2/guide/bootstrapping.html)을 참조하세요.
**Topics**
+ ['AWS CDK bootstrap' 작업을 사용해야 하는 경우](#cdk-boot-action-when-to-use)
+ ['AWS CDK 부트스트랩' 작업 작동 방식](#cdk-boot-action-how-it-works)
+ ["AWS CDK bootstrap" 작업에서 사용하는 CDK CLI 버전](#cdk-boot-action-cdk-version)
+ ['AWS CDK bootstrap' 작업에서 사용하는 런타임 이미지](#cdk-boot-action-runtime)
+ [예: AWS CDK 앱 부트스트래핑](cdk-boot-action-example-workflow.md)
+ ['AWS CDK bootstrap' 작업 추가](cdk-boot-action-add.md)
+ ['AWS CDK 부트스트랩' 변수](cdk-boot-action-variables.md)
+ ['AWS CDK 부트스트랩' 작업 YAML](cdk-boot-action-ref.md)
## 'AWS CDK bootstrap' 작업을 사용해야 하는 경우
AWS CDK 앱을 배포하는 워크플로가 있고 부트스트랩 스택을 동시에 배포(및 필요한 경우 업데이트)하려는 경우이 작업을 사용합니다. 이 경우 AWS CDK 앱을 배포하는 워크플로와 동일한 워크플로에 **AWS CDK 부트스트랩** 작업을 추가합니다.
다음 중 하나가 적용되는 경우 이 작업을 사용하지 **마세요**.
+ 다른 메커니즘을 사용하여 부트스트랩 스택을 이미 배포했으며 그대로 유지하고자 합니다(업데이트 없음).
+ **AWS CDK 부트스트랩** 작업에서 지원되지 않는 [사용자 지정 부트스트랩 템플릿](https://docs.aws.amazon.com/cdk/v2/guide/bootstrapping.html#bootstrapping-customizing)을 사용하려고 합니다.
## 'AWS CDK 부트스트랩' 작업 작동 방식
**AWS CDK 부트스트랩**은 다음과 같이 작동합니다.
1. 런타임 시 작업 버전 1.0.7 이하를 지정한 경우 작업은 최신 CDK CLI( AWS CDK Tookit이라고도 함)를 CodeCatalyst [빌드 이미지](build-images.md)에 다운로드합니다.
버전 1.0.8 이상을 지정한 경우 작업은 [특정 버전](cdk-dep-action.md#cdk-dep-action-cdk-version)의 CDK CLI와 번들로 제공되므로 다운로드가 발생하지 않습니다.
1. 작업은 CDK CLI를 사용하여 `cdk bootstrap` 명령을 실행합니다. 이 명령은 *AWS Cloud Development Kit (AWS CDK) 개발자 안내서*의 부트스트래핑 주제에 설명된 [부트스트래핑](https://docs.aws.amazon.com/cdk/v2/guide/bootstrapping.html) 작업을 수행합니다.
## "AWS CDK bootstrap" 작업에서 사용하는 CDK CLI 버전
다음 표에는 **AWS CDK 부트스트랩** 작업의 다양한 버전에서 기본적으로 사용되는 CDK CLI 버전이 나와 있습니다.
**참고**
기본값을 재정의할 수 있습니다. 자세한 내용은 ['AWS CDK 부트스트랩' 작업 YAML](cdk-boot-action-ref.md)의 [CdkCliVersion](cdk-boot-action-ref.md#cdk.boot.cdk.cli.version) 섹션을 참조하세요.
| 'AWS CDK 부트스트랩' 작업 버전 | AWS CDK CLI 버전 |
| --- | --- |
| 1.0.0 – 1.0.7 | 최신 |
| 1.0.8 이상 | 2.99.1 |
## 'AWS CDK bootstrap' 작업에서 사용하는 런타임 이미지
다음 표에는 CodeCatalyst가 **AWS CDK 부트스트랩** 작업의 다른 버전을 실행하는 데 사용하는 런타임 환경 이미지가 나와 있습니다. 이미지에는 사전 설치된 다양한 도구 세트가 포함됩니다. 자세한 내용은 [활성 이미지](build-images.md#build-curated-images) 섹션을 참조하세요.
**참고**
2024년 3월 이미지에서 사용할 수 있는 최신 도구를 활용하려면 **AWS CDK 부트스트랩** 작업을 버전 2.x로 업그레이드하는 것이 좋습니다. 작업을 업그레이드하려면 워크플로 정의 파일에서 `Identifier` 속성을 `aws/cdk-bootstrap@v2`로 설정합니다. 자세한 내용은 ['AWS CDK 배포' 작업 YAML](cdk-dep-action-ref.md) 단원을 참조하십시오.
| 'AWS CDK 부트스트랩' 작업 버전 | 런타임 환경 이미지 |
| --- | --- |
| 1.x | 2022년 11월 이미지 |
| 2.x | 2024년 3월 이미지 |
# 예: AWS CDK 앱 부트스트래핑
**AWS CDK 부트스트랩** 작업이 포함된 워크플로는 [워크플로를 사용하여 AWS CDK 앱 배포](cdk-dep-action.md)의 [예: AWS CDK 앱 배포](cdk-dep-action-example-workflow.md)를 참조하세요.
# 'AWS CDK bootstrap' 작업 추가
다음 지침에 따라 **AWS CDK 부트스트랩** 작업을 워크플로에 추가합니다.
**시작하기 전에**
**AWS CDK 부트스트랩** 작업을 사용하려면 먼저 AWS CDK 앱이 준비되었는지 확인하세요. 부트스트랩 작업은 부트스트랩 전에 AWS CDK 앱을 합성합니다. AWS CDK에서 지원하는 모든 프로그래밍 언어로 앱을 작성할 수 있습니다.
AWS CDK 앱 파일을 다음에서 사용할 수 있는지 확인합니다.
+ CodeCatalyst [소스 리포지토리](source.md) 또는
+ 다른 워크플로 작업에서 생성된 CodeCatalyst [출력 아티팩트](workflows-working-artifacts.md)
------
#### [ Visual ]
**시각적 편집기를 사용하여 'AWS CDK bootstrap' 작업을 추가하려면**
1. [https://codecatalyst.aws/](https://codecatalyst.aws/)에서 CodeCatalyst 콘솔을 엽니다.
1. 프로젝트를 선택합니다.
1. 탐색 창에서 **CI/CD**를 선택한 다음 **워크플로**를 선택합니다.
1. 워크플로의 이름을 선택합니다. 소스 리포지토리 또는 워크플로가 정의된 브랜치 이름을 기준으로 필터링하거나, 워크플로 이름 또는 상태를 기준으로 필터링할 수 있습니다.
1. **편집**을 선택합니다.
1. **비주얼**을 선택합니다.
1. 왼쪽 상단에서 **\$1 작업**을 선택하여 작업 카탈로그를 엽니다.
1. 드롭다운 목록에서 **Amazon CodeCatalyst**를 선택합니다.
1. **AWS CDK 부트스트랩** 작업을 검색하고 다음 중 하나를 수행합니다.
+ 더하기 기호(**\$1**)를 선택하여 워크플로 다이어그램에 작업을 추가하고 구성 창을 엽니다.
또는
+ **AWS CDK 부트스트랩**을 선택합니다. 작업 세부 정보 대화 상자가 나타납니다. 이 대화 상자에서 다음을 수행합니다.
+ (선택 사항) **소스 보기**를 선택하여 [작업의 소스 코드를 봅니다](workflows-view-source.md#workflows-view-source.title).
+ **워크플로에 추가**를 선택하여 워크플로 다이어그램에 작업을 추가하고 구성 창을 엽니다.
1. **입력,** **구성** 및 **출력** 탭에서 필요에 따라 필드를 작성합니다. 각 필드의 설명은 ['AWS CDK 부트스트랩' 작업 YAML](cdk-boot-action-ref.md) 섹션을 참조하세요. 이 참조는 YAML 및 시각적 편집기 모두에 나타나는 각 필드(및 해당 YAML 속성 값)에 대한 자세한 정보를 제공합니다.
1. (선택 사항) 커밋하기 전에 워크플로의 YAML 코드를 검증하려면 **검증**을 선택합니다.
1. **커밋**을 선택하고 커밋 메시지를 입력한 다음 **커밋**을 다시 선택합니다.
**참고**
**AWS CDK 부트스트랩** 작업이 실패하고 `npm install` 오류가 발생하는 경우 오류를 수정하는 방법에 대한 자세한 내용은 ['npm install' 오류를 해결하려면 어떻게 해야 하나요?](troubleshooting-workflows.md#troubleshooting-workflows-npm) 섹션을 참조하세요.
------
#### [ YAML ]
**YAML 편집기를 사용하여 'AWS CDK bootstrap' 작업을 추가하려면**
1. [https://codecatalyst.aws/](https://codecatalyst.aws/)에서 CodeCatalyst 콘솔을 엽니다.
1. 프로젝트를 선택합니다.
1. 탐색 창에서 **CI/CD**를 선택한 다음 **워크플로**를 선택합니다.
1. 워크플로의 이름을 선택합니다. 소스 리포지토리 또는 워크플로가 정의된 브랜치 이름을 기준으로 필터링하거나, 워크플로 이름 또는 상태를 기준으로 필터링할 수 있습니다.
1. **편집**을 선택합니다.
1. **YAML**을 선택합니다.
1. 왼쪽 상단에서 **\$1 작업**을 선택하여 작업 카탈로그를 엽니다.
1. 드롭다운 목록에서 **Amazon CodeCatalyst**를 선택합니다.
1. **AWS CDK 부트스트랩** 작업을 검색하고 **\$1**를 선택하여 워크플로 다이어그램에 추가하고 구성 창을 엽니다.
1. 필요에 따라 YAML 코드의 속성을 수정합니다. 사용 가능한 각 속성에 대한 설명은 ['AWS CDK 부트스트랩' 작업 YAML](cdk-boot-action-ref.md)에서 볼 수 있습니다.
1. (선택 사항) 커밋하기 전에 워크플로의 YAML 코드를 검증하려면 **검증**을 선택합니다.
1. **커밋**을 선택하고 커밋 메시지를 입력한 다음 **커밋**을 다시 선택합니다.
**참고**
**AWS CDK 부트스트랩** 작업이 실패하고 `npm install` 오류가 발생하는 경우 오류를 수정하는 방법에 대한 자세한 내용은 ['npm install' 오류를 해결하려면 어떻게 해야 하나요?](troubleshooting-workflows.md#troubleshooting-workflows-npm) 섹션을 참조하세요.
------
# 'AWS CDK 부트스트랩' 변수
**AWS CDK 부트스트랩** 작업은 런타임에 다음 변수를 생성하고 설정합니다. 이를 *사전 정의된 변수*라고 합니다.
워크플로에서 이러한 변수를 참조하는 방법에 대한 자세한 내용은 [사전 정의된 변수 사용](workflows-using-predefined-variables.md) 섹션을 참조하세요.
| Key(키) | 값 |
| --- | --- |
| deployment-platform | 배포 플랫폼의 이름입니다. `AWS:CloudFormation`로 하드코딩되었습니다. |
| 리전 | 워크플로 실행 중에 AWS CDK 부트스트랩 스택 AWS 리전 이 배포된의 리전 코드입니다. 예시: `us-west-2` |
| stack-id | 배포된 AWS CDK 부트스트랩 스택의 Amazon 리소스 이름(ARN)입니다. 예시: `arn:aws:cloudformation:us-west-2:111122223333:stack/codecatalyst-cdk-bootstrap-stack/6aad4380-100a-11ec-a10a-03b8a84d40df` |
| SKIP-DEPLOYMENT | 값이 이면 워크플로 실행 중에 AWS CDK 부트스트랩 스택의 배포를 건너뛰었음을 `true` 나타냅니다. 마지막 배포 이후 스택에 변경 사항이 없는 경우 스택 배포를 건너뜁니다. 이 변수는 값이 `true`인 경우에만 생성됩니다. `true`로 하드코딩되었습니다. |
# 'AWS CDK 부트스트랩' 작업 YAML
다음은 **AWS CDK 부트스트랩** 작업의 YAML 정의입니다. 이러한 작업 사용 방법을 배우려면 [워크플로를 사용하여 AWS CDK 앱 부트스트래핑](cdk-boot-action.md) 섹션을 참조하세요.
이 작업 정의는 더 광범위한 워크플로 정의 파일 내의 섹션으로 존재합니다. 이 파일에 대한 자세한 내용은 [워크플로 YAML 정의](workflow-reference.md)을 참조합니다.
**참고**
이어지는 대부분의 YAML 속성에는 시각적 편집기에 해당 UI 요소가 있습니다. UI 요소를 찾으려면 **Ctrl\$1F**를 사용합니다. 요소가 연결된 YAML 속성과 함께 나열됩니다.
```
# The workflow definition starts here.
# See 최상위 속성 for details.
Name: MyWorkflow
SchemaVersion: 1.0
Actions:
# The action definition starts here.
CDKBootstrapAction\$1nn:
Identifier: aws/cdk-bootstrap@v2
DependsOn:
- action-name
Compute:
Type: EC2 | Lambda
Fleet: fleet-name
Timeout: timeout-minutes
Inputs:
# Specify a source or an artifact, but not both.
Sources:
- source-name-1
Artifacts:
- artifact-name
Outputs:
Artifacts:
- Name: cdk_bootstrap_artifacts
Files:
- "cdk.out/**/*"
Environment:
Name: environment-name
Connections:
- Name: account-connection-name
Role: iam-role-name
Configuration:
Region: us-west-2
CdkCliVersion: version
```
## CDKBootstrapAction
(필수)
작업 이름을 지정합니다. 워크플로 내의 모든 작업 이름은 고유해야 합니다. 작업 이름은 영숫자 문자(a-z, A-Z, 0-9), 하이픈(-) 및 밑줄(\$1)로 제한됩니다. 스페이스은 허용되지 않습니다. 작업 이름에서 특수 문자와 공백을 활성화하는 데 따옴표를 사용할 수 없습니다.
기본값: `CDKBootstrapAction_nn`.
해당 UI: 구성 탭/**작업 표시 이름**
## Identifier
(*CDKBootstrapAction*/**Identifier**)
(필수)
작업을 식별합니다. 버전을 변경하려는 경우가 아니면 이 속성을 변경하지 마세요. 자세한 내용은 [사용할 작업 버전 지정](workflows-action-versions.md) 섹션을 참조하세요.
**참고**
를 지정`aws/cdk-bootstrap@v2`하면 Node.js 18과 같은 최신 도구가 포함된 [2024년 3월 이미지](build-images.md#build.default-image)에서 작업이 실행됩니다. 를 지정`aws/cdk-bootstrap@v1`하면 Node.js 16과 같은 이전 도구가 포함된 [2022년 11월 이미지](build-images.md#build.previous-image)에서 작업이 실행됩니다.
기본값: `aws/cdk-bootstrap@v2`.
해당 UI: 워크플로 다이어그램/CDKBootstrapAction\$1nn/**aws/cdk-bootstrap@v2** 레이블
## DependsOn
(*CDKBootstrapAction*/**DependsOn**)
(선택 사항)
이 작업을 실행하기 위해 성공적으로 실행해야 하는 작업, 작업 그룹 또는 게이트를 지정합니다.
'depends on' 함수에 대한 자세한 내용은 [작업 순서 지정](workflows-depends-on.md) 섹션을 참조하세요.
해당 UI: 입력 탭/**의존 - 선택 사항**
## Compute
(*CDKBootstrapAction*/**Compute**)
(선택 사항)
워크플로 작업을 실행하는 데 사용되는 컴퓨팅 엔진입니다. 워크플로 수준 또는 작업 수준에서 컴퓨팅을 지정할 수 있지만 둘 다 지정할 수는 없습니다. 워크플로 수준에서 지정하면 컴퓨팅 구성이 워크플로에 정의된 모든 작업에 적용됩니다. 워크플로 수준에서는 동일한 인스턴스에서 여러 작업을 실행할 수도 있습니다. 자세한 내용은 [작업 간에 컴퓨팅 공유](compute-sharing.md) 섹션을 참조하세요.
해당 UI: *없음*
## Type
(*CDKBootstrapAction*/Compute/**Type**)
([Compute](#cdk.boot.computename) 포함 시 필수)
컴퓨팅 엔진의 유형입니다. 다음 값 중 하나를 사용할 수 있습니다.
+ **EC2**(시각 편집기) 또는 `EC2`(YAML 편집기)
작업 실행 중 유연성을 위해 최적화되었습니다.
+ **Lambda**(시각 편집기) 또는 `Lambda`(YAML 편집기)
작업 시작 속도를 최적화했습니다.
컴퓨팅 유형에 대한 자세한 정보는 [컴퓨팅 유형](workflows-working-compute.md#compute.types)을 참고하세요.
해당 UI: 구성 탭/고급 - 선택 사항/**컴퓨팅 유형**
## Fleet
(*CDKBootstrapAction*/Compute/**Fleet**)
(선택 사항)
워크플로 또는 워크플로 작업을 실행할 시스템 또는 플릿을 지정합니다. 온디맨드 플릿의 경우 작업이 시작되면 워크플로가 필요한 리소스를 프로비저닝하고 작업이 완료되면 시스템이 파괴됩니다. 온디맨드 플릿의 예시: `Linux.x86-64.Large`, `Linux.x86-64.XLarge`. 온디맨드 플릿에 대한 자세한 내용은 [온디맨드 플릿 속성](workflows-working-compute.md#compute.on-demand) 섹션을 참조하세요.
프로비저닝된 플릿을 사용하면 워크플로 작업을 실행하도록 전용 시스템 세트를 구성할 수 있습니다. 이러한 시스템은 유휴 상태로 유지되므로 작업을 즉시 처리할 수 있습니다. 프로비저닝된 플릿에 대한 자세한 내용은 [프로비저닝된 플릿 속성](workflows-working-compute.md#compute.provisioned-fleets) 섹션을 참조하세요.
`Fleet` 생략 시 기본값은 `Linux.x86-64.Large`입니다.
해당 UI: 구성 탭/고급 - 선택적/**컴퓨팅 플릿**
## Timeout
(*CDKBootstrapAction*/**Timeout**)
(필수)
CodeCatalyst가 작업을 종료하기 전에 작업을 실행할 수 있는 시간을 분(YAML 편집기) 또는 시간 및 분(시각적 편집기) 단위로 지정합니다. 최소값은 5분이고 최대값은 [CodeCatalyst의 워크플로 할당량](workflows-quotas.md)에 설명되어 있습니다. 기본 제한 시간은 최대 제한 시간과 동일합니다.
해당 UI: 구성 탭/**제한 시간 - 선택 사항 **
## Inputs
(*CDKBootstrapAction*/**Inputs**)
(선택 사항)
이 `Inputs` 섹션에서는 워크플로 실행 중에 **AWS CDK 부트스트랩** 작업에 필요한 데이터를 정의합니다.
해당 UI: **입력** 탭
**참고**
각 **AWS CDK 부트스트랩** 작업에 대해 하나의 입력(소스 또는 아티팩트)만 허용됩니다.
## Sources
(*CDKBootstrapAction*/Inputs/**Sources**)
( AWS CDK 앱이 소스 리포지토리에 저장된 경우 필수)
AWS CDK 앱이 소스 리포지토리에 저장된 경우 해당 소스 리포지토리의 레이블을 지정합니다. **AWS CDK 부트스트랩** 작업은 부트스트랩 프로세스를 시작하기 전에 이 리포지토리의 앱을 합성합니다. 현재, `WorkflowSource` 리포지토리 레이블만 지원됩니다.
AWS CDK 앱이 소스 리포지토리에 포함되지 않은 경우 다른 작업에서 생성된 아티팩트에 있어야 합니다.
소스에 대한 자세한 내용은 [워크플로에 소스 리포지토리 연결](workflows-sources.md) 섹션을 참조하세요.
해당 UI: 입력 탭/**소스 - 선택 사항**
## Artifacts - input
(*CDKBootstrapAction*/Inputs/**Artifacts**)
( AWS CDK 앱이 이전 작업의 [출력 아티팩트](workflows-working-artifacts-output.md)에 저장된 경우 필수)
AWS CDK 앱이 이전 작업에서 생성된 아티팩트에 포함된 경우 여기에 해당 아티팩트를 지정합니다. **AWS CDK 부트스트랩** 작업은 부트스트랩 프로세스를 시작하기 전에 지정된 아티팩트의 앱을 CloudFormation 템플릿으로 합성합니다. AWS CDK 앱이 아티팩트 내에 포함되어 있지 않은 경우 앱은 소스 리포지토리에 있어야 합니다.
예시를 포함해 아티팩트에 대한 자세한 내용은 [작업 간 아티팩트 및 파일 공유](workflows-working-artifacts.md) 섹션을 참조하세요.
해당 UI: 입력 탭/**아티팩트 - 선택 사항**
## Outputs
(*CDKBootstrapAction*/**Outputs**)
(선택 사항)
워크플로 실행 중에 작업에 의해 출력되는 데이터를 정의합니다.
해당 UI: **출력** 탭
## Artifacts - output
(*CDKBootstrapAction*/Outputs/**Artifacts**)
(선택 사항)
작업에서 생성된 아티팩트를 지정합니다. 이러한 아티팩트를 다른 작업의 입력으로 참조할 수 있습니다.
예시를 포함해 아티팩트에 대한 자세한 내용은 [작업 간 아티팩트 및 파일 공유](workflows-working-artifacts.md) 섹션을 참조하세요.
해당 UI: 출력 탭/**아티팩트**
## Name
(*CDKBootstrapAction*/Outputs/Artifacts/**Name**)
([Artifacts - output](#cdk.boot.outputs.artifacts) 포함 시 필수)
런타임 시 **AWS CDK 부트스트랩** 작업으로 합성되는 CloudFormation 템플릿을 포함할 아티팩트의 이름을 지정합니다. 기본값은 `cdk_bootstrap_artifacts`입니다. 아티팩트를 지정하지 않으면 작업이 템플릿을 합성하지만 아티팩트에 저장하지는 않습니다. 테스트 또는 문제 해결을 위해 합성된 템플릿을 아티팩트에 저장하여 레코드를 보존하는 것이 좋습니다.
해당 UI: 출력 탭/아티팩트/아티팩트 추가/**빌드 아티팩트 이름**
## Files
(*CDKBootstrapAction*/Outputs/Artifacts/**Files**)
([Artifacts - output](#cdk.boot.outputs.artifacts) 포함 시 필수)
아티팩트에 포함할 파일을 지정합니다. AWS CDK 앱의 합성된 CloudFormation 템플릿을 `"cdk.out/**/*"` 포함하도록를 지정해야 합니다.
**참고**
`cdk.out` 는 합성된 파일이 저장되는 기본 디렉터리입니다. `cdk.json` 파일에 이외의 출력 디렉터리를 지정한 경우 대신 여기에 해당 디렉터리`cdk.out`를 지정합니다`cdk.out`.
해당 UI: 출력 탭/아티팩트/아티팩트 추가/**빌드에서 생성된 파일**
## Environment
(*CDKBootstrapAction*/**Environment**)
(필수)
작업에 사용할 CodeCatalyst 환경을 지정합니다. 작업은 선택한 환경에 지정된 AWS 계정 및 선택적 Amazon VPC에 연결됩니다. 작업은 환경에 지정된 기본 IAM 역할을 사용하여에 연결하고 [Amazon VPC 연결](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-vpcs.add.html)에 지정된 IAM 역할을 AWS 계정사용하여 Amazon VPC에 연결합니다.
**참고**
기본 IAM 역할에 작업에 필요한 권한이 없는 경우 다른 역할을 사용하도록 작업을 구성할 수 있습니다. 자세한 내용은 [작업의 IAM 역할 변경](deploy-environments-switch-role.md) 섹션을 참조하세요.
환경에 대한 자세한 내용은 [AWS 계정 및 VPCs에 배포](deploy-environments.md) 및 [환경 생성](deploy-environments-creating-environment.md) 섹션을 참조하세요.
해당 UI: 구성 탭/**환경**
## Name
(*CDKBootstrapAction*/Environment/**Name**)
([Environment](#cdk.boot.environment) 포함 시 필수)
작업과 연결하려는 기존 환경의 이름을 지정합니다.
해당 UI: 구성 탭/**환경**
## Connections
(*CDKBootstrapAction*/Environment/**Connections**)
(최신 버전의 작업에서는 선택 사항, 이전 버전에서는 필수)
작업과 연결할 계정 연결을 지정합니다. `Environment`에서 계정 연결을 최대 1개까지 지정할 수 있습니다.
계정 연결을 지정하지 않는 경우:
+ 작업은 CodeCatalyst 콘솔의 환경에 지정된 AWS 계정 연결 및 기본 IAM 역할을 사용합니다. 환경에 계정 연결 및 기본 IAM 역할을 추가하는 방법에 대한 자세한 내용은 [환경 생성](deploy-environments-creating-environment.md) 섹션을 참조하세요.
+ 기본 IAM 역할에는 작업에 필요한 정책 및 권한이 포함되어야 합니다. 이러한 정책 및 권한이 무엇인지 확인하려면 작업의 YAML 정의 설명서에서 **역할** 속성에 대한 설명을 참조하세요.
계정 연결에 대한 자세한 정보는 [연결된를 사용하여 AWS 리소스에 대한 액세스 허용 AWS 계정](ipa-connect-account.md) 섹션을 참조하세요. 환경에 계정 연결을 추가하는 방법에 대한 자세한 내용은 [환경 생성](deploy-environments-creating-environment.md) 섹션을 참조하세요.
해당 UI: 작업 버전에 따라 다음 중 하나:
+ (최신 버전) 구성 탭/환경/*내 환경*의 내용/점 3개 메뉴/**역할 전환**
+ (이전 버전) 구성 탭/'환경/계정/역할'/**AWS 계정 연결**
## Name
(*CDKBootstrapAction*/Environment/Connections/**Name**)
([Connections](#cdk.boot.environment.connections) 포함 시 필수)
계정 연결의 이름을 지정합니다.
해당 UI: 작업 버전에 따라 다음 중 하나:
+ (최신 버전) 구성 탭/환경/*내 환경*의 내용/점 3개 메뉴/**역할 전환**
+ (이전 버전) 구성 탭/'환경/계정/역할'/**AWS 계정 연결**
## Role
(*CDKBootstrapAction*/Environment/Connections/**Role**)
([Connections](#cdk.boot.environment.connections) 포함 시 필수)
**AWS CDK 부트스트랩** 작업이 부트스트랩 스택에 액세스 AWS 하고 추가하는 데 사용하는 IAM 역할의 이름을 지정합니다. [CodeCatalyst 스페이스에 역할을 추가](ipa-connect-account-addroles.md)했고 역할에 다음 정책이 포함되어 있는지 확인합니다.
IAM 역할을 지정하지 않으면 작업은 CodeCatalyst 콘솔의 [환경](deploy-environments.md)에 나열된 기본 IAM 역할을 사용합니다. 환경에서 기본 역할을 사용하는 경우 적절한 정책이 있는지 확인합니다.
원하는 경우 이 작업에서 `CodeCatalystWorkflowDevelopmentRole-spaceName` 역할을 사용할 수 있습니다. 이에 대한 자세한 내용은 [계정 및 스페이스의 **CodeCatalystWorkflowDevelopmentRole-*spaceName*** 역할 생성](ipa-iam-roles.md#ipa-iam-roles-service-create) 섹션을 참조하세요. `CodeCatalystWorkflowDevelopmentRole-spaceName` 역할에 보안 위험을 초래할 수 있는 전체 액세스 권한이 있음을 이해합니다. 보안에 대한 우려가 적은 자습서 및 시나리오에서만 이 역할을 사용하는 것이 좋습니다.
해당 UI: 작업 버전에 따라 다음 중 하나:
+ (최신 버전) 구성 탭/환경/*내 환경*의 내용/점 3개 메뉴/**역할 전환**
+ (이전 버전) 구성 탭/'환경/계정/역할'/**역할**
## Configuration
(*CDKBootstrapAction*/**Configuration**)
(필수)
작업의 구성 속성을 정의할 수 있는 섹션입니다.
해당 UI: **구성** 탭
## Region
(*CDKBootstrapAction*/Configuration/**Region**)
(필수)
부트스트랩 스택 AWS 리전 을 배포할를 지정합니다. 이 리전은 AWS CDK 앱이 배포된 리전과 일치해야 합니다. 리전 코드 목록은 [리전 엔드포인트](https://docs.aws.amazon.com/general/latest/gr/rande.html#region-names-codes)를 참조하세요.
해당 UI: 구성 탭/**리전**
## CdkCliVersion
(*CDKBootstrapAction*/Configuration/**CdkCliVersion**)
(선택 사항)
이 속성은 버전 1.0.13 이상의 **AWS CDK 배포** 작업과 버전 1.0.8 이상의 **AWS CDK 부트스트랩** 작업에서 사용할 수 있습니다.
다음 중 하나를 지정하세요.
+ 이 작업에서 사용할 AWS Cloud Development Kit (AWS CDK) 명령줄 인터페이스(CLI)( 도구 키트라고 AWS CDK 도 함)의 전체 버전입니다. 예시: `2.102.1`. 애플리케이션을 구축하고 배포할 때 일관성과 안정성을 보장하기 위해 전체 버전을 지정하는 것이 좋습니다.
또는
+ `latest`. CDK CLI의 최신 기능과 수정 사항을 활용하도록 `latest`를 지정하는 것이 좋습니다.
작업은 지정된 CLI 버전(또는 최신 버전)을 CodeCatalyst [빌드 이미지](build-images.md) AWS CDK 에 다운로드한 다음이 버전을 사용하여 CDK 애플리케이션을 배포하거나 환경을 부트스트랩 AWS 하는 데 필요한 명령을 실행합니다.
사용할 수 있는 지원되는 CDK CLI 버전 목록은 [AWS CDK 버전](https://docs.aws.amazon.com/cdk/api/versions.html) 섹션을 참조하세요.
이 속성을 생략하면 작업은 다음 주제 중 하나에 설명된 기본 AWS CDK CLI 버전을 사용합니다.
+ ['AWS CDK 배포' 작업에서 사용하는 CDK CLI 버전](cdk-dep-action.md#cdk-dep-action-cdk-version)
+ ["AWS CDK bootstrap" 작업에서 사용하는 CDK CLI 버전](cdk-boot-action.md#cdk-boot-action-cdk-version)
해당 UI: 구성 탭/**AWS CDK CLI 버전**