texastribune/supervisor

Texas Tribune Docker镜像主仓库

镜像概述和主要用途

本仓库是Texas Tribune Docker镜像的主仓库，用于集中存储所有镜像的完整历史记录。若某个容器有独立仓库，其完整历史也会同步存储在对应独立仓库中。通过Git子树技术，实现了在单一仓库中管理多个Docker镜像，同时为每个镜像提供独立的Git远程和历史记录。

弃用通知

https://hub.docker.com/r/texastribune/pg-tools/ Docker镜像不再通过本仓库构建，所有开发已迁移至https://github.com/texastribune/docker-pg-tools%E3%80%82

核心功能和特性

Git子树优势

Git子树技术使我们能够在一个位置存储所有Docker镜像，同时为每个镜像提供独立的Git远程和历史记录，具体优势包括：

• 支持从Docker Index接收Webhook
• 支持在Docker Index中进行标记构建
• 降低多项目维护的开发成本：
  • 只需检出一个Git仓库并在编辑器中设置一个项目即可开始工作
  • 更轻松地引用其他Dockerfile
  • 可一次性在所有Dockerfile中实施最佳实践

使用场景和适用范围

适用于需要开发和维护多个Docker镜像的团队，尤其适合希望集中管理代码、统一最佳实践并简化开发流程的场景。通过本仓库，开发者可在单一项目中处理多个Docker镜像，同时保持各镜像的独立性。

贡献指南

所有提交和拉取请求均需在主仓库（docks）中进行，这样只需在编辑器中打开一个项目即可处理多个Docker镜像。贡献合并后，可将更改推回各自的独立仓库。

使用方法和配置说明

为简化git subtree命令的冗长参数，仓库中包含一个辅助工具：subtree。

添加所有Git远程

每个Docker镜像都有其专用远程。为方便开发者操作所有镜像，可通过以下命令一次性设置所有远程：

bash
./subtree remotes

推送更新

对Docker镜像的更新满意后，可通过以下命令将更改推回其专用仓库：

bash
./subtree push <name>

创建新镜像

以创建名为snazzle的Docker镜像为例：

1. 在此仓库中创建snazzle Docker镜像：
   1. mkdir snazzle
   2. cd snazzle
   3. vi Dockerfile
   4. git commit（等常规Git操作）
2. 创建新的空仓库（例如：github.com:texastribune/docker-snazzle.git）
3. 更新subtree工具，在REMOTES定义中添加新镜像，格式如下：[snazzle]=github.com:texastribune/docker-snazzle.git
4. 添加snazzle远程：./subtree remotes
5. 将snazzle目录与snazzle远程关联：./subtree init snazzle
6. 将代码推送到snazzle仓库：./subtree push snazzle
7. 继续编辑snazzle并提交更改
8. 需要时，使用./subtree push snazzle持续推送更改
9. 准备发布到Docker Registry时，使用texastribune/docker-snazzle.git远程，而非本项目的远程
10. （高级）如需维护snazzle的两个版本，最简单的方法是将其视为独立项目：
    1. 按常规方式检出texastribune/docker-snazzle.git远程
    2. 从该独立项目分支和编辑，而非本主集成项目

分叉现有仓库

以分叉现有项目为例：

1. 在GitHub上分叉项目（例如：将utensils/fork分叉到texastribune/fork）
2. 更新./subtree的remote命令，添加名为fork的远程指向texastribune/fork
3. 运行./subtree remotes添加远程
4. 运行./subtree init fork建立关联
5. 运行./subtree pull fork --squash将项目引入本仓库
6. 按常规方式更新和提交更改：
   1. 创建分支
   2. 提交更改
   3. 提交拉取请求
   4. 合并
7. 运行./subtree push fork推送更改，触发Index中的新构建

在远程中维护多个分支

虽然可行，但使用Git子树维护多个分支没有简单方法。目前有多种可能方案，我们将在实际需要时再行处理。