Codacy服务基础镜像

镜像概述和主要用途

本镜像作为Codacy系列服务的底层基础镜像，旨在为各类Codacy服务提供标准化、稳定的运行环境及核心依赖。它构建了Codacy服务运行的基础层，确保各服务在一致的环境中部署和运行，降低服务间的环境差异风险，简化服务构建与维护流程。

核心功能和特性

• 标准化运行环境：基于稳定的Linux发行版（如Debian/Ubuntu）构建，提供统一的操作系统层基础，保障服务运行环境一致性。
• 预集成核心依赖：包含Codacy服务通用的基础依赖库、运行时（如Java、Python等）及工具链，减少服务构建阶段的依赖配置工作。
• 版本化管理：通过明确的版本标识（如语义化版本）实现版本追溯，确保服务间依赖兼容性。
• 轻量级优化：在满足基础依赖需求的前提下，通过精简非必要组件实现镜像轻量化，提升部署效率和资源利用率。

使用场景和适用范围

• Codacy官方服务部署：作为底层基础镜像支撑Codacy各类官方服务（如代码分析服务、报告生成服务等）的构建与运行。
• 自定义服务开发：供开发者基于Codacy生态构建扩展服务时作为基础镜像，减少环境配置工作量，专注业务逻辑开发。
• 测试与调试环境：用于搭建与生产环境一致的测试/调试环境，确保服务行为的一致性验证。

使用方法和配置说明

拉取镜像

通过Docker命令拉取镜像，支持指定版本或使用最新版本：

# 拉取最新版本
docker pull codacy/base-image:latest

# 拉取指定版本（示例版本号）
docker pull codacy/base-image:2.1.0

构建自定义服务镜像

在Dockerfile中以本镜像为基础，添加自定义服务代码和配置：

# 基于Codacy基础镜像构建
FROM codacy/base-image:latest

# 复制服务代码至容器
COPY ./my-codacy-service /app/service

# 设置工作目录
WORKDIR /app/service

# 安装服务特定依赖（如需）
RUN apt-get update && apt-get install -y specific-dependency && rm -rf /var/lib/apt/lists/*

# 暴露服务端口
EXPOSE 8080

# 定义启动命令
CMD ["./start-service.sh"]

环境变量配置

支持通过环境变量调整基础运行参数，常用配置如下：

• LOG_LEVEL：日志输出级别，可选值：INFO（默认）、DEBUG、WARN、ERROR
• TZ：容器时区设置，如Asia/Shanghai（默认UTC）
• USER_ID：运行服务的用户ID，默认使用root（生产环境建议指定非root用户）

示例：运行容器时配置环境变量

docker run -d \
  -e LOG_LEVEL=DEBUG \
  -e TZ=Asia/Shanghai \
  -e USER_ID=1000 \
  --name my-codacy-service \
  codacy/base-image:latest

多架构支持

镜像默认支持amd64、arm64等主流架构，Docker引擎会根据宿主机架构自动选择匹配的镜像版本，无需额外配置。