This document is written specifically for developers: it is not intended for end users.
If you want to contribute changes that you have made, please read the community guidelines for information about our processes.
- You are working on a non-critical test or development system.
The recommended way to create a development environment is to first install the packaged versions of the Kata Containers components to create a working system.
The installation guide instructions will install all required Kata Containers components, plus Docker, the hypervisor, and the Kata Containers image and guest kernel.
You need to install the following to build Kata Containers components:
-
To view the versions of go known to work, see the
golang
entry in the versions database. -
To view the versions of rust known to work, see the
rust
entry in the versions database. -
make
. -
gcc
(required for building the shim and runtime).
$ git clone https://github.com/kata-containers/kata-containers.git
$ pushd kata-containers/src/runtime
$ make && sudo -E "PATH=$PATH" make install
$ sudo mkdir -p /etc/kata-containers/
$ sudo install -o root -g root -m 0640 /usr/share/defaults/kata-containers/configuration.toml /etc/kata-containers
$ popd
The build will create the following:
- runtime binary:
/usr/local/bin/kata-runtime
and/usr/local/bin/containerd-shim-kata-v2
- configuration file:
/usr/share/defaults/kata-containers/configuration.toml
and/etc/kata-containers/configuration.toml
Kata containers can run with either an initrd image or a rootfs image.
If you want to test with initrd
, make sure you have uncommented initrd = /usr/share/kata-containers/kata-containers-initrd.img
in your configuration file, commenting out the image
line in
/etc/kata-containers/configuration.toml
. For example:
$ sudo sed -i 's/^\(image =.*\)/# \1/g' /etc/kata-containers/configuration.toml
$ sudo sed -i 's/^# \(initrd =.*\)/\1/g' /etc/kata-containers/configuration.toml
You can create the initrd image as shown in the create an initrd image section.
If you want to test with a rootfs image
, make sure you have uncommented image = /usr/share/kata-containers/kata-containers.img
in your configuration file, commenting out the initrd
line. For example:
$ sudo sed -i 's/^\(initrd =.*\)/# \1/g' /etc/kata-containers/configuration.toml
The rootfs image is created as shown in the create a rootfs image section.
One of the initrd
and image
options in Kata runtime config file MUST be set but not both.
The main difference between the options is that the size of initrd
(10MB+) is significantly smaller than
rootfs image
(100MB+).
Enable seccomp as follows:
$ sudo sed -i '/^disable_guest_seccomp/ s/true/false/' /etc/kata-containers/configuration.toml
This will pass container seccomp profiles to the kata agent.
Note:
- To enable SELinux on the guest, SELinux MUST be also enabled on the host.
- You MUST create and build a rootfs image for SELinux in advance. See Create a rootfs image and Build a rootfs image.
- SELinux on the guest is supported in only a rootfs image currently, so you cannot enable SELinux with the agent init (
AGENT_INIT=yes
) yet.
Enable guest SELinux in Enforcing mode as follows:
$ sudo sed -i '/^disable_guest_selinux/ s/true/false/g' /etc/kata-containers/configuration.toml
The runtime automatically will set selinux=1
to the kernel parameters and xattr
option to
virtiofsd
when disable_guest_selinux
is set to false
.
If you want to enable SELinux in Permissive mode, add enforcing=0
to the kernel parameters.
Enable full debug as follows:
$ sudo sed -i -e 's/^# *\(enable_debug\).*=.*$/\1 = true/g' /etc/kata-containers/configuration.toml
$ sudo sed -i -e 's/^kernel_params = "\(.*\)"/kernel_params = "\1 agent.log=debug initcall_debug"/g' /etc/kata-containers/configuration.toml
If you are using containerd
and the Kata containerd-shimv2
to launch Kata Containers, and wish
to enable Kata debug logging, there are two ways this can be enabled via the containerd
configuration file,
detailed below.
The Kata logs appear in the containerd
log files, along with logs from containerd
itself.
For more information about containerd
debug, please see the
containerd
documentation.
Enabling full containerd
debug also enables the shimv2 debug. Edit the containerd
configuration file
to include the top level debug option such as:
[debug]
level = "debug"
If you only wish to enable debug for the containerd
shims themselves, just enable the debug
option in the plugins.linux
section of the containerd
configuration file, such as:
[plugins.linux]
shim_debug = true
Depending on the CRI-O version being used one of the following configuration files can
be found: /etc/crio/crio.conf
or /etc/crio/crio.conf.d/00-default
.
If the latter is found, the change must be done there as it'll take precedence, overriding
/etc/crio/crio.conf
.
# Changes the verbosity of the logs based on the level it is set to. Options
# are fatal, panic, error, warn, info, debug and trace. This option supports
# live configuration reload.
log_level = "info"
Switching the default log_level
from info
to debug
enables shimv2 debug logs.
CRI-O logs can be found by using the crio
identifier, and Kata specific logs can
be found by using the kata
identifier.
Enabling full debug results in the Kata components generating
large amounts of logging, which by default is stored in the system log. Depending on
your system configuration, it is possible that some events might be discarded by the
system logging daemon. The following shows how to determine this for systemd-journald
,
and offers possible workarounds and fixes.
Note The method of implementation can vary between Operating System installations. Amend these instructions as necessary to your system implementation, and consult with your system administrator for the appropriate configuration.
systemd-journald
can be configured to rate limit the number of journal entries
it stores. When messages are suppressed, it is noted in the logs. This can be checked
for by looking for those notifications, such as:
$ sudo journalctl --since today | fgrep Suppressed
Jun 29 14:51:17 mymachine systemd-journald[346]: Suppressed 4150 messages from /system.slice/docker.service
This message indicates that a number of log messages from the docker.service
slice were
suppressed. In such a case, you can expect to have incomplete logging information
stored from the Kata Containers components.
In order to capture complete logs from the Kata Containers components, you
need to reduce or disable the systemd-journald
rate limit. Configure
this at the global systemd-journald
level, and it will apply to all system slices.
To disable systemd-journald
rate limiting at the global level, edit the file
/etc/systemd/journald.conf
, and add/uncomment the following lines:
RateLimitInterval=0s
RateLimitBurst=0
Restart systemd-journald
for the changes to take effect:
$ sudo systemctl restart systemd-journald
Note:
- You should only do this step if you are testing with the latest version of the agent.
The agent is built with a statically linked musl.
The default libc
used is musl
, but on ppc64le
and s390x
, gnu
should be used. To configure this:
$ export ARCH="$(uname -m)"
$ if [ "$ARCH" = "ppc64le" -o "$ARCH" = "s390x" ]; then export LIBC=gnu; else export LIBC=musl; fi
$ [ "${ARCH}" == "ppc64le" ] && export ARCH=powerpc64le
$ rustup target add "${ARCH}-unknown-linux-${LIBC}"
To build the agent:
The agent is built with seccomp capability by default.
If you want to build the agent without the seccomp capability, you need to run make
with SECCOMP=no
as follows.
$ make -C kata-containers/src/agent SECCOMP=no
For building the agent with seccomp support using musl
, set the environment
variables for the libseccomp
crate.
$ export LIBSECCOMP_LINK_TYPE=static
$ export LIBSECCOMP_LIB_PATH="the path of the directory containing libseccomp.a"
$ make -C kata-containers/src/agent
If the compilation fails when the agent tries to link the libseccomp
library statically
against musl
, you will need to build libseccomp
manually with -U_FORTIFY_SOURCE
.
You can use our script
to install libseccomp
for the agent.
$ mkdir -p ${seccomp_install_path} ${gperf_install_path}
$ kata-containers/ci/install_libseccomp.sh ${seccomp_install_path} ${gperf_install_path}
$ export LIBSECCOMP_LIB_PATH="${seccomp_install_path}/lib"
On ppc64le
and s390x
, glibc
is used. You will need to install the libseccomp
library
provided by your distribution.
e.g.
libseccomp-dev
for Ubuntu, orlibseccomp-devel
for CentOS
Note:
- If you enable seccomp in the main configuration file but build the agent without seccomp capability, the runtime exits conservatively with an error message.
As a prerequisite, you need to install Docker. Otherwise, you will not be
able to run the rootfs.sh
script with USE_DOCKER=true
as expected in
the following example.
$ export distro="ubuntu" # example
$ export ROOTFS_DIR="$(realpath kata-containers/tools/osbuilder/rootfs-builder/rootfs)"
$ sudo rm -rf "${ROOTFS_DIR}"
$ pushd kata-containers/tools/osbuilder/rootfs-builder
$ script -fec 'sudo -E USE_DOCKER=true ./rootfs.sh "${distro}"'
$ popd
You MUST choose a distribution (e.g., ubuntu
) for ${distro}
.
You can get a supported distributions list in the Kata Containers by running the following.
$ ./kata-containers/tools/osbuilder/rootfs-builder/rootfs.sh -l
If you want to build the agent without seccomp capability, you need to run the rootfs.sh
script with SECCOMP=no
as follows.
$ script -fec 'sudo -E AGENT_INIT=yes USE_DOCKER=true SECCOMP=no ./rootfs.sh "${distro}"'
If you want to enable SELinux on the guest, you MUST choose centos
and run the rootfs.sh
script with SELINUX=yes
as follows.
$ script -fec 'sudo -E GOPATH=$GOPATH USE_DOCKER=true SELINUX=yes ./rootfs.sh centos'
Note:
- Check the compatibility matrix before creating rootfs.
- You must ensure that the default Docker runtime is
runc
to make use of theUSE_DOCKER
variable. If that is not the case, remove the variable from the previous command. See Checking Docker default runtime.
Note:
- You should only do this step if you are testing with the latest version of the agent.
$ sudo install -o root -g root -m 0550 -t "${ROOTFS_DIR}/usr/bin" "${ROOTFS_DIR}/../../../../src/agent/target/x86_64-unknown-linux-musl/release/kata-agent"
$ sudo install -o root -g root -m 0440 "${ROOTFS_DIR}/../../../../src/agent/kata-agent.service" "${ROOTFS_DIR}/usr/lib/systemd/system/"
$ sudo install -o root -g root -m 0440 "${ROOTFS_DIR}/../../../../src/agent/kata-containers.target" "${ROOTFS_DIR}/usr/lib/systemd/system/"
$ pushd kata-containers/tools/osbuilder/image-builder
$ script -fec 'sudo -E USE_DOCKER=true ./image_builder.sh "${ROOTFS_DIR}"'
$ popd
If you want to enable SELinux on the guest, you MUST run the image_builder.sh
script with SELINUX=yes
to label the guest image as follows.
To label the image on the host, you need to make sure that SELinux is enabled (selinuxfs
is mounted) on the host
and the rootfs MUST be created by running the rootfs.sh
with SELINUX=yes
.
$ script -fec 'sudo -E USE_DOCKER=true SELINUX=yes ./image_builder.sh ${ROOTFS_DIR}'
Currently, the image_builder.sh
uses chcon
as an interim solution in order to apply container_runtime_exec_t
to the kata-agent
. Hence, if you run restorecon
to the guest image after running the image_builder.sh
,
the kata-agent
needs to be labeled container_runtime_exec_t
again by yourself.
Notes:
- You must ensure that the default Docker runtime is
runc
to make use of theUSE_DOCKER
variable. If that is not the case, remove the variable from the previous command. See Checking Docker default runtime.- If you do not wish to build under Docker, remove the
USE_DOCKER
variable in the previous command and ensure theqemu-img
command is available on your system.
- If
qemu-img
is not installed, you will likely see errors such asERROR: File /dev/loop19p1 is not a block device
andlosetup: /tmp/tmp.bHz11oY851: Warning: file is smaller than 512 bytes; the loop device may be useless or invisible for system tools
. These can be mitigated by installing theqemu-img
command (available in theqemu-img
package on Fedora or theqemu-utils
package on Debian).- If
loop
module is not probed, you will likely see errors such aslosetup: cannot find an unused loop device
. Executemodprobe loop
could resolve it.
$ pushd kata-containers/tools/osbuilder/image-builder
$ commit="$(git log --format=%h -1 HEAD)"
$ date="$(date +%Y-%m-%d-%T.%N%z)"
$ image="kata-containers-${date}-${commit}"
$ sudo install -o root -g root -m 0640 -D kata-containers.img "/usr/share/kata-containers/${image}"
$ (cd /usr/share/kata-containers && sudo ln -sf "$image" kata-containers.img)
$ popd
$ export distro="ubuntu" # example
$ export ROOTFS_DIR="$(realpath kata-containers/tools/osbuilder/rootfs-builder/rootfs)"
$ sudo rm -rf "${ROOTFS_DIR}"
$ pushd kata-containers/tools/osbuilder/rootfs-builder/
$ script -fec 'sudo -E AGENT_INIT=yes USE_DOCKER=true ./rootfs.sh "${distro}"'
$ popd
AGENT_INIT
controls if the guest image uses the Kata agent as the guest init
process. When you create an initrd image,
always set AGENT_INIT
to yes
.
You MUST choose a distribution (e.g., ubuntu
) for ${distro}
.
You can get a supported distributions list in the Kata Containers by running the following.
$ ./kata-containers/tools/osbuilder/rootfs-builder/rootfs.sh -l
If you want to build the agent without seccomp capability, you need to run the rootfs.sh
script with SECCOMP=no
as follows.
$ script -fec 'sudo -E AGENT_INIT=yes USE_DOCKER=true SECCOMP=no ./rootfs.sh "${distro}"'
Note:
- Check the compatibility matrix before creating rootfs.
Optionally, add your custom agent binary to the rootfs with the following commands. The default $LIBC
used
is musl
, but on ppc64le and s390x, gnu
should be used. Also, Rust refers to ppc64le as powerpc64le
:
$ export ARCH="$(uname -m)"
$ [ "${ARCH}" == "ppc64le" ] || [ "${ARCH}" == "s390x" ] && export LIBC=gnu || export LIBC=musl
$ [ "${ARCH}" == "ppc64le" ] && export ARCH=powerpc64le
$ sudo install -o root -g root -m 0550 -T "${ROOTFS_DIR}/../../../../src/agent/target/${ARCH}-unknown-linux-${LIBC}/release/kata-agent" "${ROOTFS_DIR}/sbin/init"
$ pushd kata-containers/tools/osbuilder/initrd-builder
$ script -fec 'sudo -E AGENT_INIT=yes USE_DOCKER=true ./initrd_builder.sh "${ROOTFS_DIR}"'
$ popd
$ pushd kata-containers/tools/osbuilder/initrd-builder
$ commit="$(git log --format=%h -1 HEAD)"
$ date="$(date +%Y-%m-%d-%T.%N%z)"
$ image="kata-containers-initrd-${date}-${commit}"
$ sudo install -o root -g root -m 0640 -D kata-containers-initrd.img "/usr/share/kata-containers/${image}"
$ (cd /usr/share/kata-containers && sudo ln -sf "$image" kata-containers-initrd.img)
$ popd
You can build and install the guest kernel image as shown here.
When setting up Kata using a packaged installation method, the
QEMU
VMM is installed automatically. Cloud-Hypervisor and Firecracker VMMs are available from the release tarballs, as well as through kata-deploy
.
You may choose to manually build your VMM/hypervisor.
Kata Containers makes use of upstream QEMU branch. The exact version and repository utilized can be found by looking at the versions file.
Find the correct version of QEMU from the versions file:
$ source kata-containers/tools/packaging/scripts/lib.sh
$ qemu_version="$(get_from_kata_deps "assets.hypervisor.qemu.version")"
$ echo "${qemu_version}"
Get source from the matching branch of QEMU:
$ git clone -b "${qemu_version}" https://github.com/qemu/qemu.git
$ your_qemu_directory="$(realpath qemu)"
There are scripts to manage the build and packaging of QEMU. For the examples below, set your environment as:
$ packaging_dir="$(realpath kata-containers/tools/packaging)"
Kata often utilizes patches for not-yet-upstream and/or backported fixes for components, including QEMU. These can be found in the packaging/QEMU directory, and it's recommended that you apply them. For example, suppose that you are going to build QEMU version 5.2.0, do:
$ "$packaging_dir/scripts/apply_patches.sh" "$packaging_dir/qemu/patches/5.2.x/"
To build utilizing the same options as Kata, you should make use of the configure-hypervisor.sh
script. For example:
$ pushd "$your_qemu_directory"
$ "$packaging_dir/scripts/configure-hypervisor.sh" kata-qemu > kata.cfg
$ eval ./configure "$(cat kata.cfg)"
$ make -j $(nproc --ignore=1)
# Optional
$ sudo -E make install
$ popd
If you do not want to install the respective QEMU version, the configuration file can be modified to point to the correct binary. In /etc/kata-containers/configuration.toml
, change path = "/path/to/qemu/build/qemu-system-x86_64"
to point to the correct QEMU binary.
See the static-build script for QEMU for a reference on how to get, setup, configure and build QEMU for Kata.
Note:
- You should only do this step if you are on aarch64/arm64.
- You should include Eric Auger's latest PCDIMM/NVDIMM patches which are under upstream review for supporting NVDIMM on aarch64.
You could build the custom qemu-system-aarch64
as required with the following command:
$ git clone https://github.com/kata-containers/tests.git
$ script -fec 'sudo -E tests/.ci/install_qemu.sh'
When using the file system type virtio-fs (default), virtiofsd
is required
$ pushd kata-containers/tools/packaging/static-build/virtiofsd
$ ./build.sh
$ popd
Modify /etc/kata-containers/configuration.toml
and update value virtio_fs_daemon = "/path/to/kata-containers/tools/packaging/static-build/virtiofsd/virtiofsd/virtiofsd"
to point to the binary.
You can check if your system is capable of creating a Kata Container by running the following:
$ sudo kata-runtime check
If your system is not able to run Kata Containers, the previous command will error out and explain why.
Refer to the How to use Kata Containers and Containerd how-to guide.
Refer to the Run Kata Containers with Kubernetes how-to guide.
If you are unable to create a Kata Container first ensure you have
enabled full debug
before attempting to create a container. Then run the
kata-collect-data.sh
script and paste its output directly into a
GitHub issue.
Note:
The
kata-collect-data.sh
script is built from the runtime repository.
To perform analysis on Kata logs, use the
kata-log-parser
tool, which can convert the logs into formats (e.g. JSON, TOML, XML, and YAML).
$ sudo docker info 2>/dev/null | grep -i "default runtime" | cut -d: -f2- | grep -q runc && echo "SUCCESS" || echo "ERROR: Incorrect default Docker runtime"
Kata containers provides two ways to connect to the guest. One is using traditional login service, which needs additional works. In contrast the simple debug console is easy to setup.
Kata Containers 2.0 supports a shell simulated console for quick debug purpose. This approach uses VSOCK to
connect to the shell running inside the guest which the agent starts. This method only requires the guest image to
contain either /bin/sh
or /bin/bash
.
Enable debug_console_enabled in the configuration.toml
configuration file:
[agent.kata]
debug_console_enabled = true
This will pass agent.debug_console agent.debug_console_vport=1026
to agent as kernel parameters, and sandboxes created using this parameters will start a shell in guest if new connection is accept from VSOCK.
For Kata Containers 2.0.x
releases, the kata-runtime exec
command depends on thekata-monitor
running, in order to get the sandbox's vsock
address to connect to. Thus, first start the kata-monitor
process.
$ sudo kata-monitor
kata-monitor
will serve at localhost:8090
by default.
Command kata-runtime exec
is used to connect to the debug console.
$ kata-runtime exec 1a9ab65be63b8b03dfd0c75036d27f0ed09eab38abb45337fea83acd3cd7bacd
bash-4.2# id
uid=0(root) gid=0(root) groups=0(root)
bash-4.2# pwd
/
bash-4.2# exit
exit
kata-runtime exec
has a command-line option runtime-namespace
, which is used to specify under which runtime namespace the particular pod was created. By default, it is set to k8s.io
and works for containerd when configured
with Kubernetes. For CRI-O, the namespace should set to default
explicitly. This should not be confused with Kubernetes namespaces.
For other CRI-runtimes and configurations, you may need to set the namespace utilizing the runtime-namespace
option.
If you want to access guest OS through a traditional way, see Traditional debug console setup).
By default you cannot login to a virtual machine, since this can be sensitive from a security perspective. Also, allowing logins would require additional packages in the rootfs, which would increase the size of the image used to boot the virtual machine.
If you want to login to a virtual machine that hosts your containers, complete the following steps (using rootfs or initrd image).
Note: The following debug console instructions assume a systemd-based guest O/S image. This means you must create a rootfs for a distro that supports systemd. Currently, all distros supported by osbuilder support systemd except for Alpine Linux.
Look for
INIT_PROCESS=systemd
in theconfig.sh
osbuilder rootfs config file to verify an osbuilder distro supports systemd for the distro you want to build rootfs for. For an example, see the Clear Linux config.sh file.For a non-systemd-based distro, create an equivalent system service using that distro’s init system syntax. Alternatively, you can build a distro that contains a shell (e.g.
bash(1)
). In this circumstance it is likely you need to install additional packages in the rootfs and add “agent.debug_console” to kernel parameters in the runtime config file. This tells the Kata agent to launch the console directly.Once these steps are taken you can connect to the virtual machine using the debug console.
To login to a virtual machine, you must
create a custom rootfs or custom initrd
containing a shell such as bash(1)
. For Clear Linux, you will need
an additional coreutils
package.
For example using CentOS:
$ pushd kata-containers/tools/osbuilder/rootfs-builder
$ export ROOTFS_DIR="$(realpath ./rootfs)"
$ script -fec 'sudo -E USE_DOCKER=true EXTRA_PKGS="bash coreutils" ./rootfs.sh centos'
Follow the instructions in the Build a rootfs image section when using rootfs, or when using initrd, complete the steps in the Build an initrd image section.
Install the image:
Note: When using an initrd image, replace the below rootfs image name
kata-containers.img
with the initrd image namekata-containers-initrd.img
.
$ name="kata-containers-centos-with-debug-console.img"
$ sudo install -o root -g root -m 0640 kata-containers.img "/usr/share/kata-containers/${name}"
$ popd
Next, modify the image=
values in the [hypervisor.qemu]
section of the
configuration file
to specify the full path to the image name specified in the previous code
section. Alternatively, recreate the symbolic link so it points to
the new debug image:
$ (cd /usr/share/kata-containers && sudo ln -sf "$name" kata-containers.img)
Note: You should take care to undo this change after you finish debugging to avoid all subsequently created containers from using the debug image.
Create a container as normal. For example using crictl
:
$ sudo crictl run -r kata container.yaml pod.yaml
The steps required to enable debug console for QEMU slightly differ with those for firecracker / cloud-hypervisor.
Add agent.debug_console
to the guest kernel command line to allow the agent process to start a debug console.
$ sudo sed -i -e 's/^kernel_params = "\(.*\)"/kernel_params = "\1 agent.debug_console"/g' "${kata_configuration_file}"
Here kata_configuration_file
could point to /etc/kata-containers/configuration.toml
or /usr/share/defaults/kata-containers/configuration.toml
or /opt/kata/share/defaults/kata-containers/configuration-{hypervisor}.toml
, if
you installed Kata Containers using kata-deploy
.
Slightly different configuration is required in case of firecracker and cloud hypervisor.
Firecracker and cloud-hypervisor don't have a UNIX socket connected to /dev/console
.
Hence, the kernel command line option agent.debug_console
will not work for them.
These hypervisors support hybrid vsocks
, which can be used for communication
between the host and the guest. The kernel command line option agent.debug_console_vport
was added to allow developers specify on which vsock
port the debugging console should be connected.
Add the parameter agent.debug_console_vport=1026
to the kernel command line
as shown below:
sudo sed -i -e 's/^kernel_params = "\(.*\)"/kernel_params = "\1 agent.debug_console_vport=1026"/g' "${kata_configuration_file}"
Note Ports 1024 and 1025 are reserved for communication with the agent and gathering of agent logs respectively.
Next, connect to the debug console. The VSOCKS paths vary slightly between each VMM solution.
In case of cloud-hypervisor, connect to the vsock
as shown:
$ sudo su -c 'cd /var/run/vc/vm/${sandbox_id}/root/ && socat stdin unix-connect:clh.sock'
CONNECT 1026
Note: You need to type CONNECT 1026
and press RETURN
key after entering the socat
command.
For firecracker, connect to the hvsock
as shown:
$ sudo su -c 'cd /var/run/vc/firecracker/${sandbox_id}/root/ && socat stdin unix-connect:kata.hvsock'
CONNECT 1026
Note: You need to press the RETURN
key to see the shell prompt.
For QEMU, connect to the vsock
as shown:
$ sudo su -c 'cd /var/run/vc/vm/${sandbox_id} && socat "stdin,raw,echo=0,escape=0x11" "unix-connect:console.sock"'
To disconnect from the virtual machine, type CONTROL+q
(hold down the
CONTROL
key and press q
).
If the image is created using osbuilder, the following YAML file exists and contains details of the image and how it was created:
$ cat /var/lib/osbuilder/osbuilder.yaml
Sometimes it is useful to capture the kernel boot messages from a Kata Container
launch. If the container launches to the point whereby you can exec
into it, and
if the container has the necessary components installed, often you can execute the dmesg
command inside the container to view the kernel boot logs.
If however you are unable to exec
into the container, you can enable some debug
options to have the kernel boot messages logged into the system journal.
- Set
enable_debug = true
in the[hypervisor.qemu]
and[runtime]
sections
For generic information on enabling debug in the configuration file, see the Enable full debug section.
The kernel boot messages will appear in the kata
logs (and in the containerd
or CRI-O
log appropriately).
such as:
$ sudo journalctl -t kata
-- Logs begin at Thu 2020-02-13 16:20:40 UTC, end at Thu 2020-02-13 16:30:23 UTC. --
...
time="2020-09-15T14:56:23.095113803+08:00" level=debug msg="reading guest console" console-protocol=unix console-url=/run/vc/vm/ab9f633385d4987828d342e47554fc6442445b32039023eeddaa971c1bb56791/console.sock pid=107642 sandbox=ab9f633385d4987828d342e47554fc6442445b32039023eeddaa971c1bb56791 source=virtcontainers subsystem=sandbox vmconsole="[ 0.395399] brd: module loaded"
time="2020-09-15T14:56:23.102633107+08:00" level=debug msg="reading guest console" console-protocol=unix console-url=/run/vc/vm/ab9f633385d4987828d342e47554fc6442445b32039023eeddaa971c1bb56791/console.sock pid=107642 sandbox=ab9f633385d4987828d342e47554fc6442445b32039023eeddaa971c1bb56791 source=virtcontainers subsystem=sandbox vmconsole="[ 0.402845] random: fast init done"
time="2020-09-15T14:56:23.103125469+08:00" level=debug msg="reading guest console" console-protocol=unix console-url=/run/vc/vm/ab9f633385d4987828d342e47554fc6442445b32039023eeddaa971c1bb56791/console.sock pid=107642 sandbox=ab9f633385d4987828d342e47554fc6442445b32039023eeddaa971c1bb56791 source=virtcontainers subsystem=sandbox vmconsole="[ 0.403544] random: crng init done"
time="2020-09-15T14:56:23.105268162+08:00" level=debug msg="reading guest console" console-protocol=unix console-url=/run/vc/vm/ab9f633385d4987828d342e47554fc6442445b32039023eeddaa971c1bb56791/console.sock pid=107642 sandbox=ab9f633385d4987828d342e47554fc6442445b32039023eeddaa971c1bb56791 source=virtcontainers subsystem=sandbox vmconsole="[ 0.405599] loop: module loaded"
time="2020-09-15T14:56:23.121121598+08:00" level=debug msg="reading guest console" console-protocol=unix console-url=/run/vc/vm/ab9f633385d4987828d342e47554fc6442445b32039023eeddaa971c1bb56791/console.sock pid=107642 sandbox=ab9f633385d4987828d342e47554fc6442445b32039023eeddaa971c1bb56791 source=virtcontainers subsystem=sandbox vmconsole="[ 0.421324] memmap_init_zone_device initialised 32768 pages in 12ms"
...
Refer to the kata-log-parser documentation which is useful to fetch these.