第2章 Dev Spaces のインストール
このセクションでは、Red Hat OpenShift Dev Spaces をインストールする手順を説明します。
OpenShift Dev Spaces のインスタンスは、クラスターごとに 1 つだけデプロイできます。
2.1. クラウドでの Dev Spaces のインストール
Red Hat OpenShift Dev Spaces をクラウドでデプロイして実行します。
前提条件
- OpenShift Dev Spaces をデプロイする OpenShift クラスター。
-
dsc
: Red Hat OpenShift Dev Spaces のコマンドラインツール。「dsc 管理ツールのインストール」 を参照してください。
2.1.1. クラウドでの OpenShift Dev Spaces のデプロイ
dsc
ツールを使用してクラウドで OpenShift Dev Spaces Server を起動するには、以下の手順に従ってください。
2.1.2. CLI を使用して OpenShift に Dev Spaces をインストールする
OpenShift Dev Spaces を OpenShift にインストールできます。
前提条件
- OpenShift Container Platform
-
OpenShift クラスターへの管理権限を持つアクティブな
oc
セッション。OpenShift CLI のスタートガイド を参照してください。 -
dsc
。「dsc 管理ツールのインストール」 を参照してください。
手順
オプション: この OpenShift クラスターに OpenShift Dev Spaces をデプロイした場合は、以前の OpenShift Dev Spaces インスタンスが削除されていることを確認してください。
$ dsc server:delete
OpenShift Dev Spaces インスタンスを作成します。
$ dsc server:deploy --platform openshift
検証手順
OpenShift Dev Spaces インスタンスのステータスを確認します。
$ dsc server:status
OpenShift Dev Spaces クラスターインスタンスに移動します。
$ dsc dashboard:open
2.1.3. Web コンソールを使用して OpenShift に Dev Spaces をインストールする
コマンドラインで OpenShift Dev Spaces をインストール できない場合は、OpenShift Web コンソールからインストールできます。
前提条件
- クラスター管理者による OpenShift Web コンソールセッション。Web コンソールへのアクセス を参照してください。
-
OpenShift クラスターへの管理権限を持つアクティブな
oc
セッション。OpenShift CLI のスタートガイド を参照してください。 - 同じ OpenShift クラスターに繰り返しインストールする場合は、8章Dev Spaces のアンインストール に従って、以前の OpenShift Dev Spaces インスタンスをアンインストールしました。
手順
-
OpenShift Web コンソールの 管理者 ビューで、Operators
OperatorHub に移動し、 Red Hat OpenShift Dev Spaces
を検索します。 Red Hat OpenShift Dev Spaces Operator をインストールします。
ヒントWeb コンソールを使用した OperatorHub からのインストール を参照してください。
注意Red Hat OpenShift Dev Spaces Operator は、Dev Workspace Operator に依存します。Red Hat OpenShift Dev Spaces Operator を手動でデフォルト以外の namespace にインストールする場合は、Dev Workspace Operator も同じ namespace にインストールされていることを確認してください。これは、Operator Lifecycle Manager が、Red Hat OpenShift Dev Spaces Operator namespace 内の依存関係として Dev Workspace Operator をインストールしようとすることから、Dev Spaces Operator が別の namespace にインストールされている場合は、Dev Workspace Operator は 2 つの競合するインストールとなる可能性があるため、確認が必要となります。
クラスターに Web Terminal Operator をオンボードする場合は、両方とも Dev Workspace Operator に依存しているため、Red Hat OpenShift Dev Spaces Operator と同じインストール namespace を使用するようにしてください。Web Terminal Operator、Red Hat OpenShift Dev Spaces Operator、および Dev Workspace Operator は、同じ namespace にインストールする必要があります。
次のように、OpenShift で
openshift-devspaces
プロジェクトを作成します。oc create namespace openshift-devspaces
-
Operators
Installed Operators Red Hat OpenShift Dev Spaces インスタンスの仕様 Create CheCluster YAML view に移動します。 -
YAML view で、
namespace: openshift-operators
をnamespace: openshift-devspaces
に置き換えます。 Create を選択します。
ヒントインストールされた Operator からのアプリケーションの作成 を参照してください。
検証
- Red Hat OpenShift Dev Spaces インスタンスの仕様 で、devspaces に移動し、Details タブに移動します。
- Message の下に None があることを確認します。これはエラーがないことを意味します。
- Red Hat OpenShift Dev Spaces URL で、OpenShift Dev Spaces インスタンスの URL が表示されるまで待ち、URL を開いて OpenShift Dev Spaces ダッシュボードを確認します。
- Resources タブで、OpenShift Dev Spaces デプロイメントのリソースとそのステータスを表示します。
2.1.4. 制限された環境での Dev Spaces のインストール
制限されたネットワークで動作する OpenShift クラスターでは、パブリックリソースは利用できません。
ただし、OpenShift Dev Spaces をデプロイしてワークスペースを実行するには、以下のパブリックリソースが必要です。
- Operator カタログ
- コンテナーイメージ
- サンプルプロジェクト
これらのリソースを使用可能にするには、OpenShift クラスターからアクセス可能なレジストリー内のそれらのコピーに置き換えます。
前提条件
- OpenShift クラスターに、少なくとも 64 GB のディスクスペースがある。
- OpenShift クラスターは制限されたネットワーク上で動作する準備ができており、OpenShift コントロールプレーンはパブリックインターネットにアクセスできる。非接続インストールミラーリングについて および ネットワークが制限された環境での Operator Lifecycle Manager の使用 を参照してください。
-
OpenShift クラスターへの管理権限を持つアクティブな
oc
セッション。OpenShift CLI のスタートガイド を参照してください。 -
registry.redhat.io
Red Hat エコシステムカタログへのアクティブなoc
レジストリーセッション。Red Hat Container Registry authentication を参照してください。
-
opm
。opm
CLI のインストール を参照してください。 -
jq
。Downloadingjq
を参照してください。 -
podman
。Podman Installation Instructions を参照してください。 -
skopeo
バージョン 1.6 以降。Installing Skopeo を参照してください。 -
プライベート Docker レジストリーへの管理アクセス権を持つアクティブな
skopeo
セッション。レジストリーへの認証、および 非接続インストールのイメージのミラーリング。 -
OpenShift Dev Spaces バージョン 3.15 の
dsc
。「dsc 管理ツールのインストール」 を参照してください。
手順
ミラーリングスクリプトをダウンロードして実行し、カスタム Operator カタログをインストールし、関連するイメージをミラーリングします (prepare-restricted-environment.sh)。
$ bash prepare-restricted-environment.sh \ --devworkspace_operator_index registry.redhat.io/redhat/redhat-operator-index:v4.16\ --devworkspace_operator_version "v0.29.0" \ --prod_operator_index "registry.redhat.io/redhat/redhat-operator-index:v4.16" \ --prod_operator_package_name "devspaces" \ --prod_operator_bundle_name "devspacesoperator" \ --prod_operator_version "v3.15.0" \ --my_registry "<my_registry>" 1
- 1
- イメージがミラーリングされるプライベート Docker レジストリー
前の手順で
で che-operator-cr-patch.yaml
に指定した設定で OpenShift Dev Spaces をインストールします。$ dsc server:deploy \ --platform=openshift \ --olm-channel stable \ --catalog-source-name=devspaces-disconnected-install \ --catalog-source-namespace=openshift-marketplace \ --skip-devworkspace-operator \ --che-operator-cr-patch-yaml=che-operator-cr-patch.yaml
- OpenShift Dev Spaces namespace からユーザープロジェクト内のすべての Pod への受信トラフィックを許可します。「ネットワークポリシーの設定」 を参照してください。
2.1.4.1. Ansible サンプルのセットアップ
制限された環境で Ansible サンプルを使用するには、次の手順に従います。
前提条件
- Microsoft Visual Studio Code - オープンソース IDE
- 64 ビット x86 システム
手順
以下のイメージをミラーリングします。
ghcr.io/ansible/ansible-workspace-env-reference@sha256:03d7f0fe6caaae62ff2266906b63d67ebd9cf6e4a056c7c0a0c1320e6cfbebce registry.access.redhat.com/ubi8/python-39@sha256:301fec66443f80c3cc507ccaf72319052db5a1dc56deb55c8f169011d4bbaacb
以下のドメインへのアクセスを許可するようにクラスタープロキシーを設定します。
.ansible.com .ansible-galaxy-ng.s3.dualstack.us-east-1.amazonaws.com
以下の IDE および CPU アーキテクチャーのサポートは、今後のリリースで計画されています。
IDE
- JetBrains IntelliJ IDEA Community Edition IDE (テクノロジープレビュー)
CPU アーキテクチャー
- IBM Power (ppc64le)
- IBM Z (s390x)