README
¶
flyctl
flyctl is a command-line interface for fly.io
Note: Most installations of flyctl also alias flyctl to fly as a command name and this will become the default name in the future.
During the transition, note that where you see flyctl as a command it can be replaced with fly.
Installation
Using a Package Manager
Homebrew (macOS, Linux, WSL)
brew install flyctl
To upgrade to the latest version:
brew upgrade flyctl
Install Script
Download flyctl and install into a local bin directory.
MacOS, Linux, WSL
Installing the latest version:
curl -L https://fly.io/install.sh | sh
Installing the latest pre-release version:
curl -L https://fly.io/install.sh | sh -s pre
Installing a specific version:
curl -L https://fly.io/install.sh | sh -s 0.0.200
Windows
Run the Powershell install script:
iwr https://fly.io/install.ps1 -useb | iex
Downloading from GitHub
Download the appropriate version from the Releases page of the flyctl GitHub repository.
Getting Started
- Sign into your fly account
fly auth login
- List your apps
fly apps list
- View app status
fly status -a {app-name}
App Settings
flyctl will attempt to use the app name from a fly.toml file in the current directory. For example, if the current directory contains this file:
$ cat fly.toml
app: banana
flyctl will operate against the banana app unless overridden by the -a flag or other app name setting in the command line.
Releases
flyctl is automatically released at 3 PM Eastern Standard Time Monday - Thursday. If needed, you can bump a release by running ./scripts/bump_version.sh.
Building on Windows
There is a simple Powershell script, winbuild.ps1, which will run the code generation for the help files, format them, and run a full build, leaving a new binary in the bin directory.
Running from branches on your local machine
Run scripts/build-dfly to build a Docker image from the current branch. Then, use scripts/dfly to run it. This assumes you are already
authenticated to Fly in your local environment.
Contributing guide
See CONTRIBUTING.md
Documentation
Source Files
Directories
¶
| Path | Synopsis |
|---|---|
|
internal/proto
Package proto implements the agent's protocol.
|
Package proto implements the agent's protocol. |
|
api
module
|
|
|
cmd
|
|
|
Borrowed from https://www.calhoun.io/creating-random-strings-in-go/
|
Borrowed from https://www.calhoun.io/creating-random-strings-in-go/ |
|
internal
|
|
|
appconfig
Package appconfig implements functionality related to reading and writing app configuration files.
|
Package appconfig implements functionality related to reading and writing app configuration files. |
|
cache
Package cache implements accessing of the state.yml file.
|
Package cache implements accessing of the state.yml file. |
|
cli
Package cli implements the command line interface.
|
Package cli implements the command line interface. |
|
command
Package command implements helpers useful for when building cobra commands.
|
Package command implements helpers useful for when building cobra commands. |
|
command/agent
Package agent implements the agent command chain.
|
Package agent implements the agent command chain. |
|
command/apps
Package apps implements the apps command chain.
|
Package apps implements the apps command chain. |
|
command/auth
Package auth implements the auth command chain.
|
Package auth implements the auth command chain. |
|
command/curl
Package curl implements the curl command chain.
|
Package curl implements the curl command chain. |
|
command/dig
Package dig implements the dig command chain.
|
Package dig implements the dig command chain. |
|
command/docs
Package docs implements the docs command chain.
|
Package docs implements the docs command chain. |
|
command/doctor
Package doctor implements the doctor command chain.
|
Package doctor implements the doctor command chain. |
|
command/extensions
Package logs implements the logs command chain.
|
Package logs implements the logs command chain. |
|
command/history
Package history implements the history command chain.
|
Package history implements the history command chain. |
|
command/lfsc
Package lfsc implements the LiteFS Cloud command chain.
|
Package lfsc implements the LiteFS Cloud command chain. |
|
command/logs
Package logs implements the logs command chain.
|
Package logs implements the logs command chain. |
|
command/platform
Package platform implements the platform command chain.
|
Package platform implements the platform command chain. |
|
command/root
Package root implements the root command.
|
Package root implements the root command. |
|
command/status
Package status implements the status command chain.
|
Package status implements the status command chain. |
|
command/version
Package version implements the version command chain.
|
Package version implements the version command chain. |
|
env
Package env implements environment related functionality.
|
Package env implements environment related functionality. |
|
filemu
Package filemu implements file-based mutexes.
|
Package filemu implements file-based mutexes. |
|
flag
Package flag implements flag-related functionality.
|
Package flag implements flag-related functionality. |
|
format
Package format implements various formatters.
|
Package format implements various formatters. |
|
prompt
Package prompt implements input-related functionality.
|
Package prompt implements input-related functionality. |
|
sentry
Package sentry implements sentry-related functionality.
|
Package sentry implements sentry-related functionality. |
|
sort
Package sort implements common sorting functions.
|
Package sort implements common sorting functions. |
|
state
Package state implements setters and getters for command contexts.
|
Package state implements setters and getters for command contexts. |
|
task
Package task implements async task handling.
|
Package task implements async task handling. |
|
scripts
|
|
|
tools
|
|