启动开发环境

重要

开发环境不再处于积极开发中。

虽然当前功能仍然可用，但我们可能需要更长时间才能回复支持请求。

您可以从以下位置启动开发环境

• 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://127.0.0.1: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://127.0.0.1:8080 以查看正在运行的应用程序。

从本地文件夹启动

1. 从 Docker Dashboard 中的 **开发环境** 中，选择 **创建**。将显示 **创建开发环境** 对话框。

2. 选择 **入门**。

3. 可选：为您的开发环境提供一个名称。

4. 选择 **本地目录** 作为源。

5. 选择 **选择** 以打开您要处理的代码的根目录。

   您的计算机上的目录被绑定挂载到容器，因此您在本地进行的任何更改都会反映在开发环境中。您可以使用您选择的编辑器或 IDE。

注意

在使用本地文件夹作为开发环境时，文件更改会在您的环境容器和本地文件之间同步。这会影响容器内部的性能，具体取决于本地文件夹中文件的数量和容器中执行的操作。

下一步做什么？

了解如何

• 设置开发环境
• 分发开发环境