Container Service for Kubernetes:Mount a static OSS volume using ossfs 1.0

RRSA

AccessKey

RRSA Kullan

1. pv-oss-rrsa.yaml adlı bir dosya oluşturun.

   apiVersion: v1
   kind: PersistentVolume
   metadata:
     # The PV name.
     name: pv-oss   
     # The PV labels.
     labels:    
       alicloud-pvname: pv-oss
   spec:
     capacity:
       # The capacity of the persistent volume.
       storage: 10Gi  
     # The access mode.
     accessModes:  
       - ReadOnlyMany
     persistentVolumeReclaimPolicy: Retain
     csi:
       driver: ossplugin.csi.alibabacloud.com
       # Must be the same as the PV name (metadata.name).
       volumeHandle: pv-oss  
       volumeAttributes:
         # Replace with your bucket name.
         bucket: "your-bucket-name"  
         # Replace with your bucket region.
         region: cn-hangzhou
         # The root directory or a subdirectory of the bucket to mount.
         path: /  
         # The endpoint of the region where the bucket is located.
         url: "https://oss-cn-hangzhou-internal.aliyuncs.com"  
         otherOpts: "-o umask=022 -o max_stat_cache_size=100000 -o allow_other"
         authType: "rrsa"
         # The RAM role that you previously created or modified.
         roleName: "demo-role-for-rrsa"
         # The signature version for OSS requests.
         sigVersion: "v4"  

   Parametre	Açıklama
   storage	OSS kalıcı biriminin kapasitesi. Bu değer yalnızca PV'yi bir PVC ile eşleştirmek için kullanılır.
   accessModes	Erişim modunu belirtir. Geçerli değerler arasında ReadOnlyMany ve ReadWriteMany bulunur. Bu parametreyi ReadOnlyMany olarak ayarlarsanız ossfs, OSS paketini salt okunur modda bağlar.
   persistentVolumeReclaimPolicy	PV'nin geri kazanma ilkesi. OSS kalıcı birimleri yalnızca Retain değerini destekler. Bu, bir PVC silindiğinde PV'nin ve OSS paketindeki verilerin korunduğu anlamına gelir.
   driver	Sürücü türü. Alibaba Cloud OSS CSI eklentisini kullanırken bu alanı ossplugin.csi.alibabacloud.com olarak ayarlayın.
   volumeHandle	metadata.name içinde belirtilen PV adıyla aynı olmalıdır.
   bucket	Bağlanacak OSS paketi.
   region	OSS imza v4 kullanırken bunu paketin bulunduğu OSS bölgesine ayarlayın. OSS bölgesini sorgulamak için bkz. Bir paketin bölgesini sorgulama. Bu parametre ayarlandığında OSS imza sürümü olarak otomatik olarak v4 kullanılır.
   path	CSI bileşeni sürümü v1.14.8.32-c77e277b-aliyun veya üzeri olmalıdır. Paketin kök dizinine göre bağlama yolu. Varsayılan değer / olup tüm paketi bağlar. ossfs sürümü 1,91'den önceyse belirtilen path OSS paketinde mevcut olmalıdır. Daha fazla bilgi için bkz. ossfs 1,91 ve sonraki sürümlerdeki yeni özellikler.
   url	OSS paketi için erişim uç noktası. Küme düğümleriniz ve paket aynı bölgedeyse veya bir Sanal Özel Cloud (VPC) bağlantısı kurulmuşsa dahili uç nokta kullanın. Bağlama düğümü ve paket farklı bölgelerdeyse genel uç nokta kullanın. Farklı erişim uç noktaları için yaygın biçimler şunlardır: Dahili: https://oss-{{regionName}}-internal.aliyuncs.com. Not vpc100-oss-{{regionName}}.aliyuncs.com dahili erişim uç noktası biçimi kullanımdan kaldırılmıştır. En kısa sürede yeni biçime geçin. Genel: https://oss-{{regionName}}.aliyuncs.com. Güvenlik nedeniyle HTTPS üzerinden OSS'ye erişmeyi öneririz. Bunun yerine HTTP kullanmak için yukarıdaki biçimdeki https:// ön ekini http:// ile değiştirin.
   otherOpts	OSS kalıcı birimi için özel parametreler; biçim -o -o şeklindedir. Örneğin: -o umask=022 -o max_stat_cache_size=100000 -o allow_other. Ayrıntılar için genişletin umask: Dosyalar ve dizinler için izin maskesini ayarlar. Örneğin umask=022 dosya izinlerini 755 olarak değiştirir. Bu, SDK'lar veya OSS konsolu gibi başka yöntemlerle yüklenen ve varsayılan izni 640 olan dosyaların izin sorununu çözer. Okuma/yazma ayrımı veya çoklu kullanıcı erişimi için bu parametreyi yapılandırmanızı öneririz. max_stat_cache_size: Meta veri önbelleği girdilerinin üst sınırını ayarlar; örneğin 100000. Meta veriler bellekte önbelleğe alınarak ls ve stat gibi işlemlerin performansı artırılır. Ancak bu önbellek, OSS konsolu, SDK'lar veya ossutil aracılığıyla yapılan dosya değişikliklerini anında algılayamaz. Bu durum uygulamaların tutarsız verileri okumasına neden olabilir. Sıkı veri tutarlılığı gereksinimleriniz varsa önbelleği devre dışı bırakmak için bu parametreyi 0 olarak ayarlayın veya stat_cache_expire parametresini kullanarak önbellek sona erme süresini azaltın. Ancak bu, okuma performansını düşürebilir. allow_other: Birimi bağlayan kullanıcı dışındaki kullanıcıların bağlama yolundaki dosyalara ve dizinlere erişmesine olanak tanır. Bu, bağlama yapmayan kullanıcıların da verilere erişmesi gereken çoklu kullanıcı paylaşımlı ortamlar için uygundur. İsteğe bağlı parametreler hakkında daha fazla bilgi için bkz. Bağlama seçenekleri ve ossfs 1,0 yapılandırması için en iyi uygulamalar.
   authType	Kimlik doğrulama için RRSA kullanmak üzere bu parametreyi rrsa olarak ayarlayın.
   roleName	Daha önce oluşturduğunuz veya değiştirdiğiniz RAM rolü. Farklı PV'ler için farklı izinler yapılandırmak üzere farklı RAM rolleri oluşturabilir ve PV'lerde farklı roleName değerleri belirtebilirsiniz.
   sigVersion	OSS sunucusuna gönderilen istekler için imza sürümü. "v1" (Varsayılan): OSS İmza Sürüm 1'i kullanır. "v4" (Önerilen): OSS İmza Sürüm 4'ü kullanır.

   Varsayılan RRSA kimlik doğrulaması gereksinimlerinizi karşılamıyorsa (örneğin varsayılan olmayan bir ServiceAccount veya üçüncü taraf OIDC kullanıyorsanız) belirli bir ARN veya ServiceAccount belirtmek için PV yapılandırmasını değiştirebilirsiniz. Daha fazla bilgi için RRSA kimlik doğrulamasıyla belirli ARN'ler veya ServiceAccount'lar nasıl kullanılır? konusuna bakın.

2. PV'yi oluşturun.

   kubectl create -f pv-oss-rrsa.yaml

AccessKey Kullan

kubectl

1. pvc-oss.yaml adlı bir dosya oluşturun.

   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
     # The name of the PVC.
     name: pvc-oss
     namespace: default
   spec:
     # Configure the access mode. ReadOnlyMany indicates that ossfs mounts the OSS bucket in read-only mode.
     accessModes:
       - ReadOnlyMany
     resources:
       requests:
         # The requested storage capacity. This value cannot exceed the capacity of the PersistentVolume.
         storage: 10Gi
     # Add this line to explicitly specify that no StorageClass is used.
     storageClassName: ""   
     selector:
       matchLabels:
         # Match the PV by its label.
         alicloud-pvname: pv-oss

2. PVC'yi oluşturun.

   kubectl create -f pvc-oss.yaml

3. PVC'nin durumunu kontrol edin.

   kubectl get pvc pvc-oss

   Çıktı, PVC'nin PV'ye bağlı olduğunu onaylar.

   NAME      STATUS   VOLUME   CAPACITY   ACCESS MODES   STORAGECLASS   VOLUMEATTRIBUTESCLASS   AGE
   pvc-oss   Bound    pv-oss   10Gi       ROX                           <unset>                 6s

Konsol

1. ACK Kümeleri sayfasında kümenizin adına tıklayın. Sol gezinme bölmesinde Volumes > Persistent Volume Claims yolunu izleyin.

2. Persistent Volume Claims sayfasında Create seçeneğine tıklayın, PVC Type olarak OSS'i seçin ve ekrandaki talimatları izleyerek parametreleri yapılandırıp isteği gönderin.

   Aşağıdaki tabloda ana parametreler açıklanmıştır.

   Parametre	Açıklama
   Allocation Mode	Use Existing PersistentVolume seçeneğini belirleyin. Henüz bir kalıcı birim oluşturmadıysanız Allocation Mode değerini Create PV olarak ayarlayabilir ve yeni birim için parametreleri yapılandırabilirsiniz.
   Toplam kapasite	PVC'nin depolama kapasitesi; bu değer Kalıcı Birimin kapasitesini aşamaz.

kubectl

1. Bir oss-workload.yaml dosyası oluşturun.

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: oss-workload
     labels:
       app: nginx
   spec:
     replicas: 2
     selector:
       matchLabels:
         app: nginx
     template:
       metadata:
         labels:
           app: nginx
       spec:
         containers:
         - name: nginx
           image: anolis-registry.cn-zhangjiakou.cr.aliyuncs.com/openanolis/nginx:1.14.1-8.6
           ports:
           - containerPort: 80
           volumeMounts:
             # The mount path in the container.
             - name: pvc-oss
               mountPath: "/data"
           # Configure a health check.
           livenessProbe:
             exec:
               command:
               - ls
               - /data
             initialDelaySeconds: 30
             periodSeconds: 30
         volumes:
           - name: pvc-oss
             persistentVolumeClaim:
               # Reference the PVC that you created.
               claimName: pvc-oss

2. Uygulamayı oluşturun.

   kubectl create -f oss-workload.yaml

3. Bağlamayı doğrulayın.

   • Pod'ların çalıştığını onaylayın.

     kubectl get pod -l app=nginx

   • Bir Pod'a erişin ve bağlama noktasını kontrol edin.

     kubectl exec -it <pod-name> -- ls /data

     Çıktıda OSS bağlama yolundaki dosyalar listelenmelidir.

Konsol