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를 누르십시오. 그러면 저장된 키가 즉시 삭제됩니다. 이를 사용하던 모든 항목은 다음 작업 시 중지되며, 조용히 실패하는 대신 이에 의존하던 화면에 해당 상태가 표시됩니다.

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