Shell脚本如何配置容器定时任务

wen 实用脚本 2026-07-17 1

Shell脚本配置容器定时任务：从入门到生产级实践指南

📖 目录导读

为什么需要容器定时任务
核心方案对比：Cron vs 容器调度器
基于宿主机的Cron调度实战
容器内嵌Cron任务配置详解
Kubernetes CronJob企业级配置
Shell脚本编写最佳实践
日志与异常处理机制
常见问题FAQ

为什么需要容器定时任务

在微服务架构中，容器化应用需要周期性执行的任务包括：数据备份、日志轮转、缓存清理、报告生成等，传统方式在宿主机配置crontab，但容器化后任务需要与容器生命周期耦合,且需考虑以下痛点：

Shell脚本如何配置容器定时任务

环境一致性：容器内路径、二进制文件与宿主机不同
资源隔离：避免单任务耗尽容器资源
可观测性：任务失败时需告警与重试
动态扩容：自动扩缩容时任务调度需同步

问答环节：
Q：为什么不在容器内直接使用cron？
A：可以，但需注意容器内通常是单进程模型，直接运行cron守护进程会占用主进程，且日志收集、健康检查需额外设计。

核心方案对比：Cron vs 容器调度器

方案	适用场景	复杂度
宿主Cron + docker exec	少量容器，快速实现	低（依赖宿主机）
容器内Cron进程	单任务容器	中（需Dockerfile技巧）
Kubernetes CronJob	生产级大规模调度	高（云原生标准）

基于宿主机的Cron调度实战

1 基础示例

# 编辑当前用户crontab
crontab -e
# 每天凌晨2点执行备份脚本
0 2 * * * docker exec mysql-container mysqldump -u root -p secret db_name > /backup/db_$(date +%Y%m%d).sql

2 进阶：使用Shell包装器脚本

创建docker_task_runner.sh：

#!/bin/bash
CONTAINER_NAME=$1
SCRIPT_PATH=$2
LOG_FILE="/var/log/cron_${CONTAINER_NAME}.log"
# 检查容器状态
if docker ps --format '{{.Names}}' | grep -q "^${CONTAINER_NAME}$"; then
    docker exec "$CONTAINER_NAME" bash "$SCRIPT_PATH" >> "$LOG_FILE" 2>&1
    echo "[$(date)] Task completed" >> "$LOG_FILE"
else
    echo "[$(date)] ERROR: Container $CONTAINER_NAME not running" >> "$LOG_FILE"
    exit 1
fi

crontab配置：

30 3 * * * /scripts/docker_task_runner.sh app-container /app/cleanup.sh

容器内嵌Cron任务配置详解

1 Dockerfile集成方案

FROM alpine:latest
# 安装cron服务
RUN apk add --no-cache dcron bash
# 添加crontab文件
COPY crontab /var/spool/cron/crontabs/root
RUN chmod 0644 /var/spool/cron/crontabs/root
# 任务脚本
COPY backup.sh /app/backup.sh
RUN chmod +x /app/backup.sh
# 启动cron守护进程（非主进程方式）
CMD ["crond", "-f", "-l", "2"]

2 容器内Crontab文件示例

# 每小时第5分钟清理临时文件
5 * * * * /app/cleanup.sh
# 每天0点归档日志
0 0 * * * /app/log_rotate.sh >> /var/log/task.log 2>&1

3 环境变量传递技巧

Shell脚本中通过env命令查看容器环境变量：

#!/bin/bash
source /app/config.env  # 加载环境文件
export PATH=$PATH:/custom/bin
# 执行核心业务逻辑...

Kubernetes CronJob企业级配置

1 YAML定义示例

apiVersion: batch/v1
kind: CronJob
metadata:
  name: data-cleanup
spec:
  schedule: "0 0 */3 * *"  # 每3天凌晨执行
  jobTemplate:
    spec:
      template:
        spec:
          containers:
          - name: cleanup
            image: registry.example.com/tools:1.2
            imagePullPolicy: IfNotPresent
            command:
            - /bin/bash
            - -c
            - "/app/cleanup.sh --force --retention=7"
            env:
            - name: DB_HOST
              value: "mysql-svc"
            - name: LOG_LEVEL
              value: "DEBUG"
            resources:
              requests:
                memory: "128Mi"
                cpu: "100m"
              limits:
                memory: "256Mi"
                cpu: "200m"
          restartPolicy: OnFailure
  successfulJobsHistoryLimit: 3
  failedJobsHistoryLimit: 1
  concurrencyPolicy: Forbid  # 禁止并发执行

2 关键配置参数说明

schedule：标准Cron表达式（支持时区偏移通过spec.timeZone）
startingDeadlineSeconds：任务启动超时时间（如：120秒）
backoffLimit：失败重试次数（默认6次）
concurrencyPolicy：Allow/Forbid/Replace（并发策略）

Shell脚本编写最佳实践

1 脚本骨架模板

#!/bin/bash
set -euo pipefail  # 严格模式：出错即停止、未定义变量报错、管道中断
# 日志函数
log() {
    local level=$1
    shift
    echo "[$(date '+%Y-%m-%d %H:%M:%S')] [${level}] $*"
}
# 健康检查
health_check() {
    if ! curl -s host:port/health > /dev/null 2>&1; then
        log ERROR "依赖服务不可用"
        exit 2
    fi
}
# 主逻辑
main() {
    log INFO "开始执行任务: $0"
    health_check
    # 业务代码
    log INFO "任务完成"
}
# 捕获信号
trap 'log ERROR "收到中断信号，清理临时文件"; rm -f /tmp/*.tmp' EXIT SIGINT SIGTERM
main "$@"

2 幂等性设计

# 使用锁文件防止重复执行
LOCKFILE="/var/run/cron_task.lock"
if ! mkdir "$LOCKFILE" 2>/dev/null; then
    log WARN "任务已在运行，跳过"
    exit 0
fi
trap "rmdir $LOCKFILE" EXIT

日志与异常处理机制

1 结构化日志输出

# JSON格式日志便于ELK收集
echo "{\"timestamp\":\"$(date -Iseconds)\",\"level\":\"ERROR\",\"message\":\"数据库连接失败\"}"

2 退出码规范

0: 成功
1: 一般错误（可重试）
2: 环境错误（不可重试）
3: 超时
4: 权限不足

3 告警集成

# 失败时发送企业微信通知
if [ $? -ne 0 ]; then
    curl -s "weixin.example.com/cgi-bin/message/send?access_token=XXX" \
        -H "Content-Type: application/json" \
        -d "{\"msgtype\":\"text\",\"text\":{\"content\":\"容器定时任务失败: $(hostname)\"}}"
fi

常见问题FAQ

Q1：容器内Cron服务不启动怎么办？

A：检查是否缺少dcron或cronie包，以及/var/spool/cron/crontabs/目录权限，可通过crond -l 2 -f在前台运行调试。

Q2：CronJob在K8s中不执行？

A：检查以下三点：

kubectl get cronjob确认CronJob对象存在
kubectl describe cronjob <name>查看Events是否有调度错误
检查Pod是否因资源不足Pending

Q3：如何测试Cron表达式？

A：使用在线工具如crontab.guru，或本地date -d "2024-12-01 03:00:00"配合验证。

Q4：容器内无法加载环境变量？

A：确保容器启动时通过--env-file或Dockerfile的ENV传入，在脚本中显式加载：

export $(cat /proc/1/environ | tr '\0' '\n')

Q5：任务日志如何持久化？

A：三种方案：

挂载宿主机目录：-v /data/logs:/var/log
输出到stdout配合Docker日志驱动
直接写入共享存储（NFS/S3）

通过本文的实践指南，你可以根据实际场景选择最合适的容器定时任务方案：

快速原型：宿主机Cron + docker exec
单容器稳定运行：容器内嵌Cron守护进程
生产级云原生：Kubernetes CronJob + Shell脚本最佳实践

关键要点包括：幂等性设计、严格模式脚本、结构化日志、退出码规范、告警集成，建议从简单方案起步，逐步向自动化、可观测的调度体系演进。

注意：所有示例中的镜像地址、API端点均为示意,生产环境请替换为实际值。