Starting the container...
|Remote LXD||lxc remote add tryit --password=|
|Remaining time||minutes, seconds|
You are now root inside a LXD container with a nested LXD installed inside it.
Initial startup can take a few seconds due to
having to generate SSL keys on a rather busy system.
Further commands should then be near instantaneous.
You're welcome to just poke around and
discover LXD through its manpage and --help
Or you can follow this step by step tutorial instead which will get you through LXD's main features.
LXD is image based, however by default no images are loaded into the image store as can be seen with:
lxc image list
LXD knows about 3 default image servers:
The stable Ubuntu images can be listed with:
lxc image list ubuntu: | less
To launch a first container called "first" using the Ubuntu 14.04 image, use:
lxc launch ubuntu:14.04 first
Your new container will now be visible in:
Running state details and configuration can be queried with:
lxc info first lxc config show first
By default your container comes with no resource limitation and inherits from its parent environment. You can confirm it with:
free -m lxc exec first -- free -m
To apply a memory limit to your container, do:
lxc config set first limits.memory 64MB
And confirm that it's been applied with:
lxc exec first -- free -m
LXD supports snapshoting and restoring
Before making a snapshot, lets do some changes to the container, for example, updating it:
lxc exec first -- apt-get update lxc exec first -- apt-get dist-upgrade -y lxc exec first -- apt-get autoremove --purge -y
Now that the container is all updated and cleaned, let's make a snapshot called "clean":
lxc snapshot first clean
Let's break our container:
lxc exec first -- rm -Rf /etc /usr
Confirm the breakage with (then exit):
lxc exec first -- bash
And restore everything to the snapshotted state:
lxc restore first clean
And confirm everything's back to normal (then exit):
lxc exec first -- bash
As your probably noticed earlier, LXD is image based, that is, all containers must be created from either a copy of an existing container or from an image.
You can create new images from an existing container or a container snapshot.
To publish our "clean" snapshot from earlier as a new image with a user friendly alias of "clean-ubuntu", run:
lxc publish first/clean --alias clean-ubuntu
At which point we won't need our "first" container, so just delete it with:
lxc stop first lxc delete first
And lastly we can start a new container from our image with:
lxc launch clean-ubuntu second
To pull a file from the container you can use the "lxc file pull" command:
lxc file pull second/etc/hosts .
Let's add an entry to it:
echo "22.214.171.124 my-example" >> hosts
And push it back where it came from:
lxc file push hosts second/etc/hosts
You can also use this mechanism to access log files:
lxc file pull second/var/log/syslog - | less
We won't be needing that container anymore, so stop and delete it with:
lxc delete --force second
The lxc client tool supports multiple "remotes", those remotes can be read-only image servers or other LXD hosts.
LXC upstream runs one such server at https://images.linuxcontainers.org which serves a set of automatically generated images for various Linux distributions.
It comes pre-added with default LXD but you can remove it or change it if you don't want it.
You can list the available images with:
lxc image list images: | less
And spawn a new Centos 7 container with:
lxc launch images:centos/7 third
Confirm it's indeed Centos 7 with:
lxc exec third -- cat /etc/redhat-release
And delete it:
lxc delete -f third
The list of all configured remotes can be obtained with:
lxc remote list
For this step, you'll need a second demo session, so open a new one here
Copy/paste the "lxc remote add" command from
the top of the page of that new session into
the shell of your old session.
Then confirm the server fingerprint and enter the password of the remote server.
Note that it may take a few seconds for the new LXD daemon to listen to the network, just retry the command until it answers.
At this point you can list the remote containers with:
lxc list tryit:
And its images with:
lxc image list tryit:
Now, let's start a new container on the remote LXD using the local image we created earlier.
lxc launch clean-ubuntu tryit:fourth
You now have a container called "fourth" running on the remote host "tryit". You can spawn a shell inside it with (then exit):
lxc exec tryit:fourth bash
Now let's copy that container into a new one called "fifth":
lxc copy tryit:fourth tryit:fifth
And just for fun, move it back to our local lxd while renaming it to "sixth":
lxc move tryit:fifth sixth
And confirm it's all still working (then exit):
lxc start sixth lxc exec sixth -- bash
Then clean everything up:
lxc delete -f sixth lxc delete -f tryit:fourth lxc image delete clean-ubuntu
We hope this gave you a good introduction to LXD, its capabilities and how easy it is to use.
You're welcome to use the demo service as long as you want to try LXD and play with the latest features.