alexfalkowski/k8s

镜像概述

本镜像为专用于Kubernetes（K8s）集群环境的基础容器镜像，旨在简化容器化应用在K8s集群中的部署与运行。它基于轻量级操作系统（如Alpine Linux）构建，集成了K8s环境下应用运行所需的核心依赖库、配置工具及兼容性组件，确保应用能够无缝适配K8s的服务发现、配置管理、存储挂载等机制。

核心功能和特性

1. 轻量级基础环境

• 基于Alpine Linux构建，镜像体积小（通常<100MB），启动速度快，资源占用低。
• 预安装基础系统工具（如curl、wget、bash）及常用依赖库（如libc6-compat），满足多数应用运行需求。

2. K8s环境兼容性

• 内置K8s API客户端基础依赖，支持应用通过K8s API获取集群信息（如节点、服务、配置项等）。
• 兼容K8s的ConfigMap、Secret挂载机制，可直接读取集群内配置数据。
• 支持K8s的livenessProbe、readinessProbe健康检查配置，便于集群管理应用生命周期。

3. 配置灵活性

• 支持通过环境变量、命令行参数或配置文件自定义应用运行参数。
• 提供基础的日志输出规范，适配K8s的日志收集机制（如ELK、Promtail）。

使用场景

• 微服务部署：作为微服务应用的基础镜像，在K8s集群中部署API服务、中间件客户端等组件。
• 集群内工具运行：用于运行K8s集群内的辅助工具（如数据同步脚本、监控代理、配置巡检工具等）。
• 应用开发测试：在本地开发环境模拟K8s运行条件，验证应用容器化后的兼容性。

使用方法和配置说明

基本使用（docker run）

直接基于本镜像运行容器（需提前配置K8s集群访问上下文，或在集群内使用）：

bash
docker run -d \
  --name k8s-app-demo \
  -e APP_PORT=8080 \
  -e K8S_NAMESPACE=default \
  your-registry/k8s-image:latest

K8s集群内部署（yaml示例）

创建Deployment资源部署应用：

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: k8s-app-demo
  namespace: default
spec:
  replicas: 3
  selector:
    matchLabels:
      app: k8s-app-demo
  template:
    metadata:
      labels:
        app: k8s-app-demo
    spec:
      containers:
      - name: app
        image: your-registry/k8s-image:latest
        ports:
        - containerPort: 8080
        env:
        - name: APP_PORT
          value: "8080"
        - name: K8S_NAMESPACE
          valueFrom:
            fieldRef:
              fieldPath: metadata.namespace
        livenessProbe:
          httpGet:
            path: /health
            port: 8080
          initialDelaySeconds: 10
          periodSeconds: 5
        readinessProbe:
          httpGet:
            path: /ready
            port: 8080
          initialDelaySeconds: 5
          periodSeconds: 3

环境变量配置

持久化与配置挂载

通过K8s的ConfigMap和Secret挂载配置文件：

yaml
# 示例：挂载ConfigMap和Secret到容器
spec:
  containers:
  - name: app
    image: your-registry/k8s-image:latest
    volumeMounts:
    - name: app-config
      mountPath: /app/config
    - name: app-secret
      mountPath: /app/secret
      readOnly: true
  volumes:
  - name: app-config
    configMap:
      name: app-configmap  # 提前创建的ConfigMap
  - name: app-secret
    secret:
      secretName: app-secret  # 提前创建的Secret

注意事项

• 本镜像为基础镜像，实际应用部署时需基于此镜像构建业务镜像（通过Dockerfile的FROM指令）。
• 在K8s集群外运行时，部分依赖K8s API的功能可能无法正常工作，建议优先在集群内使用。
• 根据应用需求，可通过docker exec或K8s的exec命令进入容器调试，或通过kubectl logs查看应用日志。