命令行工具

输入 flynn help 列出所有可用的命令。

安装

OS X 和 Linux 系统中，在终端运行以下命令：

L=/usr/local/bin/flynn && curl -sSL -A "`uname -sp`" https://dl.flynn.io/cli | zcat >$L && chmod +x $L

Windows 系统，在 PowerShell 中运行以下命令：

(New-Object Net.WebClient).DownloadString('https://dl.flynn.io/cli.ps1') | iex

应用程序管理

用法：

flynn apps

列出所有应用程序。

例子

$ flynn apps
             ID                                NAME
f1e85f5392454a329929e3f27f7a5644              gitreceive
4c6325c1f13547059e5496c91a6a97dd              router
8cfd94d040b14bd8aecc086c8f5f5e0d              blobstore
f488cfb478f54edea497bf6347c2eb80              postgres
9d5be7be873c41b9898032c08aa87597              controller

集群管理

用法：

flynn cluster
flynn cluster add [-f] [-d] [-g <githost>] [--git-url <giturl>] [--no-git] [-p <tlspin>] <cluster-name> <domain> <key>
flynn cluster remove <cluster-name>
flynn cluster default [<cluster-name>]
flynn cluster migrate-domain <domain>
flynn cluster backup [--file <file>]

命令参数

如果不带任何命令参数，将显示配置的集群列表。

• add 增加一个群集到 〜/.flynnrc 配置文件中

 选项:
  -f, --force               强制添加集群
  -d, --default             设置为默认集群
  -g, --git-host=<githost>  git 主机 (只支持传统的 SSH)
  --git-url=<giturl>        git URL
  --no-git                  跳过 git 配置
  -p, --tls-pin=<tlspin>    集群 TLS 证书的 SHA256 哈希值

• remove 从 〜/.flynnrc 配置文件中删除集群
• default 不带参数，则显示默认的集群；后面带集群名，则将它设置为默认集群
• migrate-domain 将集群当前的基本域迁移到指定的域。迁移过程中，将为控制器/控制板生成一个新证书，同时会为每个应用添加 <app-name>.<domain> 模式的路由。
• backup 备份集群

 当通过 'flynn-host bootstrap --from-backup' 命令创建一个新集群时，该备份可以被恢复。
 选项:
  --file=<backup-file>  指定备份文件的名称(默认为输出到标准输出)

例子

$ flynn cluster add -p KGCENkp53YF5OvOKkZIry71+czFRkSw2ZdMszZ/0ljs= default dev.localflynn.com e09dc5301d72be755a3d666f617c4600
Cluster "default" added.

$ flynn cluster migrate-domain new.example.com
Migrate cluster domain from "example.com" to "new.example.com"? (yes/no): yes
Migrating cluster domain (this can take up to 2m0s)...
Changed cluster domain from "example.com" to "new.example.com"

创建

用法：

flynn create [-r <remote>] [-y] [<name>]

在 flynn 中创建应用程序。如果没有提供 [<name>] 参数，将生成一个随机名。

如果使用 Git 仓库来创建一个应用，那么名为 ‘flynn’ 的远程仓库连接将被创建或替换，同样允许 git 用这个远程仓库来部署应用。

选项

例子

$ flynn create
Created turkeys-stupefy-perry

删除

用法：

flynn delete [-y] [-r <remote>]

删除一个应用。假如该应用使用了名为 'flynn' 的远程 git 仓库连接，该连接同样也会被删除。

选项

例子

$ flynn -a turkeys-stupefy-perry delete
Are you sure you want to delete the app "turkeys-stupefy-perry"? (yes/no): yes
Deleted turkeys-stupefy-perry

部署

用法：

flynn deployment

管理应用的部署

命令参数

不带任何参数，显示已部署列表。

例子

$ flynn deployment
ID                                STATUS    CREATED             FINISHED
37a63fb05fe946f18f11f741aed74d60  running   4 seconds ago
51cbf2bba1204e94b1d847ae0122c647  complete  16 seconds ago      14 seconds ago
12875d153f5c4c6cb64e263c4b422e8c  failed    About a minute ago  About a minute ago
21d4a8174a4240a0b1dcb6303f40cad5  complete  4 minutes ago       4 minutes ago

环境

用法

flynn env [-t <proc>]
flynn env set [-t <proc>] <var>=<val>...
flynn env unset [-t <proc>] <var>...
flynn env get [-t <proc>] <var>

管理应用程序的环境变量。

选项

命令参数

不带任何参数，显示所有环境变量列表。

• set 设置一个或多个环境变量
• unset 删除一个或多个环境变量
• get 返回环境变量的值

例子

$ flynn env set FOO=bar BAZ=foobar
Created release 5058ae7964f74c399a240bdd6e7d1bcb.

$ flynn env
BAZ=foobar
FOO=bar

$ flynn env get -t web FOO
bar

$ flynn env unset FOO
Created release b1bbd9bc76d6436ea2fd245300bce72e.

导出

用法

flynn export [options]

导出应用配置和数据。

应用的元数据（metadata）、部署策略（deploy strategy）、版本配置（release configuration）、slug、结构（formation）、Postgres 数据库将被导出到一个 tar 压缩文件。

选项

git 授权（git-credentials）

用法：

flynn git-credentials <operation>

导入

用法：

flynn import [options]

使用已导出的配置和数据来创建一个新应用。将使用所提供导出文件中的应用的元数据（metadata）、部署策略（deploy strategy）、版本配置（release configuration）、slug、结构（formation）、Postgres 数据库，来构建新的应用。

选项

信息

显示应用的信息

flynn info

例子

$ flynn info
=== example
Git URL:  https://git.dev.localflynn.com/example.git
Web URL:  http://example.dev.localflynn.com

$ flynn -a example info
=== example
Git URL:  https://git.dev.localflynn.com/example.git
Web URL:  http://example.dev.localflynn.com

安装

启动安装器的 web 界面服务。

flynn install

例子

$ flynn install

停止任务（Kill）

flynn kill <job>

杀掉一个任务进程

资源限制

用法：

flynn limit [-t <proc>]flynn limit set <proc> <var>=<val>...

管理应用程序的资源配置。

选项

命令

不带任何参数，即显示资源限制列表。

• set 设置一个或多个资源限制

例子

$ flynn limit
web:     max_fd=10000  memory=1GB
worker:  max_fd=10000  memory=1GB

$ flynn limit set web memory=512MB max_fd=12000
Created release 5058ae7964f74c399a240bdd6e7d1bcb

$ flynn limit
web:     max_fd=12000  memory=512MB
worker:  max_fd=10000  memory=1GB

$ flynn limit set web memory=256MB
Created release b39fe25d0ea344b6b2af5cf4d6542a80

$ flynn limit
web:     max_fd=12000  memory=256MB
worker:  max_fd=10000  memory=1GB

日志

应用程序的日志流。

flynn log [-f] [-j <id>] [-n <lines>] [-r] [-s] [-t <type>]

选项

元数据

管理应用元数据

flynn meta
flynn meta set <var>=<val>...
flynn meta unset <var>...

例子

$ flynn meta
KEY  VALUE
foo  bar

$ flynn meta set foo=baz bar=qux

$ flynn meta
KEY  VALUE
foo  baz
bar  qux

$ flynn meta unset foo

$ flynn meta
KEY  VALUE
bar  qux

pg

flynn pg psql [--] [<argument>...]
flynn pg dump [-q] [-f <file>]
flynn pg restore [-q] [-f <file>]

选项

命令

• psql 打开一个 flynn的 Postgres 数据库控制台。可以使用任何有效的 PSQL 命令参数。
• dump 备份 Postgres 数据库。如果没有指定文件，备份将输出到标准输出。
• restore 从数据库备份中还原 Postgres 数据库。如果没有指定文件，将通过标准输入获取还原备份。

例子

$ flynn pg psql
$ flynn pg psql -- -c "CREATE EXTENSION hstore"
$ flynn pg dump -f db.dump
$ flynn pg restore -f db.dump

提供程序

管理与控制器相关的资源提供程序。

flynn provider
flynn provider add <name> <url>

命令

不带任何参数，即显示当前提供程序

• add 添加新提供程序

ps

列出所有 flynn 进程。

flynn ps

例子

$ flynn ps
ID                                     TYPE   RELEASE
flynn-bb97c7dac2fa455dad73459056fabac2  web   b69d7fb5308a4684a09b160b82d267ec
flynn-c59e02b3e6ad49809424848809d4749a  web   b69d7fb5308a4684a09b160b82d267ec
flynn-46f0d715a9684e4c822e248e84a5a418  web   b69d7fb5308a4684a09b160b82d267ec

发布

管理应用程序的发布。

flynn release
flynn release add [-t <type>] [-f <file>] <uri>
flynn release show [<id>]

选项

命令

如果不带任何参数，将列出应用相关的所有版本。

• add 添加一个新发布从 Docker 镜像中创建一个新的版本。还可添加文件参数，它是 JSON 格式的配置文件的文件路径。这主要用于指定版本环境和流程（类似于Procfile）。可以使用任何控制版本类型可使用的参数。
• show显示版本信息如果省略ID，则显示当前发布信息。

例子

比如以 flynn/slugbuilder 镜像为基础发布一个 echo 服务器，用来运行 socat。

$ cat config.json
{
    "env": {"MY_VAR": "Hello World, this will be available in all process types."},
    "processes": {
        "echo": {
            "cmd": ["socat -v tcp-l:$PORT,fork exec:/bin/cat"],
            "entrypoint": ["sh", "-c"],
            "env": {"ECHO": "This var is specific to the echo process type."},
            "ports": [{"proto": "tcp"}]
        }
    }
}
$ flynn release add -f config.json https://registry.hub.docker.com?name=flynn/slugbuilder&id=15d72b7f573b
Created release 427537e78be4417fae2e24d11bc993eb.

$ flynn release
ID                                Created
427537e78be4417fae2e24d11bc993eb  11 seconds ago

$ flynn release show
ID:             427537e78be4417fae2e24d11bc993eb
Artifact:       docker+https://registry.hub.docker.com?name=flynn/slugbuilder&id=15d72b7f573b
Process Types:  echo
Created At:     2015-05-06 21:58:12.751741 +0000 UTC
ENV[MY_VAR]:    Hello World, this will be available in all process types.

仓库

创建一个可以通过 git 来部署应用的仓库。如果没有提供仓库名称，默认使用'flynn'

flynn remote add [<remote>] [-y]

选项

例子

$ flynn -a turkeys-stupefy-perry remote add
Created remote flynn with url https://git.dev.localflynn.com/turkeys-stupefy-perry.git

$ flynn -a turkeys-stupefy-perry remote add staging
Created remote staging with url https://git.dev.localflynn.com/turkeys-stupefy-perry.git

资源

管理应用程序资源。

flynn resource
flynn resource add <provider>
flynn resource remove <provider> <resource>

命令

不带任何参数，即显示资源列表。

• add 通过 为使用应用程序添加一个新资源。
• remove 通过 删除已存在的资源

路由

管理应用程序的路由。

flynn route
flynn route add http [-s <service>] [-c <tls-cert> -k <tls-key>] [--sticky] <domain>
flynn route add tcp [-s <service>] [-p <port>]
flynn route update <id> [-s <service>] [-c <tls-cert> -k <tls-key>] [--sticky] [--no-sticky]
flynn route remove <id>

选项

命令

不带任何参数，即显示路由的列表。

• add 给应用程序增加路由
• remove 删除路由

例子

$ flynn route add http example.com
$ flynn route add tcp

运行

运行任务。

flynn run [-d] [-r <release>] [-e <entrypoint>] [--] <command> [<argument>...]

选项

scale

scale 改变一个版本中每种进程的任务数量。省略参数即显示当前 scale。

flynn scale [options] [<type>=<qty>...]

选项

例子

$ flynn scale
web=4 worker=2

$ flynn scale --all
496d6e74-9db9-4cff-bcce-a3b44015907a (current)
web=1 worker=2

632cd907-85ab-4e53-90d0-84635650ec9a web=2

$ flynn scale web=2 worker=5
scaling web: 4=>2, worker: 2=>5

02:28:34.333 ==> web flynn-3f656af6f1e44092aa7037046236b203 down 02:28:34.466 ==> web flynn-ee83def0b8e4455793a43c8c70f5b34e down 02:28:35.479 ==> worker flynn-84f70ca18c9641ef83a178a19db867a3 up 02:28:36.508 ==> worker flynn-a3de8c326cc542aa89235e53ba304260 up 02:28:37.601 ==> worker flynn-e24760c511af4733b01ed5b98aa54647 up scale completed in 3.944629056s

版本

显示flynn版本信息。

flynn version

原文: http://doc.oschina.net/flynn?t=54124