9.2. 自動化コンテンツナビゲーターでよくある質問 (FAQ)
次の自動化コンテンツナビゲーターの FAQ を、お使いの環境で発生している問題のトラブルシューティングに役立ててください。
- 自動化実行環境を使用する場合、
ansible.cfgファイルはどこに置く必要がありますか。 -
ansible.cfgを使用する最も簡単な方法は、Playbook の横にあるプロジェクトディレクトリーに置くことです。Playbook ディレクトリーは実行環境に自動的にマウントされ、ansible.cfgファイルが表示されます。ansible.cfgファイルが別のディレクトリーにある場合は、ANSIBLE_CONFIG変数とカスタムボリュームマウントとして指定されたディレクトリーを設定する必要があります。execution-environment-volume-mountsについては、Automation content navigator の設定 を参照してください。 - 自動化実行環境を使用しない場合、
ansible.cfgファイルはどこに置く必要がありますか。 -
自動化実行環境を使用しない場合、Ansible は通常の場所で
ansible.cfgを探します。詳細は、Ansible 構成設定 を参照してください。 - 自動化実行環境を使用する場合、Ansible コレクションはどこに置く必要がありますか。
-
Ansible コレクションを作成する最も簡単な場所は、プロジェクトディレクトリー、Playbook に隣接するコレクションディレクトリーです (例:
ansible-galaxy collections install ansible.utils -p ./collections)。Playbook ディレクトリーは自動化実行環境に自動的にマウントされ、自動化コンテンツナビゲーターはその環境でコレクションを見つけます。または、Ansible Builder を使用して、コレクションを自動化実行環境に構築する方法もあります。自動化コントローラーは Playbook に隣接するコレクションディレクトリーをサポートしているため、これはコンテンツ作成者が実稼働用の Playbook を作成するのに役立ちます。コレクションが別のディレクトリーにある場合は、ANSIBLE_COLLECTIONS_PATHS変数を設定して、そのディレクトリーのカスタムボリュームマウントを設定します。execution-environment-volume-mountsについては、自動化コンテンツナビゲーターの設定 を参照してください。 - 自動化実行環境を使用していない場合、Ansible コレクションはどこに置く必要がありますか。
- 自動化実行環境を使用しない場合は、Ansible がコレクションのデフォルト場所を検索します。Ansible Collections ユーザーガイド を参照してください。
vars_promptまたはpause/promptが使用されたときに Playbook がハングするのはなぜですか。-
デフォルトでは、自動化コンテンツナビゲーターは、自動化コントローラーが Playbook を実行するのと同じ方法で Playbook を実行します。これは、コンテンツ作成者が実稼働環境を準備する Playbook を作成するために実行されました。
vars_promptまたはpause\promptの使用を回避できない場合は、playbook-artifactの作成を無効にすると、自動化コンテンツナビゲーターはansible-playbookと互換性のある方法で Playbook を実行し、ユーザーの対話を可能にします。 - 端末コンテンツナビゲーターが端末の色を変更したり、見栄えが悪くなるのはなぜですか。
-
自動化コンテンツナビゲーターは、OSC4 互換性の端末にクエリーを実行します。OSC4、10、11、104、110、および 111 は、端末が色変更をサポートすることを示し、元に戻します。端末が機能を誤って表示している可能性があります。OSC4 検出は、
--osc4 falseを設定して無効にできます。(環境変数または設定ファイルでこれを処理する方法は、自動化コンテンツナビゲーターの一般設定 を参照してください)。 - 自動化コンテンツナビゲーターで使用される色を変更するにはどうすればよいですか。
-
--osc4 falseを使用して、自動化コンテンツナビゲーターを強制的に端末定義した色を使用するようにします。(環境変数または設定ファイルでこれを処理する方法は、自動化コンテンツナビゲーターの一般設定 を参照してください)。 - playbook ディレクトリーにあるすべての
site-artifact-2021-06-02T16:02:33.911259+00:00.jsonファイルは何に使用しますか。 -
自動化コンテンツナビゲーターは、すべての Playbook の実行に対して Playbook アーティファクトを作成します。これらは、自動化が完了した後の結果の確認、同僚との共有とトラブルシューティング、またはコンプライアンスや変更管理の目的での維持に役立ちます。Playbook アーティファクトファイルには、すべてのプレイおよびタスク、Playbook 実行からの
stdoutに関する情報が含まれます。Automation content navigator のセッション中に、ansible-navigator restart <filename>または:replay <filename>を使用して、Playbook アーティファクトを確認できます。すべての Playbook アーティファクトは、必要なビューに応じて、--mode stdoutおよび--mode interactiveの両方で確認できます。Playbook のアーティファクトの記述およびデフォルトのファイルの命名規則を無効にすることができます。(環境変数または設定ファイルでこれを処理する方法は、自動化コンテンツナビゲーターの一般設定 を参照してください)。 :openを使用するとviが開くのはなぜですか。自動化コンテンツナビゲーターは、デフォルトのエディターで端末に表示されるものを開きます。デフォルトは
vi +{line_number} {filename}、またはEDITOR環境変数の現在の値のいずれかに設定されます。これは、エディターがコンソールベースまたは端末ベースであるかを示すeditor-console設定です。役立つ可能性のある代替設定の例を以下に示します。# emacs ansible-navigator: editor: command: emacs -nw +{line_number} {filename} console: true# vscode ansible-navigator: editor: command: code -g {filename}:{line_number} console: false#pycharm ansible-navigator: editor: command: charm --line {line_number} {filename} console: false- どの順番で設定が適用されますか。
自動化コンテンツナビゲーター設定システムは、さまざまなソースから設定をプルするため、以下の順序で階層的に適用します (最後に適用された変更が最も一般的なものになります)。
- デフォルトの内部値
- 設定ファイルの値
- 環境変数からの値
- コマンドラインで指定されたフラグおよび引数
-
テキストベースのユーザーインターフェイス内で
:コマンドを実行している間
- 何かが機能しませんでした。どうすればトラブルシューティングできますか。
-
自動化コンテンツナビゲーターには、適切なログメッセージがあります。
--log-level debugを使用して、debugログを有効にできます。バグを見つけたと思われる場合は、問題をログに記録し、ログファイルから詳細情報を追加してください。
