texastribune/postgres

The Texas Tribune Docker镜像主仓库

镜像概述和主要用途

本仓库是The Texas Tribune Docker镜像的主仓库，用于集中存储所有镜像的完整历史记录。若容器有独立仓库，其完整历史也会同步存储在对应独立仓库中。

弃用通知

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

贡献指南

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

Git子树（Subtrees）

Git子树允许我们将所有Docker镜像存储在一个位置，同时为每个镜像提供独立的Git远程仓库和历史记录。使用Git子树还带来以下优势：

• 支持从Docker Index为这些Dockerfile配置Webhooks
• 支持在Docker Index为这些Dockerfile进行标签构建
• 简化多项目维护的开发成本：
  • 入门更简单，只需检出一个Git仓库并在编辑器中设置一个项目
  • 更容易引用其他Dockerfile
  • 可一次性在所有Dockerfile中实施最佳实践

使用方法

为简化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. 告知git-subtree将snazzle目录与snazzle远程仓库关联：./subtree init snazzle
6. 将代码推送到snazzle仓库：./subtree push snazzle
7. 继续编辑snazzle并提交更改
8. 准备就绪后，使用./subtree push snazzle持续推送更改至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子树维护多个分支没有简单方法。目前有多种可能方案，我们将在实际需要时再行处理。