GitHubで初めてのリポジトリ作成!初期化からプッシュまでを徹底解説
これまでの記事でGitHubアカウントの作成とGitのインストールが完了し、いよいよGitHubを本格的に活用する準備が整いました。最初のステップとして、まずはあなたのコードを保管する「家」となるリポジトリを作成してみましょう。
この記事では、「リポジトリとは何か?」という基本的な概念から、GitHub上でリポジトリを作成する具体的な手順、そしてあなたのパソコン(ローカル環境)で作成したファイルを初めてGitHubにアップロード(プッシュ)するまでの一連の流れを、コマンドと共に丁寧に解説していきます。この流れは、今後の開発で何度も繰り返す基本動作なので、ぜひここでマスターしてください!
そもそもリポジトリとは?プロジェクトの「入れ物」です
リポジトリ(Repository)とは、直訳すると「貯蔵庫」や「保管場所」を意味します。プログラミングの世界では、あなたのプロジェクトに関連するすべてのファイル(HTML, CSS, JavaScript, 画像など)と、それらの**変更履歴(コミットログ)全体をまとめて保管しておくための「入れ物」**と考えてください。
リポジトリには、大きく分けて2種類あります。
- ローカルリポジトリ: あなたのパソコンの中に作られるリポジトリです。普段の作業はここで行います。
- リモートリポジトリ: GitHubのような、インターネット上のサーバーに作られるリポジトリです。チームメンバーとのコード共有や、個人のコードのバックアップ拠点として機能します。
基本的な開発の流れは、ローカルリポジトリで作業を進め、キリの良いところでセーブ(コミット)し、その変更内容をリモートリポジトリにアップロード(プッシュ)する、というサイクルになります。
GitHubでリモートリポジトリを作成する手順
まずは、GitHub上にコードの保管場所となるリモートリポジトリを作成しましょう。手順はとても簡単です。
ステップ1: 新規リポジトリ作成ページへ移動
GitHubにログインし、画面右上の「+」アイコンをクリックするか、ダッシュボードの左側にある「New」ボタンを押します。
[画像:GitHubダッシュボードの「New」ボタンが強調されている様子]
ステップ2: リポジトリの情報を入力
「Create a new repository」というページが表示されるので、必要な情報を入力していきます。
[画像:「Create a new repository」フォームの各項目を解説している様子]
- Repository name: リポジトリの名前です。プロジェクトの内容がわかる、簡潔な名前を英語で付けましょう。(例: `my-portfolio-site`)
- Description: リポジトリの簡単な説明です(任意)。どんなプロジェクトなのかを書いておくと、後から見返したときに分かりやすいです。
- Public / Private: 公開範囲を選びます。世界中の誰にでも見てもらいたい場合は「Public」、自分だけ、あるいは招待した人だけが見られるようにしたい場合は「Private」を選びます。練習用なら「Private」で良いでしょう。
- Initialize this repository with:: リポジトリ作成時に、自動で含めるファイルを選べます。
- Add a README file: プロジェクトの説明書となるファイルです。チェックを入れておくことを強くお勧めします。
- Add .gitignore: Gitの管理対象から外したいファイルを指定する設定ファイルです。今は「None」のままで構いません。
- Choose a license: ソースコードの利用許諾に関するライセンスを選びます。個人で使う分には、今は設定しなくても問題ありません。
ステップ3: リポジトリの作成
すべての入力が終わったら、「Create repository」ボタンをクリックします。これで、GitHub上にあなたの新しいリモートリポジトリが作成されました!
[画像:作成されたばかりの空のリポジトリのメインページ]
ローカルPCでプロジェクトを準備し、GitHubに接続する
次に、あなたのPC(ローカル)にプロジェクトを用意し、先ほど作成したリモートリポジトリに初めてのファイルをアップロードしてみましょう。
ステップ1: ローカルにプロジェクトフォルダを作成
まず、PCの好きな場所に作業用のフォルダを作成します。ここではターミナル(WindowsならGit Bash)を使って操作します。
mkdir my-first-repo
作成したフォルダに移動します。
cd my-first-repo
ステップ2: Gitリポジトリを初期化
このフォルダをGitの管理下に置くため、初期化コマンドを実行します。これにより、フォルダ内に`.git`という隠しフォルダが作成されます。
git init
ステップ3: アップロードするファイルを作成
テスト用に簡単なHTMLファイルを作成しましょう。
echo "Hello, GitHub!" > index.html
ステップ4: ファイルをコミット(セーブ)する
作成したファイルをGitに記録します。まず、`git add`でセーブ対象のファイルとして選択(ステージング)します。
git add index.html
次に、`git commit`でセーブポイントを作成します。
git commit -m "最初のHTMLファイルを追加"
ステップ5: リモートリポジトリと接続する
ローカルのリポジトリと、先ほどGitHub上に作成したリモートリポジトリを紐付けます。GitHubのリポジトリページに行き、「Code」ボタンからSSHのURLをコピーしてください。
[画像:GitHubの「Code」ボタンをクリックし、SSHのURLをコピーしている様子]
git remote add origin git@github.com:あなたのユーザー名/my-first-repo.git
ステップ6: GitHubにプッシュ(アップロード)する
いよいよ最終段階です。ローカルで作成したコミットを、リモートリポジトリにアップロードします。これを「プッシュ」と呼びます。
git push -u origin main
確認:GitHub上でファイルが反映されているか見てみよう
プッシュが完了したら、ブラウザでGitHubのリポジトリページを再読み込みしてみてください。先ほど作成した`index.html`が表示されているはずです!ファイル名をクリックすれば、中身も確認できます。
[画像:GitHubリポジトリページにindex.htmlが追加され、ファイル一覧に表示されている様子]
おめでとうございます!これで、あなたはローカルのファイルをGitHubにアップロードするという、最も基本的で重要なワークフローをマスターしました。