您的位置:

Bitbucket.org使用指南

Bitbucket是一个提供Git和Mercurial存储库的Web服务。本篇文章将从下面几个方面为大家介绍Bitbucket的使用。

一、注册与创建仓库

1、注册

首先,需要在Bitbucket官网上注册账号。注册完成后,可以新建一个仓库。

2、创建仓库

<html>
<head>
    <title>创建仓库</title>
</head>
<body>
    <form method="post" action="https://bitbucket.org/repo/create" enctype="multipart/form-data">
        <label>仓库名称:</label>
        <input type="text" name="name" required>
        <br />
        <label>仓库类型:</label>
        <input type="radio" name="scm" value="git" checked> Git
        <input type="radio" name="scm" value="hg"> Mercurial
        <br />
        <label>是私有仓库:</label>
        <input type="checkbox" name="is_private" value="1">
        <br />
        <label>仓库描述:</label>
        <textarea name="description" rows="5"></textarea>
        <br />
        <input type="submit" value="创建仓库">
    </form>
</body>
</html>

上面的代码就是创建仓库的HTML表单,可以直接复制到自己的项目中使用。

二、仓库管理

1、仓库管理员与贡献者

Bitbucket中,可以向仓库添加多个管理员和贡献者。管理员可以管理仓库的所有操作,包括创建、删除、合并等等。贡献者只能对仓库进行读写操作,无法进行删除、合并等危险操作。

// 添加管理员
git clone https://bitbucket.org/<username>/<repo_slug>.git
cd <repo_slug>
git remote add bitbucket https://bitbucket.org/<username>/<repo_slug>.git
git push -f bitbucket

// 添加贡献者
在Settings -> Users and groups中,添加相应的用户即可。

2、Pull Request

当你需要向某个仓库做出贡献时,可以通过向仓库发送一个Pull Request来实现。Pull Request是指向另一个分支的推送通知,请求让另一个人审查你的代码并将其合并。

// 在本地创建分支
git checkout -b my-branch

// 修改代码

// 将分支推送到Bitbucket
git push bitbucket my-branch

// 在Bitbucket网站上创建一个Pull Request  

三、Webhooks

1、介绍

Webhooks是一种向其它应用提供实时信息的方式。可以将Webhooks设置为在Bitbucket事件发生时发送HTTP POST请求到指定的URL。这样,就可以在事件发生时向自己的服务器发送动态数据,比如Pull Request的状态变化。

2、使用方法

// 创建一个Webhook
curl -X POST -H "Content-Type: application/json" 
     -d '{"url": "http://example.com/webhook-receiver", "description": "My webhook", "active": true}' 
     https://api.bitbucket.org/2.0/repositories/<username>/<repo_slug>/hooks 

// 删除一个Webhook
curl -X DELETE https://api.bitbucket.org/2.0/repositories/<username>/<repo_slug>/hooks/<hook_id>

四、集成

1、JIRA集成

如果你使用JIRA,可以将Bitbucket与JIRA集成,这样可以在JIRA中看到所有的Pull Request,而无需离开JIRA。

2、Hipchat集成

通过在Bitbucket中设置Hipchat集成,可以在Hipchat中收到Pull Request的状态更新通知。

3、Bamboo集成

如果你在使用Bamboo进行持续集成和部署,可以使用Bitbucket的Bamboo集成来构建和部署自己的代码。

以上只是一些常用的集成方法,实际上Bitbucket还支持非常多的同时与其他应用集成的方式。

五、总结

本文从仓库注册、创建、管理,Pull Request、Webhooks、集成等方面讲解了Bitbucket的使用方法。希望本文可以帮助到大家。