Bitbucketでリポジトリを作成する方法【初心者向け】

📌 目次

Bitbucketの特徴と活用事例
Bitbucketの初期設定とワークスペース管理
リポジトリの作成手順
リポジトリの基本設定
ローカルリポジトリの作成とプッシュ
まとめ
Q&A

💡 Bitbucketの特徴と活用事例

Bitbucketは、Atlassianが提供するGitリポジトリ管理ツールであり、特にチーム開発に適した機能が充実しています。他のバージョン管理ツールと比較して、以下のような特徴があります：

📌 Bitbucketの主な特徴

無料でプライベートリポジトリを利用可能（最大5人のチームメンバー）
JiraやTrelloとの統合がスムーズでプロジェクト管理が容易
Bitbucket Pipelines によるCI/CD機能のサポート
詳細なアクセス管理が可能（ブランチレベルの権限設定）
オンプレミス版のBitbucket Server も提供

🚀 Bitbucketの活用事例

Bitbucketは、多くの企業や開発者に利用されています。特に以下のような場面で活用されています：

企業のソフトウェア開発：コードのバージョン管理とチームの協業をスムーズに
アジャイル開発：Jiraとの連携により、スプリント管理やタスク管理が可能
継続的インテグレーション/デリバリー（CI/CD）：Bitbucket Pipelinesを活用して自動テストとデプロイを実行
リモートワーク環境：分散チームでも効率的にコードを管理できる

これらの機能を活用することで、開発プロセスの効率化とプロジェクトの品質向上が期待できます。

🔧 Bitbucketの初期設定とワークスペース管理

Bitbucketを効率的に活用するためには、初期設定が重要です。以下の手順で、最適な環境を構築しましょう。

1. ワークスペースの作成と管理

ワークスペースとは、Bitbucket上でリポジトリを整理・管理するためのスペースです。企業単位やプロジェクトごとにワークスペースを作成すると、チーム開発がスムーズになります。

ワークスペースの作成手順：

Bitbucketにログインし、左側のメニューから「ワークスペース」を選択
「新しいワークスペースを作成」をクリック
ワークスペース名を入力し、適切な権限を設定
「作成」ボタンをクリックして完了

ワークスペースを適切に管理することで、プロジェクト全体の可視性が向上します。

2. ユーザー管理とアクセス権設定

チーム開発を行う際、適切な権限を設定することで安全なコラボレーションが可能になります。Bitbucketでは、以下のようなユーザー権限を設定できます：

管理者(Admin)：すべてのリポジトリと設定を管理
書き込み(Write)：コードのプッシュやブランチの作成が可能
読み取り(Read)：コードの閲覧のみ可能

メンバーを追加するには、ワークスペースの「ユーザーと権限」メニューから招待できます。

3. SSHキーの登録と認証

SSHキーを登録することで、HTTPS認証よりも安全で便利にGit操作を行えます。

SSHキーの設定手順：

ターミナルで以下のコマンドを実行し、新しいSSHキーを生成

ssh-keygen -t rsa -b 4096 -C "your-email@example.com"

作成されたSSHキーをクリップボードにコピー

cat ~/.ssh/id_rsa.pub | pbcopy

Bitbucketの「SSHキー」設定ページにアクセスし、新しいキーを追加
「保存」をクリックして完了

SSHキーを設定すると、リポジトリのクローンやプッシュ時に毎回パスワードを入力する手間が省けます。

4. Gitクライアントの設定

ローカル環境でGitを適切に設定し、Bitbucketとスムーズに連携できるようにします。

git config --global user.name "あなたの名前"
git config --global user.email "あなたのメールアドレス"

これで、ローカルのGit環境がBitbucketのリポジトリと同期できるようになります。

1. ワークスペースの作成

ワークスペースとは、Bitbucket上でリポジトリを管理するためのグループです。会社やプロジェクトごとにワークスペースを作成すると、管理がしやすくなります。

ダッシュボードの「ワークスペースを作成」ボタンをクリックし、名前やアクセス権限を設定しましょう。

2. チームメンバーの追加

プロジェクトの規模に応じて、チームメンバーを招待し、役割を設定できます。「ユーザーと権限」メニューから、メンバーの追加やアクセス権限の管理が可能です。

3. Gitクライアントの設定

Bitbucketを使用するには、ローカル環境にGitをインストールし、Bitbucketのリポジトリと連携させる必要があります。

git config --global user.name "あなたの名前"
git config --global user.email "あなたのメールアドレス"

これにより、ローカルのGit設定が完了します。

📂 リポジトリの作成手順

1. ダッシュボードにアクセス

Bitbucketにログイン後、トップページの「リポジトリの作成」ボタンをクリックします。

2. リポジトリ情報を入力

リポジトリ名：プロジェクトの内容に適した名前を設定
アクセス権限：パブリック（公開）またはプライベート（非公開）を選択
バージョン管理：Gitを選択
READMEファイル：必要に応じて作成
Gitignoreファイル：開発言語に応じたテンプレートを選択

設定が完了したら「作成」ボタンをクリックします。

⚙️ リポジトリの基本設定

リポジトリを作成した後、開発をスムーズに進めるために、以下の基本設定を行いましょう。

1. アクセス権限の管理

リポジトリへのアクセスを適切に管理することで、セキュリティを強化できます。Bitbucketでは、以下の権限レベルを設定できます：

管理者（Admin）：すべての操作が可能
書き込み（Write）：コードのプッシュとブランチ作成が可能
読み取り（Read）：リポジトリの閲覧のみ可能

チームメンバーを追加するには、リポジトリの「Settings」→「User and group access」から設定できます。

2. ブランチ戦略とルール設定

開発プロセスを統一するために、ブランチのルールを設定しましょう。Bitbucketでは、以下のブランチ管理が推奨されています：

main（master）ブランチ：本番環境の安定したコードを管理
developブランチ：開発用の統合ブランチ
featureブランチ：新機能の開発ブランチ
hotfixブランチ：緊急バグ修正用のブランチ

「Settings」→「Branch permissions」から、特定のブランチへのプッシュやマージを制限できます。

3. Webhookの設定

Webhookを利用すると、リポジトリの変更が発生した際に、外部のツールやサーバーに通知を送ることができます。

設定手順：

「リポジトリ設定」→「Webhooks」に移動
「新しいWebhookを追加」をクリック
通知を送るURLを入力
イベントの種類を選択（例：プッシュ、プルリクエストの作成）
「保存」をクリックして完了

4. Bitbucket Pipelines（CI/CD）の設定

Bitbucket Pipelinesを使用すると、自動テストやデプロイを簡単に設定できます。

設定手順：

リポジトリのルートディレクトリに bitbucket-pipelines.yml を作成
以下のテンプレートを記述：

image: node:14
pipelines:
  default:
    - step:
        name: Build and Test
        script:
          - npm install
          - npm test

「Pipelines」メニューから設定を有効化し、CI/CDを実行しましょう。

5. セキュリティ対策

Bitbucketには、リポジトリの安全性を高めるための様々な機能が提供されています。

二段階認証（2FA）の有効化：不正アクセスを防止
IP許可リストの設定：特定のIPアドレスからのみアクセスを許可
Secrets Management：APIキーや環境変数を安全に管理

「リポジトリ設定」→「Security」から各種設定を行いましょう。

🚀 ローカルリポジトリの作成とプッシュ

ローカル環境でリポジトリを作成し、Bitbucketにプッシュする方法を詳しく解説します。

1. ローカルリポジトリの作成

まず、新しいプロジェクトフォルダを作成し、Gitリポジトリを初期化します。

mkdir my-project
cd my-project
git init

このコマンドで、my-projectフォルダを作成し、その中でGitリポジトリを初期化します。

2. Bitbucketのリモートリポジトリと接続

Bitbucketで作成したリモートリポジトリとローカルリポジトリを接続します。

git remote add origin https://bitbucket.org/your-repo.git

これにより、ローカルリポジトリがBitbucketのリモートリポジトリとリンクされます。

3. ファイルの追加と初回コミット

READMEファイルを作成し、最初のコミットを行います。

touch README.md
echo "# My Project" > README.md
git add .
git commit -m "初回コミット"

これで、リポジトリに最初のファイルが追加され、コミットされました。

4. Bitbucketにプッシュ

ローカルの変更をBitbucketにプッシュします。

git push -u origin main

このコマンドを実行すると、ローカルの main ブランチがリモートリポジトリにアップロードされます。

5. 正しくプッシュされたか確認

Bitbucketのリポジトリページを開き、コミットが反映されているか確認しましょう。

もしエラーが発生する場合、git status コマンドで現在の状態を確認し、必要に応じて git pull origin main を実行して変更を取得してください。

🔍 まとめ

Bitbucketを活用することで、ソフトウェア開発の効率を大幅に向上させることができます。本記事では、Bitbucketの基本的な使い方から、リポジトリの作成、設定、ローカル環境との連携までを詳しく解説しました。

✅ Bitbucketを利用するメリット

無料でプライベートリポジトリを作成可能（最大5人のチームメンバー）
JiraやTrelloとの統合が可能でプロジェクト管理がスムーズ
Bitbucket Pipelines によるCI/CDの自動化
詳細なアクセス管理が可能（ブランチごとの権限設定）
開発チーム向けに最適化されたワークフローを提供

🎯 今後のステップ

Bitbucketをより活用するために、以下のステップも試してみてください。

リポジトリのセキュリティ設定を強化する
Bitbucket Pipelinesを活用して、CI/CDを構築する
チームでのコードレビューをスムーズに行うため、プルリクエストのルールを設定する

✨ ぜひBitbucketを活用して、より効果的なソフトウェア開発環境を構築しましょう！

❓ Q&A

Q1. Bitbucketで新しいリポジトリを作成する方法は？

A. Bitbucketのダッシュボードから「リポジトリの作成」をクリックし、リポジトリ名やアクセス権限を設定すれば作成できます。

Q2. Bitbucketでブランチを作成するには？

A. ターミナルで以下のコマンドを実行します：

git checkout -b 新しいブランチ名

その後、git push origin 新しいブランチ名 でリモートにプッシュできます。

Q3. Bitbucketでプルリクエストを作成するには？

A. Bitbucketのリポジトリページから「プルリクエストを作成」をクリックし、変更内容を指定して送信します。

Q4. Bitbucket Pipelinesを設定するには？

A. リポジトリのルートに bitbucket-pipelines.yml ファイルを作成し、以下のような設定を追加します：

image: node:14
pipelines:
  default:
    - step:
        name: Build and Test
        script:
          - npm install
          - npm test

その後、Bitbucketの「Pipelines」メニューで有効化できます。

Q5. Bitbucketでリポジトリを削除するには？

A. 「リポジトリ設定」→「削除」から、リポジトリを削除できます。ただし、一度削除すると復元できないため注意が必要です。

Q6. Bitbucketのアクセス権限を設定する方法は？

A. 「Settings」→「User and group access」から、管理者・書き込み・読み取りの権限を設定できます。

Windowsリモートデスクトップ設定方法

3月 05, 2025