wehub-resource-sync
e071084ebe
govulncheck / govulncheck (push) Has been cancelled
Lint / golangci-lint (push) Has been cancelled
Run Tests / Unit Tests (push) Has been cancelled
Run Tests / Etcd Integration Tests (push) Has been cancelled
Harness (E2E) / Harnesses (mock LLM) (push) Has been cancelled
Harness (E2E) / Provider harnesses (live LLM conformance) (push) Has been cancelled
80 lines
1.8 KiB
Markdown
80 lines
1.8 KiB
Markdown
---
|
|
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.
|