코드를 연결하기

Coroid가 작업을 수행하려면 먼저 저장소에 대한 접근 권한이 필요합니다. 조직 단위에서 한 번만 소스 제어 제공자를 연결한 뒤, 개별 저장소를 프로젝트에 연결하면 됩니다.

연결은설정 → 연결 → 소스 제어(/settings/connections/source-control).

지원되는 제공자#

GitHub: 앱 설치 또는 토큰#

GitHub의 경우 Coroid GitHub 앱을 설치하는 것이 더 적합한 옵션입니다. 이 앱은 사용자별가 아닌 저장소별로 접근 권한을 부여하며, 설정한 사람이 퇴사해도 정상적으로 작동하고, 폴링 없이도 Coroid가 웹훅 이벤트를 수신할 수 있습니다.

앱 설치 시 관리자 승인이 필요하지만 해당 권한이 없는 경우에는 개인용 액세스 토큰을 선택하십시오.

앱을 설치하려면설정 → 연결 → 소스 제어로 이동하여GitHub를 선택한 뒤 설치 절차를 따르세요. GitHub는 어떤 저장소에 접근 권한을 부여할지 묻고, 이후에는 GitHub의 설정에서 이를 변경할 수 있습니다.

개인용 액세스 토큰으로 연결하기#

제공자 측에서 토큰을 생성한 뒤설정 → 연결 → 소스 제어.

이 토큰은 저장소 내용을 읽고 브랜치를 생성하며 풀 요청을 만들 수 있어야 합니다. GitHub에서는 이를 위한repo범위가 기존 토큰에 해당하며, GitLab에서는api.

토큰은 저장되기 전에 암호화되며, API에서 반환되거나 저장 후 인터페이스에 다시 표시되지 않습니다. 또한 설정 내보내기 번들에서도 제외되어 번들에는 플레이스홀더만 포함되며, 다른 곳으로 가져올 때 비밀번호를 다시 입력해야 합니다.

저장소를 프로젝트에 연결하기#

연결을 통해 저장소를 이용할 수 있게 되지만, Coroid가 실제로 작업하는 대상은 프로젝트입니다.프로젝트 → 새로 만들기에서 프로젝트를 생성하고 연결된 저장소를 선택하면, Coroid가 코드베이스를 처음으로 분석하여 사용 언어, 빌드 명령어, 테스트 명령어를 파악합니다.

이 첫 번째 분석 결과를 바탕으로 에이전트가 프로젝트를 빌드하고 테스트할 수 있으므로 결과를 꼭 확인하십시오. 프로젝트 설정에서 잘못 추론된 내용은 수정할 수 있습니다.

Coroid가 작업하는 브랜치는 무엇인가요?#

Coroid는 기본 브랜치에서 분기하여 그 브랜치를 대상으로 풀 요청을 생성합니다. 다른 브랜치로 병합해야 하는 경우에는 프로젝트의 저장소 설정에서 기본 브랜치를 변경할 수 있습니다.main.

연결 상태 확인하기#

저장소가 프로젝트 생성 목록에 표시되고 프로젝트의 첫 번째 분석이 완료되면 연결이 정상적으로 작동하는 것입니다. 예상했던 저장소가 누락된 경우 가장 흔한 원인은 다음과 같습니다:

• GitHub 앱이 설치되었지만 해당 특정 저장소에 대한 접근 권한이 부여되지 않은 경우
• 토큰의 범위가 너무 좁아서 비공개 저장소를 나열할 수 없는 경우
• 저장소가 연결한 조직과 다른 조직에 속한 경우

다음#

작업 항목이 어떻게 pull request가 되나요?— 작업 내용을 기술한 뒤에 발생하는 과정입니다.