d10s0vsky/sld-api

Stack-Lifecycle-Deployment 镜像文档

1. 镜像概述

Stack-Lifecycle-Deployment是一个开源的云资源生命周期管理解决方案，用于定义和管理云环境中所使用和配置的资源的完整生命周期。项目开源地址：https://github.com/D10S0VSkY-OSS/Stack-Lifecycle-Deployment%E3%80%82

2. 核心功能与特性

• 完整生命周期管理：定义并管理云资源从创建、部署到维护的完整生命周期
• 灵活配置支持：通过环境变量进行多维度参数配置，适应不同部署场景
• 安全加密机制：支持自定义加密密钥和算法，保障敏感信息安全
• 部署策略控制：可配置部署超时、重试次数及回滚策略，提升系统可靠性
• 多组件集成：支持数据库（SQLAlchemy）、Redis、Git仓库等外部组件集成
• API服务支持：提供后端API服务，支持资源生命周期的程序化管理

3. 使用场景与适用范围

• 云资源的自动化部署与全生命周期管理
• 需要统一管理多环境云资源的企业或团队
• 对部署可靠性有要求，需配置超时、重试等策略的场景
• 开源项目或内部系统中云资源的标准化管理需求

4. 配置参数说明

后端API服务支持通过以下环境变量进行配置：

5. 使用方法与部署示例

5.1 Kubernetes部署示例

5.1.1 Deployment配置

以下是Kubernetes部署后端API服务的示例配置（可根据实际情况修改镜像版本或通过kustomization.yaml管理）：

yaml
kind: Deployment
metadata:
  name: api-backend
  labels:
    name: api-backend
spec:
  replicas: 2  # 副本数
  selector:
    matchLabels:
      name: api-backend
  template:
    metadata:
      labels:
        name: api-backend
    spec:
      topologySpreadConstraints:
      - maxSkew: 1
        topologyKey: kubernetes.io/hostname
        whenUnsatisfiable: DoNotSchedule
        labelSelector:
          matchLabels:
            name: api-backend
      subdomain: primary
      containers:
        - name: api-backend
          image: d10s0vsky/sld-api:2.1.1  # 镜像地址及版本
          imagePullPolicy: Always  # 总是拉取最新镜像
          command: ["python3", "-m", "uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8000", "--workers", "1"]  # 启动命令
          ports:
            - containerPort: 8000  # 容器暴露端口
          livenessProbe:  # 存活探针配置
            httpGet:
              path: /api/v1/
              port: 8000
              httpHeaders:
              - name: status
                value: healthy
            initialDelaySeconds: 60  # 初始延迟探测时间（秒）
            periodSeconds: 60  # 探测周期（秒）
          env:  # 环境变量配置（示例中从Secret获取，需提前创建对应Secret）
          - name: SQLALCHEMY_DATABASE_URL
            valueFrom:
              secretKeyRef:
                name: db-secret
                key: .db-secret
          - name: BROKER_USER
            valueFrom:
              secretKeyRef:
                name: rabbitmq-secret
                key: .rabbitmq-username
          - name: BROKER_PASSWD
            valueFrom:
              secretKeyRef:
                name: rabbitmq-secret
                key: .rabbitmq-password
          resources:  # 资源限制配置
            limits:
              memory: 800Mi
              cpu: 1
            requests:
              memory: 300Mi
              cpu: 100m

5.1.2 Service配置

以下是用于暴露Deployment的Service配置：

yaml
apiVersion: v1
kind: Service
metadata:
  name: api-backend
spec:
  selector:
    name: api-backend  # 匹配Deployment标签
  ports:
    - name: http-api
      port: 8000  # 服务端口
      targetPort: 8000  # 目标容器端口