forked from Fediversity/Fediversity
Kiara Grouwstra
dd5a6335b1
pass in description fix syntax configure proxmox provider typo add doc comment in existing modules add comment allow insecure proxmox connection for use in dev wip proxmox progress use service configurations moved to machine-independent location wire settings directly without option block terraform adjust cwd try tf on null input update .envrc.sample with sample proxmox credentials
37 lines
784 B
Markdown
37 lines
784 B
Markdown
# service deployment
|
|
|
|
deploys [NixOS](https://nixos.org/) templates using [OpenTofu](https://opentofu.org/).
|
|
|
|
## requirements
|
|
|
|
- [nix](https://nix.dev/)
|
|
|
|
## usage
|
|
|
|
### development
|
|
|
|
before using other commands, if not using direnv:
|
|
|
|
```sh
|
|
nix-shell
|
|
```
|
|
|
|
then to initialize, or after updating pins or TF providers:
|
|
|
|
```sh
|
|
setup
|
|
```
|
|
|
|
then, one can use the `tofu` CLI in the sub-folders.
|
|
|
|
## credentials
|
|
|
|
Credentials may be placed in (sub-folders') `.envrc`, see:
|
|
|
|
- `.envrc.sample`
|
|
- TF [proxmox provider](https://registry.terraform.io/providers/bpg/proxmox/latest/docs#environment-variables-summary)
|
|
|
|
## implementing
|
|
|
|
proper documentation TODO.
|
|
until then, a reference implementation may be found in [`panel/`](https://git.fediversity.eu/Fediversity/Fediversity/src/branch/main/panel).
|