命令行客户端

说明

介绍如何安装使用FATE Flow Client，其通常包含在FATE Client中，FATE Client包含了FATE项目多个客户端：Pipeline, FATE Flow Client 和 FATE Test
介绍FATE Flow Client提供的命令行，所有的命令将有一个共有调用入口，您可以在命令行中键入flow以获取所有的命令分类及其子命令。

    [IN]
    flow

    [OUT]
    Usage: flow COMMAND [OPTIONS]

      Fate Flow Client

    Options：
      -h, --help  Show this message and exit.

    Commands：
      component   Component Operations
      data        Data Operations
      init        Flow CLI Init Command
      job         Job Operations
      model       Model Operations
      queue       Queue Operations
      table       Table Operations
      task        Task Operations

更多信息，请查阅如下文档或使用flow --help命令。

介绍所有命令使用说明

安装FATE Client

在线安装

FATE Client会发布到pypi，可直接使用pip等工具安装对应版本，如

pip install fate-client

或者

pip install fate-client==${version}

在FATE集群上安装

请在装有1.5.1及其以上版本fate的机器中进行安装：

安装命令：

cd $FATE_PROJECT_BASE/
# 进入FATE PYTHON的虚拟环境
source bin/init_env.sh
# 执行安装
cd fate/python/fate_client && python setup.py install

安装完成之后，在命令行键入flow 并回车，获得如下返回即视为安装成功：

Usage: flow [OPTIONS] COMMAND [ARGS]...

  Fate Flow Client

Options:
  -h, --help  Show this message and exit.

Commands:
  component  Component Operations
  data       Data Operations
  init       Flow CLI Init Command
  job        Job Operations
  model      Model Operations
  queue      Queue Operations
  table      Table Operations
  tag        Tag Operations
  task       Task Operations

初始化

在使用fate-client之前需要对其进行初始化，推荐使用fate的配置文件进行初始化，初始化命令如下：

指定fateflow服务地址

# 指定fateflow的IP地址和端口进行初始化
flow init --ip 192.168.0.1 --port 9380

通过FATE集群上的配置文件

# 进入FATE的安装路径，例如/data/projects/fate
cd $FATE_PROJECT_BASE/
flow init -c conf/service_conf.yaml

获得如下返回视为初始化成功：

{
    "retcode": 0,
    "retmsg": "Fate Flow CLI has been initialized successfully."
}

验证

主要验证客户端是否能连接上FATE Flow Server，如尝试查询当前的作业情况

flow job query

一般返回中的retcode为0即可

{
    "data": [],
    "retcode": 0,
    "retmsg": "no job could be found"
}

如返回类似如下，则表明连接不上，请检查网络情况

{
    "retcode": 100,
    "retmsg": "Connection refused. Please check if the fate flow service is started"
}

fate_flow_client.zh.md 3.3 KB Riwayat Mentahan