wsskeleton/che-machine-exec

CHE machine exec

Eclipse CHE工作空间的Go语言服务器端组件，用于创建机器执行实例，支持生成终端或命令进程。该组件通过JSON-RPC协议与客户端进行通信。

构建Docker镜像

手动构建che-machine-exec的Docker镜像：

bash
docker build --no-cache -t eclipse/che-machine-exec .

运行Docker容器

手动运行che-machine-exec的Docker容器：

bash
docker run --rm -p 4444:4444 -v /var/run/docker.sock:/var/run/docker.sock eclipse/che-machine-exec

在Docker基础设施上使用machine-exec镜像与Eclipse CHE工作空间

配置Docker基础设施上的Eclipse CHE需使用che.env配置文件，该文件位于CHE的data文件夹中。编辑并保存che.env文件：将docker.sock路径（默认是/var/run/docker.sock）应用到工作空间卷属性CHE_WORKSPACE_VOLUME：

示例：

bash
CHE_WORKSPACE_VOLUME=/var/run/docker.sock:/var/run/docker.sock;

注意：所有配置变更需重启Eclipse CHE后生效。

在Docker基础设施上通过UI测试che-machine-exec

运行Eclipse CHE，创建一个集成Theia IDE的新工作空间（从“Theia IDE on docker”栈创建）。之后可通过che-theia-terminal-extension测试che-machine-exec和che-theia-task-plugin测试che-machine-exec。

在本地OpenShift上测试che-machine-exec

需先在本地OpenShift部署Eclipse CHE，参考准备Eclipse CHE部署。

可使用https://github.com/eclipse/che/blob/master/deploy/openshift/ocp.sh%E5%B0%86Eclipse CHE部署到本地运行的OpenShift：

切换到ocp.sh脚本目录：

bash
cd ~/projects/che/deploy/openshift/

执行ocp.sh脚本（带参数）：

bash
./ocp.sh --run-ocp --deploy-che --no-pull --debug --deploy-che-plugin-registry --multiuser

输出中会提供部署后的Eclipse CHE项目链接，使用该链接登录。

注意：ocp.sh可使用--setup-ocp-oauth参数，但此时需在登录页选择“Openshift v3”认证方式。

在登录页注册新用户，登录后将重定向到Eclipse CHE用户仪表盘。创建新工作空间（从“Java Theia on OpenShift”或“CHE 7 Preview”栈），运行工作空间后将看到Theia IDE，之后可进行上述两个测试。

在Minishift上测试

需先在Minishift部署Eclipse CHE，参考准备Eclipse CHE部署。

安装Minishift：

• 参考文档：[***]
• 参考文档：[***]

安装oc工具：https://github.com/openshift/origin/releases%EF%BC%8C%E8%A7%A3%E5%8E%8B%E5%B9%B6%E6%B7%BB%E5%8A%A0%E5%88%B0%E7%B3%BB%E7%BB%9F%E7%8E%AF%E5%A2%83%E5%8F%98%E9%87%8FPATH%E4%B8%AD%EF%BC%8C%E9%AA%8C%E8%AF%81%EF%BC%9A

bash
$ oc version
oc v3.9.0+191fece
kubernetes v1.9.1+a0ce1bc657
features: Basic-Auth GSSAPI Kerberos SPNEGO

启动Minishift：

bash
$ minishift start --memory=8GB
-- Starting local OpenShift cluster using 'kvm' hypervisor...
...
   OpenShift server started.
   The server is accessible via web console at:
       https://192.168.99.128:8443

   You are logged in as:
       User:     developer
       Password: developer

   To login as administrator:
       oc login -u system:admin

从输出中获取Minishift master URL（示例：https://192.168.42.159:8443），并设置环境变量：

bash
export CHE_INFRA_KUBERNETES_MASTER__URL=https://192.168.42.162:8443

注意：若删除Minishift虚拟机（minishift delete）并重新创建，该URL会变化。

在CHE_INFRA_KUBERNETES_MASTER__URL页面注册新用户，使用新用户登录Minishift：

bash
$ oc login --server=${CHE_INFRA_KUBERNETES_MASTER__URL}

使用https://github.com/eclipse/che/blob/master/deploy/openshift/deploy_che.sh%E9%83%A8%E7%BD%B2Eclipse CHE： 切换到脚本目录：

bash
cd ~/projects/che/deploy/openshift

执行脚本：

bash
export CHE_INFRA_KUBERNETES_MASTER__URL=${CHE_INFRA_KUBERNETES_MASTER__URL} && ./deploy_che.sh --no-pull --debug --multiuser

创建新工作空间（从“Java Theia on OpenShift”或“CHE 7 Preview”栈），运行后进行上述两个测试。

在Kubernetes（MiniKube）上测试

需先在Minikube集群部署Eclipse CHE，参考准备Eclipse CHE部署。

安装Minikube：https://kubernetes-cn.github.io/docs/tasks/tools/install-minikube

安装Helm：https://github.com/kubernetes/helm/blob/master/docs/install.md

启动Minikube：

bash
minikube start --cpus 2 --memory 8192 --extra-config=apiserver.authorization-mode=RBAC

切换到helm/che目录：

bash
$ cd ~/projects/che/deploy/kubernetes/helm/che

• 为kube-system:default账户添加cluster-admin角色：

bash
kubectl create clusterrolebinding add-on-cluster-admin --clusterrole=cluster-admin --serviceaccount=kube-system:default

• 设置默认Kubernetes上下文：

bash
kubectl config use-context minikube

• 安装Tiller：
  • 创建serviceAccount：

    bash
    kubectl create serviceaccount tiller --namespace kube-system
    

  • 绑定角色：

    bash
    kubectl apply -f ./tiller-rbac.yaml
    

  • 安装Tiller：

    bash
    helm init --service-account tiller
    

• 启用NGINX ingress控制器：

  bash
  minikube addons enable ingress
  

部署Eclipse CHE有两种配置：

1. 每个新工作空间创建独立命名空间：

   bash
   helm upgrade --install che --namespace che ./
   

2. 工作空间与CHE在同一命名空间：

   bash
   helm upgrade --install che --namespace=che --set global.cheWorkspacesNamespace=che ./
   

信息：部署多用户CHE可使用参数-f ./values/multi-user.yaml，设置 ingress 域名可使用--set global.ingressDomain=<domain>。 注意：可通过Minikube dashboard跟踪部署进度：

bash
minikube dashboard

创建新工作空间（从“Java Theia on Kubernetes”栈），运行后进行上述两个测试。

准备Eclipse CHE部署

要求：安装Java 8或更高版本，Maven 3.3.0或更高版本。

首先克隆Eclipse CHE：

bash
$ git clone https://github.com/eclipse/che.git ~/projects/che

测试无需构建全部CHE，仅构建'assembly-main'模块即可：

bash
$ cd ~/projects/che/assembly/assembly-main
$ mvn clean install -DskipTests

通过che-theia-terminal-extension测试che-machine-exec

从Theia栈创建的Eclipse CHE工作空间包含che-theia-terminal-extension。通过该扩展测试：

在Theia主菜单选择File => New multy-machine terminal，选择要创建终端的机器，之后Theia会在底部面板创建新终端。

通过che-theia-task-plugin测试che-machine-exec

从Theia栈创建的Eclipse CHE工作空间包含che-theia-task-plugin。通过该插件测试：

在项目根目录创建.theia文件夹，在其中创建tasks.json文件，内容如下：

json
{
    "tasks": [
        {
            "label": "che",
            "type": "che",
            "command": "echo hello"
        }
    ]
}

通过菜单Task => Run...运行该任务，Theia会显示输出为“echo hello”的小部件。