citusdata/packaging

Citus Packaging镜像

镜像概述

该镜像包含一系列脚本，可生成Dockerfile集合，进而构建能生成兼容PostgreSQL 9.6/10/11版本的Citus项目包的Docker镜像，支持多平台构建。

核心功能

1. 生成针对不同操作系统的Dockerfile，用于构建Citus项目包
2. 支持构建citus、enterprise、re***三种项目类型的包
3. 支持release（最新发布版）、nightly（每日构建版）及自定义Git引用的构建类型
4. 自动拉取Docker Hub上托管的镜像，无需手动处理

使用场景

1. Citus项目开发人员构建多平台兼容的项目包
2. 测试Citus项目在不同操作系统环境下的兼容性
3. 生成Citus项目的每日构建版或特定版本包

配置说明

前提条件

Docker安装

• Linux：直接安装Docker
• OS X：需安装docker、docker-machine及VirtualBox，步骤如下：
  1. 使用Homebrew安装：brew install docker docker-machine
  2. 从VirtualBox官网安装VirtualBox
  3. 创建默认虚拟机：docker-machine create --driver virtualbox default
  4. 激活环境：eval "$(docker-machine env default)"

GitHub认证

1. 登录GitHub，访问https://github.com/settings/tokens%E7%94%9F%E6%88%90%E6%96%B0%E4%BB%A4%E7%89%8C%EF%BC%8C%E5%91%BD%E5%90%8D%E4%B8%BApackaging%EF%BC%8C%E5%8B%BE%E9%80%89repo%E5%92%8Cuser%E6%9D%83%E9%99%90
2. 将令牌添加到环境变量：export GITHUB_TOKEN=<你的令牌>（可写入.bash_profile或.zshrc）

使用步骤

构建包

在项目根目录运行build_packages脚本，需指定项目名称和构建类型：

bash
./build_packages citus release

输出包将存放在项目根目录的packages下对应操作系统的子目录中。

更新Dockerfile

运行update_dockerfiles脚本生成新的Dockerfile集合，提交并推送变更即可触发自动构建。

更新Docker镜像

运行update_images脚本，基于dockerfiles目录的文件构建所有指定操作系统的镜像，用于测试镜像变更。

许可证

本仓库内文件遵循Apache License 2.0，详情见LICENSE。各Citus项目的许可证请参考其各自仓库。