Container Service for Kubernetes:Mount OSS buckets using ossfs 1.0 dynamic volumes

1. Bir StorageClass oluşturun

1. Uygulamanızla aynı ad alanında bir Secret oluşturun.

   akId ve akSecret değerlerini AccessKey ID'niz ve AccessKey Secret değerlerinizle değiştirin.

   kubectl create secret generic oss-secret --from-literal='akId=<yourAccessKey ID>' --from-literal='akSecret=<yourAccessKey Secret>'

2. StorageClass'ı oluşturun.

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

      apiVersion: storage.k8s.io/v1
      kind: StorageClass
      metadata:
        name: sc-oss
      parameters:
        # Replace with the name of your OSS bucket.
        bucket: bucket
        # Replace with the region of your OSS bucket.
        region: cn-hangzhou
        # The mount path relative to the bucket's root directory. You can specify a subdirectory.
        path: /
        # The endpoint of the region where the bucket is located.
        url: "https://oss-cn-hangzhou-internal.aliyuncs.com" 
        # The name of the Secret that stores the AccessKey information.
        csi.storage.k8s.io/node-publish-secret-name: oss-secret
        # The namespace where the Secret that stores the AccessKey information is located.
        csi.storage.k8s.io/node-publish-secret-namespace: default
        # Custom parameters.
        otherOpts: "-o umask=022 -o max_stat_cache_size=100000 -o allow_other"
        # The signature version for requests sent to the OSS server.
        sigVersion: "v4"
      # Fixed value for the Alibaba Cloud OSS CSI plug-in.
      provisioner: ossplugin.csi.alibabacloud.com
      # The reclaim policy for the dynamically provisioned persistent volume.
      reclaimPolicy: Retain
      # The volume binding mode.
      volumeBindingMode: Immediate
      

      Parametre	Açıklama
      name	StorageClass adı.
      bucket	Bağlanacak OSS paketi.
      region	OSS imza v4 kullanılırken bu parametreyi paketin bulunduğu OSS bölgesine ayarlayın. OSS bölgesini sorgulamak için bkz. Paket 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, tüm paketi bağlayan / değeridir. 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	Bağlanacak OSS Paketinin uç noktası. Bağlama düğümü ve paket aynı bölgedeyse veya bir 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 bağlantı noktaları için yaygın biçimler aşağıda verilmiştir: Dahili ağ biçimi: https://oss-{{regionName}}-internal.aliyuncs.com. vpc100-oss-{{regionName}}.aliyuncs.com dahili uç nokta biçimi kullanım dışıdır. Derhal yeni biçime geçin. Genel ağ biçimi: https://oss-{{regionName}}.aliyuncs.com. Güvenlik amacıyla OSS'ye HTTPS üzerinden erişmenizi öneririz. Bunun yerine HTTP kullanmak için önceki biçimdeki https:// ön ekini http:// ile değiştirin.
      csi.storage.k8s.io/node-publish-secret-name	AccessKey bilgilerini saklayan Secret adı.
      csi.storage.k8s.io/node-publish-secret-namespace	AccessKey bilgilerini saklayan Secret'ın bulunduğu ad alanı.
      otherOpts	OSS kalıcı birimi için özel parametreler, -o -o biçimindedir. Ö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 diğer yöntemlerle yüklenen ve varsayılan izni 640 olan dosyaların izin sorununu çözer. Okuma/yazma ayrımı veya çok kullanıcılı erişim için bu parametreyi yapılandırmanızı öneririz. max_stat_cache_size: Meta veri önbelleği girişlerinin ü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. Katı 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 kısaltın. Ancak bu, okuma performansını azaltabilir. 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, birimi bağlamayan kullanıcıların da verilere erişmesi gereken çok kullanıcılı 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ına ilişkin en iyi uygulamalar.
      provisioner	Sürücü türü. Alibaba Cloud OSS CSI eklentisi kullanılırken bu değer ossplugin.csi.alibabacloud.com olarak sabittir.
      reclaimPolicy	Dinamik olarak sağlanan kalıcı birimler için geri kazanma ilkesi. OSS kalıcı birimleri yalnızca Retain değerini destekler; bu, bir PVC'yi sildiğinizde karşılık gelen kalıcı birimin ve OSS paketindeki verilerin silinmediği anlamına gelir.
      volumeBindingMode	Birim bağlama modu. OSS kalıcı birimleri kullanılabilirlik alanı tabanlı düğüm yakınlığı gerektirmez. Varsayılan Immediate değerini kullanabilirsiniz.
      volumeAs	Birim erişim modu. Varsayılan değer sharepath değeridir. Geçerli değerler: sharepath: Tüm kalıcı birimler aynı bağlama yolunu paylaşır. Veriler <bucket>:<path>/ konumunda depolanır. subpath: Verileri yalıtmak için her kalıcı birim için özel bir alt dizin oluşturur. Veriler <bucket>:<path>/<pv-name>/ konumunda depolanır. Bu parametre yalnızca CSI bileşeni sürümü 1,31,3 veya üzeri olduğunda etkili olur.
      sigVersion	OSS sunucusuna gönderilen isteklerin imza sürümü. "v1" (Varsayılan): OSS İmza Sürüm 1 kullanır. "v4" (Önerilen): OSS İmza Sürüm 4 kullanır.

   2. StorageClass'ı oluşturun.

      kubectl apply -f sc-oss.yaml

1. 1. Adım bölümündeki AccessKey'i kalıcı birim için bir Secret olarak saklayın.

   1. ACK Kümeleri sayfasında kümenizin adını tıklayın. Sol gezinme bölmesinde Configurations > Secrets seçeneğini tıklayın.

   2. Create from YAML seçeneğini tıklayın ve Secret'ı oluşturmak için ekrandaki talimatları izleyin.

      apiVersion: v1
      kind: Secret
      metadata:
        name: oss-secret
        # Must match the namespace of the application.
        namespace: default
      stringData:
        # Replace with your AccessKey ID.
        akId: <your AccessKey ID>
        # Replace with your AccessKey secret.
        akSecret: <your AccessKey Secret>

2. Clusters sayfasında kümenizin adını tıklayın. Sol gezinme bölmesinde Volumes > StorageClasses seçeneğini tıklayın.

3. StorageClasses sayfasında Create seçeneğini tıklayın, PV Type değerini OSS olarak ayarlayın ve StorageClass'ı yapılandırmak için ekrandaki talimatları izleyin.

   Parametre	Açıklama
   Erişim sertifikası	AccessKey ID ve AccessKey Secret değerlerini içeren OSS'ye erişim için kullanılan Secret.
   Bucket ID:	Kullanılacak OSS paketi. Konsol, yapılandırılan AccessKey'in erişebileceği paketleri yalnızca gösterir.
   OSS yolu	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, tüm paketi bağlayan / değeridir. 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.
   Volume Mode	Birim erişim modu. Varsayılan Shared Directory değeridir. Geçerli değerler: Subdirectory modu yalnızca CSI bileşeni sürümü 1,31,3 veya üzeri olduğunda etkili olur. Aksi takdirde Shared Directory modu kullanılır. Shared Directory (sharepath): Tüm kalıcı birimler aynı bağlama yolunu paylaşır. Veriler <bucket>:<path>/ konumunda depolanır. Subdirectory (subpath): Verileri yalıtmak için her kalıcı birim için özel bir alt dizin oluşturur. Veriler <bucket>:<path>/<pv-name>/ konumunda depolanır.
   Uç nokta	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 aşağıda verilmiştir: Dahili: http://oss-{{regionName}}-internal.aliyuncs.com veya https://oss-{{regionName}}-internal.aliyuncs.com. Not vpc100-oss-{{regionName}}.aliyuncs.com dahili erişim uç noktası biçimi kullanım dışıdır. En kısa sürede yeni biçime geçin. Genel: http://oss-{{regionName}}.aliyuncs.com veya https://oss-{{regionName}}.aliyuncs.com. Konsol varsayılan olarak dahili ağ üzerinden OSS'ye erişmek için HTTP kullanır. HTTPS kullanmak için PV'yi kubectl kullanarak oluşturmanız gerekir.
   Geri kazanma ilkesi	Dinamik olarak sağlanan kalıcı birimler için geri kazanma ilkesi. OSS kalıcı birimleri yalnızca Retain değerini destekler; bu, bir PVC'yi sildiğinizde karşılık gelen kalıcı birimin ve OSS paketindeki verilerin silinmediği anlamına gelir.
   Optional Parameters:	OSS kalıcı birimi için özel parametreler, -o -o biçimindedir. Ö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 diğer yöntemlerle yüklenen ve varsayılan izni 640 olan dosyaların izin sorununu çözer. Okuma/yazma ayrımı veya çok kullanıcılı erişim için bu parametreyi yapılandırmanızı öneririz. max_stat_cache_size: Meta veri önbelleği girişlerinin ü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. Katı 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 kısaltın. Ancak bu, okuma performansını azaltabilir. 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, birimi bağlamayan kullanıcıların da verilere erişmesi gereken çok kullanıcılı 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ına ilişkin en iyi uygulamalar.