iSulad

iSulad is a lightweight container runtime daemon which is designed for IOT and Cloud infrastructure.iSulad has the characteristics of light, fast and not limited by hardware specifications and architecture, and can be applied more widely.

Documentation

• en build guide
• cn build guide
• more usage guide

Getting Started

Installing

To install iSulad, you can use rpm or yum package manager command with openEuler repository.

Or write repository file by hand:

cat << EOF > /etc/yum.repos.d/openEuler.repo
[openEuler]
baseurl=https://repo.openeuler.org/openEuler-20.03-LTS/OS/\$basearch
enabled=1
EOF

Install iSulad with yum:

yum install -y iSulad

if you found this error

Repository 'openEuler' is missing name in configuration, using id.

You have enabled checking of packages via GPG keys. This is a good thing.
However, you do not have any GPG public keys installed. You need to download
the keys for packages you wish to install and install them.
You can do that by running the command:
    rpm --import public.gpg.key


Alternatively you can specify the url to the key you would like to use
for a repository in the 'gpgkey' option in a repository section and YUM
will install it for you.

For more information contact your distribution or package provider.

you should run rpm --import /etc/pki/rpm-gpg/RPM-GPG-KEY-openEuler first

Configure

Configure the container image registry address, for example "docker.io" or other registry addrss.

# cat /etc/isulad/daemon.json
.....
    "registry-mirrors": [
        "docker.io"
    ],
.....

Run

We provide systemd service to start iSulad:

systemctl restart isulad # restart the server with systemd command

You can use direct command to start iSulad server：

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

Operations on containers:

For more informations on how to use iSulad, please refer to the guide

iSulad provides two operate interfaces to manager images and containers.

• CLI, iSulad provides isula as client CLI

  Here are some sample commands to manager containers.

  List all containers in your own environment:

  # list containers
  $ sudo isula ps -a

  Create a container with busybox named test:

  # create a container 'test' with image busybox
  $ sudo isula create -t -n test busybox

  Start this container test:

  # start the container 'test'
  $ sudo isula start test

  Kill the container test:

  # kill the container 'test':
  $ sudo isula kill test

  Remove the container test:

  # remove the container 'test'
  $ sudo isula rm test

• CRI interface, iSulad can be integrated with kubernetes through CRI interface

  How to integrate with kubernetes please refer to integration.md

Build from source

Build requirements for developers are listed in build_guide

Performance

Machine configuration

X86 machine:

ARM machine:

Version of Softwares

Design of testcase

About code of test

• Now, we use shell to finish test cases of performance;

• Future, we should have a repository which store all test cases for iSula. Such as, performance tests, validation tests and so on... It's coming soon...

Compare with other container engines

run operator once

X86

base operators of client

base operators of CRI

ARM

base operators of client

base operators of CRI

parallel to run operator 100 times

X86

base operator of client

base operators of CRI

ARM

base operator of client

base operators of CRI

Try to Use iSulad

If you want to experience iSulad right now, you can try to use it at：

• https://lab.huaweicloud.com/testdetail_498

It is the experiment about iSulad. In this experiment you can install iSulad easily. And then you can pull image, run container, analyse iSulad's performance and compare it with performance of Docker.

How to Contribute

We always welcome new contributors. And we are happy to provide guidance for the new contributors. iSulad follows the kernel coding conventions. You can find a detailed introduction at:

• https://www.kernel.org/doc/html/v4.10/process/coding-style.html

You can get more information about iSulad from our wikis, including roadmap, feature design documents, etc:

• https://gitee.com/openeuler/iSulad/wikis

Licensing

iSulad is licensed under the Mulan PSL v2.

Related Resouces

• bilibili videos
• 如何在openEuler树莓派镜像上部署k8s+iSula集群
• 基于openEuler搭建部署k8s

Join us

You can join us on any of the following channels:

• Join our mailing list
• Join our Biweekly meeting at 16:30 pm on Tuesday (meeting link will be mailed at mailing list)