4.9. ストレージの設定

設定されたインフラストラクチャーストレージを使用するように OpenShift Dev Spaces を設定するには、ストレージクラスを使用して OpenShift Dev Spaces をインストールします。これは、デフォルト以外のプロビジョナーによって提供される永続ボリュームをバインドする場合に特に便利です。

OpenShift Dev Spaces には、データを保存するために永続ボリュームを必要とするコンポーネントが 1 つあります。

永続ボリューム要求のファクト:

OpenShift Dev Spaces は、ストレージストラテジーを選択することで、ワークスペースに永続ストレージまたは非永続ストレージを提供するように設定できます。選択したストレージストラテジーは、デフォルトで新しく作成されたすべてのワークスペースに適用されます。ユーザーは、devfile または URL パラメーター を通じて、ワークスペースのデフォルト以外のストレージストラテジーを選択できます。

利用可能なストレージストラテジー:

OpenShift Dev Spaces で使用されるデフォルトのストレージストラテジーは per-user です。

spec:
  devEnvironments:
    storage:
      pvc:
        pvcStrategy: 'per-user' 

spec:
  devEnvironments:
    storage:
      pvc:
        pvcStrategy: 'per-user' 

永続ボリューム要求 (PVC) サイズは、per-user または per-workspace のストレージストラテジーを使用して設定できます。CheCluster カスタムリソースの PVC サイズを Kubernetes リソース数量 の形式で指定する必要があります。利用可能なストレージストラテジーの詳細は、こちらのページ を参照してください。

デフォルトの永続ボリューム要求サイズ:

spec:
  devEnvironments:
    storage:
      pvc:
        pvcStrategy: '<strategy_name>'  
        perUserStrategyPvcConfig: 
          claimSize: <resource_quantity> 
        perWorkspaceStrategyPvcConfig:  
          claimSize: <resource_quantity> 

spec:
  devEnvironments:
    storage:
      pvc:
        pvcStrategy: '<strategy_name>'  

        perUserStrategyPvcConfig: 

          claimSize: <resource_quantity> 

        perWorkspaceStrategyPvcConfig:  

          claimSize: <resource_quantity> 

Red Hat OpenShift Dev Spaces は、非一時ワークスペースごとにワークスペースの再起動後も /home/user ディレクトリーを維持できるようにする永続ホームディレクトリー機能を提供します。spec.devEnvironments.persistUserHome.enabled を true に設定して、CheCluster でこの機能を有効にできます。

新しく起動されたワークスペースでは、この機能により、tools コンテナーの /home/user パスにマウントされる PVC が作成されます。このドキュメントでは、"tools コンテナー" を使用して devfile の最初のコンテナーを参照します。このコンテナーは、デフォルトでプロジェクトソースコードを含むコンテナーです。

PVC の初回マウント時に、永続ボリュームのコンテンツは空になるため、/home/user ディレクトリーのコンテンツを設定する必要があります。

デフォルトでは、persistUserHome 機能は、init-persistent-home という名前の新規ワークスペース Pod ごとに init コンテナーを作成します。この init コンテナーはツールコンテナーイメージと共に作成され、stow コマンドを実行して永続ボリュームにシンボリックリンクを作成し、/home/user ディレクトリーを設定します。

stow コマンドの主な機能は、以下を実行することです。

stow -t /home/user/ -d /home/tooling/ --no-folding

stow -t /home/user/ -d /home/tooling/ --no-folding

上記のコマンドにより、/home/tooling にあるファイルとディレクトリーのシンボリックリンクが /home/user に作成されます。これにより、永続ボリュームに /home/tooling のコンテンツへのシンボリックリンクが追加されます。その結果、persistUserHome 機能は、ツールイメージの /home/user/ の内容が /home/tooling 内にあると想定します。

たとえば、ツールコンテナーイメージに .config および .config-folder/another-file などの home/tooling ディレクトリーのファイルが含まれている場合は、stow は次の方法で永続ボリュームにシンボリックリンクを作成します。

図4.11 persistUserHome が有効になっているツールコンテナー

View larger image

init コンテナーは、stow コマンドの出力を /home/user/.stow.log に書き込みます。永続ボリュームをワークスペースに初めてマウントしたときにのみ stow を実行します。

stow コマンドを使用して、永続ボリュームに /home/user コンテンツを設定することには、主に 2 つの利点があります。

カスタムイメージを使用している場合は、persistUserHome 機能をサポートするために満たさなければならない 3 つの要件があります。

要件 3 により、デフォルトの UDI イメージは、たとえば /home/user コンテンツを /home/tooling に追加し、以下を実行します。

RUN stow -t /home/user/ -d /home/tooling/ --no-folding

RUN stow -t /home/user/ -d /home/tooling/ --no-folding

これは、/home/tooling のファイルが persistUserHome 機能を使用していなくても /home/user からアクセスできるように Dockerfile で実行されます。