github/kata-containers
1
0
Fork 2
mirror of https://github.com/kata-containers/kata-containers.git synced 2025-09-19 15:58:25 +00:00
Code Issues Projects Releases Wiki Activity

Merge pull request #503 from nitkon/patch-2

Browse Source 
Dev Guide: Update with debug console for initrd
This commit is contained in:
Graham Whaley
2019-06-19 16:00:16 +01:00
committed by GitHub
parent 2b5b52d28c 6c2209addd
commit de3627814b
1 changed files with 16 additions and 11 deletions
Download Patch File Download Diff File Expand all files Collapse all files

27
Developer-Guide.md
View File

@@ -636,17 +636,22 @@ boot the virtual machine.
If you want to login to a virtual machine that hosts your containers, complete If you want to login to a virtual machine that hosts your containers, complete
the following steps, which assume the use of a rootfs image. the following steps, which assume the use of a rootfs image.
> **Note:** The debug console instructions below assume a systemd based guest > **Note:** The following debug console instructions assume a systemd-based guest
> O/S image meaning you must create a rootfs for a distro that supports > O/S image. This means you must create a rootfs for a distro that supports systemd.
> systemd. Currently, all distros supported by > Currently, all distros supported by [osbuilder](https://github.com/kata-containers/osbuilder) support systemd
> [osbuilder](https://github.com/kata-containers/osbuilder) support systemd, > except for Alpine Linux.
> except for Alpine Linux. To check if a distro supports systemd look for >
> `INIT_PROCESS=systemd` in the `config.sh` osbuilder rootfs config file for > Look for `INIT_PROCESS=systemd` in the `config.sh` osbuilder rootfs config file
> the distro you wish to build a rootfs for (for example see the [Clear Linux > to verify an osbuilder distro supports systemd for the distro you want to build rootfs for.
> `config.sh` > For an example, see the [Clear Linux config.sh file](https://github.com/kata-containers/osbuilder/blob/master/rootfs-builder/clearlinux/config.sh).
> file](https://github.com/kata-containers/osbuilder/blob/master/rootfs-builder/clearlinux/config.sh)). >
> For non-systemd based distros, you will need to create an equivalent system > For a non-systemd-based distro, create an equivalent system
> service using that distros init system syntax instead. > 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](https://github.com/kata-containers/documentation/blob/master/Developer-Guide.md#connect-to-the-virtual-machine-using-the-debug-console).
### Create a custom image containing a shell ### Create a custom image containing a shell