From 0bd8634357ed121c0ba5fd3544beefc5c60e37e3 Mon Sep 17 00:00:00 2001 From: Eugene Triguba Date: Mon, 12 Oct 2026 18:37:36 -0700 Subject: Add README --- README.md | 59 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 59 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..a488ea1 --- /dev/null +++ b/README.md @@ -0,0 +1,59 @@ +# Site Infrastructure + +This repository contains terraform workspaces for setting up my infrastructure +to run my various `*.eugenetriguba.com` sites. + +## Getting Started + +To get started, you will first want to bootstrap the terraform state bucket +within Backblaze B2. To do that, you can run the following script: + +```sh +./bootstrap-state.sh +``` + +This will: + +- Setup a state bucket and application key for programmatic terraform access + via the `b2` CLI +- Setup a Secure Note within 1Password via the `op` CLI with the application + key credentials + +After that, you can setup a `.env` file with the application key credentials. To +do that, you'll first need to *manually*: + +- Setup a 1Password 'Secure Note' entry called 'Backblaze B2 Master Key' with + your B2 'Master Key' values as 'key_id' and 'key_value' fields. + +Then, you can run: + +```sh +./setup-env.sh +``` + +Now, you can source the credentials into your shell session with: + +```sh +source .env +``` + +## How to Apply a Workspace + +Where `` is one of the workspace directories: + +```sh +cd +tofu init +tofu apply +``` + +NOTE: While the official terraform CLI may work, I use the +[opentofu](https://opentofu.org/). + +## Intended Application Order + +The workspaces are intended to be applied in the following order: + +1. `hetzner-account`: Hetzner root-level account setup +2. `b2-backup`: Backblaze B2 bucket and host key setup +3. `hetzner-web`: Web servers on Hetzner setup -- cgit v1.2.3