This is beta software. If you’d like a stable release, please use our Ruby-based CLI.
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.
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: email@example.com Password: <hidden password> You are logged in as "[USERNAME]" If you’re looking to use the CLI in a headless environment (i.e. automation), you can use the --api-token flag to authenticate inline:
$ fury push package-1.0.0.gem --account ACCOUNT --api-token TOKEN 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.
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: