기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# AWS CodeCommit 리포지토리의 이벤트에 대한 알림 구성
개발자가 지정하는 리포지토리 이벤트 유형에 대한 이메일을 리포지토리 사용자가 수신하도록 리포지토리에 대한 알림 규칙을 설정할 수 있습니다. 이벤트가 알림 규칙 설정과 일치하면 알림이 전송됩니다. 알림을 위해 사용하거나 Amazon Web Services 계정에 기존 알림을 사용하기 위해 Amazon SNS 항목을 만들 수 있습니다. CodeCommit 콘솔과를 사용하여 알림 규칙을 AWS CLI 구성할 수 있습니다.
![\[CodeCommit 리포지토리에 구성된 알림 규칙\]](http://docs.aws.amazon.com/ko_kr/codecommit/latest/userguide/images/create-notification-rule-repository.png)
**Topics**
+ [리포지토리 알림 규칙 사용](#how-to-repository-email-using)
+ [알림 규칙 생성](notification-rule-create.md)
+ [알림 변경 또는 비활성화](how-to-repository-email-console-edit.md)
+ [알림 삭제](how-to-repository-email-delete.md)
## 리포지토리 알림 규칙 사용
알림을 구성하면 누군가가 다른 사용자에게 영향을 주는 작업을 수행하는 경우 사용자에게 이메일을 전송하여 리포지토리 사용자를 도울 수 있습니다. 예를 들어 커밋에 대한 주석이 작성될 때 알림을 전송하도록 알림 규칙을 구성할 수 있습니다. 이 구성에서는 리포지토리 사용자가 커밋의 코드 행에 주석을 추가하면 다른 리포지토리 사용자에게 이메일이 발송됩니다. 이들 리포지토리 사용자는 로그인하여 주석을 볼 수 있습니다. 주석에 댓글을 달아도 이메일이 생성되며 리포지토리 사용자에게 알려집니다.
알림 규칙은 리포지토리 트리거와 다르며 2019년 11월 5일 이전까지 CodeCommit 콘솔에서 구성할 수 있었던 알림과도 다릅니다.
+ 일부 저장소 이벤트에 대한 이메일을 보내기 위해 Amazon SNS를 사용하도록 트리거를 구성 할 수 있지만 이러한 이벤트는 분기 작성 및 분기로 코드 푸시와 같은 조작 이벤트로 제한됩니다. 트리거는 CloudWatch Events 규칙을 사용하여 리포지토리 이벤트를 평가하지 않습니다. 범위가 더욱 제한됩니다. 트리거 사용에 대한 자세한 내용은 [리포지토리 트리거 관리](how-to-notify.md) 단원을 참조하세요.
+ 2019년 11월 5일 이전까지 구성된 알림은 사용 가능한 이벤트 유형이 적었으며 Amazon Chime 채팅룸 또는 Slack 채널과 통합되도록 구성할 수 없었습니다. 2019년 11월 5일 이전까지 구성된 알림을 계속해서 사용할 수는 있지만 이러한 유형의 알림을 생성할 수 없습니다. 대신에 알림 규칙을 생성하고 사용합니다. 2019년 11월 5일 이전까지 생성된 알림을 비활성화하거나 삭제하고 알림 규칙을 사용하는 것이 좋습니다. 자세한 내용은 [알림 규칙 생성](notification-rule-create.md) 및 [알림 삭제](how-to-repository-email-delete.md) 섹션을 참조하세요.
# 알림 규칙 생성
알림 규칙을 사용하면 풀 요청이 리포지토리에 생성된 경우와 같이 중요한 변경 사항을 사용자에게 알릴 수 있습니다. 알림 규칙은 알림을 보내는 데 사용되는 이벤트와 Amazon SNS 주제를 모두 지정합니다. 자세한 내용은 [알림이란 무엇입니까?](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/welcome.html)를 참조하세요.
**참고**
이 기능은 유럽(밀라노) 리전에서 사용할 수 없습니다. 해당 지역에서 사용 가능한 환경에서 알림을 구성하는 방법에 대해 알아보려면 [리포지토리 알림 구성](https://github.com/awsdocs/aws-codecommit-user-guide/blob/master/doc_source/how-to-repository-email-create.2.md)을 참조하세요.
콘솔 또는를 사용하여 알림 규칙을 AWS CLI 생성할 수 있습니다 AWS CodeCommit.
# 알림 규칙을 생성하려면 (콘솔)
1. 에 로그인 AWS Management Console 하고 [https://console.aws.amazon.com/codecommit/](https://console.aws.amazon.com/codecommit/) CodeCommit 콘솔을 엽니다.
1. **리포지토리**를 선택하고 알림 규칙을 추가하려는 리포지토리를 선택합니다.
1. 리포지토리 페이지에서 **알림**을 선택하고 **알림 규칙 생성**을 선택합니다. 리포지토리의 **설정** 페이지로 이동하여 **알림 규칙 생성**을 선택할 수도 있습니다.
1. **알림 이름**에 규칙에 대한 이름을 입력합니다.
1. 알림에 포함된 Amazon EventBridge에 제공된 정보만 원하는 경우 **세부 정보 유형**에서 **기본**을 선택합니다. Amazon EventBridge에 제공된 정보와 CodeCommit 또는 알림 관리자에서 제공할 수 있는 정보를 포함하려는 경우 **전체**를 선택합니다.
자세한 내용은 [알림 내용 및 보안 이해](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/security.html#security-notifications)를 참조하세요.
1. **알림을 트리거하는 이벤트**에서 알림을 보내고자 하는 이벤트를 선택합니다. 자세한 내용은 [리포지토리의 알림 규칙 이벤트](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/concepts.html#events-ref-repositories)를 참조하시기 바랍니다.
1. **대상**에서 다음 중 하나를 수행합니다.
+ 알림과 함께 사용할 리소스를 이미 구성한 경우 **대상 유형 선택**에서 **채팅 애플리케이션의 Amazon Q Developer(Slack)** 또는 **SNS 주제**를 선택합니다. **대상 선택**에서 클라이언트의 이름(채팅 애플리케이션에서 Amazon Q Developer로 구성된 Slack 클라이언트의 경우) 또는 Amazon SNS 주제의 Amazon 리소스 이름(ARN)(알림에 필요한 정책으로 이미 구성된 Amazon SNS 주제의 경우)을 선택합니다.
+ 알림과 함께 사용할 리소스를 구성하지 않은 경우 **대상 생성**을 선택한 다음 **SNS 주제**를 선택합니다. **codestar-notifications-** 뒤에 주제 이름을 입력한 다음 **생성**을 선택합니다.
**참고**
알림 규칙을 만드는 과정에서 Amazon SNS 주제를 생성하면 알림 기능이 주제에 이벤트를 게시할 수 있도록 허용하는 정책이 적용됩니다. 알림 규칙에 대해 생성된 주제를 사용하면 이 리소스에 대한 알림을 받기를 원하는 사용자만 구독할 수 있습니다.
알림 규칙을 만드는 중에는 채팅 애플리케이션 클라이언트에 Amazon Q Developer를 만들 수 없습니다. 채팅 애플리케이션에서 Amazon Q Developer(Slack)를 선택하면 채팅 애플리케이션에서 Amazon Q Developer의 클라이언트를 구성하라는 버튼이 표시됩니다. 이 옵션을 선택하면 채팅 애플리케이션 콘솔에 Amazon Q Developer가 열립니다. 자세한 내용은 [채팅 애플리케이션에서 알림과 Amazon Q Developer 간의 통합 구성](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/notifications-chatbot.html)을 참조하세요.
기존 Amazon SNS 주제를 대상으로 사용하려면 해당 주제에 대해 존재할 수 있는 다른 정책 외에 AWS CodeStar Notifications에 필요한 정책을 추가해야 합니다. 자세한 내용은 [알림에 대한 Amazon SNS 주제 구성](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/set-up-sns.html)과 [알림 내용 및 보안 이해](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/security.html#security-notifications)를 참조하세요.
1. 규칙 생성을 완료하려면 **제출**을 선택합니다.
1. 사용자가 알림을 받으려면 먼저 규칙에 대한 Amazon SNS 주제를 사용자가 구독하도록 해야 합니다. 자세한 내용은 [대상인 Amazon SNS 주제에 사용자 구독](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/subscribe-users-sns.html)을 참조하세요. 채팅 애플리케이션에서 알림과 Amazon Q Developer 간의 통합을 설정하여 Amazon Chime 채팅룸에 알림을 보낼 수도 있습니다. 자세한 내용은 [채팅 애플리케이션에서 알림과 Amazon Q Developer 간의 통합 구성](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/notifications-chatbot.html)을 참조하세요.
# 알림 규칙을 생성하려면(AWS CLI)
1. 터미널 또는 명령 프롬프트에서 **create-notification rule** 명령을 실행하여 JSON 스켈레톤을 생성합니다.
```
aws codestar-notifications create-notification-rule --generate-cli-skeleton > rule.json
```
원하는 대로 파일 이름을 지정할 수 있습니다. 이 예에서는 *rule.json*으로 파일 이름을 지정합니다.
1. 일반 텍스트 편집기에서 JSON 파일을 열고 규칙에 대해 원하는 리소스, 이벤트 유형 및 대상을 포함하도록 편집합니다. 다음 예제는 ID가 *123456789012*인 계정의 *MyDemoRepo*라는 AWS 리포지토리에 **MyNotificationRule** 대한 라는 알림 규칙을 보여줍니다. 전체 세부 정보 유형의 알림은 브랜치 및 태그가 생성될 때 *MyNotificationTopic*이라는 Amazon SNS 주제로 전송됩니다.
```
{
"Name": "MyNotificationRule",
"EventTypeIds": [
"codecommit-repository-branches-and-tags-created"
],
"Resource": "arn:aws:codecommit:us-east-1:123456789012:MyDemoRepo",
"Targets": [
{
"TargetType": "SNS",
"TargetAddress": "arn:aws:sns:us-east-1:123456789012:MyNotificationTopic"
}
],
"Status": "ENABLED",
"DetailType": "FULL"
}
```
파일을 저장합니다.
1. 터미널 또는 명령줄에서 **create-notification-rule** 명령을 다시 실행하여 조금 전 편집한 파일을 사용해 알림 규칙을 생성합니다.
```
aws codestar-notifications create-notification-rule --cli-input-json file://rule.json
```
1. 성공한 경우 명령에서 다음과 유사한 알림 규칙의 ARN을 반환합니다.
```
{
"Arn": "arn:aws:codestar-notifications:us-east-1:123456789012:notificationrule/dc82df7a-EXAMPLE"
}
```
# 알림 변경 또는 비활성화
AWS CodeCommit 콘솔을 사용하여 사용자에게 이메일을 보내는 이벤트 유형과 리포지토리에 대한 이메일을 보내는 데 사용되는 Amazon SNS 주제를 포함하여 2019년 11월 5일 이전에 생성된 알림이 구성되는 방식을 변경할 수 있습니다. 또한 CodeCommit 콘솔을 사용하여 주제에 가입한 이메일 주소 및 엔드포인트의 목록을 관리하거나 알림을 비활성화할 수 있습니다.
**알림 설정을 변경하려면**
1. [https://console.aws.amazon.com/codesuite/codecommit/home](https://console.aws.amazon.com/codesuite/codecommit/home)에서 CodeCommit 콘솔을 엽니다.
1. **리포지토리**에서, 2019년 11월 5일 이전까지 생성된 알림을 구성하려는 리포지토리의 이름을 선택합니다.
1. 탐색 창에서 **설정**을 선택한 다음 **알림**을 선택합니다. 알림 규칙 대신에 알림이 있음을 알리는 배너가 표시되는 경우 **기존 알림 관리**를 선택합니다.
1. **편집**을 선택합니다.
1. 내용을 변경하고 **저장**을 선택합니다.
알림 비활성화는 사용자가 일시적으로 리포지토리 이벤트에 대한 이메일을 수신할 수 없도록 하는 쉬운 방법입니다.
2019년 11월 5일 이전까지 생성된 알림을 영구적으로 삭제하려면 [알림 삭제](how-to-repository-email-delete.md) 단원의 단계를 따릅니다.
**알림을 비활성화하려면**
1. [https://console.aws.amazon.com/codesuite/codecommit/home](https://console.aws.amazon.com/codesuite/codecommit/home)에서 CodeCommit 콘솔을 엽니다.
1. **리포지토리**에서, 알림을 비활성화하려는 리포지토리의 이름을 선택합니다.
1. 탐색 창에서 **설정**을 선택한 다음 **알림**을 선택합니다. **기존 알림 관리**를 선택합니다.
1. **편집**을 선택하고 **이벤트 상태**에서 슬라이더를 사용하여 **알림 활성화**를 해제합니다. **저장**을 선택합니다.
1. 이벤트 상태가 **비활성화됨**으로 변경됩니다. 이벤트에 대한 이메일이 전송되지 않습니다. 알림을 비활성화하면 리포지토리에 대한 CloudWatch Events 규칙도 자동으로 비활성화됩니다. CloudWatch Events 콘솔에서 상태를 수동으로 변경하지 마세요.
# 알림 삭제
2019년 11월 5일 이전까지 레포지토리에 생성된 알림을 더 이상 사용하지 않으려는 경우 알림과 연결된 Amazon CloudWatch Events 규칙을 삭제할 수 있습니다. 이렇게 하면 알림이 자동으로 삭제됩니다. 구독이나 알림에 사용된 Amazon SNS 주제는 삭제되지 않습니다.
**참고**
콘솔에서 리포지토리의 이름을 변경하면 2019년 11월 5일 이전까지 생성된 알림이 수정하지 않아도 계속 작동합니다. 하지만 명령줄이나 API를 사용하여 리포지토리의 이름을 변경할 경우 알림이 더 이상 작동하지 않습니다. 알림을 복원하는 가장 쉬운 방법은 알림 설정을 삭제하고 나서 다시 구성하는 것입니다.
**알림 설정을 삭제하려면**
1. [https://console.aws.amazon.com/codesuite/codecommit/home](https://console.aws.amazon.com/codesuite/codecommit/home)에서 CodeCommit 콘솔을 엽니다.
1. **리포지토리**에서, 2019년 11월 5일 이전까지 생성된 알림을 제거하려는 리포지토리의 이름을 선택합니다.
1. 탐색 창에서 **설정**을 선택한 다음 **알림**을 선택합니다. 알림 규칙 대신에 알림이 있음을 알리는 배너가 표시되는 경우 **기존 알림 관리**를 선택합니다.
1. **CloudWatch 이벤트 규칙**에서, 알림에 생성된 규칙의 이름을 복사합니다.
1. 에 로그인 AWS Management Console 하고 [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/) CloudWatch 콘솔을 엽니다.
1. **이벤트**에서 **규칙**을 선택합니다. **이름**에서, 알림에 생성된 규칙의 이름을 붙여 넣습니다. 규칙을 선택하고 **작업**에서 **삭제**를 선택합니다.
1. (선택 사항) 알림 설정을 삭제한 후 알림에 사용되는 Amazon SNS 주제를 변경하거나 삭제하려면, [https://console.aws.amazon.com/sns/v3/home](https://console.aws.amazon.com/sns/v3/home)에서 Amazon SNS 콘솔로 이동합니다. 자세한 정보는 [Amazon Simple Notification Service 개발자 안내서](https://docs.aws.amazon.com/sns/latest/dg/)에서 [정리](https://docs.aws.amazon.com/sns/latest/dg/CleanUp.html)를 참조하세요.