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

연동 시 제공되는 기능

Bitbucket을 연동하면 사이트가 Bitbucket Cloud 저장소 중 하나에서 배포될 수 있습니다. 브랜치에 푸시하면 사이트가 업데이트됩니다.

시작하기 전에

배포하려는 저장소에 접근할 수 있는 Bitbucket Cloud 계정이 필요합니다.

1. Bitbucket에서 키 생성하기

Bitbucket은 두 가지 자격 증명을 제공하며 둘 다 작동합니다.

• 저장소, 프로젝트 또는 워크스페이스용 액세스 토큰: 해당 저장소, 프로젝트 또는 워크스페이스 자체의 설정에서 Access tokens 항목을 통해 생성합니다. 개인이 아닌 해당 저장소, 프로젝트 또는 워크스페이스에 연결됩니다. 저장소에 대한 읽기 권한을 부여하십시오.
• Atlassian 계정의 API 토큰: 프로필을 선택한 후 Account settings → Security → Create and manage API tokens → Create API token with scopes로 이동하십시오. 이름을 지정하고 만료일을 설정한 다음, 앱으로 Bitbucket을 선택하고 저장소에 대한 읽기 권한을 선택하십시오. Bitbucket에서 토큰은 한 번만 표시되므로 그때 복사하십시오.

2. 여기에서 연동하기

대시보드에서 Integrations를 열고 Connect an account를 선택하십시오. 그룹으로 Code hosting을 선택하고 계정으로 Bitbucket을 선택한 뒤 API token을 입력하십시오. 액세스 토큰 대신 Atlassian 계정에서 토큰을 생성한 경우에는 Account username도 함께 입력하고 Connect account를 누르십시오.

어떤 내용도 저장되기 전에 붙여넣은 항목을 먼저 테스트합니다. 작동하지 않는 키는 절대로 저장되지 않으며, 응답을 통해 무엇이 잘못되었는지 알려줍니다. 작동하는 키는 당사 데이터베이스가 아닌 보안 비밀 금고에 암호화되어 보관되며, 귀하를 포함하여 누구에게도 다시 표시되지 않습니다.

사용자 이름은 토큰 전송 방식을 결정하므로 계정 토큰인 경우에만 입력하십시오. 사용자 이름과 함께 입력된 액세스 토큰이나, 사용자 이름 없이 입력된 계정 토큰은 거부됩니다.

이후 진행 과정

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

연결되지 않는 경우

저장소가 누락되었습니다. 액세스 토큰은 토큰이 생성된 저장소, 프로젝트 또는 워크스페이스에만 접근할 수 있습니다. 필요한 모든 저장소를 포함하는 수준에서 토큰을 생성하십시오.

작동하다가 중단되었습니다. 두 종류의 토큰 모두 만료될 수 있습니다. 새 토큰을 생성하여 연결하십시오.

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

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

연결 해제

Integrations를 열고 해당 계정을 찾은 후 Disconnect를 누르십시오. 그러면 저장된 키가 즉시 삭제됩니다. 해당 키를 사용하던 모든 작업은 다음 실행 시 중지되며, 이에 의존하던 화면에는 오류가 조용히 넘어가지 않고 명시적으로 표시됩니다.

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