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

# sam pipeline bootstrap
<a name="sam-cli-command-reference-sam-pipeline-bootstrap"></a>

이 페이지에서는 AWS Serverless Application Model 명령줄 인터페이스(AWS SAM CLI) `sam local pipeline bootstrap` 하위 명령에 대한 참조 정보를 제공합니다.

에 대한 소개는 단원을 AWS SAM CLI참조하십시오. [란 무엇입니까 AWS SAM CLI?](what-is-sam-overview.md#what-is-sam-cli) 

`sam pipeline bootstrap` 하위 명령은 CI/CD 시스템에 연결하는 데 필요한 AWS 인프라 리소스를 생성합니다. **sam pipeline init** 명령을 실행하기 전에 파이프라인에서의 각 배포 단계에 대해 이 조치를 실행해야 합니다. 

이 하위 명령은 다음과 같은 AWS 인프라 리소스를 설정합니다.
+ 다음을 통해 파이프라인 권한을 구성하는 옵션:
  + CI/CD 시스템과 공유할 액세스 키 ID 및 액세스 키 보안 인증 정보를 가진 파이프라인 IAM 사용자입니다.
**참고**  
정기적으로 액세스 키를 교체하는 것이 좋습니다. 자세한 내용은 [IAM 사용자 가이드](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#rotate-credentials)의 * 장기 보안 인증 정보가 필요한 사용 사례의 경우 정기적으로 액세스 키 교체*를 참조하세요.
  + OIDC를 통해 CI/CD 플랫폼을 지원합니다. AWS SAM 파이프라인이 있는 OIDC 사용법에 대한 소개는 [AWS SAM 파이프라인에서 OIDC 인증을 사용하는 방법](deploying-with-oidc.md) 섹션을 참조하세요.
+  AWS SAM 애플리케이션을 배포 CloudFormation 하기 위해에서 수임하는 CloudFormation 실행 IAM 역할입니다.
+ 아 AWS SAM 티팩트를 보관할 Amazon S3 버킷입니다.
+ 선택적으로 컨테이너 이미지 Lambda 배포 패키지를 보관할 Amazon ECR 이미지 리포지토리(`Image` 패키지 유형의 리소스가 있는 경우)입니다. 

## 사용법
<a name="sam-cli-command-reference-sam-pipeline-bootstrap-usage"></a>

```
$ sam pipeline bootstrap <options>
```

## 옵션
<a name="sam-cli-command-reference-sam-pipeline-bootstrap-options"></a>

`--bitbucket-repo-uuid TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-bitbucket-repo-uuid"></a>
 Bitbucket 리포지토리의 UUID입니다. 이 옵션은 Bitbucket OIDC를 권한에 따라 사용하는 경우에만 해당합니다.  
이 값은 https://bitbucket.org/*workspace*/*repository*/admin/addon/admin/pipelines/openid-connect에서 찾을 수 있습니다 

`--bucket TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-bucket"></a>
아 AWS SAM 티팩트를 보관하는 Amazon S3 버킷의 ARN입니다.

`--cicd-provider TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-cicd-provider"></a>
 AWS SAM 파이프라인의 CI/CD 플랫폼입니다.

`--cloudformation-execution-role TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-cloudformation-execution-role"></a>
애플리케이션 스택을 배포하는 CloudFormation 동안가 수임할 IAM 역할의 ARN입니다. 자신의 역할을 사용하는 경우에만 입력합니다. 그렇지 않으면 명령으로 새 역할이 생성됩니다.

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-config-env"></a>
사용할 구성 파일의 기본 매개변수 값을 지정하는 환경 이름입니다. 기본값은 **default**입니다. 구성 파일에 대한 자세한 내용은 [AWS SAMCLI구성 파일](serverless-sam-cli-config.md) 섹션을 참조하세요.

`--config-file PATH`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-config-file"></a>
사용할 기본 매개변수 값이 들어있는 구성 파일의 경로 및 파일 이름입니다. 기본값은 프로젝트 디렉터리의 루트 내 `samconfig.toml`입니다. 구성 파일에 대한 자세한 내용은 [AWS SAMCLI구성 파일](serverless-sam-cli-config.md) 섹션을 참조하세요.

`--confirm-changeset | --no-confirm-changeset`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-confirm-changeset"></a>
리소스 배포를 확인하라는 메시지를 표시합니다.

`--create-image-repository | --no-create-image-repository`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-create-image-repository"></a>
Amazon ECR 이미지 리포지토리가 제공되지 않은 경우 이를 생성할지 여부를 지정하십시오. Amazon ECR 리포지토리는 Lambda 함수 또는 패키지 유형이 `Image`인 레이어의 컨테이너 이미지를 보관합니다. 기본값은 `--no-create-image-repository`입니다.

`--debug`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-debug"></a>
디버그 로깅을 켜서 AWS SAMCLI가 생성한 디버그 메시지를 인쇄하고 타임스탬프를 표시합니다.

`--deployment-branch TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-deployment-branch"></a>
배포가 시작될 브랜치의 이름입니다. 이 옵션은 권한에 GitHub Actions OIDC를 사용하는 경우에만 해당합니다.

`--github-org TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-github-org"></a>
리포지토리가 속한 GitHub 조직입니다. 조직이 없는 경우 리포지토리 소유자의 사용자 이름을 입력합니다. 이 옵션은 권한에 GitHub Actions OIDC를 사용하는 경우에만 해당합니다.

`--github-repo TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-github-repo"></a>
배포가 시작될 GitHub 리포지토리의 이름입니다. 이 옵션은 권한에 GitHub Actions OIDC를 사용하는 경우에만 해당합니다.

`--gitlab-group TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-gitlab-group"></a>
리포지토리가 속한 GitLab 그룹입니다. 이 옵션은 권한에 GitLab OIDC를 사용하는 경우에만 해당합니다.

`--gitlab-project TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-gitlab-project"></a>
GitLab 프로젝트 이름입니다. 이 옵션은 권한에 GitLab OIDC를 사용하는 경우에만 해당합니다.

`--help, -h`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-help"></a>
이 메시지를 표시한 후 종료합니다.

`--image-repository TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-image-repository"></a>
Lambda 함수 또는 패키지 유형이 `Image`인 레이어의 컨테이너 이미지를 보관하는 Amazon ECR 이미지 리포지토리의 ARN입니다. 제공된 경우 `--create-image-repository` 옵션은 무시됩니다. 제공되지 않은 경우 `--create-image-repository`이 지정되면 명령이 하나를 생성합니다.

`--interactive | --no-interactive`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-interactive"></a>
부트스트랩 매개변수에 대한 대화식 프롬프트를 비활성화하고 필수 매개변수가 누락되면 실패합니다. 기본값은 `--interactive`입니다. 이 명령에 관하여 `--stage`이 유일한 필수 매개변수입니다.  
`--no-interactive`이 `--use-oidc-provider`와 함께 지정된 경우, OIDC 공급자의 모든 필수 매개변수가 포함되어야 합니다.

`--oidc-client-id TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-oidc-client-id"></a>
OIDC 제공업체와 함께 사용하도록 구성된 클라이언트 ID입니다.

`--oidc-provider [github-actions | gitlab | bitbucket-pipelines]`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-oidc-provider"></a>
OIDC 권한에 사용될 CI/CD 제공업체의 명칭입니다. GitLab, GitHub, Bitbucket이 지원됩니다.

`--oidc-provider-url TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-oidc-provider-url"></a>
OIDC ID 제공업체의 URL입니다. 값은 **https://**로 시작해야 합니다.

`--permissions-provider [oidc | iam]`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-permissions-provider"></a>
파이프라인 실행 역할을 맡을 권한 제공업체를 선택합니다. 기본값은 **iam**입니다.

`--pipeline-execution-role TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-pipeline-execution-role"></a>
파이프라인 사용자가 이 단계에서 운영하도록 위임하는 IAM 역할의 ARN입니다. 자신의 역할을 사용하는 경우에만 입력합니다. 지정하지 않은 경우 이 명령은 새 역할을 생성합니다.

`--pipeline-user TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-pipeline-user"></a>
액세스 키 ID와 비밀 액세스 키를 CI/CD 시스템과 공유하는 IAM 사용자의 Amazon 리소스 이름(ARN)입니다. 이 IAM 사용자에게 해당 AWS 계정에 액세스할 수 있는 권한을 부여하는 데 사용됩니다. 제공하지 않는 경우 명령은 액세스 키 ID 및 보안 액세스 키 보안 인증 정보와 함께 IAM 사용자를 생성합니다.

`--profile TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-profile"></a>
자격 증명을 가져오는 AWS 자격 증명 파일의 특정 프로필입니다.

`--region TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-region"></a>
배포할 AWS 리전입니다. 예를 들어 `us-east-1`입니다.

`--save-params`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-save-params"></a>
명령줄에 제공한 파라미터를 AWS SAM 구성 파일에 저장합니다.

`--stage TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-stage"></a>
해당하는 배포 단계의 이름입니다. 생성된 AWS 인프라 리소스의 접미사로 사용됩니다.

## 문제 해결
<a name="sam-cli-command-reference-sam-pipeline-bootstrap-troubleshooting"></a>

### 오류: 필수 매개변수 누락
<a name="sam-cli-command-reference-sam-pipeline-bootstrap-troubleshooting-example1"></a>

`--no-interactive`이 `--use-oidc-provider`와 함께 지정되었지만 필수 매개변수가 제공되지 않은 경우 이 오류 메시지가 누락된 매개변수에 대한 설명과 함께 표시됩니다. 

## 예제
<a name="sam-cli-command-reference-sam-pipeline-bootstrap-examples"></a>

다음 예제에서는 CI/CD 시스템을 생성하는 데 필요한 AWS 리소스를 생성하고 디버그 로깅을 켜고에서 생성된 디버그 메시지를 인쇄합니다 AWS SAM CLI.는 이벤트를 사용하여 로컬에서 Lambda 함수를 호출하여 로컬 테스트에 생성된 `s3.json` 이벤트를 사용합니다.

```
$ sam pipeline bootstrap --debug
```