技能 编程开发 部署 Claude API 至云环境

部署 Claude API 至云环境

v20260423
anth-deploy-integration
本技能指导用户如何将基于 Claude API 的服务安全、稳定地部署到生产云环境。内容涵盖Docker、GCP Cloud Run和Kubernetes部署流程,并提供了密钥管理、健康检查和回滚等最佳实践,确保服务的高可靠性和可维护性。
获取技能
494 次下载
概览

Anthropic Deploy Integration

Overview

Deploy Claude API integrations with proper secret management, health checks, and rollback procedures across Docker, GCP Cloud Run, and Kubernetes.

Docker Deployment

FROM python:3.12-slim
WORKDIR /app
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt
COPY src/ ./src/
ENV ANTHROPIC_API_KEY=""
EXPOSE 8000
CMD ["uvicorn", "src.main:app", "--host", "0.0.0.0", "--port", "8000"]
# src/main.py
from fastapi import FastAPI, HTTPException
import anthropic

app = FastAPI()
client = anthropic.Anthropic()

@app.get("/health")
async def health():
    try:
        count = client.messages.count_tokens(
            model="claude-haiku-4-20250514",
            messages=[{"role": "user", "content": "ping"}]
        )
        return {"status": "healthy", "api": "connected"}
    except Exception as e:
        raise HTTPException(503, detail=str(e))

GCP Cloud Run

echo -n "sk-ant-api03-..." | gcloud secrets create anthropic-key --data-file=-

gcloud run deploy claude-service \
  --image gcr.io/my-project/claude-service \
  --set-secrets ANTHROPIC_API_KEY=anthropic-key:latest \
  --min-instances 1 --max-instances 10 \
  --memory 512Mi --timeout 120s

Kubernetes

apiVersion: apps/v1
kind: Deployment
metadata: { name: claude-service }
spec:
  replicas: 3
  strategy: { type: RollingUpdate, rollingUpdate: { maxUnavailable: 1 } }
  template:
    spec:
      containers:
        - name: app
          env:
            - name: ANTHROPIC_API_KEY
              valueFrom:
                secretKeyRef: { name: anthropic-secrets, key: api-key }
          livenessProbe:
            httpGet: { path: /health, port: 8000 }
            periodSeconds: 30

Rollback

# Cloud Run
gcloud run services update-traffic claude-service --to-revisions=PREVIOUS=100

# Kubernetes
kubectl rollout undo deployment/claude-service

Error Handling

IssueCauseFix
Container crash on startMissing API key env varVerify secret binding
Health check failsKey invalid in prodTest key with curl
429 after scaling upMore replicas = more RPMShared rate limiter (Redis)

Resources

Next Steps

For event-driven patterns, see anth-webhooks-events.

信息
分类 编程开发
名称 anth-deploy-integration
版本 v20260423
大小 2.97KB
更新时间 2026-06-04
语言