devos/doc/integrations/deploy.md

50 lines
1.1 KiB
Markdown
Raw Normal View History

2021-02-15 19:08:17 +01:00
# deploy-rs
[Deploy-rs][d-rs] is a tool for managing NixOS remote machines. It was
2021-02-18 02:31:33 +01:00
chosen for devos after the author experienced some frustrations with the
2021-02-15 19:08:17 +01:00
stateful nature of nixops' db. It was also designed from scratch to support
flake based deployments, and so is an excellent tool for the job.
By default, all the [hosts](../../hosts) are also available as deploy-rs nodes,
configured with the hostname set to `networking.hostName`; overridable via
the command line.
## Usage
Just add your ssh key to the host:
```nix
{ ... }:
{
users.users.${sshUser}.openssh.authorizedKeys.keyFiles = [
../secrets/path/to/key.pub
];
}
```
And the private key to your user:
```nix
{ ... }:
{
home-manager.users.${sshUser}.programs.ssh = {
enable = true;
matchBlocks = {
${host} = {
host = hostName;
identityFile = ../secrets/path/to/key;
extraOptions = { AddKeysToAgent = "yes"; };
};
};
}
}
```
And run the deployment:
```sh
deploy "flk#hostName" --hostname host.example.com
```
> ##### _Note:_
> Your user will need sudo access
[d-rs]: https://github.com/serokell/deploy-rs