amitie10g/gcsfuse

docker-gcsfuse

这是一个基于Alpine系统构建的镜像，用于运行Google Cloud Platform的https://github.com/GoogleCloudPlatform/gcsfuse%E5%B7%A5%E5%85%B7%EF%BC%8C%E5%AE%9E%E7%8E%B0GCS%E5%AD%98%E5%82%A8%E6%A1%B6%E7%9A%84%E6%8C%82%E8%BD%BD%E8%AE%BF%E9%97%AE%E3%80%82

镜像概述

该镜像以轻量的Alpine系统为基础，集成了gcsfuse工具，支持通过服务账户密钥认证访问GCS存储桶，并针对Google Cloud VM环境提供了OS Login配置适配方案。

核心功能

1. 挂载GCS存储桶到容器内文件系统
2. 支持服务账户密钥认证
3. 适配Google Cloud VM的OS Login用户权限配置
4. 可通过环境变量设置用户ID（PUID）、组ID（PGID）及时区（TZ）

使用场景

• 需要在Docker环境中访问GCS存储桶的应用场景（如数据备份、文件共享、应用数据读取）
• Google Cloud VM实例中通过Docker部署gcsfuse的场景

配置说明

前置准备

1. 获取GCS存储桶对应的https://cloud.google.com/iam/docs/creating-managing-service-account-keys%EF%BC%8C%E4%BF%9D%E5%AD%98%E4%B8%BA%60gcsfuse-key.json%60%E6%96%87%E4%BB%B6
2. 为服务账户配置GCS存储桶的访问权限
3. 若在Google Cloud VM中运行：
   • 配置对应的https://cloud.google.com/compute/docs/access/service-accounts
   • 启用https://cloud.google.com/compute/docs/instances/managing-instance-access#enable_oslogin%E5%B9%B6%E9%80%89%E6%8B%A9%E5%90%88%E9%80%82%E7%9A%84%E6%9C%8D%E5%8A%A1%E8%B4%A6%E6%88%B7
   • 将服务账户密钥保存为名为GCSKEY的自定义元数据
   • 使用scripts/startup-gcloud.sh作为启动脚本获取OS Login账户的环境变量

部署示例

命令行方式

CONTAINER_NAME="gcsfuse"
CONTAINER_IMAGE="amitie10g/gcsfuse"
TZ="UTC"
PUID=<用户ID>
PGID=<组ID>
BUCKET=<GCS存储桶名称>

docker run -t -i -d \
  --name="$CONTAINER_NAME" \
  -e PUID="$PUID" \
  -e PGID="$PGID" \
  -e TZ="$TZ" \
  -e BUCKET="$BUCKET" \
  -v "$LOCAL_HOME/gcs-key.json":/etc/gcs-key.json \
  --device=/dev/fuse \
  --restart no \
  --privileged \
  $CONTAINER_IMAGE

Docker Compose方式

version: "3.3"
services:
  gcsfuse:
    image: amitie10g/gcsfuse
    container_name: gcsfuse
    environment:
      - PUID=<用户ID>
      - PGID=<组ID>
      - BUCKET=<GCS存储桶名称>
      - TZ=UTC
    volumes:
      - <本地gcs-key.json路径>:/etc/gcs-key.json
    restart: no