53 lines
1.8 KiB
Markdown
53 lines
1.8 KiB
Markdown
This is a starting point for Rust solutions to the
|
|
["Build Your Own Docker" Challenge](https://codecrafters.io/challenges/docker).
|
|
|
|
In this challenge, you'll build a program that can pull an image from
|
|
[Docker Hub](https://hub.docker.com/) and execute commands in it. Along the way,
|
|
we'll learn about [chroot](https://en.wikipedia.org/wiki/Chroot),
|
|
[kernel namespaces](https://en.wikipedia.org/wiki/Linux_namespaces), the
|
|
[docker registry API](https://docs.docker.com/registry/spec/api/) and much more.
|
|
|
|
**Note**: If you're viewing this repo on GitHub, head over to
|
|
[codecrafters.io](https://codecrafters.io) to signup for early access.
|
|
|
|
# Passing the first stage
|
|
|
|
The entry point for your Docker implementation is `src/main.rs`. Study and
|
|
uncomment the relevant code, and push your changes to pass the first stage:
|
|
|
|
```sh
|
|
git add .
|
|
git commit -m "pass the first stage"
|
|
git push origin master
|
|
```
|
|
|
|
That's all!
|
|
|
|
# Setup for stages 2 & beyond
|
|
|
|
1. Ensure you have [Docker](https://www.docker.com/) installed locally.
|
|
1. Follow the details below ("Running your program locally") to run your Docker
|
|
implementation, which is implemented in `src/main.rs`.
|
|
1. Commit your changes and run `git push origin master` to submit your solution
|
|
to CodeCrafters. Test output will be streamed to your terminal.
|
|
|
|
### Running your program locally
|
|
|
|
Since you'll need to use linux-specific syscalls in this challenge, we'll run
|
|
your code _inside_ a Docker container.
|
|
|
|
Start by adding a [shell alias](https://shapeshed.com/unix-alias/):
|
|
|
|
```sh
|
|
alias mydocker='docker build -t mydocker . && docker run --cap-add="SYS_ADMIN" mydocker'
|
|
```
|
|
|
|
You can now execute your program like this:
|
|
|
|
```sh
|
|
mydocker run ubuntu:latest /usr/local/bin/docker-explorer echo hey
|
|
```
|
|
|
|
This command compiles your Rust project, so it might be slow the first time you
|
|
run it. Subsequent runs will be fast.
|