exec
exec コマンドついて、以下に記します。
概要
exec コマンドは yamory-cli をインストールしたローカルホストのスキャンを行ないます。
スキャンにはアクセストークンが必要です。
アクセストークンは、チーム設定画面より発行できます。
発行手順などはこちらを参照してください。
アクセストークンは、コマンドフラグで指定してください。
コマンドフラグ
| フラグ | 必須 | 説明 |
|---|---|---|
--token/-T |
✔ | ホストスキャンのアクセストークン |
--title/-t |
yamory サービス上表示されるスキャン対象の名前 (省略時は hostname コマンドの値) |
|
--identifier/-i |
ホスト識別子。ホスト識別子には 半角英数字, -, _ のみ使用できます。 |
|
--distribution/-d |
ホストの OS | |
--version/-v |
ホストのバージョン | |
--openSystem/-o |
公開ホストの設定を true または false で指定 |
|
--tags |
ホストタグ名をカンマ区切りで指定 | |
--useSudo |
スキャン時に sudo を使用するか否かを指定。デフォルト true |
--identifier フラグについて
yamory のホストスキャン機能では、ホストの一意性を特定するためにマシン ID（/etc/machine-id の値）を使用していますが、クラウド環境などでコピーしたイメージを利用する際にマシン ID が同値となり、意図せずスキャン結果を上書きしてしまうことがあります。
そのような場合に --identifier フラグを設定することでスキャン情報の上書きを回避できます。
--identifier フラグには、チーム内でホストごとに一意の値になるように設定してください。
--distribution フラグ、および --version フラグについて
ホストの OS（--distribution フラグ）、およびバージョン（--version フラグ）が指定されている場合、 OS の自動判別が無効になります。
なお、現在 --distribution フラグに指定できる値は以下の通りです。
- Amazon Linux:
amazon-linux - CentOS:
centos - Debian:
debian - Oracle Linux:
oracle-linux - Red Hat Enterprise Linux:
redhat - Ubuntu:
ubuntu
--openSystem フラグについて
公開ホスト（外部ネットワークからパブリックアクセスが可能なホスト）として使用するかを指定することができます。
公開ホストの場合は true、非公開ホストの場合は false を指定します。
--openSystem フラグが未指定の場合、前回スキャン情報があればその状態を引き継ぎ、初回スキャン時は公開ホストとして登録されます。
本パラメータはトリアージレベルの計算に使用されます。
--useSudo フラグについて
yamory のホストスキャンでは、一部のディストリビューションにおいてホスト情報を取得するコマンドを実行する際に
no password で sudo コマンドを実行できるか確認し、実行できる場合、sudo コマンドを使用してホスト情報を取得しています。
スキャンを実行するユーザーにコマンドの実行制限がない場合、 --useSudo フラグに false を指定すると sudo を使用せずにスキャンすることができます。
--useSudo フラグ は以下のディストリビューションでのみ有効です。
- Amazon Linux
- CentOS
- Oracle Linux
- Red Hat Enterprise Linux