Unity 통합

Unity 통합을 이용하면 개발 워크플로에서 다음 Unity 서비스를 Unity가 아닌 툴에 연결할 수 있습니다.

• 클라우드 빌드
• 클라우드 다이어그노스틱
• 콜라보레이트

통합을 추가하려면 프로젝트의 소유자 또는 관리자여야 합니다. 역할 할당에 관한 내용은 조직 관리의 구성원 및 그룹 섹션을 참조하십시오.

Unity 통합은 다음과 같은 비 Unity 툴을 지원합니다.

• 웹훅: Unity가 외부 서비스에 POST 요청을 보낼 수 있도록 해주는 사용자 정의 콜백입니다.
• Discord: Discord 정의 웹훅을 통해 팀의 Discord 채널에 알림을 전송합니다.
• Slack: Slack 정의 웹훅을 통해 팀의 Slack 채널에 알림을 전송합니다.
• JIRA: JIRA 정의 웹훅을 사용하여 JIRA 티켓을 생성하거나 업데이트합니다.

통합 개수

Unity Personal은 사용자를 모든 이벤트에 대해 하나의 통합으로 제한하지만, 여러 개의 Unity 서비스는 해당 통합을 사용할 수 있습니다. Unity 팀즈, Plus, 및 Pro 사용자는 최대 100개의 통합을 보유할 수 있습니다. Unity 팀즈, Pro 또는 Plus 구독이 완료되면 Unity는 현재의 모든 통합을 보존하지만 자동으로 비활성화합니다. 이 경우 Unity 서비스 대시보드에 계속 로그인하여 하나의 통합을 활성화할 수 있습니다.

통합 추가

워크플로에 통합을 추가하는 방법은 다음과 같습니다.

1. Unity 서비스 대시보드에 로그인합니다.
2. 통합을 추가할 프로젝트를 선택합니다.
3. 왼쪽 탐색 표시줄에서 Settings 를 클릭한 후 Integrations 를 클릭합니다.
4. 새 통합(NEW INTEGRATION) 버튼을 클릭합니다.
5. 새 통합(New Integration) 다이얼로그에서 다음을 수행합니다.
   1. 통합할 프로그램을 선택하고 NEXT 버튼을 클릭하여 통합을 설정합니다.
   2. 통합에 필요한 액션을 트리거하는 이벤트를 선택하고 NEXT 버튼을 클릭합니다.

웹훅 또는 JIRA 통합을 선택하면 옵션 설정(Configure options) 단계가 열립니다. 그렇지 않으면 선택한 툴에 대한 설정 화면이 열립니다.

웹훅 통합

웹훅 통합을 설정하려면 다음 정보를 제공해야 합니다.

Discord 통합

Discord 통합을 설정하기 위해 Unity는 Discord API를 사용하는 앱을 호출하여 웹훅을 Discord 채널에 등록합니다. Discord 서버가 없는 경우 Discord 문서에서 서버 생성 방법을 참조하십시오.

중요: 통합하려는 계정에서 웹훅을 활성화해야 합니다.

설정을 완료하는 방법은 다음과 같습니다.

1. Discord 계정에 로그인합니다.
2. Select a server 드롭다운 메뉴에서 Discord 서버를 선택합니다.
3. Select a channel 메뉴에서 알림을 게시할 채널을 선택합니다.
4. 권한 부여(Authorize) 버튼을 클릭합니다.

Slack 통합

Slack 통합을 설정하기 위해 Unity는 Slack API를 사용하는 앱을 호출하여 웹훅을 Slack 채널에 등록합니다. Slack 서버가 없는 경우 Slack 문서에서 Slack 작업 공간 생성을 참조하십시오.

설정을 완료하는 방법은 다음과 같습니다.

1. Slack 계정에 로그인합니다.
2. 앱의 오른쪽에서 Slack 작업 공간을 선택합니다.
3. 게시 위치(Post to) 드롭다운 메뉴에서 알림을 게시할 Slack 채널을 선택합니다.
4. 권한 부여(Authorize) 버튼을 클릭합니다.

JIRA 통합

Unity JIRA 통합을 이용하면 다음과 같이 JIRA와 상호작용할 수 있습니다.

• 클라우드 다이어그노스틱: 보고를 받으면 새로운 문제를 생성합니다. Unity는 unity-user-report, unity-crash-report, unity-exception-report 중 하나의 레이블로 문제를 생성합니다. 이러한 통합이 동작하려면 문제를 만들고 레이블 열을 수정할 수 있는 권한이 있어야 합니다.
• 콜라보레이트: 콜라보레이트에서 변경 사항을 퍼블리시할 때 기존 문제에 코멘트를 추가합니다.

콜라보레이트 또는 클라우드 다이어그노스틱을 위한 JIRA 통합을 설정하려면 다음 정보를 제공해야 합니다.

JIRA 인스턴스에 대한 정보를 입력한 후 클라우드 다이어그노스틱을 위해 다음의 추가 정보를 제공해야 합니다.

콜라보레이트에서 변경할 때 적용 메시지에서 해당 문제 키를 참조하여 JIRA와 연결된 문제를 업데이트할 수 있습니다. 예를 들어 “ISS–42가 일으킨 크래시를 해결했습니다”는 문제 “ISS–42”에 퍼블리시 상세 정보를 추가합니다.

통합 편집

기존 통합을 편집하는 방법은 다음과 같습니다.

1. Unity 서비스 대시보드에 로그인합니다.
2. 통합을 편집할 프로젝트를 선택합니다.
3. 왼쪽 내비게이션 열에서 Settings 를 클릭한 후 Integrations 를 클릭합니다.
4. 통합 옆에 있는 편집(EDIT) 을 클릭하여 수정합니다.

가능한 편집 타입은 통합에 따라 다릅니다. Slack 및 Discord 통합의 경우에는 표시 이름을 업데이트하거나 통합을 삭제할 수 있습니다.

웹훅 및 JIRA 통합의 경우에는 생성 시 제공한 모든 설정 파라미터를 수정할 수 있습니다.

통합 활성화 또는 비활성화

대시보드에서 통합을 활성화 또는 비활성화하려면

1. Unity 서비스 대시보드에 로그인합니다.
2. 통합을 편집할 프로젝트를 선택합니다.
3. 왼쪽 내비게이션 열에서 Settings 를 클릭한 후 Integrations 를 클릭합니다.
4. Status 열에 있는 토글을 클릭하여 통합을 빠르게 활성화 또는 비활성화합니다.