- バージョン管理(Git)の有効化:Enable Version Control Integration
- ステージングに関する設定:Enable staging area
- コミットツールウィンドウ:Commit(⌘ + 0)
- diffの確認:Show Diff(⌘ + D)
- 作業ディレクトリから削除:Delete(⌫)
- add:Stage(⌘ + ⌥ + A) / addの取り消し:Unstage(⌘ + ⌥ + Z)
- commit(⌘ + Enter)
- バージョン管理ウィンドウ:Git(⌘ + 9)
- ブランチを切る:New branch
- ブランチを切り替える
- ブランチを削除する:Delete
- ブランチ名を変更する:Rename...
- コミットメッセージを変更する:Edit Commit Messages...(F2)
- GitHubアカウントを設定する
- リモートリポジトリの設定:Manage Remotes
- push(⌘ + Shift + K)
- Pull Requests
- Gistを作成する:Create Gist...
- fetch / pull / Update Project...(⌘ + T)
- stash
- reset
- rebase
- cherry-pick
- revert
- 番外編:実行されているコマンドの確認
バージョン管理(Git)の有効化:Enable Version Control Integration
RubyMineでバージョン管理(Git)の機能を使用するには、まず有効化する必要があります。
- VCS操作のポップアップメニューを開く(
⌃
+V
)か、メニューバーの「VSC」から「Enable Version Control Integration...」を選択します。 - プルダウンで「Git」が選択されていることを確認し、「OK」を選択します。
以降、VCS用のメニューがGit専用のものに置き換わります。
ステージングに関する設定:Enable staging area
コマンドラインでGitを利用している場合、
- 作業ディレクトリ
- ステージングエリア
- ローカルリポジトリ
という3ステップが必要になりますが、 RubyMineでは以下の2ステップで変更をローカルリポジトリに反映することができます。
- Changelist
- ローカルリポジトリ
RubyMine 2020.3 まではこの2ステップ式しかなかったのですが、以降はどちらの方式も採択できるようになりました。
Preferences...(⌘
+ ,
)> Version Control > Git > 「Enable staging area」をON/OFFにすることで切り替えが可能です。
(ONの場合、前者の方法でローカルリポジトリへの反映を行います)
- RubyMineを使用していない開発者は基本的にステージングエリアを使用していること
- ステージングエリアを使用した方がGit本来の恩恵を受けやすく、小回りが効きやすい
という理由から以降の説明では、「Enable staging area」がONになっている想定で説明を進めます。 なおOFFになっている場合も、「add」がないだけで他の箇所は同じです。
⌘
+ 0
)
コミットツールウィンドウ:Commit((⌘
+ 0
)でコミットツールウィンドウを開くことができます。画面左にある「Commit」とあるタブを選択することでも開くことができます。
番号 | 名前 | 内容 |
---|---|---|
1 | Staged | ステージングエリアにあるファイルを表示する |
2 | Unstaged | 作業ディレクトリにあるファイルを表示する |
3 | Commit Message | コミットメッセージを記入する |
ステージングエリア・作業ディレクトリにあるファイルは、Group By設定を切り替えることで、ファイル名だけを表示するか、ディレクトリごとにグループ化して表示することができます。
個人的にはファイル別に表示する方が見やすいですが、好みに合わせて切り替えてください。
⌘
+ D
)
diffの確認:Show Diff(コミットツールウィンドウでファイルを選択し、「Show Diff(⌘
+ D
)」を押すことで、エディタにdiffを表示することができます。
変更がある箇所がハイライトされており、ガターにある「>>」「<<」を押すことで、エディタを見ながらadd(作業ディレクトリにある場合)・commit(ステージングエリアにある場合)をすることが可能です。
gifでは、作業ディレクトリでの作業内容を表示してエディタ上でaddし、ステージングエリアに反映されることを確認しています。
⌫
)
作業ディレクトリから削除:Delete(ファイルを作業ディレクトリから削除する場合は、ファイルを右クリックし、コンテキストメニューから「Delete」(⌫
)を選択します。
⌘
+ ⌥
+ A
) / addの取り消し:Unstage(⌘
+ ⌥
+ Z
)
add:Stage(addするにはUnstagedにあるファイルを右クリックし、コンテキストメニューから「Stage」(⌘
+ ⌥
+ A
)を選択します。
また一度addした内容を取り消す(作業ディレクトリに戻す)には、コンテキストメニューから「UnStage」(⌘
+ ⌥
+ Z
)を選択します。
「UnStaged」にカーソルを合わせてStageを行うことで、作業ディレクトリにあるファイルを一括でaddすることができます。
⌘
+ Enter
)
commit(commitするにはstagedにファイルがある状態で、コミットメッセージを入力し、「COMMIT」(⌘
+ Enter
)を入力します。
⌃
+ ⌥
+ M
)
commit --amend(「Amend」にチェックを入れて(⌃
+ ⌥
+ M
)commitすることで、直前のコミットに今回のコミットをまとめることができます。
Stagedにファイルがない状態でも、直前のコミットメッセージを修正したい場合などに重宝します。
コミット前のチェック設定:Show Commit Option
「Show Commit Option」からコミット時の設定を登録することができます。
デフォルトではファイルの中に「TODO」が残っている場合は、コミットを中断して注意を促すようになっています。
「COMMIT ANYWAY」を選択することで、チェックされた内容を無視してcommitすることができます。
⌘
+ 9
)
バージョン管理ウィンドウ:Git((⌘
+ 9
)を入力もしくは画面下の「Git」タブを選択することで、バージョン管理ウィンドウを開くことができます。
番号 | 概要 |
---|---|
1 | ブランチ一覧 |
2 | コミットログ一覧。赤枠で指定した条件でフィルタリングすることが可能。 |
3 | 選択したコミットに含まれるファイル |
4 | コミットメッセージ |
ブランチを切る:New branch
ブランチ一覧でベースとなるブランチを右クリックし、コンテキストメニューから「New Branch from Selected...」を選択します。
ブランチ名を入力して「OK」を選択すると、新しいブランチが作成されます。
ブランチを切り替える
ブランチ一覧でベースとなるブランチを右クリックし、コンテキストメニューから「Checkout」を選択します。
Search Everywhereを使用するのであれば、「Branches...」を検索することでブランチ一覧に遷移できます。
Checkoutしたいブランチを選択し、「Checkout」を選択することで切り替えが可能です。
ブランチを削除する:Delete
ブランチ一覧でベースとなるブランチを右クリックし、コンテキストメニューから「Delete」を選択します。
ブランチ名を変更する:Rename...
ブランチ一覧でベースとなるブランチを右クリックし、コンテキストメニューから「Rename..」を選択します。
ブランチ名を入力して「OK」を選択すると、ブランチ名が変更されます。
F2
)
コミットメッセージを変更する:Edit Commit Messages...(コミット一覧から変更対象のコミットを右クリックし、コンテキストメニューから「Edit Commit Message...」(F2
)を選択します。
コミットメッセージを入力して、「OK」を選択すると、コミットメッセージが変更されます。
GitHubアカウントを設定する
Preferences(⌘
+ ,
) > Version Control > Github を選択し、「+」ボタンからお好みの方法でGithubアカウントをRubyMineに紐付けます。
※だいぶ前にGithubアカウントを連携したので、この先を詳細に覚えておらずすみません...。おそらく表示される内容の通りに作業をすれば問題なく登録できるかと思います。
リモートリポジトリの設定:Manage Remotes
メニューバー Git > Manage Remotes...を選択します。
「+」ボタンを押して、登録するリモートリポジトリのエイリアス名とURLを登録します。
ここで登録したリモートリポジトリを、push、pull時に選択することが可能になります。
例えば、あるリポジトリをforkして自分のリポジトリにしている場合、fork元のリポジトリを「upstream」、forkしたリポジトリを「origin」とすることで、pullは「upstream」から、pushは「origin」を指定することが可能になります。
⌘
+ Shift
+ K
)
push((⌘
+ Shift
+ K
)を入力することで、Push画面を表示することができます。
画面左側にはPush先と対象のコミット一覧が、画面右側にはコミットごとのDiffが表示されています。
Push先はクリックすることで変更でき、まだ登録されていないリモートリポジトリの場合は、この画面から登録することも可能です。
リモートリポジトリが作成されていない場合は、RubyMineが同名のブランチをリモートリポジトリに作成し、pushを行います。
対象を確認後、「PUSH」を選択する(⌘
+ Enter
)ことでPushを実行することができます。このとき、プルダウンから「Force Push」も選択可能です。
Pull Requests
Githubを開かずに、RubyMine上からPull Requestsを閲覧・作成することが可能です。
Pull Requestsツールウィンドウの表示:Pull Requests
RubyMine上でPull Request関連の機能を利用するには、Pull Requestツールウィンドウを有効にする必要があります。
メニューバーから View > Tool Window > Pull Requestsを選択し、Pull Requestsツールウィンドウを有効化します。
以降は画面左にある「Pull Requests」を選択することで、Pull Requestsツールウィンドウを有効化することができます。
Pull Requestの閲覧
Pull Requestsツールウィンドウを開くと、Pull Requestsの一覧が表示されています。
初期状態では、「state:open」でフィルターがかかっていますが、クリアすることでクローズしたプルリクも参照することができます。
また表示情報が古い場合には、⌘
+ R
を入力することで、PR一覧を更新することができます。
key:検索値
の形で入力することで、state以外のフィルターをかけることができます。使用できるパラメータは⌃
+ Space
で表示することができます。
一覧から対象のPRを選択することで、PRの詳細が表示され、エディタにConversationの詳細が表示されます。
Pull Requestsツールウィンドウでは、PRの詳細(Info)、PRに含まれるファイル(Files)、PRに含まれるコミット(Commits)を参照することができます。
エディタに表示されているConversationでは、メッセージの編集・追記を行うことができます。
なおPRをGithub上で確認したいときや、Conversationsのタブを閉じてしまったときは、Pull Requestツールウィンドウを右クリックし、コンテキストメニューから選択してください。
⌘
+ N
)
Pull Requestの作成(PRを作成するには、Pull Requestツールウィンドウ右上の「+」ボタンを選択(⌘
+ N
)します。
あとはGithubで作成する際と同じで、以下の内容を入力します。
- PRするブランチ
- タイトル
- 内容
- レビュワー
- アサイン
- ラベル
通常のPRを作成する場合は「CREATE PULL REQUEST」を、ドラフトPRを作成するにはプルダウンから「Create Draft PULL REQUEST」を選択してPRを作成します。
Gistを作成する:Create Gist...
pushの番外編的なところで、RubyMineからGistを作成することもできます。
プロジェクトツールウィンドウで、Gistを作成するファイルを右クリックし、ポップアップメニュー > Create Gistを選択します。
適宜選択してOKを選択することで、Gistを作成することができます。
なお、ディレクトリを選択してこのメニューを呼び出すことで、一つのGistに複数のファイルを一括でアップロードすることが可能です。
⌘
+ T
)
fetch / pull / Update Project...(いずれもリモートリポジトリの情報をローカルリポジトリに対して反映する方法です。
名前 | 概要 | 操作方法 |
---|---|---|
Fetch | リモートブランチの情報を更新する。ローカルには反映しない | メニューバー Git > Fetch |
Pull | 指定したリモートブランチの情報を更新し、ローカルに反映する。 | メニューバー Git > Pull |
Update Project | プロジェクト内のすべてのブランチに対して、Pullを実行する |
⌘ + T
|
Pullは通常のPullコマンド同様に、ブランチやオプションを指定することができます。
Update Projectについても、取り込み時にマージするか、リベースするかを選択することができます。
stash
現在のブランチで作業している内容を一時退避したい場合には、stashコマンドを利用します。
RubyMineでは、Gitのポップアップメニュー(⌃
+ V
) > Stash Changes... を選択することで起動できます。
メッセージを入力し、「CREATE STASH」を選択することで作業を一時退避することができます。
退避した作業の確認・復旧・削除を行いたい場合は、「Unstash Changes...」を利用します。
RubyMineでは、Gitのポップアップメニュー(⌃
+ V
) > Unstash Changes... を選択することで起動できます。
stashの一覧が表示されますので、対象のstashを選択して、必要に応じて以下から選択します。
- 「VIEW」(確認)
- 「DROP」(削除)
- 「CLEAR」(stashの全件削除)
- 「APPLY STASH」(stashの反映:
stash apply
)
reset
作業を特定のコミットまで戻したい際には、resetコマンドを使用します。
RubyMineではバージョン管理ウィンドウでコミットを指定することで、resetコマンドを起動します。
バージョン管理ウィンドウ(⌘
+ 9
) > 戻したい時点のコミットを右クリックし、コンテキストメニューから「Reset Current Branch to Here」を選択します。
resetコマンドのオプション(Soft、Mix、Hard、Keep)が表示されますので、戻したい状態に応じて選択しOKを押します。
これで指定したオプションに応じて、作業内容が元に戻ります。SHA1 IDをgit reflog
で確認する必要がないので楽ちんですね。
Drop Commit
同じくバージョン管理ウィンドウでコミットを指定して利用できるメニューに「Drop Commit」というメニューがあります。 これを選択することで、指定したコミットを破棄することができます。
(リポジトリ、ステージングエリア、作業ディレクトリから削除されるので注意してください。)
なお、実際に動作しているコマンドはgit reset --hard
であるため、resetと合わせて紹介しました。
rebase
作業ブランチ内でrebaseを行う
A---B---C topic
/
D---E main
A---B(B---C) topic
/
D---E main
作業中のブランチにおいて、rebaseを行いたい場合は以下のように作業します。
- バージョン管理ウィンドウでrebaseの起点にしたいコミットを右クリックし、コンテキストメニューから「Interactive Rebase from Here...」を選択します。
- rebaseのためのウィンドウが開きます。各コミットが時系列で表示されており、ドラッグ & ドロップで順序を変更することが可能です。必要に応じてコミットを選択した状態で各ボタンを選択します。「Reset」を選択すると、行った操作をリセットすることができます。
- 「START REBASING」を選択すると、rebaseが始まります。rebaseの結果コンフリクトが生じる場合は、エディタが立ち上がるので都度解消していきます。
ブランチ間でrebaseを行う
A---B---C topic
/
D---E---F---G main
A'---B'---C' topic
/
D---E---F---G main
あるブランチでの変更を、現在のブランチに取り込みたい場合はブランチ一覧からrebaseを利用します。
取り込みたい作業内容のあるブランチを右クリックし、コンテキストメニュー > 「Rebase Current Onto Selected」を選択します。
選択したブランチでの作業内容が、カレントブランチにrebaseで取り込まれます。
cherry-pick
別ブランチの特定のコミットを取り込みたい場合は、cherry-pickコマンドを使用します。
RubyMineではバージョン管理ウィンドウでコミットを選択することで、cherry-pickコマンドを起動します。
必須ではありませんが、cherry-pickを行う場合は全ブランチのコミット履歴をみられるようにしておくことをおすすめします。
取り込みたいコミットを右クリックし、コンテキストメニューから「Cherry-Pick」を選択します。 これで指定したコミットがカレントブランチに取り込まれます。
revert
コミット済みの内容を打ち消ししたい場合はrevertコマンドを使います。
RubyMineではバージョン管理ウィンドウでコミットを指定することで、revertコマンドを起動します。
バージョン管理ウィンドウ(⌘
+ 9
) > 打ち消したいコミットを右クリックし、コンテキストメニューから「Revert Commit」を選択します。 選択したコミットの打ち消しコミットが自動で作成されます。
番外編:実行されているコマンドの確認
RubyMineで行っているGit操作はGUI上で行うことができますが、「これをCUIで行ったらどうなるのだろうか?」と思う日もあるでしょう。
そんな時は、バージョン管理ウィンドウの「Console」タブを開いてみましょう。
これまで行われてきたGitコマンドが時系列で表示されています。IDE経由のため、実際のコマンドよりも少しいろいろと書いてありますが、最後の方だけを見れば、およそどんなコマンドが実行されているか理解することができるでしょう。