Fleetbase CLI
Introduction
FLB (Fleetbase CLI) is a command-line interface tool designed for managing Fleetbase Extensions. It simplifies the process of publishing and managing both npm and PHP Composer packages, particularly for Fleetbase extensions.
The CLI is used to setup authentication with the Fleetbase Registry, install and uninstall extensions, as well as scaffold new extensions for development.
Installation
To install FLB, run the following command:
npm install -g @fleetbase/cli
Usage
Publishing a Extension
To publish a extension, navigate to the extension directory and run:
flb publish [path]
[path]
: (Optional) The path to the extension directory to be published. Defaults to the current directory.
For PHP only extensions, flb
will automatically convert composer.json
to package.json
before publishing.
Unpublishing a Extension
To unpublish a extension, use:
flb unpublish [extension]
[extension]
: (Optional) The name of the extension to unpublish. If not provided, FLB will attempt to determine the extension name from the current directory.
Setup Registry Auth Token
To install purchased extensions you must setup authorization first which is linked to your Fleetbase account. You can generate a registry token at https://console.fleetbase.io/extensions/developers/credentials
To setup registry auth use:
flb set-auth [token] --path /fleetbase
-p, --path
: (Optional) The path to the fleetbase instance directory. Defaults to the current directory.
Scaffolding a Extension
Fleetbase CLI has the ability to scaffold a starter extension if you intend to develop your own extension. This greatly speeds up the development process as it gives you a correct starting point to build on.
To scaffold a extension, use:
flb scaffold
-p, --path
: The path to place the scaffold extension.-n, --name
: The name of the extension to scaffold.-d, --description
: The description of the extension to scaffold.-a, --author
: The name of the extension author.-e, --email
: The email of the extension author.-k, --keywords
: The keywords of the extension to scaffold.-n, --namespace
: The PHP Namespace of the extension to scaffold.-r, --repo
: The Repository URL of the extension to scaffold.
Installing a Extension
To install a extension, use:
flb install [extension] --path /fleetbase
[extension]
: The name of the extension to install.-p, --path
: (Optional) The path to the fleetbase instance directory. Defaults to the current directory.
Uninstalling a Extension
To uninstall a extension, use:
flb uninstall [extension] --path /fleetbase
[extension]
: The name of the extension to install.-p, --path
: (Optional) The path to the fleetbase instance directory. Defaults to the current directory.
Setting a Custom Registry
To specify a custom registry for publishing and unpublishing, use the -r
or --registry
option:
flb publish -r http://my-registry.com
flb unpublish -r http://my-registry.com
Configuration
FLB can be configured via command-line options. The most common options include:
-r, --registry [url]
: Specify a custom registry URL.