クライアントを使用して DLC のジョブを管理できます。このクライアントは、コマンドラインの自動補完、トレーニングジョブの送信、ジョブ管理などの機能を提供します。使用を開始する前に、クライアントをダウンロードして ID 認証を行う必要があります。このトピックでは、クライアントのダウンロード方法と ID 認証の実行方法について説明します。
クライアントの使用に関する注意
実行時に証明書関連のエラーが発生した場合は、sudo apt-get update && sudo apt-get install ca-certificates を実行できます。
クライアントのダウンロード
お使いのオペレーティングシステムに対応するクライアントを、以下のリンクからダウンロードできます。
ダウンロードしたクライアントはインストール不要です。 chmod +x dlc コマンドを実行して、ファイルに実行権限を付与します。その後、コマンドラインからクライアントのコマンドを呼び出すことができます。
自動補完 (completion)
-
機能
自動補完機能は、コミュニティの Kubectl や Arena のコマンドラインツールが提供する自動補完機能と同様に動作します。コマンドラインで Tab キーを 2 回押すと、DLC クライアントの自動補完機能を使用できます。この機能は、不完全なコマンドに対して候補を提案します。
-
フォーマット
./dlc completion <shelltype> -
パラメーター
<shelltype> には、自動補完スクリプトを生成するシェルのタイプを指定します。サポートされているタイプは、bash、fish、powershell、zsh です。
-
例
次の例では、bash で自動補完を使用する方法を示します。
-
bash-completion パッケージがインストールされていない場合は、次のコマンドを実行してインストールします。その後、
sourceコマンドを実行して変更を適用します。パッケージがすでにインストールされている場合は、この手順をスキップできます。# macOS の場合は、次のコマンドを実行します。 brew install bash-completion && source /usr/local/etc/bash_completion # Linux の場合は、次のコマンドを実行します。 yum install bash-completion && source /etc/profile.d/bash_completion.sh -
次のコマンドを実行して、自動補完を有効にします。自動補完機能は bash-completion パッケージに依存します。エラーが発生した場合、お使いの環境に bash-completion パッケージがインストールされていないことを示します。
source <(./dlc completion bash) -
./dlcと入力し、Tab キーを 2 回押して、DLC クライアントが提供するコマンドを表示します。./dlcシステムは、DLC クライアントが提供する次のコマンドを返します。
completion config create delete get help logs stop submit
説明他のシェルタイプについては、
dlc completion <zsh | fish | powershell> --helpコマンドを実行して詳細な使用方法を確認してください。 -
ユーザー認証 (config)
-
機能
初めて DLC クライアントを使用してデータやジョブを管理する際には、お使いの Alibaba Cloud アカウントの AccessKey ID と AccessKey Secret を使用して ID 認証を行う必要があります。初回の認証後は、再度認証を行う必要はありません。
-
フォーマット
./dlc config --protocol https --access_id <yourAccessKeyID> --access_key <yourAccessKeySecret> [--endpoint <yourEndpoint>] [--region <yourRegion>] -
パラメーター
パラメーター
必須
説明
タイプ
<yourAccessKeyId>
はい
お使いの Alibaba Cloud アカウントの AccessKey ID。
STRING
<yourAccessKeySecret>
はい
お使いの Alibaba Cloud アカウントの AccessKey Secret。
STRING
<yourEndpoint>
いいえ
DLC サービスがあるリージョンのエンドポイント。例: pai-dlc.cn-shanghai.aliyuncs.com。
STRING
<yourRegion>
いいえ
DLC サービスがあるリージョン。たとえば、中国 (上海) のリージョン ID は cn-shanghai です。
STRING
-
例
ID 認証を行うと、設定はデフォルトでホームディレクトリにある ~/.dlc/config ファイルに保存されます。たとえば、次のようなコマンドを実行します。
./dlc config --protocol https \ --access_id <AccessKeyId> \ --access_key <AccessKeySecret> \ --endpoint 'pai-dlc.cn-shanghai.aliyuncs.com' \ --region cn-shanghai次のようなメッセージが表示されます。
[OK] Configuration saved to: ~/.dlc/config
関連ドキュメント
-
クライアントを認証した後、サポートされているコマンドを使用して操作を実行できます。詳細については、「コマンド一覧」をご参照ください。
-
コンソールで DLC ジョブを送信することもできます。詳細については、「コンソールでのタスク作成」をご参照ください。