From d33590ec98dcae15cc321cd4f1b0de80c15b59e0 Mon Sep 17 00:00:00 2001 From: Aaron Jacobs Date: Tue, 11 Aug 2015 10:04:48 +1000 Subject: [PATCH] Switched to Google Cloud distribution of .deb packages. --- docs/installing.md | 57 +++++++++++++++------------------------------- 1 file changed, 18 insertions(+), 39 deletions(-) diff --git a/docs/installing.md b/docs/installing.md index ace35e2e48..077a6350f6 100644 --- a/docs/installing.md +++ b/docs/installing.md @@ -15,55 +15,34 @@ ensure fuse is installed, then download and install the latest release package or tarball. The instructions vary by distribution. -## Ubuntu +## Ubuntu and Debian -Ensure that dependencies are present and that fuse is configured: +The following instructions set up `apt-get` to see updates to gcsfuse, and work +for the **vivid** and **trusty** [releases][ubuntu-releases] of Ubuntu, and the +**wheezy** [release][debian-releases] of Debian. - sudo apt-get install wget fuse daemon - sudo adduser $USER fuse +1. Add the gcsfuse distribution URL as a package source: -You may need to log out and then log back in to make sure that the change to -the `fuse` group takes effect. + export GCSFUSE_REPO=gcsfuse-`lsb_release -c -s` + echo "deb http://packages.cloud.google.com/apt $GCSFUSE_REPO main" | sudo tee /etc/apt/sources.list.d/google-cloud-sdk.list -Download and install the latest release package: - - wget https://github.com/GoogleCloudPlatform/gcsfuse/releases/download/v0.9.0/gcsfuse_0.9.0_amd64.deb - sudo dpkg --install gcsfuse_0.9.0_amd64.deb - - -## Debian - -Ensure that dependencies are present: - - sudo apt-get install wget fuse daemon - -Download and install the latest release package: - - wget https://github.com/GoogleCloudPlatform/gcsfuse/releases/download/v0.9.0/gcsfuse_0.9.0_amd64.deb - sudo dpkg --install gcsfuse_0.9.0_amd64.deb - -### Old versions of Debian +2. Import the Google Cloud public key: -On versions older than Debian 8, it is additionally necessary to add yourself -to the [`fuse` group][fuse-group]: + curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add - - sudo adduser $USER fuse +3. Update the list of packages available and install gcsfuse. -You may need to log out and then log back in to make sure that the change to -the group takes effect. Finally, on these old versions of Debian, there is a -bug causing `/dev/fuse` to have incorrect permissions (cf. [this][debian-bug] -StackExchange answer). Fix this with the following commands: + sudo apt-get update + sudo apt-get install gcsfuse -``` -sudo chmod g+rw /dev/fuse -sudo chgrp fuse /dev/fuse -``` +Future updates to gcsfuse can be installed in the usual +way: `sudo apt-get update && sudo apt-get upgrade`. -Note that the operating system appears to periodically lose these changes, so -you may need to run the workaround above repeatedly. +Note that on Ubuntu you may need to run `sudo adduser $USER fuse` and then log +out and back in to obtain permissions to mount fuse file systems. -[fuse-group]: https://wiki.debian.org/SystemGroups -[debian-bug]: http://superuser.com/a/800016/429161 +[ubuntu-releases]: https://wiki.ubuntu.com/Releases +[debian-releases]: https://www.debian.org/releases/ ## CentOS and Red Hat