Newbie

• Basics
  • Create a Clear Container
  • Environment
• Intermediate
• Advanced

---

If you are new to Clear Containers, try working through the following tasks. They should help you to become familiar with the system.

Preliminaries

• Read the project's README carefully.
• Read the architecture document for a technical overview and details of the system components.

Basics

Create a Clear Container

1. Install Clear Containers.
2. Check that Clear Containers has installed, and is available in docker (hint: docker info).
3. Create a Clear Container (hint: docker run as normal! :)
4. Prove that you are running a Clear Container (hints: uname -r and ps aux | grep qemu).

Environment

1. Run sudo cc-runtime cc-check and seeing if you understand all the output

   (see https://github.com/clearcontainers/runtime#hardware-requirements).

2. Run sudo cc-runtime cc-env and seeing if you understand all the output

   (see https://github.com/clearcontainers/runtime#configuration).

Intermediate

1. Enable debugging.
2. Find a way to force an error.
3. Ensure you get a useful error message returned to you.
4. See if you can find evidence of the error you forced in the logs.

Advanced

Note:

This section assumes you have read the architecture document.

1. Create a new rootfs image using osbuilder.
2. Read the osbuilder docs to establish how to modify your runtime configuration to use the new rootfs image.
3. Start a Clear Container using your new rootfs image.
4. Find a way to prove that you are using your new image.

If you come across any issues or you have thoughts on how we can improve the system, please raise an issue so we can help! 😄