基础设施自动化工具

ShipMe.dev 是一个通过GitHub Codespaces提供基础设施自动化的工具,包括预配置的开发环境、数据库管理、托管部署和AI驱动的DevOps助手。

  • by chakrasutras-dev
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 chakrasutras-dev/shipme_template

使用说明

ShipMe入门模板

这是一个用于创建项目的模板存储库 ShipMe.dev -通过GitHub Codespace实现自动化基础设施配置。

里面有什么

此模板包括:

  • GitHub代码空间配置 -预配置的开发环境
  • MCP(模型上下文协议)服务器 -基础设施自动化工具
    • GitHub MCP-存储库管理
    • Supabase MCP-数据库和身份验证
    • Netlify MCP-托管和部署
  • Claude代码集成 -AI驱动的DevOps助手
  • 项目配置 -您在中的项目设置 .shipme/project.json

快速开始

1.在代码空间中打开

点击绿色的“代码”按钮→ “代码空间”→ “在main上创建代码空间”

或者使用此直接链接格式:

https://github.com/codespaces/new?repo=YOUR_REPO_ID

2.等待安装(2-3分钟)

代码空间将自动:

  • 安装Node.js和依赖项
  • 构建MCP服务器
  • 使用基础设施工具设置Claude代码
  • 显示设置完成消息

3.验证服务

# Authenticate GitHub CLI
gh auth login

# Add Supabase & Netlify tokens as Codespace secrets:
# Settings → Secrets → New secret
# - SUPABASE_ACCESS_TOKEN (from https://supabase.com/dashboard/account/tokens)
# - NETLIFY_AUTH_TOKEN (from https://app.netlify.com/user/applications)

4.开始配置

在终端中,让Claude Code配置您的基础设施:

@claude Read my project configuration and provision the infrastructure

克劳德将:

  • 创建您的Supabase数据库
  • 运行数据库迁移
  • 配置身份验证(如果需要)
  • 部署到Netlify
  • 设置所有环境变量

什么被配置

基于中的堆栈配置 .shipme/project.json:

数据库(Supabase)

  • PostgreSQL数据库
  • 自动生成REST API
  • 实时订阅
  • 身份验证系统
  • 行级安全(RLS)策略

主机(Netlify)

  • CDN部署
  • 自动HTTPS
  • 环境变量
  • 从Git持续部署

身份验证(可选)

  • GitHub OAuth
  • 谷歌OAuth
  • 电子邮件/密码
  • 魔术链接

项目结构

.
├── .devcontainer/
│   ├── devcontainer.json       # Codespace configuration
│   └── post-create.sh          # Setup script
├── .shipme/
│   ├── project.json            # Your project config (auto-generated)
│   └── claude-instructions.md  # Instructions for Claude Code
├── mcp-servers/                # Infrastructure automation tools
│   ├── github/                 # GitHub operations
│   ├── supabase/               # Database operations
│   ├── netlify/                # Deployment operations
│   └── shared/                 # Shared utilities
├── src/                        # Your application code (add your framework here)
└── README.md                   # This file

添加您的应用程序代码

这是一个模板-添加你的Next.js、React或其他框架代码:

# For Next.js:
npx create-next-app@latest . --typescript --tailwind --app

# For Vite + React:
npm create vite@latest . -- --template react-ts

# Or copy your existing code

确保更新 package.json 使用适当的构建脚本:

  • npm run build -应生成生产构建
  • npm start -应启动生产服务器

手动步骤

有些步骤需要手动操作:

GitHub OAuth应用程序(如果使用GitHub auth)

  1. 访问https://github.com/settings/developers
  2. 点击“新建OAuth应用程序”
  3. 设置:
    • 主页网址:您的Netlify URL
    • 回调URL: https://YOUR_PROJECT.supabase.co/auth/v1/callback
  4. 在Claude提示时复制客户端ID和密码

自定义域(可选)

  1. 在Netlify仪表板中添加域
  2. 更新DNS记录
  3. 更新OAuth回调URL

环境变量

Claude在Netlify中自动配置这些:

# Supabase (auto-configured)
NEXT_PUBLIC_SUPABASE_URL=https://xxx.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=eyJhbG...
SUPABASE_SERVICE_ROLE_KEY=eyJhbG...

# Authentication (if configured)
GITHUB_ID=your_client_id
GITHUB_SECRET=your_client_secret

# Security
NEXTAUTH_SECRET=auto_generated_random_string

故障排除

“未找到MCP服务器”

运行: cd mcp-servers && npm run build

“身份验证失败”

  • 检查令牌是否设置为代码空间机密
  • 验证令牌是否未过期
  • 跑 gh auth status 检查GitHub身份验证

“Supabase项目创建缓慢”

  • 正常-配置需要30-60秒
  • 克劳德会自动等待

“未设置某些环境变量”

  • 有些人可能会在Netlify上默默地失败
  • 在Netlify仪表板中手动验证:站点设置→ 环境变量

配置期间会发生什么

克劳德代码将:

  1. 读取配置 -了解您的项目要求
  2. 创建Supabase项目 -约1-2分钟
  3. 运行迁移 -设置数据库架构(约10秒)
  4. 配置身份验证 -设置OAuth提供程序(手动步骤)
  5. 构建应用程序 -创建生产构建(约30-60秒)
  6. 创建Netlify网站 -设置主机(约10秒)
  7. 设置环境变量 -配置所有机密(约20秒)
  8. 部署 -投入生产(约2-5分钟)

总时间:8-15分钟

建筑

GitHub Codespace
    ↓
Claude Code (AI orchestrator)
    ↓
MCP Servers (infrastructure tools)
    ↓
Cloud Services (Supabase, Netlify, etc.)
    ↓
Your Application (LIVE!)

支持

  • ShipMe文档: https://shipme.dev/docs
  • MCP协议: https://modelcontextprotocol.io
  • 问题: https://github.com/YOUR_ORG/shipme.dev/issues

由...创建

此项目是通过以下方式创建的 ShipMe.dev -借助人工智能驱动的基础设施自动化,运输速度更快。

许可证

你的代码,你的许可证。ShipMe基础设施代码获得了麻省理工学院的许可。