啟動開發環境

重要

開發環境已不再積極開發。

雖然目前的功能仍然可用,但我們可能需要更長的時間才能回應支援請求。

您可以從以下位置啟動開發環境

  • Git 儲存庫
  • Git 儲存庫的分支或標籤
  • Git 儲存庫的子資料夾
  • 本機資料夾

這不會與主機上設定的任何本機檔案或本機工具衝突。

提示

安裝適用於 ChromeFirefox開發環境瀏覽器擴充功能先決條件

若要開始使用開發環境,您也必須在您的機器上安裝下列工具和擴充功能

安裝 Git 後,請重新啟動 Docker Desktop。請選擇結束 Docker Desktop,然後再次啟動。

從 Git 儲存庫啟動開發環境

注意事項

使用 SSH 複製 Git 儲存庫時,請確認您已將 SSH 金鑰新增至 ssh-agent。方法是在終端機中開啟並執行 ssh-add <您的私密 SSH 金鑰路徑>

重要

如果您已在適用於 Windows 的 Docker Desktop 中啟用 WSL 2 整合,請確認您的 WSL 2 發行版本中正在執行 SSH 代理程式。

如果您的 WSL 2 發行版本沒有執行 ssh-agent,您可以在設定檔檔案 (也就是 ~/.profile、~/.zshrc 等) 的結尾附加此指令碼。

SSH_ENV="$HOME/.ssh/agent-environment"
function start_agent {
    echo "Initializing new SSH agent..."
    /usr/bin/ssh-agent | sed 's/^echo/#echo/' > "${SSH_ENV}"
    echo succeeded
    chmod 600 "${SSH_ENV}"
    . "${SSH_ENV}" > /dev/null
}
# Source SSH settings, if applicable
if [ -f "${SSH_ENV}" ]; then
    . "${SSH_ENV}" > /dev/null
    ps -ef | grep ${SSH_AGENT_PID} | grep ssh-agent$ > /dev/null || {
        start_agent;
    }
else
    start_agent;
fi

啟動開發環境

  1. 在 Docker Dashboard 的開發環境索引標籤中,選擇建立。此時會顯示建立開發環境對話方塊。
  2. 選擇開始使用
  3. 選用:為您的開發環境命名。
  4. 選擇現有的 Git 儲存庫作為來源,然後將您的 Git 儲存庫連結貼到提供的欄位中。
  5. 選擇您的 IDE。您可以選擇
    • Visual Studio Code。Git 儲存庫會複製到磁碟區並附加到您的容器。這讓您可以使用 Visual Studio Code 直接在容器內進行開發。
    • 其他。Git 儲存庫會複製到您選擇的本機目錄,並以繫結掛載的方式附加到您的容器。這會將您電腦上的目錄分享給容器,並讓您可以使用任何本機編輯器或 IDE 進行開發。
  6. 選擇繼續

要啟動應用程式,請在您的終端機中執行指令 make run。這會在連接埠 8080 上開啟 HTTP 伺服器。請在您的瀏覽器中開啟 http://localhost:8080從特定分支或標籤啟動

您可以從特定分支 (例如對應到提取請求的分支) 或標籤啟動開發環境,方法是在 Git URL 後面加上 @mybranch@tag 作為後綴。

https://github.com/dockersamples/single-dev-env@mybranch

git@github.com:dockersamples/single-dev-env.git@mybranch

然後,Docker 會使用您指定的分支或標籤複製儲存庫。

從 Git 儲存庫的子資料夾啟動

注意事項

目前,開發環境無法偵測子目錄的主要語言。您需要在位於子目錄中的 compose-dev.yaml 檔案中定義您自己的基礎映像或服務。如需如何設定的詳細資訊,請參閱 具有 Spring 後端和 MySQL 資料庫範例的 React 應用程式具有 Nginx 代理和 Postgres 資料庫範例的 Go 伺服器

  1. 在 Docker Dashboard 的開發環境中,選擇建立。此時會顯示建立開發環境對話方塊。
  2. 選擇開始使用
  3. 選用:為您的開發環境命名。
  4. 選擇現有的 Git 儲存庫作為來源,然後將您的 Git 儲存庫子資料夾的連結貼到提供的欄位中。
  5. 選擇您的 IDE。您可以選擇
    • Visual Studio Code。Git 儲存庫會複製到磁碟區並附加到您的容器。這讓您可以使用 Visual Studio Code 直接在容器內進行開發。
    • 其他。Git 儲存庫會複製到您選擇的本機目錄,並以繫結掛載的方式附加到您的容器。這會將您電腦上的目錄分享給容器,並讓您可以使用任何本機編輯器或 IDE 進行開發。
  6. 選擇繼續

要啟動應用程式,請在您的終端機中執行指令 make run。這會在連接埠 8080 上開啟 HTTP 伺服器。請在您的瀏覽器中開啟 http://localhost:8080從本機資料夾啟動

  1. 在 Docker Dashboard 的開發環境中,選擇建立。此時會顯示建立開發環境對話方塊。

  2. 選擇開始使用

  3. 選用:為您的開發環境命名。

  4. 選擇本機目錄作為來源。

  5. 選擇選擇以開啟您要處理的程式碼的根目錄。

    您電腦上的目錄會以繫結掛載的方式掛載到容器,因此您在本機進行的任何變更都會反映在開發環境中。您可以使用您選擇的編輯器或 IDE。

注意事項

當使用本機資料夾作為開發環境時,檔案變更會在您的環境容器與您的本機檔案之間同步。這可能會影響容器內的效能,取決於您本機資料夾中的檔案數量以及在容器中執行的作業。

後續步驟

瞭解如何