第1章 devfile およびプラグインレジストリーのカスタマイズ

手順

1. devfile レジストリーリポジトリーのクローンを作成します。

   $ git clone git@github.com:redhat-developer/codeready-workspaces.git
   $ cd codeready-workspaces/dependencies/che-devfile-registry

2. . /che-devfile-registry/devfiles/ ディレクトリーにサブディレクトリー <devfile-name>/ を作成し、devfile.yaml ファイルおよび meta.yaml ファイルを追加します。

   devfile のファイル組織

   ./che-devfile-registry/devfiles/
   └── <devfile-name>
       ├── devfile.yaml
       └── meta.yaml

3. devfile.yaml ファイルに有効なコンテンツを追加します。devfile 形式の詳細な説明は、「 Devfile を使用したワークスペースポータブルの使用」を 参照してください。

4. meta.yaml ファイルが以下の構造に準拠していることを確認します。

   Expand

   表1.1 devfile meta.yamlのパラメーター

   attribute	description
   description	ユーザーダッシュボードに表示される説明。
   displayName	ユーザーダッシュボードに表示される名前。
   globalMemoryLimit	devfile によって起動されるすべてのコンポーネントが使用する予想されるメモリーの合計。この数は、ユーザーダッシュボードに表示されます。これは通知され、CodeReady Workspaces サーバーによって考慮されません。
   icon	ユーザーダッシュボードに表示される .svg ファイルへのリンク
   tags	タグの一覧。タグには、通常スタックに含まれるツールが含まれます。

   Show more

   devfile meta.yamlの例

   displayName: Rust
   description: Rust Stack with Rust 1.39
   tags: ["Rust"]
   icon: https://www.eclipse.org/che/images/logo-eclipseche.svg
   globalMemoryLimit: 1686Mi

5. カスタム devfile レジストリーのコンテナーをビルドします。

   $ docker build -t my-devfile-registry .

手順

1. プラグインレジストリーリポジトリーのクローンを作成します。

   $ git clone git@github.com:redhat-developer/codeready-workspaces.git
   $ cd codeready-workspaces/dependencies/che-plugin-registry

2. . /che-plugin-registry/v3/plugins/ ディレクトリーに新しいディレクトリー <publisher> /<plugin-name> /<plugin-version>/ および meta.yaml ファイルを最後のディレクトリーに作成します。

   プラグインのファイル組織

   ./che-plugin-registry/v3/plugins/
   ├── <publisher>
   │   └── <plugin-name>
   │       ├── <plugin-version>
   │       │   └── meta.yaml
   │       └── latest.txt

3. meta.yaml ファイルに有効なコンテンツを追加します。meta.yaml ファイル形式の詳細は、「Using a Visual Studio Code extension in CodeReady Workspaces」セクションまたは eclipse/che-plugin-registry リポジトリーの README. md ファイルを参照してください。

4. 最新の <plugin-version> ディレクトリーの名前を含む latest.txt という名前のファイルを作成します。

   例

   $ tree che-plugin-registry/v3/plugins/redhat/java/
   che-plugin-registry/v3/plugins/redhat/java/
   ├── 0.38.0
   │   └── meta.yaml
   ├── 0.43.0
   │   └── meta.yaml
   ├── 0.45.0
   │   └── meta.yaml
   ├── 0.46.0
   │   └── meta.yaml
   ├── 0.50.0
   │   └── meta.yaml
   └── latest.txt
   $ cat che-plugin-registry/v3/plugins/redhat/java/latest.txt
   0.50.0

5. カスタムプラグインレジストリーのコンテナーをビルドします。

   ./build.sh