git - Git キーワード拡張または代替

Question

このトピックに関するいくつかの投稿を読んで、キーワード置換の使用に反対するいくつかの短所があることに気付きました. それにもかかわらず、次の問題を解決する方法が必要であり、誰かが git を使用してこれを解決する方法についてアイデアを持っていることを願っています (キーワード置換を使用するかどうかにかかわらず):

VCS として git を使用するメインアプリケーションがあります。このメインアプリケーションの一部 (XML ファイルの特定のセット) は、私が git (別のリポジトリ) も使用するユーティリティによって使用されています。

現在、メインアプリとユーティリティのリリースサイクルは異なります。新しいバージョンのユーティリティをリリースするたびに、メインアプリケーションから最新の XML ファイルセットをコピーしています。ユーティリティ内では、この XML ファイルのセットは git のバージョン管理されていないコンテンツであるため、リポジトリにチェックインすることさえできません。

今のところ、このユーティリティのさまざまなリリース (git によって管理され、リリースにタグが付けられています) を見るたびに、含まれている XML ファイルのセットがどの「バージョン」(より良いのはコミットハッシュ) を参照しているかを知る方法がありません。 .

だから私は考えていました: それらの XML ファイル内に最新のコミット SHA を (コメントとして) 持つことができれば、ユーティリティの特定のバージョンが参照する XML ファイルのセットを常に知ることができます。このアプローチに何か問題がありますか、それともこれが進むべき道ですか? はいの場合、最新の commit-SHA を XML ファイルに入れるにはどうすればよいですか? ($Id:$ はコミット SHA を使用しないことを読みましたが、「ブロブ」-SHA を使用しますか?)

score 5 · Accepted Answer

二択

サブモジュールの使用

メインアプリをレポ + XML データのサブモジュールとしてビルドできます。git-repo の一部を別のレポのサブモジュールとして使用することはできず、完全なレポ (Git-boys、FIXME) のみを使用することはできないため、utility-repo を「スーパーモジュール」として再作成し、レポを 2 つに分割します - ユーティリティ + XML-データ

メインリポジトリも「スーパーモジュール」になり、1) メインアプリと 2) アプリの XML データが含まれます

Git はメインリポジトリとサブモジュールのチェンジセット間の厳密な関係をすべてのベースチェンジセット ID (Git-boys、FIXME) に対して維持しているため、メインアプリのハッシュのみを知り、XML データのこのチェンジセットスナップショットに関連付けることができます。

汚れ除去フィルター

リポジトリを完全に独立したものとして維持しながら、追跡データを XML ファイルに追加できます。Git 制御のデータに任意のキーワードを追加する適切な方法は、Smudge-clean フィルターです(「キーワード展開」セクションと $Date$ キーワード展開の例を参照してください)。

score 2 · Accepted Answer

考えられる解決策は、メインアプリケーションのビルドプロセスを拡張して、結果の 1 つがパッケージ化された XML ファイルになるようにすることです。このパッケージ化されたバージョンには、メインアプリケーションのバージョンに関する追加情報が含まれます。このようなパッケージは、外部ユーティリティなどとバンドルすると便利です。

git describeビルド中に、またはのいずれかを使用して git から直接バージョン情報を取得できますgit rev-parse HEAD(「現在の git コミット ID を Java webapp に注入する」を参照) 。

score 2 · Accepted Answer

その XML ファイルが Git によって追跡されていない場合、これには何の問題もありません。ビルドの基になっているハッシュを目に見える場所に置くのはかなり良い考えだと思います。これにより、何かが発生したときに、これが基になっているソースコードのバージョンを常に確認できます。

完全を期すために、追跡対象のファイル内にハッシュ値を含めることはできません。これは、Git が持つすべての情報に基づいてハッシュが作成されるためです。追跡されたファイルに値を挿入すると、そのファイルが変更され、別のコミットを行うか、以前のコミットを変更する必要があります。これにより、異なるハッシュ値が発生します。

ファイルは追跡されていないため、ファイルを変更してもハッシュ値は変更されないため、上記は問題になりません。現在の SHA1 ハッシュを取得する方法は複数ありますが、最も簡単なのはおそらく.git/refs/heads/master. そのファイルはブランチへのポインタであり、masterそのブランチの HEAD コミットのハッシュが含まれています。もちろん、必要/masterに応じて他のブランチに変更することもできます。

score 0 · Accepted Answer

皆さん、あなたの入力に基づいて、これが私がしたことです：

XML ファイルにプレースホルダーを挿入します。
ant に git のバージョン情報を取得させます。これは Windows であることに注意してください。
XML ファイルをコピーするときに、この情報を XML ファイルに挿入します。

コード：

<target name="getGitDetails">
    <exec executable="cmd" outputproperty="git.revision">
         <arg value="/c" />
         <arg value="git.cmd --git-dir=<path-to-repo> describe --long --dirty --always" />
    </exec>
     <exec executable="cmd" outputproperty="git.currentBranchRef">
         <arg value="/c" />
         <arg value="git.cmd --git-dir=<path-to-repo> describe --all" />
     </exec>
 </target>

 <target name="build" depends="getGitDetails">
     <copy todir="<dest-dir>">  
         <filterset>
             <filter token="GIT_VERSION" value="${git.currentBranchRef} ${git.revision}" />
         </filterset>
     </copy>
 </target>

ご協力いただきありがとうございます！

以下も参照してください。

Ant ビルドスクリプトから最新の git commit ハッシュを検索する方法

`git describe` からアプリケーションビルドバージョンを取得する - 比較的単純な文字列を取得する方法は?

git - Git キーワード拡張または代替

4 に答える 4

Related

Reference