52 lines
1.2 KiB
Markdown
52 lines
1.2 KiB
Markdown
+++
|
|
title = "OCI Quick Start"
|
|
weight = 30
|
|
+++
|
|
This guide will quickly get you started running your first gVisor sandbox
|
|
container using the runtime directly with the default platform.
|
|
|
|
## Install gVisor
|
|
|
|
> Note: gVisor supports only x86\_64 and requires Linux {{< required_linux >}}
|
|
> ([older Linux][old-linux]).
|
|
|
|
{{% readfile file="docs/includes/install_gvisor.md" markdown="true" %}}
|
|
|
|
## Run an OCI compatible container
|
|
|
|
Now we will create an [OCI][oci] container bundle to run our container. First we
|
|
will create a root directory for our bundle.
|
|
|
|
```bash
|
|
mkdir bundle
|
|
cd bundle
|
|
```
|
|
|
|
Create a root file system for the container. We will use the Docker hello-world
|
|
image as the basis for our container.
|
|
|
|
```bash
|
|
mkdir rootfs
|
|
docker export $(docker create hello-world) | tar -xf - -C rootfs
|
|
```
|
|
|
|
Next, create an specification file called `config.json` that contains our
|
|
container specification. We will update the default command it runs to `/hello`
|
|
in the `hello-world` container.
|
|
|
|
```bash
|
|
runsc spec
|
|
sed -i 's;"sh";"/hello";' config.json
|
|
```
|
|
|
|
Finally run the container.
|
|
|
|
```bash
|
|
sudo runsc run hello
|
|
```
|
|
|
|
Next try [running gVisor using Docker](../docker/).
|
|
|
|
[oci]: https://opencontainers.org/
|
|
[old-linux]: /docs/user_guide/networking/#gso
|