docs: Add 6 and update 11 files

logserver/generate-api-key.sh

@@ -3,7 +3,45 @@
 # Interactive API Key Generation Script for LogServer
 # This script generates secure API keys and adds them to api-keys.yml
 
-API_KEYS_FILE="${CONFIG_PATH:-./config}/api-keys.yml"
+# Determine where to put the api-keys.yml file
+determine_api_keys_location() {
+    # 1. If api-keys.yml already exists in current folder, use it
+    if [ -f "./api-keys.yml" ]; then
+        echo "./api-keys.yml"
+        return 0
+    fi
+
+    # 2. If service.env exists in current folder, put keys here
+    if [ -f "./service.env" ]; then
+        echo "./api-keys.yml"
+        return 0
+    fi
+
+    # 3. If config folder exists, put keys there
+    if [ -d "./config" ]; then
+        echo "./config/api-keys.yml"
+        return 0
+    fi
+
+    # No valid location found
+    return 1
+}
+
+# Try to determine location
+if API_KEYS_FILE=$(determine_api_keys_location); then
+    : # Location found, continue
+else
+    echo -e "${RED}Error: Cannot determine where to place api-keys.yml${NC}"
+    echo ""
+    echo "This script must be run from one of these locations:"
+    echo "  1. A deployed service directory (contains service.env)"
+    echo "  2. The logserver template directory (contains config/ folder)"
+    echo "  3. A directory with existing api-keys.yml file"
+    echo ""
+    echo "Current directory: $(pwd)"
+    echo "Contents: $(ls -la 2>/dev/null | head -5)"
+    exit 1
+fi
 
 # Colors for output
 RED='\033[0;31m'
@@ -19,12 +57,21 @@ generate_key() {
 # Initialize api-keys.yml if it doesn't exist
 init_api_keys_file() {
     if [ ! -f "$API_KEYS_FILE" ]; then
+        # Create directory if needed
+        local dir=$(dirname "$API_KEYS_FILE")
+        if [ ! -d "$dir" ]; then
+            mkdir -p "$dir"
+            echo -e "${GREEN}Created directory: $dir${NC}"
+        fi
+
         echo "# API Keys for LogServer Authentication" > "$API_KEYS_FILE"
         echo "# Format: hostname:api_key" >> "$API_KEYS_FILE"
         echo "# Generated by generate-api-key.sh" >> "$API_KEYS_FILE"
         echo "" >> "$API_KEYS_FILE"
         echo "api_keys:" >> "$API_KEYS_FILE"
-        echo -e "${GREEN}Created new api-keys.yml file${NC}"
+        echo -e "${GREEN}Created new api-keys.yml file at: $API_KEYS_FILE${NC}"
+    else
+        echo -e "${GREEN}Using existing api-keys.yml at: $API_KEYS_FILE${NC}"
     fi
 }
 
@@ -112,5 +159,14 @@ echo ""
 echo "To view all keys: cat $API_KEYS_FILE"
 echo "To revoke a key: Edit $API_KEYS_FILE and remove the line"
 echo ""
-echo -e "${YELLOW}Remember to restart logserver after adding keys:${NC}"
-echo "  dropshell restart logserver"
+
+# Show location-specific restart instructions
+if [[ "$API_KEYS_FILE" == "./api-keys.yml" ]] && [ -f "./service.env" ]; then
+    # We're in a deployed service directory
+    echo -e "${YELLOW}Remember to restart the service to apply changes:${NC}"
+    echo "  dropshell restart logserver"
+else
+    # We're in the template directory
+    echo -e "${YELLOW}Note: Deploy this template to use these keys:${NC}"
+    echo "  dropshell install logserver"
+fi