第1章 FHC の設定
1.1. FHC のインストール
概要
fhc は Red Hat Mobile Application Platform Hosted (RHMAP) のコマンドラインインターフェース (CLI) であり、Node.js に基づいています。RHMAP Studio のほとんどすべての機能は RHMAP API を介して公開され、fhc を使用してアクセスできます。このため、fhc を他の Node.js アプリケーションに含めて、プログラムを使用して Platform にアクセスできます。Platform の公開された機能との対話は、ビルドシステムや継続的な統合システムなどの自動プロセスに統合できます。
要件
fhc を使用するには、Node.js と NPM をインストールします。Node.js をインストールするには、nodejs.org を参照してください。
インストール後に、node と npm の 2 つの新しいコマンドラインアプリケーションが利用可能になります。
1.1.1. FHC のインストール
ターミナル/コマンドプロンプトで、以下のコマンドを実行します。
npm install -g fh-fhc
Linux にインストールする場合は、以下のように sudoer でこのコマンドを実行する必要がある場合があります。
sudo npm install -g fh-fhc
これで Node.js モジュールの中央レジストリである npm から fhc がインストールされます。
-g フラグは、npm に fhc をグローバルでインストールするように指示し、どのディレクトリーからも使用できるようにします。
インストールが完了したら、fhc はコマンドラインから使用可能となります。Z shell (zsh) を使用している場合は、hash -r を使用してハッシュテーブルをリセットすることでコマンドが利用可能になります。
FHC が正常にインストールされたことを確認するには、以下のコマンドを使ってインストールしたバージョンを表示します。
fhc -v
1.1.1.1. コマンド自動入力 (Linux および Mac のみ)
fhc バッシュ補完スクリプトを使用すると、さまざまな fhc コマンドで Tab 補完が可能になります。以下の方法で fhc バッシュ補完スクリプトをインストールします。
fhc completion >> ~/.bashrc
別のシェル (bash 以外) を使用している場合は、fhc completion の出力を該当するファイルに追加します (たとえば、zsh の場合は ~/.zshrc)。
1.1.2. FHC の使用
ターゲットを設定し、ログインします。
fhc target https://[your-studio-domain].feedhenry.com fhc login [email address] [password]
プロジェクトを一覧表示するには、以下のコマンドを実行します。
fhc projects list
fhc の全コマンドを一覧表示するには、以下を実行します。
fhc help
1.1.2.1. 設定
fhc は非常に高度な設定が可能で、以下の 5 つの場所から設定オプションを読み取ります。
-
コマンドラインのスイッチ:
--key valで設定します。すべてのキーは値を取り、これはブール値であっても該当します (設定パーサーは、解析時にはオプションが何かを知りません)。値が提供されないと、そのオプションはブール値trueに設定されます。 -
環境変数:
環境変数の名前にfhc_config_の接頭辞を付けます。例えば、export fhc_config_key=valとなります。 -
ユーザー設定:
$HOME/.fhcrc にあるファイルは、初期化済みの設定一覧です。これがあると、解析されます。userconfigオプションが cli または環境変数で設定されると、代わりにそちらが使用されます。 -
グローバル設定:
../etc/fhcrc(実行可能なノードで、デフォルトでは/usr/local/etc/fhcrc) にファイルがあれば解析されます。globalconfigオプションが cli、環境変数、またはユーザー設定で設定されると、代わりにそれらのファイルが解析されます。 -
デフォルト:
fhc のデフォルト設定オプションは、lib/utils/config-defs.jsで定義されます。これらは変更しないでください。
詳細については、fhc help config を実行してください。すべてのコマンドの一覧については fhc help を使用し、特定のコマンドのヘルプについては fhc [command] --help を使用します。
Where did the comment section go?
Red Hat's documentation publication system recently went through an upgrade to enable speedier, more mobile-friendly content. We decided to re-evaluate our commenting platform to ensure that it meets your expectations and serves as an optimal feedback mechanism. During this redesign, we invite your input on providing feedback on Red Hat documentation via the discussion platform.