Commit Graph

264 Commits

Author SHA1 Message Date
Johannes Kirschbauer
afa0984b57 Docs: remove generated inventory.md from git index 2024-07-19 11:17:08 +02:00
Johannes Kirschbauer
67b76c8ced Docs: generate api docs for inventory 2024-07-19 11:07:47 +02:00
Valentin Gagarin
13b8b949f9 docs: add reference index pages
- add index pages for each reference documentation category
- move concepts pages into the reference hierarchy
- render clanModules overview page in the style of the CLI overview
2024-07-19 10:27:04 +02:00
Jörg Thalheim
d4b0f3bed4 docs: fix flash example 2024-07-15 11:53:25 +02:00
Valentin Gagarin
11bb60fc80 docs: move blog to end of navigation
documentation users will be here primarily because of onboarding tutorials and
reference documentation.
2024-07-15 11:03:14 +02:00
Johannes Kirschbauer
f2320e907f Doc: write inventory documentation 2024-07-14 16:42:27 +02:00
Mic92
3e6c41593d Merge branch 'main' into DavHau-dave 2024-07-09 09:33:11 +00:00
Jörg Thalheim
f62c30f81d fix shellcheck warnings 2024-07-08 16:24:34 +02:00
Jörg Thalheim
9e6d5124ad add shellcheck hints to all envrc files 2024-07-08 16:24:34 +02:00
Jörg Thalheim
29616a8b5d fix mkdocs-rss-plugin deps 2024-07-08 16:24:34 +02:00
Jörg Thalheim
bd8515fa59 treefmt: upgrade nixfmt options 2024-07-08 16:24:34 +02:00
Johannes Kirschbauer
d8ff8b042f Doc: add conceptual documentation 2024-07-06 17:22:47 +02:00
DavHau
4cde2d96be Reapply "clan.core: rename clan.{deployment,networking} -> clan.core.{deployment,networking}"
This reverts commit 9778444706.

workaround upstream bug: https://github.com/NixOS/nixpkgs/issues/324802
2024-07-05 19:29:01 +07:00
Jörg Thalheim
9778444706 Revert "clan.core: rename clan.{deployment,networking} -> clan.core.{deployment,networking}"
This reverts commit afbd4a984d.

The old configuration cannot be updated like this:

eve] error:
[eve]        … while calling the 'head' builtin
[eve]          at /nix/store/5b0hl2dnvr1sawqlkwmsnaiyqz00d34h-source/lib/attrsets.nix:1575:11:
[eve]          1574|         || pred here (elemAt values 1) (head values) then
[eve]          1575|           head values
[eve]              |           ^
[eve]          1576|         else
[eve]
[eve]        … while evaluating the attribute 'value'
[eve]          at /nix/store/5b0hl2dnvr1sawqlkwmsnaiyqz00d34h-source/lib/modules.nix:809:9:
[eve]           808|     in warnDeprecation opt //
[eve]           809|       { value = builtins.addErrorContext "while evaluating the option `${showOption loc}':" value;
[eve]              |         ^
[eve]           810|         inherit (res.defsFinal') highestPrio;
[eve]
[eve]        … while evaluating the option `system.build.toplevel':
[eve]
[eve]        … while evaluating definitions from `/nix/store/5b0hl2dnvr1sawqlkwmsnaiyqz00d34h-source/nixos/modules/system/activation/top-level.nix':
[eve]
[eve]        … while evaluating the option `assertions':
[eve]
[eve]        … while evaluating definitions from `/nix/store/5b0hl2dnvr1sawqlkwmsnaiyqz00d34h-source/nixos/modules/system/boot/systemd.nix':
[eve]
[eve]        … while evaluating the option `systemd.services':
[eve]
[eve]        … while evaluating definitions from `/nix/store/kpzcdgndym0qm1w490mjvk9c2qmz03h5-source/nixosModules/clanCore/zerotier':
[eve]
[eve]        … while evaluating the option `clan.core.networking.zerotier.networkId':
[eve]
[eve]        (stack trace truncated; use '--show-trace' to show the full, detailed trace)
[eve]
[eve]        error: A definition for option `clan.core.networking.zerotier.networkId' is not of type `null or string'. Definition values:
[eve]        - In `/nix/store/kpzcdgndym0qm1w490mjvk9c2qmz03h5-source/nixosModules/clanCore/networking.nix':
[eve]            {
[eve]              _type = "override";
[eve]              content = "267efd4a15b69623";
[eve]              priorit
2024-07-05 11:16:05 +02:00
DavHau
802f047341 devShells: make all shells inherit from default shell
Currently, important tools from the default shell are lost as soon as select-shell is used to switch to another shell. select-shell itself, for example is missing, which makes it impossible to switch back to another shell.
2024-07-05 15:01:25 +07:00
DavHau
afbd4a984d clan.core: rename clan.{deployment,networking} -> clan.core.{deployment,networking} 2024-07-04 17:05:37 +07:00
DavHau
208021ee1c reference docs: add missing description fields and enforce it from now on 2024-07-04 13:34:55 +07:00
DavHau
85a9d82132 vars: import by default & fix option rendering 2024-07-04 13:12:29 +07:00
Johannes Kirschbauer
dc583ece4f clanModules: init packages 2024-07-03 12:31:53 +02:00
Johannes Kirschbauer
fc31d1aae7 Fix frontmatter of module 2024-07-03 11:57:15 +02:00
Johannes Kirschbauer
74dd48320e ClanModules: Add docs and api to retrieve metadata 2024-06-25 21:17:42 +02:00
Johannes Kirschbauer
9b0e2a87e8 ClanModules: Add docs and api to retrieve metadata 2024-06-25 21:17:01 +02:00
clan-bot
4022c13b31 Merge pull request 'Docs: rename clanName to just name' (#1660) from hsjobeki/clan-core:hsjobeki-main into main 2024-06-25 12:25:27 +00:00
Johannes Kirschbauer
26c655ff3c Add settings.json back 2024-06-25 12:23:29 +00:00
Johannes Kirschbauer
712ed3f738 Docs: add inventory module docs 2024-06-25 12:23:29 +00:00
Johannes Kirschbauer
241cca5b70 Docs: rename clanName to just name 2024-06-25 14:21:53 +02:00
a-kenji
3bcaeda737 cli: add command to list state
Add a subcommand to list configured state for a specific machine.

Example:
```
$ clan state list [MACHINE]
```
2024-06-25 09:34:31 +00:00
a-kenji
63e6aaf1fe blog: fix typos in backup blog 2024-06-25 09:02:52 +00:00
Qubasa
88f97bd2b6 Fixed Contributing.md guide 2024-06-24 19:22:24 +02:00
Jörg Thalheim
5575c5d214 first draft of the backup article 2024-06-24 15:05:37 +02:00
DavHau
313db5643f refactor: rename clanCore -> clan.core 2024-06-18 18:32:40 +07:00
Jörg Thalheim
d221d90972 update matrix address 2024-06-17 15:26:23 +02:00
Johannes Kirschbauer
43e8804eb4 Docs: update machine hardware config instructions 2024-06-15 22:27:46 +02:00
clan-bot
a1acf0b05d Merge pull request 'Expand backup and restore capabilities w.r.t. postgresql.' (#1582) from synapse into main 2024-06-10 13:24:08 +00:00
Johannes Kirschbauer
8ff00fd8fe API: include show into docs 2024-06-08 18:07:41 +02:00
Jörg Thalheim
6dec2a9222 add postgresql backup hooks 2024-06-06 13:27:30 +02:00
a-kenji
d25eaa48d0 modules/syncthing-static-peers: init 2024-06-06 09:55:57 +02:00
a-kenji
193d54153d borbackup-static: impl
Implements sane defaults implementing borgbackup

Fixes: #1551
2024-06-05 21:17:24 +00:00
Johannes Kirschbauer
0fb207bb59 clan-app: rename clan-vm-manager 2024-06-05 11:24:59 +02:00
a-kenji
bf0cc19c8f documentation(backups): make exampe more robust 2024-06-04 17:09:26 +02:00
Qubasa
55f4dcc460 docs: Add meta tags for link preview and fix js loading issue. 2024-06-01 22:19:37 +02:00
Qubasa
90e25eeb76 Contributing.md: Fix incorrect formating. 2024-05-31 15:58:29 +02:00
Qubasa
66fe5ec4fd Contributing.md: Explain merge-after-ci for externals. 2024-05-31 13:58:13 +02:00
Qubasa
adef52a938 docs: Fix installer wrong indentation 2024-05-30 22:41:30 +02:00
Qubasa
b18d7bfeac Change clan favicon to one without text 2024-05-30 21:59:48 +02:00
Jörg Thalheim
750b6aec59 flash: make configuration more explicit
Injecting nixos configuration and potentially overriding settings a user
made and can cause surprises.
In most cases, users want to just make these option part of their NixOS
configuration and by having the rest in the command line
we make it more explicit what other configuration is being applied.
2024-05-29 12:45:50 +02:00
Jörg Thalheim
f0f97baa65 drop global argparse flags
They get shadowed by subargparser options.
2024-05-29 10:21:35 +02:00
Qubasa
ba8a51101d Update Contributing guide to external developers 2024-05-28 18:06:31 +02:00
clan-bot
dcd6ad0983 Merge pull request 'Docs: fix relative links to git.clan.lol' (#1482) from hsjobeki-main into main 2024-05-28 15:18:45 +00:00
Johannes Kirschbauer
567d979243 Docs: fix relative links to git.clan.lol 2024-05-28 17:14:16 +02:00