Red Hat Summit 红帽全球峰会支持控制台（Console）开发人员开始试用联系人

2.3. 启动新的工作区的 URL 的可选参数

当您启动新的工作区时，OpenShift Dev Spaces 根据 devfile 中的说明配置工作区。当使用 URL 启动新工作区时，您可以将可选参数附加到进一步配置工作区的 URL 中。您可以使用这些参数来指定工作区 IDE，启动重复工作区，并指定 devfile 文件名或路径。

2.3.1. URL 参数串联
复制链接

启动新的工作区的 URL 支持通过使用以下 URL 语法的 & amp; 来串联多个可选 URL 参数：

"https://devspaces-<openshift_deployment_name>.<domain_name>"#<git_repository_url>?<url_parameter_1>&<url_parameter_2>&<url_parameter_3>

例 2.5. 使用 Git 存储库和可选 URL 参数的 URL 来启动新工作区的 URL

浏览器的完整 URL：

"https://devspaces-<openshift_deployment_name>.<domain_name>"#https://github.com/che-samples/cpp-hello-world?new&che-editor=che-incubator/intellij-community/latest&devfilePath=tests/testdevfile.yaml

URL 部分的说明： 

"https://devspaces-<openshift_deployment_name>.<domain_name>"
1 

#https://github.com/che-samples/cpp-hello-world
2 

?new&che-editor=che-incubator/intellij-community/latest&devfilePath=tests/testdevfile.yaml
3
Copy to Clipboard Toggle word wrap
1
OpenShift Dev Spaces URL。
2
要克隆到新工作区中的 Git 存储库的 URL。
3
串联的可选 URL 参数。

2.3.2. IDE 的 URL 参数
复制链接

您可以在启动工作区时使用 che-editor= URL 参数指定受支持的 IDE。

提示

当您无法在 source-code Git 仓库中添加或编辑 /.che/che-editor.yaml 文件时，请使用 che-editor= 参数来为工作区克隆。

注意

che-editor= 参数覆盖 /.che/che-editor.yaml 文件。

此参数接受两种类型的值：

  • che-editor=<editor_key> 

    "https://devspaces-<openshift_deployment_name>.<domain_name>"#<git_repository_url>?che-editor=<editor_key>
    Copy to Clipboard Toggle word wrap
    Expand
    表 2.1. 支持的 IDE 的 URL 参数 <editor_key > 值
    IDE<editor_key> value备注

    Microsoft Visual Studio Code - Open Source

    che-incubator/che-code/latest

    这是在没有使用 URL 参数或 che-editor.yaml 时在新工作区中载入的默认 IDE。

    JetBrains IntelliJ IDEA Community Edition

    che-incubator/che-idea/latest

    技术预览。

  • che-editor=<url_to_a_file> 

    "https://devspaces-<openshift_deployment_name>.<domain_name>"#<git_repository_url>?che-editor=<url_to_a_file>
    1
    Copy to Clipboard Toggle word wrap
    1
    带有 devfile 内容的 文件的 URL。
    提示
    • URL 必须指向原始文件内容。
    • 要将此参数与 che-editor.yaml 文件一起使用，请使用其他名称或路径复制文件，并从文件中删除 内联 行。

2.3.3. 用于启动重复工作区的 URL 参数
复制链接

访问启动新工作区的 URL 会根据 devfile 和链接的 Git 存储库的克隆生成新的工作区。

在某些情况下，您可能需要在 devfile 和链接的 Git 存储库时复制多个工作区。您可以使用 URL 参数访问启动新工作区的同一 URL。

用于启动重复工作区的 URL 参数是 新的 ： 

"https://devspaces-<openshift_deployment_name>.<domain_name>"#<git_repository_url>?new
Copy to Clipboard Toggle word wrap
注意

如果您目前有一个使用 URL 启动的工作区，则在没有 新 URL 参数的情况下再次访问 URL 会导致错误消息。

2.3.4. devfile 文件名的 URL 参数
复制链接

当您访问启动新工作区的 URL 时，OpenShift Dev Spaces 会使用文件名 .devfile.yaml 或 devfile.yaml 为 devfile 搜索链接的 Git 存储库。链接的 Git 存储库中的 devfile 必须遵循这个文件。

在某些情况下，您可能需要为 devfile 指定不同的非关系文件名。

用于指定 devfile 的未协调文件名的 URL 参数为 df= <filename>.yaml ： 

"https://devspaces-<openshift_deployment_name>.<domain_name>"#<git_repository_url>?df=<filename>.yaml
1
Copy to Clipboard Toggle word wrap
1
<filename > .yaml 是链接 Git 存储库中 devfile 的不协调文件名。
提示

df= &lt;filename& gt; .yaml 参数也有一个长版本： devfilePath= <filename&gt; .yaml。

2.3.5. devfile 文件路径的 URL 参数
复制链接

当您访问启动新工作区的 URL 时，OpenShift Dev Spaces 会在链接 Git 存储库的根目录中搜索名为 .devfile.yaml 或 devfile.yaml 的 devfile。链接 Git 存储库中的 devfile 的文件路径必须遵循这个路径惯例。

在某些情况下，您可能需要在链接的 Git 存储库中为 devfile 指定不同的非协调文件路径。

用于指定 devfile 的非协调文件路径的 URL 参数是 devfilePath= <relative_file_path> ： 

"https://devspaces-<openshift_deployment_name>.<domain_name>"#<git_repository_url>?devfilePath=<relative_file_path>
1
Copy to Clipboard Toggle word wrap
1
<relative_file_path > 是链接 Git 存储库中 devfile 的非协调文件路径。

2.3.6. 工作区存储的 URL 参数
复制链接

如果启动新工作区的 URL 不包含指定存储类型的 URL 参数，则新工作区会在临时存储或持久性存储中创建新的工作区，每当被定义为 CheCluster 自定义资源中的默认存储类型。

为工作区指定存储类型的 URL 参数是 storage Type= <storage_type> ： 

"https://devspaces-<openshift_deployment_name>.<domain_name>"#<git_repository_url>?storageType=<storage_type>
1
Copy to Clipboard Toggle word wrap
1
可能的 &lt ;storage_type&gt; 值：
  • ephemeral
  • per-user (persistent)
  • 每个工作区 （持久性）
提示

使用 临时或 每个工作区 存储类型，您可以同时运行多个工作区，这无法使用默认的 按用户 存储类型。

其他资源

2.3.7. 其他远程的 URL 参数
复制链接

当您访问一个 URL 来启动新的工作区时，OpenShift Dev Spaces 会将 origin 远程配置为 Git 存储库，您在您的机构 OpenShift Dev Spaces 实例的 FQDN URL 后指定 #。

用于克隆和配置工作区额外远程的 URL 参数是 remotes= ： 

"https://devspaces-<openshift_deployment_name>.<domain_name>"#<git_repository_url>?remotes={{<name_1>,<url_1>},{<name_2>,<url_2>},{<name_3>,<url_3>},...}
Copy to Clipboard Toggle word wrap
重要
  • 如果您没有为任何其他远程输入名称 origin，则来自 <git_repository_url> 的远程会被克隆，并默认命名为 origin，并会作为自动签出的预期分支。
  • 如果您为一个额外的远程输入了名称 origin，它的默认分支将被自动签出，当来自 <git_repository_url> 的远程将不会为工作区进行克隆。
返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务，以及可以信赖的内容，帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情，请参阅红帽博客.

關於紅帽

我们提供强化的解决方案，使企业能够更轻松地跨平台和环境（从核心数据中心到网络边缘）工作。

Theme

© 2025 Red Hat