# autoops

**Repository Path**: wei-jianmin/autoops

## Basic Information

- **Project Name**: autoops
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-19
- **Last Updated**: 2026-08-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AutoOps — Linux 自动化运维平台

轻量级 Linux 自动化运维中台（Phase 1 MVP 骨架）。

核心原则：**Python 沉淀业务、Go 突破性能**；执行引擎复用 Ansible。

## 文档

完整设计文档见 [`docs/00-README.md`](./docs/00-README.md)。

**部署与运维（实操）：**

- **服务器 + MySQL 逐步部署：** [`docs/DEPLOY-SERVER-MYSQL.md`](./docs/DEPLOY-SERVER-MYSQL.md) ← 推荐上线看这个
- 完整参考：[`docs/DEPLOY.md`](./docs/DEPLOY.md)

## 仓库结构

```text
autoops/
├── apps/
│   ├── api/          # FastAPI + Celery 任务定义（api/worker 同镜像不同入口）
│   ├── realtime/     # Go WebSocket 实时推送
│   ├── web/          # Vue3 控制台
│   ├── filexfer/     # Phase2 占位
│   ├── webssh/       # Phase3 占位
│   └── agent/        # Phase4 占位
├── deploy/
│   └── docker-compose.yml
├── docs/
├── scripts/
├── .env.example
├── Makefile
└── README.md
```

## 快速开始

### 前置

- Docker + Docker Compose
- 可选本地开发：Python 3.11+、Node 20+、Go 1.22+

### 1. 配置环境变量

```bash
cp .env.example .env
```

### 2. 启动基础设施 + 全部服务

```bash
make up
```

或：

```bash
docker compose -f deploy/docker-compose.yml --env-file .env up -d --build
```

### 使用 MySQL 作为业务库（可选）

默认业务库是 PostgreSQL。若要切换为 MySQL：

1. 在 `.env` 中设置（可选，overlay 已有默认值）：

```bash
DATABASE_URL=mysql+pymysql://autoops:autoops@mysql:3306/autoops?charset=utf8mb4
```

2. 启动：

```bash
docker compose -f deploy/docker-compose.yml -f deploy/docker-compose.mysql.yml --env-file .env --profile mysql up -d --build
```

本地进程直连 MySQL 时：

```bash
DATABASE_URL=mysql+pymysql://autoops:autoops@127.0.0.1:3306/autoops?charset=utf8mb4
```

> 同一套 Alembic 迁移同时支持 PostgreSQL / MySQL；通过 `DATABASE_URL` 协议切换（`postgresql+psycopg://` 或 `mysql+pymysql://`）。

### 3. 访问

| 服务 | 地址 |
|------|------|
| Web（Compose） | http://localhost:8080 |
| Web（Vite 本地） | http://localhost:5173 |
| API Docs | http://localhost:8000/docs |
| API Health | http://localhost:8000/healthz |
| Realtime Health | http://localhost:8001/healthz |

默认管理员（种子脚本创建）：

- 用户名：`admin`
- 密码：见 `.env` 中 `BOOTSTRAP_ADMIN_PASSWORD`（默认 `ChangeMe123!`）

### 常用命令

```bash
make down          # 停止
make logs          # 查看日志
make seed          # 初始化管理员
make api-shell     # 进入 api 容器
```

### 本地分服务开发

```bash
# 仅依赖
make infra

# API
cd apps/api && python -m venv .venv && .venv/Scripts/activate  # Windows
pip install -r requirements.txt
uvicorn app.main:app --reload --port 8000

# Worker（含监控采集队列）
celery -A app.celery_app.celery worker -Q autoops.exec,autoops.check,autoops.monitor -l info

# Beat（定时采集 / 定时任务）
celery -A app.celery_app.celery beat -l info

# Realtime
cd apps/realtime && go run ./cmd/realtime

# Web
cd apps/web && npm install && npm run dev
```

## Phase 1 范围

- 登录与管理员/用户
- 主机 / 分组 / 凭据
- 批量命令执行（Ansible SSH 真实执行）+ WebSocket 实时日志
- 主机连通性探测（Ansible ping）
- 执行历史与审计

详见 [`docs/13-mvp-phase1.md`](./docs/13-mvp-phase1.md)。

## 许可证

内部项目，未开源。