Skip to content

Latest commit

 

History

History
134 lines (93 loc) · 6.43 KB

HELP.md

File metadata and controls

134 lines (93 loc) · 6.43 KB

目录

一、安装过程帮助

请先通过 git clone 或 下载Release包 的方式获取项目

1、Git命令不存在

检查git是否已正常安装，查看 如何安装Git

2、无法正常Clone

针对于常见无法正常Clone的问题，有如下几种解决方案

3、运行安装脚本出错

如果获取项目已经成功，但是在运行install.sh安装脚本阶段出错的话，有如下几种解决方案

  • 制作镜像过程出错 ：参考 镜像制作帮助 文档

  • 提示Error response from daemon: Get "https://registry-1.docker.io/v2/": EOF 错误 ：检查网络连接，关闭网络代理即可

4、Windows系统如何安装

目前暂不支持直接在Windows系统上操作，可以选择在Linux虚拟机、Docker环境中安装，如使用 在线Docker网站

5、out of capacity错误

We are really sorry but we are out of capacity and cannot create your session at the moment. Please try again later.

访问 https://labs.play-with-docker.com/ 时如果出现上述错误，暂无解决方案，需要多尝试几次。

二、镜像制作帮助

在install/image目录中已提供了开箱可用的phpkafka镜像文件，只需要简单的执行bash make.sh命令即可快速生成phpkafka镜像。

自带的install/image/Dockerfile镜像文件，已经过多台Unix机器上的多次测试，均可以顺利的成功制作。但是不排除在特殊情况下会存在制作失败的情况，下面会总结出常见的错误和解决方案。

如果还无法解决，可以直接使用已经推到 Docker Hub 上的lvsid/phpkafka:v1.0 ，修改方式如下 ：

# 打开根目录下的Dockerfile文件
cd esupdater
vi Dockerfile
# 把 FROM phpkafka 替换为 FROM lvsid/phpkafka:v1.0 即可

1、Docker命令不存在

安装镜像必须依赖于Docker，所以请务必成功安装Docker，否则无法创建镜像。

2、无法连接Docker

(1) 错误提示

Cannot connect to the Docker daemon at unix:///var/run/docker.sock. Is the docker daemon running?

(2) 错误原因

本地Docker服务未启动

(3) 解决方案

开启本地Docker服务即可

3、pecl.php.net更新失败

(1) 错误提示

Updating channel "pecl.php.net"
Channel "pecl.php.net" is not responding over http://, failed with message: File http://pecl.php.net:80/channel.xml not valid (redirected but no location)
Trying channel "pecl.php.net" over https:// instead
Cannot retrieve channel.xml for channel "pecl.php.net" (File https://pecl.php.net:443/channel.xml not valid (redirected but no location))

(2) 错误原因

网络异常，无法正常连接pecl.php.net

(3) 解决方案

检查网络是否正常或关掉网络代理

三、容器部署帮助

1、phpkafka镜像不存在

pull access denied for phpkafka, repository does not exist ... ...

出现这种错误是因为跳过了安装步骤，直接执行部署操作导致的。

由于容器化部署方案依赖于phpkafka镜像，所以如果提示此镜像不存在，请先参考快速使用-开始安装文档执行安装操作，或直接手动执行cd image && bash make.sh完成镜像的制作。

2、/home/log/esupdater/目录不存在或无权限写

由于容器默认会把目录挂载到宿主机的 /home/log/esupdater/ 相同目录下，所以请确保宿主机有此目录和写入权限

或者也可以选择修改容器的运行时配置中的目录挂载，修改方式如下

vi start.sh

# 替换以下内容
docker run --cpus=1.5 --name esupdaterContainer -d -v {你的宿主机目录}:/home/log/esupdater/ esupdater

3、KafkaConsumer创建失败

Consumer failed to new KafkaConsumer: "group.id" must be configured

如果在fatal.log中出现KafkaConsumer创建失败的报错，请检查consumer.php中的kafka服务配置是否可以正常连接

4、Consumer highLevelConsuming fetch timeout

重新启动后可能会报一段时间的Consumer highLevelConsuming fetch timeout问题，持续约为2~5秒。

原因 ：重启后需要重新连接kafka消费数据，在第一次连接时需要建立TCP和一些额外资源等，所以导致耗时相对较长。

四、版本选择

项目版本号规则为主版本-次版本-修订号，其中主版本主要做重大功能升级，次版本主要做性能和功能优化，修订号则做问题修复和完善。

所以次版本和修订号建议选择最新稳定版本的 Release包 ，主版本则根据以下对比信息选择合适的即可，可以查看更详细的 版本对比 信息。

主版本号 Composer
v1.x 不支持
v2.x 支持