mirror of
https://github.com/kata-containers/kata-containers.git
synced 2025-10-22 04:18:53 +00:00
This is a virtcontainers 1.0.8 import into Kata Containers runtime. virtcontainers is a Go library designed to manage hardware virtualized pods and containers. It is the core Clear Containers framework and will become the core Kata Containers framework, as discussed at https://github.com/kata-containers/runtime/issues/33 Some more more pointers: virtcontainers README, including some design and architecure notes: https://github.com/containers/virtcontainers/blob/master/README.md virtcontainers 1.0 API: https://github.com/containers/virtcontainers/blob/master/documentation/api/1.0/api.md Fixes #40 Signed-off-by: Samuel Ortiz <sameo@linux.intel.com>
57 lines
1.1 KiB
Markdown
57 lines
1.1 KiB
Markdown
|
|
Table of Contents
|
|
=================
|
|
|
|
* [Prerequisites](#prerequisites)
|
|
* [Building](#building)
|
|
* [Testing](#testing)
|
|
* [Submitting changes](#submitting-changes)
|
|
|
|
# Prerequisites
|
|
|
|
`virtcontainers` has a few prerequisites for development:
|
|
|
|
- docker
|
|
- CNI
|
|
- golang
|
|
- gometalinter
|
|
|
|
A number of these can be installed using the
|
|
[virtcontainers-setup.sh](../utils/virtcontainers-setup.sh) script.
|
|
|
|
# Building
|
|
|
|
To build `virtcontainers`, at the top level directory run:
|
|
|
|
```bash
|
|
# make
|
|
```
|
|
|
|
# Testing
|
|
|
|
Before testing `virtcontainers`, ensure you have met the [prerequisites](#prerequisites).
|
|
|
|
Before testing you need to install virtcontainers. The following command will install
|
|
`virtcontainers` into its own area (`/usr/bin/virtcontainers/bin/` by default).
|
|
|
|
```
|
|
# sudo -E PATH=$PATH make install
|
|
```
|
|
|
|
To test `virtcontainers`, at the top level run:
|
|
|
|
```
|
|
# make check
|
|
```
|
|
|
|
This will:
|
|
|
|
- run static code checks on the code base.
|
|
- run `go test` unit tests from the code base.
|
|
|
|
# Submitting changes
|
|
|
|
For details on the format and how to submit changes, refer to the
|
|
[Contributing](CONTRIBUTING.md) document.
|
|
|