From a4c5411bdf66b60440f0abca6f6fc1d1561705ad Mon Sep 17 00:00:00 2001 From: Liu Xiaodong Date: Tue, 8 Mar 2022 22:38:01 -0500 Subject: [PATCH] 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: Liu Xiaodong Reviewed-on: https://review.spdk.io/gerrit/c/spdk/spdk/+/11850 Community-CI: Broadcom CI Tested-by: SPDK CI Jenkins Reviewed-by: Changpeng Liu Reviewed-by: Tomasz Zawadzki --- doc/containers.md | 30 +++++++++++++++--------------- 1 file changed, 15 insertions(+), 15 deletions(-) diff --git a/doc/containers.md b/doc/containers.md index 7fd787587..8c0801f67 100644 --- a/doc/containers.md +++ b/doc/containers.md @@ -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)