命令行工具

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

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

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

    应用程序管理

    1. flynn apps

    列出所有应用程序。

    例子

    1. $ flynn apps
    2.              ID                                NAME
    3. f1e85f5392454a329929e3f27f7a5644              gitreceive
    4. 4c6325c1f13547059e5496c91a6a97dd              router
    5. 8cfd94d040b14bd8aecc086c8f5f5e0d              blobstore
    6. f488cfb478f54edea497bf6347c2eb80              postgres
    7. 9d5be7be873c41b9898032c08aa87597              controller

    集群管理

    用法：

    1. flynn cluster
    2. flynn cluster add [-f] [-d] [-g <githost>] [--git-url <giturl>] [--no-git] [-p <tlspin>] <cluster-name> <domain> <key>
    3. flynn cluster default [<cluster-name>]
    4. flynn cluster migrate-domain <domain>
    5. flynn cluster backup [--file <file>]

    命令参数

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

    • add 增加一个群集到 〜/.flynnrc 配置文件中
    1.  选项:
    2.   -f, --force               强制添加集群
    3.   -d, --default             设置为默认集群
    4.   -g, --git-host=<githost>  git 主机 (只支持传统的 SSH)
    5.   --git-url=<giturl>        git URL
    6.   --no-git                  跳过 git 配置
    7.   -p, --tls-pin=<tlspin>    集群 TLS 证书的 SHA256 哈希值
    • remove 从 〜/.flynnrc 配置文件中删除集群
    • default 不带参数，则显示默认的集群；后面带集群名，则将它设置为默认集群
    • migrate-domain 将集群当前的基本域迁移到指定的域。迁移过程中，将为控制器/控制板生成一个新证书，同时会为每个应用添加 <app-name>.<domain> 模式的路由。
    • backup 备份集群
    1.  当通过 'flynn-host bootstrap --from-backup' 命令创建一个新集群时，该备份可以被恢复。
    2.  选项:
    3.   --file=<backup-file>  指定备份文件的名称(默认为输出到标准输出)

    例子

    1. $ flynn cluster add -p KGCENkp53YF5OvOKkZIry71+czFRkSw2ZdMszZ/0ljs= default dev.localflynn.com e09dc5301d72be755a3d666f617c4600
    2. Cluster "default" added.
    1. $ flynn cluster migrate-domain new.example.com
    2. Migrate cluster domain from "example.com" to "new.example.com"? (yes/no): yes
    3. Migrating cluster domain (this can take up to 2m0s)...
    4. Changed cluster domain from "example.com" to "new.example.com"

    创建

    用法：

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

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

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

    选项

    例子

    1. $ flynn create
    2. Created turkeys-stupefy-perry

    删除

    用法：

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

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

    选项

    标志 描述
    -r —remote=<remote> 要删除的 Git 远程仓库名称，没有空字符串。 [默认：flynn]
    -y —yes 跳过确认提示。

    例子

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

    部署

    用法：

    1. flynn deployment

    管理应用的部署

    命令参数

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

    例子

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

    环境

    用法

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

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

    选项

    标志 描述
    -t —process-type=<proc> 设置或读取指定进程类型的环境变量

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

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

    例子

    1. $ flynn env set FOO=bar BAZ=foobar
    2. Created release 5058ae7964f74c399a240bdd6e7d1bcb.
    1. $ flynn env
    2. BAZ=foobar
    3. FOO=bar
    2. bar
    1. $ flynn env unset FOO
    2. Created release b1bbd9bc76d6436ea2fd245300bce72e.

    导出

    用法

    1. flynn export [options]

    导出应用配置和数据。

    选项

    标志 描述
    -f —file=<file> 存储导出数据的文件名(默认为标准输出)
    -q —quiet 不显示进度

    用法：

    导入

    用法：

    1. flynn import [options]

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

    选项

    信息

    显示应用的信息

    1. flynn info

    例子

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

    安装

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

    1. flynn install

    例子

    1. $ flynn install

    停止任务（Kill）

    1. flynn kill <job>

    杀掉一个任务进程

    资源限制

    用法：

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

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

    选项

    标志 描述
    -t —process-type=<proc> 设置或读取指定进程类型的限制

    命令

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

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

    例子

    1. $ flynn limit
    2. web:     max_fd=10000  memory=1GB
    3. worker:  max_fd=10000  memory=1GB
    1. $ flynn limit set web memory=512MB max_fd=12000
    2. Created release 5058ae7964f74c399a240bdd6e7d1bcb
    1. $ flynn limit
    2. web:     max_fd=12000  memory=512MB
    3. worker:  max_fd=10000  memory=1GB
    1. $ flynn limit set web memory=256MB
    2. Created release b39fe25d0ea344b6b2af5cf4d6542a80
    1. $ flynn limit
    2. web:     max_fd=12000  memory=256MB
    3. worker:  max_fd=10000  memory=1GB

    日志

    应用程序的日志流。

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

    选项

    标志 描述
    -f —follow 新的日志流
    -j —job=<id> 过滤出特定任务的 ID 的日志
    -n —number=<lines> 从日志缓冲区中提取至多 N 行日志
    -r —raw-output 输出没有前缀的原始日志信息
    -s —split-stderr 将标准错误流发送到 stderr
    -t —process-type=<type> 过滤出特定进程类型的日志

    元数据

    管理应用元数据

    1. flynn meta
    2. flynn meta unset <var>...

    例子

    1. $ flynn meta
    2. KEY  VALUE
    3. foo  bar
    1. $ flynn meta set foo=baz bar=qux
    1. $ flynn meta
    2. KEY  VALUE
    3. foo  baz
    4. bar  qux
    1. $ flynn meta unset foo
    1. $ flynn meta
    2. KEY  VALUE
    3. bar  qux
    标志 描述
    -f —file=<file>dump 备份文件的名称
    -q —quiet 不显示进度

    命令

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

    例子

    1. $ flynn pg psql
    2. $ flynn pg psql -- -c "CREATE EXTENSION hstore"
    3. $ flynn pg dump -f db.dump
    4. $ flynn pg restore -f db.dump

    提供程序

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

    1. flynn provider
    2. flynn provider add <name> <url>

    命令

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

    • add 添加新提供程序

    ps

    列出所有 flynn 进程。 

    1. flynn ps

    例子

    1. $ flynn ps
    3. flynn-bb97c7dac2fa455dad73459056fabac2  web   b69d7fb5308a4684a09b160b82d267ec
    4. flynn-c59e02b3e6ad49809424848809d4749a  web   b69d7fb5308a4684a09b160b82d267ec
    5. flynn-46f0d715a9684e4c822e248e84a5a418  web   b69d7fb5308a4684a09b160b82d267ec

    发布

    管理应用程序的发布。

    1. flynn release
    2. flynn release add [-t <type>] [-f <file>] <uri>
    3. flynn release show [<id>]

    选项

    命令

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

    例子

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

    1. $ cat config.json
    2. {
    3.     "env": {"MY_VAR": "Hello World, this will be available in all process types."},
    4.     "processes": {
    5.         "echo": {
    6.             "cmd": ["socat -v tcp-l:$PORT,fork exec:/bin/cat"],
    7.             "entrypoint": ["sh", "-c"],
    8.             "env": {"ECHO": "This var is specific to the echo process type."},
    9.             "ports": [{"proto": "tcp"}]
    10.         }
    11.     }
    12. }
    14. $ flynn release add -f config.json https://registry.hub.docker.com?name=flynn/slugbuilder&id=15d72b7f573b
    15. Created release 427537e78be4417fae2e24d11bc993eb.
    1. $ flynn release
    2. ID                                Created
    3. 427537e78be4417fae2e24d11bc993eb  11 seconds ago
    1. $ flynn release show
    2. ID:             427537e78be4417fae2e24d11bc993eb
    3. Artifact:       docker+https://registry.hub.docker.com?name=flynn/slugbuilder&id=15d72b7f573b
    4. Process Types:  echo
    5. Created At:     2015-05-06 21:58:12.751741 +0000 UTC
    6. ENV[MY_VAR]:    Hello World, this will be available in all process types.

    仓库

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

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

    选项

    标志 描述
    -y —yes 假如该仓库存在，则跳过确认提示

    例子

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

    资源

    管理应用程序资源。

    1. flynn resource
    2. flynn resource add <provider>
    3. flynn resource remove <provider> <resource>

    命令

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

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

    路由

    管理应用程序的路由。

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

    选项

    标志 描述
    -s —service=<service> 路由域的服务名称（默认为APPNAME-web）
    -c —tls-cert=<tls-cert> TLS 的 PEM 编码证书路径， - 为标准输入（只支持HTTP）
    -k —tls-key=<tls-key TLS 的 PEM 编码私钥路径， - 为标准输入（只支持HTTP）
    —sticky 支持基于 Cookie 的粘性路由（只支持HTTP）
    —no-sticky 不支持基于 Cookie 的粘性路由（只支持更新HTTP）
    -p —port=<port> 通信端口（只支持TCP）

    命令

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

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

    例子

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

    运行

    运行任务。

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

    选项

    选项 描述
    -d —detached 不连接 IO 流运行任务
    -r <release> 以版本 ID 来运行（默认为当前应用程序版本）
    -e <entrypoint> 覆盖版本镜像的默认入口点
    -l —enable-log 把输出传入日志流

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

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

    例子

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

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

    1. $ flynn scale web=2 worker=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版本信息。

    1. flynn version