第5章 開発者環境のカスタマイズ

関連情報

• 「埋め込み、およびリモートの Che-Theia プラグイン」

• コードリンティング
• コマンドの新規セット
• 新規 UI コンポーネント

• Che-Theia プラグインまたは VS Code 拡張機能バイナリー。meta.yaml ファイルの定義は埋め込みプラグインの場合と同じです。
• コンテナーイメージの定義（例: eclipse/che-theia-dev:nightly）。このイメージから、CodeReady Workspaces はワークスペース内に別のコンテナーを作成します。

• Java Language Server
• Python Language Server

• 埋め込みプラグインは、コンテナー内で追加の依存関係を必要としない Che-Theia プラグインまたは VS Code 拡張機能です。
• リモートプラグインは、必要なすべての依存関係を持つプラグインが含まれるコンテナーです。

手順

• Dockerfile で CMD コマンドを使用して、リモートプラグインのエンドポイントを起動します。

  Dockerfile の例

  FROM fedora:30
  
  RUN dnf update -y && dnf install -y nodejs htop && node -v
  
  RUN mkdir /home/jboss
  
  ENV HOME=/home/jboss
  
  RUN mkdir /projects \
      && chmod -R g+rwX /projects \
      && chmod -R g+rwX "${HOME}"
  
  CMD ${PLUGIN_REMOTE_ENDPOINT_EXECUTABLE}

  Copy to Clipboard Toggle word wrap

• Dockerfile で ENTRYPOINT コマンドを使用して、リモートプラグインのエンドポイントを起動します。

  Dockerfile の例

  FROM fedora:30
  
  RUN dnf update -y && dnf install -y nodejs htop && node -v
  
  RUN mkdir /home/jboss
  
  ENV HOME=/home/jboss
  
  RUN mkdir /projects \
      && chmod -R g+rwX /projects \
      && chmod -R g+rwX "${HOME}"
  
  ENTRYPOINT ${PLUGIN_REMOTE_ENDPOINT_EXECUTABLE}

  Copy to Clipboard Toggle word wrap

• Command - CodeReady Workspaces は、command プロパティーを使用して Dockerfile#ENTRYPOINT の値を上書きします。
• args - CodeReady Workspaces は args プロパティーを使用して Dockerfile#CMD 値を上書きします。

• command および args プロパティーが変更された YAML ファイルの例:

  apiVersion: v2
  category: Language
  description: "Typescript language features"
  displayName: Typescript
  firstPublicationDate: "2019-10-28"
  icon: "https://www.eclipse.org/che/images/logo-eclipseche.svg"
  name: typescript
  publisher: che-incubator
  repository: "https://github.com/Microsoft/vscode"
  title: "Typescript language features"
  type: "VS Code extension"
  version: remote-bin-with-override-entrypoint
  spec:
    containers:
      - image: "example/fedora-for-ts-remote-plugin-without-endpoint:latest"
        memoryLimit: 512Mi
        name: vscode-typescript
        command:
          - sh
          - -c
        args:
          - ${PLUGIN_REMOTE_ENDPOINT_EXECUTABLE}
    extensions:
      - "https://github.com/che-incubator/ms-code.typescript/releases/download/v1.35.1/che-typescript-language-1.35.1.vsix"

  Copy to Clipboard Toggle word wrap

• ラッパースクリプトのパターンでイメージを使用し、entrypoint.sh スクリプトの呼び出しを保持するには、command ではなく args を変更します。

  apiVersion: v2
  category: Language
  description: "Typescript language features"
  displayName: Typescript
  firstPublicationDate: "2019-10-28"
  icon: "https://www.eclipse.org/che/images/logo-eclipseche.svg"
  name: typescript
  publisher: che-incubator
  repository: "https://github.com/Microsoft/vscode"
  title: "Typescript language features"
  type: "VS Code extension"
  version: remote-bin-with-override-entrypoint
  spec:
    containers:
      - image: "example/fedora-for-ts-remote-plugin-without-endpoint:latest"
        memoryLimit: 512Mi
        name: vscode-typescript
        args:
          - sh
          - -c
          - ${PLUGIN_REMOTE_ENDPOINT_EXECUTABLE}
    extensions:
      - "https://github.com/che-incubator/ms-code.typescript/releases/download/v1.35.1/che-typescript-language-1.35.1.vsix"

  Copy to Clipboard Toggle word wrap

  Red Hat CodeReady Workspaces は、Dockerfile の ENTRYPOINT コマンドで定義された entrypoint.sh ラッパースクリプトを呼び出します。このスクリプトは、exec “$@” コマンドを使用して [ ‘sh’, ‘-c”, ‘ ${PLUGIN_REMOTE_ENDPOINT_EXECUTABLE}’ ] を実行します。