+5
-6
.vscode/launch.example.json
+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
+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
+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 .`