https://github.com/timwspence/codecrafters-docker-rust

https://github.com/timwspence/codecrafters-docker-rust

Last synced: 20 days ago
JSON representation

• Host: GitHub
• URL: https://github.com/timwspence/codecrafters-docker-rust
• Owner: TimWSpence
• Created: 2023-02-14T14:54:35.000Z (almost 2 years ago)
• Default Branch: master
• Last Pushed: 2023-02-21T11:01:38.000Z (almost 2 years ago)
• Last Synced: 2024-10-16T02:11:46.305Z (2 months ago)
• Language: Rust
• Size: 50.8 KB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
[![progress-banner](https://app.codecrafters.io/progress/docker/44b0edba-d7b8-425f-8e72-4fae16bcd7f5)](https://app.codecrafters.io/users/TimWSpence)

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 try the challenge.

# 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 1st stage" # any msg

git push origin master

```

That's all!

# Stage 2 & beyond

Note: This section is for stages 2 and beyond.

You'll use linux-specific syscalls in this challenge. so we'll run your code

_inside_ a Docker container.

Please ensure you have [Docker installed](https://docs.docker.com/get-docker/)

locally.

Next, add a [shell alias](https://shapeshed.com/unix-alias/):

```sh

alias mydocker='docker build -t mydocker . && docker run --cap-add="SYS_ADMIN" mydocker'

```

(The `--cap-add="SYS_ADMIN"` flag is required to create

[PID Namespaces](https://man7.org/linux/man-pages/man7/pid_namespaces.7.html))

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.