Gitの準備をしよう

このハンズオンでは、バージョン管理ツールであるGitのインストールと、GitHubのアカウント作成について実際にハンズオン形式で手を動かしながら体験します。

Gitのインストールと初期設定
GitHubアカウントの作成
SSH鍵の作成とGitHubへの登録

1. Gitのインストール

1.1 Gitとは

Gitは、ソースコードの変更履歴を管理するためのバージョン管理システムです。「いつ、誰が、何を変更したか」を記録し、過去の状態に戻したり、複数人で同じコードを安全に編集したりすることができます。

現在のソフトウェア開発では、Gitによるバージョン管理はほぼ必須のスキルとなっています。CI/CDパイプラインもGitリポジトリへのプッシュをトリガーとして動作するため、Gitの基本的な使い方を理解しておくことが重要です。

1.2 インストール方法

Gitのインストール方法はOSによって異なります。

Macの場合

Macでは、ターミナルで以下のコマンドを実行するとGitが利用可能になります。

git --version

初めて実行した場合、「コマンドライン・デベロッパ・ツール」のインストールを求めるダイアログが表示されます。「インストール」をクリックしてインストールを完了させてください。

インストール後に再度コマンドを実行すると、バージョンが表示されます。

git version 2.x.x

Windowsの場合

Windowsでは、Git公式サイトからインストーラをダウンロードしてインストールします。

Git for Windows - ダウンロード

ダウンロードしたインストーラを実行し、基本的にデフォルトの設定のまま「Next」を押していけばインストールが完了します。

インストール後、コマンドプロンプトまたはPowerShellで以下のコマンドを実行し、バージョンが表示されることを確認してください。

git --version

git version 2.x.x.windows.x

1.3 Gitの初期設定

Gitを使用する前に、ユーザ名とメールアドレスを設定する必要があります。これらの情報は、コミット（変更の記録）に記録されます。

ターミナル（Windowsの場合はコマンドプロンプトまたはPowerShell）で、以下のコマンドを実行してください。名前とメールアドレスはご自身のものに置き換えてください。

git config --global user.name "Your Name"
git config --global user.email "your-email@example.com"

設定が正しく反映されているか確認するには、以下のコマンドを実行します。

git config --global --list

user.name=Your Name
user.email=your-email@example.com

上記のように設定した名前とメールアドレスが表示されれば、初期設定は完了です。

2. GitHubアカウントの作成

2.1 GitHubとは

GitHubは、Gitリポジトリをクラウド上でホスティングするサービスです。ソースコードの管理だけでなく、プルリクエストによるコードレビューや、GitHub Actionsによる CI/CDパイプラインの実行など、チーム開発に必要な機能が豊富に揃っています。

GitHub Actionsを利用するためにはGitHubアカウントが必要ですので、ここでアカウントを作成します。すでにアカウントをお持ちの方は、この手順をスキップしてください。

2.2 アカウントの作成手順

GitHubの公式サイトにアクセスします。

GitHub

トップページのSign upをクリックします。

アカウント作成画面が表示されるので、以下の情報を入力していきます。

設定項目	入力内容	設定の基準
Email address	ご自身のメールアドレス	アカウントの認証やお知らせの受信に使用するため
Password	任意のパスワード	15文字以上、または数字と小文字を含む8文字以上が必要
Username	任意のユーザ名	GitHubのプロフィールURLに使用される（あとから変更可能）

画面の指示に従って進めると、入力したメールアドレス宛に確認コードが届きます。メールに記載されたコードを入力して、メールアドレスの認証を完了させてください。

認証が完了すると、GitHubのダッシュボードが表示されます。これでアカウントの作成は完了です。

💡 ポイント
GitHubアカウントは無料プラン（Free）で十分です。無料プランでもパブリック・プライベートリポジトリの作成やGitHub Actionsの利用が可能です。

3. GitHubへの接続設定

GitHubアカウントを作成しただけでは、ローカルのターミナルからGitHubにコードをプッシュすることはできません。ローカルからGitHubに安全にアクセスするために、SSH鍵を使った認証を設定します。

📝 SSH鍵とは
SSH鍵は、公開鍵と秘密鍵のペアで構成される認証方式です。秘密鍵はローカルPCに保存し、公開鍵をGitHubに登録します。通信時に鍵のペアが一致するかを検証することで、パスワードを入力せずに安全にGitHubにアクセスできるようになります。

3.1 SSH鍵の作成

ターミナル（Windowsの場合はコマンドプロンプトまたはPowerShell）で、以下のコマンドを実行してSSH鍵を作成します。メールアドレスはGitHubに登録したものに置き換えてください。

ssh-keygen -t ed25519 -C "your-email@example.com"

実行するといくつか質問が表示されますが、すべてそのままEnterキーを押してください。

Generating public/private ed25519 key pair.
Enter file in which to save the key (/Users/you/.ssh/id_ed25519):  ← そのままEnter
Enter passphrase (empty for no passphrase):  ← そのままEnter
Enter same passphrase again:  ← そのままEnter

これにより、以下の2つのファイルが作成されます。

ファイル	説明
`~/.ssh/id_ed25519`	秘密鍵（ローカルPCに保管。他人に共有しない）
`~/.ssh/id_ed25519.pub`	公開鍵（GitHubに登録する）

💡 ポイント
秘密鍵（`id_ed25519`）は絶対に他人に共有しないでください。GitHubに登録するのは公開鍵（`id_ed25519.pub`）のほうです。

3.2 公開鍵のコピー

作成した公開鍵の内容をコピーします。

Macの場合

pbcopy < ~/.ssh/id_ed25519.pub

上記のコマンドを実行すると、公開鍵の内容がクリップボードにコピーされます。

Windowsの場合

clip < ~/.ssh/id_ed25519.pub

上記のコマンドを実行すると、公開鍵の内容がクリップボードにコピーされます。

⚠️ コマンドでコピーできない場合
上記のコマンドが使えない場合は、`cat ~/.ssh/id_ed25519.pub`を実行して表示された内容を手動でコピーしてください。`ssh-ed25519`から始まる1行をすべて選択してコピーします。

3.3 GitHubに公開鍵を登録

コピーした公開鍵をGitHubに登録します。

GitHubにログインし、右上のアイコンをクリックしてSettingsを選択します。

左側のメニューからSSH and GPG keysを選択し、New SSH keyをクリックします。

下記の内容を入力してください。

設定項目	入力内容	設定の基準
Title	任意の名前（例: My Laptop）	どのPCの鍵かを識別するため
Key type	Authentication Key	認証用の鍵として使用するため
Key	先ほどコピーした公開鍵	ローカルPCとの認証に使用するため

入力が終わったらAdd SSH keyをクリックします。GitHubのパスワードを求められた場合は入力してください。

3.4 接続の確認

SSH鍵の登録が完了したら、ローカルからGitHubに正しく接続できるか確認します。以下のコマンドを実行してください。

ssh -T git@github.com

初回接続時には以下のような確認メッセージが表示されます。yesと入力してEnterキーを押してください。

The authenticity of host 'github.com (xx.xx.xx.xx)' can't be established.
ED25519 key fingerprint is SHA256:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.
Are you sure you want to continue connecting (yes/no/[fingerprint])? yes

接続に成功すると、以下のようなメッセージが表示されます。

Hi username! You've successfully authenticated, but GitHub does not provide shell access.

Hi username!の部分にご自身のGitHubユーザ名が表示されていれば、SSHによるGitHubへの接続設定は完了です。

⚠️ 「Permission denied (publickey)」と表示される場合
(1) SSH鍵が正しく作成されているか確認してください（`ls ~/.ssh/id_ed25519.pub`でファイルが存在するか確認）。 (2) GitHubに登録した公開鍵の内容が正しいか確認してください。公開鍵を再度コピーし、GitHub上の鍵を削除してから再登録してみてください。

4. まとめ

このハンズオンでは、Gitのインストールと、GitHubのアカウント作成を体験しました。

Gitはソースコードのバージョン管理システムであり、CI/CDの基盤となるツール
OSに合った方法でGitをインストールし、git configでユーザ名とメールアドレスを設定する
GitHubはGitリポジトリのホスティングサービスで、GitHub Actionsの利用にはアカウントが必要
GitHubアカウントは無料プランで作成できる
SSH鍵を作成してGitHubに登録することで、ローカルからGitHubに安全にアクセスできる
ssh -T git@github.comで接続の確認ができる