リリースノートおよび既知の問題

Red Hat CodeReady Workspaces 2.5

Red Hat CodeReady Workspaces 2.5 のリリースノートおよび既知の問題

概要

Red Hat CodeReady Workspaces 2.5 の既知の問題および主な問題

第1章 リリースノート

Red Hat CodeReady Workspaces は、Web ベースの統合開発環境 (IDE) です。CodeReady Workspaces は OpenShift で実行し、コンテナーベースの開発に適しています。

本セクションでは、Red Hat CodeReady Workspaces で最も重要な機能およびバグ修正について説明します。CodeReady Workspaces 2.5 リリースの問題の一覧については、3章既知の問題 セクションを参照してください。

  • CodeReady Workspaces から OpenShift クラスターにアプリケーションをデプロイするには、ユーザーは oc login を使用して実行中のワークスペースから OpenShift クラスターにログインする必要があります。
  • 同じクラスターで複数の CodeReady Workspaces デプロイメントを使用することは推奨されず、今後のリリースで削除される可能性があります。
  • 最適なパフォーマンスを得るには、CodeReady Workspaces で使用される永続ボリュームにブロックストレージを使用します。

1.1. Red Hat CodeReady Workspaces について

Red Hat CodeReady Workspaces 2.5 は、エンタープライズレベルのクラウド開発者ワークスペースサーバーおよびブラウザーベースの IDE を提供します。CodeReady Workspaces には、最も人気の高いプログラミング言語、フレームワーク、および Red Hat テクノロジー用に、すぐに使用できる開発者スタックが含まれています。

Red Hat CodeReady Workspaces のこのマイナーリリースは Eclipse Che 7.20.1 をベースとしており、以下を含む数多くの拡張機能および新機能を提供します。

  • ワークスペースの開始および全体的なパフォーマンスの向上
  • バグ修正

    • JavaSpringBoot devfile のデバッグセッションが失敗する問題が修正されました。

      CRW-1234

    • PHP の依存関係をインストールした後のブラウザーの更新に関する注意点。

      CRW-981

  • 言語の更新

    • OpenShift Connector プラグイン 0.2.0
    • vscode-yaml plug-in 0.11.1

CodeReady Workspaces 2.5 は Red Hat Container Catalog で利用できます。『インストールガイド』の「OpenShift Container Platform 3.11 への CodeReady Workspaces のインストール」の手順に従って、これを OpenShift Container Platform 3.11 以降にインストールします。

CodeReady Workspaces 2.5 は、OpenShift 4.4 以降の OperatorHub から利用できます。CodeReady Workspaces 2.5 は Operator Lifecycle Manager を使用する新規 Operator をベースとしています。これにより、OpenShift コンソールを離れることなく、CodeReady Workspaces インストールフローが簡単かつ実行可能になります。

OpenShift 4. 4 以降の CodeReady Workspaces をインストールするには、OperatorHub から CodeReady Workspaces を取得し、『インストールガイド』の「OperatorHub からの CodeReady Workspaces のインストール」の章に従ってください。

1.2. 主な機能拡張

1.2.1. IBM Power Systems のサポート [テクノロジープレビュー]

CodeReady Workspaces は、OperatorHub を使用して IBM Power Systems で実行される OpenShift の Operator としてデプロイできるようになりました。

  • IBM Power Systems は以下でサポートされます。

    • OpenShift Container Platform 4.5
    • OpenShift Container Platform 4.6
  • IBM Power Systems は、OpenShift Container Platform 4.6 での制限された環境でのインストールをサポートします。

1.2.2. ワイルドカード証明書を作成する必要がない

今回の更新により、ワイルドカード TLS 証明書を使用できない OpenShift で実行されるワークスペースのサポートが追加されました。

1.2.3. 単一ホストモードのサポート

単一ホストモードは、内部で実行されるリバースプロキシーを持つ特別な Pod を使用して要求をルーティングする特別な Pod を使用する gateway という名前のサブタイプで公開ストラテジーを有効にします。

single-host ストラテジーが使用される場合、すべてのワークスペースはメインの CodeReady Workspaces サーバードメインのサブパスにデプロイされます。

single-host モードでは、ユーザーはワイルドカード TLS 証明書を使用する必要はありません。

1.2.4. 新規の OpenShift Container Platform 4.6 Operator インデックスイメージバンドルのサポート

OpenShift Container Platform 4.6 では、イメージインデックスバンドルから Operator をインストールする方法が導入されました。これにより、Operator のインストール方法は OpenShift Container Platform 4.5 と互換性がありません。これには、メタデータをフォーマットして異なる方法で公開する必要があります。

OpenShift Container Platform 4.5 の CodeReady Workspaces 2.5 は、以前のバージョンの CodeReady Workspaces で認識される古い形式で利用できます。

1.3. その他の機能拡張

1.3.1. OpenShift Connector 0.2.0 の更新

OpenShift Connector の 0.2.0 バージョンは、odo CLI 2.0 devfile サポートを提供します。

1.3.2. ノード 12 の更新

  • plugin-java8-rhel8 および plugin-java8-openj9-rhel8 イメージが Node 10 から Node 12 に更新されました。

1.4. サポートの終了と非推奨化

1.4.1. Thorntail サポートと Quarkus による置換の終了

Thorntail はサポートされなくなったため、関連付けられた devfile は CodeReady Workspaces 2.5 から削除されました。ユーザーは代わりに Quarkus devfile を使用して、パフォーマンス調整された Java アプリケーションが発生する可能性があります。

第2章 CodeReady Workspaces のインストールおよびデプロイ

OpenShift 3.11 の場合は、『管理者ガイド』の「 OpenShift Container Platform 3.11 での CodeReady Workspaces のインストール 」の章を参照してください。

OpenShift 4.6 の場合は、『インストールガイド』の「 Operator Hub からの CodeReady Workspaces のインストール」の章を参照してください。

2.1. サポートされるデプロイメント環境

このセクションでは、OpenShift Container Platform の CodeReady Workspaces 2.5 の可用性およびサポートされるインストール方法を説明します。

Red Hat CodeReady Workspaces をサポートする最小の OpenShift Container Platform バージョンは OpenShift Container Platform 3.11 です。

表2.1 OpenShift Container Platform の CodeReady Workspaces 2.5 でサポートされるデプロイメント環境

プラットフォーム

アーキテクチャー

デプロイメント方法

OpenShift Container Platform 3.11

AMD64 および Intel 64 (x86_64)

crwctl

OpenShift Container Platform 4.5

AMD64 および Intel 64 (x86_64)

OperatorHub

OpenShift Container Platform 4.5

IBM Z (s390x)

OperatorHub

OpenShift Container Platform 4.5

IBM Power Systems (ppc64le)

OperatorHub

OpenShift Container Platform 4.6

AMD64 および Intel 64 (x86_64)

OperatorHub

OpenShift Container Platform 4.6

IBM Power Systems (ppc64le)

OperatorHub

注記
  • OpenShift Container Platform 4.5 および 4.6 では、OperatorHub インストール方法が利用できない場合に crwctl を非公式のインストール方法を使用することを検討してください。
注記

IBM Power Systems (ppc64le) および IBM Z (s390x) での OpenShift Container Platform への CodeReady Workspaces のデプロイのサポートは、現在テクノロジープレビュー機能としてのみ利用できます。テクノロジープレビュー機能は、Red Hat 製品のサービスレベルアグリーメント (SLA) の対象外であり、機能的に完全ではないことがあります。Red Hat は実稼働環境でこれらを使用することを推奨していません。これらの機能は、近々発表予定の製品機能をリリースに先駆けてご提供することにより、開発プロセスの中でお客様に機能性のテストとフィードバックをしていただくことを目的としています。テクノロジープレビュー機能のサポートレベルの詳細は、テクノロジープレビュー機能のサポート範囲を参照してください。

2.2. サポートポリシー

Red Hat CodeReady Workspaces 2.5 では、Red Hat は製品のデプロイ、設定、および使用のサポートを提供します。

CodeReady Workspaces 2.5 は Chrome バージョン 83.0.4103.97(Official Build)(64- ビット)でテストされています。

詳細は、「 CodeReady Workspaces のライフサイクルおよびサポートポリシー 」を参照してください。

2.3. Eclipse Che と Red Hat CodeReady Workspaces の相違点

CodeReady Workspaces と Eclipse Che の主な相違点は次のとおりです。

  • 最新のセキュリティー修正が含まれるように RHEL8 で構築され CodeReady Workspaces と、更新に時間がかかる Alpine ディストリビューション。
  • CodeReady Workspaces は、アップストリームプロジェクト Keycloak の代わりに Red Hat Single Sign-On(SSO)を使用します。
  • CodeReady Workspaces では、Che と比較して、サポートされるプラグインのサブセットが少なくなります。CodeReady Workspaces は、EAP や Fuse などの他の Red Hat テクノロジーを操作するための devfile を提供します。
  • CodeReady Workspaces は OpenShift Container Platform および OpenShift Dedicated でサポートされています。Che は他の Kubernetes クラスターで実行できます。

また、Red Hat はライセンス、パッケージング、およびサポートも提供しているため、CodeReady Workspaces はアップストリームの Eclipse Che プロジェクトよりも安定した製品とみなされます。

第3章 既知の問題

本セクションでは、Red Hat CodeReady Workspaces 2.5 の既知の問題を紹介します。回避策が利用可能な場合は、回避策が提案されています。

3.1. Quarkus プロジェクトのデフォルトフォルダーのデフォルト値が間違っている

Quarkus サンプルプロジェクトのデフォルトターゲットフォルダーとして '/projects/' を提案する代わりに、Quarkus ウィザードの Create Quarkus project ボタンは、代わりに IDE から表示されないルートフォルダー (/) を提案します。

この問題を回避するには、推奨される宛先を拒否し、/projects を使用します。

3.2. CodeReady Workspaces 2.4 Java Fuse ワークスペースが 2.5 への移行後に起動できない

有効化された OpenShift OAuth サポートを有効にして OpenShift にデプロイされた CodeReady Workspaces 2.4 Java Fuse ワークスペースは、2.5 に更新した後に起動に失敗します。

3.3. Install dependencies コマンドが PHP-DI ベースのワークスペースで失敗する

PHP-DI デフォルト YAML ファイルを使用してワークスペースビルドで php-di/console.php ファイルを開くと、依存関係をインストールする事前定義のコマンドの実行に失敗します。

3.4. 単一ホストモードでワークスペースの Welcome ページの読み込みに失敗する

Single-host モードでデプロイされた CodeReady Workspaces の Workspace は welcome ページの読み込みに失敗し、以下のエラーメッセージを表示します。

Cannot GET /serverj4587ysj-jwtproxy/server-4402/webview/index.html.

3.5. Python devfile のデバッグセッションが起動に失敗する

CodeReady Workspaces 2.5 インスタンスは、Python devfile から作成されるワークスペースのデバッグセッションの実行をサポートしません。

3.6. Theia Plugin View を使用して手動で追加されたレジストリーがビューに自動的に反映されない

この問題を回避するには、macOS を使用している場合は F5 または Comd+r を押してページを更新します。

3.7. 複数の CodeReady Workspaces デプロイメントのあるクラスターで crwctl server:start を使用した CodeReady Workspaces のインストールに失敗する

OpenShift OAuth で crwctl server:start を使用して CodeReady Workspaces をインストールすると失敗するか、別の crwctl インストールの既存リソースが存在しない場合にはリソースをデプロイしません。

この問題を回避するには、古いリソースを削除して、新規インストールを実行します。手順は、「 OpenShift Container Platform 3.11 での CodeReady Workspaces のインストール 」を参照してください。

同じクラスターで複数の CodeReady Workspaces デプロイメントを使用することは推奨されず、今後のリリースで削除される可能性があります。

3.8. Getting started examples in the Getting started examples is some run and build commands some run and build commands some some run and build commands some in the Getting started examples may fail in the UnitedGap installation

Getting Started devfile に含まれるサンプルプロジェクトの一部は、オフラインまたはエアギャップの使用を目的として設計されていないため、一部のコマンドは機能しない場合があります。これを解決するには、ユーザーは組織の管理者に連絡して、NMP、Maven、PIP などの内部ミラーへのアクセスを取得する必要があります。

オフラインの devfile レジストリーに埋め込ま れた使用 済みの ZIP アーカイブサンプルのベース機能は動作しません。

実行にインターネットアクセスが必要なコマンド:、Simple build ', 'Outline

3.9. ワークスペースの共有が機能しない

File > Share IDE コマンドは現在 Workspace タブを起動しますが、Share タブがありません。

3.10. crwctl server:delete コマンドは、同じ OpenShift クラスターでの既存の CodeReady Workspaces デプロイメントが破損します。

crwctl server:delete コマンドは特定のクラスタースコープのオブジェクトを削除します。これにより、他のすべての CodeReady Workspaces デプロイメントが予期せずに終了します。

この問題を回避するには、カスタムリソース定義にパッチを適用します。

$ oc patch customresourcedefinition/checlusters.org.eclipse.che -p \
'{ "metadata": { "finalizers": null }}' --type merge

同じクラスターで複数の CodeReady Workspaces デプロイメントを使用することは推奨されず、今後のリリースで削除される可能性があります。

3.11. checluster カスタムリソースを削除すると CodeReady Workspaces Operator エラーが発生します。

OperatorHub で checluster カスタムリソースを削除して CodeReady Workspaces を手動でアンインストールすると、CodeReady Workspaces Operator でエラーが発生します。その結果、OperatorHub での CodeReady Workspaces の再インストールの試行に失敗していました。

3.12. TLS サポートなしでデプロイされた CodeReady Workspaces が正しく動作しない

CodeReady Workspaces 2.1 以降では、最新の Theia IDE を使用するようにセキュアな HTTPS が必要であるため、デフォルトで TLS モードが有効になります。TLS サポートを無効にすると、ユーザーエクスペリエンスがなくなり、一部の UI が期待どおり、またはまったく機能しません。

たとえば、ウェルカムページは空白または破損している可能性があり、イメージが見つからない場合があり、その他の機能が適切に機能しない可能性があります。

第4章 IBM Z および IBM Power Systems の CodeReady Workspaces の既知の問題

4.1. IBM Z [テクノロジープレビュー]

IBM Z での OpenShift Container Platform での CodeReady Workspaces のデプロイのサポートは、現時点でテクノロジープレビュー機能としてのみ利用できます。テクノロジープレビュー機能は、Red Hat 製品のサービスレベルアグリーメント (SLA) の対象外であり、機能的に完全ではないことがあります。Red Hat は実稼働環境でこれらを使用することを推奨していません。これらの機能は、近々発表予定の製品機能をリリースに先駆けてご提供することにより、開発プロセスの中でお客様に機能性のテストとフィードバックをしていただくことを目的としています。テクノロジープレビュー機能のサポートレベルの詳細は、テクノロジープレビュー機能のサポート範囲を参照してください。

4.1.1. IBM Z では、制限された環境でのインストールに対応していない

可能な場合は、環境が制限されたインストールなどの高度な機能はサポートされません。

4.1.2. IBM Z でのサポートされない devfile

  • EAP (OpenJDK 8 の場合)
  • .Net

4.1.3. Go ワークスペースでデバッグをアクティベートできない

デバッグ機能は、CodeReady Workspaces 2.5 の Go ワークスペースで有効にできません。この機能をアクティベートしようとすると、Failed to continue エラーメッセージが表示されます。

4.1.4. IBM Z(s390x)で実行している OpenShift 4.5 クラスターへの Red Hat Fuse サンプルプロジェクトのデプロイメントに失敗する

Fuse devfile で作成された CodeReady Workspaces 2.5 ワークスペースは、OpenShift Container Platform 4.5 のターゲットクラスターにログインできません。

4.2. IBM Power Systems [テクノロジープレビュー]

IBM Power Systems での OpenShift Container Platform への CodeReady Workspaces のデプロイのサポートは、現時点でテクノロジープレビュー機能としてのみ利用できます。テクノロジープレビュー機能は、Red Hat 製品のサービスレベルアグリーメント (SLA) の対象外であり、機能的に完全ではないことがあります。Red Hat は実稼働環境でこれらを使用することを推奨していません。これらの機能は、近々発表予定の製品機能をリリースに先駆けてご提供することにより、開発プロセスの中でお客様に機能性のテストとフィードバックをしていただくことを目的としています。テクノロジープレビュー機能のサポートレベルの詳細は、テクノロジープレビュー機能のサポート範囲を参照してください。

4.2.1. IBM Power Systems で未サポートの devfile

  • EAP (OpenJDK 8 の場合)
  • .Net

4.2.2. Go ワークスペースでデバッグをアクティベートできない

デバッグ機能は、CodeReady Workspaces 2.5 の Go ワークスペースで有効にできません。この機能をアクティベートしようとすると、Failed to continue エラーメッセージが表示されます。

4.2.3. IBM Power Systems(ppc64le)で実行している OpenShift クラスターへの Red Hat Fuse サンプルプロジェクトのデプロイメントに失敗する

Fuse devfile で作成された CodeReady Workspaces 2.5 ワークスペースは、OpenShift Container Platform のターゲットクラスターにログインできません。

第5章 FAQ

  1. CodeReady Workspaces を オフライン (つまりインターネットから切断) をインストールすることは可能ですか。

    はい、可能です。詳細な手順は、『インストールガイド 』の「制限された環境での CodeReady Workspaces のインストール 」の章を参照してください。

  2. CodeReady Workspaces でデフォルト以外の証明書を使用できますか。

    はい、自己署名証明書または公開証明書を使用できます。『インストールガイド』の「 OpenShift Container Platform 3.11 への CodeReady Workspaces のインストール 」の章を参照してください。

  3. 複数のワークスペースを同時に実行できますか。

    はい、利用できます。複数のワークスペースを同時に実行するには、以下の 2 つの条件を満たす必要があります。

    • CodeReady Workspaces は、ワークスペースごと の Persistent Volume Claim(永続ボリューム要求、PVC)ストラテジー(デフォルト)を使用する必要があります。
    • 永続ボリューム(PV)は ReadWriteMany (RWX)アクセスモードを使用する必要があります。

      したがって、複数のワークスペースを同時に実行するには、以下の設定が設定されていることを確認してください。

    • PV の ReadWriteMany (RWX)アクセスモードを設定します。
    • ワークスペースごと の PVC ストラテジー(CodeReady Workspaces のデフォルト)、またはオプションで 一意 のストラテジーを使用します。