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. 필수 세부 정보를 제공합니다:
    • 이름: 아무 것이나 가능합니다. <조직>의 GitLab 또는 <이름>의 GitLab 또는 다른 설명적인 이름을 고려해보세요.
    • 애플리케이션 설명: 옵션입니다. 원하는 경우 작성하세요.
    • 콜백 URL: (GitLab 8.15 이상 필수) GitLab 설치의 URL(예: https://gitlab.example.com/users/auth)을 입력합니다. 이 필드를 비워 두면 유효하지 않은 redirect_uri 메시지가 표시됩니다.

      caution
      OAuth 2 은밀한 리디렉션 취약점을 방지하기 위해 사용자의 GitLab 계정이 침해될 수 있는 가능성이 있는 경우에는 Bitbucket 인증 콜백 URL 끝에 /users/auth를 덧붙입니다.
    • URL: GitLab 설치의 URL(예: https://gitlab.example.com)을 입력합니다.
  6. 적어도 다음 권한을 부여합니다:

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

    Bitbucket OAuth 설정 페이지

  7. 저장을 선택합니다.
  8. 새로 생성한 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 제공자 구성을 추가합니다:

    Linux 패키지 설치의 경우:

    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>시크릿입니다.

  11. 구성 파일을 저장합니다.
  12. 변경 사항이 적용되려면 Linux 패키지를 사용하여 설치한 경우 GitLab 재구성을, 소스에서 설치한 경우 다시 시작을 해야 합니다.

로그인 페이지에서 일반 로그인 양식 아래에 이제 Bitbucket 아이콘이 표시됩니다. 아이콘을 선택하여 인증 과정을 시작하세요. Bitbucket은 사용자에게 로그인하고 GitLab 애플리케이션을 승인할 것을 요청합니다. 성공하면 사용자는 GitLab에 반환되어 로그인합니다.

Bitbucket 프로젝트 가져오기

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

Bitbucket에서 프로젝트를 가져오고자 하지만 로그인 설정을 활성화하고 싶지 않은 경우 관리 영역에서 로그인 사용 끄기를 선택할 수 있습니다.