启动开发环境

重要

开发环境不再处于积极开发状态。

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

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

• Git 存储库
• Git 存储库的分支或标签
• Git 存储库的子文件夹
• 本地文件夹

这与主机上设置的任何本地文件或本地工具不冲突。

提示

安装适用于 Chrome 或 Firefox 的 Dev Environments 浏览器扩展，以更快地启动开发环境。

先决条件

要开始使用 Dev Environments，您还必须在计算机上安装以下工具和扩展：

• Git 的 Git 中。如果您是 Windows 用户，请确保将 Git 添加到您的 PATH 中。
• Visual Studio 代码
• Visual Studio Code 远程容器扩展

安装 Git 后，重启 Docker Desktop。选择 Quit Docker Desktop，然后再次启动它。

从 Git 存储库启动开发环境

注意

使用 SSH 克隆 Git 存储库时，请确保已将 SSH 密钥添加到 ssh-agent。为此，请打开终端并运行 。ssh-add <path to your private ssh key>

重要

如果您已在适用于 Windows 的 Docker Desktop 中启用了 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 Dashboard 的 Dev Environments 选项卡中，选择 Create。此时将显示 Create a Dev Environment 对话框。
2. 选择 Get Started（开始使用）。
3. 可选：为您的开发环境提供一个名称。
4. 选择 Existing Git repo （现有 Git 存储库） 作为源，然后将 Git 存储库链接粘贴到提供的字段中。
5. 选择您的 IDE。您可以选择：
   • Visual Studio 代码。Git 存储库将克隆到卷中并附加到您的容器中。这允许您使用 Visual Studio Code 直接在它们内部进行开发。
   • 其他。Git 存储库将克隆到您选择的本地目录中，并作为绑定挂载附加到您的容器。这将从您的计算机共享目录到容器，并允许您使用任何本地编辑器或 IDE 进行开发。
6. 选择 Continue（继续）。

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

从特定分支或标签启动

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

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

或

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

然后，Docker 使用您指定的分支或标签克隆存储库。

从 Git 存储库的子文件夹启动

注意

目前，Dev Environments 无法检测子目录的主语言。您需要在位于子目录中的文件中定义自己的基础镜像或服务。有关如何配置的更多信息，请参阅具有 Spring 后端和 MySQL 数据库示例的 React 应用程序或具有 Nginx 代理和 Postgres 数据库示例的 Go 服务器。compose-dev.yaml

1. 从 Docker 仪表板的开发环境中，选择创建。此时将显示 Create a Dev Environment 对话框。
2. 选择 Get Started（开始使用）。
3. 可选：为您的开发环境提供一个名称。
4. 选择 Existing Git repo 作为源，然后将 Git 存储库子文件夹的链接粘贴到提供的字段中。
5. 选择您的 IDE。您可以选择：
   • Visual Studio 代码。Git 存储库将克隆到卷中并附加到您的容器中。这允许您使用 Visual Studio Code 直接在它们内部进行开发。
   • 其他。Git 存储库将克隆到您选择的本地目录中，并作为绑定挂载附加到您的容器。这将从您的计算机共享目录到容器，并允许您使用任何本地编辑器或 IDE 进行开发。
6. 选择 Continue（继续）。

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

从本地文件夹启动

1. 从 Docker 仪表板的开发环境中，选择创建。此时将显示 Create a Dev Environment 对话框。

2. 选择 Get Started（开始使用）。

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

4. 选择 Local directory （本地目录） 作为源。

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

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

注意

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

下一步是什么？

了解如何：

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