Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
李少辉-开发者
gitlab-foss
提交
89cc2064
G
gitlab-foss
项目概览
李少辉-开发者
/
gitlab-foss
通知
15
Star
0
Fork
0
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
G
gitlab-foss
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
体验新版 GitCode,发现更多精彩内容 >>
提交
89cc2064
编写于
12月 08, 2016
作者:
V
Valery Sizov
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
Update documentation for BitBucket
上级
00cd8642
变更
2
显示空白变更内容
内联
并排
Showing
2 changed file
with
7 addition
and
92 deletion
+7
-92
doc/integration/bitbucket.md
doc/integration/bitbucket.md
+7
-92
doc/integration/img/bitbucket_oauth_settings_page.png
doc/integration/img/bitbucket_oauth_settings_page.png
+0
-0
未找到文件。
doc/integration/bitbucket.md
浏览文件 @
89cc2064
...
...
@@ -44,14 +44,12 @@ you to use.
And grant at least the following permissions:
```
Account: Email
Repositories: Read, Admin
Account: Email, Read
Repositories: Read
Pull Requests: Read
Issues: Read
```
>**Note:**
It may seem a little odd to giving GitLab admin permissions to repositories,
but this is needed in order for GitLab to be able to clone the repositories.
![Bitbucket OAuth settings page](img/bitbucket_oauth_settings_page.png)
1.
Select
**Save**
.
...
...
@@ -93,7 +91,8 @@ you to use.
```yaml
- { name: 'bitbucket',
app_id: 'BITBUCKET_APP_KEY',
app_secret: 'BITBUCKET_APP_SECRET' }
app_secret: 'BITBUCKET_APP_SECRET',
url: 'https://bitbucket.org/' }
```
---
...
...
@@ -112,91 +111,7 @@ well, the user will be returned to GitLab and will be signed in.
## Bitbucket project import
To allow projects to be imported directly into GitLab, Bitbucket requires two
extra setup steps compared to
[
GitHub
](
github.md
)
and
[
GitLab.com
](
gitlab.md
)
.
Bitbucket doesn't allow OAuth applications to clone repositories over HTTPS, and
instead requires GitLab to use SSH and identify itself using your GitLab
server's SSH key.
To be able to access repositories on Bitbucket, GitLab will automatically
register your public key with Bitbucket as a deploy key for the repositories to
be imported. Your public key needs to be at
`~/.ssh/bitbucket_rsa`
which
translates to
`/var/opt/gitlab/.ssh/bitbucket_rsa`
for Omnibus packages and to
`/home/git/.ssh/bitbucket_rsa`
for installations from source.
---
Below are the steps that will allow GitLab to be able to import your projects
from Bitbucket.
1.
Make sure you
[
have enabled the Bitbucket OAuth support
](
#bitbucket-omniauth-provider
)
.
1.
Create a new SSH key with an
**empty passphrase**
:
```sh
sudo -u git -H ssh-keygen
```
When asked to 'Enter file in which to save the key' enter:
`/var/opt/gitlab/.ssh/bitbucket_rsa` for Omnibus packages or
`/home/git/.ssh/bitbucket_rsa` for installations from source. The name is
important so make sure to get it right.
> **Warning:**
This key must NOT be associated with ANY existing Bitbucket accounts. If it
is, the import will fail with an `Access denied! Please verify you can add
deploy keys to this repository.` error.
1.
Next, you need to to configure the SSH client to use your new key. Open the
SSH configuration file of the
`git`
user:
```
# For Omnibus packages
sudo editor /var/opt/gitlab/.ssh/config
# For installations from source
sudo editor /home/git/.ssh/config
```
1.
Add a host configuration for
`bitbucket.org`
:
```sh
Host bitbucket.org
IdentityFile ~/.ssh/bitbucket_rsa
User git
```
1.
Save the file and exit.
1.
Manually connect to
`bitbucket.org`
over SSH, while logged in as the
`git`
user that GitLab will use:
```sh
sudo -u git -H ssh bitbucket.org
```
That step is performed because GitLab needs to connect to Bitbucket over SSH,
in order to add `bitbucket.org` to your GitLab server's known SSH hosts.
1.
Verify the RSA key fingerprint you'll see in the response matches the one
in the
[
Bitbucket documentation
][
bitbucket-docs
]
(the specific IP address
doesn't matter):
```sh
The authenticity of host 'bitbucket.org (104.192.143.1)' can't be established.
RSA key fingerprint is SHA256:zzXQOXSRBEiUtuE8AikJYKwbHaxvSc0ojez9YXaGp1A.
Are you sure you want to continue connecting (yes/no)?
```
1.
If the fingerprint matches, type
`yes`
to continue connecting and have
`bitbucket.org`
be added to your known SSH hosts. After confirming you should
see a permission denied message. If you see an authentication successful
message you have done something wrong. The key you are using has already been
added to a Bitbucket account and will cause the import script to fail. Ensure
the key you are using CANNOT authenticate with Bitbucket.
1.
Restart GitLab to allow it to find the new public key.
Your GitLab server is now able to connect to Bitbucket over SSH. You should be
able to see the "Import projects from Bitbucket" option on the New Project page
You should be able to see the "Import projects from Bitbucket" option on the New Project page
enabled.
## Acknowledgements
...
...
doc/integration/img/bitbucket_oauth_settings_page.png
查看替换文件 @
00cd8642
浏览文件 @
89cc2064
29.4 KB
|
W:
|
H:
29.6 KB
|
W:
|
H:
2-up
Swipe
Onion skin
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录