将 GitLab 服务器与 Bitbucket Cloud 集成 (BASIC SELF)

您可以将 Bitbucket.org 设置为 OAuth 2.0 provider，使用您的 Bitbucket.org 账户凭据登录极狐GitLab。您还可以从 Bitbucket.org 导入您的项目。

要将 Bitbucket.org 用作 OmniAuth provider，请遵循 Bitbucket OmniAuth provider 部分。
要从 Bitbucket 导入项目，请遵循 Bitbucket OmniAuth provider 和 Bitbucket 项目导入部分。

Bitbucket OmniAuth provider

要启用 Bitbucket OmniAuth provider，您必须向 Bitbucket.org 注册您的应用程序。Bitbucket 会生成一个应用程序 ID 和密钥供您使用。

为了帮助防止 OAuth 2 隐蔽重定向漏洞，其中用户的极狐GitLab 账户可能会受到损害，请将 /users/auth 附加到 Bitbucket 授权回调 URL 的结尾。

登录 Bitbucket.org。
导航到您的个人用户设置（Bitbucket settings）或团队设置（Manage team），具体取决于您希望应用程序的注册方式。申请注册为个人还是团队均可。
在 Access Management 下的左侧菜单中，选择 OAuth。
选择 Add consumer。
提供所需的详细信息：
- Name：可以是任何名称。考虑类似 <Organization>'s GitLab 或 <Your Name>'s GitLab 或其它描述性信息。
- Application description：可选。
- Callback URL：极狐GitLab 安装的 URL，例如 https://gitlab.example.com/users/auth。将此字段留空导致出现 Invalid redirect_uri 消息。
- URL：极狐GitLab 安装的 URL，例如 https://gitlab.example.com。

至少授予以下权限：

Account: Email, Read
Projects: Read
Repositories: Read
Pull Requests: Read
Issues: Read
Wiki: Read and Write

选择 Save。
选择您新创建的 OAuth 使用者，您现在应该在 OAuth 使用者列表中看到一个 Key 和 Secret。在继续配置时保持此页面打开。

在 GitLab 服务器上，打开配置文件：

# For Omnibus packages
sudo editor /etc/gitlab/gitlab.rb

# For installations from source
sudo -u git -H editor /home/git/gitlab/config/gitlab.yml

添加 Bitbucket provider 配置：

对于 Omnibus 安装实例：

gitlab_rails['omniauth_providers'] = [
  {
    name: "bitbucket",
    # label: "Provider name", # optional label for login button, defaults to "Bitbucket"
    app_id: "BITBUCKET_APP_KEY",
    app_secret: "BITBUCKET_APP_SECRET",
    url: "https://bitbucket.org/"
  }
]

对于源安装实例：

omniauth:
  enabled: true
  providers:
    - { name: 'bitbucket',
        # label: 'Provider name', # optional label for login button, defaults to "Bitbucket"
        app_id: 'BITBUCKET_APP_KEY',
        app_secret: 'BITBUCKET_APP_SECRET',
        url: 'https://bitbucket.org/' }

其中 BITBUCKET_APP_KEY 是密钥，BITBUCKET_APP_SECRET 是来自 Bitbucket 应用程序页面的 Secret。

保存配置文件。
要使更改生效，如果您使用 Omnibus GitLab 安装，请重新配置 GitLab；如果您是从源代码安装的，请重新启动。

现在，在登录页面上，常规登录表单下方应该有一个 Bitbucket 图标。单击该图标开始身份验证过程。Bitbucket 要求用户登录并授权极狐GitLab 应用程序。如果成功，用户将返回到极狐GitLab 并登录。

Bitbucket 项目导入

上述配置设置完成后，您可以使用 Bitbucket 登录极狐GitLab 并开始导入您的项目。

如果您想从 Bitbucket 导入项目，但不想启用登录，您可以在管理面板中禁用登录。