리포지토리에서 사이트를 배포할 수 있도록 토큰을 사용하여 GitHub 계정을 연결하세요

연결 시 제공되는 기능

토큰으로 GitHub을 연결하면 저장소 중 하나에서 사이트를 배포할 수 있습니다. 브랜치에 푸시하면 사이트가 업데이트됩니다. 또한 사이트 호스트로 해당 옵션을 선택한 경우 계정의 GitHub Pages로 게시할 수 있습니다.

저장소가 조직에 속해 있다면 대신 Zinn® GitHub 앱을 사용하는 것이 좋습니다. Zinn® GitHub 앱 설치를 참조하십시오. 토큰은 한 개인에게 속하므로 해당 사용자가 탈퇴하면 작동이 중지됩니다.

시작하기 전에

배포하려는 저장소에 접근할 수 있는 GitHub 계정이 필요합니다. 저장소가 조직에 속해 있는 경우, 소유자가 해당 조직에 대해 세분화된 토큰(fine-grained tokens)을 승인해야 할 수 있습니다.

1. GitHub에서 키 생성하기

GitHub에서 프로필 사진을 클릭한 다음 Settings → Developer settings → Personal access tokens → Fine-grained tokens → Generate new token을 클릭하십시오. 이름을 지정하고 유효 기간을 선택하십시오. Repository access에서 Only select repositories를 선택하고 배포할 저장소를 지정하십시오. 작동 가능한 가장 좁은 범위의 접근 권한을 선택하는 것이 좋습니다.

Repository permissions에서 다음 항목에 대해 Read and write 권한을 부여하십시오.

• Contents
• Pages
• Administration

Generate token을 누르고 복사하십시오. GitHub에서는 이 토큰을 한 번만 표시합니다.

2. 여기에서 연결하기

대시보드에서 Integrations를 열고 Connect an account를 선택하십시오. 그룹으로 Code hosting을, 계정으로 GitHub을 선택한 다음 API token을 입력하고 Connect account를 누르십시오.

저장하기 전에 붙여넣은 내용을 테스트합니다. 작동하지 않는 키는 절대로 저장되지 않으며, 문제 원인을 안내해 드립니다. 정상 작동하는 키는 데이터베이스가 아닌 당사의 비밀 금고(secrets vault)에 암호화되어 보관되며, 본인을 포함해 누구에게도 다시 표시되지 않습니다.

다음 단계 안내

• 사이트의 저장소 연결에서 이 계정의 저장소를 선택하고 저장소와 브랜치를 지정하면, 푸시할 때마다 배포가 이루어져 사이트를 즉시 배포할 수 있습니다.
• 다른 모든 브랜치는 자체 미리보기를 생성할 수 있으므로, 변경 사항이 라이브 사이트에 반영되기 전에 확인할 수 있습니다.
• Render 및 Azure Static Web Apps와 같은 Git 기반 정적 호스트는 이 연결을 사이트 코드의 소스로 사용합니다.

연결되지 않는 경우

저장소가 표시되지 않습니다. 토큰의 저장소 접근 권한에 해당 저장소가 포함되어 있지 않습니다. GitHub에서 토큰을 수정하고 저장소를 추가하십시오.

작동하다가 중지되었습니다. 세분화된 토큰은 선택한 날짜에 만료됩니다. 새 토큰을 생성하여 연결하십시오. GitHub은 토큰이 만료되기 전에 이메일을 보냅니다.

키가 거부되었다고 표시됩니다. 대부분 다음 세 가지 중 하나에 해당합니다. 공백이나 줄 바꿈이 함께 복사되었거나, 키가 만료되었거나, 복사한 후 키가 취소 또는 재생성된 경우입니다. 새 키를 생성하여 다시 붙여넣으십시오.

연결은 되지만 이후 작업이 실패합니다. 키 인증은 되었으나 해당 작업에 필요한 권한이 없습니다. 위에 나열된 권한으로 새 키를 생성한 후 이전 연결을 해제하고 새 키를 연결하십시오.

연결 해제

Integrations를 열고 해당 계정을 찾은 다음 Disconnect를 누르십시오. 그러면 저장된 키가 즉시 삭제됩니다. 해당 키를 사용하던 모든 작업은 다음 작업 실행 시 중지되며, 이에 의존하던 화면에는 알림 없이 실패하는 대신 해당 내용이 표시됩니다.

연결을 해제해도 이미 완료된 작업은 취소되지 않으며 귀하의 계정에서 변경된 기록, 배포 또는 설정은 그대로 유지됩니다. 키 자체가 유출되었다고 생각되면 공급업체 측에서도 키를 취소하십시오. 연결 해제는 당사의 사본만 삭제하며 공급업체의 사본은 삭제하지 않습니다.