This guide will walk you through using the CLI to manage your Gemfury account.
Before you get started, be sure you have an active account.
Installation
Use these instructions to install the CLI on your device.
Authentication & access
Before accessing your account(s), you must authenticate into your Gemfury
account. The credentials can either be saved locally, or passed via a command
line flags for non-interactive or single-use environments.
…
Gemfury CLI is available on a number of platforms. Each one comes with its
own installation tools & method:
macOS & Homebrew
Use Homebrew on your macOS device to install Gemfury CLI as follows:
$ brew tap gemfury/tap
$ brew install fury-cli
You can later update to the latest version by running:
$ brew update
$ brew upgrade fury-cli
Linux & DEB
Create a fury-cli.list
file in the /etc/apt/sources.list.d
directory. You will need sudo access to make these changes.
…
To authenticate with your Gemfury login credentials, and save your access token locally to $HOME/.netrc
, run the following command:
$ fury login
Please enter your Gemfury credentials.
Email: youremail@domain.com
Password: <hidden password>
You are logged in as "[USERNAME]"
Use of collaboration accounts
Once you have been added as a collaborator, you can perform Gem
operations as the shared account via the --account
flag option.
For example, to upload a new Gem into the shared account:
…
With the following commands, you can manage packages in your account:
Uploading packages
Uploading your packages is easy. Once you’ve installed the CLI, upload files
to your account with:
$ fury push package-1.0.0.gem -a ACCOUNT
Listing packages
You can list the contents of your account with the following command, which
will enumerate the names and details of all the packages in an account:
$ fury list -a ACCOUNT
And if you’d like to see all the versions of a particular package:
…
Gemfury supports storing and building packages from source with our
Git repository and builder. These repositories are stored
and managed separately from the built packages in your account.
Listing
You can list Git repositories of an account with:
$ fury git list -a ACCOUNT
Rebuilding
If you want to rebuild at the tip or at an earlier revision of the repository,
use git rebuild
subcommand. The following command will rebuild the main
branch of the repo:
…
You can share your Gemfury account with other Gemfury users. Your
collaborators will be able to upload, download, and remove packages in your
account without access to your Repo-URL or secret credentials.
Managing collaborators
Only the account owner can manage collaborators. Collaboration commands
are all grouped under the sharing prefix. For example, to list the
collaborators for your account:
$ fury sharing -a ACCOUNT
Adding and removing collaborators is as easy as:
…