Memasang fitur berbagi file di klien Compute Engine

Halaman ini menunjukkan cara memasang berbagi file Filestore di instance virtual machine (VM) Compute Engine yang berada dalam Google Cloud project dan jaringan VPC yang sama. Untuk mempelajari cara memasang fitur berbagi file di klien dalam jaringan jarak jauh, lihat Memasang fitur berbagi file di klien jarak jauh. Jika Anda ingin mengakses instance Filestore dari cluster Google Kubernetes Engine, lihat Mengakses instance Filestore dengan driver CSI Filestore.

Sebelum memulai

Pastikan firewall jaringan dikonfigurasi dengan benar untuk digunakan dengan Filestore. Lihat Mengonfigurasi aturan firewall untuk mengetahui detailnya.

Memasang fitur berbagi file di instance VM Compute Engine

Gunakan salah satu prosedur berikut untuk memasang berbagi file Filestore di VM Compute Engine. Sebaiknya pasang ke VM n1-standard-8 atau yang lebih tinggi untuk performa yang optimal.

Linux: mount

Untuk memasang fitur berbagi file secara manual ke VM klien Linux:

  1. Di konsol Google Cloud , buka halaman VM Instances.

    Buka halaman Instance VM

  2. Temukan VM Linux yang ingin Anda gunakan sebagai klien, lalu klik SSH untuk membuka terminal di VM tersebut.

  3. Opsional: Memasang berbagi file di VM klien dengan beberapa antarmuka jaringan melalui jaringan sekunder.

    Detail (Klik untuk meluaskan)

    Jika Anda ingin memasang berbagi file melalui jaringan sekunder, yaitu antarmuka selain nic0, Anda harus mengubah kebijakan perutean VM klien. Jalankan:

    sudo ip route \
    add filestore-reserved-address-range \
    via default-gateway-of-nic-to-filestore

    dengan:

    • filestore-reserved-address-range adalah rentang alamat IP yang dicadangkan untuk digunakan oleh instance Filestore.
    • default-gateway-of-nic-to-filestore adalah alamat IP gateway default dari NIC yang terhubung ke jaringan VPC yang digunakan bersama dengan instance Filestore.

    Untuk mengetahui informasi selengkapnya tentang cara menggunakan instance Compute Engine dengan beberapa NIC, lihat Mengonfigurasi perutean untuk antarmuka jaringan tambahan.

  4. Instal NFS:

    Debian/Ubuntu

    Gunakan perintah berikut untuk menginstal NFS di Debian atau Ubuntu.

    sudo apt-get -y update &&
    sudo apt-get install nfs-common

    RHEL/CentOS

    Gunakan perintah berikut untuk menginstal NFS di Red Hat Enterprise Linux atau CentOS.

    sudo yum update &&
    sudo yum install nfs-utils

    SUSE

    Gunakan perintah berikut untuk menginstal NFS di SUSE.

    sudo zypper update &&
    sudo zypper -n install nfs-client

  5. Buat direktori lokal untuk dipetakan ke berbagi file Filestore:

    sudo mkdir -p mount-point-directory

    dengan mount-point-directory adalah direktori yang akan dibuat, misalnya /mnt/filedir.

  6. Pasang berbagi file dari instance Filestore dengan menjalankan perintah mount. Anda dapat menggunakan opsi pemasangan NFS. Untuk performa terbaik, sebaiknya gunakan opsi mount NFS berikut:

    Opsi Deskripsi
    hard Klien NFS mencoba lagi permintaan NFS tanpa batas waktu. Untuk mengurangi kemungkinan gangguan I/O saat instance Filestore di-reboot, sebaiknya gunakan opsi pemasangan hard untuk klien Linux dan Windows.
    timeo=600 Klien NFS menunggu 600 desidetik (60 detik) sebelum mencoba lagi permintaan NFS.
    retrans=3 Klien NFS mencoba permintaan NFS tiga kali sebelum melakukan tindakan pemulihan lebih lanjut.
    rsize=524288 Klien NFS dapat menerima maksimum 524.288 byte dari server NFS per permintaan READ.
    Catatan: Untuk instance tingkat dasar, tetapkan nilai rsize ke 1048576.
    wsize=1048576 Klien NFS dapat menerima maksimum 1.048.576 byte dari server NFS per permintaan WRITE.
    resvport Klien NFS menggunakan port sumber yang memiliki hak istimewa saat berkomunikasi dengan server NFS untuk direktori pemasangan ini.
    async Klien NFS menunda pengiriman penulisan aplikasi ke server NFS hingga kondisi tertentu terpenuhi.
    Perhatian: Menggunakan opsi sync akan mengurangi performa secara signifikan.

    • Untuk mengurangi latensi pemasangan, tentukan opsi -o tcp.

    • Jika Anda memasang instance regional, zonal, atau enterprise ke VM klien yang menjalankan kernel Linux versi 5.3+, pertimbangkan untuk menentukan opsi pemasangan nconnect untuk meningkatkan performa NFS. Untuk tingkat layanan tertentu, sebaiknya tentukan jumlah koneksi berikut antara klien dan server:

      Tingkat Kapasitas Jumlah koneksi
      Regional, zonal 1-9,75 TiB nconnect=2
      Regional, zonal 10-100 TiB nconnect=7
      Enterprise - nconnect=2
      SSD skala tinggi - nconnect=7

      Secara umum, semakin besar kapasitas berbagi file dan semakin sedikit VM klien yang terhubung, semakin besar peningkatan performa yang Anda peroleh dengan menentukan koneksi tambahan dengan nconnect.

    Jalankan perintah mount dengan opsi pilihan Anda, seperti berikut:

    sudo mount -o rw ip-address:/file-share mount-point-directory

    dengan:

    • ip-address adalah alamat IP untuk instance Filestore.
    • file-share adalah nama berbagi file di instance.
    • mount-point-directory adalah jalur tempat Anda ingin memetakan berbagi file Filestore.

    Anda bisa mendapatkan alamat IP dan nama berbagi file instance dari salah satu sumber berikut:

    Misalnya, dengan instance Filestore yang memiliki alamat IP 10.0.1.2 dan berbagi file bernama share1, perintah berikut memasang berbagi file ke direktori titik pemasangan lokal /mnt/render:

    sudo mount 10.0.1.2:/share1 /mnt/render

  7. Opsional: Jalankan chmod untuk menetapkan izin pada direktori pemasangan sehingga pengguna selain pengguna root dapat menulis ke direktori tersebut. Untuk menetapkan izin direktori, jalankan perintah berikut:

    sudo chmod permissions mount-point-directory

    dengan:

    • permissions adalah kumpulan izin yang akan diberikan. Misalnya, chmod go+rw membuat direktori dapat dibaca dan ditulis oleh anggota dalam grup yang memiliki direktori dan semua pengguna lainnya. Untuk mengetahui informasi selengkapnya tentang cara menetapkan izin, lihat Mengonfigurasi akses di berbagi file.
    • mount-point-directory adalah jalur ke direktori tempat berbagi file Filestore dipasang.

  8. Opsional: Pastikan berbagi file Filestore telah di-mount:

    df -h --type=nfs

    Output harus berisi entri yang mirip dengan berikut ini:

    Filesystem        Size    Used  Avail  Use%  Mounted on
10.0.1.2:/share1  1018G   76M   966G   1%    /mnt/render
10.0.2.2:/vol3    1018G   76M   966G   1%    /mnt/filestore3

  9. Jika perlu menggunakan penguncian file NFS, Anda mungkin perlu menyetel port yang digunakan oleh daemon statd dan nlockmgr serta mengonfigurasi aturan firewall untuk membuka port tersebut.

Linux: /etc/fstab

Anda dapat membuat berbagi file dipasang secara otomatis ke VM klien selama proses booting dengan mengubah file /etc/fstab klien:

  1. Di konsol Google Cloud , buka halaman VM Instances.

    Buka halaman Instance VM

  2. Temukan VM Linux yang ingin Anda gunakan sebagai klien, lalu klik SSH untuk membuka terminal di VM tersebut.

  3. Opsional: Memasang berbagi file di VM klien yang memiliki beberapa antarmuka jaringan melalui jaringan sekunder.

    Detail (Klik untuk meluaskan)

    Jika Anda ingin memasang berbagi file melalui jaringan sekunder, yaitu antarmuka selain nic0, Anda harus mengubah kebijakan perutean VM klien:

    • Di /etc/default/instance_configs.cfg, tetapkan flag setup untuk NetworkInterfaces ke false: 
      [NetworkInterfaces]
dhclient_script = /sbin/google-dhclient-script
dhcp_command =
ip_forwarding = true
   setup = false

    • Di /etc/network/interfaces, tambahkan baris berikut:

      auto eth1
iface eth1 inet dhcp
    up ip route add filestore-reserved-address-range via default-gateway-of-nic-to-filestore

    dengan:

    • filestore-reserved-address-range adalah rentang alamat IP yang dicadangkan untuk digunakan oleh instance Filestore.
    • default-gateway-of-nic-to-filestore adalah alamat IP gateway default dari NIC yang terhubung ke jaringan VPC yang digunakan bersama dengan instance Filestore.

    Untuk mengetahui informasi selengkapnya tentang cara menggunakan instance Compute Engine dengan beberapa NIC, lihat Mengonfigurasi perutean untuk antarmuka jaringan tambahan.

  4. Instal NFS:

    Debian/Ubuntu

    Gunakan perintah berikut untuk menginstal NFS di Debian atau Ubuntu.

    sudo apt-get -y update &&
    sudo apt-get install nfs-common

    RHEL/CentOS

    Gunakan perintah berikut untuk menginstal NFS di Red Hat Enterprise Linux atau CentOS.

    sudo yum update &&
    sudo yum install nfs-utils

    SUSE

    Gunakan perintah berikut untuk menginstal NFS di SUSE.

    sudo zypper update &&
    sudo zypper -n install nfs-client

  5. Buat direktori lokal untuk dipetakan ke berbagi file Filestore:

    sudo mkdir -p mount-point-directory

    dengan mount-point-directory adalah direktori yang akan dibuat, misalnya /mnt/filedir.

  6. Buka file /etc/fstab:

    sudo vim /etc/fstab

  7. Tambahkan baris berikut di file /etc/fstab:

    ip-address:/file-share mount-point-directory nfs options,_netdev 0 0

    dengan:

    • ip-address adalah alamat IP untuk instance Filestore.
    • file-share adalah nama berbagi file di instance.
    • mount-point-directory adalah jalur yang ingin Anda petakan ke berbagi file Filestore.

    • options adalah opsi pemasangan NFS. Sebaiknya pertahankan opsi pemasangan NFS default, dengan pengecualian berikut:

      • Untuk pemasangan otomatis, sebaiknya tentukan -o tcp untuk mengurangi latensi saat memasang dan melepas.
      • Jika Anda memasang instance regional, zonal, atau enterprise ke VM klien yang menjalankan kernel Linux versi 5.3+, pertimbangkan untuk menentukan opsi pemasangan nconnect untuk meningkatkan performa NFS. Untuk tingkat layanan tertentu, sebaiknya tentukan jumlah koneksi berikut antara klien dan server:
      Tingkat Kapasitas Jumlah koneksi
      Regional, zonal 1-9,75 TiB nconnect=2
      Regional, zonal 10-100 TiB nconnect=7
      Enterprise - nconnect=2
      SSD skala tinggi - nconnect=7

      Secara umum, semakin besar kapasitas berbagi file dan semakin sedikit VM klien yang terhubung, semakin besar peningkatan performa yang Anda peroleh dengan menentukan koneksi tambahan dengan nconnect.

    Contoh: Baris berikut di /etc/fstab memasang berbagi file vol1 dari instance Filestore dengan alamat IP 10.0.0.2 di direktori titik pemasangan /mnt dengan opsi pemasangan default:

      10.0.0.2:/vol1 /mnt nfs defaults,_netdev 0 0

  8. Pasang semuanya di /etc/fstab:

        sudo mount -a

    Berbagi file kini otomatis di-mount setiap kali VM klien di-boot.

Linux: autofs

Anda dapat mengonfigurasi autofs untuk otomatis memasang berbagi file hanya saat diakses dan membiarkannya tidak terpasang saat tidak digunakan. Dibandingkan dengan memasang berbagi file secara statis di /etc/fstab, metode ini membantu menghemat resource VM klien dalam situasi saat klien perlu memetakan ke banyak titik pemasangan.

Instal NFS dan autofs di VM klien

  1. Di konsol Google Cloud , buka halaman VM Instances.

    Buka halaman Instance VM

  2. Temukan VM Linux yang ingin Anda gunakan sebagai klien, lalu klik SSH untuk membuka terminal di VM tersebut.

  3. Opsional: Memasang berbagi file di VM klien dengan beberapa antarmuka jaringan melalui jaringan sekunder.

    Detail (Klik untuk meluaskan)

    Jika Anda ingin memasang berbagi file melalui jaringan sekunder, yaitu antarmuka selain nic0, Anda harus mengubah kebijakan perutean VM klien:

    • Di /etc/default/instance_configs.cfg, tetapkan flag setup untuk NetworkInterfaces ke false: 
      [NetworkInterfaces]
dhclient_script = /sbin/google-dhclient-script
dhcp_command =
ip_forwarding = true
   setup = false
    • Di /etc/network/interfaces, tambahkan baris berikut: auto eth1 iface eth1 inet dhcp up ip route add filestore-reserved-address-range via default-gateway-of-nic-to-filestore

    dengan:

    • filestore-reserved-address-range adalah rentang alamat IP yang dicadangkan untuk digunakan oleh instance Filestore.
    • default-gateway-of-nic-to-filestore adalah alamat IP gateway default dari NIC yang terhubung ke jaringan VPC yang digunakan bersama dengan instance Filestore.

    Untuk mengetahui informasi selengkapnya tentang cara menggunakan instance Compute Engine dengan beberapa NIC, lihat Mengonfigurasi perutean untuk antarmuka jaringan tambahan.

  4. Instal NFS dengan menjalankan perintah berikut:

    Debian/Ubuntu

    Gunakan perintah berikut untuk menginstal NFS di Debian atau Ubuntu.

    sudo apt-get -y update &&
    sudo apt-get install nfs-common

    RHEL/CentOS

    Gunakan perintah berikut untuk menginstal NFS di Red Hat Enterprise Linux atau CentOS.

    sudo yum update &&
    sudo yum install nfs-utils

    SUSE

    Gunakan perintah berikut untuk menginstal NFS di SUSE.

    sudo zypper update &&
    sudo zypper -n install nfs-client

  5. Dari jendela terminal VM klien, instal autofs:

    Debian/Ubuntu 

    sudo apt-get install autofs

    RHEL/CentOS 

    sudo yum install autofs

    SUSE 

    sudo zypper -n install autofs

Mengonfigurasi autofs untuk memasang berbagi file secara dinamis ke VM klien

  1. Aktifkan autofs:

    sudo systemctl enable --now autofs

  2. Buat direktori lokal untuk dipetakan ke berbagi file Filestore:

    sudo mkdir -p mount-point-directory

    dengan mount-point-directory adalah direktori yang akan dibuat. Direktori ini tidak boleh berisi subdirektori. Dalam panduan ini, kita menggunakan /nfs sebagai direktori titik pemasangan.

  3. Buka file /etc/auto.master:

    sudo vim /etc/auto.master

  4. Tambahkan baris berikut di file /etc/auto.master:

    /nfs /etc/auto.nfs --timeout seconds

    dengan seconds adalah durasi dalam detik sebelum waktu tunggu pemasangan habis. Nilai defaultnya adalah 300. Menetapkan nilai ini ke 0 akan menonaktifkan pelepasan oleh autofs.

  5. Buat file bernama /etc/auto.nfs:

    sudo vim /etc/auto.nfs

  6. Tambahkan baris berikut di file /etc/auto.nfs:

    mount-point-subdir options ip-address:/file-share

    dengan:

    • mount-point-subdir adalah subdirektori di /nfs yang ingin Anda petakan ke berbagi file Filestore. Subdirektori ini dibuat secara dinamis dan tidak boleh ada di VM klien.

    • options adalah opsi pemasangan NFS. Sebaiknya pertahankan opsi pemasangan NFS default, dengan pengecualian berikut:

      • Untuk pemasangan otomatis, sebaiknya tentukan -o tcp untuk mengurangi latensi saat memasang dan melepas.
      • Jika Anda memasang instance regional, zonal, atau enterprise ke VM klien yang menjalankan kernel Linux versi 5.3+, pertimbangkan untuk menentukan opsi pemasangan nconnect untuk meningkatkan performa NFS. Untuk tingkat layanan tertentu, sebaiknya tentukan jumlah koneksi berikut antara klien dan server:
      Tingkat Kapasitas Jumlah koneksi
      Regional, zonal 1-9,75 TiB nconnect=2
      Regional, zonal 10-100 TiB nconnect=7
      Enterprise - nconnect=2
      SSD skala tinggi - nconnect=7

      Secara umum, semakin besar kapasitas berbagi file dan semakin sedikit VM klien yang terhubung, semakin besar peningkatan performa yang Anda peroleh dengan menentukan koneksi tambahan dengan nconnect.

      • ip-address adalah alamat IP untuk instance Filestore.
      • file-share adalah nama berbagi file di instance.

    Contoh: Baris berikut dalam /etc/auto.nfs memasang berbagi file vol1 instance Filestore dengan alamat IP 10.0.0.2 di subdirektori file-shares yang dibuat secara dinamis dengan akses read/write yang diberikan:

    file-shares -rw 10.0.0.2:/vol1

Menguji konfigurasi Anda

  1. Jika berbagi file di-mount, Anda harus meng-unmount-nya:

    sudo umount mount-point-directory

    dengan mount-point-directory adalah jalur tempat berbagi file Filestore dipetakan.

    Jika ada entri /etc/fstab yang memasang berbagi file saat booting sistem, pastikan untuk menghapusnya.

  2. Muat ulang autofs:

    sudo service autofs reload

  3. Konfirmasi bahwa konfigurasi Anda berfungsi:

    ls mount-point-directory/mount-point-subdir

    dengan:

    • mount-point-directory adalah direktori titik pemasangan yang ditunjukkan dalam file /etc/auto.master.
    • mount-point-subdir adalah subdirektori titik pemasangan yang ditunjukkan dalam file /etc/auto.nfs.

    Dari contoh kita, perintahnya adalah:

    ls /nfs/file-shares

    Jika pemasangan otomatis dikonfigurasi dengan benar, sistem akan memasang share file terlebih dahulu, lalu menampilkan hasil perintah ls. Berbagi file akan otomatis di-unmount setelah periode tidak aktif, yang ditentukan dalam nilai timeout yang ditentukan dalam file /etc/auto.master.

Windows

Hubungkan ke VM Windows

  1. Di konsol Google Cloud , buka halaman VM Instances.

    Buka halaman Instance VM

  2. Temukan VM Windows yang ingin Anda gunakan sebagai klien, lalu klik RDP untuk membuka koneksi desktop jarak jauh ke VM tersebut. Untuk mengetahui informasi selengkapnya, lihat Menghubungkan ke instance Windows.

Menginstal NFS di VM Windows

  1. Di VM Windows, buka PowerShell sebagai administrator untuk memastikan akses dan izin NFS yang tepat.

  2. Di PowerShell, instal klien NFS:

    Install-WindowsFeature -Name NFS-Client

  3. Mulai ulang instance VM Windows seperti yang diminta, lalu buka koneksi desktop jarak jauh baru.

Mengonfigurasi ID pengguna yang digunakan oleh klien NFS

  1. Di PowerShell, jalankan perintah berikut untuk membuat dua entri registri baru, AnonymousUid dan AnonymousGid:

    New-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\ClientForNFS\CurrentVersion\Default" `
    -Name "AnonymousUid" -Value "0" -PropertyType DWORD

    New-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\ClientForNFS\CurrentVersion\Default" `
    -Name "AnonymousGid" -Value "0" -PropertyType DWORD

  2. Mulai ulang layanan klien NFS:

    nfsadmin client stop

    nfsadmin client start

Memetakan berbagi file ke VM Windows

  1. Keluar dari PowerShell untuk keluar dari sesi administrator. Jika Anda melewati langkah ini, aplikasi yang berjalan di sesi pengguna standar tidak akan dapat melihat atau mengakses berbagi file ini.

    exit

  2. Opsional: Memasang berbagi file di VM klien dengan beberapa antarmuka jaringan melalui jaringan sekunder.

    Detail (Klik untuk meluaskan)

    Jika Anda ingin memasang berbagi file melalui jaringan sekunder, yaitu antarmuka selain nic0, Anda harus mengubah kebijakan perutean VM klien. Jalankan:

    route -p ^
    add filestore-reserved-address-range ^
    mask address-range-subnet-mask ^
    default-gateway-of-nic-to-filestore

    dengan:

    • filestore-reserved-address-range adalah rentang alamat IP yang dicadangkan untuk digunakan oleh instance Filestore.
    • address-range-subnet-mask adalah mask subnet dari filestore-reserved-address-range. Misalnya, rentang alamat yang dicadangkan /29 akan menggunakan subnet mask 255.255.255.248.
    • default-gateway-of-nic-to-filestore adalah alamat IP gateway default dari NIC yang terhubung ke jaringan VPC yang digunakan bersama dengan instance Filestore.

    Contoh:

    route -p add 10.65.21.176 mask 255.255.255.248 10.128.0.1

    Untuk mengetahui informasi selengkapnya tentang cara menggunakan instance Compute Engine dengan beberapa NIC, lihat Mengonfigurasi perutean untuk antarmuka jaringan tambahan.

  3. Dari Command Prompt, petakan berbagi file ke huruf drive:

    net use drive-letter: \\filestore-ip\file-share-name

    dengan:

    • filestore-ip adalah alamat IP instance Filestore.
    • file-share-name adalah nama berbagi file di instance Filestore.
    • drive-letter adalah huruf drive yang ingin Anda tetapkan untuk pemetaan.

    Contoh

    Perintah berikut memetakan berbagi file vol1 di instance Filestore dengan alamat IP 10.0.0.2 ke drive z: di VM Windows klien:

    net use Z: \\10.0.0.2\vol1

  4. Opsional: Untuk menggunakan penguncian file NFS, verifikasi hal berikut:

    1. Pastikan aturan firewall dikonfigurasi untuk semua port NFS yang diperlukan, termasuk statd dan nlockmgr.

    2. Pastikan klien NFS Windows dikonfigurasi dengan port yang dicadangkan menggunakan perintah yang mirip dengan berikut di PowerShell:

      nfsadmin client config protocol=tcp UseReservedPorts=yes
nfsadmin client stop
nfsadmin client start

Membuat dan memasang subdirektori di berbagi file

Setelah berbagi file Anda dipasang di VM klien, Anda dapat membuat subdirektori di berbagi file, yang kemudian dapat dipasang langsung oleh klien, bukan memasang seluruh berbagi file:

  1. Untuk membuat subdirektori di berbagi file yang terpasang, jalankan:

    sudo mkdir -p mount-point-directory/file-share-sub-dir

    dengan:

    • mount-point-directory adalah jalur tempat Anda memetakan berbagi file.
    • file-share-sub-dir adalah jalur subdirektori di berbagi file yang ingin Anda buat.

    Perintah ini akan membuat subdirektori di VM klien dan berbagi file. Misalnya, jika Anda memasang berbagi file 10.0.0.2:/vol1 ke direktori /mnt di VM klien, perintah sudo mkdir -p /mnt/nfs akan membuat 10.0.0.2:/vol1/nfs di berbagi file dan /mnt/nfs di VM klien.

  2. Opsional: Jika Anda ingin memasang subdirektori berbagi file ke direktori di VM klien tempat berbagi file dipasang, Anda harus melepas berbagi file terlebih dahulu:

    sudo umount mount-point-directory

    dengan mount-point-directory adalah direktori tempat berbagi file dipetakan.

  3. Pasang subdirektori:

    sudo mount ip-address:/file-share/file-share-sub-dir mount-point-directory

    dengan:

    • ip-address adalah alamat IP untuk instance Filestore.
    • file-share adalah nama berbagi file di instance.
    • file-share-sub-dir adalah jalur subdirektori di berbagi file yang akan di-mount.
    • mount-point-directory adalah jalur tempat Anda ingin memetakan berbagi file Filestore.

    Contoh: Dalam perintah berikut:

    sudo mount 10.0.0.2:/vol1/nfs /mnt/nfs
    • 10.0.0.2 adalah alamat IP instance Filestore.
    • vol1 adalah nama berbagi file.
    • nfs adalah subdirektori berbagi file.
    • /mnt/nfs adalah direktori di VM klien tempat subdirektori berbagi file nfs dipetakan.

Langkah berikutnya