GitHub 또는 다른 리포지토리를 Autopilot에 연결
GitHub(또는 사용 가능한 경우 GitLab이나 Bitbucket)를 연결하면 Autopilot이 릴리스와 병합된 변경 사항을 추적할 수 있습니다. 액세스 권한은 읽기 전용이며 허용된 리포지토리로 제한되고, 코드 내용은 포함되지 않습니다.
코드 리포지토리를 연결하면 Autopilot이 제품의 릴리스와 병합된 변경 사항을 추적할 수 있으므로, 제품 출시 시 도움말 센터 최신 상태 유지와 같은 작업이 출시 즉시 수정 사항을 계획합니다. 액세스 권한은 읽기 전용이며 허용된 리포지토리만 다루고, 코드 내용은 절대 포함하지 않습니다.
시작하기 전에
- 워크스페이스 소유자 또는 관리자여야 합니다. 다른 사용자는 모든 제어 기능이 비활성화된 연결을 보게 되며, "워크스페이스 소유자 또는 관리자만 연결하거나 변경할 수 있습니다."라는 메시지가 표시됩니다.
- GitHub는 Clevera의 자체 읽기 전용 GitHub 앱을 통해 계정이나 조직에 설치되어 연결됩니다. 조직 소유자의 승인이 필요한 경우, 승인 후 다시 연결하세요.
- GitLab(gitlab.com 전용, 자체 관리형 제외) 및 Bitbucket(Bitbucket Cloud)은 같은 페이지에 나열됩니다. "이 연결은 아직 사용할 수 없습니다."라고 표시되는 경우 현재 연결할 수 없으므로, 대신 GitHub나 변경 로그 페이지를 사용하세요.
리포지토리 연결
연결 열기
Autopilot의 설정 아래에서 연결을 엽니다. 리포지토리 연결에 각 제공업체와 해당 상태가 나열됩니다.

두 개의 허용된 리포지토리가 있는 연결된 GitHub 계정입니다. 연결 클릭
제공업체 옆의 연결을 클릭하고 해당 페이지에서 읽기 전용 액세스를 승인하세요. 연결 페이지로 돌아오면 새 연결이 열립니다.
리포지토리 선택
리포지토리 선택을 클릭하고 검색한 다음, Autopilot이 읽을 수 있도록 각 리포지토리 옆의 허용을 클릭하세요. 완료를 클릭하세요. 하나라도 허용하기 전까지 Autopilot은 아무것도 읽지 않으며, "아직 없음. 리포지토리를 허용할 때까지 Autopilot은 아무것도 읽지 않습니다."라고 표시됩니다.

Autopilot이 읽을 수 있는 리포지토리입니다. 각 리포지토리의 기본 브랜치와 이를 사용하는 일정 수가 표시됩니다. 작업에서 사용
각 릴리스 시 실행되는 작업을 설정하세요: 제품 출시 시 도움말 센터 최신 상태 유지, 제품 변경 시 동영상 업데이트, 새 기능마다 동영상 녹화 또는 사용자 지정 작업. 설정 카드에서 연결, 리포지토리, 그리고 읽어들인 내용(릴리스("게시하는 각 릴리스.") 또는 병합된 변경 사항("병합된 각 풀 리퀘스트."))을 선택하세요. Autopilot 작업 설정을 참조하세요.
아직 허용된 리포지토리가 없으면 설정 카드에 "아직 허용된 리포지토리가 없습니다. 계정을 연결하고 Autopilot이 읽을 수 있는 리포지토리를 선택하세요."라는 메시지와 함께 열린 연결이 표시되며, 계속 진행하면 "먼저 리포지토리를 연결하세요."라고 안내합니다. 카드에서 다른 리포지토리를 허용하려면 더 많은 저장소 허용을 사용하세요.
Autopilot 홈에서 저장소가 연결되면 시작하기 체크리스트의 저장소 연결 항목이 완료 처리됩니다.
연결 후 발생하는 일
- Clevera는 약 1시간마다 감시 중인 각 리포지토리를 확인합니다. Clevera로 푸시되는 내용은 없으며 웹훅도 사용하지 않습니다.
- 새 릴리스(또는 병합된 변경 사항)가 발생하면 작업이 실행됩니다. Clevera는 변경된 내용을 읽고 수정 사항을 계획한 뒤, 작업이 수행되기 전에 사용자의 검토를 기다립니다.
- 릴리스 노트와 풀 리퀘스트 텍스트는 Clevera 외부에서 작성되므로, 이를 읽는 작업은 항상 사용자의 검토를 기다립니다.
- 작업에서 트리거는 "acme-inc/acme-billing의 릴리스" 또는 "…의 병합된 변경 사항"으로 표시됩니다. 목록에서는 "모든 릴리스 후"로 표시됩니다.
Autopilot이 읽어들이는 내용
연결을 엽니다(관리, 또는 연결 전 제공업체의 ⋯ 메뉴에 있는 읽어들인 내용). 데이터 탭에 모든 항목이 나열됩니다.

| 읽어들인 내용 | 선택한 리포지토리의 이름, 기본 브랜치 및 공개 여부(다른 리포지토리는 제외). 릴리스(GitHub, GitLab) 또는 태그(Bitbucket): 이름, 태그 또는 메시지, 날짜 및 릴리스 노트. 병합된 풀 리퀘스트 또는 머지 리퀘스트: 제목, 설명, 병합 날짜 및 링크(GitHub 및 Bitbucket의 경우 변경된 파일 이름 포함). 병합된 변경 사항을 읽을 수 없을 때만 기본 브랜치의 커밋 메시지를 읽습니다. |
| 절대 읽지 않는 내용 | 파일 내용, diff 또는 코드. 이슈, 위키, CI 로그, 보안 정보 또는 설정. 리뷰 댓글. 선택하지 않은 리포지토리. 아무것도 작성되지 않으며 액세스는 읽기 전용입니다. |
| 저장하는 내용 | 액세스 권한이 암호화된 연결 정보, 선택한 리포지토리, 각 예약된 확인이 마지막으로 수행된 위치, 그리고 작업별 변경 사항 요약(제목, 링크, 날짜 및 각 설명의 최대 500자). 요약은 작업과 함께 삭제됩니다. |
"리포지토리의 어떤 내용도 AI 모델을 학습시키는 데 사용되지 않습니다."
| 제공업체 | 요청하는 권한 |
|---|---|
| GitHub | 메타데이터: 읽기. 콘텐츠: 읽기(릴리스 및 커밋 목록 확인용, Clevera는 파일을 열지 않음). 풀 리퀘스트: 읽기. 쓰기 액세스 및 웹훅 없음. |
| GitLab | read_api (읽기 전용 API 액세스). 쓰기 액세스, 리포지토리 다운로드 액세스, 웹훅 없음. |
| Bitbucket | 계정: 읽기. 리포지토리: 읽기. 풀 리퀘스트: 읽기. 쓰기 액세스 및 웹훅 없음. |
Clevera는 읽기 전용 이상의 액세스 권한을 부여하는 연결을 거부합니다.
활동 탭에는 최근 20개의 이벤트가 최신순으로 나열됩니다: 연결, 리포지토리 허용 및 제거, 확인("acme-inc/acme-billing 확인됨: 변경 사항 2개"), 갱신 및 오류. "목록 개수만 읽으며 내용은 절대 읽지 않습니다."
상태
| 상태 | 의미 |
|---|---|
| 연결되지 않음 | 계정을 연결하여 리포지토리를 선택하세요. |
| 연결됨 | Autopilot이 선택한 리포지토리를 읽을 수 있습니다. |
| 주의 필요 | 연결 액세스 권한이 손실되었습니다. 열어서 수정하세요. |
| 액세스 권한이 취소됨 | 제공업체가 연결 수락을 중단했습니다. 다시 연결을 클릭하면 반복 및 일정이 다시 시작됩니다. |
| 잠시 일시 중지됨, 재시도 중 | "제공업체가 속도 제한을 요청했거나 일시적인 오류가 발생했습니다. Autopilot이 자체적으로 재시도하므로 별도의 조치는 필요 없습니다." |
제공업체가 연결 수락을 중단하면 해당 연결을 사용하는 일정이 일시 중지되며, 연결한 사용자에게 이메일과 받은 편지함으로 "GitHub가 귀하의 Autopilot 연결 수락을 중단했습니다"(또는 GitLab, Bitbucket)라는 알림이 열린 연결과 함께 전송됩니다. 반복 페이지에서 해당 작업은 연결 끊김으로 표시됩니다.
동일한 제공업체의 여러 계정을 연결할 수 있습니다. 제공업체의 ⋯ 메뉴 또는 연결 내에서 다른 계정 연결을 사용하세요.
액세스 제거
- 하나의 리포지토리: 옆의 **×**를 클릭하세요("읽기를 중단합니다. 해당 작업을 사용하는 일정이 일시 중지됩니다.").
- 전체 계정: 연결을 열고 연결 해제를 클릭한 다음 "acme-inc 연결을 해제하시겠습니까?"를 확인하세요. Autopilot은 해당 리포지토리 읽기를 중단하고 이를 사용하는 일정을 일시 중지합니다. Clevera는 즉시 액세스 권한을 삭제합니다.
- GitHub: 계정이나 조직에서 Clevera 앱을 제거합니다. GitHub에서도 언제든지 제거할 수 있습니다.
- GitLab: GitLab에서도 액세스 권한이 취소됩니다. GitLab 설정의 애플리케이션에서 취소할 수도 있습니다.
- Bitbucket: Bitbucket 설정의 앱 권한에서 승인을 제거하세요.
나중에 동일한 계정을 다시 연결하면 연결이 복원되고 일시 중지된 작업이 재개될 수 있습니다.
문제 해결
| 표시되는 내용 | 조치 방법 |
|---|---|
| "GitHub 조직 소유자가 Clevera Tasks 앱을 승인해야 합니다. 승인 후 다시 연결하세요." | 조직 소유자에게 GitHub에서 앱을 승인하도록 요청한 후 연결을 다시 클릭하세요. |
| "귀하의 GitHub 계정은 이 설치를 볼 수 없습니다. 조직 소유자에게 연결을 요청하세요." | 설치에 액세스 권한이 있는 사람이 연결해야 합니다. |
| "Clevera Tasks 앱이 이 GitHub 계정에서 일시 중단되었습니다. GitHub에서 일시 중단을 해제한 후 다시 연결하세요." | GitHub 설정에서 앱의 일시 중단을 해제하세요. |
| "GitHub가 사용자 정보를 확인하지 못했습니다. 다시 시도하세요." / "GitLab이 연결을 확인하지 못했습니다. 다시 시도하세요." | 연결을 다시 시작하세요. |
| "… 읽기 전용이 아닌 다른 액세스 권한이 부여되었습니다. 지원팀에 문의하세요." | 지원팀에 문의하세요. Clevera는 읽기 전용 액세스만 허용합니다. |
| "이 계정은 아직 리포지토리를 볼 수 없습니다." | 제공업체 측에서 앱에 리포지토리 액세스 권한을 부여한 후 리포지토리 선택을 다시 여세요. |
| "GitHub가 Clevera의 이 리포지토리 읽기를 허용하지 않았습니다. 연결이 여전히 리포지토리를 볼 수 있는지 확인하세요." | 리포지토리가 앱의 액세스 권한에서 제거되었거나, 이름이 변경되었거나, 삭제되었습니다. 다시 허용하세요. |
| "이 연결은 아직 사용할 수 없습니다." | 해당 제공업체는 아직 연결할 수 없습니다. 다른 제공업체나 변경 로그 페이지를 사용하세요. |