]>
Commit | Line | Data |
---|---|---|
80c0adcb | 1 | [[chapter_pct]] |
0c6b782f | 2 | ifdef::manvolnum[] |
b2f242ab | 3 | pct(1) |
7e2fdb3d | 4 | ====== |
38fd0958 | 5 | include::attributes.txt[] |
5f09af76 DM |
6 | :pve-toplevel: |
7 | ||
0c6b782f DM |
8 | NAME |
9 | ---- | |
10 | ||
11 | pct - Tool to manage Linux Containers (LXC) on Proxmox VE | |
12 | ||
13 | ||
49a5e11c | 14 | SYNOPSIS |
0c6b782f DM |
15 | -------- |
16 | ||
17 | include::pct.1-synopsis.adoc[] | |
18 | ||
19 | DESCRIPTION | |
20 | ----------- | |
21 | endif::manvolnum[] | |
22 | ||
23 | ifndef::manvolnum[] | |
24 | Proxmox Container Toolkit | |
25 | ========================= | |
38fd0958 | 26 | include::attributes.txt[] |
194d2f29 | 27 | :pve-toplevel: |
0c6b782f | 28 | endif::manvolnum[] |
5f09af76 | 29 | ifdef::wiki[] |
cb84ed18 | 30 | :title: Linux Container |
5f09af76 | 31 | endif::wiki[] |
4a2ae9ed DM |
32 | |
33 | Containers are a lightweight alternative to fully virtualized | |
34 | VMs. Instead of emulating a complete Operating System (OS), containers | |
35 | simply use the OS of the host they run on. This implies that all | |
36 | containers use the same kernel, and that they can access resources | |
37 | from the host directly. | |
38 | ||
39 | This is great because containers do not waste CPU power nor memory due | |
40 | to kernel emulation. Container run-time costs are close to zero and | |
41 | usually negligible. But there are also some drawbacks you need to | |
42 | consider: | |
43 | ||
44 | * You can only run Linux based OS inside containers, i.e. it is not | |
a8e99754 | 45 | possible to run FreeBSD or MS Windows inside. |
4a2ae9ed | 46 | |
a8e99754 | 47 | * For security reasons, access to host resources needs to be |
4a2ae9ed | 48 | restricted. This is done with AppArmor, SecComp filters and other |
a8e99754 | 49 | kernel features. Be prepared that some syscalls are not allowed |
4a2ae9ed DM |
50 | inside containers. |
51 | ||
52 | {pve} uses https://linuxcontainers.org/[LXC] as underlying container | |
53 | technology. We consider LXC as low-level library, which provides | |
a8e99754 | 54 | countless options. It would be too difficult to use those tools |
4a2ae9ed DM |
55 | directly. Instead, we provide a small wrapper called `pct`, the |
56 | "Proxmox Container Toolkit". | |
57 | ||
a8e99754 | 58 | The toolkit is tightly coupled with {pve}. That means that it is aware |
4a2ae9ed DM |
59 | of the cluster setup, and it can use the same network and storage |
60 | resources as fully virtualized VMs. You can even use the {pve} | |
61 | firewall, or manage containers using the HA framework. | |
62 | ||
63 | Our primary goal is to offer an environment as one would get from a | |
64 | VM, but without the additional overhead. We call this "System | |
65 | Containers". | |
66 | ||
99d2e25b | 67 | NOTE: If you want to run micro-containers (with docker, rkt, ...), it |
70a42028 | 68 | is best to run them inside a VM. |
4a2ae9ed DM |
69 | |
70 | ||
71 | Security Considerations | |
72 | ----------------------- | |
73 | ||
74 | Containers use the same kernel as the host, so there is a big attack | |
75 | surface for malicious users. You should consider this fact if you | |
76 | provide containers to totally untrusted people. In general, fully | |
a8e99754 | 77 | virtualized VMs provide better isolation. |
4a2ae9ed DM |
78 | |
79 | The good news is that LXC uses many kernel security features like | |
80 | AppArmor, CGroups and PID and user namespaces, which makes containers | |
81 | usage quite secure. We distinguish two types of containers: | |
82 | ||
5eba0743 FG |
83 | |
84 | Privileged Containers | |
4a2ae9ed DM |
85 | ~~~~~~~~~~~~~~~~~~~~~ |
86 | ||
87 | Security is done by dropping capabilities, using mandatory access | |
88 | control (AppArmor), SecComp filters and namespaces. The LXC team | |
89 | considers this kind of container as unsafe, and they will not consider | |
90 | new container escape exploits to be security issues worthy of a CVE | |
91 | and quick fix. So you should use this kind of containers only inside a | |
92 | trusted environment, or when no untrusted task is running as root in | |
93 | the container. | |
94 | ||
5eba0743 FG |
95 | |
96 | Unprivileged Containers | |
4a2ae9ed DM |
97 | ~~~~~~~~~~~~~~~~~~~~~~~ |
98 | ||
a8e99754 | 99 | This kind of containers use a new kernel feature called user |
5eba0743 | 100 | namespaces. The root UID 0 inside the container is mapped to an |
4a2ae9ed DM |
101 | unprivileged user outside the container. This means that most security |
102 | issues (container escape, resource abuse, ...) in those containers | |
103 | will affect a random unprivileged user, and so would be a generic | |
a8e99754 | 104 | kernel security bug rather than an LXC issue. The LXC team thinks |
4a2ae9ed DM |
105 | unprivileged containers are safe by design. |
106 | ||
3bd9d0cf | 107 | |
80c0adcb | 108 | [[pct_configuration]] |
7fc230db DM |
109 | Configuration |
110 | ------------- | |
111 | ||
8c1189b6 FG |
112 | The `/etc/pve/lxc/<CTID>.conf` file stores container configuration, |
113 | where `<CTID>` is the numeric ID of the given container. Like all | |
114 | other files stored inside `/etc/pve/`, they get automatically | |
166e63d6 FG |
115 | replicated to all other cluster nodes. |
116 | ||
117 | NOTE: CTIDs < 100 are reserved for internal purposes, and CTIDs need to be | |
118 | unique cluster wide. | |
7fc230db | 119 | |
105bc8f1 DM |
120 | .Example Container Configuration |
121 | ---- | |
122 | ostype: debian | |
123 | arch: amd64 | |
124 | hostname: www | |
125 | memory: 512 | |
126 | swap: 512 | |
127 | net0: bridge=vmbr0,hwaddr=66:64:66:64:64:36,ip=dhcp,name=eth0,type=veth | |
128 | rootfs: local:107/vm-107-disk-1.raw,size=7G | |
129 | ---- | |
130 | ||
7fc230db | 131 | Those configuration files are simple text files, and you can edit them |
8c1189b6 | 132 | using a normal text editor (`vi`, `nano`, ...). This is sometimes |
55fb2a21 DM |
133 | useful to do small corrections, but keep in mind that you need to |
134 | restart the container to apply such changes. | |
135 | ||
8c1189b6 | 136 | For that reason, it is usually better to use the `pct` command to |
55fb2a21 DM |
137 | generate and modify those files, or do the whole thing using the GUI. |
138 | Our toolkit is smart enough to instantaneously apply most changes to | |
105bc8f1 DM |
139 | running containers. This feature is called "hot plug", and there is no |
140 | need to restart the container in that case. | |
7fc230db | 141 | |
5eba0743 | 142 | |
7fc230db DM |
143 | File Format |
144 | ~~~~~~~~~~~ | |
145 | ||
146 | Container configuration files use a simple colon separated key/value | |
147 | format. Each line has the following format: | |
148 | ||
083adc34 FG |
149 | ----- |
150 | # this is a comment | |
151 | OPTION: value | |
152 | ----- | |
7fc230db | 153 | |
8c1189b6 | 154 | Blank lines in those files are ignored, and lines starting with a `#` |
7fc230db DM |
155 | character are treated as comments and are also ignored. |
156 | ||
157 | It is possible to add low-level, LXC style configuration directly, for | |
158 | example: | |
159 | ||
160 | lxc.init_cmd: /sbin/my_own_init | |
161 | ||
162 | or | |
163 | ||
164 | lxc.init_cmd = /sbin/my_own_init | |
165 | ||
166 | Those settings are directly passed to the LXC low-level tools. | |
167 | ||
5eba0743 | 168 | |
80c0adcb | 169 | [[pct_snapshots]] |
105bc8f1 DM |
170 | Snapshots |
171 | ~~~~~~~~~ | |
172 | ||
8c1189b6 | 173 | When you create a snapshot, `pct` stores the configuration at snapshot |
105bc8f1 | 174 | time into a separate snapshot section within the same configuration |
8c1189b6 | 175 | file. For example, after creating a snapshot called ``testsnapshot'', |
105bc8f1 DM |
176 | your configuration file will look like this: |
177 | ||
5eba0743 | 178 | .Container configuration with snapshot |
105bc8f1 DM |
179 | ---- |
180 | memory: 512 | |
181 | swap: 512 | |
182 | parent: testsnaphot | |
183 | ... | |
184 | ||
185 | [testsnaphot] | |
186 | memory: 512 | |
187 | swap: 512 | |
188 | snaptime: 1457170803 | |
189 | ... | |
190 | ---- | |
191 | ||
8c1189b6 FG |
192 | There are a few snapshot related properties like `parent` and |
193 | `snaptime`. The `parent` property is used to store the parent/child | |
194 | relationship between snapshots. `snaptime` is the snapshot creation | |
195 | time stamp (Unix epoch). | |
196 | ||
7fc230db | 197 | |
3f13c1c3 DM |
198 | Guest Operating System Configuration |
199 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | |
200 | ||
201 | We normally try to detect the operating system type inside the | |
202 | container, and then modify some files inside the container to make | |
203 | them work as expected. Here is a short list of things we do at | |
204 | container startup: | |
205 | ||
206 | set /etc/hostname:: to set the container name | |
207 | ||
a8e99754 | 208 | modify /etc/hosts:: to allow lookup of the local hostname |
3f13c1c3 DM |
209 | |
210 | network setup:: pass the complete network setup to the container | |
211 | ||
212 | configure DNS:: pass information about DNS servers | |
213 | ||
a8e99754 | 214 | adapt the init system:: for example, fix the number of spawned getty processes |
3f13c1c3 DM |
215 | |
216 | set the root password:: when creating a new container | |
217 | ||
218 | rewrite ssh_host_keys:: so that each container has unique keys | |
219 | ||
a8e99754 | 220 | randomize crontab:: so that cron does not start at the same time on all containers |
3f13c1c3 | 221 | |
25535d34 WB |
222 | Changes made by {PVE} are enclosed by comment markers: |
223 | ||
37638f59 DM |
224 | ---- |
225 | # --- BEGIN PVE --- | |
226 | <data> | |
227 | # --- END PVE --- | |
228 | ---- | |
25535d34 | 229 | |
37638f59 DM |
230 | Those markers will be inserted at a reasonable location in the |
231 | file. If such a section already exists, it will be updated in place | |
232 | and will not be moved. | |
25535d34 | 233 | |
37638f59 DM |
234 | Modification of a file can be prevented by adding a `.pve-ignore.` |
235 | file for it. For instance, if the file `/etc/.pve-ignore.hosts` | |
236 | exists then the `/etc/hosts` file will not be touched. This can be a | |
237 | simple empty file creatd via: | |
25535d34 WB |
238 | |
239 | # touch /etc/.pve-ignore.hosts | |
240 | ||
37638f59 DM |
241 | Most modifications are OS dependent, so they differ between different |
242 | distributions and versions. You can completely disable modifications | |
8c1189b6 | 243 | by manually setting the `ostype` to `unmanaged`. |
3f13c1c3 DM |
244 | |
245 | OS type detection is done by testing for certain files inside the | |
246 | container: | |
247 | ||
8c1189b6 | 248 | Ubuntu:: inspect /etc/lsb-release (`DISTRIB_ID=Ubuntu`) |
3f13c1c3 DM |
249 | |
250 | Debian:: test /etc/debian_version | |
251 | ||
252 | Fedora:: test /etc/fedora-release | |
253 | ||
254 | RedHat or CentOS:: test /etc/redhat-release | |
255 | ||
256 | ArchLinux:: test /etc/arch-release | |
257 | ||
258 | Alpine:: test /etc/alpine-release | |
259 | ||
c617d721 WB |
260 | Gentoo:: test /etc/gentoo-release |
261 | ||
8c1189b6 | 262 | NOTE: Container start fails if the configured `ostype` differs from the auto |
3f13c1c3 DM |
263 | detected type. |
264 | ||
5eba0743 | 265 | |
80c0adcb | 266 | [[pct_options]] |
a7f36905 DM |
267 | Options |
268 | ~~~~~~~ | |
269 | ||
270 | include::pct.conf.5-opts.adoc[] | |
271 | ||
d61bab51 | 272 | |
80c0adcb | 273 | [[pct_container_images]] |
d61bab51 DM |
274 | Container Images |
275 | ---------------- | |
276 | ||
8c1189b6 FG |
277 | Container images, sometimes also referred to as ``templates'' or |
278 | ``appliances'', are `tar` archives which contain everything to run a | |
d61bab51 | 279 | container. You can think of it as a tidy container backup. Like most |
8c1189b6 | 280 | modern container toolkits, `pct` uses those images when you create a |
d61bab51 DM |
281 | new container, for example: |
282 | ||
283 | pct create 999 local:vztmpl/debian-8.0-standard_8.0-1_amd64.tar.gz | |
284 | ||
26ca7ff5 | 285 | {pve} itself ships a set of basic templates for most common |
8c1189b6 | 286 | operating systems, and you can download them using the `pveam` (short |
d61bab51 DM |
287 | for {pve} Appliance Manager) command line utility. You can also |
288 | download https://www.turnkeylinux.org/[TurnKey Linux] containers using | |
289 | that tool (or the graphical user interface). | |
290 | ||
3a6fa247 DM |
291 | Our image repositories contain a list of available images, and there |
292 | is a cron job run each day to download that list. You can trigger that | |
293 | update manually with: | |
294 | ||
295 | pveam update | |
296 | ||
297 | After that you can view the list of available images using: | |
298 | ||
299 | pveam available | |
300 | ||
8c1189b6 FG |
301 | You can restrict this large list by specifying the `section` you are |
302 | interested in, for example basic `system` images: | |
3a6fa247 DM |
303 | |
304 | .List available system images | |
305 | ---- | |
306 | # pveam available --section system | |
307 | system archlinux-base_2015-24-29-1_x86_64.tar.gz | |
308 | system centos-7-default_20160205_amd64.tar.xz | |
309 | system debian-6.0-standard_6.0-7_amd64.tar.gz | |
310 | system debian-7.0-standard_7.0-3_amd64.tar.gz | |
311 | system debian-8.0-standard_8.0-1_amd64.tar.gz | |
312 | system ubuntu-12.04-standard_12.04-1_amd64.tar.gz | |
313 | system ubuntu-14.04-standard_14.04-1_amd64.tar.gz | |
314 | system ubuntu-15.04-standard_15.04-1_amd64.tar.gz | |
315 | system ubuntu-15.10-standard_15.10-1_amd64.tar.gz | |
316 | ---- | |
317 | ||
a8e99754 | 318 | Before you can use such a template, you need to download them into one |
8c1189b6 | 319 | of your storages. You can simply use storage `local` for that |
3a6fa247 DM |
320 | purpose. For clustered installations, it is preferred to use a shared |
321 | storage so that all nodes can access those images. | |
322 | ||
323 | pveam download local debian-8.0-standard_8.0-1_amd64.tar.gz | |
324 | ||
24f73a63 | 325 | You are now ready to create containers using that image, and you can |
8c1189b6 | 326 | list all downloaded images on storage `local` with: |
24f73a63 DM |
327 | |
328 | ---- | |
329 | # pveam list local | |
330 | local:vztmpl/debian-8.0-standard_8.0-1_amd64.tar.gz 190.20MB | |
331 | ---- | |
332 | ||
a8e99754 | 333 | The above command shows you the full {pve} volume identifiers. They include |
24f73a63 | 334 | the storage name, and most other {pve} commands can use them. For |
5eba0743 | 335 | example you can delete that image later with: |
24f73a63 DM |
336 | |
337 | pveam remove local:vztmpl/debian-8.0-standard_8.0-1_amd64.tar.gz | |
3a6fa247 | 338 | |
d61bab51 | 339 | |
80c0adcb | 340 | [[pct_container_storage]] |
70a42028 DM |
341 | Container Storage |
342 | ----------------- | |
343 | ||
344 | Traditional containers use a very simple storage model, only allowing | |
345 | a single mount point, the root file system. This was further | |
8c1189b6 FG |
346 | restricted to specific file system types like `ext4` and `nfs`. |
347 | Additional mounts are often done by user provided scripts. This turned | |
a8e99754 | 348 | out to be complex and error prone, so we try to avoid that now. |
70a42028 DM |
349 | |
350 | Our new LXC based container model is more flexible regarding | |
351 | storage. First, you can have more than a single mount point. This | |
352 | allows you to choose a suitable storage for each application. For | |
353 | example, you can use a relatively slow (and thus cheap) storage for | |
354 | the container root file system. Then you can use a second mount point | |
355 | to mount a very fast, distributed storage for your database | |
356 | application. | |
357 | ||
358 | The second big improvement is that you can use any storage type | |
359 | supported by the {pve} storage library. That means that you can store | |
8c1189b6 FG |
360 | your containers on local `lvmthin` or `zfs`, shared `iSCSI` storage, |
361 | or even on distributed storage systems like `ceph`. It also enables us | |
362 | to use advanced storage features like snapshots and clones. `vzdump` | |
a8e99754 | 363 | can also use the snapshot feature to provide consistent container |
70a42028 DM |
364 | backups. |
365 | ||
366 | Last but not least, you can also mount local devices directly, or | |
367 | mount local directories using bind mounts. That way you can access | |
368 | local storage inside containers with zero overhead. Such bind mounts | |
a8e99754 | 369 | also provide an easy way to share data between different containers. |
70a42028 | 370 | |
eeecce95 | 371 | |
9e44e493 DM |
372 | Mount Points |
373 | ~~~~~~~~~~~~ | |
eeecce95 | 374 | |
01639994 FG |
375 | The root mount point is configured with the `rootfs` property, and you can |
376 | configure up to 10 additional mount points. The corresponding options | |
377 | are called `mp0` to `mp9`, and they can contain the following setting: | |
378 | ||
379 | include::pct-mountpoint-opts.adoc[] | |
380 | ||
9e44e493 DM |
381 | Currently there are basically three types of mount points: storage backed |
382 | mount points, bind mounts and device mounts. | |
383 | ||
5eba0743 | 384 | .Typical container `rootfs` configuration |
4c3b5c77 DM |
385 | ---- |
386 | rootfs: thin1:base-100-disk-1,size=8G | |
387 | ---- | |
388 | ||
389 | ||
5eba0743 | 390 | Storage Backed Mount Points |
4c3b5c77 | 391 | ^^^^^^^^^^^^^^^^^^^^^^^^^^^ |
01639994 | 392 | |
9e44e493 | 393 | Storage backed mount points are managed by the {pve} storage subsystem and come |
eeecce95 WB |
394 | in three different flavors: |
395 | ||
5eba0743 | 396 | - Image based: these are raw images containing a single ext4 formatted file |
eeecce95 | 397 | system. |
5eba0743 | 398 | - ZFS subvolumes: these are technically bind mounts, but with managed storage, |
eeecce95 WB |
399 | and thus allow resizing and snapshotting. |
400 | - Directories: passing `size=0` triggers a special case where instead of a raw | |
401 | image a directory is created. | |
402 | ||
4c3b5c77 | 403 | |
5eba0743 | 404 | Bind Mount Points |
4c3b5c77 | 405 | ^^^^^^^^^^^^^^^^^ |
01639994 | 406 | |
9baca183 FG |
407 | Bind mounts allow you to access arbitrary directories from your Proxmox VE host |
408 | inside a container. Some potential use cases are: | |
409 | ||
410 | - Accessing your home directory in the guest | |
411 | - Accessing an USB device directory in the guest | |
acccc49b | 412 | - Accessing an NFS mount from the host in the guest |
9baca183 | 413 | |
eeecce95 | 414 | Bind mounts are considered to not be managed by the storage subsystem, so you |
9baca183 | 415 | cannot make snapshots or deal with quotas from inside the container. With |
eeecce95 | 416 | unprivileged containers you might run into permission problems caused by the |
9baca183 FG |
417 | user mapping and cannot use ACLs. |
418 | ||
8c1189b6 | 419 | NOTE: The contents of bind mount points are not backed up when using `vzdump`. |
eeecce95 | 420 | |
6b707f2c FG |
421 | WARNING: For security reasons, bind mounts should only be established |
422 | using source directories especially reserved for this purpose, e.g., a | |
423 | directory hierarchy under `/mnt/bindmounts`. Never bind mount system | |
424 | directories like `/`, `/var` or `/etc` into a container - this poses a | |
9baca183 FG |
425 | great security risk. |
426 | ||
427 | NOTE: The bind mount source path must not contain any symlinks. | |
428 | ||
429 | For example, to make the directory `/mnt/bindmounts/shared` accessible in the | |
430 | container with ID `100` under the path `/shared`, use a configuration line like | |
8c1189b6 FG |
431 | `mp0: /mnt/bindmounts/shared,mp=/shared` in `/etc/pve/lxc/100.conf`. |
432 | Alternatively, use `pct set 100 -mp0 /mnt/bindmounts/shared,mp=/shared` to | |
9baca183 | 433 | achieve the same result. |
6b707f2c | 434 | |
4c3b5c77 | 435 | |
5eba0743 | 436 | Device Mount Points |
4c3b5c77 | 437 | ^^^^^^^^^^^^^^^^^^^ |
fe154a4f | 438 | |
7432d78e FG |
439 | Device mount points allow to mount block devices of the host directly into the |
440 | container. Similar to bind mounts, device mounts are not managed by {PVE}'s | |
441 | storage subsystem, but the `quota` and `acl` options will be honored. | |
442 | ||
443 | NOTE: Device mount points should only be used under special circumstances. In | |
444 | most cases a storage backed mount point offers the same performance and a lot | |
445 | more features. | |
446 | ||
8c1189b6 | 447 | NOTE: The contents of device mount points are not backed up when using `vzdump`. |
01639994 | 448 | |
4c3b5c77 | 449 | |
5eba0743 | 450 | FUSE Mounts |
4c3b5c77 | 451 | ~~~~~~~~~~~ |
01639994 FG |
452 | |
453 | WARNING: Because of existing issues in the Linux kernel's freezer | |
454 | subsystem the usage of FUSE mounts inside a container is strongly | |
455 | advised against, as containers need to be frozen for suspend or | |
456 | snapshot mode backups. | |
fe154a4f | 457 | |
01639994 FG |
458 | If FUSE mounts cannot be replaced by other mounting mechanisms or storage |
459 | technologies, it is possible to establish the FUSE mount on the Proxmox host | |
460 | and use a bind mount point to make it accessible inside the container. | |
461 | ||
01639994 | 462 | |
5eba0743 | 463 | Using Quotas Inside Containers |
04c569f6 | 464 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
d6ed3622 | 465 | |
9e44e493 DM |
466 | Quotas allow to set limits inside a container for the amount of disk |
467 | space that each user can use. This only works on ext4 image based | |
468 | storage types and currently does not work with unprivileged | |
469 | containers. | |
d6ed3622 | 470 | |
9e44e493 DM |
471 | Activating the `quota` option causes the following mount options to be |
472 | used for a mount point: | |
473 | `usrjquota=aquota.user,grpjquota=aquota.group,jqfmt=vfsv0` | |
d6ed3622 | 474 | |
9e44e493 DM |
475 | This allows quotas to be used like you would on any other system. You |
476 | can initialize the `/aquota.user` and `/aquota.group` files by running | |
d6ed3622 | 477 | |
9e44e493 DM |
478 | ---- |
479 | quotacheck -cmug / | |
480 | quotaon / | |
481 | ---- | |
d6ed3622 | 482 | |
166e63d6 FG |
483 | and edit the quotas via the `edquota` command. Refer to the documentation |
484 | of the distribution running inside the container for details. | |
485 | ||
9e44e493 DM |
486 | NOTE: You need to run the above commands for every mount point by passing |
487 | the mount point's path instead of just `/`. | |
488 | ||
d6ed3622 | 489 | |
5eba0743 | 490 | Using ACLs Inside Containers |
04c569f6 | 491 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
6c60aebf | 492 | |
5eba0743 | 493 | The standard Posix **A**ccess **C**ontrol **L**ists are also available inside containers. |
6c60aebf EK |
494 | ACLs allow you to set more detailed file ownership than the traditional user/ |
495 | group/others model. | |
d6ed3622 | 496 | |
04c569f6 | 497 | |
80c0adcb | 498 | [[pct_container_network]] |
04c569f6 DM |
499 | Container Network |
500 | ----------------- | |
501 | ||
bac8c385 | 502 | You can configure up to 10 network interfaces for a single |
8c1189b6 | 503 | container. The corresponding options are called `net0` to `net9`, and |
bac8c385 DM |
504 | they can contain the following setting: |
505 | ||
506 | include::pct-network-opts.adoc[] | |
04c569f6 DM |
507 | |
508 | ||
51e33128 FG |
509 | Backup and Restore |
510 | ------------------ | |
511 | ||
5eba0743 | 512 | |
2175e37b FG |
513 | Container Backup |
514 | ~~~~~~~~~~~~~~~~ | |
515 | ||
8c1189b6 FG |
516 | It is possible to use the `vzdump` tool for container backup. Please |
517 | refer to the `vzdump` manual page for details. | |
518 | ||
51e33128 | 519 | |
2175e37b FG |
520 | Restoring Container Backups |
521 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~ | |
522 | ||
8c1189b6 FG |
523 | Restoring container backups made with `vzdump` is possible using the |
524 | `pct restore` command. By default, `pct restore` will attempt to restore as much | |
2175e37b FG |
525 | of the backed up container configuration as possible. It is possible to override |
526 | the backed up configuration by manually setting container options on the command | |
8c1189b6 | 527 | line (see the `pct` manual page for details). |
2175e37b | 528 | |
8c1189b6 | 529 | NOTE: `pvesm extractconfig` can be used to view the backed up configuration |
2175e37b FG |
530 | contained in a vzdump archive. |
531 | ||
532 | There are two basic restore modes, only differing by their handling of mount | |
533 | points: | |
534 | ||
4c3b5c77 | 535 | |
8c1189b6 FG |
536 | ``Simple'' Restore Mode |
537 | ^^^^^^^^^^^^^^^^^^^^^^^ | |
2175e37b FG |
538 | |
539 | If neither the `rootfs` parameter nor any of the optional `mpX` parameters | |
540 | are explicitly set, the mount point configuration from the backed up | |
541 | configuration file is restored using the following steps: | |
542 | ||
543 | . Extract mount points and their options from backup | |
544 | . Create volumes for storage backed mount points (on storage provided with the | |
545 | `storage` parameter, or default local storage if unset) | |
546 | . Extract files from backup archive | |
547 | . Add bind and device mount points to restored configuration (limited to root user) | |
548 | ||
549 | NOTE: Since bind and device mount points are never backed up, no files are | |
550 | restored in the last step, but only the configuration options. The assumption | |
551 | is that such mount points are either backed up with another mechanism (e.g., | |
552 | NFS space that is bind mounted into many containers), or not intended to be | |
553 | backed up at all. | |
554 | ||
555 | This simple mode is also used by the container restore operations in the web | |
556 | interface. | |
557 | ||
4c3b5c77 | 558 | |
8c1189b6 FG |
559 | ``Advanced'' Restore Mode |
560 | ^^^^^^^^^^^^^^^^^^^^^^^^^ | |
2175e37b FG |
561 | |
562 | By setting the `rootfs` parameter (and optionally, any combination of `mpX` | |
8c1189b6 | 563 | parameters), the `pct restore` command is automatically switched into an |
2175e37b FG |
564 | advanced mode. This advanced mode completely ignores the `rootfs` and `mpX` |
565 | configuration options contained in the backup archive, and instead only | |
566 | uses the options explicitly provided as parameters. | |
567 | ||
568 | This mode allows flexible configuration of mount point settings at restore time, | |
569 | for example: | |
570 | ||
571 | * Set target storages, volume sizes and other options for each mount point | |
572 | individually | |
573 | * Redistribute backed up files according to new mount point scheme | |
574 | * Restore to device and/or bind mount points (limited to root user) | |
575 | ||
51e33128 | 576 | |
8c1189b6 | 577 | Managing Containers with `pct` |
04c569f6 DM |
578 | ------------------------------ |
579 | ||
8c1189b6 | 580 | `pct` is the tool to manage Linux Containers on {pve}. You can create |
04c569f6 DM |
581 | and destroy containers, and control execution (start, stop, migrate, |
582 | ...). You can use pct to set parameters in the associated config file, | |
583 | like network configuration or memory limits. | |
584 | ||
5eba0743 | 585 | |
04c569f6 DM |
586 | CLI Usage Examples |
587 | ~~~~~~~~~~~~~~~~~~ | |
588 | ||
589 | Create a container based on a Debian template (provided you have | |
5eba0743 | 590 | already downloaded the template via the web interface) |
04c569f6 DM |
591 | |
592 | pct create 100 /var/lib/vz/template/cache/debian-8.0-standard_8.0-1_amd64.tar.gz | |
593 | ||
594 | Start container 100 | |
595 | ||
596 | pct start 100 | |
597 | ||
598 | Start a login session via getty | |
599 | ||
600 | pct console 100 | |
601 | ||
602 | Enter the LXC namespace and run a shell as root user | |
603 | ||
604 | pct enter 100 | |
605 | ||
606 | Display the configuration | |
607 | ||
608 | pct config 100 | |
609 | ||
8c1189b6 | 610 | Add a network interface called `eth0`, bridged to the host bridge `vmbr0`, |
04c569f6 DM |
611 | set the address and gateway, while it's running |
612 | ||
613 | pct set 100 -net0 name=eth0,bridge=vmbr0,ip=192.168.15.147/24,gw=192.168.15.1 | |
614 | ||
615 | Reduce the memory of the container to 512MB | |
616 | ||
0585f29a DM |
617 | pct set 100 -memory 512 |
618 | ||
04c569f6 | 619 | |
fe57a420 FG |
620 | Obtaining Debugging Logs |
621 | ~~~~~~~~~~~~~~~~~~~~~~~~ | |
622 | ||
623 | In case `pct start` is unable to start a specific container, it might be | |
624 | helpful to collect debugging output by running `lxc-start` (replace `ID` with | |
625 | the container's ID): | |
626 | ||
627 | lxc-start -n ID -F -l DEBUG -o /tmp/lxc-ID.log | |
628 | ||
629 | This command will attempt to start the container in foreground mode, to stop the container run `pct shutdown ID` or `pct stop ID` in a second terminal. | |
630 | ||
631 | The collected debug log is written to `/tmp/lxc-ID.log`. | |
632 | ||
633 | NOTE: If you have changed the container's configuration since the last start | |
634 | attempt with `pct start`, you need to run `pct start` at least once to also | |
635 | update the configuration used by `lxc-start`. | |
636 | ||
637 | ||
0c6b782f DM |
638 | Container Advantages |
639 | -------------------- | |
640 | ||
8c1189b6 | 641 | * Simple, and fully integrated into {pve}. Setup looks similar to a normal |
0c6b782f DM |
642 | VM setup. |
643 | ||
8c1189b6 | 644 | ** Storage (ZFS, LVM, NFS, Ceph, ...) |
0c6b782f | 645 | |
8c1189b6 | 646 | ** Network |
0c6b782f | 647 | |
8c1189b6 | 648 | ** Authentication |
0c6b782f | 649 | |
8c1189b6 | 650 | ** Cluster |
0c6b782f | 651 | |
8c1189b6 | 652 | * Fast: minimal overhead, as fast as bare metal |
0c6b782f | 653 | |
8c1189b6 | 654 | * High density (perfect for idle workloads) |
0c6b782f | 655 | |
8c1189b6 | 656 | * REST API |
0c6b782f | 657 | |
8c1189b6 | 658 | * Direct hardware access |
0c6b782f DM |
659 | |
660 | ||
661 | Technology Overview | |
662 | ------------------- | |
663 | ||
80b5819d | 664 | * Integrated into {pve} graphical user interface (GUI) |
0c6b782f | 665 | |
80b5819d | 666 | * LXC (https://linuxcontainers.org/) |
0c6b782f | 667 | |
80b5819d | 668 | * lxcfs to provide containerized /proc file system |
0c6b782f | 669 | |
80b5819d | 670 | * AppArmor |
0c6b782f | 671 | |
80b5819d | 672 | * CRIU: for live migration (planned) |
0c6b782f | 673 | |
80b5819d | 674 | * We use latest available kernels (4.4.X) |
0c6b782f | 675 | |
80b5819d | 676 | * Image based deployment (templates) |
0c6b782f | 677 | |
80b5819d | 678 | * Container setup from host (network, DNS, storage, ...) |
0c6b782f DM |
679 | |
680 | ||
681 | ifdef::manvolnum[] | |
3bd9d0cf DM |
682 | |
683 | Files | |
684 | ------ | |
685 | ||
686 | `/etc/pve/lxc/<CTID>.conf`:: | |
687 | ||
688 | Configuration file for the container '<CTID>'. | |
689 | ||
690 | ||
0c6b782f DM |
691 | include::pve-copyright.adoc[] |
692 | endif::manvolnum[] | |
693 | ||
694 | ||
695 | ||
696 | ||
697 | ||
698 | ||
699 |