「非エンジニア Git 使い方」で検索したらコマンドラインの説明をされたので、勢いで書いてみた。
Gitと書いてありますが、その他のバージョン管理ツールでも出来る内容になっています。
対象者
- 非エンジニア
- Excelなどのツールは使える
- ファイルの更新履歴ページを作成したことがある
- ファイル名に○○ver1.1.xlsとか○○20150203.pptとかつけたことがある
- 過去のファイルをoldフォルダに入れたことがある
- 近くでGitを使っているエンジニアがいる
バージョン管理ツールとは
質問です。どれが最新版でどれを使えばいいでしょう?
・・・わかりません!
他にもこういうことを経験したことありませんか?
- 以前使っていたテストユーザデータがどれか調べたい
- 誰がこのファイルを変更したのか知りたい
- このファイルどこが変わったのか比較したい
- x日前のファイルに戻したい
それバージョン管理ツールで全部出来ますよ!
バージョン管理ツールとは編集されるファイルの変更履歴を管理するためのツールです。SVN/Subversion/Gitなどがそれにあたります。
GitとGitHubを使ってみる
習うより慣れろ。いきなりですが、GitとGitHub 1を使ってみます。
GitHubでは、ファイルは全ユーザから見ることができるようになっています。
もし、このアップロードするファイルを見られたくない!という場合、GitHubの有料サービスを使うか、Bitbucket 2のようなプライベートリポジトリ 3 4が作れるサービスを利用して下さい。
2019年からGitHubは無料でプライベートリポジトリ 3 4が利用できるようになりました。全ユーザから見られたくないファイルをGitHubで管理したい場合、プライベートリポジトリを利用して下さい。
もちろん、Bitbucket 2のようなサービスでも引き続き、プライベートリポジトリが利用可能です。
https://github.blog/2019-01-07-new-year-new-github/
最初にGitHubのアカウントを取得して下さい。取得方法は省略します。わからない場合は「github アカウント 登録」で検索して、作成して下さい。
取得したアカウントでリモートリポジトリ 5を作成します。右側にある、「New repository」ボタンをクリックします。
リポジトリ名とその説明を指定します。
今回は名前を「how-to-git」、説明文を「Gitの使い方の練習」とします。
「Create repository」ボタンをクリックします。
色々わからない言葉が書いてある画面に遷移すると思いますが、これでGitHub上にリポジトリ作成が完了しました。
このリポジトリにファイルをアップロードして、バージョン管理をしていきたいと思います。
SourceTreeを使ってローカルリポジトリを作成してみる
GitHubに作成したリモートリポジトリをローカルリポジトリ 6にダウンロードします。
SourceTree 7はMac/Windowsで使えるGitを扱うことができるツールの一つです。
このリンクからダウンロード+インストールしてみて下さい。
(30日間のトライアルの後、メールアドレスなどの登録を促されますが、無料で使い続けられます。)
無事にインストールが完了し、立ち上げるとウインドウが出てきます。
「リモート」ボタンをクリックします。
SourceTreeではデフォルトでいくつかのリポジトリのウェブサービスが利用できます。
「Connect a remote account」ボタンをクリックし、先ほど作成したGitHubアカウントを接続してみます。
出てきたポップアップウインドウに以下の情報を入力し、「OK」ボタンをクリックします。
項目 | 入力内容 |
---|---|
ホスト | GitHub |
ユーザ名 | GitHubのユーザ名 |
パスワード | GitHubのパスワード |
プロトコル | HTTPS |
GitHubにあるリポジトリの一覧が出てきます。
how-to-gitの横にある「クローン」をクリックします。
「クローン」とはGitのコマンドの一つで、リモートリポジトリのファイルを丸ごと複製し、ローカル環境へダウンロードすることです。
ポップアップウインドにリモートリポジトリの情報を入力します。
項目 | 入力内容 |
---|---|
ソースURL | https://{GitHubのユーザ名}@github.com/{GitHubのユーザ名}/how-to-git.git |
保存先のパス(Macの場合) | /Users/{Macのユーザ名}/how-to-git/ |
名前 | how-to-git |
{GitHubのユーザ名}と{Macのユーザ名}はあなたのユーザ名です。この画像は私のユーザ名、「shiraji」になっています。
入力が完了したら、「クローン」ボタンをクリックします。
リモートリポジトリをローカルにダウンロード(クローン)することが出来ました。
「Finderで開く」ボタンをクリックしてみて下さい。/Users/{Macのユーザ名}/how-to-gitという空のフォルダが確認できるはずです。
これでローカルリポジトリの準備が完了しました。
ファイルをローカルリポジトリに追加する。
ローカルリポジトリの準備が出来ました。次にローカルリポジトリにファイルを追加してみます。
テキストエディット(Windowsはメモ帳)を立ち上げて下さい。
「テキストファイルを作成します。」
と入力します。
テキストエディットのデフォルト設定だと「.rtf」ファイルになってしまうので、「フォーマット」 > 「標準テキストにする」を選択して下さい。
このファイルをhow-to-gitフォルダ内に保存します。
ファイル名は「textfile.txt」とします。
SourceTreeを見てみます。
textfile.txtが「作業ツリーのファイル」の項目内に出来ました。
「textfile.txtを追加した」ことをGitに伝え、ローカルリポジトリにtextfile.txtを追加しようと思います。
textfile.txtを右クリックし、「Indexに追加」を選択します。
textfile.txtが「Indexにステージしたファイル」の項目に移動しました。
次に、上にある「コミット」ボタンをクリックします。
下のテキストエリアにフォーカスされるので、「textfileを追加しました。」と入力し、「コミット」ボタンをクリックします。
「コミット」とはIndexにステージした全ファイルの追加・変更・削除を確定させることです。
今回はtextfile.txtを追加したことを確定させたことになります。
左上にある、時計のボタンをクリックします。
ローカルリポジトリにコミットした履歴が表示されました。
ファイルをリモートリポジトリに追加してみる
ファイルをローカルリポジトリに追加することができました。
このファイルをGitHubにアップロードしリモートリポジトリに追加してみようと思います。
SourceTreeの右上にある「プッシュ」ボタンをクリックするとプッシュに必要な情報の入力を求められます。
項目 | 入力内容 |
---|---|
プッシュ先のリポジトリ | origin |
プッシュするブランチ | masterをチェックする |
「OK」ボタンを押すとプッシュされます。
(初めての場合、Keychainへのアクセスを求められますので、許可して下さい。)
プッシュとはローカルリポジトリに加えたコミットをリモートリポジトリに反映させることです。
ブランチは説明を省略します。ここではmasterというブランチがあるのだということだけ知っていれば問題ありません。
プッシュが出来たかどうかGitHubで確認してみます。
textfile.txtをリモートリポジトリに追加することに成功しました。
ファイルを変更してみる
ファイルの追加が完了したので、次にファイルを変更してみます。
/Users/{Macのユーザ名}/how-to-git/フォルダにある、textfile.txtを開きます。
ファイルの内容を「テキストファイルを変更します。」に変更し、保存します。
SourceTreeを見てみます。
一番右側のカラムに変更した内容が記載されています。
- 赤色の背景の行が削除された行
- 緑色の背景の行が追加された行
「テキストファイルを作成します。」の行が削除され、「テキストファイルを変更します。」が追加されたことがわかります。
ローカルリポジトリにファイルが変更されたことを登録するため、textfile.txtを先ほどと同じようにコミットします。
コミットメッセージには「textfileを変更しました。」と入力します。コミット後にプッシュもして下さい。
GitHubを見てみると「2 commits」になっています。
この「2 commits」をクリックしてみます。
最初に行ったファイルの追加と今行ったファイルの変更を行った履歴が出来ました。
ファイルを追加した時ってなんという内容で追加したのか確認したくなった場合、この履歴から遡ることが可能になります。
ファイルを元に戻してみる
もう一度textfile.txtを開いて、今度は「このメッセージは後で消えます。」と書き換えます。
ファイルを保存し、テキストエディットを閉じます。
・・・
やっぱりさっきの内容のほうが良かった!戻そう!!!・・・あれ?もうテキストエディット閉じちゃってるから戻せなくない???・・・まずい・・・。
なんてことがあっても大丈夫!Gitで元に戻してしまいましょう!
SourceTreeを開きます。
案の定、textfile.txtに変更が入っていることになっています。
「リセット」ボタンをクリックします。
(時々ですが、このボタンが押せない場合があります。その時はSourceTreeを再起動してみて下さい。謎です。。。)
変更を破棄するためのwindowが開きます。
textfile.txtを選択し、「変更内容を破棄」ボタンをクリックします。
もう一度、テキストエディットでtextfile.txtを開いてみましょう。
無事元に戻せました!
GitHub上でファイルを変更してみる
ファイルの編集は、実はGitHub上でも可能です。
textfile.txtをクリックして下さい。
右側にある、ペンのアイコンをクリックして下さい。
このページでファイルの編集を行うことができます。
ファイルの中身を「GitHub上でファイルを変更します。」とし、下のほうにある、Commit changesにコミットメッセージ「GitHub上でファイルを変更しました。」と入力します。
その後、「Commit changes」ボタンをクリックするとGitHub上でファイルの変更が完了します。
ローカルリポジトリにリモートリポジトリを同期させてみる
リモートリポジトリにファイルの変更を加えましたが、ローカルリポジトリではファイルの変更を加えていません。
SourceTreeを見てみます。
3つ目のGitHubのコミットが存在していません。
ローカルリポジトリとリモートリポジトリの状態がバラバラだとプッシュ出来なくなります。
そこで、ローカルリポジトリにリモートリポジトリの状態を同期(プル)させます。
右上にある、「プル」をクリックします。
何も変更せずに、「OK」ボタンをクリックします。
変更が同期されました。
実際にローカルにある、textfile.txtを開いてみると、反映されたようです。
pdfファイルを管理してみる
テキストファイルの管理が出来ました。では非エンジニア職がよく使うであろうxlsやpdfファイルの管理もGitにさせてみます。
テキストエディットを開き、「ファイル」 > 「新規」をクリックし、「pdfファイルを追加してみる。」と入力します。
テキストエディットの「ファイル」 > 「PDFとして書き出す...」をクリックし、how-to-gitフォルダ内に、「pdffile.pdf」として保存して下さい。
Windowsの場合は、エクセルを開き、「pdfファイルを追加してみる。」とA1に入力し、「PDFとして書き出す」でいけるはずです。
SourceTreeを開きます。
pdffile.pdfが追加されたことになっていますので、先ほどと同じようにコミットし、プッシュします。
コミットメッセージは「pdfファイルの追加しました。」とします。
GitHubでコミットの履歴を見てみます。
しっかりとプッシュされています。2回目のコミットである「textfileを変更しました。」をクリックしてみます。
実際にこのコミットで変更した点が記載されています。
デフォルトでこの表記になっていないかもしれません。その場合、「Unified」から「Split」にするとこの表記になります。
(個人的で申し訳ないのですが、わかりやすいので、Splitを使っています。)
一つ前のコミット履歴の画面で、今度は「pdfファイルの追加しました。」をクリックします。
ここには変更点が記載されていません。その代わり、「Binary file not shown」と記載されています。
バージョン管理の問題点の一つにバイナリファイル 8の変更点が確認できないというものがあります。
もし、pdfやxlsをGitで管理するのであれば、コミットメッセージにどんな変更を加えたファイルなのかをはっきり記載すべきです。
それ以外の機能、ファイルを保存したり、特定のコミットまで戻すことはバイナリファイルでも可能です。
GitHubは一つのファイルの最大容量が100MBなので、その点にも注意が必要です。
まとめ
今回行ったことをリストしてみます。
- GitHubにリモートリポジトリを作成しました。
- SourceTreeを使い、リモートリポジトリからローカルリポジトリを作成しました。(クローン)
- ファイルを追加し、ローカルリポジトリに登録しました。(コミット)
- ローカルリポジトリの変更をリモートリポジトリに登録しました。(プッシュ)
- ローカルリポジトリのファイルを直前のコミットの状態に戻しました。(リセット)
- リモートリポジトリの状態をローカルリポジトリに同期しました。(プル)
これらはバージョン管理の基本的な動作です。また、今回やってみたのは一人でのバージョン管理になります。
まずは一人で触ってみて、Gitって便利なのだよと感じてくれたら良いなと思って記事を書いています。
複数人が同じリポジトリで仕事をする場合同じファイルを編集して、競合状態(コンフリクト)に陥ることもあります。
気分が乗ったらブランチやコンフリクト、マージなどの説明を書こうと思います。
Gitを使っていて、わからなくなったら近くにいるエンジニアにわからないから教えて欲しいと伝えて下さい。
(コーヒー飲んでるときとか、トイレから帰ってくるときとかに聞くのがベストです。)
コマンドラインじゃないGitなんてわからねwとか言ったら
「え?まだコマンドラインで消耗してるの?」
と驚いてあげて下さい。きっとムキになって解決してくれます。
追記
この記事を書いた後にGitHubが公式で出したGitHub DesktopもWindowsで利用可能です。
バージョン管理という点ではSourceTreeでもGitHub Desktopでも同じです。
注釈
-
GitHub。Gitのwebサービス。オンライン上でファイルのバージョン管理ができる。無料。 ↩
-
bitbucket。Gitのwebサービス。GitHub同様オンライン上でバージョン管理ができる。全リポジトリがプライベートリポジトリ。無料。 ↩ ↩2
-
プライベートリポジトリ。ネットワーク上のどこかに存在し、特定のユーザからしか閲覧することができないリポジトリ。 ↩ ↩2
-
リモートリポジトリ。ネットワーク上のどこかに存在するリポジトリ。 ↩
-
今起動しているPC上に存在するリポジトリ。 ↩
-
SourceTree。Mac/Windowsで使えるGitを扱うことができるツールの一つ。 ↩
-
バイナリファイル。画像やxls、pdfなど文字列以外で構成されたファイル。メモ帳で開いて読むことができないファイルのこと。 ↩