기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 예: Amazon SNS 주제에 대한 AWS CodeCommit 트리거 생성
사용자는 CodeCommit 리포지토리의 이벤트가 Amazon Simple Notification Service(SNS) 주제의 알림을 트리거하도록 CodeCommit 리포지토리의 트리거를 생성할 수 있습니다. Amazon SNS 주제에 대한 트리거를 생성하여 사용자가 브랜치 삭제와 같은 리포지토리 이벤트에 대한 알림을 구독할 수 있도록 하는 것이 좋을 수도 있습니다. Amazon Simple Queue Service(Amazon SQS) 및와 같은 다른 서비스와 Amazon SNS 주제의 통합을 활용할 수도 있습니다 AWS Lambda.Amazon SQS
**참고**
트리거는 기존 Amazon SNS 주제, 즉 리포지토리 이벤트에 대한 응답으로 취해진 조치를 가리켜야 합니다. Amazon SNS 주제 생성 및 구독에 대한 자세한 내용은 [Amazon Simple Notification Service 시작하기](https://docs.aws.amazon.com/sns/latest/dg/GettingStarted.html)를 참조하세요.
Amazon SNS FIFO(선입선출) 주제는 CodeCommit 트리거에 대해 지원되지 않습니다.
**Topics**
+ [CodeCommit 리포지토리에 Amazon SNS 주제를 위한 트리거 생성 (콘솔)](#how-to-notify-sns-console)
+ [CodeCommit 리포지토리에 Amazon SNS 주제를 위한 트리거 생성 (AWS CLI)](#how-to-notify-sns-cli)
## CodeCommit 리포지토리에 Amazon SNS 주제를 위한 트리거 생성 (콘솔)
1. [https://console.aws.amazon.com/codesuite/codecommit/home](https://console.aws.amazon.com/codesuite/codecommit/home)에서 CodeCommit 콘솔을 엽니다.
1. **리포지토리**에서, 리포지토리 이벤트 트리거를 생성하려는 리포지토리를 선택합니다.
1. 리포지토리의 탐색 창에서 **설정**을 선택한 후 **트리거**를 선택합니다.
1. **정책 생성**을 선택한 다음 다음을 수행합니다.
+ **트리거 이름**에서 트리거 이름(예: *MyFirstTrigger*)을 입력합니다.
+ **이벤트**에서, Amazon SNS 주제가 알림을 전송하도록 트리거할 리포지토리 이벤트를 선택합니다.
**모든 리포지토리 이벤트**를 선택하면, 다른 이벤트는 선택할 수 없습니다. 이벤트의 하위 집합을 선택하려면 **모든 리포지토리 이벤트**를 제거한 다음 목록에서 하나 이상의 이벤트를 선택합니다. 예를 들어, 사용자가 CodeCommit 리포지토리에 브랜치나 태그를 생성할 때만 해당 트리거가 실행되도록 하려면, **모든 리포지토리 이벤트**를 제거한 다음 **브랜치 또는 태그 생성**을 선택합니다.
+ 트리거를 리포지토리의 모든 브랜치에 적용하려면, **브랜치**에서 선택 항목을 비워 둡니다. 이 기본 옵션으로 트리거를 모든 브랜치에 자동으로 적용할 수 있기 때문입니다. 이 트리거를 특정 브랜치에만 적용하려면 리포지토리 브랜치 목록에서 브랜치 이름을 최대 10개까지 선택합니다.
+ **사용할 서비스 선택**에서 **Amazon SNS**를 선택합니다.
+ **Amazon SNS**에서는 목록의 주제 이름을 선택하거나 주제에 대한 ARN을 입력합니다.
**참고**
Amazon SNS FIFO(선입선출) 주제는 CodeCommit 트리거에 대해 지원되지 않습니다. 유형이 표준으로 설정된 Amazon SNS 주제를 선택해야 합니다.
+ **사용자 지정 데이터**에서, Amazon SNS 주제에서 전송하는 알림에 포함하려는 선택적 정보(예: 개발자가 이 리포지토리에서의 개발을 논의할 때 사용하는 IRC 채널 이름)를 입력합니다. 이 필드는 문자열입니다. 동적 파라미터를 전달하는 데 사용할 수 없습니다.
1. (선택 사항) **트리거 테스트**를 선택합니다. 이 단계를 통해 CodeCommit과 Amazon SNS 주제 간의 액세스 구성이 올바른지 확인할 수 있습니다. 이 단계에서는 Amazon SNS 주제를 사용하여 리포지토리의 데이터(있는 경우)로 테스트 알림을 보냅니다. 실제 데이터가 없는 경우에는 테스트 알림에 샘플 데이터가 포함됩니다.
1. **트리거 생성**을 선택하여 트리거 생성하기를 완료합니다.
## CodeCommit 리포지토리에 Amazon SNS 주제를 위한 트리거 생성 (AWS CLI)
사용자는 명령줄을 사용하여, CodeCommit 리포지토리의 이벤트(예: 리포지토리에 커밋을 푸시하는 경우)에 응답해 Amazon SNS 주제를 위한 트리거를 생성할 수도 있습니다.
**Amazon SNS 주제에 대한 트리거를 생성하려면**
1. 일반 텍스트 편집기를 열고 다음을 지정하는 JSON 파일을 생성합니다.
+ Amazon SNS 주제 이름.
**참고**
Amazon SNS FIFO(선입선출) 주제는 CodeCommit 트리거에 대해 지원되지 않습니다. 유형이 표준으로 설정된 Amazon SNS 주제를 선택해야 합니다.
+ 이 트리거로 모니터링하려는 리포지토리와 브랜치. (브랜치를 지정하지 않는 경우 트리거가 리포지토리의 모든 브랜치에 적용됩니다.)
+ 이 트리거를 활성화하는 이벤트.
파일을 저장합니다.
예를 들어, *MyDemoRepo*라는 리포지토리의 *main*과 *preprod*라는 두 브랜치에서 발생하는 모든 리포지토리 이벤트를 *MySNSTopic*이라는 Amazon SNS 주제에 게시하는 트리거를 생성하려면 다음과 같이 합니다.
```
{
"repositoryName": "MyDemoRepo",
"triggers": [
{
"name": "MyFirstTrigger",
"destinationArn": "arn:aws:sns:us-east-2:111122223333:MySNSTopic",
"customData": "",
"branches": [
"main", "preprod"
],
"events": [
"all"
]
}
]
}
```
JSON에는 리포지토리의 각 트리거에 대한 트리거 블록이 있어야 합니다. 리포지토리에 대한 트리거를 두 개 이상 만들려면 JSON에 두 개 이상의 트리거 블록을 포함합니다. 이 파일에 만든 모든 트리거는 지정된 리포지토리를 위한 것임을 기억하세요. 단일 JSON 파일에는 다수의 리포지토리에 대한 트리거를 생성할 수 없습니다. 예를 들어, 리포지토리에 대한 트리거를 두 개 생성하려는 경우 두 개의 트리거 블록이 있는 JSON 파일을 만들 수 있습니다. 다음 예제에서는 두 번째 트리거에 지정된 브랜치가 없으므로, 해당 트리거는 모든 브랜치에 적용됩니다.
```
{
"repositoryName": "MyDemoRepo",
"triggers": [
{
"name": "MyFirstTrigger",
"destinationArn": "arn:aws:sns:us-east-2:111122223333:MySNSTopic",
"customData": "",
"branches": [
"main", "preprod"
],
"events": [
"all"
]
},
{
"name": "MySecondTrigger",
"destinationArn": "arn:aws:sns:us-east-2:111122223333:MySNSTopic2",
"customData": "",
"branches": [],
"events": [
"updateReference", "deleteReference"
]
}
]
}
```
커밋이 리포지토리에 푸시되는 경우와 같이 지정한 이벤트에 대해 트리거를 만들 수 있습니다. 이벤트 유형에는 다음이 포함됩니다.
+ `all` - 지정된 리포지토리 및 브랜치의 모든 이벤트.
+ `updateReference` - 커밋이 지정된 리포지토리 및 브랜치로 푸시되는 경우.
+ `createReference` - 새 브랜치 또는 태그가 지정된 리포지토리에 생성되는 경우.
+ `deleteReference` - 브랜치 또는 태그가 지정된 리포지토리에서 삭제되는 경우.
**참고**
트리거에는 이벤트 유형을 두 개 이상 사용할 수 있습니다. 하지만 `all`을 지정하면 다른 이벤트를 지정할 수 없습니다.
유효한 이벤트 유형의 전체 목록을 보려면 터미널 또는 명령 프롬프트에서 **aws codecommit put-repository-triggers help**를 입력합니다.
또한 `customData`에 문자열을 포함할 수 있습니다(예: 개발자가 이 리포지토리에서의 개발을 논의할 때 사용하는 IRC 채널 이름). 이 필드는 문자열입니다. 동적 파라미터를 전달하는 데 사용할 수 없습니다. 이 문자열은 트리거에 대한 응답으로 반환되는 CodeCommit JSON에 속성으로 추가됩니다.
1. (선택 사항) 터미널 또는 명령 프롬프트에서 **test-repository-triggers** 명령을 실행합니다. 이 테스트에서는 리포지토리의 샘플 데이터를 사용하여(또는 사용 가능한 데이터가 없는 경우 샘플 데이터를 생성) Amazon SNS 주제 구독자에게 알림을 보냅니다. 예를 들어, 다음은 *trigger.json*이라는 JSON 파일이 유효하고 CodeCommit이 Amazon SNS 주제에 게시를 할 수 있는지 테스트하는 데 사용됩니다.
```
aws codecommit test-repository-triggers --cli-input-json file://trigger.json
```
이 명령이 제대로 실행되면 다음과 비슷한 정보를 반환합니다.
```
{
"successfulExecutions": [
"MyFirstTrigger"
],
"failedExecutions": []
}
```
1. 터미널 또는 명령 프롬프트에서 **put-repository-triggers** 명령을 실행하여 CodeCommit에서 트리거를 생성합니다. 예를 들어 *trigger.json*이라는 JSON 파일을 사용하여 트리거를 생성하려면 다음과 같이 합니다.
`aws codecommit put-repository-triggers --cli-input-json file://trigger.json`
이 명령은 다음과 유사한 [구성 ID](https://docs.aws.amazon.com/codecommit/latest/APIReference/API_PutRepositoryTriggers.html#-PutRepositoryTriggers-response-configurationId)를 반환합니다.
```
{
"configurationId": "0123456-I-AM-AN-EXAMPLE"
}
```
1. 트리거의 구성을 보려면, 리포지토리 이름을 지정하여 **get-repository-triggers** 명령을 실행합니다.
`aws codecommit get-repository-triggers --repository-name MyDemoRepo`
이 명령은 리포지토리에 대해 구성된 모든 트리거의 다음과 비슷한 구조를 반환합니다.
```
{
"configurationId": "0123456-I-AM-AN-EXAMPLE",
"triggers": [
{
"events": [
"all"
],
"destinationArn": "arn:aws:sns:us-east-2:111122223333:MySNSTopic",
"branches": [
"main",
"preprod"
],
"name": "MyFirstTrigger",
"customData": "Project ID 12345"
}
]
}
```
1. 트리거의 기능을 좀 더 테스트하려면, 커밋을 하나 생성한 다음 트리거를 구성한 리포지토리에 푸시합니다. 그러면 Amazon SNS 주제에서 응답을 볼 수 있습니다. 예를 들어, 이메일을 보내도록 Amazon SNS 주제를 구성한 경우에는 해당 주제를 구독하는 이메일 계정에서 Amazon SNS의 이메일을 볼 수 있습니다.
다음은 CodeCommit 리포지토리로의 푸시에 대한 응답으로 Amazon SNS에서 보낸 이메일을 출력한 예시입니다.
```
{
"Records":[
{
"awsRegion":"us-east-2",
"codecommit":{
"references" : [
{
"commit":"317f8570EXAMPLE",
"created":true,
"ref":"refs/heads/NewBranch"
},
{
"commit":"4c925148EXAMPLE",
"ref":"refs/heads/preprod",
}
]
},
"eventId":"11111-EXAMPLE-ID",
"eventName":"ReferenceChange",
"eventPartNumber":1,
"eventSource":"aws:codecommit",
"eventSourceARN":"arn:aws:codecommit:us-east-2:111122223333:MyDemoRepo",
"eventTime":"2016-02-09T00:08:11.743+0000",
"eventTotalParts":1,
"eventTriggerConfigId":"0123456-I-AM-AN-EXAMPLE",
"eventTriggerName":"MyFirstTrigger",
"eventVersion":"1.0",
"customData":"Project ID 12345",
"userIdentityARN":"arn:aws:iam::111122223333:user/JaneDoe-CodeCommit",
}
]
}
```