GitHub 연동

이 문서에서는 GitHub 연동 기능을 설명합니다. GitHub 리포지토리를 연결하면 선택한 리포지토리의 코드를 자동 또는 수동으로 동기화할 수 있으며, AI가 코드 내용을 참조하면서 질문에 답변하거나 워크플로를 실행할 수 있게 됩니다.

사전 조건

작업	필요한 권한
조직의 GitHub 계정을 연결하거나 해제하기	관리자 / 소유자
이 워크스페이스에서 사용할 GitHub 계정을 선택하거나 변경하기	관리자 / 소유자
승인된 리포지토리를 선택하거나 변경하기	워크스페이스 매니저 / 관리자 / 소유자
동기화 대상 브랜치를 변경하기	워크스페이스 매니저 / 관리자 / 소유자
수동 동기화를 실행하기	워크스페이스 매니저 / 관리자 / 소유자
동기화 설정을 변경하기	워크스페이스 매니저 / 관리자 / 소유자

GitHub 계정 연결은 설정 > 앱 에서 수행합니다. 관리자 또는 소유자가 계정을 연결하고 GitHub에서 리포지토리를 승인하면, 각 워크스페이스는 그 승인된 목록에서 선택할 수 있습니다.

GitHub 리포지토리 연결하기

GitHub 리포지토리 연결 화면

1. 조직에서 아직 GitHub를 연결하지 않았다면, 관리자 또는 소유자에게 설정 > 앱 에서 GitHub 계정을 연결해 달라고 요청하십시오.

2. 워크스페이스 페이지에서 리소스를 선택하십시오.

3. 코드베이스를 선택하십시오.

4. 사용할 수 있는 연결된 계정이 여러 개 있고, 당신이 관리자 또는 소유자인 경우 GitHub 계정에서 사용할 계정을 선택하십시오.

5. 리포지토리 선택을 클릭하십시오.

6. 승인된 목록에서 동기화할 리포지토리를 선택하십시오.

7. 변경사항 저장을 클릭하십시오.

리포지토리 선택·변경하기

관리자 또는 소유자가 워크스페이스의 GitHub 계정을 선택한 뒤에는, 워크스페이스 매니저도 승인된 리포지토리를 추가하거나 변경할 수 있습니다. 리포지토리 선택을 해제하면 그 리포지토리에 해당하는 코드베이스는 자동으로 삭제됩니다.

리포지토리 선택 화면

1. 워크스페이스 페이지에서 리소스를 선택하십시오.

2. 코드베이스를 선택하십시오.

3. 이 워크스페이스에 다른 GitHub 계정이 필요하다면, 먼저 관리자 또는 소유자에게 GitHub 계정을 변경해 달라고 요청하십시오.

4. 선택된 리포지토리 섹션에서 편집을 클릭하십시오.

5. 승인된 목록에서 동기화할 리포지토리를 선택하거나 선택 해제하십시오.

6. 변경사항 저장을 클릭하십시오.

필요한 리포지토리가 목록에 보이지 않으면, 관리자 또는 소유자에게 설정 > Apps 에서 추가해 달라고 요청하십시오.

동기화 대상 브랜치 변경하기

연결된 리포지토리별로 동기화할 브랜치를 변경할 수 있습니다. 지정하지 않은 경우 리포지토리의 기본 브랜치가 동기화됩니다.

브랜치 선택기

1. 워크스페이스 페이지에서 리소스를 선택하십시오.

2. 코드베이스를 선택하십시오.

3. 선택된 리포지토리 섹션에서 대상 리포지토리 행에 표시된 현재 브랜치 이름 버튼을 클릭하십시오.

4. 목록에서 동기화할 브랜치를 선택하십시오. 검색 상자에 브랜치 이름을 입력하여 좁힐 수 있습니다.

수동으로 동기화하기

GitHub 리포지토리의 내용을 수동으로 최신 상태로 갱신합니다.

수동 동기화 버튼

1. 워크스페이스 페이지에서 리소스를 선택하십시오.

2. 코드베이스를 선택하십시오.

3. GitHub 카드의 동기화를 클릭하십시오.

동기화 설정 변경하기

수동 동기화에 더해, 푸시 / 커밋 이벤트에 연동한 동기화나 일정에 따른 정기 동기화를 설정할 수 있습니다.

동기화 설정 대화 상자

1. 워크스페이스 페이지에서 리소스를 선택하십시오.

2. 코드베이스를 선택하십시오.

3. 동기화 설정 섹션의 설정을 클릭하십시오.

4. 동기화 타이밍을 선택하십시오.

   • 수동 동기화: 수동으로 트리거한 경우에만 동기화합니다.

   • 푸시 / 커밋 시 동기화 트리거: 선택한 브랜치에 코드가 푸시되었을 때 자동으로 동기화합니다.

   • 자동 동기화 활성화: 지정한 빈도와 시각으로 정기적으로 동기화합니다. 빈도(매일 / 매주 / 매월)와 시각을 지정하고, 매주인 경우에는 요일, 매월인 경우에는 날짜도 함께 지정합니다.

5. 저장을 클릭하십시오.

GitHub 연결 해제하기

GitHub 연결을 해제하면 조직에 연결된 GitHub 계정이 제거됩니다. 그 계정을 사용하는 모든 워크스페이스는 선택한 리포지토리에 대한 액세스를 잃고, 동기화된 코드베이스도 삭제됩니다. 특정 워크스페이스에서만 사용을 중지하려면 선택된 리포지토리에서 해당 리포지토리를 제거하십시오.

1. 설정 > 앱 를 여십시오.

2. 연결을 해제할 GitHub 계정을 여십시오.

3. 연결 해제를 클릭하십시오.

4. 확인한 후 실행하십시오.

문제 해결

GitHub 연동 오류

상황	원인	해결 방법
워크스페이스에 GitHub가 연결되지 않았다고 표시됨	조직 수준에서 GitHub 계정이 연결되지 않음	관리자 또는 소유자에게 설정 > 앱 에서 GitHub를 연결해 달라고 요청하십시오
코드베이스에 GitHub 액세스가 취소되었습니다 라고 표시됨	GitHub App이 제거되었거나 중지되었거나, 연결된 계정을 더 이상 볼 수 없음	마지막으로 성공한 동기화 내용은 오래된 가능성 라벨과 함께 계속 표시됩니다. 관리자 또는 소유자에게 설정 > 앱 에서 다시 연결해 달라고 요청한 뒤 동기화를 다시 실행하십시오
이 리포지토리에 대한 GitHub 액세스가 취소되었습니다 라고 표시됨	리포지토리가 이름 변경, 이전, 삭제되었거나 GitHub App 또는 승인된 목록에서 제거됨	마지막으로 성공한 동기화 내용은 오래된 가능성 라벨과 함께 계속 읽을 수 있습니다. 관리자 또는 소유자에게 리포지토리를 다시 승인하거나 계정을 점검해 달라고 요청한 뒤, 리포지토리를 다시 선택하고 동기화를 실행하십시오
GitHub 연결에서 인증 오류가 발생함	GitHub 계정 권한이 부족하거나 액세스가 거부됨	GitHub 계정 권한을 확인한 후 다시 연결을 시도하십시오
요청이 GitHub에 도달하지 못했습니다 라고 표시됨	프록시나 방화벽 등의 네트워크 장비가 GitHub API 대신 응답함	액세스가 취소된 것이 아닐 수 있습니다. GitHub API로의 아웃바운드 접근을 확인하고 네트워크 설정을 점검한 뒤 동기화를 다시 실행하십시오
"저장소 동기화에 실패했습니다"라고 표시됨	네트워크 오류 또는 GitHub API의 일시적인 장애	동기화를 다시 클릭하여 수동 동기화를 시도하십시오
동기화가 이미 진행 중이라는 메시지가 표시됨	다른 동기화 처리가 실행 중	현재 동기화가 완료될 때까지 기다린 후 다시 시도하십시오
"GitHub 설치를 불러오는 데 실패했습니다"라고 표시됨	GitHub 연동 정보 가져오기에 실패함	페이지를 새로 고침하십시오. 해소되지 않으면 관리자 또는 소유자에게 설정 > 앱 에서 GitHub를 다시 연결해 달라고 요청하십시오
"코드 아카이브 삭제에 실패했습니다"라고 표시됨	삭제 처리 중에 오류가 발생함	페이지를 새로 고침한 후 다시 시도하십시오
"브랜치를 불러오지 못했습니다"라고 표시됨	리포지토리의 브랜치 목록 가져오기에 실패함	페이지를 새로 고침하십시오. 해소되지 않으면 GitHub를 한 번 연결 해제한 후 다시 연결하십시오
"브랜치 업데이트에 실패했습니다"라고 표시됨	네트워크 오류 또는 서버의 일시적인 장애	잠시 기다린 후 다시 시도하십시오