INFRASTRUCTURE LEARNINGインフラ学習
インフラ大全インフラ大全IT INFRASTRUCTURE / LEARNING
インフラ学習ガイド
教材・演習を探す/

Escで閉じる · 検索語は送信しません

LEARNINGEN

GITHUB · 入門

GitHub入門:Gitとの違い・リポジトリ・PRと共同開発

GitHubは、Gitリポジトリの共有と共同作業を支援するサービスです。Gitが履歴を記録し、GitHubはその履歴を使った議論・レビュー・検査をまとめます。履歴を置くこと、一般へ公開すること、変更を承認することを分けて学びます。

この教材で学ぶこと

GitとGitHubの役割を分け、公開範囲・ブランチ・PR・権限の関係を説明できる。

先に知っておくこと

コミットは変更の記録、ブランチは履歴上の位置を指す名前です。前のGit教材のSQL変更を使いますが、このページでも意味を確認できます。

GitとGitHubは、どこで役割が分かれる?

手元の履歴と、GitHubでの共同作業
LOCAL
手元のGit

作業ファイル、ステージ、コミットとブランチを扱う。

HOST
GitHubのリポジトリ

プロジェクトの履歴を共有する場所。公開範囲と権限を決める。

PROPOSE
Pull Request

変更を取り込む提案を作り、差分と議論をまとめる。

DECIDE
レビューと検査

人の判断と自動検査を見て、取り込みを検討する。

履歴の共有と、変更を承認する判断は別です。GitHubのリポジトリがあるだけで、変更が本番へ配信されるわけではありません。

リポジトリは、ファイルとその変更履歴を管理する単位です。架空のdemo-acme/report-infraなら、demo-acmeが所有者、report-infraがリポジトリ名です。GitHubには履歴に加え、変更の議論や作業の管理を支援する機能があります。

公開範囲と、操作を許す権限を分ける

最初に確認する二つの判断
判断確認すること
誰に見せるかpublicは広く閲覧可能。privateは許可された範囲。利用可能な公開範囲は契約等にもよる。
誰が何をできるか閲覧、更新、管理、レビュー等の権限と保護ルールを確認する。

privateは公開範囲の設定で、変更コードの安全判定ではありません。 読める共同作業者にも誤りや悪意はあり得ます。秘密をファイルへ書いてコミットすると、閲覧者や過去の履歴、複製から漏れる可能性があります。機密値をcommitしないことと、実行時の権限を絞ることを両方考えます。

ブランチの変更を、PRで提案する

mainが変更前Bを指し、feature/jp-report-filterが提案Hを指す例です。Hでは、承認済みレポートの読取り条件へregion = JPを加えます。ブランチへ変更を記録したことと、mainへ取り込んだことは別です。B・Hは説明用の名前です。

PR #42は、その変更をmainへ取り込んでよいか相談する架空の提案です。Files changedで差分、Conversationで説明と議論、Commitsで提案の履歴、Checksで検査を確認します。R-BというUSの承認済み行が外れるなら、「それは要件どおりか」がレビューの質問になります。

レビューを提出するときの主な判断
判断意味
Comment意見や質問を残す。承認や修正要求とは区別する。
Approve変更の取り込みを支持する。実際のマージや配信とは別。
Request changes取り込む前に対応してほしい変更を示す。

検査の成功は、人が要件へ合うと判断したことと同じではありません。取り込みが可能かは、現在の差分・必要な承認・必須検査・権限・例外設定を合わせて確認します。PRを開いただけで、承認やマージが済むわけではありません。

他者の変更を読むことと、実行すること

forkは、元のリポジトリと履歴を共有する別のリポジトリです。そこから変更を提案する開発方法もあります。GitHub上で読めるソースでも、未審査のコードやworkflowを強い権限で動かしてよいとは限りません。

  1. SQLや設定ファイルだけでなく、workflow・依存・実行先の変更も読む。
  2. secretやtokenを誰に渡し、runnerがどこへ接続できるかを確認する。
  3. 公開範囲の設定と、レビュー済み・検査済み・配信済みという状態を別に扱う。

GitHubの役割を確かめる

選択すると、正誤と理由が表示されます。

GitとGitHubの関係として適切なのは?
答えと理由を読む

正解:Gitは履歴管理、GitHubはその共有や共同作業を支援するサービス。 · ローカルの履歴と、ホスト側のPRやレビューを分けて考えます。

privateリポジトリなら、どの判断が必要?
答えと理由を読む

正解:閲覧できる人と、変更コードを実行させる権限を別に決める。 · 公開範囲と、runnerや認証情報を扱う信頼境界は別です。

PRが開かれた時点で、確実に成立するのは?
答えと理由を読む

正解:変更を取り込む提案が作られた。 · 承認・検査・取り込み・配信は、さらに確認する状態です。

すべてのprivateリポジトリで必須レビューが使える、と決めてよい?
答えと理由を読む

正解:いいえ。プラン・公開範囲・保護ルールを確認する。 · 機能が存在することと、対象ブランチで必須なことは異なります。

確認して、自分の言葉で説明する

  1. ローカルGitとGitHubの仕事を一つずつ説明する。
  2. privateと、変更を実行してよいという判断を分ける。
  3. PRの提案・承認・マージを、別の状態として読む。
理解を確かめる: privateリポジトリのPRなら、未審査のコードへ配信権限を渡してよい?

いいえ。公開範囲と実行コードの信頼を別に判断します。

privateは閲覧の範囲です。runnerや認証情報へアクセスさせるかは、変更内容と処理の権限で判断します。

出典と確認した条件

説明に用いた一次資料を、確認した内容・条件と本文の参照箇所に分けてまとめています。専門家による監修・実環境での検証は行っていません。