Merge pull request #83 from edgeengineer/jo/run-dockerfile

Add the ability to run Dockerfile based containers (non-Swift!)

Author: Joannis

Examples/HelloPython/.dockerignore

@@ -0,0 +1,29 @@
+# Git
+.git
+.gitignore
+
+# Documentation
+README.md
+*.md
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db

Examples/HelloPython/Dockerfile

@@ -0,0 +1,32 @@
+# Use Python 3.11 slim image as base
+FROM python:3.11-slim
+
+# Set working directory
+WORKDIR /app
+
+# Copy requirements first for better caching
+COPY requirements.txt .
+
+# Install dependencies (none in this case, but good practice)
+RUN pip install --no-cache-dir -r requirements.txt
+
+# Copy application code
+COPY app.py .
+
+# Create a non-root user for security
+RUN useradd --create-home --shell /bin/bash app && \
+    chown -R app:app /app
+USER app
+
+# Expose port 8080
+EXPOSE 8080
+
+# Set environment variable for port
+ENV PORT=8080
+
+# Health check
+HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \
+    CMD python -c "import urllib.request; urllib.request.urlopen('http://localhost:8080/health')"
+
+# Run the application
+CMD ["python", "app.py"]

Examples/HelloPython/README.md

@@ -0,0 +1,108 @@
+# Hello World Python HTTP Server
+
+A simple Python HTTP server with Docker support for easy deployment.
+
+## Features
+
+- Simple HTTP server using Python's built-in `http.server` module
+- Multiple endpoints:
+  - `GET /` - HTML Hello World page
+  - `GET /api/hello` - JSON API response
+  - `GET /health` - Health check endpoint
+  - `POST /api/echo` - Echo back posted data
+- Dockerized for easy deployment
+- Health check included
+- Non-root user for security
+
+## Quick Start
+
+### Run Locally
+
+```bash
+# Run the server directly
+python app.py
+
+# Or with custom port
+PORT=3000 python app.py
+```
+
+Visit `http://localhost:8000` to see the Hello World page.
+
+### Run with Docker
+
+```bash
+# Build the Docker image
+docker build -t hello-python-server .
+
+# Run the container
+docker run -p 8000:8000 hello-python-server
+
+# Or run in background
+docker run -d -p 8000:8000 --name hello-server hello-python-server
+```
+
+### Test the Endpoints
+
+```bash
+# HTML page
+curl http://localhost:8000/
+
+# JSON API
+curl http://localhost:8000/api/hello
+
+# Health check
+curl http://localhost:8000/health
+
+# Echo endpoint
+curl -X POST http://localhost:8000/api/echo -d "Hello from curl"
+```
+
+## Deployment Options
+
+### Docker Hub
+
+```bash
+# Tag for Docker Hub
+docker tag hello-python-server yourusername/hello-python-server
+
+# Push to Docker Hub
+docker push yourusername/hello-python-server
+
+# Run from Docker Hub
+docker run -p 8000:8000 yourusername/hello-python-server
+```
+
+### Cloud Platforms
+
+This containerized application can be deployed to:
+- AWS ECS/Fargate
+- Google Cloud Run
+- Azure Container Instances
+- Kubernetes
+- Heroku (with container stack)
+- DigitalOcean App Platform
+
+### Environment Variables
+
+- `PORT`: Server port (default: 8000)
+
+## File Structure
+
+```
+.
+├── app.py              # Main Python server
+├── requirements.txt    # Python dependencies (none required)
+├── Dockerfile         # Docker configuration
+├── .dockerignore      # Docker ignore file
+└── README.md          # This file
+```
+
+## Development
+
+The server uses Python's built-in HTTP server, so no external dependencies are required. The code is simple and easy to modify for your needs.
+
+## Security Notes
+
+- The Docker container runs as a non-root user
+- Only necessary files are copied to the container
+- Health checks are included for monitoring

Examples/HelloPython/app.py

@@ -0,0 +1,133 @@
+#!/usr/bin/env python3
+"""
+Simple Hello World Python HTTP Server
+"""
+
+from http.server import HTTPServer, BaseHTTPRequestHandler
+import json
+import os
+
+class HelloWorldHandler(BaseHTTPRequestHandler):
+    def do_GET(self):
+        if self.path == '/':
+            self.send_response(200)
+            self.send_header('Content-type', 'text/html')
+            self.end_headers()
+            
+            html_content = """
+            <!DOCTYPE html charset="utf-8">
+            <html lang="en">
+            <head>
+                <title>Hello World Server</title>
+                <style>
+                    body { 
+                        font-family: Arial, sans-serif; 
+                        max-width: 800px; 
+                        margin: 50px auto; 
+                        padding: 20px;
+                        background-color: #f5f5f5;
+                    }
+                    .container {
+                        background-color: white;
+                        padding: 30px;
+                        border-radius: 10px;
+                        box-shadow: 0 2px 10px rgba(0,0,0,0.1);
+                        text-align: center;
+                    }
+                    h1 { color: #333; }
+                    .status { color: #28a745; font-weight: bold; }
+                </style>
+            </head>
+            <body>
+                <div class="container">
+                    <h1>Hello World! 🌍</h1>
+                    <p class="status">Server is running successfully!</p>
+                    <p>This is a simple Python HTTP server running in a Docker container.</p>
+                </div>
+            </body>
+            </html>
+            """
+            self.wfile.write(html_content.encode())
+            
+        elif self.path == '/api/hello':
+            self.send_response(200)
+            self.send_header('Content-type', 'application/json')
+            self.end_headers()
+            
+            response = {
+                "message": "Hello World!",
+                "status": "success",
+                "server": "Python HTTP Server"
+            }
+            self.wfile.write(json.dumps(response, indent=2).encode())
+            
+        elif self.path == '/health':
+            self.send_response(200)
+            self.send_header('Content-type', 'application/json')
+            self.end_headers()
+            
+            health_response = {
+                "status": "healthy",
+                "message": "Server is running"
+            }
+            self.wfile.write(json.dumps(health_response).encode())
+            
+        else:
+            self.send_response(404)
+            self.send_header('Content-type', 'application/json')
+            self.end_headers()
+            
+            error_response = {
+                "error": "Not Found",
+                "message": f"Path {self.path} not found"
+            }
+            self.wfile.write(json.dumps(error_response).encode())
+
+    def do_POST(self):
+        if self.path == '/api/echo':
+            content_length = int(self.headers['Content-Length'])
+            post_data = self.rfile.read(content_length)
+            
+            self.send_response(200)
+            self.send_header('Content-type', 'application/json')
+            self.end_headers()
+            
+            response = {
+                "message": "Echo endpoint",
+                "received_data": post_data.decode('utf-8'),
+                "status": "success"
+            }
+            self.wfile.write(json.dumps(response, indent=2).encode())
+        else:
+            self.send_response(404)
+            self.send_header('Content-type', 'application/json')
+            self.end_headers()
+            
+            error_response = {
+                "error": "Not Found",
+                "message": f"POST endpoint {self.path} not found"
+            }
+            self.wfile.write(json.dumps(error_response).encode())
+
+    def log_message(self, format, *args):
+        print(f"[{self.date_time_string()}] {format % args}")
+
+def run_server(port=8000):
+    server_address = ('', port)
+    httpd = HTTPServer(server_address, HelloWorldHandler)
+    print(f"Server running on port {port}")
+    print(f"Visit http://localhost:{port} to see the Hello World page")
+    print(f"API endpoints available:")
+    print(f"  GET  /api/hello - JSON hello message")
+    print(f"  GET  /health - Health check")
+    print(f"  POST /api/echo - Echo back posted data")
+    
+    try:
+        httpd.serve_forever()
+    except KeyboardInterrupt:
+        print("\nShutting down server...")
+        httpd.shutdown()
+
+if __name__ == '__main__':
+    port = int(os.environ.get('PORT', 8000))
+    run_server(port)

Examples/HelloPython/edge.json

@@ -0,0 +1,10 @@
+{
+    "appId": "engineer.edge.examples.hellopython",
+    "version": "1.0.0",
+    "entitlements": [
+        {
+            "type": "network",
+            "mode": "host"
+        }
+    ]
+}

Examples/HelloPython/requirements.txt

@@ -0,0 +1,2 @@
+# No external dependencies required for this simple server
+# Using only Python standard library modules