自分のパソコンで作ってきたプロジェクトを、あとから GitHub に上げて管理を始める手順です。GitHub のサイトでリポジトリを作らなくても、VS Code の中だけで最後まで進められます。
Git for Windows と名前・メールアドレスの設定がまだのときは、先に「WindowsでGitを使うための初期設定と基本操作」を済ませておきます。GitHub にすでにあるリポジトリを手元に取り込むときは、「GitHubにあるリポジトリを取り込んで開発を始める手順」をご覧ください。
ステップ1：リポジトリを初期化する
VS Code でプロジェクトのフォルダーを開き、Ctrl + Shift + G で「ソース管理」を開いて、「リポジトリを初期化する」をクリックします。このフォルダーが Git で管理されるようになります。
ステップ2：.gitignore で記録しないものを決める
最初のコミットの前に、これだけは必ずやっておきます。そのまま全部のファイルを記録すると、次のようなものまで GitHub に上がってしまいます。
- パスワードなどの秘密の情報：
Laravel の.envには、データベースのパスワードや API のキーが入っています - あとから入れ直せる大量のファイル：
vendor（Composer）やnode_modules（npm）など
プロジェクトのいちばん上のフォルダーに .gitignore という名前のファイルを作り、記録しないものを書きます。
# 秘密の情報
.env
# あとから入れ直せるもの
/vendor
/node_modules
# OS が作るファイル
Thumbs.db
.DS_StoreLaravel を composer create-project で作った場合は、最初から .gitignore が入っています。その中に .env と /vendor があるかだけ確かめます。
.gitignore を保存すると、「ソース管理」の「変更」の一覧から、書いたファイルやフォルダーが消えます。次に進む前に、一覧に .env がないことを必ず確かめてください。
ステップ3：最初のコミットをする
「変更」の右にある「＋」をクリックして、すべてのファイルを記録する対象にします。
上の欄に内容（例：最初のコミット）を入れて、「コミット」をクリックします。
コミットができると、青い「Branch の発行」ボタンが出ます。
ステップ4：GitHub に公開する
「Branch の発行」をクリックすると、画面のいちばん上に公開範囲を選ぶ欄が出ます。
| 選ぶもの | 意味 |
|---|---|
| GitHub のプライベートリポジトリに公開 | 自分と、招待した人だけが見られる |
| GitHub のパブリックリポジトリに公開 | インターネット上の誰でも見られる |
迷ったら、まずプライベートを選びます。プライベートからパブリックへは、あとから GitHub の設定で変えられます。リポジトリ名は、最初はフォルダー名になっていて、この欄で変えられます。
初めてのときはブラウザが開き、GitHub へのサインインと許可を求められるので、許可します。終わると、GitHub にリポジトリが作られ、これまでのファイルとコミットが送られます。右下に出る通知から GitHub のページを開いて、中身と公開範囲を確かめておきます。
もし .env を上げてしまったら
一度コミットしたファイルは、あとから消しても履歴に残ります。パブリックで公開してしまったときは、まずそのパスワードや API のキーを変えて、使えないようにします。そのうえで .gitignore に足し、リポジトリをプライベートにするか、作り直します。
2回目からの操作
公開したあとは、「ソース管理」で変更を確かめてコミットし、「変更の同期」で GitHub に送ります。ほかのパソコンでも編集しているときは、作業の前に「変更の同期」で最新の状態を取り込みます。それぞれの操作は「WindowsでGitを使うための初期設定と基本操作」の表にまとめています。
まとめ
- 「ソース管理」の「リポジトリを初期化する」で始める
- 最初のコミットの前に
.gitignoreを作り、.envやvendor・node_modulesを外す。一覧に.envがないことを確かめる - 「＋」で選んでコミットし、「Branch の発行」で GitHub に公開する
- 迷ったらプライベート。パスワードを公開してしまったら、まずパスワードを変える
コメント