Skip to content

Latest commit

 

History

History
96 lines (68 loc) · 2.2 KB

oss.md

File metadata and controls

96 lines (68 loc) · 2.2 KB
Raw

OSS CSI Plugin

An OSS CSI plugin is available to help simplify storage management. You can create a pv with csi configuration, and the pvc, pod defines as usual.

Configuration Requirements

  • Service Accounts with required RBAC permissions

Feature Status

Alpha

Compiling and Package

ossplugin.csi.alibabacloud.com can be compiled in a form of a container.

To build a container:

$ cd build && sh build-oss.sh

Usage

Prerequisite

Same as diskplugin.csi.alibabacloud.com;

Features

Oss Plugin support to use Secret for Access Authorization;

Oss Plugin support to mount remote subpath under oss bucket;

Oss Plugin support to upgrade online;

Step 1: Create CSI Plugin

# kubectl create -f ./deploy/oss/oss-plugin.yaml

Note: The plugin log style can be configured by environment variable: LOG_TYPE.

"host": logs will be printed into files which save to host(/var/log/alicloud/ossplugin.csi.alibabacloud.com.log);

"stdout": logs will be printed to stdout, can be printed by docker logs or kubectl logs.

"both": default option, log will be printed both to stdout and host file.

Step 2: Create pv/pvc/deploy with csi

# kubectl create -f ./examples/oss/pv.yaml
# kubectl create -f ./examples/oss/pvc.yaml
# kubectl create -f ./examples/oss/deploy.yaml

Step 3: Check status of PVC/PV

# kubectl get pvc | grep oss
oss-pvc    Bound    oss-csi-pv                                 5Gi        RWO                                5m18s

# kubectl get pv | grep oss
oss-csi-pv                                 5Gi        RWO            Retain           Bound    default/oss-pvc                                 5m21s

# kubectl get pv oss-csi-pv -o yaml
apiVersion: v1
kind: PersistentVolume
metadata:
  labels:
    alicloud-pvname: oss-csi-pv
  name: oss-csi-pv
spec:
  accessModes:
  - ReadWriteOnce
  capacity:
    storage: 5Gi
  csi:
    driver: ossplugin.csi.alibabacloud.com
    volumeAttributes:
      akId: *
      akSecret: *
      bucket: oss-docker
      otherOpts: -o max_stat_cache_size=0 -o allow_other
      path: /docker
      url: oss-cn-shenzhen-internal.aliyuncs.com
    volumeHandle: oss-csi-pv
  persistentVolumeReclaimPolicy: Retain