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

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

# 자습서: 빈 프로젝트로 시작하고 수동으로 리소스 추가
<a name="getting-started-blank-template"></a>

프로젝트를 생성할 때 **빈 프로젝트** 블루프린트를 선택하여 사전 정의된 리소스 없이 빈 프로젝트를 생성할 수 있습니다. 빈 프로젝트를 생성한 후 프로젝트 요구 사항에 따라 리소스를 생성하고 추가할 수 있습니다. 블루프린트 없이 생성된 프로젝트는 생성 시 비어 있으므로 이 옵션을 시작하려면 CodeCatalyst 리소스를 생성하고 구성하는 방법에 대한 더 많은 지식이 필요합니다.

**Topics**
+ [사전 조건](#getting-started-bt-prerequisites)
+ [빈 프로젝트 생성](#getting-started-bt-proj-create)
+ [소스 리포지토리 생성](#getting-started-bt-source-create)
+ [코드 변경을 빌드, 테스트 및 배포하기 위한 워크플로 생성](#getting-started-bt-workflow-create)
+ [프로젝트에 초대하기](#getting-started-bt-ipa-user)
+ [작업을 공동 작업하고 추적하기 위한 문제 생성](#getting-started-bt-issue)

## 사전 조건
<a name="getting-started-bt-prerequisites"></a>

빈 프로젝트를 생성하려면 **스페이스 관리자** 또는 **파워 유저** 역할이 할당되어 있어야 합니다. CodeCatalyst 처음 로그인하는 경우 [CodeCatalyst 설정 및 로그인CodeCatalyst 설정 및 로그인](setting-up-topnode.md) 섹션을 참조하세요.

## 빈 프로젝트 생성
<a name="getting-started-bt-proj-create"></a>

프로젝트 생성은 함께 작업할 수 있는 첫 번째 단계입니다. 소스 리포지토리 및 워크플로와 같은 자체 리소스를 생성하려면 빈 프로젝트로 시작할 수 있습니다.

**빈 프로젝트를 만들려면**

1. 프로젝트를 생성하려는 스페이스로 이동합니다.

1. 스페이스 대시보드에서 **프로젝트 생성**을 선택합니다.

1. **처음부터 시작**을 선택합니다.

1. **프로젝트에 이름 부여**에서 프로젝트에 할당할 이름을 입력합니다. 이름은 스페이스 내에서 고유해야 합니다.

1. **프로젝트 생성**을 선택합니다.

이제 프로젝트가 비어 있으므로 다음 단계는 소스 리포지토리를 생성하는 것입니다.

## 소스 리포지토리 생성
<a name="getting-started-bt-source-create"></a>

프로젝트 코드를 저장하고 공동 작업할 소스 리포지토리를 생성합니다. 프로젝트 멤버는 이 리포지토리를 로컬 컴퓨터에 복제하여 코드 작업을 수행할 수 있습니다. 또는 지원되는 서비스에서 호스팅되는 리포지토리를 연결하도록 선택할 수 있지만 이 자습서에서는 다루지 않습니다. 자세한 내용은 [소스 리포지토리 연결](source-repositories-link.md) 섹션을 참조하세요.

**소스 리포지토리를 생성하려면**

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

1. 프로젝트로 이동합니다.

1. 탐색 창에서 **코드**를 선택한 다음 **소스 리포지토리**를 선택합니다.

1. **리포지토리 추가**를 선택하고 **리포지토리 생성**을 선택합니다.

1. **리포지토리 이름**에 리포지토리 이름을 제공합니다. 이 안내서에서는 *codecatalyst-source-repository*를 사용하지만 다른 이름을 선택할 수 있습니다. 리포지토리 이름은 프로젝트에서 고유해야 합니다. 리포지토리 이름 요구 사항에 대한 자세한 내용은 [CodeCatalyst의 소스 리포지토리 할당량](source-quotas.md) 섹션을 참조하세요.

1. (선택 사항) **설명**에 리포지토리에 대한 설명을 추가하여 프로젝트의 다른 사용자가 리포지토리의 용도를 이해하는 데 도움이 되도록 합니다.

1. **리포지토리 생성(기본)**을 선택합니다. 이 옵션은 기본 브랜치와 README.md 파일을 포함하는 리포지토리를 생성합니다. 빈 리포지토리와 달리 이 리포지토리가 생성되는 즉시 사용할 수 있습니다.

1. **기본 브랜치**에서 다른 이름을 선택할 이유가 없는 한 이름을 *main*으로 둡니다. 이 가이드의 예시는 모두 기본 브랜치의 이름으로 *main*을 사용합니다.

1. (선택 사항) 푸시하려는 코드 유형에 맞는 `.gitignore` 파일을 추가합니다.

1. **생성(Create)**을 선택합니다.
**참고**  
CodeCatalyst는 `README.md` 파일을 만들 때 리포지토리에 파일을 추가합니다. 또한 CodeCatalyst는 **main**이라는 기본 브랜치에 리포지토리에 대한 초기 커밋을 생성합니다. README.md 파일을 편집하거나 삭제할 수 있지만 기본 브랜치를 삭제할 수는 없습니다.

개발 환경을 생성하여 리포지토리에 코드를 빠르게 추가할 수 있습니다. 이 자습서에서는를 사용하여 개발 환경을 생성하고 개발 환경을 생성할 때 **기본** 브랜치에서 브랜치를 생성하는 옵션을 AWS Cloud9선택하는 것이 좋습니다. 이 브랜치에 **test** 이름을 사용하지만 원하는 경우 다른 브랜치 이름을 입력할 수 있습니다.

**새 브랜치로 개발 환경을 생성하려면**

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

1. 개발 환경을 생성하려는 프로젝트로 이동합니다.

1. 프로젝트의 소스 리포지토리 목록에서 리포지토리 이름을 선택합니다. 또는 탐색 창에서 **코드**를 선택하고 **소스 리포지토리**를 선택한 다음 개발 환경을 생성할 리포지토리를 선택합니다.

1. 리포지토리 홈 페이지에서 **개발 환경 생성**을 선택합니다.

1. 드롭다운 메뉴에서 지원되는 IDE를 선택합니다. 자세한 정보는 [개발 환경에 지원되는 통합 개발 환경](devenvironment-create.md#devenvironment-supported-ide)을 참조하세요.

1. 복제할 리포지토리를 선택하고, **새 브랜치에서 작업**을 선택하고, **브랜치 이름** 필드에 브랜치 이름을 입력하고, **다음에서 브랜치 생성** 드롭다운 메뉴에서 새 브랜치를 만들 브랜치를 선택합니다.

1. 원하는 경우 개발 환경의 별칭을 추가할 수 있습니다.

1. 선택적으로 **개발 환경 구성** 편집 버튼을 선택하여 개발 환경의 컴퓨팅, 스토리지 또는 제한 시간 구성을 편집합니다.

1. **생성(Create)**을 선택합니다. 개발 환경이 생성되는 동안 개발 환경 상태 열에 **시작 중**이 표시되고, 개발 환경이 생성되면 상태 열에 **실행 중**이 표시됩니다. 선택한 IDE의 개발 환경과 함께 새 탭이 열립니다. 코드를 편집하고 변경 사항을 커밋하고 푸시할 수 있습니다.

## 코드 변경을 빌드, 테스트 및 배포하기 위한 워크플로 생성
<a name="getting-started-bt-workflow-create"></a>

CodeCatalyst에서는 워크플로에서 애플리케이션 또는 서비스의 구축, 테스트 및 배포를 구성합니다. 워크플로는 작업으로 구성되며 코드 푸시 또는 풀 요청 열기 또는 업데이트와 같이 지정된 소스 리포지토리 이벤트가 발생한 후 자동으로 실행되도록 구성할 수 있습니다. 워크플로에 대한 자세한 내용은 [워크플로를 사용하여 빌드, 테스트 및 배포워크플로를 사용하여 빌드, 테스트 및 배포](workflow.md) 섹션을 참조하세요.

[워크플로 시작하기](workflows-getting-started.md)의 지침에 따라 첫 번째 워크플로를 생성합니다.

## 프로젝트에 초대하기
<a name="getting-started-bt-ipa-user"></a>

이제 사용자 지정 프로젝트를 설정했으므로 다른 사용자가 함께 작업하도록 초대합니다.

**프로젝트에 누군가를 초대하려면**

1. 사용자를 초대하려는 프로젝트로 이동합니다.

1. 탐색 창에서 **프로젝트 설정**을 선택합니다.

1. **멤버** 탭에서 **초대**를 선택합니다.

1. 프로젝트의 사용자로 초대하려는 사람의 이메일 주소를 입력합니다. 여러 이메일 주소를 스페이스 또는 쉼표로 구분하여 입력할 수 있습니다. 프로젝트의 멤버가 아닌 스페이스의 멤버 중에서 선택할 수도 있습니다.

1. 사용자의 역할을 선택합니다.

   사용자 추가를 완료했으면 **초대**를 선택합니다.

## 작업을 공동 작업하고 추적하기 위한 문제 생성
<a name="getting-started-bt-issue"></a>

CodeCatalyst는 프로젝트와 관련된 기능, 작업, 버그 및 기타 작업과 문제를 추적하는 데 도움이 됩니다. 문제를 생성하여 필요한 작업과 아이디어를 추적할 수 있습니다. 기본적으로 문제를 생성하면 백로그에 추가됩니다. 진행 중인 작업을 추적하는 보드로 문제를 이동할 수 있습니다. 특정 프로젝트 멤버에게 문제를 할당할 수도 있습니다.

**프로젝트에 대한 문제를 생성하려면**

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

   문제를 생성하려는 프로젝트를 탐색하고 있는지 확인합니다. 모든 프로젝트를 보려면 탐색 창에서 **Amazon CodeCatalyst**를 선택하고 필요한 경우 **모든 프로젝트 보기**를 선택합니다. 문제를 생성하거나 처리할 프로젝트를 선택합니다.

1. 탐색 창에서 **트랙**를 선택한 후, **백로그**를 선택합니다.

1. **문제 생성**을 선택합니다.

1. **문제 제목**에 문제의 이름을 입력합니다. 필요에 따라 문제에 대한 설명을 제공합니다. 원하는 경우 문제의 상태, 우선 순위 및 추정치를 선택합니다. 프로젝트 멤버 목록에서 프로젝트 멤버에게 문제를 할당할 수도 있습니다.
**작은 정보**  
**Amazon Q**가 문제를 해결하도록 Amazon Q에 문제를 할당할 수 있습니다. 시도가 성공하면 풀 요청이 생성되고 코드를 검토하고 테스트할 수 있도록 문제의 상태가 **검토 중**으로 변경됩니다. 자세한 내용은 [자습서: CodeCatalyst 생성형 AI 기능을 사용하여 개발 작업 속도 향상](getting-started-project-assistance.md) 섹션을 참조하세요.  
이 기능을 사용하려면 스페이스에 생성형 AI 기능을 활성화해야 합니다. 자세한 내용은 [생성형 AI 기능 관리](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-generative-ai-features.html)를 참조하세요.

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

문제를 생성한 후 프로젝트 멤버에게 할당하고, 예측하고, Kanban 보드에서 추적할 수 있습니다. 자세한 내용은 [CodeCatalyst의 문제 처리 추적 및 구성문제 작업 추적 및 구성](issues.md) 섹션을 참조하세요.