github/kata-containers
1
0
Fork 1
mirror of https://github.com/kata-containers/kata-containers.git synced 2025-06-26 07:22:20 +00:00
Code Issues Projects Releases Wiki Activity
runtime-rs
kata-containers/docs/install/kata-containers-3.0-rust-runtime-installation-guide.md
Zhongtao Hu fa85fd584e docs: add rust environment setup for kata 3.0 
add more details for rust set up in kata 3.0 install guide

Fixes: #4720
Signed-off-by: Zhongtao Hu <zhongtaohu.tim@linux.alibaba.com>
2022-07-25 09:48:18 +08:00

4.7 KiB
Raw Permalink Blame History

Kata Containers 3.0 rust runtime installation

The following is an overview of the different installation methods available.

Prerequisites

Kata Containers 3.0 rust runtime requires nested virtualization or bare metal. Check hardware requirements to see if your system is capable of running Kata Containers.

Platform support

Kata Containers 3.0 rust runtime currently runs on 64-bit systems supporting the following architectures:

Notes: For other architectures, see https://github.com/kata-containers/kata-containers/issues/4320

Architecture Virtualization technology
x86_64 Intel VT-x
aarch64 ("arm64") ARM Hyp

Packaged installation methods

Installation method Description Automatic updates Use case Availability
Using kata-deploy The preferred way to deploy the Kata Containers distributed binaries on a Kubernetes cluster No! Best way to give it a try on kata-containers on an already up and running Kubernetes cluster. No
Using official distro packages Kata packages provided by Linux distributions official repositories yes Recommended for most users. No
Using snap Easy to install yes Good alternative to official distro packages. No
Automatic Run a single command to install a full system No! For those wanting the latest release quickly. No
Manual Follow a guide step-by-step to install a working system No! For those who want the latest release with more control. No
Build from source Build the software components manually No! Power users and developers only. Yes

Kata Deploy Installation

ToDo

Official packages

ToDo

Snap Installation

ToDo

Automatic Installation

ToDo

Manual Installation

ToDo

Build from source installation

Rust Environment Set Up

  • Download Rustup and install Rust

    Notes: Rust version 1.58 is needed

    Example for x86_64

    $ curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
$ source $HOME/.cargo/env
$ rustup install 1.58
$ rustup default 1.58-x86_64-unknown-linux-gnu

  • Musl support for fully static binary

    Example for x86_64

    $ rustup target add x86_64-unknown-linux-musl

  • Musl libc install

    Example for musl 1.2.3

    $ wget https://git.musl-libc.org/cgit/musl/snapshot/musl-1.2.3.tar.gz
$ tar vxf musl-1.2.3.tar.gz
$ cd musl-1.2.3/
$ ./configure --prefix=/usr/local/
$ make && sudo make install

Install Kata 3.0 Rust Runtime Shim

$ git clone https://github.com/kata-containers/kata-containers.git
$ cd kata-containers/src/runtime-rs
$ make && make install

After running the command above, the default config file configuration.toml will be installed under /usr/share/defaults/kata-containers/, the binary file containerd-shim-kata-v2 will be installed under /user/local/bin .

Build Kata Containers Kernel

Follow the Kernel installation guide.

Build Kata Rootfs

Follow the Rootfs installation guide.

Build Kata Image

Follow the Image installation guide.

Install Containerd

Follow the Containerd installation guide.