Bitbucket Cloud에 연결

이 페이지에서는 Bitbucket Cloud에 연결을 만들고 Bitbucket Cloud 저장소에 링크를 만드는 방법을 설명합니다. 콘솔 또는 Google Cloud CLI를 사용하여 이러한 작업을 완료할 수 있습니다. Google Cloud

이 안내는 Google과 함께 Bitbucket Cloud 소스 코드 저장소를 사용하려는 애플리케이션 개발자, 플랫폼 관리자, 보안 관리자를 대상으로 합니다. 특히 Gemini Code Assist와 함께 Bitbucket Cloud 저장소를 사용할 수 있습니다.

Developer Connect에 대한 자세한 내용은 Developer Connect 개요를 참조하세요.

시작하기 전에

로그인하여 Google 계정을 사용하세요.

아직 계정이 없으면 새 계정을 등록하세요.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Developer Connect API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Developer Connect API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

Developer Connect를 사용 설정하면 Secret Manager API도 사용 설정됩니다.

1. Bitbucket Cloud의 계정에 액세스할 수 있는지 확인합니다.

   팀의 작업을 안전하게 유지하려면 개인 계정이 아닌 봇 계정 또는 팀에서 공유하는 계정을 사용하여 이 가이드의 작업을 완료하는 것이 좋습니다.

2. Bitbucket Cloud 저장소를 소유하고 있거나 공유 저장소에 관리자 수준 권한이 있는지 확인합니다.
3. (선택사항) Developer Connect에서 만드는 인증 보안 비밀을 암호화하기 위한 고객 관리 암호화 키(CMEK)를 만듭니다.
4. (선택사항) 이 가이드의 명령줄 안내를 사용하려면 다음 단계를 완료하세요.
   1. Google Cloud CLI 설치 이전에 gcloud CLI를 설치한 경우 사용 가능한 최신 버전을 사용하고 있는지 확인합니다. gcloud components update
   2. 다음 명령어를 실행하여 Developer Connect 서비스 계정 을 만듭니다. 여기서 PROJECT_ID는 Google Cloud 프로젝트 ID입니다.

              gcloud beta services identity create \
                  --service=developerconnect.googleapis.com \
                  --project=PROJECT_ID
              

필요한 역할

연결 및 링크를 만드는 데 필요한 권한을 얻으려면 관리자에게 다음 IAM 역할을 부여해 달라고 요청하세요.

• 프로젝트 소유자가 아닌 경우: Developer Connect 관리자 (roles/developerconnect.admin) 사용자 계정에 대한.
• CMEK를 사용하여 Developer Connect에서 만드는 보안 비밀을 암호화하려는 경우: Cloud KMS CryptoKey 암호화/복호화 (roles/cloudkms.cryptoKeyEncrypterDecrypter) Secret Manager 서비스 계정에.
• gcloud CLI를 사용하여 이 가이드의 단계를 완료하려는 경우: Secret Manager 관리자 역할 (roles/secretmanager.admin) Developer Connect 서비스 계정에 대한.
• 콘솔을 사용하여 이 가이드의 단계를 완료하려는 경우: 프로젝트 IAM 관리자 (roles/resourcemanager.projectIamAdmin) 사용자 계정에 대한. Google Cloud

역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.

참고: 프로젝트 IAM 관리자 (roles/resourcemanager.projectIamAdmin) 역할이 있는 경우 콘솔에서 Google Cloud 사용자를 대신하여 필요한 권한을 자동으로 부여할 수 있습니다. 관리자가 프로젝트 IAM 관리자 역할을 허용하지 않는 경우 관리자에게 Developer Connect 서비스 계정 (service-{projectNumber}@gcp-sa-devconnect.iam.gserviceaccount.com)에 대한 Secret Manager 관리자(roles/secretmanager.admin)를 부여해 달라고 요청하세요.

액세스 토큰 만들기

다음 단계에 따라 Bitbucket Cloud에서 개인 액세스 토큰을 만듭니다.

1. Bitbucket Cloud에 로그인합니다.

2. 다음 단계에 따라 Bitbucket Cloud에서 두 개의 액세스 토큰을 만듭니다. 이것은 저장소 액세스 토큰, 프로젝트 액세스 토큰 또는 작업공간 액세스 토큰일 수 있습니다.

   1. 사용할 액세스 토큰 유형의 안내를 선택합니다.

      • 저장소 액세스 토큰 만들기
      • 프로젝트 액세스 토큰 만들기
      • 작업공간 토큰 만들기

   2. 다음 범위로 첫 번째 토큰을 만듭니다.

      • 저장소: 읽기.
      • pull 요청: 읽기.
      • 웹훅: 읽기 및 쓰기.

      Developer Connect에서는 이를 승인자 액세스 토큰 이라고 합니다.

   3. 다음 범위로 두 번째 토큰을 만듭니다.

      • 저장소: 읽기.

      Developer Connect에서는 이를 읽기 액세스 토큰 이라고 합니다.

   Bitbucket Cloud에서 토큰 수명을 관리할 책임은 사용자에게 있습니다. Bitbucket Cloud 토큰은 만료되지 않으며 사용자가 취소할 때까지 유효합니다.

   일부 Bitbucket 토큰 유형은 유료 요금제에서만 사용할 수 있는 프리미엄 기능입니다. 자세한 내용은 Bitbucket Cloud 토큰을 참조하세요.

3. 다음 절차에서 사용할 액세스 토큰을 복사합니다.

연결 만들기

이 섹션에서는 Developer Connect와 Bitbucket Cloud 간의 연결을 만드는 방법을 설명합니다. 콘솔을 사용하는 경우 연결 설정을 완료하면서 저장소에 링크 추가를 시작할 수도 있습니다. Google Cloud

새 Bitbucket Cloud 연결을 만들려면 다음 옵션 중 하나를 선택합니다.

콘솔

다음 단계를 완료하여 연결을 시작합니다.

1. 콘솔에서 Developer Connect 를 엽니다. Google Cloud

   Developer Connect로 이동

   Developer Connect에 Git 저장소 페이지가 표시됩니다.

   • 소스 코드 관리 제공업체 목록이 표시되는 경우: 소스 코드 관리 제공업체를 선택하여 첫 번째 연결 구성을 시작합니다. Bitbucket Cloud 카드에서 연결 을 클릭합니다.

   • 기존 연결을 나열하는 표가 표시되는 경우: 연결 만들기 > Bitbucket Cloud 를 클릭하여 소스 코드 관리 제공업체를 설정합니다.

     연결 만들기 페이지가 열립니다.

2. 리전에서 연결 리소스의 리전 을 선택합니다.

   1. 이름에 새 연결의 이름을 입력합니다.

3. 작업공간에 Bitbucket Cloud 작업공간 ID를 입력합니다.

4. 액세스 토큰 섹션에서 Bitbucket Cloud 액세스 토큰을 입력합니다.

   • 승인자 액세스 토큰: 승인자 액세스 토큰을 입력합니다.
   • 읽기 액세스 토큰: 읽기 액세스 토큰을 입력합니다.

5. 더보기 를 클릭하여 선택적 구성 설정을 확인합니다.

   1. (선택사항) 암호화 섹션에서 CMEK 키를 선택하여 Developer Connect 에서 만드는 Secret Manager 보안 비밀을 암호화합니다.

   2. (선택사항) 기본적으로 Developer Connect는 Bitbucket Cloud에 대한 Git 호출의 프록시 역할을 할 수 있습니다. 이 옵션을 사용 중지하려면 Developer Connect 프록시 사용 설정 체크박스를 선택 취소합니다.

6. 연결 구성을 완료하려면 계속 버튼을 클릭합니다.

   Developer Connect에서 연결을 만듭니다. 이 프로세스는 몇 초 정도 걸릴 수 있습니다.

연결이 생성되면 저장소 연결 페이지가 표시됩니다.

다음 단계에 따라 저장소를 연결에 연결합니다.

1. 사용 가능한 저장소 목록에서 사용할 저장소를 선택합니다.

2. 확인 을 클릭합니다.

3. 링크 를 클릭합니다.

연결이 연결 페이지에 추가되고 저장소 링크가 콘솔의 저장소 페이지에 추가됩니다. Google Cloud 언제든지 기존 연결에 링크를 더 추가할 수 있습니다.

Gemini Code Assist를 설정하는 경우 Gemini Code Assist 코드 맞춤설정 구성 및 사용의 단계에 따라 프로세스를 계속 진행합니다.

gcloud

1. 다음 명령어를 실행하여 Secret Manager에 웹훅 보안 비밀을 만듭니다. 여기서 WEBHOOK_SECRET_NAME은 웹훅 보안 비밀의 이름입니다.

   cat /proc/sys/kernel/random/uuid | tr -d '\n' | gcloud secrets create WEBHOOK_SECRET_NAME
   

2. 다음 명령어를 실행하여 Secret Manager에 개인 액세스 토큰을 저장합니다.

   gcloud secrets create AUTHORIZER_SECRET_NAME
   
   echo -n AUTHORIZER_SECRET_DATA | gcloud secrets versions add AUTHORIZER_SECRET_NAME --data-file=-
   
   gcloud secrets create READ_SECRET_NAME
   
   echo -n READ_SECRET_DATA | gcloud secrets versions add READ_SECRET_NAME --data-file=-
   

   다음을 바꿉니다.

   • AUTHORIZER_SECRET_NAME: Secret Manager에서 승인자 액세스 토큰을 저장하는 보안 비밀의 이름입니다.
   • AUTHORIZER_SECRET_DATA: 승인자 액세스 토큰입니다.
   • READ_SECRET_NAME: Secret Manager에서 읽기 액세스 토큰을 저장하는 보안 비밀의 이름입니다.
   • READ_SECRET_DATA: 읽기 액세스 토큰입니다.

3. gcloud developer-connect connections create 명령어를 실행하여 Bitbucket Cloud에 연결합니다.

   gcloud developer-connect connections create CONNECTION_NAME \
       --location=REGION \
       --bitbucket-cloud-config-authorizer-credential-user-token-secret-version=projects/PROJECT_ID/secrets/AUTHORIZER_SECRET_NAME/versions/VERSION \
       --bitbucket-cloud-config-read-authorizer-credential-user-token-secret-version=projects/PROJECT_ID/secrets/READ_SECRET_NAME/versions/VERSION \
       --bitbucket-cloud-config-webhook-secret-version=projects/PROJECT_ID/secrets/WEBHOOK_SECRET_NAME/versions/VERSION
       --git-proxy-config-enabled
   

   다음을 바꿉니다.

   • CONNECTION_NAME: 연결의 이름입니다.
   • REGION: 연결에 사용할 리전입니다.
   • PROJECT_ID: 프로젝트 ID입니다. Google Cloud
   • AUTHORIZER_SECRET_NAME: Bitbucket Cloud의 승인자 수준 토큰이 포함된 Secret Manager 보안 비밀의 이름입니다.
   • READ_SECRET_NAME: Bitbucket Cloud의 읽기 전용 토큰이 포함된 Secret Manager 보안 비밀의 이름입니다.
   • WEBHOOK_SECRET_NAME: 웹훅 보안 비밀이 포함된 Secret Manager 보안 비밀의 이름입니다.
   • VERSION: 각 보안 비밀의 버전 번호입니다. 최신 버전 번호를 사용하려면 latest일 수 있습니다.
   • --git-proxy-config-enabled: Developer Connect가 Bitbucket Cloud에 대한 Git 호출의 프록시 역할을 하도록 허용하는 선택적 플래그입니다. 이는 미리보기 버전에 있는 기능입니다.

   Developer Connect에서 Bitbucket Cloud에 대한 연결을 완료합니다. 다음으로 저장소에 연결합니다.

기존 연결을 사용하여 저장소에 연결

Bitbucket Cloud에 연결을 설정한 후 저장소에 연결할 수 있습니다. 나중에 필요에 따라 추가 저장소를 연결하기 위해 이러한 단계를 반복할 수 있습니다.

기존 Bitbucket Cloud 연결에서 저장소 링크를 만들려면 다음 옵션 중 하나를 선택합니다.

콘솔

다음 단계를 완료하여 저장소에 링크를 만듭니다.

1. 콘솔에서 저장소 페이지를 엽니다. Google Cloud

   저장소 페이지 열기

2. 저장소 연결 을 클릭합니다.

   Git 저장소 연결 창이 열립니다.

3. 연결 목록에서 연결을 선택합니다.

4. 계속 을 클릭합니다.

5. 저장소 목록에서 연결할 저장소를 선택합니다.

   Developer Connect에서 저장소 리소스의 추천 이름을 표시합니다.

6. 저장소 리소스 이름 지정 옵션을 선택합니다.

   • 생성됨: 생성된 저장소 리소스 이름을 사용합니다.
   • 수동: 이름을 직접 입력합니다.

7. 만들기 를 클릭합니다.

   Developer Connect에서 저장소 링크를 만들고 콘솔에 Google Cloud 표시합니다.

gcloud

다음 명령어를 실행하여 Bitbucket Cloud 저장소에 링크를 만듭니다.

gcloud developer-connect connections git-repository-links create REPO_NAME \
    --clone-uri=REPO_URI \
    --connection=CONNECTION_NAME \
    --location=REGION

다음을 바꿉니다.

• REPO_NAME: Developer Connect와 Bitbucket Cloud 저장소 간의 새 링크 이름입니다.
• REPO_URI: https:// 프리픽스와 .git 서픽스를 포함한 Bitbucket Cloud의 저장소 URL입니다.
• CONNECTION_NAME: Bitbucket Cloud에 대한 연결 이름입니다.
• REGION: 연결의 리전입니다.

Developer Connect에서 저장소 링크를 만듭니다.

연결된 저장소를 나열하려면 developer-connect connections git-repository-linkslist 명령어를 실행합니다.

Gemini Code Assist를 설정하는 경우 Gemini Code Assist 코드 맞춤설정 구성 및 사용의 단계에 따라 프로세스를 계속 진행합니다.

다음 단계

• Gemini Code Assist 코드 맞춤설정 설정을 완료합니다.
• Gemini Code Assist가 소프트웨어 개발 속도를 높이는 데 어떻게 도움이 되는지 알아봅니다.
• Developer Connect를 통해 사용할 수 있는 다른 통합을 살펴봅니다.