mirror of
https://github.com/apple/container.git
synced 2026-10-14 10:09:10 +00:00
pickle-RickAandpickle-RickA
565e8a3e02
Small documentation improvements for better consistency: - Fixed capitalization (url → URL) in kernel README - Added bash syntax highlighting to code block in lab.md - Improved formatting consistency in ctr-example README (added colon + code fence) Co-authored-by: pickle-RickA <273219719+pickle-RickA@users.noreply.github.com>
49 lines
1.3 KiB
Markdown
49 lines
1.3 KiB
Markdown
# Container Example
|
|
|
|
Very basic example of launching a Linux container using Containerization.
|
|
|
|
## Build and Run
|
|
|
|
### 1. Fetch Kernel
|
|
|
|
In your terminal, change directories to examples/ctr-example and run:
|
|
|
|
**Option A: Using Makefile (recommended)**
|
|
```bash
|
|
make fetch-default-kernel
|
|
```
|
|
|
|
**Option B: Copy from installed container tool**
|
|
```bash
|
|
cp "$(ls -t ~/Library/Application\ Support/com.apple.container/kernels/vmlinux-* | head -1)" ./vmlinux
|
|
```
|
|
|
|
You should now see the `vmlinux` image in examples/ctr-example
|
|
|
|
### 2. Build/Run ctr-example
|
|
|
|
From examples/ctr-example run:
|
|
```bash
|
|
make all
|
|
```
|
|
|
|
> [!WARNING]
|
|
> If you get the following error, try building from the default macOS terminal:
|
|
> `error: compiled module was created by a newer version of the compiler`
|
|
|
|
After the build completes, the example will run. In your terminal you should see something like:
|
|
|
|
```
|
|
Starting container example...
|
|
Fetching container initial filesystem...
|
|
Creating container from docker.io/library/alpine:3.16...
|
|
Starting container...
|
|
/ #
|
|
```
|
|
|
|
> [!WARNING]
|
|
> If you get the following error, try moving the `ctr-example` binary to `/var/tmp` and run it from there.
|
|
> `Swift/ErrorType.swift:254: Fatal error: Error raised at top level: unsupported: "failed to create vmnet network with status vmnet_return_t(rawValue: 1001)"`
|
|
|
|
**Congratulations, you've started the example container!**
|