thinkwhere/application-base

thinkWhere应用和CI基础镜像

概述

该镜像作为thinkWhere应用程序和持续集成(CI)环境的基础镜像，旨在提供统一、标准化的运行和构建环境。通过使用此基础镜像，可确保开发、测试及CI流程中的环境一致性，减少因环境差异导致的问题，简化应用部署和维护流程。

核心功能和特性

• 标准化环境：内置统一的操作系统、运行时及依赖库版本，确保应用在开发、测试和生产环境中的行为一致性
• CI兼容性：针对持续集成/持续部署(CI/CD)流水线优化，支持主流CI工具（如Jenkins、GitLab CI、GitHub Actions等）的集成
• 轻量级设计：在提供核心功能的同时最小化镜像体积，提升构建速度和资源利用率
• 依赖预配置：预安装thinkWhere应用开发和运行所需的常用依赖组件，减少重复配置工作

使用场景

• thinkWhere应用程序的本地开发和测试环境搭建
• CI/CD流水线中的构建、测试阶段环境提供
• 多团队协作开发时的环境标准化
• 需要统一基础环境的应用部署和维护

使用方法

基本使用

直接运行基础镜像

bash
docker run --rm -it thinkwhere/base-image:latest

构建自定义应用镜像

基于此基础镜像创建自定义应用镜像（示例Dockerfile）：

dockerfile
# 基于thinkWhere基础镜像构建
FROM thinkwhere/base-image:latest

# 添加应用代码
COPY ./app-source /opt/thinkwhere/app

# 设置工作目录
WORKDIR /opt/thinkwhere/app

# 安装应用特定依赖
RUN npm install  # 或其他依赖安装命令

# 暴露应用端口
EXPOSE 8080

# 启动命令
CMD ["npm", "start"]

构建并运行自定义镜像：

bash
# 构建镜像
docker build -t my-thinkwhere-app:1.0 .

# 运行应用
docker run -d -p 8080:8080 --name my-app my-thinkwhere-app:1.0

CI环境集成示例

GitLab CI配置

在.gitlab-ci.yml中使用该镜像作为构建环境：

yaml
stages:
  - test
  - build

test_stage:
  stage: test
  image: thinkwhere/base-image:latest
  script:
    - cd ./app
    - npm install
    - npm run test

build_stage:
  stage: build
  image: thinkwhere/base-image:latest
  script:
    - cd ./app
    - npm run build
    - ./package.sh
  artifacts:
    paths:
      - ./app/dist/*.tar.gz

环境变量配置

该镜像支持以下环境变量进行基础配置：

示例：指定生产环境和上海时区运行

bash
docker run --rm -it \
  -e APP_ENV=prod \
  -e TIMEZONE=Asia/Shanghai \
  thinkwhere/base-image:latest