启动开发环境

重要

开发环境（Dev Environments）已不再处于活跃开发阶段。

虽然当前功能仍然可用，但我们的支持请求响应时间可能会延长。

你可以从以下任一方式启动开发环境：

• 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 "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 仪表板的 开发环境 选项卡中，选择 创建。将显示 创建开发环境 对话框。
2. 选择 开始使用。
3. 可选：为您的开发环境提供一个名称。
4. 选择 现有 Git 仓库 作为源，然后将您的 Git 仓库链接粘贴到提供的字段中。
5. 选择您的集成开发环境（IDE）。您可以选择以下任一选项：
   • Visual Studio Code。Git 仓库将被克隆到一个卷（Volume）中，并附加到您的容器上。这允许您直接在容器内部使用 Visual Studio Code 进行开发。
   • 其他。Git 仓库将被克隆到您选择的本地目录中，并以绑定挂载（bind mount）的方式附加到您的容器上。这会将您计算机上的该目录共享给容器，从而允许您使用任何本地编辑器或 IDE 进行开发。
6. 选择 继续。

要启动应用程序，请在终端中运行命令 make run。该命令将在端口 8080 上启动一个 HTTP 服务器。在浏览器中打开 http://localhost:8080 查看正在运行的应用程序。

从特定分支或标签启动

您可以从特定分支启动开发环境，例如对应于拉取请求（Pull Request）的分支，或通过在 Git URL 后添加 @mybranch 或 @tag 作为后缀来指定标签：

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

or

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

Docker 然后会使用您指定的分支或标签克隆该仓库。

从 Git 仓库的子文件夹启动

注意

目前，开发环境（Dev Environments）无法自动检测子目录中的主要编程语言。您需要在子目录中创建一个 compose-dev.yaml 文件，并自行定义基础镜像或服务。有关配置方法的更多信息，请参阅以下示例： 带 Spring 后端和 MySQL 数据库的 React 应用示例 或 带 Nginx 反向代理和 Postgres 数据库的 Go 服务器示例。

1. 在 Docker 仪表板的 开发环境 中，选择 创建。将显示 创建开发环境 对话框。
2. 选择 开始使用。
3. 可选：为您的开发环境提供一个名称。
4. 选择 现有 Git 仓库 作为源，然后将您的 Git 仓库子文件夹链接粘贴到提供的字段中。
5. 选择您的集成开发环境（IDE）。您可以选择以下任一选项：
   • Visual Studio Code。Git 仓库将被克隆到一个卷（Volume）中，并附加到您的容器上。这允许您直接在容器内部使用 Visual Studio Code 进行开发。
   • 其他。Git 仓库将被克隆到您选择的本地目录中，并以绑定挂载（bind mount）的方式附加到您的容器上。这会将您计算机上的该目录共享给容器，从而允许您使用任何本地编辑器或 IDE 进行开发。
6. 选择 继续。

要启动应用程序，请在终端中运行命令 make run。该命令将在端口 8080 上启动一个 HTTP 服务器。在浏览器中打开 http://localhost:8080 查看正在运行的应用程序。

从本地文件夹启动

1. 在 Docker 仪表板的 开发环境 中，选择 创建。将显示 创建开发环境 对话框。

2. 选择 开始使用。

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

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

5. 选择 选择 以打开您想要工作的代码的根目录。

   您的计算机中的一个目录被绑定挂载到容器中，因此您在本地所做的任何更改都会反映在开发环境中。您可以使用任意您喜欢的编辑器或集成开发环境（IDE）。

注意

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

接下来是什么？

了解如何：

• 搭建开发环境
• 分发您的开发环境