Help us understand the problem. What is going on with this article?

Git for Windowsでシンボリックリンクを扱えるようにする

More than 3 years have passed since last update.

概要

Git for Windowsはデフォルトでシンボリックリンクが扱えないようになっています。しかしそれではUnix系OSとリポジトリを共有して開発する場合などで不便なため、Unix系OSと同等にシンボリックリンクを扱えるように設定します。
内容としては、↓の元ネタを整理・補足するようなものとなります。

確認した環境

  • Windows 10: build 14986.1001
  • Git for Windows: 2.11.1.20170208
  • Polsedit: 1.0.0.5

事前準備:一般ユーザにシンボリックリンクを作る権限を与える

Windowsでシンボリックリンクを作成するには管理者権限が必要なのですが、git cloneln -sを実行するためにわざわざ管理者権限を付与したくないですよね。
元ネタにあるように、グループポリシーエディタがあれば、SeCreateSymbolicLinkPrivilege権限を一般ユーザに与えることによって、管理者権限不要でシンボリックリンクを作成することができるようになります。
しかし、グループポリシーエディタは、WindowsのProエディション以上にしか付属しておらず、おそらくほとんどの方が利用されているであろうHomeエディション以下には付属していないのです。
そこで、元ネタにはPolseditというフリーのローカルポリシーエディタのクローンが紹介されています。
これを使うことで上記の権限設定を行うことができます。

追記1:
@ubnt_intrepidさんのコメントにあるように、editrightsコマンドを用いてもSeCreateSymbolicLinkPrivilege権限を一般ユーザに付与することができるようです。

追記2:
@ubnt_intrepidさんのコメントにあるように、2017年3月に公開されると言われているWindows 10 Creators Updateでは、デフォルトの状態でも開発者モードにすることで管理者権限なしでシンボリックリンクが作成できるようになるようです。よって、Creators Update以降は、この節の作業は不要になりますね。 ただし、コメントにあるWindowsブログの記事によると、この変更自体はbuild 14972から提供されているのですが、管理者権限が不要になるのは、mklinkコマンドを使った場合と、CreateSymbolicLink APIを特別なフラグを付けて呼んだ場合だけのようです。git bashのlnコマンドはまだフラグに対応していないのか、この記事の作成時点で私が試した限りでは、管理者権限がなければシンボリックリンクが作成できませんでした。
(↑2017/03/05 22:59 開発者モードへの変更が必要なこと、lnコマンドにはまだ管理者権限が必要だったことを追記)

Polseditで一般ユーザにシンボリックリンク作成権限を付与する

Polseditのzipを展開し、polsedit.exeを実行してください。
実行には管理者権限が必要です。

1. Policy一覧からCreate symbolic linksを開く

画面の右ペインに編集可能なポリシーの一覧が表示されるので、その中からCreate symbolic linksポリシーをダブルクリック等で開きます。

Polsedit_policies_list.png

以下のようなダイアログが表示されます。
デフォルト状態では、Administratorsグループだけに権限が付与されています。

Polsedit_Create_symbolic_links_Properties_before.png

ここに、一般ユーザを表すUsersグループを追加することによって、一般ユーザでもシンボリックリンクを作成できるようにします。

2. Usersグループに権限を与える

Add User or Group...ボタンをクリックすると、権限を与えるユーザとグループを選択するダイアログが表示されます。

Polsedit_Select_Users_or_Groups.png

私が試したところでは、初期状態ではこの一覧にはグループが表示されておらず、Object Types...ボタンを押して表示されるダイアログでGroupsにもチェックを入れる必要がありました。

Polsedit_Object_Types.png

一覧からUsersを選択し、OKボタンを押します。
最初のダイアログが以下のような状態になっていれば成功です。

Polsedit_Create_symbolic_links_Properties_after.png

設定を反映するために一度サインオフすることが求められるので、サインオフして再度サインインしましょう。

git cloneでリポジトリに含まれるシンボリックリンクを正しく再現できるようにする

Git for Windowsでgit cloneを行うと、デフォルトではリポジトリに含まれるシンボリックリンクが、リンク先を示す文字列が書かれたただのテキストファイルになってしまいます。
gitconfigのcore.symlinkstrueに設定することで、リポジトリに含まれるシンボリックリンクがきちんとシンボリックリンクとして扱われるようになります。
元ネタでは、git clone時にオプションを渡す方法を解説していますが、gitconfigを設定してしまったほうが便利だと思います。

$ git config --global core.symlinks=true

git bashのln -sコマンドでシンボリックリンクを作れるようにする

元ネタでは「ln -sコマンドではファイルのコピーを作るようになっているので、mklinkコマンドを使ってね」とありますが、以下の設定をすればln -sでもシンボリックリンクが作成できるようになります。

環境変数MSYSwinsymlinks:nativestrictを設定する

MSYSでは上記見出しにあるような設定をすることで、Windowsネイティブのシンボリックリンクが作成できるようになります。git bashはMSYS由来の環境なので、同様の設定が有効のようです。
私はWindowsのユーザ環境変数に設定しましたが、システム環境変数やgit bashの環境変数に設定してもうまくいくと思います(未確認)。
Windowsの環境変数を設定する場合、コントロールパネルから環境変数のメニューを辿ってもいいのですが、setxコマンドを使うと一発で環境変数をセットできるのでオススメです。
setxコマンドを使ってユーザ環境変数へ上記設定を行うには以下のようにします。

> setx MSYS winsymlinks:nativestrict

参考:

シンボリックリンクをコミットしても大丈夫

前述の方法で作成したシンボリックリンクをリポジトリにコミットし、他のマシン(Windows, Linux)でgit cloneしたところ、正しくシンボリックリンクとして取り出せることを確認しました。
これでWindowsでも安心してシンボリックリンクが使えますね。

Why not register and get more from Qiita?
  1. We will deliver articles that match you
    By following users and tags, you can catch up information on technical fields that you are interested in as a whole
  2. you can read useful information later efficiently
    By "stocking" the articles you like, you can search right away
Comments
No comments
Sign up for free and join this conversation.
If you already have a Qiita account
Why do not you register as a user and use Qiita more conveniently?
You need to log in to use this function. Qiita can be used more conveniently after logging in.
You seem to be reading articles frequently this month. Qiita can be used more conveniently after logging in.
  1. We will deliver articles that match you
    By following users and tags, you can catch up information on technical fields that you are interested in as a whole
  2. you can read useful information later efficiently
    By "stocking" the articles you like, you can search right away
ユーザーは見つかりませんでした