コミット
- プラン: Free、Premium、Ultimate
- 提供形態: GitLab.com、GitLab Self-Managed、GitLab Dedicated
コミットリストには、リポジトリの履歴が表示されます。コードの変更の閲覧、コミット詳細の表示、コミット署名の確認に使用します。コミットは日ごとにグループ化され、作成者、コミットメッセージ、日付、またはGitリビジョンでリストをフィルターできます。
リストに表示される内容:
- コミットハッシュ: 各コミットの固有識別子(SHA)です。
- コミットメッセージ: コミットのタイトルと説明。
- 作成者: コミットを作成した作成者の名前とアバター。
- タイムスタンプ: コミットが作成された日時。
- パイプラインステータス: 設定されている場合は、CI/CDパイプラインの結果。
- 署名の検証: GPG、SSH、またはX.509署名のステータス。
- タグ: このコミットを指すタグ。
コミットを表示する
リポジトリのコミット履歴を表示するには:
- 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。
- 左側のサイドバーで、コード > コミットを選択します。
コミットの完全な説明を表示するには、コミットの右側にある展開( )アイコンを選択します。説明を折りたたむには、展開( )アイコンをもう一度選択します。
コミット詳細を表示する
ファイルの変更、追加、削除など、コミットに加えられた特定の変更を調べます。
コミットの詳細を表示するには:
- 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。
- 左側のサイドバーで、コード > コミットを選択します。
- コミットを選択して、コミットの詳細ページを開きます。
コミットの詳細ページには、次の情報が表示されます:
- コミット情報: コミットハッシュ、作成者、コミッター、親コミット、およびタイムスタンプ。
- コミットメッセージ: コミットのタイトルと説明。
- ファイルの変更: 差分ビューですべての変更されたファイル。
- 統計: 変更、追加、および削除された行数。
- パイプラインの詳細: 関連付けられたCI/CDパイプラインのステータスと詳細。
- 参照: このコミットを含むブランチとタグ。
- 関連するマージリクエスト: コミットに関連付けられたマージリクエストへのリンク。
Gitリビジョンでリポジトリファイルを参照する
コミットSHA、ブランチ名、またはタグなど、特定のGitリビジョンですべてのリポジトリファイルとフォルダーを表示するには:
- 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。
- 左側のサイドバーで、コード > コミットを選択します。
- 次のいずれかのオプションを選択します。
- Gitリビジョンでフィルタリング:
- 上部で選択して、Gitリビジョンの選択ドロップダウンリストを開きます。
- Gitリビジョンを選択または検索します。
- コミットリストから特定のコミットを選択します。
- Gitリビジョンでフィルタリング:
- 右上にあるファイルを参照を選択します。
その特定のリビジョンのリポジトリページに移動します。
コミットをフィルタリングおよび検索する
検索バーを使用してコミット履歴を作成者、コミットメッセージ、または日付でフィルターします。複数のフィルターを同時に組み合わせることができます。
日付でフィルター
日付でコミットをフィルターするには:
- 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。
- 左側のサイドバーで、コード > コミットを選択します。
- 検索バーで、フィルタードロップダウンリストからコミット日が次の日付以降またはコミット日が次の日付以前を選択します。
- 日付を入力します。
特定の日付範囲のコミットを表示するには、両方のフィルターを一緒に使用します。
作成者でフィルタリングする
1人以上の作成者でコミットをフィルターするには:
- 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。
- 左側のサイドバーで、コード > コミットを選択します。
- 検索バーで、フィルタードロップダウンリストから作成者を選択します。
- 1人以上の作成者を選択または検索します。
リストは、選択した作成者からのコミットのみを表示するように更新されます。
作成者のフィルタリングが特殊文字を含む名前で機能しない場合は、URLパラメータ形式を使用します。たとえば、URLに?author=Elliot%20Stevensを追加します。
Gitリビジョンでフィルタリングする
ブランチ、タグ、コミットSHAなどのGitリビジョンでコミットをフィルタリングするには:
- 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。
- 左側のサイドバーで、コード > コミットを選択します。
- 上部のドロップダウンリストで、Gitリビジョンを選択または検索します。たとえば、ブランチ名、タグ、またはコミットSHA。
- Gitリビジョンを選択して、フィルタリングされたコミットのリストを表示します。
コミットメッセージで検索する
メッセージの内容でコミットを検索するには:
- 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。
- 左側のサイドバーで、コード > コミットを選択します。
- 検索バーで、フィルタードロップダウンリストからメッセージを選択します。
- 検索語を入力します。
コミットSHAの全部または一部で検索して、特定のコミットを直接見つけることもできます。
フィルターされたビューを共有してブックマークする
コミットリストをフィルターするか、ページサイズを変更すると、URLが現在のビューを反映するように更新されます。次のことが可能です。
- フィルターされたビューを共有するには、URLをコピーします。
- フィルターの組み合わせを保存するには、URLをブックマークします。
- ブラウザの戻るボタンと進むボタンを使用して、フィルターの状態を切り替えます。
URLは次のパラメータを使用します:
| パラメータ | 説明 |
|---|---|
author | コミット作成者のユーザー名。 |
message | コミットメッセージで一致させるテキスト。 |
committed_after | 最も早いコミット日付。YYYY-MM-DD形式。 |
committed_before | 最新のコミット日付。YYYY-MM-DD形式。 |
page_size | ページあたりのコミット数。デフォルトは20です。 |
コミットのページ間を移動する
コミットリストはカーソルベースのページネーションを使用します。ページ間を移動するには:
- 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。
- 左側のサイドバーで、コード > コミットを選択します。
- リストの下部にある前ページまたは次ページを選択して、ページ間を移動します。
コミットリストアクションにアクセスする
コミットページには、現在のGitリビジョンへのクイックリンクを含むアクションメニューがあります。
アクションメニューにアクセスするには:
- 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。
- 左側のサイドバーで、コード > コミットを選択します。
- 右上の縦方向の省略記号( )を選択して、アクションメニューを開きます。
アクションメニューには次のものが含まれます:
- ファイルを参照: 選択したGitリビジョンで、すべてのリポジトリファイルを表示します。
- Subscribe to commits RSS feed: 現在のリビジョンのコミットのRSSフィードを購読します。
コミットをチェリーピックする
特定のコミットからの変更を別のコミットに適用します。
前提条件:
- プロジェクトのデベロッパー、メンテナー、またはオーナーロールが必要です。
- ターゲットブランチが存在する必要があります。
コミットをチェリーピックするには:
- 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。
- 左側のサイドバーで、コード > コミットを選択します。
- チェリーピックするコミットを選択します。
- 右上隅で、オプションを選択し、次にcherry-pickを選択します。
- ダイアログで:
- ドロップダウンリストから、ターゲットプロジェクトとブランチを選択します。
- オプション。Start a new merge requestを選択して、変更を含むマージリクエストを作成します。
- Cherry-pickを選択します。
GitLabは、チェリーピックされた変更を含むターゲットブランチに新しいコミットを作成します。ブランチが保護されている場合、または適切な権限がない場合、GitLabは新しいマージリクエストを作成するように求めます。
コミットをリバートする
前のコミットからの変更を元に戻す新しいコミットを作成します。
前提条件:
- プロジェクトのデベロッパー、メンテナー、またはオーナーロールが必要です。
コミットをリバートするには:
- 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。
- 左側のサイドバーで、コード > コミットを選択します。
- リバートするコミットを選択します。
- 右上隅で、オプションを選択し、次にリバートを選択します。
- ダイアログで:
- リバートコミットのターゲットブランチを選択します。
- オプション。Start a new merge requestを選択して、マージリクエストを作成します。
- リバートを選択します。
GitLabは、選択したコミットからの変更を元に戻す新しいコミットを作成します。ブランチが保護されている場合、または適切な権限がない場合、GitLabは新しいマージリクエストを作成するように求めます。
コミットの内容をダウンロードする
コミットの差分の内容をダウンロードするには:
- 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。
- 左側のサイドバーで、コード > コミットを選択します。
- ダウンロードするコミットを選択します。
- 右上隅で、オプションを選択します。
- ダウンロードで、テキスト差分を選択します。
コミット署名を検証する
GitLabは、GPG、SSH、およびX.509署名を検証して、コミットの信頼性を確保します。検証済みのコミットには、検証済みバッジが表示されます。
詳細については、署名されたコミットを参照してください。
署名の詳細を表示する
署名情報を表示するには:
- 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。
- 左側のサイドバーで、コード > コミットを選択します。
- 検証済みまたは未検証バッジが付いたコミットを見つけます。
- バッジを選択して、次の署名の詳細を表示します:
- 署名の種類(GPG、SSH、またはX.509)
- キーのフィンガープリント
- 検証ステータス
- 署名者のID
パイプラインステータスと詳細を表示する
コミットリストには、各コミットの横にCI/CDパイプラインステータスアイコンが表示されます。パイプラインの詳細を表示するには:
- 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。
- 左側のサイドバーで、コード > コミットを選択します。
- 任意のコミットの横にあるパイプラインステータスアイコンを選択します。
