# dockerfiles

**Repository Path**: ZoeDong/dockerfiles

## Basic Information

- **Project Name**: dockerfiles
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-04-09
- **Last Updated**: 2026-04-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# TencentOS Container DockerFiles
欢迎来到 TencentOS Container DockerFiles 仓库！这是我们携手共建、共享鹅厂容器基础镜像的平台。

诚挚邀请您基于 TencentOS 基础镜像，贡献包含中间件、AI 软件栈等组件的通用镜像，共同打造丰富多样的鹅厂容器基础镜像生态。

TencentOS 基础镜像介绍：https://km.woa.com/articles/show/602995

## 如何贡献中间件、AI软件栈等组件的通用镜像 Dockerfile
以下是贡献 Dockerfile 的步骤：
1. **Fork 仓库**：在页面顶部，点击 Fork 按钮创建属于您的 DockerFiles 仓库副本。
2. **创建新目录**：在你的副本仓库中，创建一个新的目录用于存放您的 Dockerfile。新目录名称应当简洁明了，可以反映 Dockerfile 对应的组件以及镜像名称的主体。
3. **添加 Dockerfile**：在新创建的目录中，添加您的 Dockerfile。
4. **提交和推送更改**：使用 git add, git commit, 和 git push 命令将你的更改提交并推送到你的副本仓库。
5. **创建 Pull Request**：回到 TencentOS Container DockerFiles 仓库，点击 New Merge Request 按钮并在打开的页面中创建 Pull Request。
6. **等待审核**：仓库的维护者会对你的 Pull Request 进行审核。如果您的 Dockerfile 符合要求，它将会被合并到主仓库中。
7. **镜像构建并推送到 docker 镜像仓库**： 如需使用自动构建发布流水线，必须在仓库根目录填写 images-map.json 文件，并确保所有架构共用同一个 Dockerfile。

### Dockerfile 注意事项
- 请确保您的 Dockerfile 是可工作的，并且已经过测试。
- 请在提交的 Dockerfile 中包含详细的注释，说明每一步的作用和需要注意的地方。
- 如果你的 Dockerfile 依赖于特定的操作系统或者环境，请在 Dockerfile 或者 Pull Request 中明确说明。
- **Dockerfile 文件命名规范**：Dockerfile 文件名必须为 `Dockerfile`，不能使用其他名称
- **镜像构建要求**：确保在镜像目录下可以直接执行 `docker build .` 命令成功构建镜像

### Docker 镜像仓库
镜像推送涉及如下 Docker 镜像仓库：
- 腾讯软件源 Docker镜像仓库：https://mirrors.tencent.com/#/private/project，命名空间：tencentos
- CSIGHub 镜像仓库：https://csighub.woa.com/tencenthub/store/registry，命名空间：tencentos
- DockerHub 镜像仓库：https://hub.docker.com/u/tencentos

镜像默认推送到腾讯软件源 Docker 镜像仓库和 CSIGHub 镜像仓库，默认不推送到 DockerHub 镜像仓库，若需要推送 DockerHub 请在 Pull Request 中说明。

## 项目结构概览

### images-map.json结构
images-map.json文件采用标准JSON格式，用于定义镜像构建配置映射关系：

```json
{
  "images": [
    {
      "name": "镜像名称",
      "os": "操作系统（可选值：opencloudos, tencentos）",
      "tag-configs": [
        {
          "tags": ["标签列表"],
          "build_path": "Dockerfile所在路径",
          "architectures": ["架构列表（可选值：x86_64, aarch64, loongarch64）"],
          "platforms": ["平台列表（可选值：mirrors.tencent.com, csighub.tencentyun.com, docker.io）"]
        }
      ]
    }
  ]
}
```

### 文件结构要求
项目采用标准化的目录结构，确保CI检查系统能够正确识别和处理：

```
项目根目录/
├── .ci/
│   ├── check.yml                    # CI检查配置文件
│   ├── validate_images_map.py       # JSON格式验证脚本
│   ├── validate_repository_mapping.py # 仓库映射验证脚本
│   └── README.md                    # CI系统文档
├── images-map.json                  # 镜像映射配置
└── [各Dockerfile目录]/              # Dockerfile所在目录
```


非常欢迎并感谢你的贡献！让我们携手共建一个丰富、多样化的鹅厂容器镜像库！