Git · GitHub
Git / GitHub
Gitとは?
- Git=コード変更の履歴管理
- GitHub=オンライン保管・協業
- やり直し・協業の基本
Gitを使い始めると、チームのファイル管理の習慣からまず変わります。「アプリ_最終.py」「アプリ_最終_本当の最終.py」のようにコピーを増やしていたやり方の代わりに、ファイルは一つにまとめ、変更履歴だけを下に積み上げていきます。誰がいつ、どの行を、なぜ直したのかがコミットメッセージとともに残るので、事故が起きても責めるのではなく記録を照会する問題として整理されます。一人で作ったコードを他の人に引き継ぐ際にも、履歴そのものが引き継ぎ資料になります。
GitとGitHubは一つの言葉のようにセットで語られますが、層が違います。Gitは自分のノートパソコンで動くプログラムで、GitHubはその結果物を上げておくサーバーです。同じ役割にGitLabやBitbucketを使う会社も多くあります。実務で必要な概念は4つです——コミット(保存地点)、ブランチ(本流を触らない作業用の枝)、プルリクエスト(統合前のレビュー依頼)、マージ(統合)。リポジトリは公開と非公開のどちらかを必ず選ぶ必要があり、ファイル1つあたり100MBの制限があります。また、Excelや画像のようなバイナリは変更点の比較ができないため、コードと設定ファイル中心に入れるほうが良いです。
AIでコードを作る場合、コミットの単位がそのまま実験の単位になります。一度に機能を5つ頼んでコミットを1回だけ残すと、どの依頼が問題を起こしたのか見分けられないため、依頼1件につきコミット1つを原則にするのが安全です。GitHubのリポジトリはデプロイサービスと直接つなげることもでき、コードを上げた瞬間に実際の画面が更新される仕組みも作れます。この場合は上げる行為がそのままデプロイになるため、検討なしに押し込まない習慣が必要です。
現場で最も多い事故は、APIキーやDBパスワードをコードに書いたままコミットし、公開リポジトリに上げてしまうことです。後でファイルから消しても、過去のコミットの中にはそのまま残っているため、履歴を数行さかのぼるだけで再び出てきます。二つ目の誤解は、「GitHubに上げたからバックアップは終わった」というものです。コミットだけしてpushしなければ、その記録はまだノートパソコンの中にしかなく、機器が壊れると一緒に消えます。三つ目は、コメントをすべて「修正」で埋める癖です。戻る地点を見つけられなければ、溜めておいた履歴もないのと同じです。
Gitは、Linuxを作ったリーナス・トーバルズ(Linus Torvalds)が2005年、Linuxカーネルの開発のために作りました。GitHubは2008年に登場し、世界最大のコード協業プラットフォームになりました。
仮想の事例で見てみましょう。従業員38名、年間売上約120億ウォン(約143,508万円)の産業用部品流通A社です。在庫担当のキム代理がバイブコーディングで「倉庫別在庫照会ウェブアプリ」を3週間ひとりで作っていましたが、デスクトップのコピーは27個まで増えていました。ある日、うまく動いていたバージョンを誤って上書きしてしまい、2日分の作業がまるごと消えました。
- 事故の翌日、キム代理がIT担当のパク次長に「AIがコードを丸ごと書き換えたら、元に戻す方法がありません」と打ち明けると、パク次長はノートパソコンにGitを入れ、1時間かけてコミットの残し方だけを教えました。
- キム代理は、画面が正常に動くたびに「倉庫別在庫リストの照会 正常」のような一文でコミットを残し、最初の1週間だけで保存地点が41個溜まりました。
- AIに「Excel書き出し機能を追加して」と頼んだら照会画面まで壊れたとき、コマンド2行で20分前のコミットに戻り、作業の損失がゼロになりました。
- GitHubに非公開リポジトリを作り、退勤前にpushすることにしたのですが、パク次長がコードに書かれていた倉庫DBの接続パスワードを先に見つけ、環境変数に移してから初めてアップロードしました。
- その後、営業チームのイ課長が合流してブランチを分けて作業するようになり、復旧に使っていた時間は週4時間から20分に減り、修正依頼の処理期間は平均5日から1日に短くなりました。
ク・ジャリョン
金鍾赫