devkuma – Git

Git

kc@example.com (kc kim) — Sun, 13 Aug 2017 19:04:43 +0900

Git

Git の概要

kc@example.com (kc kim) — Sun, 13 Aug 2017 19:04:43 +0900

Git について説明する。

Git の紹介

kc@example.com (kc kim) — Sun, 13 Aug 2017 19:04:43 +0900

Git とは何か

Git は、従来のバージョン管理ツールとは異なる考え方を持つファイルバージョン管理ツールである。

従来のバージョン管理ツールは中央集中方式で、自分専用のリポジトリがないため、作業内容を保存または更新するには必ず社内サーバーへ接続する必要があった。そのため、長期出張中やノート PC で行った作業内容に対して、別途バージョンを付与することが難しかった。

しかし Git のようなツールが登場したことで、自分のハードディスク上にリポジトリを作成し、社内またはプロジェクト全体のリポジトリへ自分の作業内容を追加、補完、修正する作業を非常に便利に行えるようになった。

Git 関連サイト

参考になるサイト

誰でも簡単に理解できる Git 入門

Git の基本

kc@example.com (kc kim) — Sun, 13 Aug 2017 19:04:43 +0900

この Git 基本チュートリアルでは、Git の重要なコマンドを簡潔に説明する。最初にリポジトリを設定するセクションでは、バージョン管理を始める新しいプロジェクトに必要な各種コマンドを説明する。残りのセクションでは、日常的に使用する Git コマンドを紹介する。

このチュートリアルを終えると、Git リポジトリの作成、プロジェクトスナップショットの安全な保存、プロジェクト履歴の閲覧ができるようになる。

Git 演習: 基本編

Git 基本コマンド

kc@example.com (kc kim) — Sun, 13 Aug 2017 19:04:43 +0900

git push

ローカルコミットをリモートリポジトリへ反映する。

git checkout

作業ツリーで変更されたファイルを、index にある内容へ戻す。

git checkout [ファイル]

作業ツリーで変更されたファイルを、HEAD にある内容へ戻す。

git checkout HEAD (ファイル名: 省略可能)

作業ツリーで変更されたファイルの内容を、FETCH_HEAD にある内容へ戻す。

git checkout FETCH_HEAD (ファイル名: 省略可能)

git commit

現在 index 領域にある変更内容を commit 領域へ登録する。

git commit -m "コメント"

index に登録されていない変更内容もすべて commit 領域へ登録する。

git commit -a -m "コメント"

Git の基本 | git init

kc@example.com (kc kim) — Sun, 13 Aug 2017 19:04:43 +0900

git init コマンド

git init は、新しい Git リポジトリを作成するコマンドである。このコマンドは、まだバージョン管理されていない既存プロジェクトを Git リポジトリへ変換する場合や、新しい空のリポジトリを作成して初期化する場合に使用する。このコマンド以外のほとんどの Git コマンドは、初期化済みリポジトリ以外では使用できないため、新しいプロジェクトを始めるときに通常最初に実行するコマンドである。

git init コマンドを実行すると、リポジトリに関するすべてのメタデータを持つ .git サブディレクトリがプロジェクトのルートに作成される。この .git ディレクトリの作成を除けば、既存プロジェクトには何も変更を加えない。SVN とは異なり、Git は各サブディレクトリに .git フォルダを作成しない。

使い方

git init

現在のディレクトリを Git リポジトリへ変換する。このコマンドを実行すると、現在のディレクトリに .git フォルダが作成され、プロジェクトのバージョン管理を開始できる。

git init <directory>

指定したディレクトリに空の Git リポジトリを作成する。このコマンドを実行すると、.git サブディレクトリを含む <directory> という名前の新しいフォルダが作成される。

git init --bare <directory>

作業ディレクトリを持たない Git リポジトリを作成して初期化する。共有リポジトリは必ず --bare フラグを指定して作成する必要がある。以下の補足説明を参照。--bare フラグを指定して作成したリポジトリディレクトリ名には、自動的に .git が追加される。たとえば、my-project という名前のリポジトリのベア版は my-project.git という名前のフォルダに保存される。

補足説明

SVN と比較すると、git init は新しいバージョン管理プロジェクトを作成するための非常に簡単な方法を提供するコマンドである。Git では、手動でリポジトリフォルダを作成したり、ファイルをインポートしたり、作業コピーをチェックアウトしたりする必要はない。プロジェクトフォルダで git init を実行するだけで、完全な機能を持つ Git リポジトリを作成できる。

ただし、ほとんどのプロジェクトでは、git init コマンドは中央リポジトリを作成するときに一度だけ使用される。それぞれの開発者がローカルリポジトリ、つまり中央リポジトリの作業コピーを作成するときには、通常 git init は使用しない。開発者は一般的に git clone コマンドを使って、既存リポジトリのコピーをローカルマシンに作成する。

ベアリポジトリ

--bare フラグを指定すると、作業ディレクトリを持たないリポジトリが作成され、そのリポジトリ内でファイルを編集したり変更を適用したりできない。ベアリポジトリではないリポジトリへブランチをプッシュすると、変更内容が誤って記録される可能性があるため、中央リポジトリは必ずベアリポジトリとして作成する必要がある。--bare の指定は、そのリポジトリを開発環境ではなく保存用領域として認識させる方法だと考えればよい。つまり、実質的にすべての Git ワークフローで中央リポジトリはベアリポジトリであり、開発者のローカルリポジトリはベアリポジトリではない。

Git チュートリアル: ベアリポジトリ

使用例

中央リポジトリの作業コピーを作成するには git clone コマンドの方が便利であるため、git init コマンドの一般的な使用例は、主に最初の中央リポジトリを作成するときである:

ssh @
cd path / above / repo
git init --bare my-project.git

まず SSH 通信で中央リポジトリを作成するサーバーへログインする。
次に、プロジェクトを保存するディレクトリへ移動する。
最後に、--bare フラグを指定して中央リポジトリを作成する。
その後、開発者は clone my-project.git コマンドを使って、自分の開発環境に作業コピーを作成する。

Git の変更を取り消す

kc@example.com (kc kim) — Sun, 13 Aug 2017 19:04:43 +0900

このチュートリアルでは、ソフトウェア開発プロジェクトの過去のバージョンを扱うときに必要な技術を学ぶ。最初に過去の履歴からコミットを探す方法を示し、公開リポジトリに公開済みのコミットを取り消す場合と、ローカルマシンにだけ存在するコミットを取り消す場合の違いを説明する。

Git チュートリアル: 変更の取り消し

Git の基本 | git clone

kc@example.com (kc kim) — Sun, 13 Aug 2017 19:04:43 +0900

git clone コマンド

git clone は、既存の Git リポジトリのコピーを作成するコマンドである。このコマンドは svn checkout に似ているが、作業コピー自体が完全な Git リポジトリを構成し、変更履歴を自分自身で持ち、自分のファイルを管理し、元のリポジトリとは完全に独立した環境を提供する点が異なる。

利用者の便宜のため、clone すると元のリポジトリを指す origin という名前のリモート接続が自動的に作成される。これにより、中央リポジトリと非常に簡単に通信できる。

使い方

git clone <repo>

<repo> にあるリポジトリをローカルマシンへ複製するコマンドである。<repo> のリポジトリは同じローカルマシン上に存在してもよく、HTTP または SSH を使ってアクセスするリモートマシン上に存在してもよい。

git clone <repo> <directory>

<repo> にあるリポジトリを、ローカルマシン上の <directory> という名前のフォルダへ複製するコマンドである。

補足説明

中央リポジトリがすでに作成されている場合、git clone は開発者の作業コピーを作成するもっとも一般的なコマンドである。git init コマンドと同じく、clone も通常は一度だけ行う作業であり、開発者が作業コピー、つまりローカルリポジトリを作成した後は、そのローカルリポジトリを通じてすべてのバージョン管理と共同作業を行う。

リポジトリ間の共同作業

Git における「作業コピー」は、SVN リポジトリからコードをチェックアウトして得られる作業コピーとは大きく異なる概念であることを理解する必要がある。SVN とは異なり、Git では作業コピーと中央リポジトリの間に実質的な違いはなく、どちらも完全な Git リポジトリである。

これにより、Git の共同作業と SVN の共同作業は根本的に異なる。SVN では中央リポジトリと作業コピーの関係が重要な役割を持つが、Git の協力モデルはリポジトリ間の相互作用である。SVN は作業コピーを中央リポジトリへチェックインするのに対し、Git はあるリポジトリから別のリポジトリへコミットをプッシュまたはプルする。

Git チュートリアル: リポジトリ間の共同作業

当然のことながら、所有している Git リポジトリに特別な意味を与えることもできる。たとえば、Git リポジトリを「中央」リポジトリとして指定することで、Git でも集中型ワークフローを採用できる。重要なのは、それがバージョン管理システムや物理的な接続状態によって区別されるのではなく、Git では単なる約束として決まるという点である。

使用例

次の例は、アドレスが example.com で、使用する SSH ユーザー名が john の場合に、サーバーに保存された中央リポジトリの作業コピーを作成する方法を示す:

git clone ssh://john@example.com/path/to/my-project.git
cd my-project
# Start working on the project

1 行目は、ローカルマシンの my-project フォルダに新しい Git リポジトリを作成して初期化し、中央リポジトリからファイルを取得するコマンドである。
完了したら、現在のディレクトリをプロジェクトへ移動し、編集、スナップショットのコミット、他のリポジトリとの通信などの作業を開始する。
また、複製されたリポジトリには .git 拡張子が追加されない。これは、ローカルコピーがベアリポジトリではない状態であることを意味する。

Git ブランチ

kc@example.com (kc kim) — Sun, 13 Aug 2017 19:04:43 +0900

このチュートリアルでは、Git ブランチを包括的に紹介する。まず、プロジェクト履歴における新しい開発の流れとも言えるブランチ作成の概要を説明する。次に、ブランチを選択するときの git checkout コマンドの使い方を説明する。最後に、独立したブランチの履歴を統合するための git merge コマンドの使い方を学ぶ。

読み進めると、Git ブランチが SVN ブランチとは異なるものであることが理解できるはずである。SVN ブランチが作業成果をときどき大きく整理するために使われることが多いのに対し、Git ブランチは日常的なワークフローに欠かせない要素である。

Git チュートリアル: ブランチとマージ

Git の履歴を書き換える

kc@example.com (kc kim) — Sun, 13 Aug 2017 19:04:43 +0900

Git の主な目的は、コミット済みの変更を失わずに記録していくことである。しかし Git には、開発ワークフローを整え、作り替えるための機能もある。これらの機能には、プロジェクト履歴を明示的に書き換える機能も含まれるが、そのためにコミット情報を失う可能性も生じる。Git は履歴を書き換えるコマンドを、プロジェクト内容を失う可能性についての警告とともに提供している。

この章では、コミット済みスナップショットを書き換える必要が生じる一般的な理由を説明し、それを実行するときにミスを防ぐ方法を示す。

リモート Git リポジトリ

kc@example.com (kc kim) — Sun, 13 Aug 2017 19:04:43 +0900

SVN では、1 つの中央リポジトリを開発者間のコミュニケーションハブとして使用し、共同作業とは開発者の作業コピーと中央リポジトリの間で変更をやり取りする過程を意味する。Git の協力モデルはこれとは異なり、各開発者がリポジトリのコピーを持ち、その中にローカル履歴とブランチ構造を完全な形で保持している。開発者は他の開発者と個別の変更を共有する必要はなく、通常は一連の作業をまとめて共有する。中央リポジトリを変更する場合、Git は作業コピーの個別変更を中央リポジトリにコミットするのではなく、リポジトリ間でブランチ全体を共有する。

以下に示すコマンドを使うと、他のリポジトリとの接続を管理し、ブランチを他のリポジトリへプッシュして公開し、ブランチをローカルリポジトリへ取り込むことで他の開発者の進捗を確認できる。

Git の活用

kc@example.com (kc kim) — Thu, 25 Aug 2022 18:24:00 +0900

Git の活用方法について説明する。

GitHub

kc@example.com (kc kim) — Thu, 25 Aug 2022 18:24:00 +0900

GitHub の活用方法について説明する。

Git トラブルシューティング

kc@example.com (kc kim) — Thu, 22 Dec 2022 08:15:00 +0900