啟動開發環境

重要

開發環境不再處於積極開發中。

雖然當前功能仍然可用，但我們可能需要更長時間才能回覆支援請求。

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

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

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

提示

安裝 開發環境瀏覽器擴充套件 用於 Chrome 或 Firefox，以更快地啟動開發環境。

先決條件

要開始使用開發環境，您還必須在您的計算機上安裝以下工具和擴充套件

• Git。如果您是 Windows 使用者，請確保將 Git 新增到您的 PATH。
• Visual Studio Code
• Visual Studio Code 遠端容器擴充套件

安裝 Git 後，重新啟動 Docker Desktop。選擇 **退出 Docker Desktop**，然後再次啟動它。

從 Git 儲存庫啟動開發環境

注意

使用 SSH 克隆 Git 儲存庫時，請確保您已將 SSH 金鑰新增到 ssh-agent。為此，請開啟終端並執行 ssh-add <path to your private ssh key>。

重要

如果您已在 Docker Desktop for Windows 中啟用 WSL 2 整合，請確保您在 WSL 2 發行版中運行了 SSH 代理。

SSH_ENV="$HOME/.ssh/agent-environment"
function start_agent {
    echo "Initialising 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 伺服器。在您的瀏覽器中開啟 https://: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 伺服器。在您的瀏覽器中開啟 https://:8080 以檢視正在執行的應用程式。

從本地資料夾啟動

1. 從 Docker Dashboard 中的 **開發環境** 中，選擇 **建立**。將顯示 **建立開發環境** 對話方塊。

2. 選擇 **入門**。

3. 可選：為您的開發環境提供一個名稱。

4. 選擇 **本地目錄** 作為源。

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

   您的計算機上的目錄被繫結掛載到容器，因此您在本地進行的任何更改都會反映在開發環境中。您可以使用您選擇的編輯器或 IDE。

注意

在使用本地資料夾作為開發環境時，檔案更改會在您的環境容器和本地檔案之間同步。這會影響容器內部的效能，具體取決於本地資料夾中檔案的數量和容器中執行的操作。

下一步做什麼？

瞭解如何

• 設定開發環境
• 分發開發環境