Go to file
Leo Nunner 3d56c9c0ff api: network: get interfaces from containers
Adds an 'interfaces' endpoint in the API
(/nodes/{node}/lxc/{vmid}/interfaces'), which returns a list of
interface names, together with a MAC, IPv4 and IPv6 address. This list
may be expanded in the future. Note that this is only returned for
*running* containers, stopped containers simply return an empty list.

Signed-off-by: Leo Nunner <l.nunner@proxmox.com>
2023-11-14 19:16:01 +01:00
debian bump version to 5.0.5 2023-09-18 16:52:09 +02:00
src api: network: get interfaces from containers 2023-11-14 19:16:01 +01:00
Makefile buildsys: expand clean target 2023-06-15 10:19:05 +02:00
README update README for new configuration format 2015-08-08 17:11:40 +02:00

= Info for developers =

== Command Line Tool ==

Example:

 # pct create 200 debian-7.0-standard_7.0-2_i386.tar.gz
 # pct start 200
 # pct enter 200
 # pct stop 200
 # pct destroy 200

You can get detailed help with:

 # pct help -v
 
== Container names ==

We use integers values for container names (and do not allow to use
arbitrary names for containers).

== LXC Configuration ==

We store LXC container configurations on the cluster file system:

 /etc/pve/nodes/lxc/<CTID>.conf

There is a symbolic link for the local node at

 /etc/pve/lxc => /etc/pve/nodes/<localhost>/lxc

see man pct.conf for syntax details.

== CRIU ==

CRIU (1.5.2) does not work well with kernel 3.10.0, so checkpoint/restore
and live migration does not work.

= FAQ =

* Why not LXD

- LXD uses a local database to store configuration files, which simply
  does not work with our distributed configuration file system
  (pmxcfs)

- We want to use our existing libraries (i.e. Storage). Also see:
  https://lists.linuxcontainers.org/pipermail/lxc-users/2015-June/009441.html
  where they write: "Lxd will not be as flexible as lxc in many ways,
  including with respect to backing stores."

  We have a different goal, and want to support many new storage technologies
  like zfs, ceph, ...
  
- It is a wrapper around LXC, and only provides a REST API and new CLI
  tool. But Proxmox VE already provides a full featured API, and CLI tools
  are automatically generated from that API.