启动开发环境

重要的

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

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

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

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

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

提示

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

先决条件

开发环境作为 Docker Desktop 3.5.0 版本的一部分提供。下载并安装Docker Desktop 3.5.0或更高版本：

• Docker 桌面

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

• 吉特.如果您是 Windows 用户，请确保将 Git 添加到您的 PATH。
• 视觉工作室代码
• Visual Studio Code 远程容器扩展

安装 Git 后，重新启动 Docker Desktop。选择退出 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 "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 仪表板的“开发环境”中，选择“创建”。将显示“创建开发环境”对话框。
2. 选择开始。
3. 可选：为您的开发环境提供名称。
4. 选择现有的 Git 存储库作为源，然后将您的 Git 存储库链接粘贴到提供的字段中。
5. 选择您的 IDE。您可以选择：
   • Visual Studio 代码. Git 存储库被克隆到一个卷中并附加到您的容器。这允许您使用 Visual Studio Code 直接在其中进行开发。
   • 其他。 Git 存储库将克隆到您选择的本地目录中，并作为绑定安装附加到您的容器。这会将目录从您的计算机共享到容器，并允许您使用任何本地编辑器或 IDE 进行开发。
6. 选择继续。

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

从特定分支或标签启动

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

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 仪表板的“开发环境”中，选择“创建”。将显示“创建开发环境”对话框。
2. 选择开始。
3. 可选：为您的开发环境提供名称。
4. 选择现有的 Git 存储库作为源，然后将 Git 存储库子文件夹的链接粘贴到提供的字段中。
5. 选择您的 IDE。您可以选择：
   • Visual Studio 代码. Git 存储库被克隆到一个卷中并附加到您的容器。这允许您使用 Visual Studio Code 直接在其中进行开发。
   • 其他。 Git 存储库将克隆到您选择的本地目录中，并作为绑定安装附加到您的容器。这会将目录从您的计算机共享到容器，并允许您使用任何本地编辑器或 IDE 进行开发。
6. 选择继续。

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

从本地文件夹启动

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

2. 选择开始。

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

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

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

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

笔记

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

下一步是什么？

了解如何：

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