バージョン管理

バージョン管理ツールは、コードベースのバックアップや共同作業を行うために、現行のワークフローに不可欠な要素です。このモジュールでは、Git と GitHub を使用してバージョン管理の要点を案内します。

概要

VCS は本質的に、ソフトウェア開発のためのものです。

  • 完全に自分一人でプロジェクトに取り組むことは稀で、他の人と一緒に作業を始めるとすぐに、二人が同時に同じコードを更新しようとする場合、互いの作業が衝突する危険性が出てきます。このような事態を回避するためには、何らかの仕組みを用意しておく必要があり、それが結果的に仕事のロスを避けるのに役立ちます。
  • 一人で、あるいは他の人と一緒にプロジェクトを進める際には、コンピューターが壊れてもコードが失われないように、中央にバックアップできるようにしておきたいものです。
  • また、後で問題が発見された場合には、以前のバージョンにロールバックできるようにしておきたいものです。同じファイルの異なるバージョン、例えば myCode.js, myCode_v2.js, myCode_v3.js, myCode_final.js, myCode_really_really_final.js のようなものを作成して、自分の仕事でこれを始めているかもしれませんが、これは実にエラーが起こりやすく、信頼性に欠けます。
  • チームのメンバーは、それぞれ別のバージョンのコード (Git ではブランチと呼びます) を作成し、そのバージョンで新機能の開発を行い、作業が終わったら制御された方法 (GitHub ではプルリクエストを使用します) でマスターバージョンにマージしたいと考えるのが一般的です。

VCS は、上記のニーズを満たすツールを提供します。 Git は VCS の一例であり、 GitHub は Git サーバーに加えて、コードの問題点の報告、レビューツール、タスクの割り当てやタスクの状態管理などのプロジェクト管理機能など、個人やチームで git リポジトリーを扱うための実に便利なツールを提供するウェブサイト＋インフラです。

メモ: Git は実際には分散バージョン管理システムです。つまり、コードベースを含むリポジトリーの完全なコピーが、自分のコンピューター (そして他の全員のコンピューター) に作られます。自分のコピーに変更を加え、その変更をサーバーにプッシュします。サーバーでは、管理者があなたの変更をマスターコピーにマージするかどうかを決定します。

前提条件

Git と GitHub を使用するには、以下のものが必要です。

  • Git がインストールされたデスクトップコンピューター (Git のダウンロードページを参照)。
  • Git を使うためのツール。仕事のやり方によっては、 Git の GUI クライアント (GitHub Desktop、SourceTree、Git Kraken などがお勧めです) を使うこともできますし、端末ウィンドウを使うこともできます。実際、 GUI を使うにしても、 Git の端末コマンドの基本だけは覚えておいたほうが役立つでしょう。
  • GitHub アカウント。まだお持ちでない場合は、このリンクからサインアップしてください。

前提知識としては、このモジュールを始めるにあたり、ウェブ開発、Git/GitHub、VCS について何も知らなくても構いません。しかし、適度なコンピューターリテラシーを持ち、リポジトリーに保存するためのコードがあるように、いくらかのコーディングの知識を持つことをお勧めします。

また、ディレクトリー間の移動、ファイルの作成、システムの PATH の変更など、基本的な端末の知識があることが望ましいです。

メモ: GitHub が Git で使えるサイトやツールセットとして唯一のものではありません。 GitLab のような他のツールもありますし、自分で Git サーバーを立ち上げて GitHub の代わりに使うこともできます。このコースでは、 GitHub を使った方法だけを紹介しています。

学習成果

  • バージョン管理システムが必要な理由。
  • Git と GitHub や GitLab のようなウェブサイトとの違い。
  • GitHub や GitLab などのウェブサイトは、 Git だけでは簡単ではないチームワークやコラボレーションを可能にすること。
  • 基本的なセットアップ — git のインストール、選んだソーシャルコーディングサイトの登録。
  • SSH/GPG 鍵などのセキュリティ要件を処理すること。
  • リポジトリーを作成し、変更をプッシュすること。
  • 他人のリポジトリーに貢献すること。フォーク、新しいブランチの作成、PRの作成、レビューフロー。
  • 良き保守作業:
    • リモートのリポジトリーと同期するように、ローカルのリポジトリーを定期的に更新すること。
    • .gitignore を使用して、コミットしたくないものをすべて無視すること。
    • 完了したブランチを削除すること。
  • マージの競合の処理。

ガイド

以下のリンクは、外部サイトのリソースに移動しますのでご注意ください。最終的には、 Git/GitHub に特化した独自のコースを設けることを目指していますが、現時点では、これらのサイトがこの主題を把握するのに役立つでしょう。

Hello, World (GitHub より)

始めるのによいところです。 — リポジトリーやブランチの作成、コミットの作成、プルリクエストの作成とマージなど、 Git の基本を学びながら、 GitHub をすぐに使い始めることができる実用的なガイドとなっています。

Git について（GitHub より）

この Git ハンドブックでは、 VCS とは何か、リポジトリーとは何か、 GitHub の基本モデルはどうなっているのか、 Git コマンドとその例など、もう少し深く掘り下げて説明しています。

プロジェクトのフォーク（GitHub より）

誰かのコードに協力したいときには、プロジェクトをフォークすることが不可欠です。このガイドでは、その方法を説明します。

pull requests について（GitHub より）

提案されたコードの変更を、他の人のリポジトリーに配信して検討してもらう方法であるプルリクエストを管理す津ための有益なガイドです。

Issue について（GitHub より）

課題 (issue) とは、 GitHub プロジェクトのフォーラムのようなものです。質問をしたり問題を報告したりすることができ、そこで更新を管理することができます (たとえば、問題を修正する人を割り当てたり、問題を明確にしたり、問題が修正されたことを人々に知らせたりすることができます)。この記事では、課題について知っておくべきことを説明します。

メモ: Git や GitHub でできることは他にもたくさんありますが、以上のことは Git を効果的に使い始めるために最低限知っておくべきことだと思います。 Git の理解が深まるにつれ、より複雑なコマンドを使い始めると簡単に間違えてしまうことに気づくでしょう。心配しないでください。プロのウェブ開発者であっても、 Git が分かりにくいと感じることがあり、ウェブ上で解決策を探したり、 Flight rules for Git や Dangit, git! のようなサイトを参考にして問題を解決することがよくあります。

関連情報