Bitbucket で開発環境を改善: 最初の 4 ステップ

まずは Bitbucket にデータを作成するところから始めましょう。

ステップ 1: コードを Bitbucket に保存する

リポジトリ (親しみを込めて現場では「リポ」と呼ばれています) は Bitbucket でコードを保存する場所です。ニーズに合わせていくつかの方法で作業を始められます。

ゼロから始める

新しい空のリポジトリを作成する

  1. 左側にあるグローバル サイドバーで [+] をクリックし、[新規作成] の下で [リポジトリ] を選択します。

  2. リポジトリに名前を付けます。ここが重要なポイントです。リポジトリの名前はそのままリポジトリの URL の一部になります。

  3. [README を含めますか?] オプションを [Yes, with a template (テンプレートと一緒に含める)] に設定します。

  4. 他のオプションは初期設定のままにして [作成] をクリックします。

新しいリポジトリを作成する

別のプロバイダーから

別の Git プロバイダーからリポジトリをインポートする

  1. 左側にあるグローバル サイドバーで [+] をクリックし、[インポート] の下で [リポジトリ] を選択します。

  2. リポジトリにアクセスできる URL を入力します。

  3. リポジトリで認証が必要な場合は、[Requires authorization (認証が必要)] のチェックボックスをオンにしてアクセスに必要な認証情報を入力します。

  4. リポジトリに名前を付けます。ここが重要なポイントです。リポジトリの名前はそのままリポジトリの URL の一部になります。

  5. 他のオプションは初期設定のままにして [Import repository (リポジトリをインポート)] をクリックします。

新しいリポジトリを作成する

ステップ 2: ローカルでセットアップしてグローバルにコラボレーション

Bitbucket リポジトリをクローン

  1. 左側にあるグローバル サイドバーで [+] をクリックし、[Get to work (作業を開始)] の下で [Clone this repository (このリポジトリを複製)] を選択します。

  2. 右上のメニューから [HTTPS] を選択します (SSH キーをまだ設定していない場合)。

  3. clone コマンドをコピーします。

このリポジトリをクローンする

CLI から

  • リポジトリを複製するディレクトリに変更します。cd

  • Bitbucket からコピーした git clone コマンドを貼り付けます (次のようなコマンドです): git clone https://username@bitbucket.org/teamsinspace/documentation-test.git

クローンを作成したリポジトリと同じ名前の新しいサブディレクトリがローカルドライブに表示されます。空のリポジトリのクローンを作成した場合は、そのローカルディレクトリにはまだ何もありません。

オンラインの Bitbucket にあるファイルに変更を加える

まだ Bitbucket 上にファイルがない場合...

Bitbucket リポジトリに README ファイルを追加するオプション ステップを飛ばした場合でも、問題ありません。まだリポジトリが空の場合は、リポジトリに移動して [Create a README (README の作成)] をクリックすれば作成できます。これで、空ではないリポジトリができたので複製を開始できます。

Bitbucket から更新をプルする

CLI から

  1. リポジトリを複製するディレクトリに変更します。cd

  2. Bitbucket からコピーしたコマンドをコマンドラインに貼り付けます (次のようなコマンドです)。git clone

これでファイルの変更がすべてローカルシステムにダウンロードされました。

ステップ 3: Bitbucket で基本的なブランチを作成する

ブランチを作成することで、元のコードベースや他のメンバーの作業に影響を与えずに、各チーム メンバーは同時に別の作業を進められます。変更をマージする準備ができたら、Bitbucket にブランチをプッシュすればプル リクエストでレビューできるようになります。

ブランチ作成にはいくつかの方法があるため、チームのニーズに最適な方法を選択してください。

ブランチの作成

Bitbucket から (最も簡単)

  1. リポジトリからグローバル サイドバーの [+] をクリックし、[Get to work (作業を開始)] の下で [Create a branch (ブランチを作成)] を選択します。

  2. 表示されたポップアップで [タイプ (Type)] (ブランチ作成モデルを使用している場合) を選択し、ブランチ名を入力して [Create (作成)] をクリックします。

ブランチを作成する

CLI から

  1. ブランチを作成したら、git fetch を実行し、ローカル システムからブランチをチェックアウトします。必要なコマンドが自動的に表示されます (次のようなコマンドです)。git fetch && git checkout

  2. ローカルで変更を加えた後、変更をブランチに追加、コミット、プッシュします。

    git add

    git commit -m "フィーチャー ブランチから変更を追加"git push origin

  3. リポジトリのソース ページをクリックします。ドロップダウンに main とブランチの両方が表示されるはずです。

ブランチにフィルターをかける

CLI から

ローカルリポジトリディレクトリの CLI から

  1. git branch コマンドを使用してブランチを作成します。

  2. このリポジトリのブランチをすべてリストします。既定のブランチ main と新しく作成したブランチが表示されます。

  3. ブランチをチェックアウトします。

  4. 新しいブランチを Bitbucket にプッシュします。

今度は Bitbucket に移動してブランチを確認します。

  1. リポジトリに移動します。

  2. [ブランチ] をクリックします。

ブランチにフィルターをかける

Jira から

この操作を行うには Jira Software Cloud へのアクセスが必要です。また、Jira Software Cloud と Bitbucket を統合しておく必要があります。操作には管理者権限が必要ですが、統合の仕組みを確認するだけの場合はいつでも Jira Software Cloud の無料トライアルに登録できます。

Jira サイトを設定したら、これら 2 つの製品を統合する方法を「Bitbucket Cloud と Jira Software Cloud を接続する」で確認してください。

ステップ 4: コード変更をプル リクエストでレビューする

Bitbucket にコード変更をプッシュしたら、同僚にその変更をレビューしてもらいましょう。プルリクエストはシンプルかつ効果的な方法で、共有環境内でチームにコードのレビューとコラボレーションをしてもらえます。

プルリクエストを作成する

  1. 開いているリポジトリでグローバルサイドバーの [+] をクリックして [Get to work (作業を開始)] の [Create a pull request (プルリクエストを作成)] を選択します。

  2. プルリクエストフォームの残りの箇所を入力します。

プルリクエストを作成する

  1. ソース: マージ対象のコード変更があるリポジトリとブランチです。

  2. マージ先: 変更のマージ先となるリポジトリとブランチです。

  3. タイトルと説明: 両方ともメール通知に記載されていて、タイトルはプル リクエストのリストに表示されます。

  4. レビュアー: 効果的なフィードバックを提供し、変更を承認する必要のあるレビュアーを選択します。

  5. Close branch (ブランチを閉鎖): プル リクエストのマージ完了時にブランチを自動で閉鎖する場合に選択します。

  6. Diff and Commits (差分とコミット): これらのタブで、加えられた変更 (差分)、または含まれているコミットを確認します。

  1. [プルリクエストの作成] をクリックします。

リポジトリのサイドナビゲーションのプルリクエストリストからこのプルリクエストを確認できます。

プル リクエストをレビューする

レビュアーには、レビューするプル リクエストがあることを知らせる通知が送信されます。未対応のプル リクエストはダッシュボードの [プル リクエスト] タブからも確認できます。品質保証のためにコードをレビューする方法は多数ありますが、どの方法を選ぶかは完全にチームに任されています。ここでは、同僚と効率的に連絡を取って変更内容を全員で把握し、マージ対象の変更を承認する方法を紹介します。

差分を表示する プル リクエストを表示すると、プル リクエストで変更されたすべてのファイルの差分 (変更) を確認できます。追加された行は緑の影で、削除された行は赤で表示されます。プル リクエストの上部にある [コミット] タブをクリックしてどのコミットが含まれているかを確認することで、大きなプル リクエストを楽にレビューできます。

フィードバックを残してコメントで質問する Bitbucket では、プル リクエスト全体、特定のファイル、またはファイル内の特定の部分に対してコメントを残せます。これは、フィードバックにコンテキストや具体的な内容を添えたい場合に便利です。コメントには、画像、リンク、リッチ テキストを含めたり、特定のコメントをすばやく共有できるように一意の URL を割り当てたりできます。

プル リクエストを承認または却下する コード変更のレビューが完了したら、そのプル リクエストをマージできるかどうかをプル リクエストの作成者に伝える必要があります。[承認] ボタンをクリックすると、プル リクエストの作成者に通知が送信され、変更を安全にマージできることが伝えられます。プル リクエストを却下した場合も、その旨が作成者に通知されます。プル リクエストを却下したら、リクエストは再度開けなくなります。ブランチをマージするには、新しいプル リクエストを開く必要があります。

プルリクエストの却下は作成者にとって気分の良いものではないため、的外れな変更や不要になった作業に対してのみ使用した方が良いでしょう。他の人の作業をレビューするときは厳しくなりすぎずに、自分の立場ではなく常に相手の立場に立って内容を確認するようにします。

プル リクエストをマージする プル リクエストでコードのレビューと承認が終わったら、[マージ] ボタンをクリックしてブランチをメイン ブランチにマージします。これで、ソース ブランチのコード変更はターゲット ブランチに完全に統合されます。