正式なドキュメントは英語版であり、この日本語訳はAI支援翻訳により作成された参考用のものです。日本語訳の一部の内容は人間によるレビューがまだ行われていないため、翻訳のタイミングにより英語版との間に差異が生じることがあります。最新かつ正確な情報については、英語版をご参照ください。

コミット

  • プラン: Free、Premium、Ultimate
  • 提供形態: GitLab.com、GitLab Self-Managed、GitLab Dedicated

コミットは、ソースブランチのコードの変更をリポジトリに記録して送信します。詳しくは、リポジトリへの変更の記録をご覧ください。

コマンドラインを使用して変更をコミットする

コマンドラインを使用する場合は、git commitを使用します。変更をプッシュする前に、複数のコミットを追加できます。

  • コミットメッセージ:

    コミットメッセージは、何が変更されたのか、その理由を識別します。変更を明確にするために、説明的なメッセージを使用してください。GitLabでは、次のいずれかのアクションを実行するために、コミットメッセージにキーワードを追加できます:

    • GitLab CI/CDパイプラインをトリガーする:

      プロジェクトがGitLab CI/CDで構成されている場合、コミットごとではなく、プッシュごとにパイプラインをトリガーします。

    • パイプラインをスキップ:

      ci skipというキーワードをコミットメッセージに追加して、GitLab CI/CDがパイプラインをスキップするようにします。

    • クロスリンクイシューとマージリクエスト:

      クロスリンクを使用して、ワークフローの関連部分を追跡します。コミットメッセージでイシューまたはマージリクエストについて言及すると、それぞれのスレッドに表示されます。

  • コミットをチェリーピックする:

    GitLabでは、UIからコミットをチェリーピックすることができます。

  • コミットをリバートする:

    UIから選択したブランチにコミットを元に戻す

  • コミットに署名する:

    コミットに署名することで、セキュリティを強化します。

詳細については、ステージ、コミット、およびプッシュの変更を参照してください。

マージリクエストのコミット

各マージリクエストには、マージリクエストが作成された後にソースブランチに加えられたコミットの履歴があります。

これらのコミットは、マージリクエストのコミットタブに表示されます。このタブから、コミットメッセージを確認し、変更をチェリーピックする必要がある場合にコミットのSHAをコピーできます。

マージリクエストでコミットをスカッシュする

マージリクエストに含まれるコミットを確認するには:

  1. 左側のサイドバーで、検索または移動先を選択して、プロジェクトを見つけます。

  2. コード > マージリクエストを選択し、マージリクエストを選択します。

  3. マージリクエスト内のコミットのリストを先頭に表示するには、コミットを選択します。コミットの詳細については、任意のコミットでコミットの説明の切り替え( ellipsis_h )を選択してください。

  4. コミットの変更を表示するには、コミットリンクのタイトルを選択します。

  5. マージリクエスト内の他のコミットを表示するには、次のいずれかの操作を行います:

    • 前ページまたは次へを選択します。
    • キーボードショートカットを使用します: X (コミットを前に戻す) およびC (コミットを次に進む)を選択します。

マージリクエストが以前のマージリクエストに基づいてビルドされている場合は、コンテキスト用により多くのコミットを含める必要がある場合があります。

以前のマージリクエストからコミットを表示する

マージリクエストをレビューする場合、レビューしているコミットを理解するために、以前のコミットからの情報が必要になる場合があります。別のマージリクエストの場合、より多くのコンテキストが必要になることがあります:

  • 現在のマージリクエストが変更しないファイルが変更されたため、これらのファイルは現在のマージリクエストの差分に表示されません。
  • 現在のマージリクエストで変更しているファイルが変更され、作業の進捗状況を確認する必要がある。

コンテキストを増やすために、以前にマージされたコミットをマージリクエストに追加するには:

  1. 左側のサイドバーで、検索または移動先を選択して、プロジェクトを見つけます。
  2. コード > マージリクエストを選択し、マージリクエストを選択します。
  3. コミットを選択します。
  4. コミットのリストの最後にスクロールし、以前にマージしたコミットを追加を選択します。
  5. 追加するコミットを選択します。
  6. 変更を保存を選択します。

以前にマージされたコミットは、APIではContext Commits(コンテキストコミット)と呼ばれます。

コミットにコメントを追加する

この方法で作成されたスレッドは、強制プッシュ後にコミットIDが変更されると失われます。

特定のコミットにディスカッションを追加するには:

  1. 左側のサイドバーで、検索または移動先を選択して、プロジェクトを見つけます。
  2. コード > コミットを選択します。
  3. コミットの下にあるコメントフィールドに、コメントを入力します。
  4. スタンドアロンコメントまたはスレッドとしてコメントを保存します:
    • コメントを追加するには、コメントを選択します。
    • スレッドを開始するには、下向き矢印( chevron-down )を選択し、**スレッドを開始します。**を選択します。

コミット間の差分を表示する

以前にマージされたコミット間の変更を表示するには:

  1. 左側のサイドバーで、検索または移動先を選択して、プロジェクトを見つけます。

  2. コード > マージリクエストを選択し、マージリクエストを選択します。

  3. 変更を選択します。

  4. 比較( file-tree )で、比較するコミットを選択します:

    以前にマージされたコミット

コンテキスト用に以前にマージされたコミットを追加するように選択した場合、これらのコミットもリストに表示されます。

変更を導入したマージリクエストを見つける

コミットの詳細ページを表示すると、GitLabはそのコミットを含む1つまたは複数のマージリクエストにリンクします。

この動作は、マージリクエストの最新バージョンにあるコミットにのみ適用されます。コミットがマージリクエストにあり、そのマージリクエストからリベースされた場合、そのコミットはリンクされません。