Tüm Ürünler
Search
Belge Merkezi

Cloud Parallel File Storage:CPFS-NFS istemcisi ile dosya sistemi bağlama (Önerilen)

Son Güncelleme:Oct 07, 2026

CPFS, NFS protokolü üzerinden erişimi destekler. Bir CPFS dosya sistemi oluşturduktan sonra protokol hizmetini etkinleştirin ve bir dışa aktarma dizini oluşturarak bir bağlama hedefi oluşturun. Ardından bir ECS örneğine CPFS-NFS istemcisini yükleyin ve dosya sistemine erişmek için bağlama komutunu çalıştırın. Dışa aktarma dizinine yönelik bağlama hedefi, POSIX bağlama hedeflerinden bağımsızdır. CPFS dosya sistemine yalnızca NFS protokolü üzerinden erişmeniz gerekiyorsa POSIX bağlama hedefi oluşturmanız gerekmez. Mevcut bir POSIX bağlama hedefinin silinmesi, dışa aktarma dizini aracılığıyla veri erişimini etkilemez.

Ön koşullar

Kullanım

Desteklenen işletim sistemleri

İşletim sistemi türü

İşletim sistemi sürümü

Alibaba Cloud Linux

  • Alibaba Cloud Linux 3.2104 64-bit

  • Alibaba Cloud Linux 2.1903 64-bit

CentOS

  • CentOS 8.x 64-bit

  • CentOS 7.x 64-bit

Ubuntu

  • Ubuntu 20.04 64-bit

  • Ubuntu 18.04 64-bit

  • Ubuntu 16.04 64-bit

Debian

  • Debian 10.x 64-bit

  • Debian 9.x 64-bit

  • Debian 8.x 64-bit

SUSE

  • SUSE Linux Enterprise Server 15 64-bit

IP adresleri ve bağlantı noktaları

CPFS-NFS istemcisi, bir dosya sistemi bağlarken port eşlemesi için yerel IP adresi 127.0.1.255 ve 30000 ile 60000 arasındaki TCP bağlantı noktası aralığını kullanır.

Başka bir uygulama zaten 127.0.1.255 IP adresini veya 30000 ile 60000 arasındaki bağlantı noktası aralığını kullanıyorsa CPFS-NFS istemci yapılandırmasını değiştirin. Daha fazla bilgi için bkz. İstemci yapılandırması.

Dosya dizinleri

CPFS-NFS istemcisini yüklemek, ECS örneğinde aşağıdaki dizinleri oluşturur: yapılandırma dosyası dizini (/etc/aliyun/cpfs), çalışma zamanı dizini (/var/run/cpfs) ve günlük dizini (/var/log/aliyun/cpfs/).

Çalışma zamanı dizini, otomatik olarak oluşturulan haproxy yapılandırma dosyalarını depolar. hp_config_dir seçeneğini kullanarak özel bir yol belirtirseniz bunun yerine bu yol kullanılır.

İşlemler

CPFS-NFS istemcisini kullanarak bir CPFS dosya sistemi bağladıktan sonra G/Ç erişimi için ECS örneğinde bir haproxy işlemi başlar. Ayrıca CPFS-NFS istemcisinin durumunu izlemek için bir watchdog işlemi başlatılır.

İstemci günlükleri

/var/log/aliyun/cpfs/ dizinindeki CPFS-NFS istemci günlüklerinde bağlama hatalarıyla ilgili bilgilere ulaşabilirsiniz. Günlük içeriğini özelleştirmek için /etc/aliyun/cpfs/cpfs-utils.conf konumundaki günlük yapılandırma dosyasındaki parametreleri değiştirin. Yapılandırma dosyasını değiştirdikten sonra arka plandaki watchdog işlemini yeniden başlatmak için sudo service aliyun-cpfs-mount-watchdog restart komutunu çalıştırın.

Adım 1: CPFS-NFS istemcisini indirip yükleme

Bu istemci açık kaynaktır. Kaynak koduna erişmek veya manuel olarak derlemek için GitHub deposunu ziyaret edin.
  1. CPFS dosya sistemini bağlayacağınız ECS örneğinde oturum açın. Bir ECS örneğine bağlanma hakkında daha fazla bilgi için bkz. Bağlantı yöntemleri.

  2. CPFS-NFS istemcisini indirin ve yükleyin.

    Alibaba Cloud Linux

    1. CPFS-NFS istemcisini indirin.

      wget https://cpfs-hangzhou-nfs-client.oss-cn-hangzhou.aliyuncs.com/aliyun-alinas-utils-latest.al.noarch.rpm
    2. CPFS-NFS istemcisini yükleyin.

      sudo yum install aliyun-alinas-utils-*.rpm

    CentOS

    1. CPFS-NFS istemcisini indirin.

      wget https://cpfs-hangzhou-nfs-client.oss-cn-hangzhou.aliyuncs.com/aliyun-alinas-utils-latest.el.noarch.rpm
    2. CPFS-NFS istemcisini yükleyin.

      sudo yum install aliyun-alinas-utils-*.rpm

    Ubuntu

    1. CPFS-NFS istemcisini indirin.

      sudo wget https://cpfs-hangzhou-nfs-client.oss-cn-hangzhou.aliyuncs.com/aliyun-alinas-utils-latest.deb -O /tmp/aliyun-alinas-utils-latest.deb
    2. CPFS-NFS istemcisini yükleyin.

      sudo apt-get update
      sudo apt-get install /tmp/aliyun-alinas-utils-latest.deb

    Debian

    1. CPFS-NFS istemcisini indirin.

      sudo wget https://cpfs-hangzhou-nfs-client.oss-cn-hangzhou.aliyuncs.com/aliyun-alinas-utils-latest.deb -O /tmp/aliyun-alinas-utils-latest.deb
    2. CPFS-NFS istemcisini yükleyin.

      sudo apt-get update
      sudo apt-get install /tmp/aliyun-alinas-utils-latest.deb

    SUSE

    1. CPFS-NFS istemcisini indirin.

      wget https://cpfs-hangzhou-nfs-client.oss-cn-hangzhou.aliyuncs.com/aliyun-alinas-utils-latest.lp15.x86_64.rpm
    2. CPFS-NFS istemcisini yükleyin.

      sudo zypper --no-gpg-checks install -y aliyun-alinas-utils-*.rpm
  3. Yüklemeyi doğrulayın.

    which mount.cpfs-nfs

    Başarılı bir yükleme aşağıdaki çıktıyı döndürür:

    /usr/sbin/mount.cpfs-nfs

Adım 2: Dosya sistemini istemci ile bağlama

  1. CPFS dosya sistemini bağlayın.

    1. Senaryo 1: Genel bağlama (varsayılan yol)

      Bu senaryo, AppArmor, SELinux veya diğer özel yol erişim kısıtlamalarının etkin olmadığı çoğu ortam için geçerlidir.

      sudo mount -t cpfs-nfs -o vers=3,rsize=1048576,wsize=1048576,hard,timeo=600,retrans=2,noresvport file-system-id.region.cpfs.aliyuncs.com:/share/path /mnt
    2. Senaryo 2: Yüksek güvenlikli ortamda bağlama (örneğin, SELinux veya AppArmor'un etkin olduğu sistemlerde)

      İşletim sisteminizde AppArmor veya SELinux gibi güvenlik sıkılaştırma ilkeleri etkinse varsayılan bağlama işlemi erişim hatalarına neden olabilir. Bu durumda hp_config_dir seçeneğini kullanarak bir yol belirtin. Komutu çalıştırırken <custom_directory> değerini sisteminizin güvenlik ilkesinin izin verdiği bir yolla değiştirin.

      sudo mount -t cpfs-nfs -o vers=3,rsize=1048576,wsize=1048576,hard,timeo=600,retrans=2,noresvport,hp_config_dir=<custom_directory> file-system-id.region.cpfs.aliyuncs.com:/share/path /mnt
  2. Bağlama komutu parametreleri

    Parametre

    Açıklama

    file-system-id.region.cpfs.aliyuncs.com:/share/path /mnt

    Bağlama yolunu ve yerel yolu belirtir. Bunları gerçek değerlerinizle değiştirin.

    • Bağlama yolu: Dışa aktarma dizininin bağlama yolu. File Storage NAS konsolunda dosya sistemi listesi sayfasında hedef dosya sistemi için Manage seçeneğine tıklayarak Protocol Service sayfasına gidin. Actions sütununda Export Directory seçeneğine tıklayarak Export Directory panelini açın ve bağlama yolunu alın.

      Örnek: cpfs-196f91a8e58b**-195ceeac7b6ac**.cn-chengdu.cpfs.aliyuncs.com:/share/fileset

    • Yerel yol: Dosya sistemini bağlamak istediğiniz ECS örneğindeki yol. Bu, kök dizin (/) veya /mnt gibi herhangi bir alt dizin olabilir. Bir alt dizin belirtirseniz dizinin zaten var olduğundan emin olun.

    vers

    NFS sürümü. CPFS yalnızca NFSv3'ü destekler.

    Bağlama seçenekleri

    Virgülle (,) ayrılmış birden çok bağlama seçeneği belirtebilirsiniz. Aşağıdaki seçenekler kullanılabilir:

    • rsize: İstemci ile dosya sistemi arasında veri okumak için kullanılan veri bloğunun boyutu (bayt cinsinden). Önerilen değer: 1048576.

    • wsize: İstemci ile dosya sistemi arasında veri yazmak için kullanılan veri bloğunun boyutu (bayt cinsinden). Önerilen değer: 1048576.

      Not

      G/Ç boyutu parametrelerini (rsize ve wsize) değiştirmeniz gerekiyorsa performans düşüşünü önlemek için maksimum değeri (1048576) kullanmanızı öneririz.

    • hard: CPFS dosya sistemi geçici olarak kullanılamaz duruma gelirse dosya sistemindeki bir dosyayı kullanan yerel bir uygulama durur ve dosya sistemi çevrimiçi olana kadar bekler. Bu seçenek önerilir.

    • timeo: CPFS-NFS istemcisinin dosya sistemine yönelik bir isteği yeniden denemeden önce yanıt için beklediği süre (saniyenin onda biri cinsinden). Önerilen değer: 600 (60 saniye).

      Not

      Zaman aşımı parametresini (timeo) değiştirmeniz gerekirse 150 veya daha büyük bir değer kullanmanızı öneririz. Bu değer saniyenin onda biri cinsindendir, dolayısıyla 150 değeri 15 saniyeye karşılık gelir.

    • retrans: CPFS-NFS istemcisinin bir isteği yeniden deneme sayısı. Önerilen değer: 2.

    • noresvport: Ağ hatası kurtarma sırasında bağlantının kesilmemesini sağlamak için ağ yeniden bağlantısında yeni bir TCP bağlantı noktası kullanır. Bu seçenek önerilir.

      Önemli
      • soft seçeneği veri tutarlılığı açısından risk oluşturduğu için önerilmez. soft seçeneğini kullanırsanız tüm ilişkili riskleri üstlenmiş olursunuz.

      • Diğer bağlama seçeneklerinin değerlerini önerilen değerlerden farklı olacak şekilde ayarlamaktan kaçının. Örneğin okuma veya yazma arabellek boyutlarını değiştirmek veya nitelik önbelleğe almayı devre dışı bırakmak performansı düşürebilir.

    • hp_config_dir: (İsteğe bağlı) Haproxy yapılandırma dosyasını içeren dizini belirtir. İşletim sisteminizde süreçlerin yalnızca belirli yollarda yapılandırma okumasını veya çalıştırmasını kısıtlayan güvenlik uygulaması ilkeleri (örneğin AppArmor veya SELinux) ya da diğer yüksek güvenlik ilkeleri varsa bu parametreyi ayarlayın.

      • Yol seçimi önerisi: Sisteminizin güvenlik ilkesi izin listesinden uygun bir dizin seçin ve yolun güvenlik modülü tarafından yetkilendirildiğinden emin olun.

      • Mantık: CPFS istemcisi öncelikle bu parametreyle belirtilen dizini kullanmaya çalışır. Bu parametreyi belirtmezseniz istemci güvenlik ilkesi izin listesini otomatik olarak ayrıştırmaya çalışır. Ayrıştırma başarısız olursa istemci varsayılan /var/run/cpfs yoluna geri döner.

  3. Bağlama bilgilerini görüntülemek için mount -l komutunu çalıştırın.

    Dosya sistemi bağlandıktan sonra dosya sisteminin kapasite bilgilerini görüntülemek için df -h komutunu çalıştırabilirsiniz.

  4. (İsteğe bağlı) Başlangıçta otomatik bağlamayı yapılandırın.

    ECS örneği yeniden başlatıldıktan sonra bağlama bilgilerinin kaybolmasını önlemek için /etc/fstab dosyasını yapılandırmanız gerekir. Manuel bağlama sırasında hp_config_dir parametresini kullandıysanız bunu burada da yapılandırmanız gerekir.

    1. /etc/fstab yapılandırma dosyasını açın ve bağlama yapılandırmasını ekleyin.

      • Genel bir ortam için yapılandırma:

        file-system-id.region.cpfs.aliyuncs.com:/share/path /mnt cpfs-nfs vers=3,rsize=1048576,wsize=1048576,hard,timeo=600,retrans=2,_netdev,noresvport 0 0
      • Yüksek güvenlikli bir ortam için örnek yapılandırma:

        <custom_directory> değerini sisteminizin güvenlik ilkesinin izin verdiği bir yolla değiştirin.

        file-system-id.region.cpfs.aliyuncs.com:/share/path /mnt cpfs-nfs vers=3,rsize=1048576,wsize=1048576,hard,timeo=600,retrans=2,_netdev,noresvport,hp_config_dir=<custom_directory> 0 0
      • Aşağıdaki tabloda diğer parametreler açıklanmaktadır.


        Parametre


        Açıklama


        _netdev


        İstemcinin ağ hazır olmadan önce dosya sistemini bağlamaya çalışmasını engeller.


        0 (noresvport'tan sonraki ilk öğe)


        Sıfırdan farklı bir değer dump komutunun dosya sistemini yedeklemesi gerektiğini gösterir. CPFS dosya sistemleri için bu değer 0'dır.


        0 (noresvport'tan sonraki ikinci öğe)


        Fsck komutunun başlangıçta dosya sistemini kontrol etme sırasını belirtir. CPFS dosya sistemleri için bu değer 0'dır ve fsck'nin başlangıçta çalışmasını engeller.

    2. ECS örneğini yeniden başlatmak için reboot komutunu çalıştırın.

      ECS örneğini yeniden başlatmadan önce örneğin yeniden başlatılamamasını önlemek için manuel bağlamanın başarılı olduğunu onaylayın. Otomatik bağlama başarıyla yapılandırılırsa ECS örneği yeniden başlatıldıktan sonra df -h komutunu çalıştırarak bağlanan CPFS dosya sistemini görüntüleyebilirsiniz.

İstemci yapılandırması

Yapılandırma dosyası

CPFS-NFS istemci yapılandırmasını değiştirmeniz gerekiyorsa CPFS teknik destek ekibiyle iletişime geçin. G/Ç erişiminin kesintiye uğramasını önlemek için yapılandırma dosyasını yalnızca onların rehberliğinde değiştirin. Yapılandırma dosyası /etc/aliyun/cpfs/cpfs-utils.conf konumunda bulunur. Aşağıda bir yapılandırma örneği verilmiştir:

[DEFAULT]
logging_level = INFO
logging_max_bytes = 1048576
logging_file_count = 10

[mount]
stunnel_debug_enabled = false

# Validate the certificate hostname on mount. This option is not supported by certain stunnel versions.
stunnel_check_cert_hostname = false

# Use OCSP to check certificate validity. This option is not supported by certain stunnel versions.
stunnel_check_cert_validity = false
proxy_port = 12049

cpfs_proxy_addr = 127.0.1.255
cpfs_proxy_port_min = 30000
cpfs_proxy_port_max = 60000

[mount-watchdog]
poll_interval_sec = 1
unmount_grace_period_sec = 30
dns_refresh_interval = 60

[client-tool]

Aşağıdaki tabloda yapılandırma dosyasındaki önemli parametreler açıklanmaktadır.


Parametre


Açıklama


logging_level


Günlük düzeyi. Varsayılan değer: INFO.


logging_max_bytes


Bir günlük dosyasının maksimum boyutu (bayt cinsinden). Varsayılan: 1048576 (1 MiB).


logging_file_count


Tutulacak maksimum günlük dosyası sayısı. Varsayılan değer: 10.


cpfs_proxy_addr


CPFS istemcisi için proxy IP adresi. Varsayılan değer: 127.0.1.255.


cpfs_proxy_port_min


CPFS istemcisi için proxy bağlantı noktası aralığının minimum değeri. Varsayılan değer: 30000.


cpfs_proxy_port_max


CPFS istemcisi için proxy bağlantı noktası aralığının maksimum değeri. Varsayılan değer: 60000.


poll_interval_sec


Arka plandaki watchdog hizmeti için algılama aralığı. Varsayılan değer: 1 sn.


unmount_grace_period_sec


Bir CPFS-NFS bağlama hedefini kaldırdıktan sonra ilgili yapılandırma dosyalarını temizlemek için verilen süre. Varsayılan değer: 30 sn.


dns_refresh_interval


Arka plandaki watchdog hizmetinin birincil ve ikincil düğümlerin kullanılabilir olup olmadığını belirlemek için DNS kayıtlarını kontrol ettiği aralık. Varsayılan değer: 60 sn.

Haproxy yapılandırması

Bağlama işlemi sırasında CPFS-NFS istemcisi otomatik olarak bir haproxy yapılandırma dosyası oluşturur ve ilgili işlemleri başlatır. Bu yapılandırma dosyasını manuel olarak değiştirmeyin. Aksi takdirde G/Ç erişimi kesintiye uğrayabilir. Ayrıntılar için haproxy-config.dns yapılandırma dosyasını görüntüleyebilirsiniz. Varsayılan olarak bu dosya /var/run/cpfs/ dizininde depolanır. Bağlama sırasında hp_config_dir parametresini belirttiyseniz dosya belirtilen özel dizinde depolanır. Aşağıdaki kod dosya içeriğine bir örnek göstermektedir:

global
    maxconn 4096

defaults
    mode    tcp
    balance leastconn
    timeout client      60s
    timeout server      60s
    timeout connect     3s
    retries 3

frontend cpfs2049
    bind 127.0.1.255:30000
    default_backend bk2049

backend bk2049
    server cpfs_primary 172.27.1.189:2049 maxconn 2048 check port 2049 inter 2s fall 5 rise 30 on-marked-up shutdown-backup-sessions
    server cpfs_backup  172.27.0.214:2049 maxconn 2048 check port 2049 inter 2s fall 5 rise 30 backup

Aşağıdaki tabloda önemli parametreler açıklanmaktadır.


Parametre


Açıklama


defaults


Varsayılan parametre değerlerini değiştirmemeniz önerilir.


frontend


Haproxy proxy'si için yerel IP adresi ve bağlantı noktası. Varsayılan IP adresi 127.0.1.255 ve bağlantı noktası aralığı 30000 ile 60000 arasındadır.


backend


Arka uç CPFS-NFS hizmetinin IP adresleri; burada cpfs_primary birincil düğümü ve cpfs_backup ikincil düğümü belirtir.

SSS

İlgili konular