安裝或升級 Cloud Storage FUSE

如要將 Cloud Storage bucket 掛接為本機檔案系統，請先在機器上安裝 Cloud Storage FUSE。本文說明如何使用預先建構的 Linux 二進位檔或最新原始碼安裝 Cloud Storage FUSE，以及如何升級至最新版本。如要瞭解 Cloud Storage FUSE 支援哪些架構、作業系統和架構，請參閱「架構、作業系統和架構」。

使用預先建構的 Linux 二進位檔安裝 Cloud Storage FUSE

如要使用預先建構的 Linux 程式庫安裝或升級 Cloud Storage FUSE，請完成下列操作說明。

設定套件管理工具

Ubuntu/Debian

如果您的發行版本支援 signed-by 選項，請完成下列操作說明：

1. 安裝必要套件：

   sudo apt-get update
   sudo apt-get install -y curl lsb-release

2. 將 Cloud Storage FUSE 發行版本網址新增為套件來源：

   export GCSFUSE_REPO=gcsfuse-`lsb_release -c -s`
   echo "deb [signed-by=/usr/share/keyrings/cloud.google.asc] https://packages.cloud.google.com/apt $GCSFUSE_REPO main" | sudo tee /etc/apt/sources.list.d/gcsfuse.list

3. 匯入 Google Cloud 公開金鑰：

   curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo tee /usr/share/keyrings/cloud.google.asc

如果您的發行版本過舊，不支援 signed-by 選項，請按照下列指示操作：

1. 將 Cloud Storage FUSE 發行版本網址新增為套件來源：

   export GCSFUSE_REPO=gcsfuse-`lsb_release -c -s`
   echo "deb https://packages.cloud.google.com/apt $GCSFUSE_REPO main" | sudo tee /etc/apt/sources.list.d/gcsfuse.list

2. 匯入 Google Cloud 公開金鑰：

   curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -

CentOS/Red Hat/Rocky Linux

如果您使用的是 CentOS、Red Hat 或 Rocky Linux 作業系統，請完成下列操作說明：

1. 設定 Cloud Storage FUSE 存放區和相關聯的公開金鑰：

   sudo tee /etc/yum.repos.d/gcsfuse.repo > /dev/null <<EOF
   [gcsfuse]
   name=gcsfuse (packages.cloud.google.com)
   baseurl=https://packages.cloud.google.com/yum/repos/gcsfuse-el7-x86_64
   enabled=1
   gpgcheck=1
   repo_gpgcheck=0
   gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg
         https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
   EOF

2. 如果尚未安裝 FUSE，請使用 YUM Linux 套件管理工具安裝：

   sudo yum install fuse

SUSE Linux

如果您使用的是 SUSE Linux 作業系統，請按照下列指示操作：

1. 設定 Cloud Storage FUSE 存放區和相關聯的公開金鑰：

   sudo tee /etc/zypp/repos.d/gcsfuse.repo > /dev/null <<EOF
   [gcsfuse]
   name=gcsfuse (packages.cloud.google.com)
   baseurl=https://packages.cloud.google.com/yum/repos/gcsfuse-el7-x86_64
   enabled=1
   gpgcheck=1
   repo_gpgcheck=0
   gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg
         https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
   EOF

2. 如果尚未安裝 FUSE，請使用 ZYPPER Linux 套件管理工具安裝：

   sudo zypper install fuse

安裝或升級 Cloud Storage FUSE

Ubuntu/Debian

更新可用套件清單，並安裝 Cloud Storage FUSE：

sudo apt-get update
sudo apt-get install gcsfuse

CentOS/Red Hat/Rocky Linux

如果您使用的是 CentOS、Red Hat 或 Rocky Linux 作業系統，請執行下列指令：

安裝 Cloud Storage FUSE：

sudo yum install gcsfuse

請務必對任何有關新增 GPG 簽署金鑰的問題回答「yes」。

SUSE Linux

如果您使用的是 SUSE Linux 作業系統，請執行下列指令：

安裝 Cloud Storage FUSE：

sudo zypper install gcsfuse

請務必對任何有關新增 GPG 簽署金鑰的問題回答「是」。

或者，您也可以直接從 GitHub 下載最新的預先建構 Cloud Storage FUSE 套件。

如要使用預先建構的 Linux 二進位檔，升級至最新版 Cloud Storage FUSE，請按照下列操作說明操作：

Ubuntu/Debian

如果您使用的是 Ubuntu 或 Debian Linux 作業系統，請使用下列指令升級至最新版本的 Cloud Storage FUSE：

sudo apt-get update
sudo apt-get install --only-upgrade gcsfuse

CentOS/Red Hat/Rocky Linux

如果您使用的是 CentOS、Red Hat 或 Rocky Linux 作業系統，請使用下列指令升級至最新版 Cloud Storage FUSE：

sudo apt-get update
sudo yum -y upgrade gcsfuse

SUSE Linux

如果您使用的是 SUSE Linux 作業系統，請使用下列指令升級至最新版 Cloud Storage FUSE：

sudo zypper refresh
sudo zypper -n update gcsfuse

建構最新原始碼，安裝或升級 Cloud Storage FUSE

如要透過從 GitHub 建構最新原始碼來安裝或升級 Cloud Storage FUSE，請完成下列操作說明：

1. 如果尚未安裝，請安裝 fuse、git 和 go (請參閱 go.mod，瞭解最新版本的 go)。

2. 使用 go install 指令安裝 Cloud Storage FUSE：

   go install github.com/googlecloudplatform/gcsfuse/v3@master

   如果成功，名為 gcsfuse 的二進位檔會安裝到 $GOPATH/bin。GOPATH 是環境變數，用於尋找 go 工作區的根目錄。

或者，您也可以將 Git 存放區複製到本機檔案系統，藉此安裝 Cloud Storage FUSE：

1. 複製 Cloud Storage FUSE 存放區：

   git clone https://github.com/GoogleCloudPlatform/gcsfuse.git

2. 將目前使用的目錄切換至包含 Cloud Storage FUSE 存放區的 gcsfuse 資料夾：

   cd gcsfuse

3. 使用 go install 指令安裝 Cloud Storage FUSE：

   go install .

   如果成功，名為 gcsfuse 的二進位檔會安裝到 $GOPATH/bin。

如要使用原始碼升級至最新版本 Cloud Storage FUSE，請重新執行安裝操作說明。

後續步驟

• 瞭解如何使用 Cloud Storage FUSE 掛接 bucket。
• 瞭解如何排解 Cloud Storage FUSE 安裝問題。