저장소에서 사이트를 배포할 수 있도록 GitLab 계정을 연결하세요

연결 시 제공되는 기능

GitLab을 연결하면 사이트가 사용자의 GitLab 저장소 중 하나에서 배포될 수 있으며, 사이트의 호스트로 선택한 계정의 GitLab Pages로 게시할 수 있습니다.

시작하기 전에

배포하려는 프로젝트에 대한 접근 권한이 있는 GitLab 계정.

1. GitLab에서 키 생성하기

GitLab에서 우측 상단의 아바타를 선택한 다음, Edit profile → Access → Personal access tokens로 이동하여 새 토큰을 생성하십시오(GitLab의 Generate token 메뉴에서 이를 Legacy token으로 표시할 수 있습니다). 이름을 지정하고, 만료일을 설정한 후, 다음 범위를 선택하십시오:

• api
• write_repository

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

2. 여기서 연결하기

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

저장하기 전에 붙여넣은 내용을 테스트합니다. 작동하지 않는 키는 절대로 저장되지 않으며, 응답을 통해 문제점을 안내합니다. 정상 작동하는 키는 당사 데이터베이스가 아닌 비밀 금고에 암호화되어 보관되며, 사용자 본인에게도 다시 표시되지 않습니다.

다음 단계

• 사이트는 이 계정의 저장소에서 직접 배포될 수 있습니다. 사이트의 저장소 연결에서 해당 계정을 선택하고, 저장소와 브랜치를 지정하면 푸시할 때 배포됩니다.
• 다른 모든 브랜치에는 개별 미리보기가 제공되므로, 실제 운영 사이트에 반영되기 전에 변경 사항을 확인할 수 있습니다.
• Render 및 Azure Static Web Apps와 같은 Git 기반 정적 호스트는 이 연결을 사이트 코드의 소스로 사용합니다.

연결되지 않는 경우

작동하다가 중단되었습니다. GitLab 토큰은 항상 만료되며(일반적으로 생성 후 최대 1년), 만료되기 전에 GitLab에서 이메일을 보냅니다. 새 토큰을 생성하여 연결하십시오.

범위가 누락되었습니다. 토큰의 범위는 생성된 후에는 변경할 수 없습니다. 두 범위가 모두 선택된 새 토큰을 생성하십시오.

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

연결은 되지만 이후에 문제가 발생합니다. 키 인증은 되었으나 해당 작업에 필요한 권한이 없습니다. 위에 나열된 권한이 포함된 새 키를 생성한 다음, 기존 연결을 해제하고 새 키를 연결하십시오.

연결 해제

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

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