이 문서에서는 Guide 테마와 GitHub 연동의 오류 메시지 및 테마를 추가하거나 업데이트할 때 문제가 발생하는 경우 수행할 문제 해결 단계에 대해 다룹니다.
Guide 관리자만 Guide에서 GitHub 연동 서비스를 관리할 수 있습니다.
테마를 가져오지 못함
-
GitHub 저장소 URL 또는 [사용자 이름]/[저장소]를 올바르게 썼는지 확인하세요. 저장소를 볼 때 주소 창에서 저장소 URL을 복사하여 붙여넣는 것이 좋습니다.
- 특정 브랜치에서 가져오는 경우에는 브랜치 이름을 올바르게 썼는지 확인하세요.
- 저장소에 액세스 권한이 있는지 확인
- Zendesk Guide 앱에 권한이 부여되어 있는지 확인
테마를 업데이트하지 못함
저장소에 액세스 권한이 있는지 확인
https://github.com/settings/repositories로 이동하여 저장소에 액세스 권한이 있는지 확인하세요. 저장소가 보이지 않는다면 액세스가 취소되었거나 저장소가 삭제되었을 수 있습니다. 저장소 관리자에게 문의하여 다음 사항에 대해 확인해 보세요.
-
액세스가 취소되어 저장소 관리자가 다시 액세스 권한을 부여해야 하는지.
-
저장소가 삭제되어 테마를 업데이트할 수 없거나 다른 저장소에 연결할 수 없어서 존재하는 저장소로부터 새 가져오기를 시작해야 하는지.
Zendesk Guide 앱에 권한이 부여되어 있는지 확인
Zendesk Guide 앱에 GitHub의 계정에 대한 권한이 부여되어 있는지 확인하세요. https://github.com/settings/applications로 이동하여 “Authorized OAuth Apps” 탭에서 Zendesk Guide 앱에 해당 계정에 대한 액세스 권한이 있는지 확인하세요.
Authorized OAuth Apps에 Zendesk Guide 앱이 나타나지 않는다면 다음과 같은 이유로 인한 것일 수 있습니다.
-
Zendesk Guide GitHub 앱에 대한 권한 부여가 취소되었거나 다시 권한을 부여해야 합니다. 테마를 다시 업데이트하면 되지만 안 될 경우에는 테마를 새 테마로 추가한 후 업데이트하려던 테마를 업데이트하면 됩니다.
- 저장소를 소유한 GitHub 조직이 Zendesk Guide 앱의 권한 부여를 허용하지 않습니다. 그런 경우에는 GitHub 조직의 관리자에게 연락하여 ‘repo’ 범위에 대한 Zendesk Guide 앱의 권한 부여를 허용하도록 해야 합니다. GitHub가 repo에서 코드에 액세스 권한을 제공하는 유일한 범주이므로 더 적은 범주를 허용하는 옵션은 없습니다.
잘못된 테마 버전 번호
현재 버전 번호와 상충되므로 manifest.json 파일에서 테마 버전 번호가 증가되어야 합니다. 테마 버전 번호를 증가시키거나 테마 개발자에게 부탁하세요.
테마 버전 번호가 허용되지 않음
manifest.json 파일의 테마 버전 번호가 버전 관리 규칙을 준수하지 않습니다. 테마 개발자로 하여금 버전 관리 규칙에 맞게 테마 버전 번호를 수정하도록 하세요.
Internet Explorer를 사용하여 권한 부여할 수 없음
GitHub가 더 이상 지원하지 않으므로 Internet Explorer를 사용하여 인증할 수 없습니다. 하지만 Google Chrome, Firefox 또는 Safari와 같은 GitHub 및 Zendesk에서 지원하는 브라우저를 사용하여 인증할 수 있습니다.
