-
Notifications
You must be signed in to change notification settings - Fork 1.1k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
add readme #19
add readme #19
Conversation
readme.md
Outdated
### Important: This repository is in an early development phase and not suitable for practical workloads. It does not compare with `docker build` features yet. | ||
|
||
|
||
## Buildkit |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I think we standardised on using capital K
for the kits (BuildKit
)
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
(here, and other occurrences below)
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Left some minor nits for the README (also - can you wrap to 80-chars? easier for future reviews), and some questions
readme.md
Outdated
|
||
[![asciicinema example](https://asciinema.org/a/gPEIEo1NzmDTUu2bEPsUboqmU.png)](https://asciinema.org/a/gPEIEo1NzmDTUu2bEPsUboqmU) | ||
|
||
Buildkit daemon can be built in two different versions: one that uses [containerd](https://github.com/containerd/containerd) for execution and distribution and a standalone version that doesn't have other dependencies apart from [runc](https://github.com/opencontainers/runc). We are open for adding more backends. `buildd` is a CLI utility for running the gRPC API. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
s/Buildkit daemon/The BuildKit daemon/ ?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
"for execution and distribution and a standalone" -> "for execution and distribution, and a standalone" (add comma before the last "and")
readme.md
Outdated
|
||
Buildkit daemon can be built in two different versions: one that uses [containerd](https://github.com/containerd/containerd) for execution and distribution and a standalone version that doesn't have other dependencies apart from [runc](https://github.com/opencontainers/runc). We are open for adding more backends. `buildd` is a CLI utility for running the gRPC API. | ||
|
||
``` |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
can you add a bash
language-hint here?
readme.md
Outdated
|
||
You can use `buildctl debug dump` to see what data is this definition. | ||
|
||
``` |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
```bash
(here, and other occurrences)
readme.md
Outdated
``` | ||
|
||
To start building use `buildctl build` command. The script accepts `--target` flag to choose between `containerd` and `standalone` configurations. In standalone mode buildkit binaries are built together with `runc`. In containerd mode, `containerd` binary is built as well from the upstream repo. | ||
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
"containerd
binary is built as well" -> "the containerd
binary is built as well..."
readme.md
Outdated
|
||
``` | ||
make validate-all | ||
``` |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Will this repository stay in your name, or be moved to the "docker" or "moby" org?
Can you also;
- add a
CONTRIBUTING.md
(like https://github.com/linuxkit/linuxkit/blob/master/CONTRIBUTING.md) and link it from here? - add a link to the license here (
Released under the [Apache 2.0 license](LICENSE).
) - fill in the copyright owner, and year in the license
- add a
NOTICE
file (like https://github.com/linuxkit/linuxkit/blob/master/NOTICE) - add a poule.yml (assuming we'll be using the regular review procedure); https://github.com/linuxkit/linuxkit/blob/master/poule.yml - may have to add the right labels as well
- add a
MAINTAINERS
file (https://github.com/docker/opensource/blob/master/project-template/MAINTAINERS)
We may have to configure leeroy to do the DCO check on PR's 😄
Let me know if you want me to take care of those
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Let's leave these to separate PR
Signed-off-by: Tonis Tiigi <tonistiigi@gmail.com>
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
LGTM
(per our discussion; other files will be added at a later stage)
- fix IsSSHTransport to also check for explicitly-defined ssh-based git repos Signed-off-by: Alex Couture-Beil <alex@earthly.dev>
fix(debug): check for nil payload
Open files for local writes with truncate flag
@thaJeztah
Signed-off-by: Tonis Tiigi tonistiigi@gmail.com