はじめに
前回の記事から引き続き、用語の詳しい解説は省いて 「実際に使う」 ことにフォーカスを当てています。
個人で試せるようにしていますので、お気軽にお試しください。
前回の記事はこちら↓
この記事で分かること
- GitHub から情報を取得する方法
git pull origin main
- GitHub を活用した開発の流れ&お試し
- GitHub Flow
git branch
git checkout
- プルリクエスト
GitHub から情報を取得しよう!
チーム開発をしていくと、他の方もセーブデータを GitHub に送るため、自分のPC上にあるセーブデータと、GitHub 上にあるセーブデータが必ずしも一緒であるとは限りません。このようなとき、自分のPC上に GitHub にあるセーブデータを取り込む必要があります。
まずは実際に、GitHub 上にセーブデータを増やしてみましょう。
以前作成した GitHub の Repository には緑色のボタン「Add a README」があるので、それをクリックしましょう。
READMEの中身はいじらず、下の方にある「Commit new file」でメッセージ「README を追加」と書いて、緑色のボタン「Commit new file」をクリックしてください。
すると新しくセーブデータが追加されており、README ファイルが作成されています。
(このように、GitHub 上でも変更を加えることが出来ます)
ここまでの状況を整理すると以下の通りです。
- GitHub上で新しくREADMEファイルを作成した
- 自分のPC上にはREADMEファイルは存在しない
つまり、自分のPC上に GitHub のセーブデータを取り込み、README ファイルを手にする必要があります。なので、VSCode で以下のコマンドを実行してください。
git pull origin main
そうすると、自分のPC上に README ファイルが増えました。データの取得はこれだけです。
チーム開発の流れを知ろう!
チーム開発では、他の方も同様にコーディングしています。
そのため、以下のような流れで作業をすることがあります。(これが GitHub Flow というものです。興味あればこちらの記事もどうぞ:GitHub flowについて)
- あらかじめ自分で「ブランチ」を作成して作業を行い、
- 一通り完了したら GitHub に Push して、
- 「プルリクエスト」を出し、
- レビューをもらい、
- main ブランチに「マージ」
- 1~5を繰り返す
なんだか用語が多くなってきましたが、1つずつ見ていきましょう
ブランチ
ブランチを使用することで、作業を分離させ、他に影響を与えることなく作業することが出来ます。
以下のように枝分かれをするイメージです。
プルリクエスト
プルリクエストを使用することで、他の人に対して自分がどのような作業をしたのかを知らせることが出来ます。こうすることで他の方にレビューをもらえます。
マージ
マージをすることで、行った作業をmainブランチに反映させることが出来ます。マージをしないと、作業は反映されないので注意が必要です。
実際にやってみよう!
ここでは自分のページをもっとリッチにして、プルリクエストを出して、マージする流れを実際に試してみましょう
- あらかじめ自分で「ブランチ」を作成して作業を行い、
- 一通り完了したら GitHub に Push して、
- 「プルリクエスト」を出し、
-
レビューをもらい、(ここでは貰わない) - main ブランチに「マージ」
①あらかじめ自分で「ブランチ」を作成して作業を行う
個人的にブランチはmainから作成することが多いと思うので、流れとしては以下のようになります。
git checkout main
git pull origin main
git branch [ブランチ名]
git checkout [ブランチ名]
- main ブランチに移動(※念のため)
- ※ main じゃなくても構いません。ブランチを切りたいところに移動してください
- GitHub 上のデータを取得(※念のため)
- ※1が main でない場合はここも変更してください
- ブランチ作成
- そのブランチに移動
git branch [ブランチ名]
git checkout [移動したいブランチ名]
ブランチ名は自分の GitHub のユーザー名にして、実際にやってみましょう。
ブランチが切り替わったかどうかは git branch
で確認できます。自分のユーザー名の前に「*」が付いてればOKです!
あとは自分のページに色々情報を加えたりして、セーブしてください。自由に作業してみましょう。
(git add
、git commit
を忘れずに!)
②一通り完了したら GitHub に Push
セーブデータを GitHub に送りましょう。ブランチ名はさっき自分が作ったものに変更してください
git push origin [ブランチ名]
③「プルリクエスト」を出そう!
GitHub を見るとこのようになっているので、「Compare & pull request」をクリックして
「base」が「main」になっているか、「compare」が「Pushしたブランチ名」になっているかを確認して、良ければ「Create pull request」をクリック!
(チーム開発では、Leave a comment のところに「何をしたのか」についての概要を書いたりします)
④レビューをもらいます
ここではカットします
⑤mainブランチに「マージ」しよう!
「Merge pull request」⇒「Confirm merge」を順にクリックするだけです。
こうなっていればOKです。ブランチがもう必要なければ「Delete branch」で消しておくと良いでしょう。
おまけ:Repository をコピーする方法
今までは自分で1から作っていましたが、毎回自分から作るとは限りません。誰かが作成したものを使用する場合は、最初にCloneする必要があります。
試しにこちらのRepositoryをCloneしてみましょう。
VSCodeに戻って以下のURL部分を変更して実行しましょう(git init
していない場合は先にやっておきましょう)
git clone [URL]
Cloneしてきたディレクトリ内部に入ってしまえば、今までと同様に作業が出来ます。
おまけ:Private な Repository に招待する方法
Private の場合は「Settings」>「Collaborators」>「Manage access」内の緑色のボタン「Add people」をクリックし、
次のようなものが表示されるので、招待したいユーザー名を入れます。そうすると招待された側にはメールが届くので、承諾しましょう。
参考資料
おわりに
個人的には、この辺りは実際にチーム開発をするのが一番手っ取り早いと思うのでやってみると良いと思います。
段々慣れてきたな~と思ったら他のコマンドを調べてみると面白いので興味があればぜひ!(コミットを取り消したり、特定のコミット履歴まで戻ったり色々出来ます)
ここまで読んでいただき、ありがとうございました!何かありましたら、コメントをお願いいたします。