纵有疾风起
人生不言弃

Exceptionless 5.0.0 本地Docker快速部署介绍

在之前我有专门写两篇文章介绍过Exceptionless这款开源日志项目的使用和部署,但是当时是基于4.1.0版本(2017年的release),时隔两年多Exceptionless也推出了5.0.0版本。

一、关于Exceptionless 5.0.0

  Exceptionless 是一个开源的实时的好用的日志收集框架,它将日志收集变得简单易用并且不需要了解太多的相关技术细节及配置。但是之前的版本将其Web和API绑定在了Windows平台通过IIS运行,对于已经步入云原生时代的我们显得有点格格不入。5.0.0的发布解决了这一痛点,其最大的变化就是基于ASP.NET Core重写并支持跨平台,也就是说当初我们设想的要是能够基于Docker部署在Linux服务器下就更好了的愿望已经实现了,在此真心感谢Exceptionless项目的各位贡献者。本文就Exceptionless 5.0.0版本介绍一下快速地部署开发环境和生产环境,相信对有兴趣的朋友会有一点帮助。

  至此我也可以将我们之前的Exceptionless从Windows Server迁移到Linux上了!

二、快速本地部署步骤

2.1 安装Docker 18.09+

  由于Exceptionless 5.0.0的一个前置要求是Docker版本(CE)在18.09及以上,因此我们需要安装一个18.09+的Docker CE版本到Linux服务器上,如果你之前安装了可以跳过此步骤,但如果版本小于18.09,那么请清理掉老版本升级到新版本,升级版本可以参考以下步骤。

  实验环境:阿里云ECS主机,CentOS 7.4

  (1)清理已有Docker老版本

  停止Docker老版本:

systemctl stop docker

  卸载软件包:

yum erase docker \    docker-client \    docker-client-latest \    docker-common \    docker-latest \    docker-latest-logrotate \    docker-logrotate \    docker-selinux \    docker-engine-selinux \    docker-engine \    docker-ce

  删除相关配置文件:

find /etc/systemd -name '*docker*' -exec rm -f {} \;find /etc/systemd -name '*docker*' -exec rm -f {} \;find /lib/systemd -name '*docker*' -exec rm -f {} \;rm -rf /var/lib/docker   #删除以前已有的镜像和容器,非必要,慎删rm -rf /var/run/docker  

  (2)安装Docker 18.09+

  软件包安装:

yum install -y yum-utils  device-mapper-persistent-data lvm2

  添加yum源:

yum-config-manager \--add-repo \    https://download.docker.com/linux/centos/docker-ce.repo

  查看可安装的版本:目前最新版本已经是19.03

yum list docker-ce --showduplicates | sort -r

  安装指定版本:18.09

yum install docker-ce docker-ce-18.09.9-3.el7 -y

  启动Docker并设置开机自启动:

systemctl start dockersystemctl enable docker

  查看Docker版本:

docker version 

  你可以看到已经是18.09版本了:

  Exceptionless 5.0.0 本地Docker快速部署介绍插图

2.2 下载Exceptionless 5.0.0 Release包

  传送门:Exceptionless release

   Exceptionless 5.0.0 本地Docker快速部署介绍插图(1)

2.3 安装Exceptionless 5.0.0

  (1)修改docker-compose.yml文件,设置外部访问地址/域名(适配你的服务器IP地址 或 域名+SSL证书,这里我直接修改为我的阿里云服务器的外网IP地址,参考我的注释)

version: '3.4'services:  api:    depends_on:      - elasticsearch      - redis    build:      context: .      target: api    image: exceptionless/api:latest    restart: on-failure    environment:      EX_AppMode: Production      EX_BaseURL: http://192.168.16.170:5100 #UI地址,修改这里的IP地址为你的服务器IP地址      EX_ConnectionStrings__Cache: provider=redis      EX_ConnectionStrings__Elasticsearch: server=http://elasticsearch:9200      #EX_ConnectionStrings__Email: smtps://user:password@smtp.host.com:587      EX_ConnectionStrings__MessageBus: provider=redis      #EX_ConnectionStrings__Metrics: provider=statsd;server=statsd;      EX_ConnectionStrings__Queue: provider=redis      EX_ConnectionStrings__Redis: server=redis,abortConnect=false      EX_ConnectionStrings__Storage: provider=folder;path=/app/storage      EX_RunJobsInProcess: 'false'    ports:      - 5000:80 # This can be commented out if using reverse proxy.    volumes:      - appdata:/app/storage  jobs:    depends_on:      - api    build:      context: .      target: job    image: exceptionless/job:latest    restart: on-failure    environment:      EX_AppMode: Production      EX_BaseURL: http://192.168.16.170:5100 #UI地址,修改这里的IP地址为你的服务器IP地址      EX_ConnectionStrings__Cache: provider=redis      EX_ConnectionStrings__Elasticsearch: server=http://elasticsearch:9200      #EX_ConnectionStrings__Email: smtps://user:password@smtp.host.com:587      EX_ConnectionStrings__MessageBus: provider=redis      #EX_ConnectionStrings__Metrics: provider=statsd;server=statsd;      EX_ConnectionStrings__Queue: provider=redis      EX_ConnectionStrings__Redis: server=redis,abortConnect=false      EX_ConnectionStrings__Storage: provider=folder;path=/app/storage    volumes:      - appdata:/app/storage  ui:    image: exceptionless/ui:latest    environment:      AppMode: Production      EX_ApiUrl: http://192.168.16.170:5000 #API地址,修改这里的IP地址为你的服务器IP地址      #EX_Html5Mode: 'false'      #EX_EnableSsl: 'false'      #EX_EnableAccountCreation: 'false'    ports:      - 5100:80 # This can be commented out if using reverse proxy.#  reverseproxy:#    depends_on:#      - api#      - ui#    image: valian/docker-nginx-auto-ssl#    restart: on-failure#    ports:#      - 80:80#      - 443:443#    volumes:#      - ssldata:/etc/resty-auto-ssl#    environment:#      ALLOWED_DOMAINS: '(ex-ui|ex-api).mydomainn.com'#      SITES: 'ex-ui.mydomainn.com=ui;ex-api.mydomainn.com=api'  elasticsearch:    image: exceptionless/elasticsearch:1    restart: on-failure    environment:      cluster.name: 'exceptionless'      bootstrap.memory_lock: 'true'      discovery.type: single-node      ES_JAVA_OPTS: '-Xms512m -Xmx512m'      xpack.security.enabled: 'false'      xpack.graph.enabled: 'false'      xpack.watcher.enabled: 'false'    ports:      - 9200:9200      - 9300:9300    ulimits:      memlock:        soft: -1        hard: -1    volumes:      - esdata:/usr/share/elasticsearch/data  kibana:    depends_on:      - elasticsearch    image: exceptionless/kibana:1    restart: on-failure    environment:      xpack.security.enabled: 'false'    ports:      - 5601:5601  redis:    image: redis:alpine    restart: on-failure    ports:      - 6379:6379volumes:  esdata:    driver: local  appdata:    driver: local  ssldata:    driver: local

Note:在这个docker-compose.yml中定义了Exceptionless的最小化运行环境,但官方建议生产环境使用ElasticSearch集群,并适当修改ElasticSearch的内存限制。如果你的量很小真的不大,那么这个最小化的运行环境也够用了,没必要为了高可用而高可用。  

  此外,貌似官方已经将exceptionless/elasticsearch:1这个镜像移除了,大家可以使用这个镜像:edisonsaonian/exceptionless-elasticsearch:1

  (2)将Release包上传到阿里云服务器,然后通过SSH执行一下shell命令(首先cd到这个release包的目录下)启动Exceptionless 5.0.0。

docker-compose up -d

  整个过程会比较漫长,因为会经过34个Steps,拉取很多镜像,类似于Redis,ElasticSearch,Kibana及.NET Core SDK等等,请耐心等待。最终效果如下所示:

  Exceptionless 5.0.0 本地Docker快速部署介绍插图(2)

  Exceptionless 5.0.0 本地Docker快速部署介绍插图(3)

2.4 使用Exceptionless 5.0.0

  (1)访问你的服务器IP:5100 即可访问Exceptionless Web管理登录界面,如果你能看到,那么代表部署成功了。注册一个账号,然后登陆吧。

  Exceptionless 5.0.0 本地Docker快速部署介绍插图(4)

  (2)可以看到主页是全新的中文管理界面,感谢贡献者的努力

  Exceptionless 5.0.0 本地Docker快速部署介绍插图(5)

  Exceptionless 5.0.0 本地Docker快速部署介绍插图(6)

  (3)创建一些示例项目,如“XDP.Product.API”,并获取API Key

  Exceptionless 5.0.0 本地Docker快速部署介绍插图(7)

  (4)在你的ASP.NET Core WebAPI项目中配置API Key,并向Exceptionless API(这里是5000端口)发送Log

  (5)在Exceptionless中查看Log

  Exceptionless 5.0.0 本地Docker快速部署介绍插图(8)

  Exceptionless 5.0.0 本地Docker快速部署介绍插图(9)

三、遗留问题:Email通知配置

  使用过Exceptionless的童鞋都知道,Exceptionless提供了强大的Email通知机制,可以为用户提供及时的严重错误通知和每日报告。

  Exceptionless 5.0.0 本地Docker快速部署介绍插图(10)

  在上面介绍的安装基础上,根据官方Wiki文档,按理说我们只需要确保docker-compose.yml中的api和jobs的AppMode为Production模式并设置SMTP就可以开启Email通知。

EX_AppMode: ProductionEX_ConnectionStrings__Email: smtps://edisonchou7%40qq.com:zltqvl2321ed@smtp.qq.com:465
  这里的%40是@的转义替代,在Exceptionless中会使用Decode进行解码为@,原因好像是因为它是通过@符号分割前方的用户名+密码和后方的Host+Port,也是醉了。
  设置完成后,通过以下命令重启docker:
docker-compose up -d
  docker-compose会自动帮我们重启更改过的容器,比如api和jobs。
  但是,我试了很多次都发现还是无法正常发送Email通知,由于不影响使用,也就暂时没去深究了,有解决的朋友可以告知并分享一下解决办法,谢谢。

202009后记

  Email邮件问题已经解决,发布了一篇问题解决的文章供大家参考。

四、小结

  本文介绍了Exceptionless 5.0.0的容器化本地部署,主要参考自Exceptionless的Self-Host文档。

参考资料

1、Exceptionless release

2、Exceptionless Self-Hosting Documention

 

文章转载于:https://www.cnblogs.com/edisonchou/p/exceptionless_v5_deployment_introduction.html

原著是一个有趣的人,若有侵权,请通知删除

未经允许不得转载:起风网 » Exceptionless 5.0.0 本地Docker快速部署介绍

分享到: 生成海报
avatar

评论 抢沙发

评论前必须登录!

立即登录   注册

切换注册

登录

忘记密码 ?

切换登录

注册

我们将发送一封验证邮件至你的邮箱, 请正确填写以完成账号注册和激活