Skip to content

Commit a56d484

Browse files
committed
update hyperd configuration reference
Signed-off-by: Wang Xu <[email protected]>
1 parent b38ed1b commit a56d484

File tree

2 files changed

+62
-19
lines changed

2 files changed

+62
-19
lines changed

Diff for: SUMMARY.md

+5-5
Original file line numberDiff line numberDiff line change
@@ -13,10 +13,7 @@
1313
* [Pod](get_started/pod.md)
1414
* [Lifecycle](get_started/lifecycle.md)
1515
* [Reference](reference/README.md)
16-
* [Podfile](reference/podfile.md)
17-
* [Containers](reference/containers.md)
18-
* [Volumes](reference/volumes.md)
19-
* [Files](reference/files.md)
16+
* [Hyperd Config](reference/configuration.md)
2017
* [CLI](reference/cli.md)
2118
* [run](reference/run.md)
2219
* [start](reference/start.md)
@@ -37,7 +34,10 @@
3734
* [login](reference/login.md)
3835
* [logout](reference/logout.md)
3936
* [API](reference/api.md)
40-
* [Config](reference/configuration.md)
37+
* [Podfile](reference/podfile.md)
38+
* [Containers](reference/containers.md)
39+
* [Volumes](reference/volumes.md)
40+
* [Files](reference/files.md)
4141
* [License](license.md)
4242
* [Trouble Shooting](trouble_shooting/README.md)
4343
* [Platform Independent FAQ](trouble_shooting/general.md)

Diff for: reference/configuration.md

+57-14
Original file line numberDiff line numberDiff line change
@@ -1,24 +1,67 @@
1-
# Configuration
1+
# Hyperd Configuration
22

33
## Configuration file
44

5-
The configuration file of Hyper is located under `/etc/hyper/config`. The file is in INI format:
5+
The configuration file of Hyper is located under `/etc/hyper/config` by default. The file is in INI format:
66

7-
Host = tcp://localhost:1246
8-
Kernel = /var/lib/hyper/kernerl
9-
Initrd = /var/lib/hyper/hyper-initrd.img
10-
Bridge = hyper0
11-
BridgeIP = 192.168.123.1/24
7+
```
8+
# Root directory for hyperd
9+
# Root=/var/lib/hyper/
1210
13-
#### Parameters
11+
# Specify the hypervisor: libvirt, qemu, qemu-kvm, kvm, xen, vbox (for linux)
12+
# vbox (for mac).
13+
# "kvm" is equivalent to "qemu-kvm" which uses qemu with kvm acceleration.
14+
# "qemu" is equivalent to "qemu-kvm" when the system enables kvm, otherwise
15+
# the hypervisor is "qemu-tcg" (qemu without kvm acceleration).
16+
# When Hypervisor is not set, the hyperd will try to probe "qemu-kvm" or "xen"
17+
# as the containers' hypervisor according to the host, if the host doesn't
18+
# support any hardware-assisted technology, it will use "qemu-tcg".
19+
#
20+
# Hypervisor=qemu
1421
15-
- `Host`: bind hyperd's socket to the IP and Port, by default hyperd listens on `unix:///var/run/hyper.sock`
16-
- `Kernel`: the path of the HyperKernel, by default `/var/lib/hyper/kernel`
17-
- `Initrd`: the path of the initrd file, by default `/var/lib/hyper/hyper-initrd.img`
18-
- `Bridge`: bridge name, default `hyper0`
19-
- `BridgeIP`: IP range of the bridge, default `192.168.123.0/24`
22+
# Boot kernel
23+
Kernel=/var/lib/hyper/kernel
2024
21-
## CLI usage
25+
# Boot initrd
26+
Initrd=/var/lib/hyper/hyper-initrd.img
27+
28+
# Storage driver for hyperd, valid value includes devicemapper, overlay, and aufs
29+
# StorageDriver=overlay
30+
31+
# Bridge device for hyperd, default is hyper0
32+
# Bridge=
33+
34+
# Bridge ip address for the bridge device
35+
# BridgeIP=
36+
37+
# If the host IP is provided, a TCP port will be listened for, same as the '--host' option
38+
# Host=
39+
40+
# This is only useful for hypernetes, to disable the iptables setup by hyperd
41+
# DisableIptables=false
42+
43+
# Enable vsock support. This only works with libvirt/qemu hypervisor and template disabled
44+
# EnableVsock=false
45+
46+
# VmFactoryPolicy defines the policies to create factories
47+
# VmFactoryPolicy = [FactoryConfig,]*FactoryConfig
48+
# FactoryConfig = {["cache":NUMBER,]["template":(true|false),]"cpu":NUMBER,"memory":NUMBER}
49+
# Examples:
50+
# VmFactoryPolicy={"cache":10, "cpu":1, "memory":128}
51+
# VmFactoryPolicy={"cpu":3, "memory":1024}
52+
# VmFactoryPolicy={"template":true, "cpu":1, "memory":128}
53+
# VmFactoryPolicy={"cache":1, "template":true, "cpu":1, "memory":128}
54+
# VmFactoryPolicy={"cache":10, "template":true, "cpu":1, "memory":128},{"template":true, "cpu":3, "memory":1024}
55+
# It is recommended to specify the "cache" when VmFactoryPolicy is set,
56+
# otherwise it is a less efficient factory
57+
VmFactoryPolicy=
58+
59+
[Log]
60+
# PodLogPrefix=/var/run/hyper/Pods
61+
# PodIdInPath=true
62+
```
63+
64+
## Hyperd command line
2265

2366
Usage:
2467
./hyperd [OPTIONS]

0 commit comments

Comments
 (0)