From e46cd3b4cff04bbb71aae786911257f77c8a1247 Mon Sep 17 00:00:00 2001 From: caihaomin Date: Thu, 2 Jan 2020 17:16:59 +0800 Subject: [PATCH] change ReadME Signed-off-by: caihaomin --- README.md | 64 ++++++++++++++++++++++++++++++++++++++++---- logo/isula-logo.png | Bin 0 -> 12202 bytes 2 files changed, 59 insertions(+), 5 deletions(-) create mode 100644 logo/isula-logo.png diff --git a/README.md b/README.md index 0475907..d632af2 100644 --- a/README.md +++ b/README.md @@ -1,9 +1,63 @@ -# iSulad +iSulad -This is a umbrella project for gRPC-services based Lightweight Container Runtime Daemon. -iSulad provide a unified architecture to meet the different needs of CT and IT. -Compared with Docker written by Golang, iSulad has the characteristics of light, agile, fast, -not limited by hardware specifications and architecture, and can be applied more widely. +## iSulad + +`iSulad` is a light weight container runtime daemon which is desinged 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. + +## Getting Started + +### Installing +To install iSulad, you can use `rpm` or `yum` package manager command with `openEuler` repository. + +Install iSulad with yum +```sh +yum install -y iSulad +``` + +### Run +We provide `systemd` service to start `iSulad` +```sh +systemd start lcrd # run the server with systemd command +``` + +You can use direct command to start `iSulad` server: +```sh +$ sudo lcrd # run the server with default socket name and default log level and images manage function +``` +### Operations on containers: +`iSulad` provides command line `lcrd` to talk with server. +Here are some sample commands to manager containers. + +List all containers in your own environment: +```sh +# list containers +$ sudo lcrc ps -a +``` + +Create a container with busybox named `test` +```sh +# create a container 'test' with image busybox +$ sudo lcrc create -t -n test busybox +``` + +Start this container `test` +```sh +# start the container 'test' +$ sudo lcrc start test +``` +Kill the container `test` +```sh +# kill the container 'test' +$ sudo lcrc kill test +``` +Remove the container `test` +```sh +# remove the container 'test' +$ sudo lcrc rm test +``` + +### Build from source +Build requirements for developers are listed in [build_guide](./doc/build_guide.md) ## How to Contribute diff --git a/logo/isula-logo.png b/logo/isula-logo.png new file mode 100644 index 0000000000000000000000000000000000000000..011d66d9c1a696a605bc88a02c8e470d6f54d039 GIT binary patch literal 12202 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