启动开发环境

重要

Dev Environments 不再处于积极开发阶段。

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

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

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

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

提示

安装 Dev Environments 浏览器扩展 用于 ChromeFirefox,以更快地启动开发环境。

先决条件

要开始使用开发环境,您还必须在您的机器上安装以下工具和扩展:

安装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

启动开发环境:

  1. 从 Docker 仪表板的 Dev Environments 选项卡中,选择 Create。将显示 Create a Dev Environment 对话框。
  2. 选择开始
  3. 可选:为您的开发环境提供一个名称。
  4. 选择现有的Git仓库作为源,然后将您的Git仓库链接粘贴到提供的字段中。
  5. 选择你的IDE。你可以选择以下任一选项:
    • Visual Studio Code。Git仓库被克隆到一个卷中,并附加到你的容器。这允许你直接在容器内使用Visual Studio Code进行开发。
    • 其他。Git仓库被克隆到你选择的本地目录中,并作为绑定挂载附加到你的容器。这将目录从你的计算机共享到容器,并允许你使用任何本地编辑器或IDE进行开发。
  6. 选择继续

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

从特定分支或标签启动

你可以从特定的分支启动开发环境,例如与拉取请求对应的分支,或者通过在你的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 无法检测子目录的主要语言。您需要在子目录中的 compose-dev.yaml 文件中定义自己的基础镜像或服务。有关如何配置的更多信息,请参阅 使用 Spring 后端和 MySQL 数据库的 React 应用程序示例使用 Nginx 代理和 Postgres 数据库的 Go 服务器示例

  1. 从 Docker 仪表板中的 Dev Environments 选择 Create。将显示 Create a Dev Environment 对话框。
  2. 选择开始
  3. 可选:为您的开发环境提供一个名称。
  4. 选择现有的Git仓库作为源,然后将您的Git仓库子文件夹的链接粘贴到提供的字段中。
  5. 选择你的IDE。你可以选择以下任一选项:
    • Visual Studio Code。Git仓库被克隆到一个卷中,并附加到你的容器。这允许你直接在容器内使用Visual Studio Code进行开发。
    • 其他。Git仓库被克隆到你选择的本地目录中,并作为绑定挂载附加到你的容器。这将目录从你的计算机共享到容器,并允许你使用任何本地编辑器或IDE进行开发。
  6. 选择继续

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

从本地文件夹启动

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

  2. 选择开始

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

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

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

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

注意

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

接下来是什么?

学习如何: