docker-nixpkgs/README.md
zimbatm 5d9a795ac3
use image tags to identify channels
this works better with registries like hub.docker.com that don't allow
nested images
2019-01-19 18:25:40 +01:00

50 lines
1.4 KiB
Markdown

# docker-nixpkgs: docker images from nixpkgs
This project is a collection of docker images automatically produced with Nix
and the latest nixpkgs package set. It even refreshes every morning a 4:00 UTC
thanks to the [Gitlab CI schedules][gitlab-schedules].
It's also a good demonstration on how to build and publish Docker images with
Nix.
Always keep your docker images fresh!
## Why use Nix to build docker images?
Nix has a number of advantages over Dockerfile when producing docker images:
* builds are actually reproducible
* Nix will only rebuild the minimum set of changes
* Nix can produce automatic optimised layers for you
## Example usage
Here is an example of using one of the docker images. Usage will change from
image to image.
```
# the user must have an account at gitlab
$ docker login registry.gitlab.com
# run the curl image which has curl as an entry-point
$ docker run -ti --rm registry.gitlab.com/zimbatm/docker-nixpkgs/curl http://ifconfig.co
180.52.248.114
```
## List of images
| Image | Description |
| --- | --- |
| curl | just curl as an entrypoint |
| nix | nix with deps |
| nix-unstable | nixUnstable with deps |
## Channels
| Name |
| --- |
| nixos-unstable |
| nixos-18.09 |
[gitlab-schedules]: https://gitlab.com/zimbatm/docker-nixpkgs/pipeline_schedules