启动开发环境
重要
开发环境已不再积极开发。
虽然当前功能仍然可用,但我们对支持请求的响应时间可能会较长。
您可以从以下位置启动开发环境:
- Git 仓库
- Git 仓库的分支或标签
- Git 仓库的子文件夹
- 本地文件夹
这不会与您主机上设置的任何本地文件或本地工具冲突。
提示
安装 Dev Environments 浏览器扩展 用于 Chrome 或 Firefox,以更快地启动开发环境。
先决条件
要开始使用开发环境,您还必须在您的机器上安装以下工具和扩展
- Git。如果您是 Windows 用户,请确保将 Git 添加到您的 PATH 环境变量中。
- Visual Studio Code
- Visual Studio Code Remote Containers 扩展
安装 Git 后,重启 Docker Desktop。选择**退出 Docker Desktop**,然后再次启动。
从 Git 仓库启动开发环境
注意
使用 SSH 克隆 Git 仓库时,请确保已将您的 SSH 密钥添加到 ssh-agent。为此,请打开终端并运行
ssh-add <您的私钥路径>
。
重要
如果您在 Windows 版 Docker Desktop 中启用了 WSL 2 集成,请确保您的 WSL 2 发行版中正在运行 SSH 代理。
如果您的 WSL 2 发行版没有运行ssh-agent
,您可以将此脚本添加到配置文件的末尾(例如:~/.profile、~/.zshrc 等)。
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
启动开发环境
- 在 Docker Dashboard 的**开发环境**选项卡中,选择**创建**。将显示**创建开发环境**对话框。
- 选择**开始**。
- 可选:为您的开发环境提供名称。
- 选择**现有 Git 仓库**作为源,然后将您的 Git 仓库链接粘贴到提供的字段中。
- 选择您的 IDE。您可以选择:
- Visual Studio Code。Git 仓库将克隆到一个卷中,并连接到您的容器。这允许您使用 Visual Studio Code 直接在容器内进行开发。
- 其他。Git 仓库将克隆到您选择的本地目录中,并作为绑定挂载连接到您的容器。这将共享您计算机上的目录到容器,并允许您使用任何本地编辑器或 IDE 进行开发。
- 选择**继续**。
要启动应用程序,请在您的终端中运行命令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 服务器示例。
- 在 Docker Dashboard 的**开发环境**中,选择**创建**。将显示**创建开发环境**对话框。
- 选择**开始**。
- 可选:为您的开发环境提供名称。
- 选择**现有 Git 仓库**作为源,然后将您的 Git 仓库子文件夹链接粘贴到提供的字段中。
- 选择您的 IDE。您可以选择:
- Visual Studio Code。Git 仓库将克隆到一个卷中,并连接到您的容器。这允许您使用 Visual Studio Code 直接在容器内进行开发。
- 其他。Git 仓库将克隆到您选择的本地目录中,并作为绑定挂载连接到您的容器。这将共享您计算机上的目录到容器,并允许您使用任何本地编辑器或 IDE 进行开发。
- 选择**继续**。
要启动应用程序,请在您的终端中运行命令make run
。这将在 8080 端口上打开一个 http 服务器。在您的浏览器中打开https://#:8080查看正在运行的应用程序。
从本地文件夹启动
在 Docker Dashboard 的**开发环境**中,选择**创建**。将显示**创建开发环境**对话框。
选择**开始**。
可选:为您的开发环境提供名称。
选择**本地目录**作为源。
选择**选择**以打开您要处理的代码的根目录。
您的计算机中的目录将绑定挂载到容器中,因此您在本地进行的任何更改都会反映在开发环境中。您可以使用您选择的编辑器或 IDE。
注意
当使用本地文件夹作为开发环境时,文件更改会在您的环境容器和本地文件之间同步。这可能会影响容器内的性能,具体取决于本地文件夹中的文件数量和在容器中执行的操作。
下一步是什么?
学习如何