Linux和Windows下部署BeetleX服务网关

        有朋友希望写一篇BeetleX服务网关部署到Linux和windows下并以服务的方式运行的介绍文章。接下详细介绍如何做并简单介绍一下网的使用。首先需要在官网(beetlex-io.com)下载对应版本的BeetleX服务网关（现阶段只支持linux64和windows64），下载完成后把可执行文件解压到相应的目录中。

运行

        服务网关的运行文件在linux下是BumblebeeApp，而windows是BumblebeeApp.exe。解压目录下还有一个HttpConfig.json配置文件，主要用于配置监听的端口、SSL和缓冲区配置等；默认情况是监听本地所有IP地址的80端口。

• linux
  

sudo chmod 777 BumblebeeApp #这个命令是给文件的执行权限，一般解压后都要执行才能运行
./BumblebeeApp #运行网关
#可以通过参数指定端口
./BumblebeeApp -port 8080 #这一命令是监听8080 端口，命令参数优先于配置

• windows

BumblebeeApp.exe  #命令行执行或直接双击执行即可

通过访问以下地址可以知道网关服务是否运行成功。

http://localhost/__system/bumblebee/index.html 根据实际部署的环境用域名或IP地址代替localhost

默认管理用户名密码是:admin 123456

制定服务

        对于服务来说都希望在系统启动的时候进行自动启动管理，接下来介绍如何在linux和windows下建立对应的启动服务。

• linux
  

        以下针对ubuntu的systemctl创建的服务，其他版本的linux可以根据各自的功能来创建

vim /etc/systemd/system/beetlex.service

可以添加一个beetlex.service的文件，并填写以下内容

[Unit]
Description=beetlex
After=network.target
[Service]
Type=oneshot
User=root
WorkingDirectory=/usr/share/beetlex
ExecStart=/usr/share/beetlex/BumblebeeApp


[Install]
WantedBy=default.target

注意:尽量不要使用root用户作为进程用户！

编写完成后就可以通过systemctl来启动，关闭和和查询服务信息

• windows
  

        在windows创建服务会更方便一些，只需要通过sc命令即可创建服务

sc create gateway binPath= d:\gateway\BumblebeeApp.exe

运行相关命令后即可以在服务管理里看到相关服务了

部署WEB站点

        网关部署后由于没有配置任何服务和路由，所以这个时候访问网关会显示如下内容:

接下来使用网关部署一个aspcore的示例，并添加到默认路由中。首先在【进程文件】管理中添加一个aspcore的目录,然后点击进去把发布好的示例上传到目录中(拖放上传，支持批量和子目录)。

接下来针对WebApplication1创建一服务进程，并把启动的服务指向到默认*路由上。

创建完进程后在【进程】管理功能中启动它

启动完成后再次访问网关即可以查看aspcore示例的内容

开启HTTPS

        服务网关支持开启https配置，但只支持单一证书，如果想希望多域名支持https只能通过申请泛域名的证书来支持。开启https非常简单只需要在HttpConfig.json中配置以下属性即可

"SSL": true,#开启ssl
    "SSLPort": 443,#ssl服务端口，不指定的情况是443
    "CertificateFile": "beetlex-io.com.pfx",#证书
    "CertificatePassword": "*****",#证书密码

BeetleX

开源跨平台通讯框架(支持TLS)
提供高性能服务和大数据处理解决方案

https://beetlex-io.com