告别脚手架：零代码从零到部署全指南——基于声明式API与云原生的工程化实践

# main.tf - 腾讯云资源声明
provider "tencentcloud" {
  region = "ap-shanghai"
}

# 创建PostgreSQL实例
resource "tencentcloud_postgresql_instance" "main" {
  name              = "zero-code-db"
  availability_zone = "ap-shanghai-2"
  charge_type       = "POSTPAID_BY_HOUR"
  vpc_id            = tencentcloud_vpc.main.id
  subnet_id         = tencentcloud_subnet.main.id
  engine_version    = "14.2"
  storage           = 100
  cpu               = 2
  memory            = 4
}

# 创建COS存储桶用于静态托管
resource "tencentcloud_cos_bucket" "static" {
  bucket = "zero-code-static-1234567890"
  acl    = "public-read"
  website {
    index_document = "index.html"
    error_document = "404.html"
  }
}

generator client {
  provider = "prisma-client-js"
}

datasource db {
  provider = "postgresql"
  url      = env("DATABASE_URL")
}

model Post {
  id        String   @id @default(cuid())
  title     String
  content   String
  published Boolean  @default(false)
  author    User     @relation(fields: [authorId], references: [id])
  authorId  String
  createdAt DateTime @default(now())
  updatedAt DateTime @updatedAt
}

model User {
  id    String @id @default(cuid())
  email String @unique
  name  String
  posts Post[]
}

# schema.graphql
type Post {
  id: ID!
  title: String!
  content: String!
  published: Boolean!
  author: User!
  createdAt: String!
  updatedAt: String!
}

type User {
  id: ID!
  email: String!
  name: String!
  posts: [Post!]!
}

input CreatePostInput {
  title: String!
  content: String!
  authorEmail: String!
}

type Mutation {
  createPost(input: CreatePostInput!): Post!
}

type Query {
  publishedPosts: [Post!]!
}

// src/resolvers.ts - 由工具链自动生成模板，开发者仅需填充业务逻辑（但此处可进一步通过装饰器绑定）
import { Resolver, Query, Mutation, Args } from '@nestjs/graphql';
import { PrismaService } from './prisma.service';
import { Post, CreatePostInput } from './graphql';

@Resolver()
export class AppResolver {
  constructor(private prisma: PrismaService) {}

  @Query()
  async publishedPosts() {
    return this.prisma.post.findMany({ where: { published: true } });
  }

  @Mutation()
  async createPost(@Args('input') input: CreatePostInput) {
    const { authorEmail, ...postData } = input;
    return this.prisma.post.create({
      data: {
        ...postData,
        author: { connect: { email: authorEmail } },
      },
    });
  }
}

// codegen.ts
import { CodegenConfig } from '@graphql-codegen/cli';

const config: CodegenConfig = {
  schema: './schema.graphql',
  documents: './src/**/*.graphql',
  generates: {
    './src/generated/graphql.tsx': {
      plugins: [
        'typescript',
        'typescript-operations',
        'typescript-react-apollo',
      ],
      config: {
        withHooks: true,
      },
    },
  },
};
export default config;

// src/pages/Home.graphql
query PublishedPosts {
  publishedPosts {
    id
    title
    content
    author { name }
  }
}

// src/pages/Home.tsx
import { usePublishedPostsQuery } from '../generated/graphql';

export const Home = () => {
  const { data, loading } = usePublishedPostsQuery();
  if (loading) return <div>Loading...</div>;
  return (
    <ul>
      {data?.publishedPosts.map(post => (
        <li key={post.id}>{post.title} - {post.author.name}</li>
      ))}
    </ul>
  );
};

# Dockerfile
FROM node:18-alpine AS builder
WORKDIR /app
COPY package*.json ./
RUN npm ci --only=production && npm cache clean --force
COPY . .
RUN npx prisma generate
RUN npm run build

FROM node:18-alpine
WORKDIR /app
COPY --from=builder /app/node_modules ./node_modules
COPY --from=builder /app/dist ./dist
COPY --from=builder /app/prisma ./prisma
EXPOSE 3000
CMD ["node", "dist/main"]

# deployment.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: zero-code-api
spec:
  replicas: 3
  selector:
    matchLabels:
      app: zero-code-api
  template:
    metadata:
      labels:
        app: zero-code-api
    spec:
      containers:
      - name: api
        image: ccr.ccs.tencentyun.com/zero-code/api:latest
        ports:
        - containerPort: 3000
        env:
        - name: DATABASE_URL
          valueFrom:
            secretKeyRef:
              name: db-secret
              key: url

# .github/workflows/deploy.yml
name: Deploy

on:
  push:
    branches: [ main ]

jobs:
  build-and-deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 18
      - run: npm ci
      - run: npm run build
      - run: npx prisma migrate deploy
      
      # 使用腾讯云官方Action构建并推送镜像
      - uses: tencentcloud/tencentcloud-actions/tcr-login@v1
        with:
          secret-id: ${{ secrets.SECRET_ID }}
          secret-key: ${{ secrets.SECRET_KEY }}
          region: ap-shanghai
      - run: docker build -t ccr.ccs.tencentyun.com/zero-code/api:${{ github.sha }} .
      - run: docker push ccr.ccs.tencentyun.com/zero-code/api:${{ github.sha }}
      
      # 使用Kubectl Action部署
      - uses: actions-hub/kubectl@master
        env:
          KUBE_CONFIG: ${{ secrets.KUBE_CONFIG }}
        with:
          args: set image deployment/zero-code-api api=ccr.ccs.tencentyun.com/zero-code/api:${{ github.sha }}

# serverless.yml
service: zero-code-api
provider:
  name: tencent
  runtime: Nodejs18.15
  memorySize: 512
  timeout: 10

plugins:
  - serverless-tencent-scf

functions:
  main:
    handler: dist/main.handler
    events:
      - apigw:
          name: zero-code-gw
          parameters:
            protocols:
              - http
              - https

import { InputType, Field } from '@nestjs/graphql';
import { IsEmail, IsNotEmpty, MinLength } from 'class-validator';

@InputType()
export class CreatePostInput {
  @Field()
  @IsNotEmpty()
  title: string;

  @Field()
  @MinLength(10)
  content: string;

  @Field()
  @IsEmail()
  authorEmail: string;
}

directive @auth on FIELD_DEFINITION

type Mutation {
  createPost(input: CreatePostInput!): Post! @auth
}

// main.ts 启动时注入
const { NodeTracerProvider } = require('@opentelemetry/sdk-trace-node');
const provider = new NodeTracerProvider();
provider.register();

apiVersion: cls.cloud.tencent.com/v1
kind: LogConfig
metadata:
  name: api-log-config
spec:
  inputDetail:
    type: container_file
    containerFile:
      namespace: default
      container: api
      logPath: /var/log/app
  outputDetail:
    topicId: xxxxxx