Git, GitHubとは？ – 準備ガイド

🇺🇸 English version: 00_Prep_EN.md

これは, 「Git＆GitHubの概要」講義の準備をするためのガイドです。

講義の準備として (順番に)行う手順は次のとおりです。

1. GitHub.comアカウント
2. Visual Studio Code (VS Code) + Command Line
3. Git のインストール
4. GitHub Desktop App
5. GitHub Command Line (GitHub CLI)
6. Git を設定する

---

概要

• GitHub.comアカウント
  • Step 1 - GitHub.comアカウントを作成する
  • Step 2 - 2要素認証を設定する
• Visual Studio Code (VS Code) + Command Line
• Git のインストール
  • MacOS - Git のインストール
  • Windows 10 - Git のインストール
• GitHub Desktop App
• GitHub Command Line (GitHub CLI)
  • MacOS - GitHub CLI のインストール
  • Windows 10 - GitHub CLI のインストール
• Git を設定する
  • Add GitHub.com Login
  • Add GitHub Enterprise Login
  • GitHub認証が成功したことを確認する
  • デフォルトブランチ - main
• 随意の設定
  • Windows - cash をインストール
• 次のセクション

---

GitHub.comアカウント

Step 1 - GitHub.comアカウントを作成する

ここでサインアップして, GitHub.comアカウントを作成します。

• github.com/join

プロフィール写真に使用できる無料の画像については, unsplash.comをおすすめします:

• unsplash.com/s/photos/cute
• unsplash.com/s/photos/profile-dog
• unsplash.com/collections/410090/animals

Step 2 - 2要素認証を設定する

1. GitHub.com の Two-factor authentication 設定画面に移動します: github.com/settings/security
   • Click on the Enable two-factor authentication button
   • Enable two-factor authentication (2要素認証を有効にする) ボタンをクリックします
   • Set up using an app (アプリを使用して設定する) オプションを選択し, Continue (続行) ボタンをクリックします
2. 二要素認証アプリでQRコードをスキャンする
   • おすすめの二要素認証アプリ:
     • 1Password
     • Microsoft
     • Authy
     • Enpass
3. 二要素認証アプリから6桁のコードを入力します
4. リカバリコードをダウンロードして, I have saved my recovery codes (リカバリコードを保存しました) ボタンをクリックします
5. 最後に, Done (完了) ボタンをクリックします

これがステップ2のセクションを案内するgifです

• 

ドキュメンテーション

• GitHub ドキュメンテーション: 2 要素認証を設定する
• YouTube: GitHubで2FAをセットアップする方法 / How to setup 2FA with GitHub

---

Visual Studio Code (VS Code) + Command Line

Visual Studio Codeダウンロードリンク:

• code.visualstudio.com

コマンドラインからVSCodeを開く機能を設定します。

1. VSCodeAppを起動します
2. 次のショートカットを使用して Command Palette (コマンドパレット) を開きます。
   • Mac: Command + Shift + P
   • Windows: Ctrl + Shift + P
3. shell をタイプして Shell Command: Install 'code' command in PATH オプションを選択します
   • 
4. ターミナルを再起動します
5. ターミナルで, code .と入力して, VSCodeで現在のフォルダーを開きます
   • Mac: ターミナル を使う
   • Windows: Command Prompt を使う

---

Git のインストール

• MacOS - Git のインストール
• Windows 10 - Git のインストール

MacOS - Git のインストール

1. 次のコマンドで Homebrew (brew.sh) をインストールします。

    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
   

2. 新しいパッケージをインストールする前に, brew を更新およびアップグレードします

    brew update && brew upgrade
   

3. Homebrew で git をインストール

    brew install git
   

4. インストールの確認

    git --version
   
    # Gitのバージョンが表示されれば成功です
    git version 2.36.1
   

デバッグ

もし次の結果が返ってきた場合	git version 1.7.10.2 (Apple Git-33)
このコマンドを実行してください！	brew link --force git
またはこちらを実行してください！	export PATH=/usr/local/bin:$PATH

詳細: Git - Gitのインストール

これで, Git をインストールする準備が整いました

次のセクションは GitHub Desktop App です

---

Windows 10 - Git のインストール

1. gitforwindows.org に行ってWindowsのgitをインストールします。
2. 次の設定を除いて, インストールウィザードのデフォルト設定を受け入れます。
   1. Choosing the default editor used by Git 設定で, Use Visual Studio Code as Git's default editor オプションを選択します
   2. [Gitで使用されるデフォルトのエディターを選択する]設定で, [VisualStudioCodeをGitのデフォルトのエディターとして使用する]オプションを選択します
   3. Adjusting the name of the initial branch in new repositories 設定で, Override the default branch name for new repositories オプションを選択します
   4. Configuring the line ending conversions 設定で, Checkout as is, commit as is オプションを選択します
   5. Configuring the terminal emulator to use with Git Bash 設定で, Use Windows's default console window オプションを選択します
   6. 最後の設定ページで, Launch Git Bash (Git Bashの起動) オプションを選択し, View Release Notes (リリースノートの表示) オプションの選択を解除します

インストールウィザード設定のスクリーンショット

デフォルト以外の設定が強調表示されます。

これで, Git をインストールする準備が整いました

次のセクションは GitHub Desktop App です

---

GitHub Desktop App

1. ここから GitHub デスクトップアプリをダウンロードします: desktop.github.com
2. 次に, Sign in to GitHub.com (GitHub.comにサインイン) ボタンをクリックします
3. ブラウザウィンドウが起動します
4. 以下のスクリーンショットに従って, GitHub.com アカウントにログインします。

ステップ 1		ステップ 2
ステップ 3		ステップ 4
ステップ 5		ステップ 6

GitHub デスクトップアプリのドキュメント:

• English: GitHub Desktop - GitHub Docs
• 日本語: GitHub Desktopのドキュメント

---

GitHub Command Line (GitHub CLI)

GitHubコマンドライン (GitHub CLI)

• MacOS - GitHub CLI のインストール
• Windows 10 - GitHub CLI のインストール

MacOS - GitHub CLI のインストール

1. 新しいパッケージをインストールする前に, brewを更新およびアップグレードします

    brew update && brew upgrade
   

2. 次のコマンドを使用して GitHub CLI をインストールします。

    brew install gh
   

3. GitHub CLI を使用する前にコンピューターを再起動してください

これで, GitHub CLI をインストールする準備が整いました

次のセクションは Git を設定する です

Windows 10 - GitHub CLI のインストール

1. Install GitHub CLI by going to cli.github.com and clicking on the Download for Windows button
2. cli.github.com に行って, Download for Windows ボタンをクリックして, GitHub CLI をインストールします
3. インストールウィザードのデフォルト設定を受け入れます
4. GitHub CLI を使用する前にコンピューターを再起動してください

これで, GitHub CLI をインストールする準備が整いました

次のセクションは Git を設定する です

---

Git を設定する

Add GitHub.com Login

GitHub CLI の gh auth login コマンドを使用して GitHub ログインを構成します

git コマンド (git) と GitHub CLI コマンド (gh) はこちらを使って実行します:

• Mac: ターミナル を使う
• Windows: Command Prompt を使う

コンピューターに git を設定するには, 次の手順を実行します:

1. gh auth login コマンドを実行します
2. What account do you want to log into? プロンプトで, GitHub.com オプションを選択します
3. What is your preferred protocol for Git operations? プロンプトで, HTTPS オプションを選択します
4. Authenticate Git with your GitHub credentials? (Y/n) プロンプトで, yと入力します
5. 9文字のコードをコピーして, enter キーを押します
6. ブラウザウィンドウが起動します
7. GitHub Webサイトに9文字のコードを入力します
8. Authorize ボタンをクリックします

Add GitHub Enterprise Login

1. gh auth login --hostname <hostname> コマンドを実行します
   • ホスト名の例: github.dev.ahandsel.co.jp
2. What is your preferred protocol for Git operations? プロンプトで, HTTPS オプションを選択します
3. Authenticate Git with your GitHub credentials? (Y/n) プロンプトで, yと入力します
4. 9文字のコードをコピーして, enter キーを押します
5. ブラウザウィンドウが起動します
6. GitHub Webサイトに9文字のコードを入力します
7. Authorize ボタンをクリックします

GitHub認証が成功したことを確認する

次のコマンドで設定を確認します: gh auth status

これを見たら成功した証拠です:

  ❯ gh auth status
  github.com
    ✓ Logged in to github.com as ahandsel (/Users/***/.config/gh/hosts.yml)
    ✓ Git operations for github.com configured to use https protocol.
    ✓ Token: *******************

  github.dev.ahandsel.co.jp
    ✓ Logged in to github.dev.ahandsel.co.jp as ahandsel (/Users/***/.config/gh/hosts.yml)
    ✓ Git operations for github.dev.ahandsel.co.jp configured to use https protocol.
    ✓ Token: *******************

デフォルトブランチ - main

• main または master は, git によってデフォルトのブランチ名として設定されます。
• 以前のデフォルトは master ですが, 現在は main を使用するのがベストプラクティスです ( master の意味を考えるとね😅)

次のコマンドを使用して, コンピューターのデフォルトのブランチ名を main に設定します。

git config --global init.defaultBranch main

---

随意の設定

Windows - cash をインストール

1. Node.js を Windows にインストールします

   • [Download

     Node.js](https://nodejs.org/ja/download/)

   • Windows に Node.js をインストールガイド - Windows 10へNode.jsをインストールする - Qiita
2. Command Prompt で次のコマンドを実行して, Node.js のインストールを確認します
   • node --version
3. dthree/cash をインストールして, Windows コマンドプロンプトで Linux コマンドを実行できるようにします。
   • インストールコマンド: npm install cash-global -g

---

次のセクション

基本と最初のレポ - 01_Start.md へ 💪

講義ガイド一覧

README.md ⚙️