프로젝트 연동 워크플로
Integrate Unity Build Automation with external services for notifications and workflow automation.
읽는 시간 1분최근 업데이트: 한 달 전
Unity Build Automation(UBA)을 사용하여 Unity 클라우드 프로젝트를 외부 서비스와 연결하여 빌드 상태와 기타 중요한 이벤트에 대한 알림을 자동으로 수신할 수 있습니다. 이 연동을 통해 팀에 실시간으로 정보를 제공하여 워크플로를 간소화할 수 있습니다. 새 프로젝트 연동을 생성하려면 다음 작업을 완료합니다.
프로젝트 연동에 액세스
프로젝트 연동 페이지에는 프로젝트에 설정된 모든 연동 목록과 현재 상태가 표시됩니다.- Unity Dashboard에서 Administration 탭을 선택합니다.
- Integrations에서 Project Integrations를 선택합니다.
지원되는 연동
현재 UBA는 다음의 연동을 지원합니다.- Discord
- Microsoft Teams
- Slack
- Webhook
참고
참고: Slack 메시지 포맷을 커스터마이즈하는 등 고급 구성을 알아보려면 연동 중인 특정 서비스의 기술 자료를 참고하십시오.
연동 생성
- Project integrations 페이지에서 New integration을 선택합니다.
- 드롭다운 메뉴에서 설정할 연동 유형을 선택합니다.
- 선택한 연동 서비스에 연결 세부 정보와 설정을 입력합니다.
웹후크 연동 설정
커스텀 웹후크를 사용하여 알림을 전송하는 타사 연동의 경우 다음 필드를 설정해야 합니다.필드 | 설명 |
|---|---|
| Display name | 웹후크 연동을 식별할 수 있는 이름입니다. |
| Webhook URL | UBA가 |
| Authorization secret(선택 사항) | 선택한 인증 유형에 따라 UBA에서 요청 헤더나 페이로드에 포함하는 비밀 토큰입니다. 이 비밀 토큰을 사용하여 수신되는 요청이 UBA에서 발생했는지 확인합니다. |
| Authorization type | UBA에서 인증 비밀을 전송하는 방식입니다. _ 공유 비밀: UBA는 헤더 또는 페이로드 필드에 비밀을 포함합니다(서비스에 따라 다름). _ 설정에 따라 다른 옵션이 나타날 수 있습니다. |
| Content type | UBA에서 데이터를 전송하는 데 사용하는 포맷입니다. 예: |
| Disable SSL/TLS verification(선택 사항) | 이 기능을 활성화하면 UBA에서 SSL 인증서를 검증하지 않습니다. 로컬 테스트나 자체 서명된 인증서에 유용하지만, 프로덕션 환경에서는 권장되지 않습니다. |
참고
참고: 일부 서비스에는 수신되는 요청이 적합한지 확인하기 위해 공유 비밀이나 토큰이 필요합니다. Unity 측과 외부 서비스 측 모두에서 이 설정을 올바르게 설정해야 합니다.
custom-webhook-config
서비스와 이벤트 구독
연동을 설정할 때 구독할 서비스와 이벤트를 선택하고 알림을 받을 수 있습니다. UBA의 경우 다음 이벤트 중에서 선택할 수 있습니다.- 빌드 성공
- 빌드 실패
- 빌드 대기열에 추가
- 빌드 시작
- 빌드 취소
- 빌드 재시작
- 업로드된 로컬 빌드
참고
참고: 필요한 이벤트만 구독합니다. 모든 이벤트를 구독하면 채널에 불필요한 노이즈가 발생할 수 있습니다.
uba-events
연동 저장
새 연동을 Project Integrations 목록에 추가하려면 Create를 선택합니다.참고
참고: Slack이나 Discord와 연동 시 연동을 저장하기 전에 외부 서비스로 인증하려면 Authenticate & create를 선택합니다.
연동 테스트
- Unity Build Automation에서 빌드를 트리거합니다. 예를 들어 코드를 커밋하거나 수동으로 빌드를 시작합니다.
- Slack이나 Discord 등 외부 서비스에서 해당 알림이 수신되는지 확인합니다.
연동 편집과 관리
연동을 생성한 후 다음과 같이 Project Integrations 페이지에서 연동을 관리할 수 있습니다.- 편집: 연동 이름이나 웹후크 URL, 구독하는 이벤트를 업데이트합니다.
- Disable: 연동을 완전히 제거하지 않고 일시적으로 알림을 비활성화합니다.
- 삭제: 프로젝트에서 연동을 영구적으로 제거합니다.