前提
- GitHubでリポジトリ作成済み
- EclipseでSpringプロジェクト作成済み
使用環境・ツール
- mac
- Finder
- ターミナル
- GitHub
さっそくやっていきます
まず以下のような構成でフォルダを作成します。
/Users/username/DevProjects
├── SpringProjects
└── my-app-spring
SpringProjectsフォルダに移動します。
% cd DevProjects/SpringProjects/my-app-spring
git initします。
% git init
Initialized empty Git repository in /Users/username/DevProjects/SpringProjects/my-app-spring/.git/
ローカルに.gitフォルダが作成されました。
% ls -A
.classpath .mvn HELP.md pom.xml
.git .project mvnw src
.gitignore .settings mvnw.cmd target
.gitフォルダに移動してみます。
% cd .git
.gitフォルダ内のファイル一覧。
% ls
HEAD description info refs
config hooks objects
それぞれの役割をchatGPTに聞いてみました。
| ファイル/フォルダ名 | 役割 |
|---|---|
| config | Gitリポジトリの設定ファイル。リポジトリ固有の設定が含まれています。 |
| hooks | リポジトリに関連するスクリプトが配置されるディレクトリ。コミット前やプッシュ後などのイベントにフックされるスクリプトが含まれます。 |
| objects | Gitのデータベース。コミットやツリー、ブロブなどのオブジェクトがSHA-1ハッシュ値に基づいて保存されます。 |
| HEAD | 現在チェックアウトされているブランチの参照を保持するファイル。 |
| description | Gitリポジトリの説明を含むファイル。通常、Gitウェブインターフェースで表示される説明文がここに書かれます。 |
| info | リポジトリに関する追加情報が含まれるディレクトリ。特にexcludeファイルは、.gitignoreと同様に無視するパターンを指定します。 |
| refs | ブランチやタグの参照情報を保持するディレクトリ。 |
おそらくdescriptionはGitHubでリポジトリ作成した時に書いた説明のところが入ってくる？
その他、configとHEADファイルの内容を確認してみます。
% cat HEAD
ref: refs/heads/main
% cat config
[core]
repositoryformatversion = 0
filemode = true
bare = false
logallrefupdates = true
ignorecase = true
precomposeunicode = true
つまり、HEADから分かることは「現在チェックアウトされているブランチの参照を保持するファイル」はrefs/heads/mainということになります。
「Gitリポジトリの設定ファイル」であるconfigに関してもchatGPTで聞いてみました。
| 設定名 | 説明 |
|---|---|
| repositoryformatversion | リポジトリフォーマットのバージョン。通常は0です。 |
| repositoryformatversion | trueの場合、Gitはファイルの実行権限（パーミッション）を管理します。 |
| bare | falseの場合、このリポジトリはワーキングディレクトリを持つ標準的なリポジトリです。trueの場合、ワーキングディレクトリを持たないベアリポジトリになります。 |
| logallrefupdates | trueの場合、リファレンス（ブランチやタグ）の更新をすべて記録します。 |
| ignorecase | trueの場合、Gitはファイル名の大文字と小文字を区別しません。主にWindowsやmacOSで使われます。 |
| precomposeunicode | trueの場合、Unicodeの正規化を行います。主にmacOSで使われ、Unicodeの合成文字を分解せずにそのまま扱います。 |
.gitフォルダ内にrefsフォルダがあるのでその先に進んで。「現在チェックアウトされているブランチ」のmainを確認していきます。
% cd refs/heads/main
cd: no such file or directory: refs/heads/main
まだ存在しませんでした。
これについてもchatGPTに聞いてみたところ、
「git initコマンドを実行すると、Gitは新しいリポジトリを初期化し、必要なディレクトリやファイルを作成しますが、ブランチ自体はまだ作成されません。」
とのことでした。
ということで参照自体は作成されているけど、実体はまだないというようなことみたいです。
Springプロジェクトのファイルをコミットしてみます
流れとしては、ステージングというのを行なってファイルをコミット対象としてからコミットするみたいです。
ステージングするためにgit addしていきます。今回は試しにpom.xmlを初回コミットしてみます。
% git add pom.xml
このコマンド打った後はターミナル上では何も起きませんでした。
git statusで状態を確認できるみたいです。
% git status
On branch main
No commits yet
Changes to be committed:
(use "git rm --cached <file>..." to unstage)
new file: pom.xml
Untracked files:
(use "git add <file>..." to include in what will be committed)
.DS_Store
.gitignore
.mvn/
mvnw
mvnw.cmd
src/
git addしたpom.xmlが無事コミット対象されたみたいです。
コミット対象となったので、コミットしていきます。
% git commit -m "Initial commit"
[main (root-commit) 9cf7788] Initial commit
1 file changed, 64 insertions(+)
create mode 100644 pom.xml
ログも確認します。うまくいってそうです。
git log
commit ハッシュ値 (HEAD -> main)
Author: 名前 <メールアドレス>
Date: Tue May 21 20:12:29 2024 +0900
ということで先ほど、参照は作成されたけど実態がなかったrefs/heads/mainを確認してみます。
headsに移動します
% cd .git/refs/heads
heads %
mainができていました。
% ls
main
つまり改めて整理すると
| コミット前 | コミット後 |
|---|---|
| git initコマンドでリポジトリが初期化され、参照が設定されるが、まだ実際のコミットオブジェクトは存在しないためrefs/heads/mainはない。 | git commitコマンドを実行すると、実際のコミットオブジェクトが作成され、そのハッシュ値がrefs/heads/mainファイルに保存される。 |
Githubとローカルのリポジトリを連携していく
事前にGitHubで作成しておいたリポジトリとここまで頑張って作業して作成してきたローカルリポジトリを連携させます。git remote addで連携できます。つまりこれを行うことで、この後のプルやプッシュができる対象となるみたいです。
% git remote add origin https://github.com/自分のgithubのユーザ名/リポジトリ名.git
確認します。originというのがあります。これはリモートリポジトリのことです。
うまくいってそうです。
% git remote
origin
続いて、Githubでリポジトリ作成した時に、ライセンスファイルやREADMEファイルを付けて作成したので、それを取り込む作業が必要です。今回はfetchしてmergeしていきたいと思います。
fetchします。
% git fetch origin
remote: Enumerating objects: 4, done.
remote: Counting objects: 100% (4/4), done.
remote: Compressing objects: 100% (4/4), done.
remote: Total 4 (delta 0), reused 0 (delta 0), pack-reused 0
Unpacking objects: 100% (4/4), 1.59 KiB | 325.00 KiB/s, done.
From https://github.com/ユーザ名/リポジトリ名
* [new branch] main -> origin/main
mergeします。
% git merge origin/main --allow-unrelated-histories
Merge made by the 'ort' strategy.
LICENSE | 21 +++++++++++++++++++++
README.md | 2 ++
2 files changed, 23 insertions(+)
create mode 100644 LICENSE
create mode 100644 README.md
無事にライセンスファイルとREADEMEファイルがマージされたみたいです。
プッシュしていきます
最後にプッシュしていきます
% git push origin main
Enumerating objects: 6, done.
Counting objects: 100% (6/6), done.
Delta compression using up to 12 threads
Compressing objects: 100% (4/4), done.
Writing objects: 100% (5/5), 1.22 KiB | 1.22 MiB/s, done.
Total 5 (delta 0), reused 0 (delta 0), pack-reused 0
To https://github.com/ユーザ名/リポジトリ名.git
9fc9989..bf816a2 main -> main
無事プッシュできたみたいです。
GitHubも確認してみたところpom.xmlがしっかり反映されていました。
まとめ
今までの流れをまとめてみます。
①git initでローカルリポジトリを初期化する。
②git addでステージングしファイルをコミット対象とする。
③git commitでファイルをコミットする。
④git remote add originでGitHubで作成したリポジトリと連携する。
⑤git fetchで差分を取り込む
⑥git mergeでローカルリポジトリとリモートリポジトリを合体させる。
⑦git pushでリモートリポジトリにコミットする。