create-version

説明

現在のディレクトリをソースコードとしてバージョンを作ります。

概要

$ abeja training create-version [--help]
Usage: abeja training create-version [OPTIONS]

Options:
  -j, --job_definition_name, --job-definition-name TEXT
                                  Training job definition name
  -h, --handler TEXT              Training handler
  -i, --image TEXT                Specify base image name and tag in the
                                  "name:tag" format. ex) abeja-inc/all-gpu:19.10
  -d, --description TEXT          Description for the training job, which must be less
                                  than or equal to 256 characters.
  -e, --environment ENVIRONMENTSTRING
                                  Environment variables, ex. BATCH_SIZE:32
  --exclude TEXT                  Specify the file/dir to exclude from create-version.
  --dataset, --datasets DATASETPARAMSTRING
                                  Datasets name
  --help                          Show this message and exit.

引数

学習設定ファイル (training.yaml) からパラメータを取得します。ソースコードとして現在のディレクトリをアップロードします。

オプション

-j, --job_definition_name, --job-definition-name

学習ジョブ定義名

training.yaml が存在すれば、 training.yaml の name の値が使用されます。
このオプションで training.yaml の name に定義されている値を上書きすることが出来ます。

-h, --handler

呼び出す関数のパス

training.yaml が存在すれば、 training.yaml の handler の値が使用されます。
このオプションで training.yaml の handler に定義されている値を上書きすることが出来ます。

-i, --image

モデルを学習させる image

training.yaml が存在すれば、 training.yaml の image の値が使用されます。
このオプションで training.yaml の image に定義されている値を上書きすることが出来ます。

-d, --description

トレーニング定義バージョンの説明

-e, --environment

環境変数を指定します。登録された環境変数はコードから参照できるようになります。 例）IMAGE_WIDTH:100
ユーザーの指定可能な環境変数についての詳細は、こちらを参照ください。

( バージョン 0.14.0 以降 ) training.yaml が存在すれば、 training.yaml の environment ( params ) の値が使用されます。
このオプションで training.yaml の environment に定義されている環境変数を上書きすることができます。

--exclude

作成するバージョンから除外するファイル/ディレクトリを指定します。
training.yaml で ignores を設定していた場合は、両方共有効です（マージされます）。
複数指定する場合は、 --exclude <value1> --exclude <value2> ... と繰り返し指定してください。

--dataset, --datasets

モデルを学習するために使用するデータセット

training.yaml が存在すれば、 training.yaml の datasets の値が使用されます。
このオプションで training.yaml の datasets に定義されている値を上書きすることが出来ます。

-e オプションはバージョン 0.14.0 以降からは --environment の省略形に変更されました

例

トレーニングのバージョンを作成

この例でトレーニングのバージョンを作成します

デフォルト設定ファイル (training.yaml):

name: training1
handler: train:handler
image: abeja-inc/all-gpu:19.04
datasets:
  "mnist": "1111111111111"

コマンド:

$ abeja training create-version

出力:

{
    "created_at": "2018-02-13T10:13:10.956198Z",
    "datasets": {
        "mnist": "1111111111111"
    },
    "handler": "train:handler",
    "image": "abeja-inc/all-gpu:19.04",
    "job_definition_id": "1368416720943",
    "job_definition_version": 1,
    "modified_at": "2018-02-13T10:13:11.000461Z",
    "environment": {}
}