Update project with steps to deploy to fly.io

Author: letam

README.md

@@ -76,3 +76,34 @@ Includes some functionality for a basic public micro-blogging app.
 	```
 	./build-prod
 	```
+
+
+## Deploying to fly.io
+
+### Config Type 1: Deploy on simple single webserver with SQLite database:
+
+1. Set app name in project (Replace *your_app_name* with an actual app name):
+```
+sed -i.bak 's/FLY_APP_NAME/your_app_name/g' server/config/settings.py && find scripts/ -type f -name "deploy_*" -exec sed -i.bak 's/FLY_APP_NAME/your_app_name/g' {} +
+```
+
+2. Run app deployment script:
+```
+./scripts/deploy-fly.io-sqlite.sh $app_name
+```
+
+### Config Type 2: Deploy using HA configuration with Postgres database:
+
+1. Set app name in project (Replace *your_app_name* with an actual app name):
+```
+sed -i.bak 's/FLY_APP_NAME/your_app_name/g' server/config/settings.py && find scripts/ -type f -name "deploy_*" -exec sed -i.bak 's/FLY_APP_NAME/your_app_name/g' {} +
+```
+
+2. Run app deployment script:
+```
+./scripts/deploy-fly.io-postgres.sh
+```
+
+### To use Cloudflare R2 object storage for user uploads (Required for Config Type 2):
+
+TODO

scripts/cleanup-after-fly-deploy.sh

@@ -0,0 +1,13 @@
+#!/usr/bin/env bash
+
+# Remove backup files created by fly deployment script
+files=(
+    "scripts/configs/fly-postgres.toml.bak"
+    "scripts/configs/fly-sqlite.toml.bak"
+    "server/config/settings.py.bak"
+)
+for file in "${files[@]}"; do
+    if [ -f "$file" ]; then
+        rm "$file"
+    fi
+done

scripts/configs/fly-postgres.toml

@@ -3,7 +3,7 @@
 # See https://fly.io/docs/reference/configuration/ for information about how to use this file.
 #
 
-app = 'web-framework-2025-lively-glitter-9000'
+app = 'FLY_APP_NAME'
 primary_region = 'iad'
 console_command = '/code/manage.py shell'
 

scripts/configs/fly-sqlite.toml

@@ -3,7 +3,7 @@
 # See https://fly.io/docs/reference/configuration/ for information about how to use this file.
 #
 
-app = 'webframework'
+app = 'FLY_APP_NAME'
 primary_region = 'yyz'
 console_command = '/code/manage.py shell'
 

scripts/deploy-fly.io-postgres.sh

@@ -1,5 +1,17 @@
 #!/usr/bin/env bash
 
+# Get FLY_APP_NAME from command line arguments
+FLY_APP_NAME=$1
+
+# Display usage if no argument is provided
+if [ -z "$FLY_APP_NAME" ]; then
+    echo "Usage: $0 <app_name>"
+    exit 1
+fi
+
+# Set app name in project via script
+./scripts/set-fly-app-name.sh $FLY_APP_NAME
+
 # Specify the target fly.toml configuration file
 function specify_target_fly_toml() {
     # Move currently active fly.toml configuration file to local tmp directory
@@ -14,7 +26,7 @@ function specify_target_fly_toml() {
 specify_target_fly_toml
 
 # Launch app
-yes n | fly launch --now --copy-config
+yes n | fly launch --name $FLY_APP_NAME --now --copy-config
 
 # Restore existing fly.toml
 mv .tmp/fly.toml fly.toml

scripts/deploy-fly.io-sqlite.sh

@@ -1,5 +1,16 @@
 #!/usr/bin/env bash
 
+# Get FLY_APP_NAME from command line arguments
+FLY_APP_NAME=$1
+
+# Display usage if no argument is provided
+if [ -z "$FLY_APP_NAME" ]; then
+    echo "Usage: $0 <app_name>"
+    exit 1
+fi
+
+# Set app name in project via script
+./scripts/set-fly-app-name.sh $FLY_APP_NAME
 
 # Specify the target fly.toml configuration file
 function specify_target_fly_toml() {
@@ -16,11 +27,16 @@ specify_target_fly_toml
 
 
 # Create app without launching
-yes n | fly launch --vm-memory 512 --ha=false --no-db --now --copy-config --build-only
+yes n | fly launch --name $FLY_APP_NAME --vm-memory 512 --ha=false --no-db --now --copy-config --build-only
 
 # Set database location
 flyctl secrets set DATABASE_URL=sqlite:////data/db.sqlite3
 
+# Set uploads location
+flyctl secrets set MEDIA_URL=https://${FLY_APP_NAME}.fly.dev/media/
+flyctl secrets set MEDIA_ROOT=/data/uploads
+flyctl secrets set USE_LOCAL_FILE_STORAGE=True
+
 # Use gsed on macOS
 SED_CMD="sed"
 if [[ "$OSTYPE" == "darwin"* ]]; then
@@ -35,9 +51,18 @@ $SED_CMD -i "s|^  release_command = 'python manage.py migrate --noinput'|#  rele
 
 
 # Launch app
-fly deploy
+fly deploy --config ./scripts/configs/fly-sqlite.toml
+
+# Wait for app to be ready
+echo "Waiting for app to be ready..."
+while ! curl -s -o /dev/null -w "%{http_code}" https://$FLY_APP_NAME.fly.dev; do
+    sleep 2
+done
+echo
+echo "App is ready!"
 
 # Run migrations
+echo "Running migrations..."
 fly ssh console -C 'python manage.py migrate'
 
 # Restore existing fly.toml

scripts/set-fly-app-name.sh

@@ -0,0 +1,14 @@
+#!/usr/bin/env bash
+
+# Get FLY_APP_NAME from command line arguments
+FLY_APP_NAME=$1
+
+# Display usage if no argument is provided
+if [ -z "$FLY_APP_NAME" ]; then
+    echo "Usage: $0 <app_name>"
+    exit 1
+fi
+
+# Set app name in project
+sed -i.bak "s/FLY_APP_NAME/$FLY_APP_NAME/g" server/config/settings.py
+find scripts/configs/ -type f -name "fly-*" -exec sed -i.bak "s/FLY_APP_NAME/$FLY_APP_NAME/g" {} +

server/config/settings.py

@@ -72,6 +72,7 @@
     ALLOWED_HOSTS = [
         '127.0.0.1',
         'localhost',
+        'FLY_APP_NAME.fly.dev',
         'webframework.fly.dev',
         'webframework.dev',
         'wut.sh',
@@ -295,6 +296,7 @@ def create_log_dir_for_server_errors():
     )
 
 CSRF_TRUSTED_ORIGINS = [
+    'https://FLY_APP_NAME.fly.dev',
     'https://webframework.fly.dev',
     'https://webframework.dev',
     'https://wut.sh',