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

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

알림을 시작하는 가장 쉬운 방법은 빌드 프로젝트, 배포 애플리케이션, 파이프라인 또는 리포지토리 중 하나에 알림 규칙을 설정하는 것입니다.

**참고**  
처음 알림 규칙을 생성하면 해당 계정에 서비스 연결 역할이 생성됩니다. 자세한 내용은 [AWS CodeStar Notifications에 서비스 연결 역할 사용](using-service-linked-roles.md) 단원을 참조하십시오.

**Topics**
+ [사전 조건](#getting-started-prerequisites)
+ [리포지토리에 대한 알림 규칙 생성](getting-started-repository.md)
+ [빌드 프로젝트에 대한 알림 규칙 생성](getting-started-build.md)
+ [배포 애플리케이션에 대한 알림 규칙 생성](getting-started-deploy.md)
+ [파이프라인에 대한 알림 규칙 생성](getting-started-pipeline.md)

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

[설정](setting-up.md)의 단계를 수행하세요. 또한 알림 규칙을 만들 리소스가 필요합니다.
+ [CodeBuild에서 빌드 프로젝트를 생성](https://docs.aws.amazon.com/codebuild/latest/userguide/create-project.html)하거나 기존 프로젝트를 사용합니다.
+ [애플리케이션을 생성](https://docs.aws.amazon.com/codedeploy/latest/userguide/applications-create.html)하거나 기존 배포 애플리케이션을 사용합니다.
+ [CodePipeline에서 파이프라인을 생성](https://docs.aws.amazon.com/codepipeline/latest/userguide/pipelines-create.html)하거나 기존 파이프라인을 사용합니다.
+ [a AWS CodeCommit 리포지토리를 생성하거나 기존 리포지토리](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-create-repository.html)를 사용합니다.

# 리포지토리에 대한 알림 규칙 생성
<a name="getting-started-repository"></a>

알림 규칙을 생성하여 중요한 리포지토리의 이벤트에 관한 알림을 보낼 수 있습니다. 다음 단계는 단일 리포지토리 이벤트에 대한 알림 규칙을 설정하는 방법을 보여줍니다. 이러한 단계는 AWS 계정에 리포지토리가 구성되어 있다는 가정하에 작성됩니다.

**중요**  
2019년 11월 5일 이전에 CodeCommit에서 알림을 설정한 경우 해당 알림에 사용되는 Amazon SNS 주제에는 CodeCommit이 AWS CodeStar Notifications에 필요한 권한과 다른 권한이 포함된 알림을 게시하도록 허용하는 정책이 포함됩니다. 이러한 주제는 사용하지 않는 것이 좋습니다. 해당 환경에 대해 생성된 정책을 사용하려면 이미 존재하는 정책 외에도 AWS CodeStar Notifications에 필요한 정책을 추가해야 합니다. 자세한 내용은 [알림에 대한 Amazon SNS 주제 구성](set-up-sns.md) 및 [알림 콘텐츠 및 보안 이해](security.md#security-notifications) 섹션을 참조하세요.

1. [https://console.aws.amazon.com/codecommit/](https://console.aws.amazon.com/codecommit/)에서 CodeCommit 콘솔을 엽니다.

1. 목록에서 리포지토리를 선택하고 엽니다.

1. **Notify(알림)**를 선택하고 **Create notification rule(알림 규칙 생성)**을 선택합니다. **설정**을 선택하고, **알림**을 선택한 다음 **Create notification rule(알림 규칙 생성)**을 선택합니다.

1. **알림 이름**에 규칙에 대한 이름을 입력합니다.

1. 알림에 포함된 Amazon EventBridge에 제공된 정보만 원하는 경우 [**세부 정보 유형(Detail type)**]에서 [**기본(Basic)**]을 선택합니다. Amazon EventBridge에 제공된 정보와 리소스 서비스 또는 알림 관리자가 제공할 수 있는 정보를 포함하려는 경우 [**전체(Full)**]를 선택합니다.

   자세한 내용은 [알림 콘텐츠 및 보안 이해](security.md#security-notifications) 단원을 참조하십시오.

1. **Events that trigger notifications(알림을 트리거하는 이벤트)**의 **Branches and tags(브랜치 및 태그)**에서 **생성됨**을 선택합니다.

1. **대상**에서 **SNS 주제 생성**을 선택합니다.
**참고**  
알림 규칙을 만드는 과정에서 주제를 생성하면 CodeCommit이 주제에 이벤트를 게시하도록 허용하는 정책이 적용됩니다. 알림 규칙에 대해 생성된 주제를 사용하면 이 리포지토리에 대한 알림을 받기를 원하는 사용자만 구독할 수 있습니다.

   **codestar-notifications-** 접두사 뒤에 주제 이름을 입력한 다음 **제출**을 선택합니다.
**참고**  
새 항목을 생성하는 대신 기존 Amazon SNS 항목을 사용하려면 [**대상(Targets)**]에서 해당 ARN을 선택합니다. 주제에 적절한 액세스 정책이 있는지 여부와 구독자 목록에 리소스에 대한 정보를 볼 수 있는 사용자만 포함되어 있는지를 확인합니다. Amazon SNS 주제가 2019년 11월 5일 이전에 CodeCommit 알림에 사용된 주제인 경우 CodeCommit이 AWS CodeStar Notifications에 필요한 권한과 다른 권한이 포함된 주제를 게시하도록 허용하는 정책이 포함됩니다. 이러한 주제는 사용하지 않는 것이 좋습니다. 해당 환경에 대해 생성된 정책을 사용하려면 이미 존재하는 정책 외에도 AWS CodeStar Notifications에 필요한 정책을 추가해야 합니다. 자세한 내용은 [알림에 대한 Amazon SNS 주제 구성](set-up-sns.md) 및 [알림 콘텐츠 및 보안 이해](security.md#security-notifications) 섹션을 참조하세요.

1. **제출**을 선택한 다음 알림 규칙을 검토합니다.

1. 방금 생성한 Amazon SNS 주제에 대한 이메일 주소를 구독합니다. 자세한 내용은 [알림에 사용되는 Amazon SNS 주제에 대해 사용자를 구독하려면](subscribe-users-sns.md#set-up-sns-subscribe) 단원을 참조하십시오.

1. 리포지토리로 이동하여 기본 브랜치에서 테스트 브랜치를 생성합니다.

1. 브랜치를 생성하면 알림 규칙이 모든 주제 가입자에게 해당 이벤트에 대한 정보와 함께 알림을 보냅니다.

# 빌드 프로젝트에 대한 알림 규칙 생성
<a name="getting-started-build"></a>

알림 규칙을 생성하여 중요한 빌드 프로젝트의 이벤트에 관한 알림을 보낼 수 있습니다. 다음 단계는 단일 빌드 프로젝트 이벤트에 대한 알림 규칙을 설정하는 방법을 보여줍니다. 이러한 단계는 AWS 계정에 빌드 프로젝트가 구성되어 있다는 가정하에 작성됩니다.

1. [https://console.aws.amazon.com/codebuild/](https://console.aws.amazon.com/codebuild/)에서 CodeBuild 콘솔을 엽니다.

1. 목록에서 빌드 프로젝트를 선택하고 엽니다.

1. **Notify(알림)**를 선택하고 **Create notification rule(알림 규칙 생성)**을 선택합니다. **설정**을 선택한 다음 **Create notification rule(알림 규칙 생성)**을 선택할 수도 있습니다.

1. **알림 이름**에 규칙에 대한 이름을 입력합니다.

1. 

   알림에 포함된 Amazon EventBridge에 제공된 정보만 원하는 경우 [**세부 정보 유형(Detail type)**]에서 [**기본(Basic)**]을 선택합니다. Amazon EventBridge에 제공된 정보와 리소스 서비스 또는 알림 관리자가 제공할 수 있는 정보를 포함하려는 경우 [**전체(Full)**]를 선택합니다.

   자세한 내용은 [알림 콘텐츠 및 보안 이해](security.md#security-notifications) 단원을 참조하십시오.

1.  **Events that trigger notifications(알림을 트리거하는 이벤트)**의 **Build phase(빌드 단계)**에서 **성공**을 선택합니다.

1. **대상**에서 **SNS 주제 생성**을 선택합니다.
**참고**  
알림 규칙을 만드는 과정에서 주제를 생성하면 CodeBuild가 주제에 이벤트를 게시하도록 허용하는 정책이 적용됩니다. 알림 규칙에 대해 생성된 주제를 사용하면 이 빌드 프로젝트에 대한 알림을 받기를 원하는 사용자만 구독할 수 있습니다.

   **codestar-notifications-** 접두사 뒤에 주제 이름을 입력한 다음 **제출**을 선택합니다.
**참고**  
새 항목을 생성하는 대신 기존 Amazon SNS 항목을 사용하려면 [**대상(Targets)**]에서 해당 ARN을 선택합니다. 주제에 적절한 액세스 정책이 있는지 여부와 구독자 목록에 리소스에 대한 정보를 볼 수 있는 사용자만 포함되어 있는지를 확인합니다. Amazon SNS 주제가 2019년 11월 5일 이전에 CodeCommit 알림에 사용된 주제인 경우 CodeCommit이 AWS CodeStar Notifications에 필요한 권한과 다른 권한이 포함된 주제를 게시하도록 허용하는 정책이 포함됩니다. 이러한 주제는 사용하지 않는 것이 좋습니다. 해당 환경에 대해 생성된 정책을 사용하려면 이미 존재하는 정책 외에도 AWS CodeStar Notifications에 필요한 정책을 추가해야 합니다. 자세한 내용은 [알림에 대한 Amazon SNS 주제 구성](set-up-sns.md) 및 [알림 콘텐츠 및 보안 이해](security.md#security-notifications) 섹션을 참조하세요.

1. **제출**을 선택한 다음 알림 규칙을 검토합니다.

1. 방금 생성한 Amazon SNS 주제에 대한 이메일 주소를 구독합니다. 자세한 내용은 [알림에 사용되는 Amazon SNS 주제에 대해 사용자를 구독하려면](subscribe-users-sns.md#set-up-sns-subscribe) 단원을 참조하십시오.

1. 빌드 프로젝트로 이동한 다음 빌드를 시작합니다.

1. 빌드 단계가 성공적으로 완료되면 알림 규칙이 모든 주제 가입자에게 해당 이벤트에 대한 정보와 함께 알림을 보냅니다.

# 배포 애플리케이션에 대한 알림 규칙 생성
<a name="getting-started-deploy"></a>

알림 규칙을 생성하여 중요한 배포 애플리케이션의 이벤트에 관한 알림을 보낼 수 있습니다. 다음 단계는 단일 빌드 프로젝트 이벤트에 대한 알림 규칙을 설정하는 방법을 보여줍니다. 이러한 단계는 AWS 계정에 배포 애플리케이션이 구성되어 있다는 가정하에 작성되었습니다.

1. [https://console.aws.amazon.com/codedeploy/](https://console.aws.amazon.com/codedeploy/)에서 CodeDeploy 콘솔을 엽니다.

1. 목록에서 애플리케이션을 선택하고 엽니다.

1. **Notify(알림)**를 선택하고 **Create notification rule(알림 규칙 생성)**을 선택합니다. **설정**을 선택한 다음 **Create notification rule(알림 규칙 생성)**을 선택할 수도 있습니다.

1. **알림 이름**에 규칙에 대한 이름을 입력합니다.

1. 알림에 포함된 Amazon EventBridge에 제공된 정보만 원하는 경우 [**세부 정보 유형(Detail type)**]에서 [**기본(Basic)**]을 선택합니다. Amazon EventBridge에 제공된 정보와 리소스 서비스 또는 알림 관리자가 제공할 수 있는 정보를 포함하려는 경우 [**전체(Full)**]를 선택합니다.

   자세한 내용은 [알림 콘텐츠 및 보안 이해](security.md#security-notifications) 단원을 참조하십시오.

   

1.  **Events that trigger notifications(알림을 트리거하는 이벤트)**의 **배포**에서 **성공**을 선택합니다.

1. **대상**에서 **SNS 주제 생성**을 선택합니다.
**참고**  
알림 규칙을 만드는 과정에서 주제를 생성하면 CodeDeploy에서 주제에 이벤트를 게시하도록 허용하는 정책이 적용됩니다. 알림 규칙에 대해 생성된 주제를 사용하면 이 배포 애플리케이션에 대한 알림을 받기를 원하는 사용자만 구독할 수 있습니다.

   **codestar-notifications-** 접두사 뒤에 주제 이름을 입력한 다음 **제출**을 선택합니다.
**참고**  
새 항목을 생성하는 대신 기존 Amazon SNS 항목을 사용하려면 [**대상(Targets)**]에서 해당 ARN을 선택합니다. 주제에 적절한 액세스 정책이 있는지 여부와 구독자 목록에 리소스에 대한 정보를 볼 수 있는 사용자만 포함되어 있는지를 확인합니다. Amazon SNS 주제가 2019년 11월 5일 이전에 CodeCommit 알림에 사용된 주제인 경우 CodeCommit이 AWS CodeStar Notifications에 필요한 권한과 다른 권한이 포함된 주제를 게시하도록 허용하는 정책이 포함됩니다. 이러한 주제는 사용하지 않는 것이 좋습니다. 해당 환경에 대해 생성된 정책을 사용하려면 이미 존재하는 정책 외에도 AWS CodeStar Notifications에 필요한 정책을 추가해야 합니다. 자세한 내용은 [알림에 대한 Amazon SNS 주제 구성](set-up-sns.md) 및 [알림 콘텐츠 및 보안 이해](security.md#security-notifications) 섹션을 참조하세요.

1. **제출**을 선택한 다음 알림 규칙을 검토합니다.

1. 방금 생성한 Amazon SNS 주제에 대한 이메일 주소를 구독합니다. 자세한 내용은 [알림에 사용되는 Amazon SNS 주제에 대해 사용자를 구독하려면](subscribe-users-sns.md#set-up-sns-subscribe) 단원을 참조하십시오.

1. 배포 애플리케이션으로 이동하여 배포를 시작합니다.

1. 배포가 성공하면 알림 규칙이 모든 주제 구독자에게 이벤트에 대한 정보와 함께 알림을 보냅니다.

# 파이프라인에 대한 알림 규칙 생성
<a name="getting-started-pipeline"></a>

알림 규칙을 생성하여 중요한 파이프라인의 이벤트에 관한 알림을 보낼 수 있습니다. 다음 단계는 단일 파이프라인 이벤트에 대한 알림 규칙을 설정하는 방법을 보여줍니다. 이러한 단계는 AWS 계정에 파이프라인이 구성되어 있다는 가정하에 작성됩니다.

1. [https://console.aws.amazon.com/codepipeline/](https://console.aws.amazon.com/codepipeline/)에서 CodePipeline 콘솔을 엽니다.

1. 목록에서 파이프라인을 선택하고 엽니다.

1. **Notify(알림)**를 선택하고 **Create notification rule(알림 규칙 생성)**을 선택합니다. **설정**을 선택한 다음 **Create notification rule(알림 규칙 생성)**을 선택할 수도 있습니다.

1. **알림 이름**에 규칙에 대한 이름을 입력합니다.

1. 알림에 포함된 Amazon EventBridge에 제공된 정보만 원하는 경우 [**세부 정보 유형(Detail type)**]에서 [**기본(Basic)**]을 선택합니다. Amazon EventBridge에 제공된 정보와 리소스 서비스 또는 알림 관리자가 제공할 수 있는 정보를 포함하려는 경우 [**전체(Full)**]를 선택합니다.

   자세한 내용은 [알림 콘텐츠 및 보안 이해](security.md#security-notifications) 단원을 참조하십시오.

1. **Events that trigger notifications(알림을 트리거하는 이벤트)**의 **Action execution(작업 실행)**에서 **시작됨**을 선택합니다.

1. **대상**에서 **SNS 주제 생성**을 선택합니다.
**참고**  
알림 규칙을 만드는 과정에서 주제를 생성하면 CodePipeline이 주제에 이벤트를 게시하도록 허용하는 정책이 적용됩니다. 알림 규칙에 대해 생성된 주제를 사용하면 이 파이프라인에 대한 알림을 받기를 원하는 사용자만 구독할 수 있습니다.

   **codestar-notifications-** 접두사 뒤에 주제 이름을 입력한 다음 **제출**을 선택합니다.
**참고**  
새 항목을 생성하는 대신 기존 Amazon SNS 항목을 사용하려면 [**대상(Targets)**]에서 해당 ARN을 선택합니다. 주제에 적절한 액세스 정책이 있는지 여부와 구독자 목록에 리소스에 대한 정보를 볼 수 있는 사용자만 포함되어 있는지를 확인합니다. Amazon SNS 주제가 2019년 11월 5일 이전에 CodeCommit 알림에 사용된 주제인 경우 CodeCommit이 AWS CodeStar Notifications에 필요한 권한과 다른 권한이 포함된 주제를 게시하도록 허용하는 정책이 포함됩니다. 이러한 주제는 사용하지 않는 것이 좋습니다. 해당 환경에 대해 생성된 정책을 사용하려면 이미 존재하는 정책 외에도 AWS CodeStar Notifications에 필요한 정책을 추가해야 합니다. 자세한 내용은 [알림에 대한 Amazon SNS 주제 구성](set-up-sns.md) 및 [알림 콘텐츠 및 보안 이해](security.md#security-notifications) 섹션을 참조하세요.

1. **제출**을 선택한 다음 알림 규칙을 검토합니다.

1. 방금 생성한 Amazon SNS 주제에 대한 이메일 주소를 구독합니다. 자세한 내용은 [알림에 사용되는 Amazon SNS 주제에 대해 사용자를 구독하려면](subscribe-users-sns.md#set-up-sns-subscribe) 단원을 참조하십시오.

1. 파이프라인으로 이동한 다음 **변경 사항 배포**를 선택합니다.

1. 작업이 시작되면 알림 규칙이 모든 주제 구독자에게 이벤트에 대한 정보와 함께 알림을 보냅니다.