startx/runner-bash

STARTX Docker-Images 仓库

镜像概述和主要用途

STARTX Docker-Images是一个应用或服务容器的集合，可用于执行或嵌入应用程序，支持作为构建过程的一部分（如docker、podman、s2i）或直接通过多种容器引擎（如docker、podman、dockerEE、kubernetes、openshift）运行。每个容器基于多种底层OS版本，包括Fedora Linux、CentOS、Alpine和UBI发行版，对Kubernetes和OpenShift友好，可作为OpenShift集群中的s2i构建器使用。

核心功能和特性

支持的容器类型及用途

镜像版本

使用场景和适用范围

• 目标用户：熟悉RedHat类发行版（如Fedora、CentOS）的用户，需要使用接近其偏好发行版的容器而非Ubuntu或Debian类容器。
• 应用场景：
  • 构建和运行基于RedHat类发行版的服务（如Apache、MariaDB、Node.js）
  • 在Kubernetes或OpenShift集群中作为S2I构建器嵌入应用
  • 提供VDI服务（如Chrome、Firefox容器）
  • 作为Gitlab Runner执行CI/CD任务（如Ansible、PHP构建）
  • 部署现成应用（如phpMyAdmin、RockMongo）

使用方法和配置说明

环境准备

1. 安装容器引擎（根据需求选择）：

   • https://github.com/startxfr/containers-engines/blob/master/Docker.md
   • https://github.com/startxfr/containers-engines/blob/master/Podman.md
   • https://github.com/startxfr/containers-engines/blob/master/S2I.md
   • https://github.com/startxfr/containers-engines/blob/master/Kubernetes.md

2. 验证环境：

   bash
   # 检查Docker是否安装
   docker --version
   # 检查docker-compose是否安装
   docker-compose --version
   # 检查Git是否安装
   git --version
   

3. 克隆仓库：

   bash
   mkdir startx-docker-images && cd startx-docker-images
   git clone https://github.com/startxfr/docker-images.git .
   

构建容器

使用docker-compose构建所有容器

bash
# 选择镜像版本（如fc34、centos8）
git checkout fc34
# 创建数据目录
mkdir /tmp/container
# 构建所有容器
docker-compose build
# 后台运行多容器
docker-compose up -d
# 查看日志
docker-compose logs

构建单个容器（以Apache服务为例）

bash
# 进入服务目录
cd Services/apache
# 构建镜像
docker build -t startx/sv-apache:custom .

运行容器

交互式运行

bash
# 运行Fedora基础容器（交互式）
docker run -it startx/fedora:latest /bin/bash

后台运行服务容器

bash
# 运行MariaDB服务（后台模式）
docker run -d -p 3306:3306 --name mariadb startx/sv-mariadb:latest

高级配置

sx-lib版本说明

通过sx version命令查看sx-lib版本，主要版本特性：

• 0.95.21：新增fc34和fc33分支
• 0.95.17：稳定支持ubi8、centos7/8、fc30/31/32
• 0.95.5：支持MariaDB的_.data.sql和_.schema.sql数据导入
• 0.31.3：完全兼容OKD 4.0（支持s2i、podman）

自定义容器内容

修改目标容器的Dockerfile后重新构建，例如添加额外依赖：

dockerfile
# 在Services/php/Dockerfile中添加
RUN dnf install -y php-mbstring

然后重新执行docker build命令构建自定义镜像。

注意事项

• 每个容器的详细使用方法请参考对应目录的手册（如Services/apache#running-this-image）
• 实验性服务请谨慎用于生产环境，建议先测试稳定性
• 构建大型容器集合可能需要较长时间，建议根据需求选择特定服务容器单独构建