前言

在Eclipse Che的官网首页有如下一句话:

Eclipse Next-Generation IDE

Eclipse Che is a developer workspace server and cloud IDE built for teams and organizations.

可以看出来Che的定位是一款云IDE,同时,首页的大图也表示,Che运行在浏览器上,本着程序员的折腾之心,开搞


安装前说明

【一】安装Docker

本教程使用的安装方法为Docker的镜像安装,干净,省力,所以需要在安装环境内安装docker。您可以前往官网下载并安装对应系统的Docker,请下载并安装最新的版本,或至少安装17.0以上的版本。
本教程使用的系统为CentOS 7,该系统的安装可参考我的另一篇文章:在CentOS 中安装Docker

【二】适用对象

本安装教程适用于运行Linux、MacOS、Windows操作系统的电脑或虚拟机。

在MacOS系统中安装前,需要设置IP别名,操作步骤如下:

  1. 在菜单栏点击docker图标,选择Preferences > Advanced,在Docker subnet一栏中复制IP地址,或在终端中通过命令docker run --rm --net host eclipse/che-ip:nightly查询IP
  2. 在终端中输入以下命令来设置IP别名,其中${IP}为您上一步查询到的IP
$ sudo ifconfig lo0 alias ${IP}

【三】服务器配置

最低配置:1 CPU;2GB RAM;3GB 磁盘空间

【四】 配置默认端口

运行Che所需的默认端口是8080。Che在启动时执行预检时会验证端口是否可用。您也可以在启动时传入-e CHE_PORT=${your host} start命令来更改Che启动的端口。请确保以下端口都已经打开,并且没有被防火墙或其他第三方应用阻止,除非另有说明,所有端口均为TCP,Che常用端口如下:

PortServiceNotes
8080Tomcat PortChe server default port
8000Server Debug PortUsers developing Che extensions and custom assemblies would use this debug port to connect a remote debugger to Che server.
32768-65535Docker and Che AgentsUsers who launch servers in their workspace bind to ephemeral ports in this range. This range can be limited.

已知的问题

您可以搜索Che的GitHub Issues页面,被标记为kind/bug的即已知问题的项目

=page=

安装单用户版Eclipse Che

运行安装命令

在终端中运行以下命令

#此为精简安装模式,但命令行会提示你下一步命令该如何输入
$ docker run -it eclipse/che start

#此为完整安装命令,其中<path>为本地存储eclipse che配置文件的地址
$ docker run -it --rm -v /var/run/docker.sock:/var/run/docker.sock -v <path>:/data eclipse/che start

#执行案例
$ docker run -it --rm -v /var/run/docker.sock:/var/run/docker.sock -v /home/che:/data eclipse/che start

#案例输出
WARN: Bound 'eclipse/che' to 'eclipse/che:6.11.1'
INFO: (che cli): Pulling image alpine:3.4
INFO: (che cli): Pulling image eclipse/che-ip:6.11.1
INFO: (che cli): 6.11.1 - using docker 18.06.1-ce / native
...(第一次运行时会下载缺少的文件,此处省略)
INFO: (che config): Generating che configuration...
INFO: (che config): Customizing docker-compose for running in a container
INFO: (che start): Preflight checks
         mem (1.5 GiB):           [OK]
         disk (100 MB):           [OK]
         port 8080 (http):        [AVAILABLE]
         conn (browser => ws):    [OK]
         conn (server => ws):     [OK]

INFO: (che start): Starting containers...
INFO: (che start): Services booting...
INFO: (che start): Server logs at "docker logs -f che"
INFO: (che start): Booted and reachable
INFO: (che start): Ver: 5.20.1
INFO: (che start): Use: http://172.19.20.180:8080
INFO: (che start): API: http://172.19.20.180:8080/swagger

修改默认端口

  1. 在执行Eclipse Che运行命令时添加-e CHE_PORT=${your host}参数来为本次运行指令临时端口,完整命令如下:
$ docker run -it --rm -v /var/run/docker.sock:/var/run/docker.sock -v <path>:/data -e CHE_HOST=<your-ip-or-host> eclipse/che start
  1. 修改安装目录下che.env文件来永久修改che的运行默认端口

    1. 打开安装目录下的che.env文件
    2. 搜索CHE_PORT,找到如图红框中的内容
    3. 删除#CHE_PORT=8080前注释用的#号,并修改=号后的端口号
    4. 保存退出,并重新运行Eclipse Che,即可使用新端口进入Che

打开Che

打开浏览器,在浏览器中输入http://${your ip}:${your port}来打开Eclipse Che,出现如下内容则安装成功

=page=

安装多用户版Eclipse Che

运行安装命令

$ docker run -it -e CHE_MULTIUSER=true -e CHE_HOST=${EXTERNAL_IP} -v /var/run/docker.sock:/var/run/docker.sock -v ~/.che-multiuser:/data eclipse/che start
  1. ~/.che-multiuser可以是任何的本地路径。该路径用来存储Che的数据和配置;
  2. ${EXTERNAL_IP}应该是将访问Che实例的所有用户都可访问的公共IP。如果您是在本地运行Che并且所有用户都将从同一局域网络中访问它,则可以删除-e CHE_HOST=${EXTERNAL_IP}参数。在这种情况下,Che CLI将尝试自动检测您的服务器IP。但是,自动检测可能会产生错误的结果,尤其是在网络设置复杂的情况下。如果您将Che作为云服务器运行,即可供外部用户访问,我们建议明确提供外部IP CHE_HOST

打开Che

打开浏览器,在浏览器中输入http://${your ip}:${your port}来打开Eclipse Che,出现如下内容则安装成功

  1. 默认管理员账号:admin;密码:admin,第一次使用admin登录是会要求修改admin密码
  2. 多用户可以点击Register来注册用户账号
  3. 管理员可登录http://<your-ip>:5050来管理多用户
最后修改:2021 年 02 月 01 日 11 : 26 AM
如果觉得我的文章对你有用,请随意赞赏