GitHub 저장소에서 사이트가 배포되도록 토큰을 사용하여 GitHub 계정을 연결하세요.

연동 시 제공되는 기능

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

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

시작하기 전에

배포하려는 저장소에 액세스할 수 있는 GitHub 계정이 필요합니다. 저장소가 조직에 속해 있는 경우 소유자가 해당 조직에 대한 세분화된 토큰을 승인해야 할 수 있습니다.

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(API 토큰)을 입력한 후 Connect account(계정 연동)를 누릅니다.

저장되기 전에 입력한 내용을 테스트합니다. 작동하지 않는 키는 절대 저장되지 않으며, 응답에 문제의 원인이 표시됩니다. 작동하는 키는 데이터베이스가 아닌 보안 저장소에 암호화되어 보관되며, 귀하를 포함하여 다시는 표시되지 않습니다.

다음 단계

• 이 계정의 저장소에서 직접 사이트를 배포할 수 있습니다. 사이트의 저장소 연동에서 선택하고, 저장소와 브랜치를 선택한 후 푸시하면 배포됩니다.
• 다른 모든 브랜치에 자체 미리보기를 지정할 수 있으므로 변경 사항이 라이브 사이트에 적용되기 전에 확인할 수 있습니다.
• Render 및 Azure Static Web Apps과(와) 같은 Git 기반 정적 호스트는 이 연동을 사이트 코드의 소스로 사용합니다.

연동되지 않는 경우

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

작동하다가 중단된 경우. 세분화된 토큰은 선택한 날짜에 만료됩니다. 새 토큰을 생성하여 연동하십시오. 토큰이 만료되기 전에 GitHub에서 이메일이 발송됩니다.

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

연동은 되지만 나중에 작업이 실패하는 경우. 키는 인증되지만 작업에 필요한 권한이 부족합니다. 위에 나열된 권한으로 새 키를 생성한 다음, 기존 연동을 해제하고 새 키를 연동하십시오.

연동 해제

Integrations(연동)를 열고 계정을 찾아 Disconnect(연동 해제)를 누릅니다. 그러면 저장된 키가 즉시 삭제됩니다. 이를 사용하던 모든 항목은 다음 작업 시 중지되며, 이에 의존하던 화면은 조용히 실패하는 대신 오류를 알립니다.

연동을 해제해도 이미 수행된 작업(계정에서 변경한 기록, 배포 또는 설정)은 취소되지 않으며 그대로 유지됩니다. 키 자체가 유출되었을 수 있다고 생각되는 경우 공급업체에서도 취소하십시오. 연동을 해제하면 공급업체가 아닌 당사의 복사본만 제거됩니다.