

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

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

# CodeCatalyst에서 프로젝트 작업 구성
<a name="projects"></a>

Amazon CodeCatalyst의 프로젝트를 사용하여 개발 팀이 공유된 지속적 통합/지속적 전달(CI/CD) 워크플로 및 리포지토리를 사용하여 개발 작업을 수행할 수 있는 협업 스페이스를 구축합니다. 프로젝트를 생성한 후 리소스를 추가, 업데이트 또는 제거할 수 있습니다. 팀의 작업 진행 상황을 모니터링할 수도 있습니다. 스페이스 내에 여러 프로젝트를 포함할 수 있습니다.

CodeCatalyst의 스페이스는 프로젝트로 구성됩니다. 스페이스 내의 모든 프로젝트를 볼 수 있지만 멤버인 프로젝트만 사용할 수 있습니다. 프로젝트를 생성하면 프로젝트의 기본 역할이 생성되어 프로젝트에 초대하는 사용자에게 할당합니다.
+ **기고자** 역할과 같이 프로젝트 역할이 있는 프로젝트에 할당된 모든 사용자는 소스 리포지토리와 같은 프로젝트 리소스에 액세스할 수 있습니다.
+ **스페이스 관리자** 또는 **프로젝트 관리자** 역할이 있는 사람은 누구나 프로젝트 참여 초대장을 보낼 수 있습니다.
+ **프로젝트 관리자** 역할을 가진 사용자는 공유 리소스에서 활동, 상태 및 기타 설정을 추적할 수 있습니다.
+ **제한된 액세스** 역할을 지닌 사용자는 CI/CD 워크플로의 일부로서 기능, 코드 수정 및 테스트에 대한 프로젝트 할당을 관리할 수 있습니다.

  워크플로는 CI/CD 파이프라인으로서 애플리케이션을 빌드, 테스트, 릴리스 또는 업데이트하는 데 사용됩니다. 소스 아티팩트를 전송하고 작업하는 작업을 추가하여 워크플로를 조합할 수 있습니다. 작업을 실행하면, 프로젝트 클라우드 리소스는 워크플로 작업에 온디맨드 컴퓨팅 기능을 제공하는 데 사용됩니다. 설정하려는 활동 및 출력에 따라 더 많은 CI/CD 워크플로를 구성할 수 있습니다. 예를 들어, 빌드 및 테스트 작업에 대해서만 워크플로를 생성할 수 있습니다. 여기서 버그를 수정하는 동안 배포 없이 테스트 결과를 보고 워크플로를 완료할 수 있습니다. 그런 다음 다른 워크플로를 생성하여 애플리케이션을 빌드하고 스테이징 환경에 배포할 수 있습니다.

프로젝트를 생성할 때 블루프린트를 사용하여 샘플 코드를 포함하거나 리소스를 생성하는 프로젝트를 생성하거나 빈 프로젝트로 시작할 수 있습니다. 블루프린트를 사용하여 프로젝트를 생성하는 경우, 선택한 블루프린트에 따라 프로젝트에 추가되는 리소스와 CodeCatalyst가 생성하거나 구성하는 도구가 결정되어 프로젝트 리소스를 추적하고 사용할 수 있습니다. 프로젝트를 생성한 후 수동으로 리소스를 추가 또는 제거할 수 있습니다.

각 프로젝트는 프로젝트가 생성되거나 리소스가 수정되는 경우와 같이 사용자별 이벤트 목록으로 프로젝트 활동을 추적합니다. 프로젝트 활동은 스페이스 수준에서 모니터링 및 집계됩니다. 활동 데이터 작업에 대한 자세한 내용은 [한 스페이스에서 모든 프로젝트 보기](projects-view-overview.md) 섹션을 참조하세요.

프로젝트에서 AWS 리소스를 사용하는 경우 CodeCatalyst 계정을 AWS 프로젝트의 리소스를 통합할 관리 권한이 있는 계정에 연결할 수 있습니다.

소스 리포지토리, 문제 및 기타 리소스를 생성한 후 프로젝트에 추가할 수 있습니다. 프로젝트를 생성하려면 **스페이스 관리자** 역할이 있어야 합니다.

# 프로젝트 생성
<a name="projects-create"></a>

CodeCatalyst 프로젝트를 사용하면 공유된 지속적 통합/지속적 전송(CI/CD) 워크플로 및 리포지토리를 사용하여 개발 작업을 수행하고, 리소스를 관리하며, 문제를 추적하고, 사용자를 추가할 수 있습니다.

프로젝트를 생성하기 전에 **스페이스 관리자** 또는 **파워 유저** 역할이 있어야 합니다.

**Topics**
+ [Amazon CodeCatalyst에서 빈 프로젝트 생성](#projects-create-empty)
+ [연결된 타사 리포지토리를 사용하여 프로젝트 생성](#projects-create-3p-repo)
+ [블루프린트를 사용하여 프로젝트 생성](#projects-create-console-template)
+ [Amazon Q를 사용하여 프로젝트를 생성하거나 블루프린트를 사용하여 기능을 추가할 때의 모범 사례](#projects-create-amazon-q)
+ [프로젝트에서 블루프린트를 사용하는 모범 사례](#projects-create-use-blueprints)
+ [생성된 프로젝트에 리소스 및 작업 추가](#projects-create-after-steps)

## Amazon CodeCatalyst에서 빈 프로젝트 생성
<a name="projects-create-empty"></a>

리소스 없이 빈 프로젝트를 생성하고 나중에 원하는 리소스를 수동으로 추가할 수 있습니다.

프로젝트를 생성하기 전에 **스페이스 관리자** 또는 **파워 유저** 역할이 있어야 합니다.

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

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

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

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

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

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

## 연결된 타사 리포지토리를 사용하여 프로젝트 생성
<a name="projects-create-3p-repo"></a>

프로젝트의 소스 코드를 선호하는 타사 공급자에 보관하면서도, 블루프린트, 수명 주기 관리, 워크플로 등과 같은 모든 CodeCatalyst 기능을 계속 사용할 수 있습니다. 이를 위해, GitHub 리포지토리, Bitbucket 리포지토리 또는 GitLab 프로젝트 리포지토리에 연결되는 새 CodeCatalyst 프로젝트를 생성할 수 있습니다. 그런 다음 CodeCatalyst 프로젝트에서 연결된 소스 리포지토리를 사용할 수 있습니다.

CodeCatalyst 프로젝트를 생성하기 전에 **스페이스 관리자** 또는 **파워 유저** 역할이 있어야 합니다. 자세한 내용은 [스페이스 생성](spaces-create.md) 및 [사용자를 직접 스페이스에 초대](spaces-members-add-admin.md) 섹션을 참조하세요.

CodeCatalyst에서 GitHub 계정의 소스 리포지토리에 연결하는 프로젝트를 생성하려면 다음 세 가지 작업을 완료해야 합니다.

1. **GitHub 리포지토리**, **Bitbucket 리포지토리** 또는 **GitLab 리포지토리** 확장 프로그램을 설치합니다. 외부 사이트에서 CodeCatalyst에 연결하고 리포지토리에 대한 액세스 권한을 제공하도록 프롬프트가 표시되며, 이는 다음 단계의 일부로 수행됩니다.
**중요**  
**GitHub 리포지토리**, **Bitbucket 리포지토리** 또는 **GitLab 리포지토리** 확장 프로그램을 CodeCatalyst 스페이스에 설치하려면 해당 스페이스에 **스페이스 관리자** 역할이 있는 계정으로 로그인해야 합니다.

1. GitHub 계정 또는 Bitbucket 작업 영역 또는 GitLab 사용자를 CodeCatalyst에 연결합니다.
**중요**  
GitHub 계정, Bitbucket 작업 영역, GitLab 사용자를 CodeCatalyst 스페이스에 연결하려면, 타사 소스의 관리자면서 동시에 CodeCatalyst **스페이스 관리자**여야 합니다.
**중요**  
리포지토리 확장 프로그램을 설치한 후 CodeCatalyst에 연결하는 모든 리포지토리의 코드가 CodeCatalyst에 인덱싱 및 저장됩니다. 이렇게 하면 CodeCatalyst에서 코드를 검색할 수 있습니다. CodeCatalyst에서 연결된 리포지토리를 사용할 때 코드에 대한 데이터 보호를 더 잘 이해하려면 *Amazon CodeCatalyst 사용 설명서*의 [데이터 보호](https://docs.aws.amazon.com/codecatalyst/latest/userguide/data-protection.html)를 참조하세요.

1. GitHub 리포지토리, Bitbucket 리포지토리 또는 GitLab 프로젝트 리포지토리에 연결된 CodeCatalyst 프로젝트를 생성합니다.
**중요**  
GitHub 리포지토리, Bitbucket 리포지토리 또는 GitLab 프로젝트 리포지토리를 **기고자**로 연결할 수 있지만 타사 리포지토리를 **스페이스 관리자** 또는 **프로젝트 관리자**로서만 연결 해제할 수 있습니다. 자세한 내용은 [CodeCatalyst에서 GitHub 리포지토리, Bitbucket 리포지토리, GitLab 프로젝트 리포지토리 및 Jira 프로젝트 연결 해제](extensions-unlink.md) 섹션을 참조하세요.
**중요**  
CodeCatalyst는 연결된 리포지토리에 대한 기본 브랜치의 변경 사항 감지를 지원하지 않습니다. 연결된 리포지토리의 기본 브랜치를 변경하려면 먼저 CodeCatalyst에서 연결을 해제하고 기본 브랜치를 변경한 다음 다시 연결해야 합니다. 자세한 내용은 [CodeCatalyst에서 GitHub 리포지토리, Bitbucket 리포지토리, GitLab 프로젝트 리포지토리 및 Jira 프로젝트 연결](extensions-link.md) 섹션을 참조하세요.  
리포지토리를 연결하기 전에 항상 최신 버전의 확장 프로그램을 사용하는 것이 좋습니다.
**참고**  
GitHub 리포지토리, Bitbucket 리포지토리 또는 GitLab 프로젝트 리포지토리는 한 스페이스에서 하나의 CodeCatalyst 프로젝트에만 연결할 수 있습니다.
비어있거나 보관된 GitHub 리포지토리, Bitbucket 리포지토리 또는 GitLab 프로젝트 리포지토리를 CodeCatalyst 프로젝트와 함께 사용할 수 없습니다.
CodeCatalyst 프로젝트의 리포지토리와 이름이 동일한 GitHub 리포지토리, Bitbucket 리포지토리 또는 GitLab 프로젝트 리포지토리를 연결할 수 없습니다.
**GitHub 리포지토리** 확장 프로그램은 GitHub Enterprise Server 리포지토리와 호환되지 않습니다.
**Bitbucket 리포지토리** 확장 프로그램은 Bitbucket Data Center 리포지토리와 호환되지 않습니다.
**GitLab 리포지토리** 확장 프로그램은 GitLab 자체 관리형 프로젝트 리포지토리와 호환되지 않습니다.
연결된 리포지토리에서는 **설명 쓰기** 또는 **설명 요약** 기능을 사용할 수 없습니다. 이러한 기능은 CodeCatalyst의 풀 요청에서만 사용할 수 있습니다.

자세한 내용은 [CodeCatalyst에서 확장 프로그램이 있는 프로젝트에 기능 추가확장 프로그램이 있는 프로젝트에 기능 추가](extensions.md) 단원을 참조하십시오.

**타사 확장 프로그램을 설치하려면**

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

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

1. **자체 코드 가져오기**를 선택합니다.

1. **기존 리포지토리 연결**에서 사용하려는 타사 리포지토리 공급자에 따라 **GitHub 리포지토리**, **Bitbucket 리포지토리**, **GitLab 리포지토리**를 선택합니다. 이전에 연결하지 않은 경우 GitHub 계정, Bitbucket 작업 영역 또는 GitLab 계정을 연결하라는 메시지가 표시됩니다. 선택한 타사 확장 프로그램이 아직 설치되지 않은 경우 설치 프롬프트가 표시됩니다.

1. 프롬프트가 표시되면 **설치**를 선택합니다. 확장 프로그램에 필요한 권한을 검토하고 계속하려면 **설치**를 다시 선택합니다.

타사 확장 프로그램을 설치한 후 다음 단계는 GitHub 계정, Bitbucket 작업 영역 또는 GitLab 사용자를 CodeCatalyst 스페이스에 연결하는 것입니다.

**GitHub 계정, Bitbucket 작업 영역 또는 GitLab 사용자를 CodeCatalyst에 연결하려면**

구성하도록 선택한 타사 확장 프로그램에 따라 다음 중 하나를 수행합니다.
+ **GitHub 리포지토리**: GitHub 계정에 연결합니다.

  1. **GitHub 계정 연결**을 선택하여 GitHub의 외부 사이트로 이동합니다.

  1. GitHub 자격 증명으로 GitHub 계정에 로그인한 다음 Amazon CodeCatalyst를 설치할 계정을 선택합니다.
**작은 정보**  
이전에 GitHub 계정을 스페이스에 연결한 경우 재인증하라는 메시지가 표시되지 않습니다. 대신 둘 이상의 GitHub 스페이스에 멤버 또는 공동 작업자인 경우 확장 프로그램을 설치할 위치를 묻는 대화 상자가 표시되고, GitHub 스페이스에만 속한 경우 Amazon CodeCatalyst 애플리케이션의 구성 페이지가 표시됩니다. 허용하려는 리포지토리 액세스에 대한 애플리케이션을 구성한 다음 **저장**을 선택합니다. **저장** 버튼이 활성화되지 않은 경우 구성을 변경한 다음 다시 시도하세요.

  1. CodeCatalyst가 현재 및 미래 리포지토리에 모두 액세스하도록 허용할지 여부를 선택하거나 CodeCatalyst에서 사용할 특정 GitHub 리포지토리를 선택합니다. 기본 옵션은 CodeCatalyst에서 액세스할 향후 리포지토리를 포함하여 GitHub 계정에 모든 GitHub 리포지토리를 포함하는 것입니다.

  1. CodeCatalyst에 부여된 권한을 검토한 다음 **설치**를 선택합니다.

  GitHub 계정을 CodeCatalyst에 연결하면 **GitHub 리포지토리** 확장 프로그램 세부 정보 페이지로 이동합니다. 여기서 연결된 GitHub 계정과 연결된 GitHub 리포지토리를 보고 관리할 수 있습니다.
+ **Bitbucket 리포지토리**: Bitbucket 작업 영역에 연결합니다.

  1. **Bitbucket 작업 영역 연결**을 선택하여 Bitbucket의 외부 사이트로 이동합니다.

  1. Bitbucket 자격 증명을 사용하여 Bitbucket 작업 영역에 로그인하고 CodeCatalyst에 부여된 권한을 검토합니다.

  1. **작업 영역에 대한 권한 부여** 드롭다운 메뉴에서 CodeCatalyst 액세스를 제공할 Bitbucket 작업 영역을 선택한 다음 **액세스 권한 부여**를 선택합니다.
**작은 정보**  
이전에 Bitbucket 작업 영역을 스페이스에 연결한 경우 재인증하라는 메시지가 표시되지 않습니다. 대신 하나 이상의 Bitbucket 작업 영역에서 멤버 또는 공동 작업자인 경우 확장 프로그램을 설치할 위치를 묻는 대화 상자가 표시되고, 하나의 Bitbucket 작업 영역에만 속한 경우 Amazon CodeCatalyst 애플리케이션의 구성 페이지가 표시됩니다. 작업 영역 액세스를 허용하려는 애플리케이션을 선택하고, **액세스 허용**을 선택합니다. **액세스 허용** 버튼이 활성화되지 않은 경우 구성을 변경한 다음 다시 시도하세요.

  Bitbucket 워크스페이스를 CodeCatalyst에 연결하면 연결된 Bitbucket 워크스페이스과 연결된 Bitbucket 리포지토리를 보고 관리할 수 있는 **Bitbucket 리포지토리** 확장 프로그램 세부 정보 페이지로 이동합니다.
+ **GitLab 리포지토리:** GitLab 사용자에게 연결합니다.

  1. **GitLab 사용자 연결**을 선택하여 GitLab 외부 사이트로 이동합니다.

  1. GitLab 자격 증명을 사용하여 GitLab 사용자에 로그인하고 CodeCatalyst에 부여된 권한을 검토합니다.
**작은 정보**  
이전에 GitLab 사용자를 스페이스에 연결한 경우 재인증하라는 메시지가 표시되지 않습니다. 대신 CodeCatalyst 콘솔로 다시 이동합니다.

  1. **GitLab용 AWS 커넥터 권한 부여**를 선택합니다.

  GitLab 사용자를 CodeCatalyst에 연결하면 **GitLab 리포지토리** 확장 프로그램 세부 정보 페이지로 이동하며, 여기서 연결된 GitLab 사용자 및 연결된 GitLab 프로젝트 리포지토리를 보고 관리할 수 있습니다.

타사 소스를 CodeCatalyst 에 연결한 후 타사 리포지토리를 CodeCatalyst 프로젝트에 연결할 수 있습니다.

**프로젝트를 생성하려면**

1. **프로젝트 생성** 페이지에서 연결한 GitHub 계정을 선택합니다.

1. 연결한 타사 리포지토리 공급자에 따라 **GitHub 리포지토리**, **Bitbucket 리포지**토리 또는 **GitLab 리포지토리**의 리포지토리 드롭다운 메뉴를 선택하여 타사 리포지토리를 확인한 다음 프로젝트에 연결할 리포지토리를 선택합니다.

1. **프로젝트 이름 지정** 텍스트 입력 필드에 프로젝트에 할당할 이름을 입력합니다. 이름은 스페이스 내에서 고유해야 합니다.

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

**GitHub 리포지토리**, **Bitbucket 리포지토리** 또는 **GitLab 리포지토리** 확장 프로그램을 설치하고, 리소스 공급자를 연결하고, 타사 리포지토리를 CodeCatalyst 프로젝트에 연결한 후 CodeCatalyst 워크플로 및 개발 환경에서 사용할 수 있습니다. 블루프린트에서 생성된 코드를 사용하여 연결된 GitHub 계정, Bitbucket 작업 영역 또는 GitLab 사용자에서 타사 리포지토리를 생성할 수도 있습니다. Amazon Q Developer, 블루프린트 등과 함께 연결된 리포지토리를 사용할 수도 있습니다. 자세한 내용은 [타사 리포지토리 이벤트 후 워크플로 실행 자동 시작](extensions-workflow-repositories.md) 및 [개발 환경 생성](devenvironment-create.md) 섹션을 참조하세요.

## 블루프린트를 사용하여 프로젝트 생성
<a name="projects-create-console-template"></a>

프로젝트 블루프린트를 사용하여 모든 프로젝트 리소스와 샘플 코드를 프로비저닝할 수 있습니다. 블루프린트에 대한 자세한 내용은 [CodeCatalyst 블루프린트를 사용하여 포괄적인 프로젝트 생성블루프린트를 사용하여 포괄적인 프로젝트 생성](project-blueprints.md) 섹션을 참조하세요.

**블루프린트를 사용하여 프로젝트를 생성하려면**

1. CodeCatalyst 콘솔에서 프로젝트를 생성하려는 스페이스로 이동합니다.

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

1. **블루프린트로 시작**을 선택합니다.
**작은 정보**  
Amazon Q가 블루프린트를 제안하도록 프로젝트 요구 사항을 **Amazon Q**에 제공하여 블루프린트를 추가하도록 선택할 수 있습니다. 자세한 내용은 [Amazon Q를 사용하여 프로젝트를 생성하거나 기능을 추가할 때 블루프린트 선택](getting-started-project-assistance.md#getting-started-project-assistance-create-apply-bp) 및 [Amazon Q를 사용하여 프로젝트를 생성하거나 블루프린트를 사용하여 기능을 추가할 때의 모범 사례](#projects-create-amazon-q) 섹션을 참조하세요. 이 기능은 미국 서부(오리건) 리전에서만 사용할 수 있습니다.  
이 기능을 사용하려면 스페이스에 생성형 AI 기능을 활성화해야 합니다. 자세한 내용은 [생성형 AI 기능 관리](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-generative-ai-features.html)를 참조하세요.

1. **CodeCatalyst 블루프린트** 또는 **스페이스 블루프린트** 탭에서 블루프린트를 선택한 다음 **다음**을 선택합니다.

1. **프로젝트 이름 지정**에 프로젝트에 할당할 이름과 관련 리소스 이름을 입력합니다. 이름은 스페이스 내에서 고유해야 합니다.

1. (선택 사항) 기본적으로 블루프린트에서 생성된 소스 코드는 CodeCatalyst 리포지토리에 저장됩니다. 또는 블루프린트의 소스 코드를 타사 리포지토리에 저장하도록 선택할 수 있습니다. 자세한 내용은 [CodeCatalyst에서 확장 프로그램이 있는 프로젝트에 기능 추가확장 프로그램이 있는 프로젝트에 기능 추가](extensions.md) 섹션을 참조하세요.
**중요**  
CodeCatalyst는 연결된 리포지토리에 대한 기본 브랜치의 변경 사항 감지를 지원하지 않습니다. 연결된 리포지토리의 기본 브랜치를 변경하려면 먼저 CodeCatalyst에서 연결을 해제하고 기본 브랜치를 변경한 다음 다시 연결해야 합니다. 자세한 내용은 [CodeCatalyst에서 GitHub 리포지토리, Bitbucket 리포지토리, GitLab 프로젝트 리포지토리 및 Jira 프로젝트 연결](extensions-link.md) 섹션을 참조하세요.  
리포지토리를 연결하기 전에 항상 최신 버전의 확장 프로그램을 사용하는 것이 좋습니다.

   사용하려는 타사 리포지토리 공급자에 따라 다음 중 하나를 수행합니다.
   + **GitHub 리포지토리**: GitHub 계정을 연결합니다.

     **고급** 드롭다운 메뉴를 선택하고 GitHub를 리포지토리 공급자로 선택한 다음 블루프린트에서 생성된 소스 코드를 저장할 GitHub 계정을 선택합니다.
**참고**  
GitHub 계정을 연결하는 경우 CodeCatalyst ID와 GitHub ID 간에 ID 매핑을 설정하려면 개인 연결을 생성해야 합니다. 자세한 내용은 [개인 연결](concepts.md#personal-connection-concept) 및 [개인 연결을 사용하여 GitHub 리소스에 액세스](ipa-settings-connections.md) 섹션을 참조하세요.
   + **Bitbucket 리포지토리:** Bitbucket 작업 영역을 연결합니다.

     **고급** 드롭다운 메뉴를 선택하고 Bitbucket을 리포지토리 공급자로 선택한 다음, 블루프린트에서 생성된 소스 코드를 저장할 Bitbucket 작업 영역을 선택합니다.
   + **GitLab 리포지토리:** GitLab 사용자를 연결합니다.

     **고급** 드롭다운 메뉴를 선택하고 GitLab을 리포지토리 공급자로 선택한 다음 블루프린트에서 생성된 소스 코드를 저장할 GitLab 사용자를 선택합니다.

1. **프로젝트 리소스**에서 블루프린트 파라미터를 구성합니다. 블루프린트에 따라 소스 리포지토리의 이름을 지정할 수 있는 옵션이 있을 수 있습니다.

1. (선택 사항) 구성한 프로젝트 파라미터에 따라 업데이트가 포함된 정의 파일을 보려면 **프로젝트 미리 보기 생성**에서 **코드 보기** 또는 **워크플로 보기를** 선택합니다.

1. (선택 사항) 블루프린트의 아키텍처 개요, 필수 연결 및 권한, 블루프린트가 생성하는 리소스 유형 등 블루프린트에 대한 특정 세부 정보를 보려면 블루프린트 카드에서 **세부 정보 보기**를 선택합니다.

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

## Amazon Q를 사용하여 프로젝트를 생성하거나 블루프린트를 사용하여 기능을 추가할 때의 모범 사례
<a name="projects-create-amazon-q"></a>

프로젝트를 생성하거나 기존 프로젝트에 새 구성 요소를 추가하려는 경우, 어떤 블루프린트를 사용할지 또는 기능을 어떻게 통합할지 잘 모를 수 있습니다. CodeCatalyst에는 프로젝트 요구 사항을 분석하고 요구 사항에 가장 적합한 블루프린트를 제안할 수 있는 Amazon Q라는 생성형 AI 어시스턴트와의 통합 기능이 포함됩니다.

Amazon Q를 사용하여 요구 사항에 따라 구성 요소를 생성하는 블루프린트로 프로젝트를 만들거나 Amazon Q를 사용하여 기존 프로젝트에 블루프린트를 추가할 수 있습니다. 예를 들어 프로젝트에 웹 애플리케이션 또는 최신 애플리케이션의 리소스를 추가하려면, 요구 사항을 지정할 시 권장 블루프린트와 함께 리소스가 추가됩니다. 나머지 구성 요소에 대한 문제를 생성할 수 있습니다.

또한 Amazon Q는 제안된 블루프린트로 해결할 수 없는 요구 사항에 대한 문제를 생성합니다. 또한 이러한 문제를 Amazon Q에 할당할 수 있습니다. Amazon Q에 문제를 할당하면 평가하기 위해 솔루션 초안을 생성하려고 시도합니다. 이렇게 하면 사용자와 팀이 주의가 필요한 문제에 집중하고 작업을 최적화하는 데 도움이 되며, Amazon Q는 즉시 해결할 리소스가 없는 문제에 대한 솔루션을 제공합니다.

**참고**  
**Amazon Bedrock:implements 자동 침해 탐지로 구동**됩니다. AWS [https://docs.aws.amazon.com//bedrock/latest/userguide/abuse-detection.html](https://docs.aws.amazon.com//bedrock/latest/userguide/abuse-detection.html) 소프트웨어 개발용 Amazon Q Developer Agent의 **설명 쓰기**, **콘텐츠 요약 생성**, **권장 작업**, **Amazon Q를 사용하여 프로젝트에 기능을 생성하거나 추가**, **Amazon Q에 문제 할당** 기능은 Amazon Bedrock에 구축되므로, 사용자는 Amazon Bedrock에서 구현된 제어 기능을 최대한 활용하여 안전, 보안 및 인공 지능(AI)을 책임 있게 사용할 수 있습니다.

다음은 Amazon Q를 사용하여 프로젝트를 생성하고 블루프린트를 추가하는 데 도움이 되는 몇 가지 모범 사례입니다.

**중요**  
생성형 AI 기능은 미국 서부(오리건) 리전에서만 사용할 수 있습니다.
+ **Amazon Q 에서 제공하는 기본 프롬프트를 사용합니다**. Amazon Q는 제공된 프롬프트에서 블루프린트를 선택하는 것이 가장 좋습니다.
+ **Amazon Q에서 제안한 구성 옵션을 사용하여 블루프린트를 미리 봅니다**. 블루프린트를 선택하여 블루프린트에서 생성할 샘플 코드와 리소스를 미리 봅니다.
+ **Amazon Q에 대해 활성화된 스페이스를 사용합니다**. Amazon Q를 사용하여 프로젝트를 생성하거나 Amazon Q를 사용하여 블루프린트가 있는 프로젝트에 기능을 추가하려면, 생성형 AI 기능에 대해 활성화된 스페이스를 사용합니다. 자세한 내용은 [스페이스에 대한 생성형 AI 기능 활성화 또는 비활성화](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-generative-ai-features.html#managing-generative-ai-features-enable-disable)를 참조하세요.
+ **Amazon Q에서 권장하는 블루프린트에 대한 자세한 내용을 확인하세요**. 특정 권장 블루프린트로 생성된 프로젝트 리소스, 샘플 코드 및 구성 요소의 종류에 대해 자세히 찾아볼 수 있습니다. CodeCatalyst에서 사용 가능한 블루프린트에 대한 자세한 내용은 [CodeCatalyst 블루프린트를 사용하여 포괄적인 프로젝트 생성블루프린트를 사용하여 포괄적인 프로젝트 생성](project-blueprints.md)섹션을 참조하세요.
+ **Amazon Q가 문제를 처리하도록 허용합니다**. Amazon Q가 문제를 생성하고, 해당 문제를 할당하고, 추적하도록 허용합니다. 자세한 내용은 [자습서: CodeCatalyst 생성형 AI 기능을 사용하여 개발 작업 속도 향상](getting-started-project-assistance.md) 단원을 참조하십시오.
+ **더 이상 작업하지 않는 문제에서 Amazon Q 할당을 취소합니다**. 예시를 완료한 후, 더 이상 작업하지 않는 문제에서 Amazon Q 할당을 취소합니다. Amazon Q가 문제에 대한 작업을 완료했거나 솔루션을 찾을 수 없는 경우 생성형 AI 기능의 최대 할당량에 도달하지 않도록 Amazon Q를 할당 취소해야 합니다. 자세한 내용은 [생성형 AI 기능 관리](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-generative-ai-features.html) 및 [요금](https://codecatalyst.aws/explore/pricing)을 참조하세요.
+ **Amazon Q 의 사용량을 봅니다**. 사용자 수준에서 생성형 AI 기능의 사용량을 볼 수 있습니다. **내 설정**으로 이동하여 생성형 AI 할당량을 관리하고 Builder ID 또는 AWS Single Sign-On(SSO) ID별로 사용량을 확인합니다. 자세한 내용은 [스페이스에서 생성형 AI 기능 사용량 보기](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-generative-ai-features.html#managing-generative-ai-features-view-usage)를 참조하세요.

**중요**  
CodeCatalyst의 생성형 AI 기능에는 할당량이 적용됩니다. 자세한 내용은 [Amazon Q Developer 요금](https://aws.amazon.com/q/developer/pricing/), [ 스페이스에 대한 생성형 AI 기능 활성화 또는 비활성화](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-generative-ai-features.html#managing-generative-ai-features-enable-disable) 및 [ 청구](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-billing.html)를 참조하세요.

## 프로젝트에서 블루프린트를 사용하는 모범 사례
<a name="projects-create-use-blueprints"></a>

다음은 블루프린트로 프로젝트를 생성하거나 블루프린트를 추가하는 데 도움이 되는 몇 가지 모범 사례입니다.
+ **CodeCatalyst에서 제공하는 블루프린트를 사용하여 프로젝트를 생성하거나 에 추가합니다**. 블루프린트를 사용하여 개발자를 위한 소스 코드 및 리소스가 포함된 전체 프로젝트를 생성할 수 있습니다. 예를 들어 웹 애플리케이션 블루프린트는 애플리케이션 및 인프라 리소스를 생성하고 웹 애플리케이션을 배포합니다. 블루프린트로 프로젝트를 생성하거나 기존 프로젝트에 사용자 지정 블루프린트를 추가할 수 있습니다. 자세한 내용은 [블루프린트를 사용하여 프로젝트 생성](create-project-with-bp.md) 단원을 참조하십시오. CodeCatalyst의 블루프린트를 보고 블루프린트에서 생성할 샘플 코드와 리소스를 미리 봅니다.
+ **조직에서 설계한 사용자 지정 블루프린트를 사용합니다**. 사용자 지정 블루프린트를 사용하여 스페이스에 전체 프로젝트를 생성할 수 있습니다. 조직에서 설계한 사용자 지정 블루프린트는 표준화 및 모범 사례를 제공할 수 있으며, 이를 통해 새 프로젝트를 설정할 때 드는 노력을 줄일 수도 있습니다. 사용자 지정 블루프린트 작성자는 스페이스 전체에서 블루프린트를 사용하는 프로젝트에 대한 세부 정보를 볼 수 있습니다. 수명 주기 관리를 사용하면 모든 프로젝트의 소프트웨어 개발 수명 주기를 중앙에서 관리할 수 있으며, 블루프린트 사용자는 수명 주기 관리를 사용하여 업데이트된 옵션 또는 블루프린트 버전에서 코드베이스를 재생성할 수 있습니다. 자세한 내용은 [블루프린트 작성자로서 수명 주기 관리 작업](lifecycle-management-dev.md) 단원을 참조하십시오.
+ **프로젝트 계정에 개발자 역할 또는 적절한 IAM 역할을 추가합니다**. 프로젝트 생성 단계 중 또는 완료 후, 스페이스에 연결된 AWS 계정 에서 IAM 역할을 선택하거나 생성하여 블루프린트 권한을 구성할 수 있습니다.

## 생성된 프로젝트에 리소스 및 작업 추가
<a name="projects-create-after-steps"></a>

프로젝트가 준비되면 리소스와 작업을 추가할 수 있습니다.
+ 프로젝트로 생성된 CI/CD 워크플로에 대한 자세한 내용은 [워크플로 시작하기](workflows-getting-started.md) 섹션을 참조하세요.
+ Amazon S3 버킷에 빌드 아티팩트를 배포하는 새 프로젝트의 작업과 유사한 빌드 작업을 수행하려면 [워크플로로 빌드하기](build-workflow-actions.md) 및 [자습서: Amazon S3에 아티팩트 업로드](build-deploy.md) 섹션을 참조하세요.
+ 빈 프로젝트로 시작하여 CloudFormation 스택 배포로 유사한 서버리스 애플리케이션을 배포하는 작업을 수행하려면 섹션을 참조하세요[자습서: 서버리스 애플리케이션 배포](deploy-tut-lambda.md).
+ 문제 계획 보드를 추가하려면 [CodeCatalyst의 문제 처리 추적 및 구성문제 작업 추적 및 구성](issues.md) 섹션을 참조하세요.
+ 프로젝트 개요, 프로젝트 상태, 최근 팀 활동 및 할당된 작업을 보려면 [프로젝트 목록 가져오기](projects-view.md) 섹션을 참조하세요.
+ 소스 코드를 보거나 풀 요청을 생성하려면 [CodeCatalyst의 소스 리포지토리로 코드 저장 및 협업소스 리포지토리를 사용하여 코드 저장 및 협업](source.md) 섹션을 참조하세요.
+ 워크플로 실행 성공 또는 실패에 대한 상태 알림을 보내는 알림을 설정하려면 [CodeCatalyst에서 Slack 및 이메일 알림 전송](notifications-manage.md) 섹션을 참조하세요.
+ 프로젝트에 멤버를 초대하려면 [사용자에게 프로젝트 권한 부여](projects-members.md) 섹션을 참조하세요.
+ 개발 환경을 설정하려면 [CodeCatalyst에서 개발 환경으로 코드 작성 및 수정개발 환경으로 코드 작성 및 수정](devenvironment.md) 섹션을 참조하세요.

# 프로젝트 목록 가져오기
<a name="projects-view"></a>

CodeCatalyst 스페이스에서 프로젝트 권한이 있는 각 프로젝트의 세부 정보를 볼 수 있습니다.

프로젝트를 보려면 프로젝트의 멤버가거나 해당 공간에 대한 **스페이스 관리자** 역할이 있어야 합니다.

프로젝트를 아직 생성하지 않은 경우 [프로젝트 생성](projects-create.md) 섹션을 참조하세요. 프로젝트를 생성하려면 **스페이스 관리자** 역할이 있어야 합니다.
+ 프로젝트 개요에서 프로젝트 멤버, 소스 리포지토리, 워크플로 실행, 오픈 풀 요청, 프로젝트 개발 환경 및 문제를 볼 수 있습니다.
+ 프로젝트 설정에서 프로젝트 세부 정보를 보고 관리하고, 프로젝트를 삭제하고, 프로젝트에 새 멤버를 초대하고, 프로젝트 멤버를 관리하고, 알림을 구성할 수 있습니다.

## 프로젝트 작업 및 개발 환경 보기
<a name="projects-view-overview-tasks"></a>

사용자에게 할당되거나 사용자가 생성한 아직 완료되지 않은 문제 및 풀 요청, 프로젝트의 관련 개발 환경과 같은 프로젝트 작업의 요약을 보려면 콘솔을 사용합니다.

프로젝트를 보려면 프로젝트의 멤버가거나 해당 공간에 대한 **스페이스 관리자** 역할이 있어야 합니다.

**소스 리포지토리, 워크플로 실행, 문제, 풀 요청, 개발 환경 및 문제를 보려면**

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

1. 보려는 프로젝트가 있는 스페이스로 이동합니다. **프로젝트**에서 프로젝트를 선택합니다.

1. 탐색 창에서 **개요**를 선택합니다.

1. 사용자에게 할당되고 사용자가 생성한 프로젝트 작업을 봅니다.
   + **멤버 \$1 전체 보기** 목록을 통해 프로젝트 멤버 목록을 볼 수 있습니다.
   + **리포지토리** 카드를 보고 프로젝트와 연결된 소스 리포지토리를 확인합니다.
   + **워크플로 실행** 카드를 보고 프로젝트와 연결된 워크플로를 확인합니다.
   + **풀 요청 열기** 카드를 보고 코드 리포지토리 상태 요약과 더불어, 사용자에게 할당되고 사용자가 생성한 풀 요청도 확인합니다.
   + **내 개발 환경** 카드를 보고 프로젝트와 관련된 개발 환경의 요약을 확인합니다.
   + **문제** 카드를 보고 생성한 작업 또는 할당된 작업의 요약을 봅니다.

# 한 스페이스에서 모든 프로젝트 보기
<a name="projects-view-overview"></a>

스페이스의 **프로젝트** 목록에서 권한이 있는 모든 프로젝트를 볼 수 있습니다.

사용자에게 할당되거나 사용자가 생성한 아직 완료되지 않은 문제 및 풀 요청, 프로젝트의 관련 개발 환경과 같은 프로젝트 작업의 요약을 보려면 콘솔을 사용합니다.

프로젝트를 보려면 프로젝트의 멤버가거나 해당 공간에 대한 **스페이스 관리자** 역할이 있어야 합니다.

**소스 리포지토리, 워크플로 실행, 문제, 풀 요청, 개발 환경 및 문제를 보려면**

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

1. 보려는 프로젝트가 있는 스페이스로 이동합니다. **프로젝트**에서 프로젝트를 선택합니다.

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

1. 프로젝트 이름, 경로, 프로젝트 ID 및 설명을 봅니다.

## 프로젝트 설정 보기
<a name="projects-view-settings"></a>

**프로젝트 설정** 에서 프로젝트 멤버, 소스 리포지토리, 워크플로 실행, 오픈 풀 요청, 프로젝트 개발 환경 및 문제를 볼 수 있습니다.

사용자에게 할당되거나 사용자가 생성한 아직 완료되지 않은 문제 및 풀 요청, 프로젝트의 관련 개발 환경과 같은 프로젝트 작업의 요약을 보려면 콘솔을 사용합니다.

**소스 리포지토리, 워크플로 실행, 문제, 풀 요청, 개발 환경 및 문제를 보려면**

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

1. 보려는 프로젝트가 있는 스페이스로 이동합니다. **프로젝트**에서 프로젝트를 선택합니다.

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

1. 프로젝트 이름, 경로, 프로젝트 ID 및 설명을 봅니다.

## CodeCatalyst에서 다른 프로젝트로 변경
<a name="projects-view-switch"></a>

다른 프로젝트로 변경하려면 콘솔을 사용하여 액세스할 수 있는 프로젝트 목록에서 선택합니다.

**다른 프로젝트로 변경하려면**

1. CodeCatalyst 콘솔에서 상단의 프로젝트 선택기를 선택합니다.

1. 드롭다운을 확장하고 탐색할 프로젝트를 선택합니다.

# 프로젝트 삭제
<a name="projects-delete"></a>

프로젝트를 삭제하여 프로젝트의 리소스에 대한 모든 액세스를 제거할 수 있습니다. 프로젝트를 삭제하려면 스페이스 관리자 또는 프로젝트 관리자 역할이 있어야 합니다. 프로젝트를 삭제하면 프로젝트 멤버가 프로젝트 리소스에 액세스할 수 없게 되고 타사 소스 리포지토리에서 프롬프트하는 워크플로가 중지됩니다.

**프로젝트를 삭제하려면**

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

1. 보려는 프로젝트가 있는 스페이스로 이동합니다. **프로젝트**에서 프로젝트를 선택합니다.

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

1. **프로젝트 삭제**를 선택합니다.

1. **delete**를 입력하여 삭제를 확인합니다.

1. **프로젝트 삭제**를 선택합니다.

# 사용자에게 프로젝트 권한 부여
<a name="projects-members"></a>

Amazon CodeCatalyst 콘솔을 사용하여 프로젝트의 멤버를 관리할 수 있습니다. 사용자를 추가 또는 제거하고, 현재 멤버의 역할을 관리하고, 프로젝트 참여할 수 있는 초대장을 보내고, 아직 수락되지 않은 초대장을 취소할 수 있습니다.

스페이스 및 프로젝트 사용자의 멤버 페이지에서 사용자는 여러 역할을 가질 수 있습니다. 여러 역할을 지닌 사용자에게는 역할이 여러 개일 때 보이는 표시가 나타나며, 가장 많은 권한을 가진 역할이 먼저 표시됩니다.

## 멤버 및 해당 프로젝트 역할 목록 가져오기
<a name="projects-members-view"></a>

프로젝트에 사용자를 추가할 때, 다음과 같이 프로젝트 권한을 부여하는 역할을 할당합니다.
+ **프로젝트 관리자** 역할에게는 프로젝트의 모든 권한이 있습니다. 프로젝트 설정 편집, 프로젝트 권한 관리, 프로젝트 삭제 등 프로젝트의 모든 측면을 관리해야 하는 사용자에게만 이 역할을 할당합니다. 자세한 내용은 [프로젝트 관리자 역할](ipa-role-types.md#ipa-role-project-admin) 단원을 참조하십시오.
+ **기고자** 역할에게는 프로젝트에서 작업하는 데 필요한 권한이 있습니다. 프로젝트의 코드, 워크플로, 문제 및 작업을 수행해야 하는 사용자에게 이 역할을 할당합니다. 자세한 내용은 [기고자 역할](ipa-role-types.md#ipa-role-contributor) 단원을 참조하십시오.
+ **검토자** 역할에게는 검토 권한이 있습니다. 자세한 내용은 [검토자 역할](ipa-role-types.md#ipa-role-reviewer)을 참조하세요.
+ **읽기 전용** 역할에게는 읽기 권한이 있습니다. 자세한 내용은 [읽기 전용 역할](ipa-role-types.md#ipa-role-read-only)을 참조하세요.

**스페이스 관리자** 역할을 가진 사용자는 이미 스페이스의 모든 프로젝트에 대한 암시적 액세스 권한이 있으므로 프로젝트에 초대할 필요가 없습니다.

사용자를 (**스페이스 관리자** 역할을 할당하지 않고) 프로젝트에 초대하면, 사용자는 프로젝트의 **프로젝트 멤버** 표와 스페이스의 **프로젝트 멤버** 표에 표시됩니다.

**스페이스에서 사용자 및 역할을 보려면**

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

1. 보려는 프로젝트가 있는 스페이스로 이동합니다. **프로젝트**에서 프로젝트를 선택합니다.

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

1. **멤버** 탭을 선택합니다.

   **프로젝트 멤버** 테이블에는 프로젝트에서 역할을 가진 모든 멤버가 표시됩니다.
**작은 정보**  
**스페이스 관리자** 역할이 있는 경우 직접 초대된 프로젝트를 볼 수 있습니다. 프로젝트의 **프로젝트 설정**으로 이동한 다음, **내 프로젝트**를 선택합니다.

   **스페이스 관리자** 테이블에는 **스페이스 관리자** 역할을 지닌 사용자가 표시됩니다. 이러한 사용자는 스페이스의 모든 프로젝트에 자동으로(암시적으로) 할당되며 프로젝트에 역할이 없습니다.

   **상태** 열에 유효한 값은 다음과 같습니다.
   + **초대됨** - CodeCatalyst가 초대를 보냈지만 사용자가 아직 수락하거나 거부하지 않았습니다.
   + **멤버** - 사용자가 초대를 수락했습니다.

**Topics**
+ [멤버 및 해당 프로젝트 역할 목록 가져오기](#projects-members-view)
+ [프로젝트에 사용자 초대](#projects-members-add)
+ [초대 취소](#projects-members-cancel-invite)
+ [프로젝트에서 사용자 제거](#projects-members-remove)
+ [프로젝트 초대 수락 또는 거부](#w2aac27c19c15c25)

## 프로젝트에 사용자 초대
<a name="projects-members-add"></a>

콘솔을 사용하여 사용자를 프로젝트에 초대할 수 있습니다. 스페이스 외부에서 스페이스 멤버로 초대하거나 이름을 추가할 수 있습니다.

사용자를 프로젝트에 초대하려면 **프로젝트 관리자** 또는 **스페이스 관리자** 역할로 로그인해야 합니다.

**스페이스 관리자** 역할을 가진 사용자는 이미 스페이스의 모든 프로젝트에 대한 암시적 액세스 권한이 있으므로 프로젝트에 초대할 필요가 없습니다.

사용자를 (**스페이스 관리자** 역할을 할당하지 않고) 프로젝트에 초대하면, 사용자는 프로젝트의 **프로젝트 멤버** 표와 스페이스의 **프로젝트 멤버** 표에 표시됩니다.

**프로젝트 설정 탭에서 프로젝트에 멤버를 초대하려면**

1. 프로젝트로 이동합니다.
**작은 정보**  
상단 탐색 모음에서 보려는 프로젝트를 선택할 수 있습니다.

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

1. **멤버** 탭을 선택합니다.

1. **프로젝트 멤버**에서 **새 멤버 초대**를 선택합니다.

1. 새 멤버의 이메일 주소를 입력하고 이 멤버의 역할을 선택한 다음 **초대**를 선택합니다. 역할에 관한 자세한 내용은 [사용자 역할로 액세스 권한 부여](ipa-roles.md) 섹션을 참조하세요.

**프로젝트 개요 페이지에서 프로젝트에 멤버를 초대하려면**

1. 프로젝트로 이동합니다.
**작은 정보**  
상단 탐색 모음에서 보려는 프로젝트를 선택할 수 있습니다.

1. **멤버 \$1** 버튼을 선택합니다.

1. 새 멤버의 이메일 주소를 입력하고 이 멤버의 역할을 선택한 다음 **초대**를 선택합니다. 역할에 관한 자세한 내용은 [사용자 역할로 액세스 권한 부여](ipa-roles.md) 섹션을 참조하세요.

## 초대 취소
<a name="projects-members-cancel-invite"></a>

최근에 초대를 보낸 경우, 초대가 아직 수락되지 않은 한 취소할 수 있습니다.

프로젝트 초대를 관리하려면 **프로젝트 관리자** 또는 **스페이스 관리자** 역할이 있어야 합니다.

**프로젝트 멤버 초대를 취소하려면**

1. 취소하려는 초대장을 보낸 프로젝트로 이동합니다.

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

1. **멤버** 탭을 보고 멤버의 상태가 **초대됨**인지 확인합니다.
**참고**  
아직 수락되지 않은 초대만 취소할 수 있습니다.

1. 초대된 멤버가 있는 행 옆의 옵션을 선택한 다음 **초대 취소**를 선택합니다.

1. 확인 창이 표시됩니다. **초대 취소**를 선택하여 확인합니다.

## 프로젝트에서 사용자 제거
<a name="projects-members-remove"></a>

콘솔을 사용하여 프로젝트에서 사용자를 제거할 수 있습니다.

프로젝트에서 사용자를 제거하려면 **프로젝트 관리자** 또는 **스페이스 관리자** 역할로 로그인해야 합니다.

**참고**  
한 명의 사용자를 한 스페이스 내의 모든 프로젝트에서 제거하면 해당 스페이스에서 해당 사용자가 자동으로 제거됩니다.

**사용자를 프로젝트에서 제거하려면**

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

1. 보려는 프로젝트가 있는 스페이스로 이동합니다. **프로젝트**에서 프로젝트를 선택합니다.

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

1. **멤버** 탭을 선택합니다.

1. 제거하려는 프로파일 옆의 선택기를 선택한 다음 **제거** 선택합니다.

1. 해당 사용자를 제거할지 확인한 다음, **제거**를 선택합니다.

## 프로젝트 초대 수락 또는 거부
<a name="w2aac27c19c15c25"></a>

Amazon CodeCatalyst 프로젝트에 참여하도록 권하는 이메일 초대장을 받을 수 있습니다. 여러분은 초대를 수락하거나 거부할 수 있습니다.

**초대를 수락하거나 거부하려면**

1. 초대 이메일을 엽니다.

1. 이메일에서 프로젝트 링크를 선택합니다.

1. **수락** 또는 **거부**를 선택합니다.

   **거부**를 선택하면 초대를 거부했음을 알리는 이메일이 프로젝트 관리 계정으로 전송됩니다.

# 팀을 통해 프로젝트 액세스 허용
<a name="projects-teams"></a>

프로젝트를 생성한 후 팀을 추가할 수 있습니다. 팀을 통해 CodeCatalyst에서 프로젝트 및 스페이스 멤버로서 권한을 공유하고 프로젝트, 문제 추적, 역할 및 리소스를 관리할 수 있도록 사용자를 그룹화할 수 있습니다.

프로젝트의 팀을 관리하려면 **프로젝트 관리자** 역할이 있어야 합니다.

또한 팀은 CodeCatalyst의 스페이스 수준에서 관리됩니다. 스페이스의 팀에 대한 자세한 내용은 [팀을 사용하여 스페이스 액세스 허용](managing-teams.md) 섹션을 참조하세요.

**Topics**
+ [프로젝트에 팀 추가](projects-teams-add.md)
+ [팀에 프로젝트 역할 부여](projects-teams-project-roles.md)
+ [팀의 프로젝트 역할 제거](projects-teams-remove.md)

# 프로젝트에 팀 추가
<a name="projects-teams-add"></a>

팀원이 프로젝트의 리소스에 액세스할 수 있는 팀을 관리할 수 있습니다.

스페이스 및 프로젝트 사용자의 멤버 페이지에서 사용자는 여러 역할을 가질 수 있습니다. 여러 역할을 지닌 사용자에게는 역할이 여러 개일 때 보이는 표시가 나타나며, 가장 많은 권한을 가진 역할이 먼저 표시됩니다.

**팀을 추가하려면**

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

1. 프로젝트로 이동합니다. **프로젝트 설정**을 선택하고 **팀**을 선택합니다.

1. **팀 추가**를 선택합니다.

1. **팀**의 사용 가능한 팀 목록에서 팀을 선택합니다.

1. **프로젝트 역할**의 CodeCatalyst 내 사용할 수 있는 프로젝트 역할 목록에서 역할을 선택합니다.
   + **프로젝트 관리자** - 자세한 내용은 [프로젝트 관리자 역할](ipa-role-types.md#ipa-role-project-admin) 섹션을 참조하세요.
   + **기고자** - 자세한 내용은 [기고자 역할](ipa-role-types.md#ipa-role-contributor) 섹션을 참조하세요.
   + **검토자** - 자세한 내용은 [검토자 역할](ipa-role-types.md#ipa-role-reviewer) 섹션을 참조하세요.
   + **읽기 전용** - 자세한 내용은 [읽기 전용 역할](ipa-role-types.md#ipa-role-read-only) 섹션을 참조하세요.

1. **팀 추가**를 선택합니다.

# 팀에 프로젝트 역할 부여
<a name="projects-teams-project-roles"></a>

팀은 한 스페이스에 **파워 유저**와 같은 역할 권한을 가질 수 있습니다. 팀의 스페이스 역할은 변경할 수 있지만, 팀의 모든 멤버가 해당 권한을 상속한다는 점에 유의해야 합니다.

**프로젝트 역할을 추가하거나 변경하려면**

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

1. 스페이스로 이동합니다. **프로젝트 설정**을 선택하고 **팀**을 선택합니다.

1. 역할을 변경하려면 이 목록의 팀 옆에 있는 선택기를 선택한 다음 **역할 변경**을 선택합니다. 역할을 추가하려면 **프로젝트 역할 추가**를 선택합니다. **프로젝트**에서 추가할 프로젝트를 선택하고 **역할**에서 역할을 선택합니다. 사용 가능한 프로젝트 역할 중 하나를 선택합니다.
   + **프로젝트 관리자** - 자세한 내용은 [프로젝트 관리자 역할](ipa-role-types.md#ipa-role-project-admin) 섹션을 참조하세요.
   + **기고자** - 자세한 내용은 [기고자 역할](ipa-role-types.md#ipa-role-contributor) 섹션을 참조하세요.
   + **검토자** - 자세한 내용은 [검토자 역할](ipa-role-types.md#ipa-role-reviewer) 섹션을 참조하세요.
   + **읽기 전용** - 자세한 내용은 [읽기 전용 역할](ipa-role-types.md#ipa-role-read-only) 섹션을 참조하세요.

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

# 팀의 프로젝트 역할 제거
<a name="projects-teams-remove"></a>

CodeCatalyst에서 팀의 프로젝트 역할을 볼 수 있습니다. 팀의 멤버도 확인이 가능합니다. 또한 팀의 프로젝트 역할을 제거할 수도 있습니다.

**프로젝트 역할을 제거하려면**

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

1. 스페이스로 이동합니다. **프로젝트 설정**을 선택하고 **팀**을 선택합니다.

1. **프로젝트 역할** 탭을 선택합니다.

1. 제거할 역할을 선택합니다.
**중요**  
팀에서 역할을 제거하면 팀의 모든 사용자가 지닌 관련 권한이 제거됩니다.

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

# 시스템 리소스에 대한 프로젝트 액세스 허용
<a name="projects-machine-resources"></a>

시스템 리소스는 CodeCatalyst의 프로젝트 또는 스페이스에 대한 권한이 부여된 CodeCatalyst의 특정 리소스입니다.

**참고**  
시스템 리소스라는 용어는 EC2 인스턴스와 같은 클라우드 인프라를 가리키는 것이 아니라 스페이스 또는 프로젝트에 대한 권한이 있는 블루프린트 또는 워크플로 리소스를 의미합니다.

프로젝트에서 시스템 리소스를 사용하는 작업의 예로는 블루프린트 리소스가 사용자를 대신하여 프로젝트에 액세스할 수 있도록 하는 것이 포함됩니다.

시스템 리소스는 SSO를 통해 CodeCatalyst에 액세스할 때 승인된 리소스의 ID를 나타냅니다. 시스템 리소스는 **블루프린트** 및 **워크플로**와 같은 프로젝트의 리소스에 권한을 부여하는 데 사용됩니다. 프로젝트의 시스템 리소스는 확인할 수 있으며 프로젝트의 시스템 리소스를 활성화하거나 비활성화하도록 선택할 수 있습니다. 예를 들어, 액세스를 관리하기 위해 시스템 리소스를 비활성화했다가 나중에 다시 활성화할 수도 있습니다.

이러한 작업은 시스템 리소스를 취소하거나 비활성화해야 하는 경우 시스템 리소스에 사용할 수 있습니다. 예를 들어 자격 증명이 손상되었을 수 있다고 의심되는 경우 시스템 리소스를 비활성화할 수 있습니다. 일반적으로 이러한 작업은 사용할 필요가 없습니다.

이 페이지를 보고 프로젝트 수준에서 시스템 리소스를 관리하려면 **스페이스 관리자** 역할 또는 **프로젝트 관리자** 역할이 있어야 합니다.

또한 시스템 리소스는 CodeCatalyst의 스페이스 수준에서 관리됩니다. 스페이스/프로젝트의 팀에 대한 자세한 내용은[시스템 리소스에 대한 스페이스 액세스 허용](managing-machine-resources.md) 섹션을 참조하세요.

**Topics**
+ [시스템 리소스에 대한 프로젝트 액세스 보기](projects-machine-resources-view.md)
+ [시스템 리소스에 대한 프로젝트 액세스 비활성화](projects-machine-resources-disable.md)
+ [시스템 리소스에 대한 프로젝트 액세스 활성화](projects-machine-resources-enable.md)

# 시스템 리소스에 대한 프로젝트 액세스 보기
<a name="projects-machine-resources-view"></a>

프로젝트에서 사용 중인 시스템 리소스 목록을 볼 수 있습니다.

**스페이스 관리자** 역할 또는 **프로젝트 관리자** 역할이 있어야 합니다.

**시스템 리소스를 보려면**

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

1. 프로젝트로 이동한 다음 **프로젝트 설정**을 선택합니다. **시스템 리소스**를 선택합니다.

1. 드롭다운에서 **워크플로 작업**을 선택하여 워크플로에 대한 시스템 리소스만 봅니다. **블루프린트**에 대한 시스템 리소스만 보려면 블루프린트를 선택합니다.

   **필터** 필드를 사용하여 이름을 필터링할 수도 있습니다.

# 시스템 리소스에 대한 프로젝트 액세스 비활성화
<a name="projects-machine-resources-disable"></a>

프로젝트에서 사용 중인 시스템 리소스를 비활성화하도록 선택할 수 있습니다.

**중요**  
시스템 리소스를 비활성화하면 스페이스의 모든 관련 블루프린트 또는 워크플로에 대한 모든 권한이 제거됩니다.

**스페이스 관리자** 역할 또는 **프로젝트 관리자** 역할이 있어야 합니다.

**시스템 리소스를 비활성화하려면**

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

1. 프로젝트로 이동한 다음 **프로젝트 설정**을 선택합니다. **시스템 리소스**를 선택합니다.

1. 다음 중 하나를 선택합니다.
**중요**  
시스템 리소스를 비활성화하면 스페이스의 모든 관련 블루프린트 또는 워크플로에 대한 모든 권한이 제거됩니다.
   + 개별적으로 비활성화하려면, 비활성화하려는 하나 이상의 시스템 리소스 옆에 있는 선택기를 선택합니다. **비활성화**를 선택한 다음 **이 리소스**를 선택합니다.
   + 모든 리소스를 비활성화하려면 **비활성화**를 선택한 다음 **모든 리소스**를 선택합니다.
   + 모든 워크플로 작업을 비활성화하려면 **비활성화**를 선택한 다음 **모든 워크플로 작업**을 선택합니다.
   + 모든 블루프린트를 비활성화하려면 **비활성화**를 선택한 다음 **모든 블루프린트**를 선택합니다.

# 시스템 리소스에 대한 프로젝트 액세스 활성화
<a name="projects-machine-resources-enable"></a>

프로젝트에서 사용 중이고 비활성화된 시스템 리소스를 활성화하도록 선택할 수 있습니다.

**스페이스 관리자** 역할 또는 **프로젝트 관리자** 역할이 있어야 합니다.

**시스템 리소스를 활성화하려면**

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

1. 프로젝트로 이동한 다음 **프로젝트 설정**을 선택합니다. **시스템 리소스**를 선택합니다.

1. 다음 중 하나를 선택합니다.
   + 개별적으로 활성화하려면 활성화하려는 하나 이상의 시스템 리소스 옆에 있는 선택기를 선택합니다. **활성화**를 선택한 다음 **이 리소스**를 선택합니다.
   + 모든 리소스를 활성화하려면 **활성화**를 선택한 다음 **모든 리소스**를 선택합니다.
   + 모든 워크플로 작업을 활성화하려면 **활성화**를 선택한 다음 **모든 워크플로 작업**을 선택합니다.
   + 모든 블루프린트를 활성화하려면 **활성화**를 선택한 다음 **모든 블루프린트**를 선택합니다.

# 프로젝트 할당량
<a name="projects-quotas"></a>

다음 표에서는 Amazon CodeCatalyst의 프로젝트에 대한 할당량 및 제한을 설명합니다. Amazon CodeCatalyst의 할당량에 대한 자세한 내용은 [CodeCatalyst 할당량](quotas.md) 섹션을 참조하세요.


|  |  | 
| --- |--- |
| 스페이스당 최대 프로젝트 수 | 100 | 
| 사용자가 속할 수 있는 최대 프로젝트 수 | 1,000 | 
| 프로젝트에 속할 수 있는 최대 멤버 수 | 10,000 | 
| 프로젝트 이름 |  프로젝트 이름은 스페이스에서 고유해야 합니다. 이름은 3\$163자 이내로 작성해야 합니다. 이름은 대/소문자를 구분합니다. 프로젝트 이름은 영숫자 문자로 시작해야 합니다. 유효한 문자: **a\$1z, A\$1Z, 0\$19, 공백,** **.(마침표), \$1(밑줄), -(하이픈)** 프로젝트 이름에 포함할 수 없는 문자: `! ? @ # $ % ^ & * ( ) + = { } [ ] \| \ / > < ~ ` ' " ; : `  | 
| 프로젝트 설명 |  프로젝트 설명은 최대 200자까지 입력이 가능합니다. 유효한 문자: **a\$1z, A\$1Z, 0\$19, 공백,** **.(마침표), \$1(밑줄), -(하이픈)** 프로젝트 설명은 선택 사항입니다.  | 

# CodeCatalyst에서 알림 전송
<a name="notifications"></a>

CodeCatalyst에서 프로젝트 및 리소스를 모니터링하도록 알림을 설정할 수 있습니다. 사용자는 자신이 멤버인 모든 프로젝트에서 이메일을 수신하려는 프로젝트 이벤트를 선택할 수 있습니다. CodeCatalyst 스페이스와 Slack 작업 영역 간의 액세스를 구성한 다음 해당 Slack 작업 영역의 하나 이상의 채널로 전송할 프로젝트에 대한 알림을 구성하여, Slack과 같은 팀 메시징 애플리케이션의 전체 팀에 전송되는 알림을 구성하도록 선택할 수도 있습니다. CodeCatalyst 스페이스와 Slack 작업 영역 간에 액세스를 구성한 후에는 연결된 Slack 작업 영역 및 채널의 CodeCatalyst 이벤트에 대해 직접 알림을 받을 수 있도록 프로젝트 멤버에게 자체 Slack 멤버 ID를 추가할 수도 있습니다.

**참고**  
Slack으로 전송할 수 있는 프로젝트 이벤트 세트는 사용자가 이메일로 알림을 받기로 선택할 수 있는 이벤트 세트와 다릅니다.

**Topics**
+ [알림은 어떻게 작동합니까?](notifications-concepts.md)
+ [스택 알림 시작하기](getting-started-notifications.md)
+ [CodeCatalyst에서 Slack 및 이메일 알림 전송](notifications-manage.md)

# 알림은 어떻게 작동합니까?
<a name="notifications-concepts"></a>

Slack과 같은 팀 메시징 애플리케이션에 알림을 제공하도록 프로젝트를 설정할 수 있습니다.



## 알림에는 어떤 권한이 필요한가요?
<a name="notifications-concepts-permissions"></a>

모든 프로젝트 멤버는 CodeCatalyst의 채널에 대한 알림 설정을 구성, 확인, 업데이트 또는 삭제할 수 있습니다. 그러나 **스페이스 관리자** 역할을 가진 사용자만 Slack 작업 영역을 추가하거나 삭제할 수 있습니다. 모든 사용자는 CodeCatalyst에서 자신이 속한 프로젝트에 대해 이메일을 수신하려는 프로젝트 이벤트를 구성할 수 있습니다.

## 알림을 구성할 수 있는 CodeCatalyst 이벤트는 무엇인가요?
<a name="notifications-concepts-events"></a>

워크플로 이벤트에 대한 알림을 하나 이상의 Slack 채널에 전달하도록 CodeCatalyst를 구성할 수 있습니다. CodeCatalyst 프로젝트와 Slack 간에 알림이 구성되면, 프로젝트 사용자는 자신의 Slack 멤버 ID를 추가하여 CodeCatalyst 이벤트에 대해 Slack 채널에서 다이렉트 메시지를 수신하도록 선택할 수 있습니다. Slack 멤버 ID를 추가하는 사용자는 프로젝트에 구성된 Slack 채널의 ID로 직접 언급을 받게 되므로 관심 있는 이벤트에 대한 인식을 높이는 데 도움이 됩니다.

이메일을 수신하려는 이벤트를 선택할 수도 있습니다. 이러한 이메일은 AWS Builder ID에 대해 구성된 이메일 주소로 전송됩니다.

## 알림은 어떻게 표시되나요?
<a name="notifications-concepts-delivery"></a>

하나 이상의 Slack 채널에 알림을 전달하도록 CodeCatalyst를 구성할 수 있습니다. CodeCatalyst에 Slack 작업 영역에 액세스할 수 있는 권한을 부여해야 합니다. 권한이 부여되면 CodeCatalyst는 사용자가 구성한 Slack 채널에 알림을 전송할 수 있습니다. 프로젝트 멤버가 Slack 멤버 ID를 추가하기로 선택하면, 해당 프로젝트에 대해 구성된 Slack 채널에서 CodeCatalyst 이벤트에 대한 언급을 받을 수 있습니다.

## 알림을 어떻게 설정할 수 있나요?
<a name="notifications-concepts-setup"></a>

이메일 알림은 CodeCatalyst의 일부로 구성됩니다. 프로젝트 사용자는 **내 설정** 페이지에서 이메일을 수신할 이벤트를 선택할 수 있습니다.

프로젝트 리소스에 대한 Slack 알림을 설정하려면 다음과 같은 고급 작업을 완료해야 합니다.

**알림을 설정하려면(고급 작업)**

1. CodeCatalyst에서 CodeCatalyst와 Slack과 같은 메시징 클라이언트 간의 **연결을 설정합니다**. Slack 작업 영역이 연결되면 스페이스의 모든 프로젝트에서 사용할 수 있습니다.
**참고**  
스페이스 관리자 역할을 가진 사용자만 Slack 작업 영역을 추가하거나 삭제할 수 있습니다.

1. CodeCatalyst의 프로젝트에 팀이 알림을 수신할 **채널을 추가합니다**.

1. CodeCatalyst에서는 워크플로 실행 실패와 같은 다양한 이벤트에 대한 **알림을 켜고** 전송하려는 채널을 지정합니다.

자세한 단계는 [스택 알림 시작하기](getting-started-notifications.md) 섹션을 참조하세요.

CodeCatalyst 스페이스와 Slack 간에 알림이 구성되면, 사용자는 자체 Slack 멤버 ID를 추가하여 프로젝트에 구성된 Slack 채널에서 CodeCatalyst 이벤트에 대한 다이렉트 메시지를 수신하도록 선택할 수 있습니다.

# 스택 알림 시작하기
<a name="getting-started-notifications"></a>

프로젝트를 생성한 후 팀이 프로젝트 리소스를 모니터링하는 데 도움이 되는 Slack 알림을 설정할 수 있습니다.

이 단계에서는 CodeCatalyst에서 처음으로 Slack 알림을 설정하는 방법을 안내합니다. 알림을 이미 구성한 경우 [CodeCatalyst에서 Slack 및 이메일 알림 전송](notifications-manage.md) 섹션을 참조하세요.

**참고**  
알림 채널로 전송할 수 있는 프로젝트 이벤트 세트는 사용자가 이메일로 알림을 받도록 선택할 수 있는 이벤트 세트와 다릅니다. 자세한 내용은 [CodeCatalyst에서 Slack 및 이메일 알림 전송](notifications-manage.md) 섹션을 참조하세요.

**Topics**
+ [사전 조건](#getting-started-notifications-prerequisites)
+ [1단계: CodeCatalyst를 Slack 작업 영역에 연결](#getting-started-notifications-connect-slack)
+ [2단계: CodeCatalyst에 Slack 채널 추가](#getting-started-notifications-add-slack-channel)
+ [3단계: CodeCatalyst에서 Slack으로 알림 테스트](#getting-started-notifications-next-steps)
+ [4단계: 다음 단계](#getting-started-notifications-test)

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

시작하려면 다음이 필요합니다.
+ CodeCatalyst 스페이스. CodeCatalyst 스페이스를 생성하고 처음 로그인하는 방법에 대한 자세한 내용은 [CodeCatalyst 설정 및 로그인CodeCatalyst 설정 및 로그인](setting-up-topnode.md) 섹션을 참조하세요.
+ CodeCatalyst 프로젝트. 자세한 내용은 [프로젝트 생성](projects-create.md) 섹션을 참조하세요.
+ **프로젝트 관리자** 또는 **스페이스 관리자** 역할이 있는 CodeCatalyst 계정. 자세한 내용은 [사용자 역할로 액세스 권한 부여](ipa-roles.md) 섹션을 참조하세요.
+ CodeCatalyst에서 액세스할 수 있는 Slack 계정 및 Slack 작업 영역.
+ CodeCatalyst가 알림을 보낼 Slack 채널. 이 채널은 퍼블릭 또는 프라이빗일 수 있습니다.

## 1단계: CodeCatalyst를 Slack 작업 영역에 연결
<a name="getting-started-notifications-connect-slack"></a>

**스페이스 관리자** 역할을 가진 사용자만 Slack 작업 영역을 추가하거나 삭제할 수 있습니다. Slack 작업 영역을 추가하거나 삭제하면 스페이스의 모든 프로젝트에 영향을 미칩니다. CodeCatalyst와 Slack 간의 연결을 설정하기 위해 CodeCatalyst는 Slack 작업 영역에서 보안 OAuth 인증 핸드셰이크를 수행합니다.

다음 지침을 사용하여 CodeCatalyst를 Slack 작업 영역에 연결합니다.

**참고**  
이는 각 Slack 작업 영역에 대해 한 번만 수행하면 됩니다. 그런 다음 Slack 채널을 통해 알림을 설정할 수 있습니다.

**CodeCatalyst를 Slack 작업 영역에 연결하려면**

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

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

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

1. **알림** 탭을 선택합니다.

1. **알림 구성**을 선택합니다.

1. **Slack 작업 영역에 연결**을 선택합니다.

1. 대화 상자 내용을 읽고 **Slack 작업 영역에 연결**을 선택합니다.

1. **채팅 애플리케이션의 Amazon Q Developer** 메시지에서

   1. 오른쪽 상단에서 채널이 포함된 Slack 작업 영역을 선택합니다.

   1. **허용**을 선택합니다.

   CodeCatalyst 콘솔로 돌아갑니다.

1. 계속해서 [2단계: CodeCatalyst에 Slack 채널 추가](#getting-started-notifications-add-slack-channel)로 이동하세요.

## 2단계: CodeCatalyst에 Slack 채널 추가
<a name="getting-started-notifications-add-slack-channel"></a>

CodeCatalyst에 채널을 추가하려면 Slack 채널 ID가 필요합니다.

**Slack 채널 ID를 가져오려면**

1. Slack에 로그인합니다. 자세한 내용은 [Slack에 로그인](https://slack.com/help/articles/212681477-Sign-in-to-Slack)을 참조하세요.

1. 알림을 보낼 채널이 포함된 Slack 작업 영역으로 이동합니다. 자세한 내용은 [Slack 작업 영역 간 전환](https://slack.com/help/articles/1500002200741-Switch-between-workspaces) 또는 [추가 Slack 작업 영역에 로그인](https://slack.com/help/articles/212681477-Sign-in-to-Slack)을 참조하세요.

1. 탐색 창에서 알림을 보낼 채널의 컨텍스트(마우스 오른쪽 버튼 클릭) 메뉴를 열고 **채널 세부 정보 열기**를 선택합니다.

   채널 ID는 대화 상자 하단에 표시됩니다.

1. **채널 ID** 값을 복사합니다. 다음 단계에서 이 정보를 사용할 것입니다.

방금 복사한 채널 ID를 사용하여 이제 Slack 채널을 CodeCatalyst에 연결할 수 있습니다.

**CodeCatalyst에 Slack 채널을 추가하려면**

1. 시작하기 전에 Slack 채널이 프라이빗인 경우 다음과 같이 채팅 애플리케이션에서 채널에 Amazon Q Developer를 추가합니다.

   1. Slack 채널의 메시지 상자에서 **@aws**을 입력하고 대화 상자에서 **aws 앱**을 선택합니다.

   1. 입력을 누릅니다.

      채팅 애플리케이션에서 Amazon Q Developer가 프라이빗 채널에 없음을 나타내는 Slackbot 메시지가 나타납니다.

   1. 채팅 애플리케이션에서 Amazon Q Developer를 채널에 초대하려면 **초대**를 선택합니다.

1. CodeCatalyst 콘솔에서 **다음**을 선택합니다.

1. **채널 ID**에서 이전에 얻은 Slack 채널 ID를 붙여넣습니다.

1. **채널 이름**에 이름을 입력합니다. Slack 채널 이름을 사용하는 것이 좋습니다.

1. **다음**을 선택합니다.

1. **이벤트 알림 선택**에서 알림을 받을 이벤트 유형을 선택합니다.

1. **마침**을 클릭합니다.

## 3단계: CodeCatalyst에서 Slack으로 알림 테스트
<a name="getting-started-notifications-next-steps"></a>



워크플로 상태에 대한 알림을 보내도록 프로젝트를 구성한 후 Slack에서 알림을 볼 수 있습니다.

**Slack에서 알림을 보려면**

1. CodeCatalyst 프로젝트에서 워크플로 실행을 완료하고 실행이 완료되면 상태 알림을 받으려면 [워크플로를 수동으로 시작](workflows-manually-start.md)합니다.

1. Slack에서 알림을 위해 설정한 채널을 확인합니다. 알림에는 각 워크플로 실행의 최신 상태와 실패 또는 성공 여부가 표시됩니다.

## 4단계: 다음 단계
<a name="getting-started-notifications-test"></a>

CodeCatalyst 스페이스에 대해 Slack 작업 영역이 구성되면 기존 CodeCatalyst 프로젝트를 Slack 채널에 추가하고 생성한 후 새 프로젝트에 추가할 수 있습니다. 또한 프로젝트 사용자에게 Slack 멤버 ID에 대한 개인 Slack 알림을 구성하고 이메일을 수신할 이벤트를 구성할 수 있음을 알릴 수 있습니다. 자세한 내용은 [CodeCatalyst에서 Slack 및 이메일 알림 전송](notifications-manage.md) 섹션을 참조하세요.

# CodeCatalyst에서 Slack 및 이메일 알림 전송
<a name="notifications-manage"></a>

프로젝트에서 발생하는 이벤트에 대한 알림을 보내도록 CodeCatalyst를 구성할 수 있습니다. CodeCatalyst는 Slack 채널과 같은 메시징 클라이언트에 알림을 보낼 수 있습니다. CodeCatalyst가 Slack 채널로 메시지를 보내면 전체 팀이 워크플로 실패와 같은 중요한 이벤트를 인식하는 데 도움이 됩니다. 선택적으로 CodeCatalyst가 @mention을 보내는 Slack 메시지에 포함시켜 해당 다이렉트 메시지(DM)를 수신하도록 선택할 수 있습니다.

CodeCatalyst는 이메일로 직접 알림을 보낼 수도 있습니다. 멤버인 프로젝트의 이벤트에 대한 이메일 알림이 전송됩니다. 이러한 이메일은 AWS Builder ID에 대해 구성된 이메일 주소로 전송됩니다.

**참고**  
Slack 채널로 전송할 수 있는 이벤트는 이메일로 전송할 수 있는 이벤트와 다를 수 있습니다.

**Topics**
+ [이메일 알림 구성](notifications-personal.md)
+ [Slack 채널로 알림 전송](notifications-projects.md)
+ [Slack 다이렉트 메시지 구성](notifications-personal-slack.md)
+ [알림 채널의 알림 편집](notifications-edit.md)
+ [채널 제거](notifications-remove-channel.md)

# 이메일 알림 구성
<a name="notifications-personal"></a>

멤버인 프로젝트의 이벤트에 대한 이메일 알림을 보내도록 선택할 수 있습니다. 이러한 이메일은 AWS Builder ID에 대해 구성된 이메일 주소로 전송됩니다. 기본적으로 이메일을 보낼 수 있는 모든 프로젝트 이벤트에 대한 이메일을 받게 됩니다.<a name="notifications-personal-email"></a>

**프로젝트 이벤트에 대한 이메일 알림을 구성하려면**

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

1. 상단 메뉴 바에서 프로파일 배지를 선택한 다음 **내 설정**을 선택합니다. CodeCatalyst **내 설정** 페이지가 열립니다.
**작은 정보**  
프로젝트 또는 스페이스의 멤버 페이지로 이동하고 멤버 목록에서 이름을 선택하여 자신의 사용자 프로파일을 찾을 수도 있습니다.

1. **이메일 알림**에서 이메일 알림을 구성하려는 목록에서 프로젝트를 찾아 **편집**을 선택합니다.

1. 이메일을 수신할 이벤트를 선택한 다음 **저장**을 선택합니다.

# Slack 채널로 알림 전송
<a name="notifications-projects"></a>

프로젝트 이벤트에 대한 알림을 팀의 Slack 채널로 보내도록 CodeCatalyst를 구성할 수 있습니다. 이렇게 하면 전체 팀이 워크플로 실행이 실패할 때와 같은 중요한 이벤트를 인식할 수 있습니다.

**참고**  
프로젝트의 모든 멤버는 해당 프로젝트의 채널로 전송되는 알림을 관리할 수 있습니다. 그러나 **스페이스 관리자** 역할을 가진 사용자만 Slack 작업 영역을 추가하거나 삭제할 수 있습니다.

다음 지침에 따라 알림을 전송할 Slack 채널을 추가합니다.

**알림을 전송하기 위해 Slack 채널을 추가하려면**

1. 첫 번째 Slack 채널을 추가하는 경우 대신 [스택 알림 시작하기](getting-started-notifications.md) 섹션을 참조하세요.

   첫 번째 채널을 설정한 후 이 절차로 돌아와 추가 채널을 설정합니다.

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

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

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

1. **알림** 탭을 선택합니다.

1. **Add channel**(채널 추가)을 선택합니다.

1. **작업 영역 선택**을 선택한 다음 알림을 보낼 채널이 포함된 Slack 작업 영역을 선택합니다.

   Slack 작업 영역이 목록에 없는 경우 [스택 알림 시작하기](getting-started-notifications.md)의 지침에 따라 추가할 수 있습니다.

1. **채널 ID**를 입력하기 전에, 추가하려는 Slack 채널이 비공개 채널인 경우 다음 단계를 완료합니다.

   1. Slack 채널의 메시지 상자에 팝업에서 **@aws**를 입력하고 **aws 앱**을 선택합니다.

   1. Enter를 누릅니다.

      채팅 애플리케이션에서 Amazon Q Developer가 프라이빗 채널에 없음을 나타내는 Slackbot 메시지가 나타납니다.

   1. 채팅 애플리케이션에서 Amazon Q Developer를 채널에 초대하려면 **초대**를 선택합니다.

1. CodeCatalyst **채널 ID** 필드에 Slack 채널 ID를 입력합니다. ID를 찾으려면 Slack으로 이동하여 탐색 창에서 채널을 마우스 오른쪽 버튼으로 클릭하고 **채널 세부 정보 열기**를 선택합니다.

   채널 ID는 대화 상자 하단에 표시됩니다.

1. **채널 이름**에 이름을 입력합니다. Slack 채널 이름을 사용하는 것이 좋습니다.

1. **이벤트 알림 선택**에서 알림을 받을 이벤트 유형을 선택합니다.

1. **추가**를 선택합니다.

# Slack 다이렉트 메시지 구성
<a name="notifications-personal-slack"></a>

CodeCatalyst 프로젝트가 [Slack 채널에 알림을 보내도록](notifications-projects.md) 구성된 경우 이러한 알림은 다이렉트 메시지(DM)로 전송할 수 있습니다. DM으로 알림을 직접 보내면 역할이 있는 프로젝트에서 발생하는 이벤트에 대한 인식을 높이는 데 도움이 될 수 있습니다. DM를 활성화하려면 CodeCatalyst 에 Slack 멤버 ID를 추가해야 합니다.

**Slack 다이렉트 메시지를 구성하려면**

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

1. 상단 메뉴 바에서 프로파일 배지를 선택한 다음 **내 설정**을 선택합니다. CodeCatalyst **내 설정** 페이지가 열립니다.
**작은 정보**  
프로젝트 또는 스페이스의 멤버 페이지로 이동하고 멤버 목록에서 이름을 선택하여 자신의 사용자 프로파일을 찾을 수도 있습니다.

1. **개인 Slack 알림**에서 **Slack ID 연결**을 선택한 다음 **Slack 작업 영역에 연결**을 선택합니다. 별도의 창이 열립니다.
**작은 정보**  
**스페이스 관리자** 역할이 있는 사용자가 CodeCatalyst 스페이스에 Slack 작업 영역을 추가하지 않는 한, 이 옵션은 구성할 수 없습니다. 자세한 내용은 [스택 알림 시작하기](getting-started-notifications.md) 및 [Slack 채널로 알림 전송](notifications-projects.md)(을)를 참조하세요.

1. 권한 요청 창에서 작업 영역의 이름이 CodeCatalyst 스페이스에 대해 구성된 Slack 작업 영역과 일치하는지 확인합니다. 채팅 애플리케이션에서 Amazon Q Developer가 워크스페이스에 액세스할 수 있도록 허용하려면 **허용**을 선택합니다. 창이 닫히고 Slack 작업 영역에 **연결 상태**가 **연결됨**으로 표시됩니다.
**작은 정보**  
연결 상태가 변경되지 않는 경우 Slack 작업 영역을 연결하는 동안 오류가 발생했는지 확인합니다. 오류를 보려면 위로 스크롤해야 할 수 있습니다.

1. 개인 Slack 알림 수신을 중지하려면 연결된 Slack 작업 영역을 선택한 다음 **Slack ID 연결 해제**를 선택합니다.

# 알림 채널의 알림 편집
<a name="notifications-edit"></a>

알림이 전송되는 채널을 변경하고 특정 알림을 모두 끌 수 있습니다.

**알림을 편집하려면**

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

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

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

1. **알림** 탭을 선택합니다.

1. **알림 편집**을 선택합니다.

1. 다음 중 하나를 수행합니다.
   + 특정 채널에 알림을 보내려면 드롭다운 목록에서 채널을 선택합니다.
   + 전역적으로 알림을 끄려면 알림 옆의 토글을 선택합니다.
   + 특정 채널로 알림 전송을 중지하려면 채널에서 **X**를 선택합니다.

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

# 채널 제거
<a name="notifications-remove-channel"></a>

Amazon CodeCatalyst에서 Slack 채널을 제거할 수 있습니다. Slack 채널을 제거하면 선택한 CodeCatalyst 프로젝트에 대한 알림이 더 이상 채널로 전송되지 않습니다.

**채널을 제거하려면**

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

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

1. **프로젝트 설정** 페이지에서 **알림** 탭을 선택합니다.

1. 제거할 채널 옆의 표시기를 선택한 다음 **채널 제거**를 선택합니다. 확인 창에서 **확인**을 선택합니다.