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.4. 使用 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>"
#https://github.com/che-samples/cpp-hello-world
?new&che-editor=che-incubator/intellij-community/latest&devfilePath=tests/testdevfile.yaml
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>Expand 表 2.1. 支持的 IDE 的 URL 参数 <editor_key > 值 IDE <editor_key>value备注 che-incubator/che-code/latest这是在没有使用 URL 参数或
che-editor.yaml时在新工作区中载入的默认 IDE。che-incubator/che-idea/latest技术预览。
eclipse/che-theia/latest弃用并将在以后的版本中删除。
che-editor=<url_to_a_file>"https://devspaces-<openshift_deployment_name>.<domain_name>"#<git_repository_url>?che-editor=<url_to_a_file>1 - 1
- 带有 devfile 内容的 文件的 URL。
提示- URL 必须指向原始文件内容。
-
要将此参数与
che-editor.yaml文件一起使用,请使用其他名称或路径复制文件,并从文件中删除内联行。
- che-editors.yaml 文件 具有所有支持的 IDE 的 devfile。
2.3.3. 用于启动重复工作区的 URL 参数 复制链接链接已复制到粘贴板!
访问启动新工作区的 URL 会根据 devfile 和链接的 Git 存储库的克隆生成新的工作区。
在某些情况下,您可能需要在 devfile 和链接的 Git 存储库时复制多个工作区。您可以使用 URL 参数访问启动新工作区的同一 URL。
用于启动重复工作区的 URL 参数是 新的 :
"https://devspaces-<openshift_deployment_name>.<domain_name>"#<git_repository_url>?new
如果您目前有一个使用 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
<filename > .yaml是链接 Git 存储库中 devfile 的不协调文件名。
df= <filename& gt; .yaml 参数也有一个长版本: devfilePath= <filename> .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
<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
- 可能的 <
;storage_type> 值:-
ephemeral -
每个用户(持久性) -
每个工作区(持久性)
-
使用 临时或 每个工作区 存储类型,您可以同时运行多个工作区,这无法使用默认的 按用户 存储类型。
其他资源
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>},...}
-
如果您没有为任何其他远程输入名称
origin,则来自 <git_repository_url> 的远程会被克隆,并默认命名为origin,并会作为自动签出的预期分支。 -
如果您为一个额外的远程输入了名称
origin,它的默认分支将被自动签出,当来自 <git_repository_url> 的远程将不会为工作区进行克隆。