はじめに
Spring Tool Suite(STS)でプロジェクトを GitHub に Push(アップロード)するまでの手順をメモを残しておきます。
環境は、Windows です。
<参考サイト>
Eclipseで一通り基本的なGitを使ってみる
STSで作成したプロジェクトをGitHubにアップロード(連携,push)する方法
STSで作成したSpringプロジェクトのGitHub連携メモ
1. サンプルプロジェクトの作成
(参考)記載したコード
① コントローラー
package com.example.demo;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
@Controller
@RequestMapping
public class SampleController {
@GetMapping
public String index() {
return "index";
}
}
② HTML ファイル
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>Insert title here</title>
</head>
<body>
<h2>Hello World!</h2>
</body>
</html>
2. ローカルリポジトリの作成
プロジェクト名を右クリックして、「Team」→「Share Project」を選択します。
次の画面が表示されますので「Use or create repository in parent folder of project」にチェックを入れます。
チェックを入れると次の画面が表示されます。
ここで対象のプロジェクトを選択すると(青にすると)、「Create Repository」のボタンが押せるようになるので、クリックします。
次のように、対象プロジェクトにチェックが入ります。
そのまま「Finish」をクリックすれば、ローカルリポジトリが作成されます。
3. コミットしてmasterブランチを作成
プロジェクト名を右クリックして、「Team」→「Commit」を選択します。
次の画面が表示されたら、赤枠の「全てのファイルを選択」ボタンをクリックして、「unstaged Changes」にある全てのファイルをコミットの対象にします(左側の「+」ボタンで、必要なファイルだけを選択して追加することもできます)。
追加したファイルが「Staged Changes」に移動していることが確認できたら、「Commit Message」を記入します。
何でも良いのですが、ここでは「Initial Commit」としておきました。
最後に「Commit」ボタンを押せば、masterブランチが作成されます。
※ なお、ここで「Commit and Push」ボタンから、すぐに GitHub に Push することもできます(手順が異なりますので「こちらの記事」を参照してください)。
4. .gitignoreファイルを確認する
プロジェクトにあるファイルのうち Git の管理外に置きたいファイルは、「.gitignore ファイル」に記載することで管理の対象外とすることができます。
この .gitignore は、ローカルリポジトリの作成時に自動で生成されています。
しかし、デフォルトの状態では Package Explorer には表示されていませんので、これを表示されるようにしておきます。
Package Explorer の「View Menu」ボタン(赤枠のところ)から「Filters」を選択します。
次のように「.* resources」のチェックを外します。
こうすることで、.gitignore ファイルが表示されるようになります。
よく分らないうちは、以下のデフォルトの設定のままで問題はないと思います。
5. GitHubにリポジトリを作成
GitHub に Push するには、あらかじめリポジトリを作成しておく必要があります(STS から自動でリモートリポジトリを作る機能は無いようです)。
GitHub のアカウントの作成方法は、数多のサイトで紹介されていますので、そちらを参考にしてください(例えば「GitHubアカウントの作り方」など)
ログインした画面から、次のように「New repository」を選択します。
リポジトリの作成画面が出てきますので、名前(Repository name)を付けて、必要に応じて、Public(公開)か Private(非公開)かを選択します。
それ以外のチェックは不要です(チェックすると不要なブランチが作成されてしまいます)。
「Create repository」をクリックすると、リポジトリが作成されます。
6. リモートリポジトリにPushする
以上の準備が整ったら、リモートリポジトリに Push します。
プロジェクト名を右クリックして、「Team」→「Remote」→「Push」を選択します。
6-1. Destination Git Repository
次の、Destination Git Repository という画面が出てきますので、ここで Push 先のリポジトリを指定することになります。
「URI」のところに、先ほど作成した GitHub のリポジトリの URL を入力(コピペ)します。
この URL には、リポジトリ自体の URL「https://github.com/ユーザー名/リポジトリ名
」を入れる必要があります。
入力すると、自動的に Host と Repository path が補完されます。
そして、Authentication のところに、GitHub の自身のユーザー名(User)とパスワード(Password)を入力して「Next」ボタンをクリックします。
6-2. Push Ref Specifications
次に、Push Ref Specifications(Push 参照仕様)という画面が出てきます。
これは、正直あまりよく分りませんが、ローカルブランチからリモートブランチへの参照方法を定義するもののようです。
次のサイトを参考にして(日本語に翻訳して)、一応の設定をしていきます。
<参考サイト>
Pushing to remote repositories
① Add create/update specification(追加作成/更新の仕様)
ここでは、リモートブランチにマップするローカルブランチを指定するとのことです。
「Source ref」のところで「master[branch]」を指定しておきます。
② Add predefined specification(事前定義された仕様の追加)
ここには、事前定義された仕様が組み込まれているとのことです。
「Add All Branches Spec」は、「ローカルブランチ名を Push 先のリポジトリ上の同じブランチ名にマップすることを宣言している」とのことで、とりあえずクリックして追加しておきます。
「Add All Tags Spec」は、「ローカルタグをプッシュ先のリポジトリ上の同じタグに1つずつマップすることを宣言している」とのことで、これもクリックして追加しておきます。
最後に「Finish」をクリックすれば、リモートリポジトリへの Push が完了します。
7. GitHubのリポジトリを確認
無事に Push できたかを、GitHub で確認しておきます。
リポジトリの URL https://github.com/ユーザー名/リポジトリ名
にアクセスします。
次のように、ソースコードが無事に Push されていれば完了です。
8. ブランチの作成とPush
一応、新しいブランチも作成しておきます。
手探りで操作してますので、回りくどい形になっているかもしれません。
8-1. ブランチの作成
プロジェクト名を右クリックして、「Team」→「Switch To」→「New Branch」を選択します。
(なお、この Switch To
のところで、ブランチの切り替えも簡単にできます。)
次の画面でブランチ名を入力します。
「Finish」を押せば、ブランチの作成が完了します。
Package Explorer で、新しいブランチに切り替わっていることが確認できます。
8-2. ファイルの修正内容をコミットする
ファイルの内容を変更しておきます。
ここでは、index.html ファイルの「Hello World!」を「Hello GitHub!」に変更しておきました。
プロジェクト名を右クリックして、「Team」→「Commit」を選択します。
修正したファイルが「Staged Changes」にあることを確認して、「Commit Message」を記載します。
ここでは「update_html_file」としておきました(急にスネークケースにしましたが意味はありません)。
最後に「Commit」ボタンを押してコミットが完了します。
8-3. 新しいブランチをリモートにPushする
プロジェクト名を右クリックして、「Team」→「Push Branch '新しいブランチ名'」を選択します。
「URI」に、リポジトリのURLを入力して、GitHub のユーザー名、パスワードを入力して「Preview」をクリックます。
「Push」をクリックすると、リモートリポジトリに反映されます。
GitHub のリポジトリにアクセスすると、無事に新しいブランチが Push されていることが確認できました。
以上