Red Hat Summit Red Hat Summitサポートコンソール開発者トライアルの開始お問い合わせ

2.3. 新しいワークスペースを開始するための URL の任意のパラメーター

新しいワークスペースを開始すると、OpenShift Dev Spaces は devfile の指示に従ってワークスペースを設定します。URL を使用して新しいワークスペースを開始する場合は、ワークスペースをさらに設定する任意のパラメーターを URL に追加できます。これらのパラメーターを使用して、ワークスペース IDE を指定し、複製ワークスペースを開始し、devfile ファイル名またはパスを指定できます。

2.3.1. URL パラメーターの連結
リンクのコピー

新しいワークスペースを開始するための URL は、次の URL 構文で & を使用することにより、複数の任意の URL パラメーターの連結をサポートします。

https://<openshift_dev_spaces_fqdn>#<git_repository_url>?<url_parameter_1>&<url_parameter_2>&<url_parameter_3>

例2.8 Git リポジトリーの URL と任意の URL パラメーターを使用して新しいワークスペースを開始するための URL

ブラウザーの完全な URL:

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

URL の部分の説明: 

https://<openshift_dev_spaces_fqdn>
1 

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

?new&che-editor=che-incubator/intellij-community/latest&devfilePath=tests/testdevfile.yaml
3
1
OpenShift Dev Spaces URL
2
新しいワークスペースに複製される Git リポジトリーの URL。
3
連結された任意の URL パラメーター。

2.3.2. IDE の URL パラメーター
リンクのコピー

URL パラメーター che-editor= を使用して、ワークスペースの開始時にサポートされている IDE を指定できます。

ヒント

ソースコード Git リポジトリーで /.che/che-editor.yaml ファイルを追加または編集して、ワークスペース用に複製できない場合は、che-editor= パラメーターを使用します。

注記

che-editor= パラメーターは /.che/che-editor.yaml ファイルをオーバーライドします。

このパラメーターは、次の 2 種類の値を受け入れます。

  • che-editor=<editor_key> 

    https://<openshift_dev_spaces_fqdn>#<git_repository_url>?che-editor=<editor_key>
    Expand
    表2.1 サポートされている IDE の URL パラメーター <editor_key> の値
    IDE<editor_key> 値注記

    Microsoft Visual Studio Code - Open Source

    che-incubator/che-code/latest

    これは、URL パラメーターまたは che-editor.yaml が使用されていない場合に新しいワークスペースに読み込まれるデフォルトの IDE です。

    JetBrains IntelliJ IDEA コミュニティー版

    che-incubator/che-idea/latest

    テクノロジープレビュー。Dashboard を使用してこの IDE を選択します。

  • che-editor=<url_to_a_file> 

    https://<openshift_dev_spaces_fqdn>#<git_repository_url>?che-editor=<url_to_a_file>
    1
    1
    devfile の内容 を含むファイルへの URL。
    ヒント
    • URL は、RAW ファイルの内容を指している必要があります。
    • このパラメーターを che-editor.yaml ファイルで使用するには、ファイルを別の名前またはパスでコピーし、ファイルから inline の行を削除します。

2.3.3. 重複するワークスペースを開始するための URL パラメーター
リンクのコピー

新しいワークスペースを開始するために URL にアクセスすると、devfile に従って、リンクされた Git リポジトリーのクローンを使用して新しいワークスペースが作成されます。

状況によっては、devfile とリンクされた Git リポジトリーに関して重複する複数のワークスペースが必要になる場合があります。これを行うには、同じ URL にアクセスして、URL パラメーターを使用して新しいワークスペースを開始します。

複製ワークスペースを開始するための URL パラメーターは new です。 

https://<openshift_dev_spaces_fqdn>#<git_repository_url>?new
注記

現在 URL の使用を開始したワークスペースがある場合、new URL パラメーターを指定せずに URL に再度アクセスすると、エラーメッセージが表示されます。

2.3.4. devfile ファイル名の URL パラメーター
リンクのコピー

新しいワークスペースを開始するために URL にアクセスすると、OpenShift Dev Spaces は、リンクされた Git リポジトリーで、ファイル名が .devfile.yaml または devfile.yaml の devfile を検索します。リンクされた Git リポジトリー内の devfile は、このファイル命名規則に従う必要があります。

状況によっては、devfile に別の型にはまらないファイル名を指定する必要がある場合があります。

devfile の型にはまらないファイル名を指定するための URL パラメーターは df=<filename>.yaml です。 

https://<openshift_dev_spaces_fqdn>#<git_repository_url>?df=<filename>.yaml
1
1
<filename>.yaml は、リンクされた Git リポジトリー内の devfile の型にはまらないファイル名です。
ヒント

df=<filename>.yaml パラメーターにも長いバージョン (devfilePath=<filename>.yaml) があります。

2.3.5. devfile ファイルパスの URL パラメーター
リンクのコピー

新しいワークスペースを開始するために URL にアクセスすると、OpenShift Dev Spaces は、リンクされた Git リポジトリーの root ディレクトリーで、ファイル名が .devfile.yaml または devfile.yaml の devfile を検索します。リンクされた Git リポジトリー内の devfile のファイルパスは、このパス規則に従う必要があります。

状況によっては、リンクされた Git リポジトリー内の devfile に別の型にはまらないファイルパスを指定する必要がある場合があります。

devfile の型にはまらないファイルパスを指定するための URL パラメーターは devfilePath=<relative_file_path> です。 

https://<openshift_dev_spaces_fqdn>#<git_repository_url>?devfilePath=<relative_file_path>
1
1
<relative_file_path> は、リンクされた Git リポジトリー内の devfile の型にはまらないファイルパスです。

2.3.6. ワークスペースストレージの URL パラメーター
リンクのコピー

新規ワークスペースを起動する URL にストレージタイプを指定する URL パラメーターが含まれていない場合、新規ワークスペースは一時ストレージまたは永続ストレージに作成されます。これは、CheCluster カスタムリソースのデフォルトストレージタイプとして定義されます。

ワークスペースのストレージタイプを指定する URL パラメーターは、storageType= <storage_type> です。 

https://<openshift_dev_spaces_fqdn>#<git_repository_url>?storageType=<storage_type>
1
1
使用できる <storage_type> の値:
  • ephemeral
  • per-user (永続)
  • per-workspace (永続)
ヒント

ephemeral または per-workspace ストレージタイプを使用すると、複数のワークスペースを同時に実行できますが、これはデフォルト per-user ストレージタイプでは不可能です。

関連情報

2.3.7. 追加のリモートの URL パラメーター
リンクのコピー

新しいワークスペースを開始するための URL にアクセスすると、OpenShift Dev Spaces は origin リモートを、組織の OpenShift Dev Spaces インスタンスの FQDN URL の後に # で指定した Git リポジトリーになるように設定します。

ワークスペースの追加のリモートを複製および設定するための URL パラメーターは、remotes= です。 

https://<openshift_dev_spaces_fqdn>#<git_repository_url>?remotes={{<name_1>,<url_1>},{<name_2>,<url_2>},{<name_3>,<url_3>},...}
重要
  • 追加のリモートのいずれにも origin という名前を入力しない場合、<git_repository_url> からのリモートが複製され、デフォルトで origin という名前が付けられ、想定されるブランチが自動的にチェックアウトされます。
  • 追加のリモートの 1 つに名前 origin を入力すると、そのデフォルトブランチは自動的にチェックアウトされますが、<git_repository_url> からのリモートはワークスペース用に複製されません。

2.3.8. コンテナーイメージの URL パラメーター
リンクのコピー

次のシナリオでは、image パラメーターを使用して、コンテナーイメージへのカスタム参照を使用できます。

  • Git リポジトリーに devfile が含まれていないため、カスタムイメージを使用して新しいワークスペースを開始したい場合。
  • Git リポジトリーには devfile が含まれており、devfile の components セクションにリストされている最初のコンテナーイメージをオーバーライドしたい場合。

コンテナーイメージへのパスの URL パラメーターは image= です。 

https://<openshift_dev_spaces_fqdn>#<git_repository_url>?image=<container_image_url>

例

https://<openshift_dev_spaces_fqdn>#https://github.com/eclipse-che/che-docs?image=quay.io/devfile/universal-developer-image:ubi8-latest

Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2026 Red Hatトップに戻る