GitLab 서버를 Bitbucket Cloud와 통합하기

Tier: Free, Premium, Ultimate Offering: Self-managed

Bitbucket.org을 OAuth 2.0 프로바이더로 설정하여 Bitbucket.org 계정 자격 증명을 사용하여 GitLab에 로그인할 수 있습니다. 또한 Bitbucket.org에서 프로젝트를 가져올 수도 있습니다.

Bitbucket을 OAuth 2.0 인증 프로바이더로 사용하기

Bitbucket OmniAuth 프로바이더를 활성화하려면 Bitbucket.org에 응용 프로그램을 등록해야 합니다. Bitbucket은 응용 프로그램 ID 및 비밀 키를 생성하여 사용하도록 합니다.

  1. Bitbucket.org에 로그인합니다.
  2. 개인 사용자 설정(Bitbucket 설정) 또는 팀 설정(팀 관리)으로 이동하여 등록할 응용 프로그램에 따라 선택하세요. 응용 프로그램을 개인 또는 팀으로 등록하느냐에 대해 중요하지 않습니다.
  3. 왼쪽 메뉴에서 액세스 관리 아래에서 OAuth를 선택합니다.
  4. 소비자 추가를 선택합니다.
  5. 필요한 세부 정보를 제공하세요:
    • 이름: 아무것이나 될 수 있습니다. <Organization>의 GitLab 또는 <Your Name>의 GitLab 또는 다른 설명적인 이름을 고려해보세요.
    • 응용 프로그램 설명: 선택 사항입니다. 원하는 경우 작성하세요.
    • 콜백 URL: (GitLab 버전 8.15 및 그 이상에서 필요) GitLab 설치의 URL, 예를 들어 https://gitlab.example.com/users/auth. 이 필드를 비워 두면 잘못된 redirect_uri 메시지가 표시됩니다. WARNING: 사용자의 GitLab 계정이 침해될 수 있는 OAuth 2 속임수 리디렉션 취약점을 방지하기 위해 Bitbucket 인증 콜백 URL 끝에 /users/auth를 추가하세요.

    • URL: GitLab 설치의 URL, 예를 들어 https://gitlab.example.com.
  6. 적어도 다음 권한을 부여하세요:

    계정: 이메일, 읽기
    프로젝트: 읽기
    리포지터리: 읽기
    풀 리퀘스트: 읽기
    이슈: 읽기
    위키: 읽기 및 쓰기
    

    Bitbucket OAuth 설정 페이지

  7. 저장을 선택합니다.
  8. 새로 생성한 OAuth 소비자를 선택하면 이제 OAuth 소비자 디렉터리에 비밀이 표시됩니다. 이 페이지를 계속 유지하면서 구성을 계속합니다.

    Bitbucket OAuth 키

  9. GitLab 서버에서 구성 파일을 엽니다:

    # Omnibus 패키지의 경우
    sudo editor /etc/gitlab/gitlab.rb
       
    # 소스에서 설치한 경우
    sudo -u git -H editor /home/git/gitlab/config/gitlab.yml
    
  10. Bitbucket 프로바이더 구성을 추가하세요: 리눅스 패키지 설치의 경우:
   gitlab_rails['omniauth_providers'] = [
     {
       name: "bitbucket",
       # label: "제공자 이름", # 로그인 버튼의 선택사항 레이블, 기본값은 "Bitbucket"
       app_id: "<bitbucket_app_key>",
       app_secret: "<bitbucket_app_secret>",
       url: "https://bitbucket.org/"
     }
   ]

자체 컴파일된 설치의 경우:

   omniauth:
     enabled: true
     providers:
       - { name: 'bitbucket',
           # label: '제공자 이름', # 로그인 버튼의 선택사항 레이블, 기본값은 "Bitbucket"
           app_id: '<bitbucket_app_key>',
           app_secret: '<bitbucket_app_secret>',
           url: 'https://bitbucket.org/' }

여기서 <bitbucket_app_key>는 Bitbucket 응용 프로그램 페이지의 이고, <bitbucket_app_secret>비밀입니다.

  1. 구성 파일을 저장합니다.
  2. 변경 사항이 적용되려면 리눅스 패키지를 사용하여 설치했다면 GitLab 재구성을, 자체 컴파일 설치인 경우 재시작을 실행하세요.

로그인 페이지에서 일반 로그인 양식 아래에 이제 Bitbucket 아이콘이 표시됩니다. 아이콘을 선택하여 인증 프로세스를 시작합니다. Bitbucket은 사용자에게 로그인하고 GitLab 응용 프로그램을 승인할 것을 요청합니다. 성공하면 사용자는 GitLab로 돌아가 로그인됩니다.

Bitbucket 프로젝트 가져오기

위의 구성이 설정된 후 Bitbucket을 사용하여 GitLab에 로그인하고 프로젝트 가져오기를 시작할 수 있습니다.

Bitbucket에서 프로젝트를 가져오려면 로그인을 활성화하고 싶지만 프로젝트를 가져오고 싶지 않은 경우 관리 영역에서 로그인 활성화/비활성화를 사용할 수 있습니다.