如何构建

Kmesh 需要在具有 Kmesh 内核增强功能的 Linux 环境中编译和构建。目前，Kmesh 可以在多个 OS 版本中编译和运行，具体 OS 版本请参见 Kmesh 支持系统。

构建

先决条件

安装 Docker 引擎

sudo apt-get update
(可选)sudo apt-get remove docker docker-engine docker.io
sudo apt install docker.io

您可以检查 Docker 版本以确保 Docker 已安装。

docker version
Client: Docker Engine - Community
Version:           26.0.1
API version:       1.45
Go version:        go1.21.9
Git commit:        d260a54
Built:             Thu Apr 11 10:53:21 2024
OS/Arch:           linux/amd64
Context:           default

Server: Docker Engine - Community
Engine:
  Version:          26.0.1
  API version:      1.45 (minimum version 1.24)
  Go version:       go1.21.9
  Git commit:       60b9add
  Built:            Thu Apr 11 10:53:21 2024
  OS/Arch:          linux/amd64
  Experimental:     false
containerd:
  Version:          1.6.31
  GitCommit:        e377cd56a71523140ca6ae87e30244719194a521
runc:
  Version:          1.1.12
  GitCommit:        v1.1.12-0-g51d5e94
docker-init:
  Version:          0.19.0
  GitCommit:        de40ad0

下载 Kmesh-build 镜像

要编译 Kmesh 镜像，您需要准备 Kmesh 源代码和 Kmesh-build 镜像。可以使用以下命令获取镜像：
```
docker pull ghcr.io/kmesh-net/kmesh-build-x86:latest
```
注意：Kmesh-build 镜像需要与源代码版本匹配。

从源代码构建 Kmesh

从 GitHub 克隆源代码。

git clone https://github.com/kmesh-net/kmesh.git

代码编译

通过 build-image 编译 Kmesh
```
cd kmesh/
make build
```
通过脚本编译 Kmesh

Kmesh 也提供通过脚本编译的方式
```
[root@dev] ./kmesh_compile.sh
```
注意，如果您使用脚本编译，需要确保您的 OS 系统版本是 Kmesh 支持系统中的一个！

Kmesh 编译完成后，构建产物将输出到 out 目录。

ls out/amd64/
kmesh-daemon       libbpf.so    libbpf.so.0.8.1       libkmesh_deserial.so  libprotobuf-c.so.1      mdacore
kmesh-cni  libboundscheck.so  libbpf.so.0  libkmesh_api_v2_c.so  libprotobuf-c.so      libprotobuf-c.so.1.0.0

构建 Docker 镜像

在 Kmesh 源代码目录中执行 make docker。

用户可以指定构建参数，如下例所示：

用户自定义 HUB、TARGET、TAG 值。如果未指定，将使用默认值。
HUB=ghcr.io/kmesh-net
TARGET=kmesh
TAG= #git sha

[root@dev docker] make docker
...
Successfully tagged ghcr.io/kmesh-net/kmesh:b68790eb07830e757f4ce6d1c478d0046ee79730

[root@dev docker] make docker HUB=ghcr.io/kmesh-net TARGET=kmesh TAG=latest
...
Successfully tagged ghcr.io/kmesh-net/kmesh:latest

检查本地镜像仓库中现有的 Kmesh 镜像：

[root@dev docker]# docker images ls
REPOSITORY                          TAG                                        IMAGE ID            CREATED             SIZE
ghcr.io/kmesh-net/kmesh             latest                                     71aec5898c44        About an hour ago   506MB

编译清理

您可以使用以下命令清理二进制文件。

[root@dev] make clean

构建​

先决条件​

从源代码构建 Kmesh​

构建 Docker 镜像​

编译清理​

构建

先决条件

从源代码构建 Kmesh

构建 Docker 镜像

编译清理