iSulad/docs/build_guide.md

Build iSulad from source

If you intend to contribute on iSulad. Thanks for your effort. Every contribution is very appreciated for us.

Build iSulad based on openEuler distribution

If you use the openEuler distribution, you can easily install various dependent packages via yum.

Install Dependencies

$ sudo yum install -y cmake gcc-c++ systemd-devel yajl-devel libcurl libcurl-devel clibcni clibcni-devel protobuf-devel grpc-devel grpc-plugins http-parser-devel libwebsockets-devel libevhtp-devel libevent-devel lcr lxc-devel

Build steps:

Run the cmds under the iSulad source directory

$ sudo mkdir build
$ sudo cd build
$ sudo cmake ..
$ sudo make
$ sudo make install

Via Docker container

Build image

You can build iSulad via a Linux-based Docker container. You can build an image from theDockerfile in the source directory. From the iSulad source root directory you can run the following command to make your image.

$ sudo docker build --build-arg http_proxy=YOUR_HTTP_PROXY_IF_NEED
		--build-arg https_proxy=YOUR_HTTPS_PROXY_IF_NEED \
		-t YOUR_IMAGE_NAME -f ./Dockerfile .

Prepare root directory for the iSulad

Let's prepare a root directory on host, and we will mount this directory into the container. This directory be used by iSulad in container.

$ sudo mkdir -p /var/lib/isulad

Build iSulad in container

Let's suppose that you built an image called iSulad:dev.

Then from the iSulad source root directory you can run the following command:

$ sudo docker run -tid --name YOUR_CONTAINER_NAME -v /var/lib/isulad:/var/lib/isulad -v `pwd`:/src/isulad --privileged iSulad:dev

Let's suppose that you run an container named iSulad_build. Then you can use the following commands to build iSulad in your container iSulad_build:

// enter the container
$ sudo docker exec -it iSulad_build bash
// Now you enter the container, so build iSulad in the container by following commands
# cd /src/isulad
# mkdir build
# cd build
# cmake ..
# make
# make install

Now You can use direct command to start iSulad server in the container：

$ sudo isulad # run the server with default socket name and default log level and images manage function