docs: update Adding Machines guide

This commit is contained in:
Michael Hoang
2024-12-11 13:54:18 +11:00
parent ad4a3b473f
commit 38d867a4e1

View File

@@ -1,22 +1,22 @@
# Adding Machines # Adding Machines
Clan has two general methods of adding machines Clan has two general methods of adding machines:
- **Automatic**: Detects every folder in the `machines` folder. - **Automatic**: Detects every folder in the `machines` folder.
- **Declarative**: Explicit declarations in nix. - **Declarative**: Explicit declarations in Nix.
## Automatic register ## Automatic registration
Every machine of the form `machines/{machineName}` will be registered automatically. Every folder `machines/{machineName}` will be registered automatically as a Clan machine.
!!! info "Automatically loaded files" !!! info "Automatically loaded files"
Some files are loaded by a clan machine automatically. This decision was made for convinience and allows easier automation. The following files are loaded automatically for each Clan machine:
- [x] ``machines/{machineName}/configuration.nix` - [x] `machines/{machineName}/configuration.nix`
- [x] ``machines/{machineName}/hardware-configuration.nix` - [x] `machines/{machineName}/hardware-configuration.nix`
- [x] ``machines/{machineName}/facter.json` Automatically configured, for further information see [nixos-facter](https://clan.lol/blog/nixos-facter/) - [x] `machines/{machineName}/facter.json` Automatically configured, for further information see [nixos-facter](https://clan.lol/blog/nixos-facter/)
- [x] ``machines/{machineName}/disko.nix` Automatically loaded, for further information see the [disko docs](https://github.com/nix-community/disko/blob/master/docs/quickstart.md). - [x] `machines/{machineName}/disko.nix` Automatically loaded, for further information see the [disko docs](https://github.com/nix-community/disko/blob/master/docs/quickstart.md).
## Manual declaration ## Manual declaration