# Mocco 이벤트

Mocco는 Sentry, Vercel, GitHub의 이벤트를 전달하는 것 외에, 자체 배포 거버넌스 이벤트도 게시합니다. 이 이벤트에는 소스가 필요 없습니다. 채널에 규칙을 추가하면 바로 도착하기 시작합니다.

| 이벤트 | 시점 | 메시지에 표시되는 내용 |
|---|---|---|
| `gate.pending` | 실행이 게이트에 도달해 승인을 기다립니다. | 저장소, 파이프라인, 짧은 커밋, 실행을 실행한 사람, 게이트, 필요한 승인("2 × deployer" 등). 실행으로 가는 링크가 함께 표시됩니다. |
| `gate.resumed` | 적절한 역할을 가진 사람이 게이트를 재개했습니다. | 같은 실행 상세 정보와 재개한 역할. |
| `gate.rejected` | 누군가 게이트를 거부했습니다. | 같은 실행 상세 정보와 입력한 거부 사유. |
| `run.failed` | 실행이 실패했습니다. | 실행 상세 정보, 실패한 단계, 그리고 알려진 경우 로그로 가는 링크. |
| `run.succeeded` | 실행이 성공적으로 끝났습니다. | 실행 상세 정보. |

모든 메시지에는 Mocco의 해당 실행으로 돌아가는 링크가 있습니다.

## Mocco 프리셋

채널의 **Rules**에서 **Mocco** 프리셋을 고르고 **Apply**를 클릭합니다. 다음 규칙이 추가됩니다. `gate.pending`, `gate.resumed`, `gate.rejected`, `run.failed`. OTA 이벤트인 `ota.promotion.requested`, `ota.promotion.approved`, `ota.promotion.rejected`, `ota.emergency_launch.spike`. 기능 플래그 이벤트인 `flags.changeset.requested`, `flags.changeset.applied`, `flags.changeset.rejected`, `flags.flag.killed`, `flags.stale.digest`. 메신저 이벤트인 `messenger.conversation.created`, `messenger.message.received`. 피드백 이벤트인 `feedback.ship.suggested`. 프리셋은 `run.succeeded`를 제외합니다. 알림이 너무 잦은 경우가 많기 때문입니다. `messenger.conversation.unassigned`(인박스 라운드 로빈에서 아무도 맡을 수 없었던 새 대화)도 제외합니다. 생성 메시지와 중복되기 때문입니다. 필요하면 직접 추가하세요. `gate.*`나 `run.*`를 쓰면 이벤트 계열 전체를 받을 수도 있습니다.

`feedback.ship.suggested`는 릴리스가 배포되었는데 아직 출시됨으로 표시되지 않은 피드백 보드의 게시물이 있다는 사실을 팀에 알립니다. 메시지에는 게시물이 몇 개이고 어떤 것인지, 릴리스의 커밋, 릴리스를 승인한 게이트, 보드 인박스로 가는 링크가 표시됩니다. 보드와 릴리스당 한 번만 도착하며, 확인 없이 게시물을 출시됨으로 표시하는 보드에는 도착하지 않습니다. `board=<보드의 slug>` 필터로 특정 보드 하나로 좁힐 수 있습니다. [릴리스되면 게시물을 출시됨으로 표시하기](https://www.mocco.club/docs/ko/articles/zp45zj-public-board#mark-posts-shipped-when-they-release)를 참고하세요.

Mocco 이벤트는 소스에서 오지 않으므로, **Only from source**로 제한한 규칙은 Mocco 이벤트와 일치하지 않습니다.

## 필터 키

| 이벤트 | 키 |
|---|---|
| `run.*` | `repo`(`acme/web`), `pipeline`(`.mocco.yml`의 `pipeline` 이름) |
| `gate.*` | `repo`, `pipeline`, `gate`(게이트의 이름) |

예를 들어 프로덕션 승인만 `#deploys`로 보내려면, `gate.pending`에 `gate=production` 필터를 건 규칙을 추가합니다.

## Activity에서

채널 하나 이상이 Mocco 이벤트에 대한 메시지를 받았다면, 그 이벤트는 **Activity** 탭에 소스 **Mocco**로 나타납니다. 상세 정보에는 소스에서 온 이벤트와 마찬가지로 채널별 전송 결과가 표시됩니다. 각 상태의 의미는 [문제 해결](https://www.mocco.club/docs/ko/articles/pmzrkr-troubleshooting)을 참고하세요.