info_tfgrid/collections/developers/internals/zos/manual/zmachine/readme.md

14 lines
1010 B
Markdown
Raw Normal View History

2024-08-06 15:33:59 +00:00
# `zero_vm` type
2024-04-29 17:49:02 +00:00
2024-08-06 15:33:59 +00:00
`zero_vm` is a unified container/virtual machine type. This can be used to start a virtual machine on a `zos` node give the following:
2024-04-29 17:49:02 +00:00
- `flist`, this what provide the base `vm` image or container image.
2024-08-06 15:33:59 +00:00
- the `flist` content is what changes the `zero_vm` mode. An `flist` built from a docker image or has files, or executable binaries will run in a container mode. `ZOS` will inject it's own `kernel+initramfs` to run the workload and kick start the defined `flist` `entrypoint`
2024-04-29 17:49:02 +00:00
- private network to join (with assigned IP)
- optional public `ipv4` or `ipv6`
2024-08-06 15:33:59 +00:00
- optional disks. But at least one disk is required in case running `zero_vm` in `vm` mode, which is used to hold the `vm` root image.
2024-04-29 17:49:02 +00:00
2024-08-06 15:33:59 +00:00
For more details on all parameters needed to run a `zero_vm` please refer to [`zero_vm` data](https://github.com/threefoldtech/zos/blob/main/pkg/gridtypes/zos/zero_vm.go)
2024-04-29 17:49:02 +00:00
# Building your `flist`.
2024-08-06 15:33:59 +00:00
Please refer to [this document](manual.md) here about how to build an compatible `zero_vm flist`