暄风吹斋响苍玉,竹石相看便有情。提胡卢来沽美酒,终日撩人不住声。

Eclipse Che安装使用教程(一):安装Eclipse Che

前言


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

Eclipse Next-Generation IDE

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

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

安装前说明


  1. 安装Docker

    本教程使用的安装方法为Docker的镜像安装,干净,省力,所以需要在安装环境内安装docker。您可以前往官网下载并安装对应系统的Docker,请下载并安装最新的版本,或至少安装17.0以上的版本。

    本教程使用的系统为CentOS 7,该系统的安装可参考我的另一篇文章:在 CentOS 7 中安装 Docker

  2. 本安装教程适用于Linux、MacOS、Windows

  3. 在MacOS系统中安装前,需要设置IP别名,操作方式为:

    1. 在菜单栏点击docker图标,选择Preferences > Advanced,在Docker subnet一栏中复制IP地址,或在终端中通过命令docker run --rm --net host eclipse/che-ip:nightly查询IP

    2. 在终端中输入以下命令来设置IP别名,其中${IP}为您上一步查询到的IP

      1
      $ sudo ifconfig lo0 alias ${IP}
  4. 安装服务器最低配置:1 CPU;2GB RAM;3GB 磁盘空间

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

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

已知的问题


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

安装单用户版Eclipse Che


运行安装命令

在终端中运行以下命令

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
#此为精简安装模式,但命令行会提示你下一步命令该如何输入
$ 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}参数来为本次运行指令临时端口,完整命令如下:

    1
    $ 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
  2. 修改安装目录下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,出现如下内容则安装成功

安装多用户版Eclipse Che


运行安装命令

1
$ 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来管理多用户
-------------本文结束感谢您的阅读-------------
坚持原创技术及精品文章分享,您的支持将鼓励我继续创作!
0%