GitHub †

• https://github.com/
  • Publicリポジトリは無料。デフォルトで全てインターネットに公開されるため、個人情報、パスワード、各種キー等は絶対に置かないように。
    • GitHubで多くのユーザーが秘密鍵を公開状態にしていたことが判明 | スラッシュドット・ジャパン オープンソース
  • Privateリポジトリを作りたい場合は 有料。月額$7〜 Microsoftに買収後、無料に。
    • New year, new GitHub: Announcing unlimited free private repos and unified Enterprise offering - The GitHub Blog
  • Pricing · Plans for every developer
    • 無料プラン: Privateリポジトリは3コラボレータまで。使用できない機能: wiki, Protected branches, オーナー権限, etc

• ステータスページ(障害等の確認): https://status.github.com/messages

• 記事
  • GitHubリポジトリの招待が大量に届いてもまとめて承諾できる。そう、GitHub APIならね ｜ DevelopersIO
  • Gitホスティングサービス5選【比較表付き】 | Find Job ! Startup

---

project/スケジュール管理 †

• 記事
  • 開発者のスケジュール管理に超便利、GitHub Issues、Label、Milestone、Projects使いこなし術 (1/4)：こっそり始めるGit／GitHub超入門（12） - ＠IT

---

無料アカウントは1個人1つ †

GitHubの規約的には。

• GitHub Terms of Service - GitHub Help
  • > We do not recommend creating more than one account.

• 記事
  • 全社的に会社用GitHubアカウントを廃止した件 - ZOZO Technologies TECH BLOG

---

複数アカウントのマージ †

• Merging multiple user accounts - GitHub Help

---

WebHook等で許可すべきIP †

IP制限をしている場合、GitHubのIPを許可する必要がある。

• About GitHub's IP addresses - GitHub Help

• jsonで取得可能

  curl -s https://api.github.com/meta | jq .

---

Actions: ワークフローの自動化とカスタマイズ †

• Features • GitHub Actions

• 記事
  • GitHub Actionsでtextlintしてみた ｜ DevelopersIO
  • Github Actionsが使えるようになったので使ってみる - Qiita
  • GitHub Actions： みなさんが開発し、GitHubで実行 - The GitHub Blog - Japan

---

GitHub markdownで使える言語 †

```言語の名前 or aliases
コード
```

• linguist/languages.yml at master · github/linguist
  • 言語の名前 + aliasesが指定できる
  • bashの場合: https://github.com/github/linguist/blob/master/lib/linguist/languages.yml#L4456
    • 言語の名前: Shell
    • aliases: sh, shell-script, bash, zsh

• 記事
  • [GitHub] コードブロックでシンタックスハイライト可能な言語一覧 ｜ DevelopersIO

---

GitHub上で、ブランチ、コミットIDの比較 †

GitHub上で、ブランチ、コミットID間の比較ができる。
レビューする人の負担が減る。

• 記事
  • github でブランチ・commit間の diff を見る - Qiita

• URL:

  https://github.com/example/example/compare/<commit-id OR branch>...<commit-id or branch>

• 例1: stgディレクトリをコピーして、prodディレクトリを作成して変更。stgとprodの比較をしたい

  # 作業用ブランチ作成
  git co -b add/prod
  
  # stgからprodへコピー
  cp -R stg prod
  
  # 重要。このcommit-idが比較元になる。例: 1234abc
  git add prod
  git commit
  
  # prod/以下を変更してcommit
  git commit
  
  git push origin add/prod
  
  # stgとprodの比較用リンクで確認し、PR等に記載
  https://github.com/example/example/compare/1234abc...add/prod

---

GitHubを使った開発フロー †

• 記事
  • 開発フロー研修 @ Wantedly - Qiita

---

Issue Template †

• Github Issue Template - bl.ocks.org 英語の例

---

二段階認証 †

• https://github.com/settings/security

• 二段階認証後
  • 初回(IPアドレス等？)ブラウザログイン時に、ワンタイムパスワードを入力する
  • clone時に、https://だとIDとアクセストークンをGitHub上で取得し、入力する必要がある。SSHの方が便利

---

一時的にユーザ名の変更 †

• コミット時に指定

  git commit --author='User1 <user1@example.com>' -a

• リポジトリ毎に指定( repository/.git/config)

  git config user.name "user1"
  git config user.email "user1@example.com"

---

GitHub for WindowsでBitBucketを使う †

GitHubはデフォルトで正しい秘密鍵が指定されるようだが、BitBucketでは秘密鍵を明示的に指定する必要があった

1. https://bitbucket.org/ のアカウントの管理 > SSHキーにGitHub for Windowsで使用している公開鍵を追加
   • %USERPROFILE%\.ssh\github_rsa.pub
2. Git Shellを開き以下のようにする

   vim ~/.ssh/config
   ----
   Host bitbucket.org
     User git
     Port 22
     HostName bitbucket.org
     IdentityFile ~/.ssh/github_rsa
     TCPKeepAlive yes
     IdentitiesOnly yes
   ----

---

GitHubに登録した公開鍵は世界に公開される †

• 以下のアドレスから誰でも取得できる。未登録の場合は空
  • https://github.com/<user>.keys
  • https://api.github.com/users/<user>/keys
• GitHubのアカウント名を知っていれば、ログインしたいホストの ~/.ssh/authorized_keys に追加すればOK
• 公開鍵末尾のスペース以降はコメントなので、判別しやすいコメントを付けると良い

  ssh-rsa AAAAB3N...YFd8w6Q== username@example.com

---

よく使うリンク †

• 自分にアサインされているissue一覧
  • https://github.com/issues/assigned

---

Markdown記法 †

• Githubによって拡張されている
• エディタ
  • https://atom.io/ α版だがWindows/MacOSX版あり。CTRL+SHIFT+Mでプレビュー

• 記事
  • Qiita - Markdown記法 チートシート - Qiita

---

webhook: push後、指定サーバに通知を送信、サーバ上で自動更新 †

• https://developer.github.com/webhooks/

• 記事
  • githubのwebhookを使って、push時に自動でサーバーを更新させる - MANA-DOT

---

接続に使うユーザの確認 †

ssh git@github.com

Hi <UserName> ...

---

ERROR: Repository not found. †

• pull権限はあるが、push権限が無い場合もこのエラー

---

Issue †

• Problem : 解決されるべき事
• Issue : 議論されるべき事

• Closing issues via commit messages GitHub Help

• コメントに #1 等のIssue番号を入れる事で自動的にリンクしてくれる。
• #1 fixed, #1 closed等の決められた単語をコミットメッセージに入れる事で、Issueをcloseできる

  git commi -m "#1 fixed"
  git commi -m "#1 closed"

---

githubのpull request †

変更点を含んだブランチを元リポジトリに取り込んで貰うようにリクエストを投げる事

• 記事
  • GitHub直伝 プルリクエスト活用の3つのコツ | A-Listers
  • できる! pull request! - Masteries
  • 綺麗なpull requestを送るための3つのポイント #git #GitHub #AdventCalendar - Qiita [キータ]
  • GitHub初心者はForkしない方のPull Requestから入門しよう - QNYP Blog
  • GitHubへpull requestする際のベストプラクティス - hnwの日記

• 編集する人
  • コンソールでの作業

    # 現在のbranch確認
    git branch -a
    * master
    
    # 最新のmasterに更新
    git pull
    
    # 作業用ブランチ作成とチェックアウト
    git checkout -b new-branch
    
    # 現在のbranch確認
    git branch
      master
    * new-branch
    
    # ファイルを変更、追加
    # 変更点確認
    git diff .
    
    # 問題なければコミット
    git commit .
    
    # ブランチをリモートへプッシュ
    git push origin new-branch

  • GitHub上での作業

1. 該当ブランチを選択
2. Compare & pull Request ボタン
3. @名前で該当の人を記入

• Pull requestを受け取った人

1. Changesetで変更点を確認
2. Merge pull request
3. Confirm merge
4. Delete branch

• 最新のマスターを取得

  git checkout master
  git pull

---

リポジトリ毎に別のgithubアカウントを使う †

• 記事
  • 【メモ】githubの複数アカウントにSSH接続するための設定手順 ｜ Developers.IO

• リポジトリ毎に別のユーザ名を使用できる。例えばuser1。global user.name, user.emailが設定されていない場合、commit, push等が出来ない

  git clone git@github.com:REPO/git-test.git
  cd REPO
  
  git config user.name "user1"
  git config user.email "user1@example.com"
  git config --list
  
  # ssh秘密鍵を適当な場所に置く
  vim ~/.ssh/github-user1_rsa
  chmod 600 ~/.ssh/github-user1_rsa
  
  # ssh configを変更し、適当なホスト名を付ける
  vim ~/.ssh/config
  ----
  Host github-user1
    User git
    Port 22
    HostName github.com
    IdentityFile ~/.ssh/github-user1_rsa
    TCPKeepAlive yes
    IdentitiesOnly yes
  ----
  
  # 接続テスト: 詳細を知りたければ「-v」を付ける
  ssh -T github-user1
  Hi user1! ... # のようにgithubのuser nameが表示されれば成功
  
  # リポジトリ中のアドレスを変更
  vim .git/config
  ----
      url = git@github-user1:REPO/git-test.git
  ----

• push前ならcommit済みのauthorを変更できる。

  git commit --amend --author="user1 <user1@example.com>"
  # 確認
  git log

• 記事
  • Git の Commit Author と Commiter を変更する - Qiita

---

使い方 †

• 記事
  • gitでpushしたりpullしたり | 半年前の私への教科書
  • とっても優しい github の使い方 - 日常日記

• README.mdのリアルタイムプレビュー

• ヘルプ

1. https://github.com/signup/free 無料アカウントの作成
2. Linux上での作業用にSSH公開鍵の登録。パスフレーズをありにすると毎回聞かれるので空でも良い

   ssh-keygen -t rsa -C "your_email@youremail.com"
   
   秘密鍵と公開鍵が出来るので保存しておく
   ~/.ssh/id_rsa
   ~/.ssh/id_rsa.pub
   
   コミットログに表示される名前とメールアドレスを設定。~/.gitconfig に保存される
   git config --global user.name "your_name"
   git config --global user.email "your_email@youremail.com"

3. githubにログインした状態で右上のAccount Settingsを選択し、SSH Keys > Add SSH Keyに「~/.ssh/id_rsa.pub」の内容をコピペ
4. 右上のCreate New Repoで新しいリポジトリ(例：example)を作成
5. ローカルに新規リポジトリを作成する場合

   mkdir example
   cd example
   git init
   touch README
   git add README
   git commit -m 'first commit'
   # URLに'origin' という短い別名を付ける(必須ではない)
   git remote add origin git@github.com:your_name/example.git
   # git push git@github.com:your_name/example.git master:master と同じ
   git push -u origin master

   • linux上でローカルリポジトリをもってくる場合

     git clone git://github.com/your_name/example.git
     cd example
     
     # リモートの更新内容を反映
     git pull
     
     # ファイルの追加
     git add README
     
     # 全ての変更を追加
     git add .
     
     # 変更の確認
     git status
     
     # 差分の確認
     git diff [ファイル名]
     
     # 変更を元に戻す
     git revert ファイル名
     
     # 変更のコミット
     git commit -a
     
     # リモートリポジトリへ反映
     git push