將符號連結新增至GIT

目錄

< — 上一頁：Dispatcher健康狀態檢查

在AMS中，您會取得預先填入的GIT存放庫，其中包含您的Dispatcher原始程式碼成熟度，可讓您開始開發和自訂。

建立您的第一個.vhost檔案或最上層farm.any檔案後，您將需要從available_*目錄建立到enabled_*目錄的符號連結。 使用適當的連結型別將是透過Cloud Manager管道成功部署的關鍵。 此頁面可協助您瞭解如何執行此動作。

Dispatcher原型

AEM開發人員通常會從AEM原型開始他們的專案

以下是原始程式碼區域的範例，您可在此看到使用的符號連結：

$ tree dispatcher
dispatcher
└── src
   ├── conf.d
.....SNIP.....
    │   └── available_vhosts
    │   │   ├── 000_unhealthy_author.vhost
    │   │   ├── 000_unhealthy_publish.vhost
    │   │   ├── aem_author.vhost
    │   │   ├── aem_flush.vhost
    │   │   ├── aem_health.vhost
    │   │   ├── aem_lc.vhost
    │   │   └── aem_publish.vhost
    └── dispatcher_vhost.conf
    │   └── enabled_vhosts
    │   │   ├── aem_author.vhost -> ../available_vhosts/aem_author.vhost
    │   │   ├── aem_flush.vhost -> ../available_vhosts/aem_flush.vhost
    │   │   ├── aem_health.vhost -> ../available_vhosts/aem_health.vhost
    │   │   └── aem_publish.vhost -> ../available_vhosts/aem_publish.vhost
.....SNIP.....
    └── conf.dispatcher.d
    │   ├── available_farms
    │   │   ├── 000_ams_author_farm.any
    │   │   ├── 001_ams_lc_farm.any
    │   │   └── 002_ams_publish_farm.any
.....SNIP.....
    │   └── enabled_farms
    │   │   ├── 000_ams_author_farm.any -> ../available_farms/000_ams_author_farm.any
    │   │   └── 002_ams_publish_farm.any -> ../available_farms/002_ams_publish_farm.any
.....SNIP.....
17 directories, 60 files

例如，/etc/httpd/conf.d/available_vhosts/目錄包含我們可在執行組態中使用的暫存的潛在.vhost檔案。

啟用的.vhost檔案將在/etc/httpd/conf.d/enabled_vhosts/目錄中顯示為相對路徑symlinks。

建立符號連結

我們使用檔案的符號連結，因此Apache Webserver會將目的地檔案視為相同的檔案。 我們不想在兩個目錄中複製檔案。 而只是從某個目錄（符號連結）到另一個目錄的捷徑。

瞭解您部署的組態會針對Linux主機。 建立與目標系統不相容的symlink將會導致失敗和不需要的結果。

如果您的工作站不是Linux電腦，您可能會想知道要使用哪些命令來正確建立這些連結，以便這些連結能夠提交到GIT中。

TIP:使用相對連結很重要，因為如果您安裝了Apache Webserver的本機復本，且安裝基礎不同，連結仍可運作。 如果您使用絕對路徑，那麼您的工作站或其他系統都必須符合相同的確切目錄結構。

OSX / Linux

符號連結是這些作業系統的原生連結，以下是如何建立這些連結的一些範例。 開啟您最愛的終端機應用程式，並使用下列範例命令建立連結：

$ cd <LOCATION OF CLONED GIT REPO>\src\conf.d\enabled_vhosts
$ ln -s ../available_vhosts/<Destination File Name> <Target File Name>

以下是供參考的填入命令範例：

$ git clone https://github.com/adobe/aem-project-archetype.git
$ cd aem-project-archetype/src/main/archetype/dispatcher.ams/src/conf.d/enabled_vhosts/
$ ln -s ../available_vhosts/aem_flush.vhost aem_flush.vhost

如果您使用ls命令列出檔案，以下是現在連結的範例：

ls -l
total 0
lrwxrwxrwx. 1 root root 35 Oct 13 21:38 aem_flush.vhost -> ../available_vhosts/aem_flush.vhost

Windows

Note:原來MS Windows （較佳，NTFS）支援符號連結，因為……Windows Vista！

Warning:建立symlink的mklink命令需要系統管理員許可權才能正確執行。 即使是管理員帳戶，除非您已啟用開發人員模式，否則您將需要以管理員身分執行命令提示字元

不適當的許可權：


適當的許可權：

以下是建立連結的命令：

C:\<PATH TO SRC>\enabled_vhosts> mklink <Target File Name> ..\available_vhosts\<Destination File Name>

以下是供參考的填入命令範例：

C:\> git clone https://github.com/adobe/aem-project-archetype.git
C:\> cd aem-project-archetype\src\main\archetype\dispatcher.ams\src\conf.d\enabled_vhosts\
C:\aem-project-archetype\src\main\archetype\dispatcher.ams\src\conf.d\enabled_vhosts> mklink aem_flush.vhost ..\available_vhost\aem_flush.vhost
symbolic link created for aem_flush.vhost <<===>> ..\available_vhosts\aem_flush.vhost

開發人員模式( Windows 10 )

在開發人員模式中，Windows 10可讓您更輕鬆地測試您正在開發的應用程式、使用Ubuntu Bash殼層環境、變更各種以開發人員為中心的設定，以及執行其他類似動作。

Microsoft似乎會持續新增功能至開發人員模式，或是在這些功能獲得更廣泛採用且被視為穩定後，預設會啟用其中的部分功能（例如，使用建立者更新，Ubuntu Bash Shell環境不再需要開發人員模式）。

符號連結呢？ 啟用開發人員模式後，就不需要以提升的許可權執行命令提示字元來建立符號連結。 因此，在啟用開發人員模式後，任何使用者都可以建立符號連結。

啟用「開發人員模式」後，使用者應登出/登入，變更才會生效。

現在您無需以管理員身分執行即可看到命令運作

替代/程式化方法

有特定原則可允許特定使用者建立符號連結→ 建立符號連結(Windows 10) - Windows安全性 | Microsoft檔案

PRO：

CON：

使用者必須登出/登入，本機/群組原則變更才會生效。

執行gpedit.msc，視需要新增/變更使用者。 管理員預設存在

在GIT中啟用符號連結

Git會根據core.symlinks選項處理符號連結

Source： Git - git-config檔案

如果core.symlinks為false，符號連結會簽出為包含連結文字的小型純檔案。 git-update-index[1]和git-add[1]不會將記錄的型別變更為一般檔案。 對於不支援符號連結的檔案系統（例如FAT）非常有用。
預設值為true，除了git-clone[1]或git-init[1] will probe and set core.symlinks false if appropriate when the repository is created.在大多數情況下，Git會假設Windows對符號連結沒有好處，並將此設定為false。

以下說明Git在Windows上的行為：符號連結· git-for-windows/git Wiki · GitHub

Info：以上連結的檔案中所列的假設似乎與AEM Developer在Windows上的可能設定沒有關係，尤其是NTFS，而且我們只有檔案符號連結與目錄符號連結

好消息，因為Git for Windows 2.10.2版安裝程式有明確選項可啟用符號連結支援。

Warning： core.symlink選項可在執行階段複製存放庫時提供，或儲存為全域設定。

Windows適用的Git將在"C:\Program Files\Git\etc\gitconfig"中儲存全域偏好設定。 其他Git案頭使用者端應用程式可能不會考慮這些設定。
訣竅如下，並非所有開發人員都會使用Git原生使用者端（即Git Cmd、Git Bash），而部分Git案頭應用程式（如GitHub Desktop、Atlassian Sourcetree）可能有不同的設定/預設來使用System或內嵌Git

以下是gitconfig檔案中的內容範例

[diff "astextplain"]
    textconv = astextplain
[filter "lfs"]
    clean = git-lfs clean -- %f
    smudge = git-lfs smudge -- %f
    process = git-lfs filter-process
    required = true
[http]
    sslBackend = openssl
    sslCAInfo = C:/Program Files/Git/mingw64/ssl/certs/ca-bundle.crt
[core]
    autocrlf = true
    fscache = true
    symlinks = true
[pull]
    rebase = false
[credential]
    helper = manager-core
[credential "https://dev.azure.com"]
    useHttpPath = true
[init]
    defaultBranch = master

Git命令列提示

在某些情況下，您可能需要建立新的符號連結（例如新增主機或新陣列）。

我們在上述檔案中看到，Windows提供「mklink」命令來建立符號連結。

如果您在Git Bash環境中工作，您可以改用標準Bash命令ln -s，但必須使用如下列範例的特殊指示作為前置詞：

MSYS=winsymlinks:nativestrict ln -s test_vhost_symlink ../dispatcher/src/conf.d/available_vhosts/default.vhost

摘要

若要讓Git在Microsoft Windows作業系統上正確處理符號連結(至少是在目前AEM Dispatcher設定基準線的範圍內)，您需要：

Note:如果您已經有本機存放庫，則需要從來源重新複製。 您可以複製至新的位置，並手動將您未認可/未暫存的本機變更合併至新複製的存放庫。