AWS Cloud9 는 더 이상 신규 고객이 사용할 수 없습니다. AWS Cloud9 의 기존 고객은 정상적으로 서비스를 계속 이용할 수 있습니다. [자세히 알아보기](https://aws.amazon.com/blogs/devops/how-to-migrate-from-aws-cloud9-to-aws-ide-toolkits-or-aws-cloudshell/)
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 다른 AWS 서비스 작업
를 사용할 때 AWS Cloud9, Amazon Lightsail AWS CodeStar및와 긴밀하게 작업할 수 있습니다 AWS CodePipeline. 이를 수행하는 방법이 이 섹션의 주제입니다.
**중요**
AWS 도구 키트 기능은 AWS Lambda AWS Serverless Application Model및 Amazon S3와 같은 주요 AWS 서비스를 사용하기 위한 편리한 시각적 인터페이스를 제공합니다. 자세한 내용은 [AWS 도구 키트 작업](toolkit-welcome.md) 단원을 참조하십시오.
**Topics**
+ [Amazon Lightsail 인스턴스로 작업](lightsail-instances.md)
+ [작업 AWS CodePipeline](codepipeline-repos.md)
+ [CodeCatalyst 작업](ide-toolkits-cloud9.md)
+ [작업 AWS CDK](cdk-explorer.md)
# AWS Cloud9 IDE의 Amazon Lightsail 인스턴스 작업
AWS Cloud9 IDE를 사용하여 널리 사용되는 애플리케이션 및 프레임워크로 미리 구성된 Amazon Lightsail 인스턴스에서 코드를 사용할 수 있습니다. 여기에는 WordPress, LAMP(Linux, Apache, MySQL 및 PHP), Node.js, NGINX, Drupal 및 Joomla가 포함됩니다. Amazon Linux, Ubuntu, Debian, FreeBSD 및 openSUSE 등의 Linux 배포판이 포함됩니다.
Lightsail는 편리하고 빠른 설정 가상 프라이빗 서버 솔루션을 제공합니다. Lightsail는 컴퓨팅, 스토리지 및 네트워킹 용량과 클라우드에서 웹 사이트 및 웹 애플리케이션을 배포하고 관리하는 기능을 제공합니다. Lightsail을 사용하면 저렴하고 예측 가능한 월별 요금으로 프로젝트를 빠르게 시작할 수 있습니다. 자세한 내용은 [Amazon Lightsail 기능](https://amazonlightsail.com/features/)을 참조하세요.
이 주제에서는와 호환되는 Linux 기반 Lightsail 인스턴스를 생성하고 설정합니다 AWS Cloud9. 그런 다음 AWS Cloud9 SSH 개발 환경을 생성하고 Lightsail 인스턴스에 연결합니다.
**참고**
이러한 절차를 완료하면 요금이 발생할 수 있습니다 AWS 계정. 여기에는 Lightsail과 같은 서비스에 대해 발생할 수 있는 요금이 포함됩니다. 자세한 내용은 [Amazon Lightsail요금](https://aws.amazon.com/lightsail/pricing/)을 참조하세요.
AWS Cloud9 IDE를 사용하여 샘플 코드가 없는 Amazon Linux 또는 Ubuntu Server를 실행하는 Amazon EC2 인스턴스로 작업하려면 섹션을 참조하세요[시작하기: 기본 자습서](tutorials-basic.md).
+ [1단계: Linux 기반 Lightsail 인스턴스 생성](#lightsail-instances-create)
+ [2단계:와 함께 사용할 인스턴스 설정 AWS Cloud9](#lightsail-instances-setup)
+ [3단계: AWS Cloud9 SSH 개발 환경 생성 및 연결](#lightsail-instances-environment)
+ [4단계: AWS Cloud9 IDE를 사용하여 인스턴스에서 코드 변경](#lightsail-instances-change-code)
## 1단계: Linux 기반 Lightsail 인스턴스 생성
이 단계에서는 Lightsail 콘솔을 사용하여 Linux 기반 배포판에서 앱을 실행하는 Amazon EC2 인스턴스를 생성합니다. 이 인스턴스에는 다음 사항이 자동으로 포함됩니다.
+ 퍼블릭 및 프라이빗 IP 주소. (나중에 정적 퍼블릭 IP를 생성할 수 있습니다.)
+ SSH(포트 22), HTTP(포트 80) 및 HTTPS(포트 443)를 사용하여 인스턴스에 액세스. (이 설정은 변경할 수 있습니다.)
+ 블록 스토리지 디스크 (나중에 추가 디스크를 연결할 수 있습니다.)
+ 기본 제공 시스템 보고 기능.
Lightsail 콘솔에서는 인스턴스를 나중에 백업, 재부팅, 중지 또는 삭제할 수 있습니다.
1. 를 열고 [https://lightsail.aws.amazon.com](https://lightsail.aws.amazon.com) Lightsail 콘솔에 로그인합니다.
AWS 계정의 IAM 관리자 사용자용 보안 인증 정보를 사용하여 로그인하는 것이 좋습니다. IAM 관리자 사용자로 로그인할 수 없으면 AWS 계정 관리자에게 문의하세요.
1. 해당 메시지가 표시되면 콘솔에서 사용할 언어를 선택하고 나서 **저장**을 선택합니다.
1. 해당 메시지가 표시되면 **시작하기**를 선택합니다.
1. 홈 페이지에 이미 선택되어 있는 **인스턴스** 탭에서 **인스턴스 생성**을 선택합니다.
![\[Lightsail 콘솔에서 인스턴스 생성 버튼 선택\]](http://docs.aws.amazon.com/ko_kr/cloud9/latest/user-guide/images/console-lightsail-create-instance.png)
1. **인스턴스 위치의 경우** 인스턴스를 생성하려는 위치를 AWS 리전 AWS Cloud9 사용할 수 있는지 확인합니다. 자세한 내용은 *Amazon Web Services 일반 참조*의 [AWS Cloud9](https://docs.aws.amazon.com/general/latest/gr/rande.html#cloud9_region) 섹션을 참조하세요. AWS 리전, 가용 영역 또는 둘 다를 변경하려면 ** AWS 리전 및 가용 영역 변경을** 선택한 다음 화면의 지침을 따릅니다.
1. [**인스턴스 이미지 선택(Pick your instance image)**]에서 [**플랫폼 선택(Select a platform)**]에 [**Linux/Unix**]가 이미 선택되어 있고 [**블루프린트 선택(Select a blueprint)**]에 [**Apps \$1 OS**]가 이미 선택되어 있는 상태로 블루프린트를 선택합니다.
![\[Lightsail 콘솔에서 인스턴스 플랫폼 및 블루프린트 선택\]](http://docs.aws.amazon.com/ko_kr/cloud9/latest/user-guide/images/console-lightsail-pick-instance-image.png)
**참고**
앱이 없는 인스턴스를 생성하려면 [**Apps \$1 OS**] 대신 [**OS만(OS Only)**]을 선택한 다음 배포판을 선택합니다.
사용 가능한 선택 사항에 대한 자세한 내용은 Lightsail 웹사이트에서 [Amazon Lightsail 인스턴스 이미지 선택](https://lightsail.aws.amazon.com/ls/docs/getting-started/article/compare-options-choose-lightsail-instance-image)을 참조하세요.
1. **인스턴스 계획 선택**에서 계획을 선택하거나 선택된 기본 계획을 그대로 사용합니다.
1. **인스턴스 이름 지정**에서 인스턴스의 이름을 입력하거나 제안된 기본 이름을 그대로 사용합니다.
1. 인스턴스 수에는 생성할 인스턴스 수를 입력하거나 기본값인 단일 인스턴스(**x 1**)를 그대로 유지합니다.
1. **생성(Create)**을 선택합니다.
## 2단계: 인스턴스를와 함께 사용하도록 설정 AWS Cloud9
이 단계에서는 실행 중인 인스턴스에 연결한 다음 나중에에서 사용할 AWS Cloud9 수 있도록 설정합니다.
**참고**
다음 지침에서는 이전 단계에서 **앱 \$1 OS**를 선택했다고 가정합니다. **OS 전용**과 배포판(**Ubuntu** 이외)을 선택한 경우 다음 지침에 따라 조정해야 할 수도 있습니다.
1. 이전 단계의 Lightsail 콘솔이 열려 있는 상태로 **인스턴스** 탭의 인스턴스 카드에서 인스턴스의 이름을 선택합니다.
![\[Lightsail 콘솔에서 인스턴스 세부 정보를 표시하도록 선택\]](http://docs.aws.amazon.com/ko_kr/cloud9/latest/user-guide/images/console-lightsail-show-instance-details.png)
1. **Connect**(연결) 탭의 **Connect using your own SSH client**(자체 SSH 클라이언트를 사용하여 연결)에 표시된 **퍼블릭 IP**와 **사용자 이름** 값을 적어둡니다. 나중에 이들 값이 필요합니다.
![\[Lightsail 콘솔에 표시되는 인스턴스 퍼블릭 주소 및 사용자 이름\]](http://docs.aws.amazon.com/ko_kr/cloud9/latest/user-guide/images/console-lightsail-instance-ip-user.png)
1. **SSH를 사용하여 연결**을 선택합니다.
1. 인스턴스에 최신 시스템 업데이트가 있는지 확인합니다. 이렇게 하려면 표시되는 터미널 세션에서 ** `sudo apt update` ** 명령을 실행합니다.
1. Python이 설치되었는지 확인하고 설치된 경우 버전이 2.7인지 확인합니다. 버전을 확인하려면 **`python --version`** 명령을 실행하고 표시되는 버전 번호를 적어둡니다. 버전 번호가 표시되지 않거나 버전이 2.7이 아니면 ** `sudo apt install -y python-minimal` ** 명령을 실행하여 인스턴스에 Python 2.7을 설치합니다.
1. Node.js가 설치되었는지 확인하고 설치된 경우 버전이 0.6.16 또는 그 이후 버전인지 확인합니다. 버전을 확인하려면 **`node --version`** 명령을 실행하고 표시되는 버전 번호를 적어둡니다. 버전 번호가 표시되지 않거나 버전이 0.6.16 또는 그 이후 버전이 아닐 경우, Node Version Manager(nvm)를 사용하여 인스턴스에 Node.js를 설치하는 것이 좋습니다.
이렇게 하려면 다음 명령을 다음 순서에 따라 한 번에 하나씩 실행하여 인스턴스를 업데이트하고 인스턴스에 Node Version Manager(nvm)를 설치한 다음, 인스턴스에서 nvm을 활성화하고 나서 인스턴스에 Node.js의 최신 버전을 설치합니다.
```
sudo apt update
curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.33.0/install.sh | bash
. ~/.bashrc
nvm install node
```
1. **`which node`** 명령을 실행하고 표시되는 값을 적어둡니다. 잠시 후 필요한 정보입니다.
**참고**
명령의 출력**`which node`**이와 같은 경우 `/usr/sbin/node`는 해당 경로에서 Node.js를 찾을 AWS Cloud9 수 없습니다. 대신에 이 절차의 이전 단계에 설명된 대로 `nvm`을 사용하여 Node.js를 설치합니다. 그런 다음 `which node` 명령을 다시 실행하고 표시되는 새 값을 적어둡니다.
1. 인스턴스[에서 AWS Cloud9 설치 프로그램을 다운로드하고 실행합니다](installer.md#installer-download-run).
## 3단계: AWS Cloud9 SSH 개발 환경 생성 및 연결
이 단계에서는 AWS Cloud9 콘솔과 인스턴스의 터미널을 사용하여 SSH 환경을 생성한 다음 실행 중인 인스턴스에 환경을 연결합니다.
1. 이전 단계에서 터미널 세션을 열어 둔 상태에서 다음과 같이 AWS Cloud9 콘솔에 로그인합니다.
+ 를 사용하는 유일한 개인 AWS 계정 이거나 단일에서 IAM 사용자인 경우 [https://console.aws.amazon.com/cloud9/](https://console.aws.amazon.com/cloud9/) AWS 계정이동합니다.
+ 조직에서를 사용하는 경우 관리자에게 AWS 계정 로그인 지침을 AWS IAM Identity Center문의하세요.
**참고**
이 단계에서는 두 가지 다른를 AWS 서비스 동시에 사용합니다. Lightsail 콘솔에 IAM 관리자 사용자로 로그인했지만 다른 엔터티에서 새 SSH 환경을 소유하도록 하려는 경우를 가정해 보겠습니다. 이 경우 다른 웹 브라우저를 열고 해당 엔티티로 AWS Cloud9 콘솔에 로그인하는 것이 좋습니다.
1. AWS Cloud9 콘솔에서 프레임워크에서 인스턴스를 생성한 것과 AWS 리전 일치하는를 선택합니다.
![\[AWS AWS Cloud9 콘솔의 리전 선택기\]](http://docs.aws.amazon.com/ko_kr/cloud9/latest/user-guide/images/consolas_region_new_UX.png)
1. 시작 페이지가 표시되면 **새 AWS Cloud9 환경에서** **환경 생성을** 선택합니다. 그렇지 않으면 **Create environment**(환경 생성)를 선택합니다.
![\[환경 페이지가 표시되면 다음 단계 버튼 선택\]](http://docs.aws.amazon.com/ko_kr/cloud9/latest/user-guide/images/create_welcome_env_new_UX.png)
또는 다음과 같습니다.
![\[시작 페이지가 표시되지 않으면 Create environment(환경 생성) 버튼 선택\]](http://docs.aws.amazon.com/ko_kr/cloud9/latest/user-guide/images/console_create_env_new_UX.png)
1. [**환경 이름 지정(Name environment)**] 페이지의 [**이름(Name)**]에 환경의 이름을 입력합니다.
1. 환경에 설명을 추가하려면 **설명** 필드에 내용을 입력합니다.
1. **환경 유형**에서 **기존 컴퓨팅**을 선택합니다. 이는 **사용자** 및 **호스트** 옵션을 표시하려면 이 옵션을 선택해야 하므로 중요합니다.
1. **User**(사용자)에 앞에서 적어둔 **User name**(사용자 이름) 값을 입력합니다.
1. **Host**(호스트)에 앞에서 적어둔 **Public IP**(퍼블릭 IP) 값을 입력합니다.
1. **포트**에서 기본값 **22**를 그대로 둡니다.
1. **추가 세부 정보**를 확장합니다.
1. **환경 경로**에 로그인 후에서 AWS Cloud9 시작하는 경로인를 입력합니다`~/`. 이것은 사용자의 홈 디렉터리 루트입니다.
1. **Node.js 바이너리 경로**에 앞에서 적어둔 **`which node`** 명령의 값을 입력합니다.
1. **SSH jump host(SSH 점프 호스트)**를 비워 둡니다.
1. 가이 환경에 대해 AWS Cloud9 생성하는 퍼블릭 SSH 키를 시스템 클립보드에 저장합니다. 이렇게 하려면 **Copy key to clipboard(클립보드에 키 복사)**를 선택합니다.
**참고**
복사된 퍼블릭 SSH 키 값을 보려면 **View public SSH key(퍼블릭 SSH 키 보기)**를 확장합니다.
1. 방금 복사했던 퍼블릭 SSH 키 값을 인스턴스에 저장합니다. 이렇게 하려면 인스턴스에 이미 설치되어 있는 널리 사용되는 텍스트 편집기인 vi를 사용합니다.
1. 인스턴스의 터미널 세션에서 **`vi ~/.ssh/authorized_keys`** 명령을 실행합니다.
1. 화면에 표시되는 vi 편집기에서 파일의 끝으로 이동하여 삽입 모드로 전환합니다. 이렇게 하려면 `I` 키를 누른 다음 `A` 키를 누릅니다. (**-- INSERT --**가 vi 편집기의 하단에 표시됩니다.)
1. `Enter`를 두 번 눌러서 파일 끝에 캐리지 리턴 두 개를 추가합니다.
1. 시스템 클립보드의 내용(방금 복사한 퍼블릭 SSH 키 값을 포함함)을 터미널 세션 클립보드에 붙여 넣습니다. 이렇게 하려면 터미널 세션 창의 아래 모서리에서 클립보드 버튼을 선택한 다음 시스템 클립보드의 내용을 상자에 붙여 넣습니다.
![\[Lightsail 터미널 세션 클립보드 열기\]](http://docs.aws.amazon.com/ko_kr/cloud9/latest/user-guide/images/console-lightsail-terminal-clipboard.png)
1. 터미널 세션 클립보드의 내용을 vi 편집기에 붙여 넣습니다. 이렇게 하려면 vi 편집기의 삽입점에서 `Ctrl + Shift + V`를 누릅니다.
1. 파일을 저장합니다. 이렇게 하려면 `Esc` 키를 눌러 명령 모드로 들어갑니다. (**-- INSERT --**가 vi 편집기의 하단에서 사라집니다.) `:wq`(파일을 `write`하고 나서 vi 편집기를 `quit`)를 입력한 다음 `Enter` 키를 누릅니다.
1. AWS Cloud9 콘솔로 돌아가**서 다음 단계를** 선택합니다.
1. **Review choices(선택 항목 검토)** 페이지에서 **Create environment(환경 생성)**를 선택합니다. 가 환경을 AWS Cloud9 생성하는 동안 기다린 다음 환경에 대한 AWS Cloud9 IDE를 표시합니다. 몇 분 정도 걸릴 수 있습니다.
가 환경을 AWS Cloud9 생성하면 환경에 대한 AWS Cloud9 IDE가 표시됩니다.
AWS Cloud9 가 최소 5분 후에도 IDE를 표시하지 않으면 웹 브라우저, AWS 액세스 권한, 인스턴스 또는 연결된 Virtual Private Cloud(VPC)에 문제가 있을 수 있습니다. 가능한 해결 방법은 *문제 해결*에서 [환경을 열 수 없음](troubleshooting.md#troubleshooting-env-loading) 섹션을 참조하세요.
## 4단계: AWS Cloud9 IDE를 사용하여 인스턴스의 코드 변경
IDE가 새 환경에 대해 표시되고, Lightsail 터미널 세션 대신에 IDE의 터미널 세션을 사용할 수 있습니다. IDE는 여러 프로그래밍 언어 및 런타임 디버거를 지원하는 풍부한 코드 편집 환경을 제공합니다. IDE는 색상 테마, 바로 가기 키 결합, 프로그래밍 언어별 구문 색상 지정 및 코드 서식 지정 등도 포함합니다.
IDE 사용 방법을 배우려면 [AWS Cloud9 IDE 둘러보기](tour-ide.md) 섹션을 참조하세요.
인스턴스에서 코드를 변경하는 방법에 대해 알아보려면 다음 리소스를 사용하는 것이 좋습니다
+ Lightsail 웹 사이트에서 **All** ['Bitnami 제공' Lightsail 이미지에 대한 애플리케이션 암호 가져오기](https://lightsail---aws.amazon.com.rproxy.govskope.cals/docs/how-to/article/log-in-to-your-bitnami-application-running-on-amazon-lightsail)
+ **Drupal**: [BitnamiDrupal - Bitnami 웹 사이트의 AWS 클라우드](https://docs.bitnami.com/aws/apps/drupal/)와 Drupal 웹 사이트의 [튜토리얼 및 사이트 레시피](https://www.drupal.org/node/627198)
+ **GitLab CE**: [BitnamiGitLab CE - Bitnami 웹 사이트의 AWS 클라우드](https://docs.bitnami.com/aws/apps/gitlab/) 및 GitLab 웹 사이트의 [GitLab 설명서](https://docs.gitlab.com/ce/)
+ **Joomla**: [BitnamiJoomla\$1 - Bitnami 웹 사이트의 AWS 클라우드](https://docs.bitnami.com/aws/apps/joomla/), [Joomla\$1 웹 사이트에서 Joomla\$1 시작하기](https://www.joomla.org/about-joomla/getting-started.html)
+ **LAMP 스택**: [BitnamiLAMP - Bitnami 웹 사이트의 AWS 클라우드](https://docs.bitnami.com/aws/infrastructure/lamp/)
+ **Magento**: [BitnamiMagento - Bitnami 웹 사이트의 AWS 클라우드](https://docs.bitnami.com/aws/apps/magento/), Magento 웹 사이트의 [Magento User Guide](http://docs.magento.com/m1/ce/user_guide/getting-started.html)
+ **MEAN**: [BitnamiMEAN - Bitnami 웹 사이트의 AWS 클라우드](https://docs.bitnami.com/aws/infrastructure/mean/)
+ **NGINX**: [BitnamiNGINX - Bitnami 웹 사이트의 AWS 클라우드](https://docs.bitnami.com/aws/infrastructure/nginx/), NGINX 웹 사이트의 [NGINX Wiki](https://www.nginx.com/resources/wiki/)
+ **Node.js**: [BitnamiNode.Js - Bitnami 웹 사이트의 AWS 클라우드](https://docs.bitnami.com/aws/infrastructure/nodejs/), Node.js 웹 사이트의 [시작 안내서](https://nodejs.org/en/docs/guides/getting-started-guide/)
+ **Ubuntu의 Plesk 호스팅 스택**: [Amazon Lightsail에서 Plesk를 설정하고 구성합니다](https://aws.amazon.com/getting-started/hands-on/plesk-on-aws/).
+ **Redmine**: [Bitnami Redmine - Bitnami 웹 사이트의 AWS 클라우드](https://docs.bitnami.com/aws/apps/redmine/), Redmine 웹 사이트에서 [시작하기](http://www.redmine.org/projects/redmine/wiki/Getting_Started)
+ **WordPress**: Lightsail 웹 사이트의 [Amazon Lightsail 인스턴스에서 WordPress 사용 시작하기](https://lightsail.aws.amazon.com/ls/docs/en_us/articles/amazon-lightsail-tutorial-launching-and-configuring-wordpress) 및 Bitnami 웹 사이트의 [AWS 클라우드용 Bitnami WordPress](https://docs.bitnami.com/aws/apps/wordpress/)
# AWS Cloud9 IDE AWS CodePipeline 에서 작업
AWS Cloud9 통합 개발 환경(IDE)을 사용하여와 호환되는 리포지토리의 소스 코드를 사용할 수 있습니다 AWS CodePipeline.
CodePipeline은 소프트웨어 릴리스에 필요한 단계를 모델링, 시각화 및 자동화하는 데 사용할 수 있는 지속적 전달 서비스입니다. CodePipeline을 사용하여 소프트웨어 릴리스 프로세스의 다양한 단계를 신속하게 모델링하고 구성할 수 있습니다. 자세한 내용은 [AWS CodePipeline 사용 설명서](https://docs.aws.amazon.com/codepipeline/latest/userguide/welcome.html)를 참조하십시오.
**참고**
이러한 절차를 완료하면 AWS 계정에 요금이 부과될 수 있습니다. 여기에는 Amazon EC2, CodePipeline, Amazon S3 및 CodePipeline에서 지원하는 서비스와 같은 AWS 서비스에 대해 발생할 수 있는 요금이 포함됩니다. 자세한 내용은 [Amazon EC2 요금](https://aws.amazon.com/ec2/pricing/), [AWS CodePipeline 요금](https://aws.amazon.com/codepipeline/pricing/), [Amazon S3 요금](https://aws.amazon.com/s3/pricing/) 및 [클라우드 서비스 요금](https://aws.amazon.com/pricing/services/)을 참조하세요.
+ [1단계: 소스 코드 리포지토리 만들기 또는 식별](#codepipeline-repos-create-source-code)
+ [2단계: AWS Cloud9 개발 환경을 생성하고, 이 환경을 코드 리포지토리에 연결한 다음, 코드 업로드](#codepipeline-repos-connect-to-repo)
+ [3단계: 작업 준비 AWS CodePipeline](#codepipeline-repos-setup)
+ [4단계:에서 파이프라인 생성 AWS CodePipeline](#codepipeline-repos-create-pipeline)
## 1단계: 소스 코드 리포지토리 만들기 또는 식별
이 단계에서는 CodePipeline과 호환되는 소스 코드 리포지토리를 생성하거나 식별합니다.
이 주제의 뒷부분에서 소프트웨어의 소스 코드를 해당 리포지토리에 업로드합니다. CodePipeline은 생성한 관련 파이프라인을 사용하여 해당 리포지토리에서 업로드한 소스 코드를 빌드, 테스트 및 배포합니다.
소스 코드 리포지토리는 CodePipeline에서 지원하는 다음 리포지토리 유형 중 하나여야 합니다.
+ **AWS CodeCommit**. 사용할 리포지토리가 CodeCommit에 이미 있는 경우 [2단계: AWS Cloud9 개발 환경을 생성하고, 이 환경을 코드 리포지토리에 연결한 다음, 코드 업로드](#codepipeline-repos-connect-to-repo)로 진행합니다. 그렇지 않고 CodeCommit을 사용하려면 *AWS CodeCommit 샘플*의 다음 지침을 다음 순서로 따른 다음 이 주제로 돌아옵니다.
+ [1단계: 필요한 액세스 권한을 사용하여 IAM 그룹 설정](sample-codecommit.md#sample-codecommit-permissions)
+ [2단계: AWS CodeCommit에서 리포지토리 생성](sample-codecommit.md#sample-codecommit-create-repo)
+ **Amazon S3**. Amazon S3에 사용하려는 버킷이 이미 있는 경우 [2단계: AWS Cloud9 개발 환경 생성, 코드 리포지토리에 연결, 코드 업로드로 건너뜁니다](#codepipeline-repos-connect-to-repo). 그렇지 않은 경우 Amazon S3를 사용하려면 *Amazon Simple Storage Service 사용 설명서*의 지침을 이 순서대로 따른 후 이 주제로 돌아오십시오.
+ [Amazon S3에 가입](https://docs.aws.amazon.com/AmazonS3/latest/gsg/SigningUpforS3.html)
+ [버킷 만들기](https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-bucket.html)
+ **GitHub**. GitHub에 리포지토리가 이미 있는 경우, [Git 패널](source-control-gitpanel.md) 인터페이스를 사용하여 이를 복제하고 개발 환경에서 로컬 사본을 만들 수 있습니다. GitHub에 아직 계정 또는 리포지토리가 설정되어 있지 않은 경우 [관련 문서](https://docs.github.com/en/github)에서 자세한 지침을 참조하세요.
## 2단계: AWS Cloud9 개발 환경 생성, 코드 리포지토리에 연결, 코드 업로드
이 단계에서는 AWS Cloud9 콘솔에서 AWS Cloud9 개발 환경을 생성합니다. 그런 다음 CodePipeline이 사용할 리포지토리에 환경을 연결합니다. 마지막으로 환경에 IDE를 사용하여 소스 코드를 AWS Cloud9 리포지토리에 업로드합니다.
환경을 생성하려면 [환경 생성](create-environment.md)의 지침을 따른 다음 이 주제로 돌아옵니다. (환경이 이미 있으면 해당 환경을 사용할 수 있으며, 새로 생성할 필요가 없습니다.)
환경을 리포지토리에 연결한 다음, 이 위치에 아직 없는 경우 소스 코드를 리포지토리에 업로드하려면 다음 지침 중 하나를 사용합니다. 선택하는 지침은 소스 코드를 저장하는 리포지토리의 유형에 따라 다릅니다.
****
| **리포지토리 유형** | **지침** |
| --- | --- |
| CodeCommit | *AWS CodeCommit 샘플*의 다음 지침을 따릅니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/cloud9/latest/user-guide/codepipeline-repos.html) |
| Amazon S3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/cloud9/latest/user-guide/codepipeline-repos.html) |
| GitHub | [Git 패널](source-control-gitpanel.md) 인터페이스를 사용하여 GitHub에서 호스트되는 리포지토리를 복제하고 상호 작용할 수 있습니다. |
환경을 리포지토리에 연결한 후 소스 코드 변경 사항을 AWS Cloud9 IDE에서 리포지토리로 푸시할 때마다 CodePipeline은 빌드, 테스트 및 배포할 관련 파이프라인을 통해 이러한 변경 사항을 자동으로 전송합니다. 이 주제의 뒷부분에서 관련 파이프라인을 생성합니다.
## 3단계: 작업 준비 AWS CodePipeline
이 단계에서는 [팀 설정](setup.md)에서 생성하거나 식별한 IAM 그룹에 특정 AWS 관리형 정책을 연결합니다. 이렇게 하면 그룹 사용자가 CodePipeline에서 파이프라인 생성 및 작업을 시작할 수 있습니다.
전에 CodePipeline을 사용한 적이 있는 경우 [4단계: AWS CodePipeline에서 파이프라인 생성](#codepipeline-repos-create-pipeline)으로 진행합니다.
이 단계에서는 *AWS CodePipeline 사용 설명서*의 [3단계: IAM 관리형 정책을 사용하여 IAM 사용자에게 AWS CodePipeline권한 할당](https://docs.aws.amazon.com/codepipeline/latest/userguide/getting-started-codepipeline.html#assign-permissions)의 지침을 따른 다음이 주제로 돌아갑니다.
## 4단계:에서 파이프라인 생성 AWS CodePipeline
이 단계에서는 이 주제의 앞부분에서 생성하거나 식별한 리포지토리를 사용하는 파이프라인을 CodePipeline에서 생성합니다.
이 단계에서는 *AWS CodePipeline 사용 설명서*의 [AWS CodePipeline에서 파이프라인 생성](https://docs.aws.amazon.com/codepipeline/latest/userguide/pipelines-create.html)에 나와 있는 지침을 따릅니다.
파이프라인을 생성한 후 CodePipeline은 빌드, 테스트 및 배포할 파이프라인을 통해 리포지토리에 있는 현재 버전의 소스 코드를 보냅니다. 그런 다음 소스 코드 변경 사항을 AWS Cloud9 IDE에서 리포지토리로 푸시할 때마다 CodePipeline은 빌드, 테스트 및 배포할 파이프라인을 통해 이러한 변경 사항을 자동으로 전송합니다.
파이프라인을 보려면 *AWS CodePipeline 사용 설명서*의 [AWS CodePipeline에서 파이프라인 세부 정보 및 이력 보기](https://docs.aws.amazon.com/codepipeline/latest/userguide/pipelines-view.html)에 나와 있는 지침을 따릅니다.
# Amazon CodeCatalyst 작업
Amazon CodeCatalyst는 소프트웨어 개발 팀을 위한 클라우드 기반 협업 공간입니다. CodeCatalyst는 CI/CD(지속적 통합/전달) 도구를 사용하여 작업하고, 코드를 공동 작업하고, 애플리케이션을 구축, 테스트 및 배포할 수 있는 통합된 장소입니다. 를 CodeCatalyst 스페이스에 연결하여 AWS 리소스 AWS 계정와 프로젝트를 연결할 수 있습니다. 또한 CodeCatalyst를 사용하여 소프트웨어를 빠르고 확실하게 제공할 수 있습니다. Codecatalyst에 대한 자세한 내용은 Amazon CodeCatalyst 설명서의 [What is Amazon CodeCatalyst?](https://docs.aws.amazon.com/codecatalyst/latest/userguide/devenvironment.html)(Amazon CodeCatalyst란 무엇입니까?)를 참조하세요.**
Dev Environment는 CodeCatalyst에서 프로젝트의 소스 리포지토리에 저장된 코드를 작업하는 데 사용할 수 있는 클라우드 기반 개발 환경입니다. CodeCatalyst에서 개발 환경을 생성할 수 있습니다. 그런 다음 지원되는 통합 개발 환경(IDE)을 사용하여 프로젝트별 CodeCatalyst에서 코드 작업을 수행할 수 있습니다. 또는 빈 개발 환경을 만들고 타사 리포지토리의 코드를 복제하여 지원되는 IDE로 작업할 수도 있습니다.
CodeCatalyst 콘솔에서 개발 환경에 액세스하는 데 사용되는 AWS Cloud9 IDE는에서 실행되는 AWS Cloud9 IDE와 다릅니다 AWS. CodeCatalyst AWS Cloud9 IDE에서는 CodeCatalyst에 자동으로 로그인되며 IDE 내의 **aws-explorer** 옵션을 사용하여 서비스에 액세스할 수 있습니다. AWS 도구 키트에 대한 자세한 내용은 *AWS Cloud9 가이드*의 [AWS 도구 키트를 AWS Cloud9](https://docs.aws.amazon.com/cloud9/latest/user-guide/toolkit-welcome.html) 참조하세요.
**Topics**
+ [에서 Amazon CodeCatalyst 시작하기 AWS Cloud9](ide-toolkits-cloud9-getstarted.title.md)
+ [에서 Amazon CodeCatalyst AWS Cloud9 로 마이그레이션](c9-replication-cc.md)
+ [복제 도구 사용](c9-replication-cc-tool.md)
+ [복제 프로세스에 대한 FAQ](faqs-replication-tool.md)
+ [Amazon CodeCatalyst에서의 Dev Environment](devenvironment-cloud9.title.md)
# 에서 Amazon CodeCatalyst 시작하기 AWS Cloud9
이 섹션에서는 CodeCatalyst를 사용하여 시작하는 방법을 간략히 살펴봅니다. 이 섹션의 주제에서는 Amazon CodeCatalyst AWS Cloud9 에서를 사용하는 방법과 CodeCatalyst에서 환경을 복제 AWS Cloud9 하는 방법을 다룹니다. 이후 주제에서는 CodeCatalyst 개발 환경을 생성하는 방법과 AWS Cloud9 IDE를 사용하여 개발 환경에 액세스하는 방법도 자세히 설명합니다.
AWS 도구 키트는 AWS 클라우드 계정, 서비스 및 리소스에 빠르게 액세스할 수 있는 IDE별 소프트웨어 개발 키트(SDKs. AWS Toolkit의 CodeCatalyst 계정을 통해 편리한 인터페이스에서 CodeCatalyst 개발 환경, 스페이스 및 프로젝트를 보고, 편집하고, 관리할 수 있습니다. AWS 도구 키트를 통해 사용할 수 있는 AWS 클라우드 서비스 및 기능에 대한 자세한 내용은 [란 무엇입니까 AWS Toolkit for Visual Studio Code?, 도구](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/welcome.html) [AWS 키트 , AWS Cloud9](https://docs.aws.amazon.com/cloud9/latest/user-guide/toolkit-welcome.html)[란 무엇입니까 AWS Toolkit for JetBrains?를](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/welcome.html) 참조하세요.가이드[란 무엇입니까 AWS Toolkit for JetBrains](https://docs.aws.amazon.com/toolkit-for-jetbrains/latest/userguide/welcome.html)?
AWS Cloud9 IDE와 함께 CodeCatalyst를 사용하려면 CodeCatalyst 콘솔 내에서 생성한 기존 스페이스, 프로젝트 및 개발 환경이 있어야 합니다.
**참고**
CodeCatalyst용 AWS Cloud9 IDE의 파일 시스템 내에서 동일한 이름의 폴더 내에 **프로젝트**라는 하위 폴더를 생성하지 마십시오. 이렇게 하면 이 디렉터리에 있는 어떤 파일에도 액세스할 수 없습니다. 이 문제는 파일 경로 **/projects/projects**에 영향을 줍니다. **/test/projects** 및 **/projects/test/projts**와 같은 파일 경로는 이 문제의 영향을 받지 않습니다. 이는 알려진 문제이며 AWS Cloud9 IDE 파일 탐색기에만 영향을 미칩니다.
**참고**
현재 CodeCatalyst용 AWS Cloud9 IDE의 파일 시스템을 사용하여 동일한 이름의 폴더 내에 **프로젝트**라는 하위 폴더를 생성할 수 없습니다. AWS Cloud9 IDE 파일 탐색기에서는이 디렉터리 내의 파일에 액세스할 수 없지만 명령줄을 사용하여 액세스할 수 있습니다. 다른 폴더 이름을 사용하십시오. 이 문제는 **/projects/projects** 파일 경로에만 영향을 미치며, **/test/projects**와 **/projects/test/projects **같은 파일 경로가 적합합니다. 이는 알려진 문제이며 AWS Cloud9 IDE 파일 탐색기에만 영향을 미칩니다.
# 에서 Amazon CodeCatalyst AWS Cloud9 로 마이그레이션
AWS Cloud9 CodeCatalyst의는와 상호 작용하기 위한 완전 관리형 환경을 제공합니다 AWS Cloud9. Amazon CodeCatalyst에서 현재 AWS Cloud9 코드 리소스를 수동으로 복제할 수 있습니다. 다음 섹션에서는 이 프로세스를 상세히 설명합니다. 코드 리소스를 이동하고 복제하려면 CodeCatalyst 내에 스페이스를 생성하세요. 스페이스는 회사, 부서 또는 그룹을 나타냅니다. CodeCatalyst에서 만든 프로젝트, 구성원 및 관련 클라우드 리소스를 추가하려면 스페이스를 만들어야 합니다. 사용자가 프로젝트 초대를 수락하면 CodeCatalyst는 자동으로 해당 초대를 스페이스에 추가합니다. **스페이스 관리자** 역할을 가진 사용자는 스페이스를 관리할 수 있습니다.
이 스페이스 내에서 프로젝트를 만들고 소스 리포지토리를 추가합니다. 프로젝트는 개발 팀과 작업을 지원하는 CodeCatalyst의 협업 공간입니다. 프로젝트를 생성한 후 리소스를 추가, 업데이트 또는 제거할 수 있습니다. 또한 프로젝트 대시보드를 사용자 지정하고 팀 작업의 진행 상황을 모니터링할 수 있습니다. 스페이스 내에 여러 프로젝트를 포함할 수 있습니다. 추가하는 소스 리포지토리 수는 AWS Cloud9 환경에서 이미 사용 중인 리포지토리 수에 따라 달라집니다. 이 프로젝트를 생성하고 해당 소스 리포지토리를 추가한 후 AWS Cloud9 환경으로 돌아가서 환경 데이터를 CodeCatalyst의 이러한 새 리포지토리에 복제해야 할 수 있습니다. 수행하는 작업은 AWS Cloud9에서 사용 중인 소스 리포지토리의 유형에 따라 달라집니다.
스페이스, 프로젝트 및 소스 리포지토리를 생성한 후 개발 환경과 AWS Cloud9 함께를 사용하여 CodeCatalyst에서 환경을 시작할 수 있습니다. 개발 환경은 클라우드 기반 개발 환경입니다. CodeCatalyst의 개발 환경을 사용하여 프로젝트의 소스 리포지토리에 저장된 코드 작업을 수행할 수 있습니다. 또한 CodeCatalyst에서 개발 환경을 만들어 지원되는 통합 개발 환경(IDE)이 있는 프로젝트별 개발 환경에서 코드 작업을 수행할 수 있습니다.
복제 도구를 사용하여 현재 AWS Cloud9 코드 리소스를 CodeCatalyst에 복제할 수도 있습니다. 이는 AWS Cloud9 환경에서 다운로드하고 실행하는 도구입니다. 이미 CodeCatalyst에 가입하고 스페이스를 생성한 경우, 도구가 이 스페이스 내에 프로젝트를 자동으로 생성하고 코드 리소스를 CodeCatalyst의 새 리포지토리에 복제합니다. 이는 수동 복제 프로세스와 비슷합니다. 이 작업은 AWS Cloud9에서 사용 중인 소스 리포지토리의 유형에 따라 달라집니다. 예를 들어 GitHub 리포지토리가 있는 경우 CodeCatalyst 콘솔의 **GitHub 확장**을 사용하여 이러한 리포지토리를 복제해야 합니다.
+ [1단계. Amazon CodeCatalyst에 가입하고 스페이스 생성](#c9-replication-cc-space-creation)
+ [2단계. 스페이스에서 프로젝트 생성](#c9-replication-cc-project-creation)
+ [3단계. 프로젝트에 소스 리포지토리 만들기](#c9-replication-cc-repo-creation)
+ [4단계. AWS Cloud9 코드 리소스를 CodeCatalyst의 소스 리포지토리에 복제 ](#c9-replication-cc-source-repo-creation)
+ [5단계. 를 사용하여 CodeCatalyst에서 개발 환경 생성 AWS Cloud9](#dev-environment-creation)
## 1단계. Amazon CodeCatalyst에 가입하고 스페이스 생성
기존 스페이스 또는 프로젝트에 초대하지 않고도 Amazon CodeCatalyst에 가입할 수 있습니다. 가입하면 스페이스와 프로젝트가 생성됩니다. 사용한 기존 AWS 계정 ID를 입력할 수 있습니다 AWS Cloud9. 이는 결제 목적으로도 사용할 AWS 계정 수 있습니다. AWS 계정 ID를 찾는 방법에 대한 자세한 내용은 [AWS 계정 ID 및 해당 별칭을 참조하세요](https://docs.aws.amazon.com/IAM/latest/UserGuide/console_account-alias.html). 이 절차에 따라 Amazon CodeCatalyst 프로필에 가입하고, 스페이스를 만들고, 스페이스에 대한 계정을 추가합니다.
**새 사용자 등록**
1. [CodeCatalyst 콘솔](https://codecatalyst.aws/)을 엽니다.
1. 시작 페이지에서 **가입**을 선택합니다.
** AWS Builder ID 생성** 페이지가 표시됩니다. AWS BuilderID는 로그인하기 위해 생성하는 자격 증명입니다. 이 ID는 AWS 계정 ID와 동일하지 않습니다. AWS Builder ID에 대한 자세한 내용은 *AWS 로그인 사용 설명서*의 [AWS Builder ID 및 기타 AWS 자격 증명을](https://docs.aws.amazon.com/signin/latest/userguide/differences-aws_builder_id.html) 참조하세요.
1. **이메일 주소**에 CodeCatalyst에 연결하여 사용하려는 이메일 주소를 입력합니다. 그리고 **다음**을 선택합니다.
1. **이름**에 AWS Builder ID를 사용하는 애플리케이션에 표시할 이름과 성을 입력합니다.
이 이름은 AWS Builder ID 프로파일 이름입니다. 원하는 경우 나중에 이름을 변경할 수 있습니다.
**다음**을 선택합니다. **이메일 확인** 페이지가 나타납니다. 지정한 이메일로 확인 코드가 전송됩니다.
1. 받은 코드를 **확인 코드**에 입력한 다음 **확인**을 선택합니다.
5분 후에도 코드를 받지 못하고 스팸 폴더나 정크 폴더에서 코드를 찾을 수 없다면 코드 **재전송**을 선택하세요.
1. 코드가 확인되면 암호를 입력하고 **암호 확인**을 선택합니다.
고객 계약 및 AWS 서비스 약관을 읽고 승인 AWS 함을 확인하는 확인란을 선택한 다음 **내 프로필 생성을** 선택합니다.
1. **별칭 생성** 페이지에서 CodeCatalyst에 사용할 별칭을 입력합니다. 다른 CodeCatalyst 사용자는 댓글과 풀 요청에서 이 별칭을 사용하여 사용자에게 @mention을 보냅니다. CodeCatalyst 프로파일에는 AWS Builder ID의 전체 이름과 CodeCatalyst 별칭이 모두 포함됩니다. CodeCatalyst 별칭은 변경할 수 없습니다.
전체 이름과 별칭은 CodeCatalyst의 여러 영역에 표시됩니다. 예를 들어 프로필 이름은 활동 피드에 표시되지만 프로젝트 구성원은 사용자의 별칭을 사용자를 @mention하는 데 사용합니다.
**별칭 생성**을 선택합니다. 페이지가 업데이트되어 **스페이스 생성** 섹션이 표시됩니다.
1. **스페이스 이름**에 스페이스 이름을 입력하고 **다음**을 선택합니다.
이 이름은 변경할 수 없습니다.
1. **AWS 계정 ID**의 경우 스페이스에 연결하려는 계정의 12자리 ID를 연결합니다.
**AWS 계정 확인 토큰**에서 생성된 토큰 ID를 복사합니다. 토큰은 자동으로 복사됩니다. 그러나 AWS 연결 요청을 승인하는 동안 저장할 수 있습니다.
1. **확인을 AWS** 선택합니다.
1. AWS Management Console에서 **Amazon CodeCatalyst 스페이스 확인** 페이지가 열립니다.
**Amazon CodeCatalyst 스페이스** 페이지입니다. 페이지에 액세스하려면 로그인해야 할 수 있습니다.
페이지에 액세스하려면 [AWS Management Console](https://console.aws.amazon.com/codecatalyst/home/)에서 Amazon CodeCatalyst Spaces에 로그인합니다.
의 확인 토큰 필드는 CodeCatalyst에서 생성된 토큰으로 AWS Management Console 자동으로 채워집니다.
1. **스페이스 확인**을 선택합니다.
계정이 스페이스에 추가되었음을 보여주는 **계정 확인** 성공 메시지가 표시됩니다.
기본적으로 CodeCatalyst 프리 티어를 사용하게 됩니다. 변경하려면 변경하려면 **표준 계층을 활성화하거나 이 공간에 대한 IAM 역할을 추가하려면 공간 세부 정보 보기**를 선택합니다.
CodeCatalyst 요금 티어에 대한 자세한 내용은 [Amazon CodeCatalyst - 요금](https://codecatalyst.aws/explore/pricing)을 참조하세요.
AWS Management Console에서 **CodeCatalyst 스페이스 세부 정보** 페이지가 열립니다. **Amazon CodeCatalyst 스페이스** 페이지입니다. 페이지에 액세스하려면 로그인해야 할 수 있습니다.
1. **[Amazon CodeCatalyst](https://codecatalyst.aws/)로 이동**을 선택합니다.
1. CodeCatalyst의 생성 페이지에서 **스페이스 생성**을 선택합니다.
스페이스가 생성되는 동안 상태 메시지가 표시됩니다. 스페이스가 생성되면 CodeCatalyst가 스페이스 페이지를 엽니다. 보기의 기본값은 **프로젝트** 탭입니다.
**참고**
권한 오류 또는 배너가 표시되면 페이지를 새로 고치고 페이지를 다시 확인해 봅니다.
CodeCatalyst에 가입하고 스페이스를 만든 후 복제 프로세스의 다음 단계는 이 스페이스 내에 프로젝트를 만드는 것입니다.
## 2단계. 스페이스에서 프로젝트 생성
다음 단계에서는 이전 단계에서 생성한 스페이스 내에 빈 프로젝트를 생성하는 방법을 간략히 살펴봅니다. 이 프로젝트를 사용하면 나중에 원하는 리소스를 수동으로 추가할 수 있습니다. 프로젝트를 만들기 전에 **스페이스 관리자 역할이 있어야 하며 프로젝트를 만들려는 스페이스에 가입해야 합니다. 스페이스를 만들면 CodeCatalyst는 **스페이스 관리자 역할을 자동으로 할당합니다. **스페이스 관리자 역할은 CodeCatalyst에서 가장 강력한 역할입니다. 이 역할 및 권한에 대한 자세한 내용은 [스페이스 관리자 역할](https://docs.aws.amazon.com/codecatalyst/latest/userguide/welcome.html)을 참조하세요.
**빈 프로젝트를 만들려면**
1. 프로젝트를 생성하려는 스페이스로 이동합니다.
1. 스페이스 대시보드에서 **프로젝트 생성**을 선택합니다.
1. **처음부터 시작**을 선택합니다.
1. **프로젝트에 이름 부여**에서 프로젝트에 할당할 이름을 입력합니다. 이름은 스페이스 내에서 고유해야 합니다.
1. **프로젝트 생성**을 선택합니다.
프로젝트를 만든 후 복제 프로세스의 다음 단계는 소스 리포지토리를 하나 이상 만드는 것입니다.
## 3단계. 프로젝트에 소스 리포지토리 만들기
방금 만든 프로젝트 내에서 소스 리포지토리를 만들어야 합니다. 이 리포지토리에는 언제든지 편집하거나 삭제할 수 있는 단일 파일인 **README.md** 파일이 있습니다. 소스 리포지토리를 만들 때 선택한 사항에 따라 소스 리포지토리에 `.gitignore` 파일이 포함될 수도 있습니다.
**소스 리포지토리를 생성하려면**
1. [CodeCatalyst 콘솔](https://codecatalyst.aws/)을 엽니다.
1. 프로젝트로 이동합니다.
1. 탐색 창에서 **코드**를 선택한 다음 **소스 리포지토리**를 선택합니다.
1. **리포지토리 추가**를 선택하고 **리포지토리 생성**을 선택합니다.
1. **리포지토리 이름**에 리포지토리 이름을 제공합니다.
리포지토리 이름은 프로젝트에서 고유해야 합니다. 리포지토리 이름 요구 사항에 대한 자세한 내용은 [CodeCatalyst의 소스 리포지토리 할당량](https://docs.aws.amazon.com/codecatalyst/latest/userguide/source-quotas.html)을 참조하세요.
1. (선택 사항) **설명**에 리포지토리에 대한 설명을 추가하여 프로젝트의 다른 사용자가 리포지토리의 용도를 이해하는 데 도움이 되도록 합니다.
1. (선택 사항) 푸시하려는 코드 유형에 맞는 `.gitignore` 파일을 추가합니다.
1. **생성(Create)**을 선택합니다.
**참고**
CodeCatalyst는 `README.md` 파일을 만들 때 리포지토리에 파일을 추가합니다. 또한 CodeCatalyst는 **main**이라는 기본 브랜치에 리포지토리에 대한 초기 커밋을 생성합니다. README.md 파일을 편집하거나 삭제할 수 있지만 기본 브랜치를 변경하거나 삭제할 수는 없습니다.
1. 소스 리포지토리 복제 URL 및 PAT를 가져오려면 **리포지토리 복제**를 선택합니다.
1. HTTPS 복제 URL과 PAT를 각각 복사하려면 **복사**를 선택합니다. 그런 다음 복제 URL과 PAT를 검색할 수 있는 위치에 저장합니다.
복제 URL과 PAT는 4단계에서 사용되며, `CODECATALYST_SOURCE_REPO_CLONE_URL` 및 `CODECATALYST_PAT`로 참조됩니다.
프로젝트 내에 소스 리포지토리를 만든 후 AWS Cloud9 데이터를 이 소스 리포지토리에 복제합니다.
## 4단계. CodeCatalyst의 소스 리포지토리에 AWS Cloud9 코드 리소스 복제
AWS Cloud9 환경에 있는 소스 리포지토리의 유형에 따라 코드 리소스를 생성한 CodeCatalyst 소스 리포지토리로 가져오는 데 따르는 복제 방법이 결정됩니다. 옵션은 다음과 같습니다.
+ [에서 GitHub 리포지토리 사용 AWS Cloud9](#c9-replication-cc-source-repo-creation-github)
+ [에서 GitLab 또는 Bitbucket, 리포지토리GitHub와 같은 비 사용 AWS Cloud9](#c9-replication-cc-source-repo-creation-nongithub)
+ [AWS Cloud9에서 빈 리포지토리 사용](#c9-replication-cc-source-norepo-creation) 이 옵션은 AWS Cloud9에서 소스 리포지토리를 사용하지 않을 것임을 의미합니다.
### CodeCatalyst에서 GitHub 리포지토리 사용
**GitHub 리포지토리** 확장을 사용하면 Amazon CodeCatalyst 프로젝트의 AWS Cloud9 에서 연결된 GitHub리포지토리를 사용할 수 있습니다. 다음 단계에서는 CodeCatalyst 카탈로그에서 GitHub 확장을 설치하는 방법을 설명합니다. 또한 이 단계에서는 기존 GitHub 계정을 CodeCatalyst 스페이스에 연결하고 GitHub 리포지토리를 CodeCatalyst 프로젝트에 연결하는 방법도 보여줍니다.
이 방법의 첫 번째 단계는 CodeCatalyst 카탈로그에서 **GitHub 리포지토리** 확장을 설치하는 것입니다. 확장을 설치하려면 다음 단계를 수행합니다.
**중요**
**Github 리포지토리** 확장 설치 및 구성의 일환으로 GitHub 계정에 확장을 설치해야 합니다. 이렇게 하려면 GitHub 계정 관리자 및 CodeCatalyst 스페이스 관리자여야 합니다.
**1단계. CodeCatalyst 카탈로그에서 확장을 설치하려면**
1. [CodeCatalyst 콘솔](https://codecatalyst.aws/)을 엽니다.
1. 스페이스로 이동합니다.
**작은 정보**
둘 이상의 스페이스에 속해 있는 경우 상단 탐색 표시줄에서 보려는 스페이스를 선택할 수 있습니다.
1. 검색 창 옆의 상단 메뉴 바에서 **카탈로그** 아이콘을 선택하여 CodeCatalyst 카탈로그로 이동합니다. **GitHub 리포지토리**를 검색하거나 범주를 기준으로 확장을 필터링할 수 있습니다.
1. (선택 사항) 확장과 관련된 권한 등 확장에 대한 자세한 내용을 보려면 **GitHub 리포지토리** 확장 이름을 선택합니다.
1. **설치**를 선택합니다. 확장에 필요한 권한을 검토하고 계속하려면 **설치**를 다시 선택합니다.
**GitHub 리포지토리** 확장을 설치하면 연결된 GitHub 계정과 연결된 GitHub 리포지토리를 보고 관리할 수 있는 **GitHub 리포지토리** 확장 세부 정보 페이지로 이동합니다.
**GitHub 리포지토리** 확장을 설치한 후 GitHub 계정을 CodeCatalyst 스페이스에 연결합니다. GitHub 계정을 연결하려면 다음 단계를 수행합니다.
**2단계. GitHub 계정을 CodeCatalyst에 연결하려면**
1. **연결된 Github 계정** 탭에서 **GitHub 계정 연결**을 선택하여 GitHub의 외부 사이트로 이동합니다.
1. GitHub 보안 인증 정보를 사용하여 GitHub 계정에 로그인한 다음 Amazon CodeCatalyst를 설치할 계정을 선택합니다.
1. CodeCatalyst가 현재 및 미래의 모든 리포지토리에 액세스할 수 있도록 허용할지 여부를 선택합니다. 또는 CodeCatalyst에서 사용하려는 특정 GitHub 리포지토리를 선택할 수도 있습니다. 기본 옵션은 GitHub 스페이스의 모든 GitHub 리포지토리입니다.
1. CodeCatalyst에 부여된 권한을 검토한 다음 **설치**를 선택합니다.
GitHub 계정을 CodeCatalyst에 연결하면 **GitHub 리포지토리 확장 세부 정보** 페이지의 **GitHub 계정** 탭에서 연결된 계정을 볼 수 있습니다.
CodeCatalyst에서 GitHub 리포지토리를 사용하기 위한 마지막 단계는 리포지토리를 사용하려는 CodeCatalyst 프로젝트에 연결하는 것입니다. GitHub 리포지토리를 CodeCatalyst 프로젝트에 연결하려면 전체 프로세스의 3단계에 설명된 다음 단계를 수행합니다.
**3단계. GitHub 리포지토리 확장 세부정보 페이지에서 GitHub 리포지토리를 CodeCatalyst 프로젝트에 연결하려면**
1. **연결된 GitHub 리포지토리** 탭에서 **GitHub 리포지토리 연결**을 선택합니다.
1. **GitHub 계정**의 경우, 연결하려는 리포지토리가 포함된 GitHub 계정을 선택합니다.
1. **GitHub 리포지토리**의 경우, CodeCatalyst 프로젝트에 연결하려는 리포지토리를 선택합니다.
1. **CodeCatalyst 프로젝트**의 경우, GitHub 리포지토리에 연결하려는 CodeCatalyst 프로젝트를 선택합니다.
1. **연결**을 선택합니다.
이제 막 푸시한 업데이트된 파일과 커밋이 CodeCatalyst 리포지토리에 있을 것입니다. 이제 이 브랜치에서 개발 환경을 만들고 AWS Cloud9을 사용하여 열 수 있습니다. 개발 환경에 대한 자세한 내용은 [CodeCatalyst의 개발 환경](https://docs.aws.amazon.com/codecatalyst/latest/userguide/devenvironment.html)을 참조하세요.
이제 이 브랜치에서 개발 환경을 만들고 AWS Cloud9을 사용하여 열 수 있습니다. 이를 위한 단계는 [ CodeCatalyst의 5단계:를 사용하여 개발 환경 생성 AWS Cloud9 에](#dev-environment-creation) 요약되어 있습니다.
### CodeCatalyst에서 비GitHub 리포지토리 사용
비GitHub 리포지토리를 AWS Cloud9 사용하여 환경을 복제하기 전에 Amazon CodeCatalyst에서 개인 액세스 토큰(PAT)을 생성해야 합니다. 다음 섹션에서는 이 토큰을 생성하는 방법을 간략하게 설명합니다.
#### Amazon CodeCatalyst에서 개인용 액세스 토큰 생성
프로젝트에서 만든 소스 리포지토리는 Git 클라이언트가 있는 로컬 컴퓨터 또는 통합 개발 환경(IDE)에서 액세스할 수 있습니다. 이렇게 하려면 애플리케이션별 암호를 입력해야 합니다. 이 용도로 사용할 개인용 액세스 토큰(PAT)을 만들 수 있습니다. 생성한 개인용 액세스 토큰(PAT)은 CodeCatalyst의 모든 스페이스 및 프로젝트에서 사용자 자격 증명과 연결됩니다. 생성한 PAT의 이름과 만료 날짜를 볼 수 있으며 더 이상 필요하지 않은 PAT는 삭제할 수 있습니다. PAT 비밀은 생성할 때만 복사할 수 있습니다.
**개인용 액세스 토큰(PAT)을 만들려면**
1. [https://codecatalyst.aws/](https://codecatalyst.aws/)에서 CodeCatalyst 콘솔을 엽니다.
1. 상단 메뉴 바에서 프로필 배지를 선택한 다음 **내 설정**을 선택합니다.
**작은 정보**
사용자 프로필도 찾을 수 있습니다. 이렇게 하려면 프로젝트 또는 스페이스의 구성원 페이지에 있는 구성원 목록에서 이름을 선택합니다.
1. **개인용 액세스 토큰**에서 **생성**을 선택합니다.
1. **PAT 이름**에 개인용 액세스 토큰(PAT)을 설명하는 이름을 입력합니다.
1. **만료 날짜**에 기본 날짜를 유지하거나 달력 아이콘을 선택하여 사용자 지정 날짜를 선택합니다. 만료 날짜는 기본적으로 현재 날짜로부터 1년 후입니다.
1. **생성(Create)**을 선택합니다.
**작은 정보**
소스 리포지토리의 **복제 리포지토리**를 선택할 때도 이 토큰을 생성할 수 있습니다.
1. PAT 비밀을 복사하려면 **복사**를 선택합니다. PAT 비밀을 검색할 수 있는 곳에 저장합니다.
**중요**
PAT 비밀은 한 번만 표시됩니다. 창을 닫은 후에는 검색할 수 없습니다. PAT 비밀을 안전한 위치에 저장하지 않은 경우 다른 비밀을 만들 수 있습니다.
소스 리포지토리에 대한 PAT를 생성한 후 아래 섹션에 설명된 대로 AWS Cloud9 환경에 원격 리포지토리를 추가하고 데이터를이 리포지토리에 푸시하여 AWS Cloud9 환경에서 CodeCatalyst로 데이터를 복제합니다.
#### AWS Cloud9 환경에 원격 리포지토리 추가
GitHub 리포지토리가 아닌 리포지토리를 실행하고 있다고 가정해 보겠습니다. AWS Cloud9 환경에 원격 리포지토리를 추가하고 데이터를 CodeCatalyst의 소스 리포지토리로 푸시할 수 있습니다. 이 프로세스를 완료하려면 다음 명령을 실행합니다.
IDE 내에서 CodeCatalyst의 복제 프로세스 3단계에서 생성한 소스 AWS Cloud9 리포지토리를 가리키는 원격 리포지토리를 추가합니다. 명령의 `CODECATALYST_SOURCE_REPO_CLONE_URL`을 [3단계: 프로젝트에 소스 리포지토리 생성](#c9-replication-cc-repo-creation)의 10단계에서 저장한 복제 URL로 바꿉니다.
```
git remote add codecatalyst CODECATALYST_SOURCE_REPO_CLONE_URL
```
다음 명령을 사용하여 새 브랜치를 소스 리포지토리로 푸시합니다. 암호를 입력하라는 메시지가 표시되면 [3단계: 프로젝트에 소스 리포지토리 생성의 10단계에서 저장한 `CODECATALYST_PAT`를 사용합니다.](#c9-replication-cc-repo-creation)
```
git checkout -b replication && git push codecatalyst replication
```
다음은 예상되는 명령 실행 출력의 예입니다.
```
Switched to a new branch 'replication'
Password for 'https://[aws-account-id]@[aws-region].codecatalyst.aws/v1/MySpace222581768915/Replication/Repository':
Enumerating objects: 4, done.
Counting objects: 100% (4/4), done.
Compressing objects: 100% (3/3), done.
Writing objects: 100% (4/4), 982 bytes | 122.00 KiB/s, done.
Total 4 (delta 0), reused 0 (delta 0), pack-reused 0
remote: Validating objects: 100%
To https://[aws-account-id].codecatalyst.aws/v1/MySpace222581768915/Replication/Repository
* [new branch] replication → replication
```
```
```
이 브랜치는 CodeCatalyst에서 만든 소스 리포지토리에서 사용할 수 있습니다. 이 브랜치에서 개발 환경을 만들고 AWS Cloud9을 사용하여 열 수 있습니다. 개발 환경에 대한 자세한 내용은 [CodeCatalyst의 개발 환경](https://docs.aws.amazon.com/codecatalyst/latest/userguide/devenvironment.html)을 참조하세요.
이제 이 브랜치에서 개발 환경을 만들고 AWS Cloud9을 사용하여 열 수 있습니다. 이를 위한 단계는 [ CodeCatalyst의 5단계:를 사용하여 개발 환경 생성 AWS Cloud9 에](#dev-environment-creation) 요약되어 있습니다.
#### 에서 빈 리포지토리 사용 AWS Cloud9
빈 리포지토리를 AWS Cloud9 사용하여에서 환경을 복제하려면 먼저 Amazon CodeCatalyst에서 개인 액세스 토큰(PAT)을 생성합니다. 다음 섹션에서는 이 토큰을 생성하는 방법을 간략하게 설명합니다.
##### Amazon CodeCatalyst에서 개인용 액세스 토큰 생성
프로젝트에서 만든 소스 리포지토리는 Git 클라이언트가 있는 로컬 컴퓨터 또는 통합 개발 환경(IDE)에서 액세스할 수 있습니다. 이렇게 하려면 애플리케이션별 암호를 입력해야 합니다. 이 용도로 사용할 개인용 액세스 토큰(PAT)을 만들 수 있습니다. 생성한 개인용 액세스 토큰(PAT)은 CodeCatalyst의 모든 스페이스 및 프로젝트에서 사용자 자격 증명과 연결됩니다. 생성한 PAT의 이름과 만료 날짜를 볼 수 있으며 더 이상 필요하지 않은 PAT는 삭제할 수 있습니다. PAT 비밀은 생성할 때만 복사할 수 있습니다.
**개인용 액세스 토큰(PAT)을 만들려면**
1. [https://codecatalyst.aws/](https://codecatalyst.aws/)에서 CodeCatalyst 콘솔을 엽니다.
1. 상단 메뉴 바에서 프로필 배지를 선택한 다음 **내 설정**을 선택합니다.
**작은 정보**
사용자 프로필도 찾을 수 있습니다. 이렇게 하려면 프로젝트 또는 스페이스의 구성원 페이지에 있는 구성원 목록에서 이름을 선택합니다.
1. **개인용 액세스 토큰**에서 **생성**을 선택합니다.
1. **PAT 이름**에 개인용 액세스 토큰(PAT)을 설명하는 이름을 입력합니다.
1. **만료 날짜**에 기본 날짜를 유지하거나 달력 아이콘을 선택하여 사용자 지정 날짜를 선택합니다. 만료 날짜는 기본적으로 현재 날짜로부터 1년 후입니다.
1. **생성(Create)**을 선택합니다.
**작은 정보**
소스 리포지토리의 **복제 리포지토리**를 선택할 때도 이 토큰을 생성할 수 있습니다.
1. PAT 비밀을 복사하려면 **복사**를 선택합니다. PAT 비밀을 검색할 수 있는 곳에 저장합니다.
**중요**
PAT 비밀은 한 번만 표시됩니다. 창을 닫은 후에는 검색할 수 없습니다. PAT 비밀을 안전한 위치에 저장하지 않은 경우 다른 비밀을 만들 수 있습니다.
소스 리포지토리에 대한 PAT를 생성한 후 아래 섹션에 설명된 대로 AWS Cloud9 환경에서 빈 리포지토리를 시작하고 CodeCatalyst에서 생성한 소스 리포지토리를 가리켜 AWS Cloud9 환경에서 CodeCatalyst로 데이터를 복제합니다.
##### 에서 빈 리포지토리 시작 AWS Cloud9
에 설정된 소스 리포지토리가 없는 경우 AWS Cloud9에서 빈 리포지토리를 시작합니다 AWS Cloud9. 또한 CodeCatalyst에서 생성한 소스 리포지토리를 가리키고 Git을 통해 복제하려는 파일을 추가하고 푸시합니다. 다음 단계를 수행하고 다음 명령을 실행하여 AWS Cloud9 파일을 CodeCatalyst에 복제합니다.
1. AWS Cloud9 환경에서 다음 명령을 실행하여 빈 리포지토리를 시작합니다.
```
git init -b main
```
그러면 아래와 같은 유사한 출력이 표시됩니다.
```
Initialized empty Git repository in /home/ec2-user/environment/.git/
```
1. CodeCatalyst에서 소스 리포지토리 URL을 복제합니다. CodeCatalyst 콘솔에서 만든 CodeCatalyst 프로젝트로 이동한 후 탐색 창에서 **코드**를 선택한 다음 **소스 리포지토리**를 선택합니다.
1. 원하는 소스 리포지토리 목록에서 리포지토리를 선택하고 **복제 리포지토리**를 선택하여 복제 URL을 복사합니다.
1. 복제한 URL을 사용하여 CodeCatalyst 리포지토리를 추가하고 CodeCatalyst의 빈 리포지토리에 이미 있는 콘텐츠를 푸시합니다.
```
git remote add origin [...]
git push origin --force
```
1. 복제할 파일을 추가합니다. 환경 디렉터리의 모든 파일을 복제하려면 `git add -A`를 실행합니다.
```
git add -A .
git commit -m "replicate"
```
1. 관련 없는 두 기록을 병합합니다. 병합 충돌이 발생하는 경우 다음과 같이 해결합니다.
```
git merge origin/main --allow-unrelated-histories
```
1. 다음 명령을 실행하여 변경 사항을 CodeCatalyst의 소스 리포지토리로 다시 푸시합니다. 암호를 입력하라는 메시지가 표시되면 [3단계: 프로젝트에 소스 리포지토리 생성의 10단계에서 생성한 개인 액세스 토큰(`CODECATALYST_PAT`)을 입력합니다](#c9-replication-cc-repo-creation).
```
Admin:~/environment (main) $ git push origin main
Password for 'https://222581768915@git.us-west-2.codecatalyst.aws/v1/MySpace222581768915/Replication/Replication':
```
이 절차를 완료하면 CodeCatalyst 리포지토리에 방금 푸시한 업데이트된 파일과 커밋이 저장됩니다. 이제 이 브랜치에서 개발 환경을 만들고 AWS Cloud9을 사용하여 열 수 있습니다. 이 작업을 수행하는 단계는 아래 섹션에 요약되어 있습니다.
## 5단계: CodeCatalyst AWS Cloud9 에서를 사용하여 개발 환경 생성
다음 절차에서는 AWS Cloud9 와 방금 복제한 데이터를 사용하여 CodeCatalyst에서 개발 환경을 생성하는 방법을 간략하게 설명합니다.
**를 사용하여 개발 환경을 생성하려면 AWS Cloud9**
1. [https://codecatalyst.aws/](https://codecatalyst.aws/)에서 CodeCatalyst 콘솔을 엽니다.
1. 개발 환경을 생성하려는 스페이스로 이동합니다.
1. 탐색 창에서 **개요**를 선택한 다음 **내 개발 환경** 섹션으로 이동합니다.
1. **개발 환경 생성**을 선택합니다.
1. 드롭다운 메뉴에서 AWS Cloud9 를 선택합니다.
1. **리포지토리 복제**를 선택합니다.
**참고**
현재 CodeCatalyst는 서드 파티 리포지토리 복제를 지원하지 않지만, 개발 환경을 만들고 선택한 IDE에서 서드 파티 리포지토리를 복제할 수 있습니다.
1. 다음 중 하나를 수행하세요.
1. 복제할 리포지토리를 선택하고, **기존 브랜치에서 작업**을 선택한 다음 기존 브랜치 드롭다운 메뉴에서 브랜치를 선택합니다.
1. 복제할 리포지토리를 선택하고, **새 브랜치에서 작업**을 선택하고, **브랜치 이름** 필드에 브랜치 이름을 입력하고, **다음에서 브랜치 생성** 드롭다운 메뉴에서 새 브랜치를 만들 브랜치를 선택합니다.
1. 원하는 경우 개발 환경의 별칭을 추가할 수 있습니다.
1. 선택적으로 **개발 환경 구성** 편집 버튼을 선택하여 개발 환경의 컴퓨팅, 스토리지 또는 제한 시간 구성을 편집합니다.
1. **생성(Create)**을 선택합니다. 개발 환경이 생성되는 동안 개발 환경 상태 열에 **시작 중**이 표시되고, 개발 환경이 생성되면 상태 열에 **실행 중**이 표시됩니다.
# 복제 도구 사용
AWS Cloud9 CodeCatalyst의는와 상호 작용하기 위한 완전 관리형 환경을 제공합니다 AWS Cloud9. 고객이 CodeCatalyst AWS Cloud9 에서 사용을 시도할 수 있도록 복제 도구를 만들었습니다. AWS Cloud9 환경에서 스크립트를 복사하고 실행한 후 프롬프트에 따라 스크립트를 실행하고에서 CodeCatalyst AWS Cloud9 로 코드 리소스를 복제합니다. 복제 도구 및 프로세스에 대한 자세한 내용은 아래에 설명된 [복제 프로세스에 대한 FAQ](https://docs.aws.amazon.com/cloud9/latest/user-guide/faqs-replication-tool)를 참조하세요.
**참고**
이 복제 프로세스는 기존 AWS Cloud9 환경에 영향을 주지 않습니다. 복제 프로세스가 완료되면 개발 환경, 소스 리포지토리, 프로젝트 및 공간을 삭제할 수 있으며 환경에 영향을 주지 않습니다 AWS Cloud9 . 이 도구는 CodeCatalyst AWS Cloud9 의에 코드 리소스만 복사하며 기존 AWS Cloud9 환경을 삭제하거나 구성하지 않습니다. 이 복제 도구는 초기 선택 AWS 계정 그룹에 릴리스되었습니다. 따라서 특정 AWS 계정에 표시되지 않을 수 있습니다.
**참고**
도구를 다운로드하기 전에 Amazon CodeCatalyst에 가입하고 스페이스를 생성하는 것이 좋습니다. CodeCatalyst에 가입하는 방법에 대한 자세한 내용은 [Amazon CodeCatalyst에 가입하고 스페이스 생성](c9-replication-cc.md#c9-replication-cc-space-creation)을 참조하세요.
## Amazon CodeCatalyst AWS Cloud9 에서를 사용할 때의 이점
다음 섹션에서는 CodeCatalyst AWS Cloud9 에서를 사용할 때 경험할 수 있는 몇 가지 성능 이점과 향상된 기능을 간략하게 설명합니다.
+ CodeCatalyst는 완전 관리형 개발 환경을 사용하여 단일 위치에서 전체 소프트웨어 개발 수명 주기를 관리할 수 있는 통합 환경을 제공합니다.
+ 출시 시 Amazon EBS 볼륨 크기 옵션이 향상되었습니다.
+ 임시 환경을 지원하고 필요에 따라 개발 환경의 컴퓨팅을 확장할 수 있습니다.
+ 사용자 지정 이미지 사양을 통해 사용할 수 있는 사용자 지정 AMI 지원.
+ 구성을 코드로 설명할 수 있는 Devfile 지원
## 복제 도구를 사용하여 CodeCatalyst에서 AWS Cloud9 코드 리소스 복제
다음 절차에서는 복제 도구를 복사하고 실행하여 복제 프로세스를 완료하는 방법을 자세히 설명합니다.
1. 아래 스크립트를 복사하고 AWS Cloud9 환경 내에서 실행해야 합니다.
```
curl https://dx5z5embsyrja.cloudfront.net -o /tmp/replicate-tool.tar.gz && tar --no-same-owner --no-same-permissions -xvf /tmp/replicate-tool.tar.gz -C /tmp && node /tmp/cloud9-replication-tools
```
1. **[선택 사항] 복제 도구는 원격 측정에 사용자의 AWS 계정 ID를 사용합니다. 이 도구의 목적은 도구를 사용하는 동안 발생할 수 있는 문제를 더 잘 식별할 수 있도록 하는 것입니다. `tool starts`, `tool fails`, `tool is cancelled by user`, `tool completes successfully` 및 `tool creates a Dev Environment for the user`에 대한 원격 측정 이벤트가 발생합니다. 복제 도구를 사용하여 원격 분석을 사용하지 않도록 설정하려면 아래 [복제 도구의 원격 측정 비활성화](#disable-telemetry)를 참조하세요.
1. AWS Cloud9 환경에서 복제 도구를 복사하고 실행한 후에는 브라우저의 액세스 URL AWS 계정 로 이동하여 10분 이내에 *허용*을 클릭하여를 AWS Builder ID와 연결해야 합니다. 링크는 한 번만 열어주세요. 링크를 여러 번 열면 오류가 발생하고 다시 시작해야 합니다. AWS Builder ID에 대한 자세한 내용은 로그인 사용 설명서의 [AWS Builder ID로](https://docs.aws.amazon.com/signin/latest/userguide/sign-in-aws_builder_id.html) 로그인을 참조하세요. *AWS * 이렇게 하면 CodeCatalyst에서 코드 리소스를 복제할 목적으로 복제 도구에 코드 리소스에 대한 액세스 권한이 부여됩니다.
1. 사용하려는 스페이스를 선택합니다. 스페이스가 하나뿐인 경우 해당 스페이스가 선택됩니다. 스페이스에 대한 자세한 내용은 **Amazon CodeCatalyst 사용 설명서의 [CodeCatalyst의 스페이스](https://docs.aws.amazon.com/codecatalyst/latest/userguide/spaces.html)를 참조하세요.
1. CodeCatalyst에서 코드를 복제할지 아니면 새 개발 환경에서 시도해 볼지 선택합니다. CodeCatalyst에서 코드를 직접 복제하는 것이 좋습니다. 개발 환경에 대한 자세한 내용은 **Amazon CodeCatalyst 사용 설명서의 [CodeCatalyst의 개발 환경](https://docs.aws.amazon.com/codecatalyst/latest/userguide/devenvironment.html)을 참조하세요.
1. 프로젝트 이름을 입력하거나 Enter 키를 눌러 제공된 기본 이름을 사용합니다.
1. 메시지가 표시되면 CodeCatalyst의 새 소스 리포지토리에 파일을 복사할 방법을 선택합니다. 루트 폴더를 단일 CodeCatalyst 리포지토리로 푸시하거나 하위 폴더를 별도의 CodeCatalyst 리포지토리로 푸시하도록 선택할 수 있습니다.
1. 도구가 완성되면 터미널 메시지에 제공된 URL을 통해 CodeCatalyst 콘솔 내에서 프로젝트로 이동하여 CodeCatalyst의 코드 리소스에 액세스할 수 있습니다.
이 절차를 완료하면 CodeCatalyst 리포지토리에 방금 푸시한 업데이트된 파일과 커밋이 저장됩니다. 이제 이 브랜치에서 개발 환경을 만들고 AWS Cloud9을 사용하여 열 수 있습니다.
## 복제 도구에 대한 원격 측정 비활성화
다음 단계에서는 복제 도구에 대한 원격 측정을 비활성화하도록 환경 변수를 설정하는 방법을 간략하게 설명합니다.
1. AWS Cloud9 환경에서 터미널 열기
1. 다음과 같은 명령 중 하나를 실행합니다.
```
export CLOUD9_REPLICATION_TOOL_TELEMETRY=off
```
또는
```
export CLOUD9_REPLICATION_TOOL_TELEMETRY=0
```
1. 위 명령 중 하나를 실행하면 환경 변수가 설정되고 복제 도구에 대한 원격 측정이 비활성화됩니다. 원격 측정을 비활성화하도록 설정한 후에는 복제 도구 스크립트를 복사하고 다시 실행하여 프로세스를 시작해야 합니다.
## 복제 도구 피드백
문제가 발생하거나 복제 도구 사용 경험에 대한 피드백을 제공하려면 지원 사례를 작성하여 제출하세요. 지원 사례 생성에 대한 자세한 내용은 [지원 사례 및 사례 관리 생성](https://docs.aws.amazon.com/awssupport/latest/user/case-management.html)을 참조하세요.
## AWS Cloud9 와 Amazon CodeCatalyst의 차이점
다음 표에는 CodeCatalyst와 간의 몇 가지 차이점이 요약되어 AWS Cloud9 AWS Cloud9 있습니다.
| AWS Cloud9 | AWS Cloud9 Amazon CodeCatalyst의 |
| --- | --- |
| 프라이빗 VPC는와 매우 잘 작동합니다 AWS Cloud9. | 프라이빗 VPC 사용은 현재 CodeCatalyst에서 AWS Cloud9 에 대해 지원되지 않습니다. |
| AWS Cloud9 는 사전 구성된 AWS 관리형 자격 증명을 지원합니다. | CodeCatalyst AWS Cloud9 에서에 대한 자격 증명을 수동으로 구성해야 합니다. |
| 30분\$17일 간격을 두고를 사용하여 종료를 비활성화할 수 있습니다 AWS Cloud9. | AWS Cloud9 CodeCatalyst에서에 대해 15분\$120시간 간격을 가질 수 있으며 종료를 비활성화할 수 없습니다. |
| AWS Cloud9 는 Ubuntu 및 AL2 OS 플랫폼을 지원합니다. | AWS Cloud9 CodeCatalyst의는 Ubuntu 및 AL2를 포함할 수 있는 MDE Universal 이미지 및 사용자 지정 이미지를 지원합니다. 이에 대한 자세한 내용은 **Amazon CodeCatalyst 사용 설명서의 [유니버설 devfile 이미지](https://docs.aws.amazon.com/codecatalyst/latest/userguide/devenvironment-universal-image.html)를 참조하세요. |
| 업로드 및 다운로드는에서 지원됩니다. AWS Cloud9 | CodeCatalyst AWS Cloud9 의에 대한 업로드 및 다운로드는 현재 지원되지 않습니다. 사용자는 Amazon S3 버킷을 사용하여 업로드하고 다운로드해야 합니다. |
| 에서 공동 작업을 사용할 수 있습니다. AWS Cloud9 | CodeCatalyst AWS Cloud9 의 에는 현재 공동 작업을 사용할 수 없습니다. |
# 복제 프로세스에 대한 FAQ
다음 섹션은 복제 도구 및 복제 프로세스와 관련된 몇 가지 FAQ에 대한 답변을 제공하는 것을 목표로 합니다.
**질문:** CodeCatalyst에서 AWS Cloud9 환경을 복제하면 AWS Cloud9 환경에 영향을 미치나요?
**답변:** 아니요. 환경 복제는 CodeCatalyst의 AWS Cloud9 에 코드 리소스를 통해서만 복사되므로 작업을 계속할 수 있습니다. 의 코드 리소스 및 환경 AWS Cloud9 은 어떤 식으로든 영향을 받지 않습니다.
**질문:** 롤백하려는 경우 내 AWS Cloud9 환경이 영향을 받나요?
**답변:** 아니요. CodeCatalyst 개발 환경, 소스 리포지토리, 프로젝트 및 스페이스를 삭제할 수 있으며, 이는 사용자의 AWS Cloud9 환경에 영향을 주지 않습니다.
**질문:** 새 위치는 HIPAA, SOC 등과 같은 표준을 준수하나요?
**답변:** CodeCatalyst의 개발 환경은 현재 이러한 표준을 준수하지 않습니다. 이러한 표준의 준수는 로드맵에 포함되어 있습니다.
**질문:** 코드 리소스는 어디로 이동하나요?
**답변:** 코드 리소스는 CodeCatalyst의 프로젝트 내 소스 리포지토리에 복사됩니다.
**질문:** 사용량이 제한되나요?
**답변:** 복제 프로세스의 일환으로 프리 티어 내에 16GB의 개발 환경을 만들게 됩니다. 즉, 최대 4개의 개발 환경을 사용할 수 있습니다. 요금, 스토리지 및 사용 가능한 다양한 티어에 대한 자세한 내용은 [Amazon CodeCatalyst - 요금](https://codecatalyst.aws/explore/pricing)을 참조하세요.
**질문:** 내 컴퓨팅은 어디로 이동하나요?
**답변:** 기존 컴퓨팅은 변경되지 않습니다. 그대로 유지됩니다.
**질문:** CodeCatalyst에서 기존 AWS 계정 자격 증명을 사용할 수 있으며 자동으로 전송되나요?
**답변:** CodeCatalyst에서 AWS 계정 자격 증명을 수동으로 구성할 수 있습니다. 자동으로 전송되지는 않습니다.
**질문:** 비용이 얼마나 드나요?
**답변:** CodeCatalyst를 무료로 사용해 볼 수 있습니다. 요금 및 사용 가능한 다양한 티어에 대한 자세한 내용은 [Amazon CodeCatalyst - 요금](https://codecatalyst.aws/explore/pricing)을 참조하세요.
**질문:** CodeCatalyst의 데이터 복제 프로세스와 데이터 스토리지는 안전한가요?
**답변:** 예, Git 푸시와 https를 사용하여 코드 리소스를 복사하며, CodeCatalyst는 서비스 내에 데이터를 안전하게 저장합니다. 모든 데이터는 전송 및 저장 시 암호화됩니다. CodeCatalyst의 데이터 보호에 대한 자세한 내용은 **Amazon CodeCatalyst 사용 설명서의 [Amazon CodeCatalyst에서의 데이터 보호](https://docs.aws.amazon.com/codecatalyst/latest/userguide/data-protection.html)를 참조하세요.
**질문:** 어떤 복제 접근 방식을 선택해야 하나요?
**답변:** 복제 도구는 두 가지 접근 방식을 제공합니다. 코드 리소스를 단일 CodeCatalyst 소스 리포지토리 AWS Cloud9 로 푸시하여에서 CodeCatalyst로 복사하거나 각 하위 폴더를 고유한 CodeCatalyst 소스 리포지토리로 변환할 수 있습니다. 첫 번째 접근 방식은 소스 리포지토리와 같은 CodeCatalyst 개념에 대한 사전 지식이 필요하지 않으므로 사용하는 것이 좋습니다. 이 접근 방식은 AWS Cloud9에서 익숙한 유사한 설정으로 작업하면서 CodeCatalyst에서 AWS Cloud9 경험을 탐색하기 위한 좋은 출발점입니다.
두 번째 옵션은 루트 AWS Cloud9 환경 폴더 아래에 있는 하위 폴더를 독립적으로 사용할 때 가장 적합합니다. 이 방법을 사용하면 루트 폴더 아래의 모든 파일이 복제되지 않습니다. CodeCatalyst의 소스 리포지토리에 대한 자세한 내용은 **Amazon CodeCatalyst 사용 설명서의 [CodeCatalyst의 소스 리포지토리](https://docs.aws.amazon.com/codecatalyst/latest/userguide/source.html)를 참조하세요.
**질문:** 복제 프로세스에서 생성되는 개인용 액세스 토큰은 무엇이며 왜 필요한가요? 분실한 경우 다시 생성할 수 있나요?
**답변:** 개인용 액세스 토큰은 CodeCatalyst의 사용자 자격 증명과 연결되어 있습니다. Git을 사용하여 로컬 변경 내용을 CodeCatalyst 소스 리포지토리로 푸시할 때는 암호로 필요합니다. 토큰 및 토큰 생성 방법에 대한 자세한 내용은 **Amazon CodeCatalyst 사용 설명서의 [Amazon CodeCatalyst에서 개인용 액세스 토큰 관리](https://docs.aws.amazon.com/codecatalyst/latest/userguide/ipa-tokens-keys.html)를 참조하세요.
**질문:** 복제 프로세스 중에 오류가 발생하면 어떻게 되나요?
**답변:** 복제 도구를 사용할 때 오류가 발생하면 먼저 도구를 다시 시도해야 합니다. 소스 리포지토리와 관련된 오류인 경우 코드 리소스를 복제한 후 CodeCatalyst 소스 리포지토리에 수동으로 푸시할 수 있습니다. 로컬 리포지토리가 이미 CodeCatalyst 업스트림과 함께 작동하도록 구성되어 있으므로 제대로 작동할 것입니다. 문제가 지속되면 지원 사례를 생성하여 제출하세요. 지원 사례 생성에 대한 자세한 내용은 [지원 사례 및 사례 관리 생성](https://docs.aws.amazon.com/awssupport/latest/user/case-management.html)을 참조하세요.
**질문:** my AWS BuilderID를 사용하여 복제 도구를 인증하고 권한을 부여해야 하는 이유는 무엇인가요?
**답변:** 복제 프로세스 중에 복제 도구는 CodeCatalyst에서 여러 리소스(프로젝트, 개발 환경, 소스 리포지토리)를 읽고 쓰고 사용자를 대신하여 로컬 콘텐츠를 복사해야 하므로 이 작업을 수행하려면 사용자의 허가가 필요합니다.
**질문:** CodeCatalyst로 전환하면 지연 시간에 변화가 있나요?
**답변:** 수행 중인 작업에 따라 지연 시간이 줄어들 수 있습니다. 이는 CodeCatalyst 서버가 PDX 리전에서 호스팅되기 때문입니다.
**질문:** 설치된 소프트웨어가 모두 이전되나요?
**답변:** 아니요. 코드 리소스만 전송됩니다. 바이너리, 구성 및 설치된 소프트웨어는 이전되지 않습니다.
# Amazon CodeCatalyst에서의 Dev Environment
다음 섹션에서는 AWS Cloud9 IDE를 사용하여 CodeCatalyst로 개발 환경을 생성하고 관리하는 방법을 간략하게 설명합니다.
+ [Dev Environment 생성](#ide-toolkits-create-cloud9)
+ [Dev Environment 설정 열기](#ide-toolkits-settings-cloud9)
+ [Dev Environment 재개](#ide-toolkits-resume-cloud9)
+ [Dev Environment 삭제](#ide-toolkits-delete-cloud9)
+ [Dev Environment용 리포지토리 devfile 편집](#ide-toolkits-edit-devfile-cloud9)
+ [리포지토리 복제](#ide-toolkits-clone-cloud9)
+ [Dev Environment 문제 해결](#cloud9-devenvironment-troubleshoot)
## Dev Environment 생성
개발 환경은 다양한 방법으로 만들 수 있습니다.
+ **요약**, **개발 환경** 또는 **소스 리포지토리** 페이지에서 CodeCatalyst 소스 리포지토리를 이용해 CodeCatalyst에서 개발 환경을 만듭니다.
+ 개발 환경의 CodeCatalyst에 있는 소스 리포지토리에 연결되지 않은 빈 개발 환경을 만듭니다.
+ 선택한 IDE에서 Dev Environment를 만들고 CodeCatalyst 소스 리포지토리를 Dev Environment에 복제합니다.
각 브랜치 및 리포지토리별로 Dev Environment 하나를 만들 수 있습니다. 프로젝트에는 여러 리포지토리가 존재할 수 있습니다. Dev Environment는 CodeCatalyst 계정에만 연결되며, CodeCatalyst 계정으로만 관리할 수 있습니다. Dev Environment를 열고 지원되는 모든 IDE를 이용해 작업할 수 있습니다. 특정 IDE를 선택한 후에는 선택한 IDE에서만 관련 개발 환경을 열 수 있습니다. 다른 IDE를 사용하려는 경우 탐색 모음에서 개발 환경을 선택하고 **편집**을 선택하거나 새 개발 환경을 생성하여 IDE를 변경할 수 있습니다. 기본적으로 개발 환경은 2코어 프로세서, 4GB RAM 및 16GB 영구 스토리지로 생성합니다.
CodeCatalyst에서 개발 환경을 만드는 방법에 대한 자세한 내용 및 단계는 Amazon CodeCatalyst 설명서의 [개발 환경 생성](https://docs.aws.amazon.com/codecatalyst/latest/userguide/devenvironment-create.html)을 참조하세요.**
CodeCatalyst에서 개발 환경을 만드는 방법에 대한 자세한 내용 및 단계는 Amazon CodeCatalyst 사용 설명서의 [개발 환경 생성](https://docs.aws.amazon.com/codecatalyst/latest/userguide/devenvironment-create.html)을 참조하세요.**
**참고**
이제 타사 소스 리포지토리를 사용하여 개발 환경을 만들 수 있습니다. CodeCatalyst 내 프로젝트에 타사 소스 리포지토리를 연결하는 방법에 대한 자세한 내용은 **Amazon CodeCatalyst 사용 설명서의 [소스 리포지토리 연결](https://docs.aws.amazon.com/codecatalyst/latest/userguide/source-repositories-link.html)을 참조하세요.
**중요**
개발 환경은 CodeCatalyst 자격 증명에 액세스할 수 있는 devfile을 통해 스크립트를 실행할 수 있습니다. 신뢰할 수 없는 리소스를 열기 전에 리포지토리를 검사하십시오.
## Dev Environment 설정 열기
CodeCatalyst 콘솔에서 개발 환경을 만든 후에는 구체적인 개발 환경 설정을 확인할 수 있습니다.
1. CodeCatalyst 콘솔에서 AWS Cloud9 IDE를 통해 개발 환경으로 이동합니다.
1. AWS Cloud9 사이드바에서 **aws-explorer**를 선택합니다.
1. **개발자 도구** 탐색 창에서 **CodeCatalyst**를 확장하고 **설정 열기**를 선택하여 **개발 환경 설정** 보기를 엽니다.
1. **Dev Environment Settings**(개발 환경 설정) 보기의 다음 섹션에는 개발 환경 관련 옵션이 포함되어 있습니다.
+ **별칭:** 개발 환경에 할당된 **별칭**을 보고 변경합니다.
+ **상태:** 현재 개발 환경 상태와 개발 환경에 할당된 프로젝트를 확인하고 개발 환경을 중지합니다.
+ **Devfile:** 개발 환경용 Devfile의 이름과 위치를 봅니다. **편집기에서 열기** 버튼을 선택하여 Devfile을 엽니다.
+ **Compute Settings**(컴퓨팅 설정): 개발 환경의 크기 및 기본 **Timeout Length**(제한 시간)을 변경할 수 있습니다.
**참고**
개발 환경이 생성되면 개발 환경에 할당한 스토리지 양을 변경할 수 없습니다.
**참고**
터미널에서 Amazon CodeCatalyst AWS CLI 를 사용하는 경우 *CodeCatalyst 명령을 실행하기 전에 AWS\$1PROFILE=codecatalyst*를 설정해야 합니다. CodeCatalyst
## Dev Environment 재개
Dev Environment `$HOME` 디렉터리에 있는 모든 항목은 영구적으로 저장됩니다. 필요하다면 개발 환경에서 작업을 중단한 다음 나중에 작업을 재개할 수 있습니다. 개발 환경이 생성될 때 제한 시간 필드에서 선택한 시간보다 오랫동안 개발 환경이 유휴 상태로 남아 있다고 가정합니다. 이 경우 세션이 자동으로 중지됩니다.
Dev Environment는 CodeCatalyst에서만 재개할 수 있습니다. 개발 환경 재개에 대한 자세한 내용은 **Amazon CodeCatalyst 설명서의 [개발 환경 재개](https://docs.aws.amazon.com/codecatalyst/latest/userguide/devenvironment-resume.html)를 참조하세요.
**참고**
개발 환경을 재개하는 데 몇 분 정도 걸릴 수 있습니다.
## Dev Environment 삭제
개발 환경에 저장된 콘텐츠 작업을 마치면 해당 콘텐츠를 삭제할 수 있습니다. 개발 환경을 삭제하기 전에 코드 변경 사항을 커밋하고 원본 소스 리포지토리에 푸시해야 합니다. 개발 환경을 삭제하면 개발 환경에 대한 컴퓨팅 및 스토리지 청구가 종료됩니다.
Dev Environment는 CodeCatalyst의 **Dev Environments** 페이지에서만 삭제할 수 있습니다. 개발 환경 삭제 방법에 대한 자세한 내용은 **Amazon CodeCatalyst 설명서의 [개발 환경 삭제](https://docs.aws.amazon.com/codecatalyst/latest/userguide/devenvironment-delete.html)를 참조하세요.
## 개발 환경용 리포지토리 devfile 편집
개발 환경의 구성을 변경하려면 devfile을 편집해야 합니다. devfiles을 사용하면 팀 전체의 개발 환경을 표준화할 수 있습니다. CodeCatalyst에 있는 소스 리포지토리의 루트에서 devfile을 편집할 수 있습니다. 지원되는 IDE에서 devfile을 편집하는 방법도 있습니다. 지원되는 IDE에서 devfile을 편집하는 경우, 변경 사항을 커밋하고 소스 리포지토리에 푸시하거나 풀 요청을 생성합니다. 이렇게 하면 팀원이 devfile 편집을 검토하고 승인할 수 있습니다.
**참고**
devfile에는 퍼블릭 컨테이너 이미지만 포함할 수 있습니다.
**참고**
종속성이 누락된 경우 일부 AWS Cloud9 IDE 기능이 사용자 지정에서 작동하지 않을 수 있습니다devfile. Linux x64가 아닌 일부 플랫폼에서 작동하게 하려면 추가 작업이 필요할 수 있습니다.
**에서 개발 환경devfile의 리포지토리를 편집하려면 AWS Cloud9**
1. CodeCatalyst 콘솔에서 AWS Cloud9 IDE를 통해 개발 환경으로 이동합니다.
1. AWS Cloud9 사이드바에서 **aws-explorer**를 선택합니다.
1. **개발자 도구** 탐색 창에서 **CodeCatalyst 툴킷**을 확장합니다.
1. **Open Devfile**(Devfile 열기)을 선택합니다.
1. devfile을 편집하고 파일을 저장합니다.
1. 메뉴 사이드바에서 Git 확장자인 **소스 제어**를 선택합니다.
1. **Message**(메시지) 텍스트 필드에 스테이징 변경 전 메시지를 입력합니다.
1. 커밋을 준비하려면 **Stage All Changes (\$1)**(모든 변경 사항 준비 (\$1)) 아이콘을 선택합니다.
1. Git 명령을 보려면 리포지토리 이름 옆에 있는 **메뉴** 아이콘을 선택합니다.
1. **Commit**(커밋)과 **Push**(푸시)를 선택합니다.
1. AWS Toolkit 메뉴에서 **개발 환경 업데이트**를 선택합니다.
**Commit**(커밋)과 **Push**(푸시)를 선택합니다. 업데이트된 devfile이 저장되었고 변경 사항이 커밋 및 푸시되었습니다.
**참고**
사용자 지정 devfile을 사용하여 시작하려는 개발 환경이 작동하지 않는다고 가정해 보겠습니다. 이는 devfile이 AWS Cloud9과 호환되지 않기 때문일 수 있습니다. 문제를 해결하려면 devfile을 검토하세요. 문제가 해결되지 않는다면 삭제한 다음 새로 만들어 보세요.
CodeCatalyst를 통해 Dev Environment용 devfile을 편집할 수도 있습니다. 자세한 내용은 *Amazon CodeCatalyst 설명서*의 [Configuring your Dev Environment](https://docs.aws.amazon.com/codecatalyst/latest/userguide/devenvironment-devfile.html)(Dev Environment 구성)를 참조하세요.
## 리포지토리 복제
소스 리포지토리의 여러 파일, 브랜치 및 커밋으로 효과적으로 작업하려면 소스 리포지토리를 로컬 컴퓨터에 복제하면 됩니다. 그런 다음 Git 클라이언트나 IDE를 사용하여 변경합니다. CodeCatalyst에서 다른 Git 호스트 공급자와 동일한 방식으로 AWS Cloud9 IDE Git확장을 사용할 수 있으며 명령줄도 사용할 수 있습니다. 서드 파티 리포지토리를 복제하는 방법은 [Git 리포지토리 초기화 또는 복제](https://docs.aws.amazon.com/cloud9/latest/user-guide/using-gitpanel.html)를 참조하세요.
소스 리포지토리에서 개발 환경을 생성하고 CodeCatalyst를 사용하여 복제하는 방법에 대한 자세한 내용은 **Amazon CodeCatalyst 설명서의 [소스 리포지토리 개념](https://docs.aws.amazon.com/codecatalyst/latest/userguide/source-concepts-clone.html)을 참조하세요.
## Dev Environment 문제 해결
Dev Environment에서 문제가 발생하는 경우 Amazon CodeCatalyst 설명서의 [Troubleshooting problems with Dev Environments](https://docs.aws.amazon.com/codecatalyst/latest/userguide/troubleshooting-devenvironments.html)(Dev Environment 문제 해결)를 참조하세요.**
**참고**
터미널에서 Amazon CodeCatalyst AWS CLI 를 사용하는 경우 *CodeCatalyst 명령을 실행하기 전에 AWS\$1PROFILE=codecatalyst*를 설정해야 합니다. CodeCatalyst
Dev Environment에서 문제가 발생하는 경우 Amazon CodeCatalyst 설명서의 [Troubleshooting problems with Dev Environments](https://docs.aws.amazon.com/codecatalyst/latest/userguide/devenvironments-troubleshooting.html)(Dev Environment 문제 해결)를 참조하세요.**
# AWS Cloud9 IDE AWS CDK 에서 작업
**AWS CDK 서비스**를 사용하면 [AWS Cloud Development Kit (AWS CDK)](https://aws.amazon.com/cdk/) 애플리케이션 또는 *앱* 작업을 수행할 수 있습니다. [AWS Cloud Development Kit (AWS CDK) 개발자 안내서](https://docs.aws.amazon.com/cdk/latest/guide/) AWS CDK 에서에 대한 자세한 정보를 확인할 수 있습니다.
AWS CDK 앱은 *[구문](https://docs.aws.amazon.com/cdk/latest/guide/constructs.html)*이라고 하는 빌딩 블록으로 구성됩니다. 이러한 구성 요소에는 CloudFormation 스택과 스택 내의 AWS 리소스에 대한 정의가 포함됩니다. **AWS CDK 탐색**기를 사용하면 정의된 스택[https://docs.aws.amazon.com/cdk/latest/guide/stacks.html](https://docs.aws.amazon.com/cdk/latest/guide/stacks.html)과 [리소스를](https://docs.aws.amazon.com/cdk/latest/guide/resources.html) 볼 수 있습니다. AWS CDK ** AWS Cloud9 편집기의 개발자 도구 창에서이 뷰에 액세스할 수 있습니다.
이 섹션에서는 AWS Cloud9 편집기**AWS CDK **에서에 액세스하고를 사용하는 방법에 대한 정보를 제공합니다.
# AWS CDK 애플리케이션 작업
AWS Cloud9 통합 개발 환경(IDE)에서 **AWS CDK 탐색**기를 사용하여 AWS CDK 애플리케이션을 시각화하고 작업할 수 있습니다.
## 사전 조건
AWS CDK 명령줄 인터페이스를 설치합니다. 지침은 *AWS Cloud Development Kit (AWS CDK) 개발자 안내서*[의 AWS CDK 시작하기](https://docs.aws.amazon.com/cdk/latest/guide/getting_started.html)를 참조하세요.
**중요**
설치하는 AWS CDK 버전은 1.17.0 이상이어야 합니다. **`cdk --version`** 명령을 사용하여 실행 중인 버전을 확인할 수 있습니다.
## AWS CDK 애플리케이션 시각화
AWS Cloud9 IDE AWS CDK Explorer를 사용하면 앱의 CDK 구문에 저장된 [스택](https://docs.aws.amazon.com/cdk/latest/guide/stacks.html)과 [리소스를](https://docs.aws.amazon.com/cdk/latest/guide/resources.html) 관리할 수 있습니다. AWS CDK 탐색기는 `tree.json` 파일에 정의된 정보를 사용하여 트리 보기에 리소스를 표시합니다. **`cdk synth`** 명령을 실행하면 이 파일이 생성됩니다. 기본적으로 앱의 `cdk.out` 디렉터리에 `tree.json` 파일이 위치합니다.
Toolkit AWS CDK Explorer 사용을 시작하려면 CDK 애플리케이션을 생성합니다.
1. [AWS CDK 개발자 안내서](https://docs.aws.amazon.com/cdk/v2/guide/getting_started.html)에 있는 [Hello World 자습서](https://docs.aws.amazon.com/cdk/latest/guide/getting_started.html#hello_world_tutorial)의 처음 몇 단계를 완료합니다.
**중요**
**스택 배포** 단계에 도달하면 중지하고 이 가이드로 돌아옵니다.
**참고**
자습서에 제공된 명령(예: **`mkdir`** 및 **`cdk init`**)을 운영 체제 명령줄 인터페이스나 VS 코드 편집기 내의 **Terminal**(터미널) 창에서 실행할 수 있습니다.
1. CDK 자습서의 필수 단계를 완료한 후 AWS Cloud9 IDE 편집기에서 생성한 CDK 콘텐츠를 엽니다.
1. AWS 탐색 창에서 **CDK ** 제목을 확장합니다. 이제 CDK 애플리케이션 및 관련 리소스가 CDK Explorer 트리 뷰에 표시됩니다. AWS Cloud9 내의 터미널에서 다음 명령을 실행하여 CDK 기능이 작동하는지 확인할 수도 있습니다.
```
mkdir mycdkapp
cd mycdkapp
cdk init app --language=typescript
cdk synth
cdk bootstrap
```
### 중요 정보
+ CDK 앱을 AWS Cloud9 편집기에 로드할 때 한 번에 여러 폴더를 로드할 수 있습니다. 앞의 이미지와 같이 폴더는 CDK 앱을 여러 개 포함할 수 있습니다. AWS CDK Explorer는 프로젝트 루트 디렉터리와 해당 직접 하위 디렉터리에서 앱을 찾습니다.
+ 이 자습서의 처음 몇 단계를 수행할 때 마지막으로 실행한 명령이 **`cdk synth`**이라는 것을 알 수 있습니다. 이 명령은 AWS CDK 앱을 CFN으로 변환하여 CloudFormation 템플릿을 합성합니다. 부산물로 `tree.json` 파일도 생성합니다. CDK 앱을 변경한 경우 **`cdk synth`** 명령을 다시 실행하여 트리 뷰에 반영된 변경 사항을 확인합니다. 변경 사항의 한 가지 예는 앱에 더 많은 리소스를 추가하는 것입니다.
## AWS CDK 앱에서 다른 작업 수행
AWS Cloud9 편집기를 사용하여 명령줄 인터페이스를 사용하는 것과 동일한 방식으로 CDK 앱에서 다른 작업을 수행할 수 있습니다. 예를 들어 편집기에서 코드 파일을 업데이트하고 AWS Cloud9 **Terminal** 창을 사용하여 앱을 배포할 수 있습니다.
이러한 유형의 작업을 시도하려면 AWS Cloud9 편집기를 사용하여 *AWS CDK 개발자 안내서*의 [Hello World 자습서를](https://docs.aws.amazon.com/cdk/latest/guide/getting_started.html#hello_world_tutorial) 계속 진행합니다. 마지막 단계인 **앱 리소스 삭제**를 수행해야 합니다. 그렇지 않으면 AWS 계정에 예상치 못한 비용이 발생할 수 있습니다.