chore: import upstream snapshot with attribution

internal/website/docs/guides/deployment.md

@@ -0,0 +1,79 @@
+---
+layout: default
+---
+
+# Deployment Guide
+
+This is a quick reference for deploying go-micro services. For the full guide, see the [Deployment documentation](../deployment.md).
+
+## Workflow
+
+```
+micro run      →  Develop locally with hot reload
+micro build    →  Compile production binaries
+micro deploy   →  Push to a remote Linux server via SSH + systemd
+micro server   →  Optional: production web dashboard with auth
+```
+
+## Quick Start
+
+```bash
+# Build binaries for Linux
+micro build --os linux
+
+# Deploy to server (builds automatically if needed)
+micro deploy user@your-server
+```
+
+## First-Time Server Setup
+
+On your server (any Linux with systemd):
+
+```bash
+curl -fsSL https://go-micro.dev/install.sh | sh
+sudo micro init --server
+```
+
+This creates `/opt/micro/{bin,data,config}` and a systemd template for managing services.
+
+## Deploy
+
+```bash
+micro deploy user@your-server
+```
+
+This builds for linux/amd64, copies binaries to `/opt/micro/bin/`, configures systemd services, and verifies they're running.
+
+### Named Targets
+
+Add deploy targets to `micro.mu`:
+
+```
+deploy prod
+    ssh deploy@prod.example.com
+
+deploy staging
+    ssh deploy@staging.example.com
+```
+
+Then: `micro deploy prod`
+
+## Managing Services
+
+```bash
+micro status --remote user@server       # Check status
+micro logs --remote user@server         # View logs
+micro logs myservice --remote user@server -f  # Follow logs
+```
+
+## Docker (Optional)
+
+```bash
+micro build --docker          # Build Docker images
+micro build --docker --push   # Build and push
+micro build --compose         # Generate docker-compose.yml
+```
+
+## Full Documentation
+
+See the [Deployment documentation](../deployment.md) for complete details including SSH setup, environment variables, security best practices, and troubleshooting.