From d9dd5b94eaa5ad8b884c7c5dbf867b111fb100bf Mon Sep 17 00:00:00 2001 From: tv Date: Fri, 28 Sep 2018 16:04:22 +0200 Subject: README: fix list --- README.md | 1 + 1 file changed, 1 insertion(+) (limited to 'README.md') diff --git a/README.md b/README.md index 251a923..59c5344 100644 --- a/README.md +++ b/README.md @@ -3,6 +3,7 @@ krops is a lightweigt toolkit to deploy nixos systems, remotely or locally. fancy features include: + - store your secrets in passwordstore - build your system remotely - minimal overhead -- cgit v1.2.3 From 75e1338628aea086ea0dc8d19103c7263f4e6b8a Mon Sep 17 00:00:00 2001 From: tv Date: Fri, 28 Sep 2018 16:11:52 +0200 Subject: README: add link to palo's blog post --- README.md | 4 ++++ 1 file changed, 4 insertions(+) (limited to 'README.md') diff --git a/README.md b/README.md index 59c5344..7f403b7 100644 --- a/README.md +++ b/README.md @@ -48,3 +48,7 @@ in ``` and run `$(nix-build krops.nix)`. This results in a script which deploys the machine via ssh & rsync on the target machine. + +## References + +- [Blog post with in-depth example](http://tech.ingolf-wagner.de/nixos/krops/) by [Ingolf Wagner](https://ingolf-wagner.de/) -- cgit v1.2.3 From b922b41fe371896cbc38bb1dc9d0074d11686ec3 Mon Sep 17 00:00:00 2001 From: tv Date: Fri, 28 Sep 2018 17:01:38 +0200 Subject: README: add more words to the example =) --- README.md | 21 +++++++++++---------- 1 file changed, 11 insertions(+), 10 deletions(-) (limited to 'README.md') diff --git a/README.md b/README.md index 7f403b7..eb564a7 100644 --- a/README.md +++ b/README.md @@ -1,20 +1,20 @@ # krops (krebs ops) -krops is a lightweigt toolkit to deploy nixos systems, remotely or locally. +krops is a lightweigt toolkit to deploy NixOS systems, remotely or locally. -fancy features include: +## Some Features - store your secrets in passwordstore - build your system remotely -- minimal overhead +- minimal overhead (it's basically just `nixos-rebuild switch`!) - run from custom nixpkgs branch/checkout/fork -minimal example: +## Minimal Example + +Create a file named `krops.nix` (name doesn't matter) with following content: -create a krops.nix somewhere ``` let - #krops = ./.; krops = (import {}).fetchgit { url = https://cgit.krebsco.de/krops/; rev = "3022582ade8049e6ccf18f358cedb996d6716945"; @@ -28,11 +28,9 @@ let nixpkgs.git = { ref = "4b4bbce199d3b3a8001ee93495604289b01aaad3"; url = https://github.com/NixOS/nixpkgs; - }; nixos-config.file = toString (pkgs.writeText "nixos-config" '' { pkgs, ... }: { - fileSystems."/" = { device = "/dev/sda1"; }; boot.loader.systemd-boot.enable = true; services.openssh.enable = true; @@ -47,8 +45,11 @@ in } ``` -and run `$(nix-build krops.nix)`. This results in a script which deploys the machine via ssh & rsync on the target machine. +and run `$(nix-build --no-out-link krops.nix)` to deploy the target machine. + +Under the hood, this will make the sources available on the target machine +below `/var/src`, and execute `nixos-rebuild switch -I /var/src`. ## References -- [Blog post with in-depth example](http://tech.ingolf-wagner.de/nixos/krops/) by [Ingolf Wagner](https://ingolf-wagner.de/) +- [In-depth example](http://tech.ingolf-wagner.de/nixos/krops/) by [Ingolf Wagner](https://ingolf-wagner.de/) -- cgit v1.2.3 From 5b27dc84c8dc2fd104393ef5b3574469e1617fea Mon Sep 17 00:00:00 2001 From: tv Date: Fri, 28 Sep 2018 17:03:24 +0200 Subject: README: add link to password store --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'README.md') diff --git a/README.md b/README.md index eb564a7..b86c469 100644 --- a/README.md +++ b/README.md @@ -4,7 +4,7 @@ krops is a lightweigt toolkit to deploy NixOS systems, remotely or locally. ## Some Features -- store your secrets in passwordstore +- store your secrets in [password store](https://www.passwordstore.org/) - build your system remotely - minimal overhead (it's basically just `nixos-rebuild switch`!) - run from custom nixpkgs branch/checkout/fork -- cgit v1.2.3