快速开始

安装

NJet官方提供centos，ubuntu，cloudOS等多个版本的2进制安装包，及软件源。其中支持的有：

二进制安装包，可以从gitee的主仓库选择对应的版本进行下载，或通过软件源的方式自动获得后续的 更新，目前支持centos及ubuntu的软件源配置。除NJet主应用外，NJet的某些功能模块会通过独立的 二进制发行包进行可选安装，当前提供的有njet-otel模块,用于支持调用链跟踪，其安装参考«njet- otel安装说明»（todo）。

1. 二进制安装​

OpenNJet 提供多个版本操作系统下的二进制安装文件，二进制包安装后，所有OpenNJet 相关的文件 都在 /usr/local/njet 目录下， 并在 /usr/lib/systemd/system 目录下添加service 文件。

1.1 RPM 安装​

1. 从 gitee https://gitee.com/njet-rd/njet/releases上下载对应操作系统的rpm 格式安装包​

2. 使用 yum 进行安装 例如下载的安装包是njet-2.0.0-1.el7.x86_64.rpm， yum localinstall ./njet- 2.0.0-1.el7.x86_64.rpm​

3. 安装后，使用命令 systemctl start njet 启动服务​

4. 使用命令 systemctl stop njet 停止服务​

1.2 DEB 安装​

1. 从 gitee https://gitee.com/njet-rd/njet/releases上下载对应操作系统的deb 格式安装包​
2. 使用 dpkg 进行安装 例如下载的安装包是njet_2.0.1-1~ubuntu.18.04~bionic_amd64.deb， dpkg -i ./njet_2.0.1-1~ubuntu.18.04~bionic_amd64.deb​
3. 安装后，使用命令 systemctl start njet 启动服务​
4. 使用命令 systemctl stop njet 停止服务​

2. 安装发行版

2.1 centos发行版​

现在 njet 支持yum源安装了，目前只支持 centos 7 和 x86_64架构。​ 具体安装方式如下：

1. 生成njet.repo

 echo "
 [opennjet]
    name=OpenNJet
 baseurl=https://njet.org.cn/download/linux/centos/$releasever/$basearch/
    enabled=1
    gpgcheck=1
 gpgkey=https://njet.org.cn/download/linux/centos/RPM-GPG-KEY-OpenNJet
 " > /etc/yum.repos.d/njet.repo

2. 更新yum 缓存

yum clean all
yum makecache #类似于 apt update​

3. 安装 njet 或 njet-otel

yum install njet
yum install njet-otel

4. 启动njet服务​

systemctl start njet

2.2 ubuntu发行版​

目前支持Ubuntu 18.04/20.04/22.04 amd64 架构的操作系统通过APT源直接安装二进制软件包​ 具体安装方式如下：

1. 添加gpg 文件​

 sudo apt-get update
 sudo apt-get install ca-certificates curl gnupg
 sudo install -m 0755 -d /etc/apt/keyrings
 curl -fsSL https://njet.org.cn/download/linux/ubuntu/gpg | sudo gpg --dearmor -
o /etc/apt/keyrings/njet.gpg
 sudo chmod a+r /etc/apt/keyrings/njet.gpg

2. 添加APT 源​

 echo \

"deb [arch=$(dpkg --print-architecture) signed-
by=/etc/apt/keyrings/njet.gpg] https://njet.org.cn/download/linux/ubuntu \
 $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
 sudo tee /etc/apt/sources.list.d/njet.list > /dev/null
 sudo apt-get update

3. 安装及启动

 sudo apt-get install njet
 sudo systemctl start njet

3. 源码安装

3.1 下载 OpenNJet 源码​

如果要下载特定tag的源码，如v2.0.0,则执行：

git clone -b v2.0.0 git@gitee.com:njet-rd/njet.git

如果要下载最新源码，则执行：

git clone git@gitee.com:njet-rd/njet.git

如果要下载特定branch(比如dynconf)的源码，则执行：

git clone git@gitee.com:njet-rd/njet.git --branch=dynconf

如果要下载特定branch（比如dynconf）的特定commit （ca5eaf057a5709a615a4873a1558c6d9fe1cc213）的源码，则执行：

git clone <remote_repository> --branch=<branch_name> --single-branch --depth=1
commit/ca5eaf057a5709a615a4873a1558c6d9fe1cc213

如果要下载特定commit（ca5eaf057a5709a615a4873a1558c6d9fe1cc213）源码，则执行：

git clone -b ca5eaf057a5709a615a4873a1558c6d9fe1cc213 git@gitee.com:njet-rd/njet.git

3.2 编译：

提供两种编译方法：

1. dockerfile快速编译，不用宿主机安装依赖的编译环境以及软件

   依赖：docker 环境（需要在编译机器安装docker并启动docker）

    docker build -t njet_main:v1.0 .

    docker run -v `pwd`:/njet_main njet_main:v1.0 /bin/bash -c "cd /njet_main &&
    ./build_cc.sh conf make"

2. 宿主机安装依赖环境以及软件 centos7系统请安装如下软件：

    gcc gcc-c++
    libtool libtool-ltdl cmake3
    make cmake perl perl-CPAN
    zlib-devel cmake perl-IPC-Cmd
    pkgconfig make vim-common
    sudo m4 deltarpm openssl-devel
    automake autoconf pcre2-devel
    yum-utils rpm-build

ubuntu系统请安装如下软件：

    gcc g++ make cmake libpcre2-dev
    libpcre3-dev libssl-dev zlib1g-dev
    perl m4  libtool  automake 
    autoconf vim-common unzip  libcap2-bin

编译命令：

    ./build_cc.sh conf make

3.3 安装：

• 将 /usr/local/lib 目录添加到 /etc/ld.so.conf 文件，并使用 make install 安装编译后的依赖库，可 执行文件，动态模块及默认配置文件。

sudo bash -c 'echo "/usr/local/lib" >> /etc/ld.so.conf'
sudo ./build_cc.sh install

4. 启动

4.1 手工起停

1. 通过源码编译安装的，可执行文件及相关的配置文件将安装到目录/usr/local/njet

 cd /usr/local/njet
 sbin/njet

4.2 通过systemctl起停​

使用 rpm 或 deb 二进制安装后，会在 /usr/lib/systemd/system/ 目录下添加 service文件。​

使用 sudo systemctl start njet 启动服务。​

使用 sudo systemctl stop njet 停止服务​

5. 验证

通过浏览器或curl/wget访问部署机器的8080地址​

curl http localhost:8080/

功能特性

贡献指南

贡献从哪里开始入手？

开始入手

初阶入门：从快速上手开始

文档贡献：当然您也可以考虑从文档贡献

高阶挑战：先来两个优化任务练练手

问题反馈：

1、提交 Issue 反馈问题

2、描述如何重现该问题（可选）

3、可提供解决方案（可选）

4、提交PR以解决问题（可选）

如果您想为OpenNJet贡献一个新功能点：

1、提出 issue 指出你想要的新功能以及原因

2、在 issue 中指出这个功能的实现方案以及测试大纲（可选）

3、提出PR实现这个新的功能

如果您对现有的已经存在的问题感兴趣：

1、您可以在标有bug、improvement和enhancement的issue标签内帮助他人。您可以选择给出对应的解决方案，并提交PR修复该issue

2、在标有question标签的issue内回答问题帮助他人

参加社区活动

如果您对现有的活动感兴趣：

欢迎关注我们的活动页面或者关注我们的QQ群：了解最新动态。

活动日历还在更新中···