Fork i18n + search + filtering- v0.2

documentation: add local development guide and release playbook

* Update launch.example.json with simplified environment variables
* Create localdev.md with step-by-step setup instructions for running it with a network-local environment
* Create release.md with release procedure documentation

Changed files
+33 -6
.vscode
playbooks
+5 -6
.vscode/launch.example.json
··· 20 20 "env": { 21 21 "DEBUG": "true", 22 22 "HTTP_PORT": "3100", 23 - "EXTERNAL_BASE": "your-hostname", 24 - "HTTP_COOKIE_KEY": "Iteax8DsUgOrQJdES+zMa6JKYlbQkewl42Y1bO1ExSyB9jkUktrdKwwWSu+X58T20liLmsegL3LbQB0FvE1AEA", 25 - "DATABASE_URL": "postgres://postgres:password@postgres/smokesignal", 26 - "OAUTH_ACTIVE_KEYS": "01JV2SGY5K5KW5V4YS0YQ352FD", 27 - "DESTINATION_KEY": "01JV2SGY5K5KW5V4YS0YQ352FD", 28 - "SIGNING_KEYS": "/workspace/keys.json", 23 + "EXTERNAL_BASE": "yourhostname", 24 + "HTTP_COOKIE_KEY": "7omSYPNPwxT2gZPf0sQ51kPhaWKAqBu22M0j2il81LyIWP79jR4lrS1rBRX5ZIQS9qxATh469XL0k4G8c67r+A", 25 + "OAUTH_ACTIVE_KEYS": "01JV8430MGTTA692WBYFGRMWRG", 26 + "DESTINATION_KEY": "01JV8430MGTTA692WBYFGRMWRG", 27 + "SIGNING_KEYS": "eyJrZXlzIjpbeyJraWQiOiIwMUpWODQzME1HVFRBNjkyV0JZRkdSTVdSRyIsImFsZyI6IkVTMjU2Iiwia3R5IjoiRUMiLCJjcnYiOiJQLTI1NiIsIngiOiJYb3dFbHpXMFhTeXVXUWJOaVFpTDFmbm9RQlhZRmkwWk9BQ2U3S3JONU1jIiwieSI6IkFXLWpFNWYtcXNZYVBoRFhCUUNuNjVCaVRKRWtJRVEzYXFONXV2b1U1TkkiLCJkIjoiNXNvT2RZWko2MzVoWnJWMmlRcFgya1dPR19wdFB0eHJVN1J4eFFaUTNJSSJ9XX0K", 29 28 "RUST_LOG": "smokesignal=debug,html5ever=info,info" 30 29 } 31 30 }
+19
playbooks/localdev.md
··· 1 + # Localdev Playbook 2 + 3 + To run Smoke Signal in localdev (assuming vscode): 4 + 5 + 1. Create the localdev services https://tangled.sh/@smokesignal.events/localdev 6 + 7 + 2. Create a Smoke Signal dev container. Ensure it is connected to tailscale. 8 + 9 + 3. Run migrations `sqlx database reset` 10 + 11 + 4. Copy `.vscode/launch.example.json` to `.vscode.json` and set the following environment variables: 12 + 13 + * `DNS_NAMESERVERS` to `100.100.100.100` 14 + * `PLC_HOSTNAME` to `plc.internal.ts.net`. Be sure to change `internal.ts.net` to whatever your Tailnet name is (i.e. `sneaky-fox.ts.net`) 15 + * `EXTERNAL_BASE` to `placeholder.tunn.dev`. Be sure to change this to whatever tunnel service you're using. 16 + 17 + 5. Start your developer tunnel `tunnelto --subdomain placeholder --port 3100 --host localhost` 18 + 19 + At this point you can open up https://placeholder.tunn.dev/ and login with identities created with https://didadmin.internal.ts.net using the handle and password "password".
+9
playbooks/release.md
··· 1 + # Release Playbook 2 + 3 + To release a version of Smoke Signal: 4 + 5 + 1. Set the version in `Cargo.toml` 6 + 2. Set the version in `Dockerfile` 7 + 3. Commit the changes `git commit -m "release: X.Y.Z"` 8 + 4. Tag the commit `git tag -s -m "vX.Y.Z" X.Y.Z` 9 + 5. Build the container `docker build -t repository/smokesignal:latest .`