diff options
| author | Domen Kožar <domen@dev.si> | 2021-10-06 08:10:53 -0500 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2021-10-06 08:10:53 -0500 |
| commit | d0cc6a192af34f57b0892c49e09c2896c1f5a9dc (patch) | |
| tree | 71189139f6601761c7a12ac4369ccf69dfb9b112 /doc/manual/src | |
| parent | bedd12ec14062bb23bbd87dd892219b84abbcce9 (diff) | |
| parent | 0574c1850a785297b7f28c6f286a23fa3eca14a8 (diff) | |
Merge pull request #5095 from happysalada/update_remote_builds_docs
docs: add troubleshooting session in remote builds
Diffstat (limited to 'doc/manual/src')
| -rw-r--r-- | doc/manual/src/advanced-topics/distributed-builds.md | 14 |
1 files changed, 12 insertions, 2 deletions
diff --git a/doc/manual/src/advanced-topics/distributed-builds.md b/doc/manual/src/advanced-topics/distributed-builds.md index 580b36736..23a179a2a 100644 --- a/doc/manual/src/advanced-topics/distributed-builds.md +++ b/doc/manual/src/advanced-topics/distributed-builds.md @@ -95,7 +95,7 @@ default, set it to `-`. there are multiple machines of the right type, Nix will prefer the fastest, taking load into account. -6. A comma-separated list of *supported features*. If a derivation has +6. A comma-separated list of _supported features_. If a derivation has the `requiredSystemFeatures` attribute, then Nix will only perform the derivation on a machine that has the specified features. For instance, the attribute @@ -107,7 +107,7 @@ default, set it to `-`. will cause the build to be performed on a machine that has the `kvm` feature. -7. A comma-separated list of *mandatory features*. A machine will only +7. A comma-separated list of _mandatory features_. A machine will only be used to build a derivation if all of the machine’s mandatory features appear in the derivation’s `requiredSystemFeatures` attribute.. @@ -156,3 +156,13 @@ option `builders-use-substitutes` in your local `nix.conf`. To build only on remote builders and disable building on the local machine, you can use the option `--max-jobs 0`. + +## Troubleshooting + +### ssh + +even if the store is reachable with `nix store ping --store your_store_url`, the nix-daemon might not be able to reach it. nix-daemon operates as root so you need to make sure that the machine is reachable via ssh as root user. + +- add the `-vvv` flags to show more information on the potential problem. +- make sure your store is reachable by the root user. `sudo ssh -i "your_ssh_key_path" your_user@your_hostname` +- make sure your ssh_config is set for the root user to access that server or that your builders configuration contains the ssh_key, user and hostname |