ageapps/k8s-storage-buckets

k8s-storage-buckets

Kubernetes的卷可理解为Pod中容器可访问的目录。在松耦合的微服务架构中，扩展共享文件的服务时易遇到问题，分布式文件系统是有效解决方案。Kubernetes支持多种卷类型，但多数持久卷在扩展时存在局限，而主流云平台的分布式存储（如AWS S3、GCP Cloud Storage）需自定义挂载方式实现集成。

核心功能

• 支持GCP Cloud Storage：通过gcsfuse挂载，提供两种认证方式（JSON凭证/ GKE集群scope）
• 支持AWS S3：通过s3fs-fuse挂载（未来将补充示例）
• 支持Azure File Storage：Kubernetes原生azureFileVolume卷集成

使用场景

微服务架构下多副本服务共享文件资源的场景，如静态资源存储、日志共享等。

配置说明

GCP Cloud Storage集成

方式1：JSON凭证认证

1. 创建secret存储凭证：

bash
kubectl create secret generic storage-auth-credentials --from-file=credentials=path/to/json

2. 挂载凭证到容器：

yaml
volumes:
  - name: storage-credentials
    secret:
      secretName: storage-auth-credentials
      items:
        - key: credentials
          path: storage-credentials.json
volumeMounts:
  - name: storage-credentials
    mountPath: /auth
    readOnly: true

方式2：GKE集群scope认证

创建集群时指定存储读写权限：

bash
gcloud container clusters create your-cluster --scopes=https://www.googleapis.com/auth/devstorage.read_write

部署示例

同一容器运行NGINX与GCSFUSE：

bash
docker build -t nginx-gcsfuse:v1 .
docker run --privileged -d -p 8080:8080 nginx-gcsfuse:v1
kubectl create -f nginx-gcsfuse-mono.yaml
kubectl scale --replicas=3 deploy/nginx

Azure File Storage集成

使用原生azureFileVolume卷：

yaml
volumeMounts:
  - name: azure
    mountPath: /mnt/azure
volumes:
  - name: azure
    azureFile:
      secretName: azure-secret
      shareName: k8stest
      readOnly: false

AWS S3集成

需通过s3fs-fuse挂载（未来将补充详细示例）。