Commit a4c5411b authored by Liu Xiaodong's avatar Liu Xiaodong Committed by Tomasz Zawadzki
Browse files

doc/container: put containerizing SPDK to front 



Recently, received questions around containerizing SPDK app
or app built on top of SPDK. Containerizing SPDK is more
useful for general SPDK users.
So move it to front in order to avoid SPDK users get confused
or stuck on the Kata one.

Change-Id: I3dc510d0a7bafa63be4559810990d28c5f9d7de5
Signed-off-by: default avatarLiu Xiaodong <xiaodong.liu@intel.com>
Reviewed-on: https://review.spdk.io/gerrit/c/spdk/spdk/+/11850


Community-CI: Broadcom CI <spdk-ci.pdl@broadcom.com>
Tested-by: default avatarSPDK CI Jenkins <sys_sgci@intel.com>
Reviewed-by: default avatarChangpeng Liu <changpeng.liu@intel.com>
Reviewed-by: default avatarTomasz Zawadzki <tomasz.zawadzki@intel.com>
parent 087b6cb6

doc/containers.md

+15 −15
Original line number Diff line number Diff line
@@ -6,22 +6,8 @@ here. 


## In this document {#containers_toc}



* @ref kata_containers_with_spdk_vhost

* @ref spdk_in_docker



## Using SPDK vhost target to provide volume service to Kata Containers and Docker {#kata_containers_with_spdk_vhost}



[Kata Containers](https://katacontainers.io) can build a secure container

runtime with lightweight virtual machines that feel and perform like

containers, but provide stronger workload isolation using hardware

virtualization technology as a second layer of defense.



From Kata Containers [1.11.0](https://github.com/kata-containers/runtime/releases/tag/1.11.0),

vhost-user-blk support is enabled in `kata-containers/runtime`. That is to say

SPDK vhost target can be used to provide volume service to Kata Containers directly.

In addition, a container manager like Docker, can be configured easily to launch

a Kata container with an SPDK vhost-user block device. For operating details, visit

Kata containers use-case [Setup to run SPDK vhost-user devices with Kata Containers and Docker](https://github.com/kata-containers/documentation/blob/master/use-cases/using-SPDK-vhostuser-and-kata.md#host-setup-for-vhost-user-devices)

* @ref kata_containers_with_spdk_vhost



## Containerizing an SPDK Application for Docker {#spdk_in_docker}
@@ -90,3 +76,17 @@ Initialization complete. 
INFO: using host memory buffer for IO

Hello world!

~~~



## Using SPDK vhost target to provide volume service to Kata Containers and Docker {#kata_containers_with_spdk_vhost}



[Kata Containers](https://katacontainers.io) can build a secure container

runtime with lightweight virtual machines that feel and perform like

containers, but provide stronger workload isolation using hardware

virtualization technology as a second layer of defense.



From Kata Containers [1.11.0](https://github.com/kata-containers/runtime/releases/tag/1.11.0),

vhost-user-blk support is enabled in `kata-containers/runtime`. That is to say

SPDK vhost target can be used to provide volume service to Kata Containers directly.

In addition, a container manager like Docker, can be configured easily to launch

a Kata container with an SPDK vhost-user block device. For operating details, visit

Kata containers use-case [Setup to run SPDK vhost-user devices with Kata Containers and Docker](https://github.com/kata-containers/documentation/blob/master/use-cases/using-SPDK-vhostuser-and-kata.md#host-setup-for-vhost-user-devices)