picoded/gs-zip-cloner-base

picoded/gs-zip-cloner-base

https://hub.docker.com/r/picoded/gs-zip-cloner-base/
https://github.com/picoded/dockerfiles/tree/master/gs-zip-cloner/gs-zip-cloner-base

镜像概述

本镜像基于picoded/ubuntu-base构建，核心功能是从指定源（包括Google Storage）下载ZIP文件并解压，同时支持在下载前后执行自定义脚本，适用于需要自动化获取和解压压缩包的场景。若需结合OpenJDK或Node.js使用，建议参考gs-zip-cloner-plus镜像。

核心功能

1. 从Google Storage或其他源下载ZIP文件并解压
2. 支持通过JSON凭证文件或内容进行Google Storage认证
3. 允许在下载前后执行自定义脚本
4. 继承picoded/ubuntu-base的标准环境变量和卷配置

使用场景

• 自动化部署流程中获取代码包或资源文件
• 批量处理远程存储的ZIP格式数据
• 结合自定义脚本实现解压后的后续操作（如编译、部署）

配置说明

Google Storage环境变量

• GS_URL: 需下载的Google Storage文件URL，格式为gs://<bucket-name>/<sub-directory>/<file>.zip
• GS_CRED_FILE: Google Storage服务账号JSON凭证文件路径（如/etc/gs-cred.json）
• GS_CRED_CONTENT: Google Storage服务账号JSON凭证内容（若直接挂载文件则留空）

通用环境变量

• ZIP_FILE: 目标ZIP文件名（默认master.zip）
• ZIP_FOLDER: 解压目标相对路径（默认./，对应/workspace/./，不可为空）
• ZIP_PRESCRIPT: 下载ZIP前执行的脚本
• ZIP_POSTSCRIPT: 下载解压后执行的脚本

继承自picoded/ubuntu-base的配置

标准环境变量

• TIMEZONE: 系统时区（默认GMT+08，即新加坡时区）
• LANGUAGE: 系统语言（默认en_US.UTF-8）
• APTGET_PRESCRIPT: 执行apt-get安装/升级前的命令
• APTGET_INSTALL: 启动时需安装的软件包（若缺失）
• APTGET_UPGRADE: 是否执行apt-get升级（默认false）
• APTGET_POSTSCRIPT: 执行apt-get安装/升级后的命令

标准卷挂载点

• /workspace: 存储镜像相关的持久化文件

更多细节请参考https://github.com/picoded/dockerfiles/tree/master/base%E3%80%82

部署示例

Docker Run命令（使用凭证文件）

bash
docker run -d \
  -e GS_URL="gs://my-bucket/my-folder/data.zip" \
  -e GS_CRED_FILE="/etc/gs-cred.json" \
  -v /path/to/local/cred.json:/etc/gs-cred.json \
  -v /path/to/workspace:/workspace \
  picoded/gs-zip-cloner-base

Docker Run命令（使用凭证内容）

bash
docker run -d \
  -e GS_URL="gs://my-bucket/my-folder/data.zip" \
  -e GS_CRED_CONTENT='{"type":"service_account", ...}' \
  -v /path/to/workspace:/workspace \
  picoded/gs-zip-cloner-base

问题反馈

如有问题、建议或反馈，请提交至GitHub仓库：https://github.com/picoded/dockerfiles