• Skip to Main content
  • 検索にジャンプ
  • Skip to Footer
  • Cisco.com Japan
  • 製品とサービス
  • ソリューション
  • サポート
  • 学び
  • サイトマップ
  • 購入のご案内
  • パートナーホーム
  • パートナープログラム
  • サポート
  • ツール
  • シスコパートナーを探す
  • パートナーのご紹介
  • シスコパートナーになる
  • ホーム
  • サポート
  • 製品サポート
  • クラウドおよびシステム管理
  • Cisco Catalyst Center
  • エンドユーザ ガイド

偏向のない言語

この製品のマニュアルセットは、偏向のない言語を使用するように配慮されています。このマニュアルセットでの偏向のない言語とは、年齢、障害、性別、人種的アイデンティティ、民族的アイデンティティ、性的指向、社会経済的地位、およびインターセクショナリティに基づく差別を意味しない言語として定義されています。製品ソフトウェアのユーザーインターフェイスにハードコードされている言語、RFP のドキュメントに基づいて使用されている言語、または参照されているサードパーティ製品で使用されている言語によりドキュメントに例外が存在する場合があります。シスコのインクルーシブランゲージに対する取り組みの詳細は、こちらをご覧ください。

翻訳について

このドキュメントは、米国シスコ発行ドキュメントの参考和訳です。リンク情報につきましては、日本語版掲載時点で、英語版にアップデートがあり、リンク先のページが移動/変更されている場合がありますことをご了承ください。あくまでも参考和訳となりますので、正式な内容については米国サイトのドキュメントを参照ください。

マニュアルのコンテンツ
    null
このマニュアル内で検索
ログインしてコンテンツを保存
ご利用いただける言語

検索結果

Updated:
2021年5月31日月曜日

章のタイトル: デバイス設定の変更を自動化するテンプレートの作成

  • デバイス設定の変更を自動化するテンプレートの作成
  • テンプレート エディタについて
  • プロジェクトの作成
  • テンプレートの作成
    • 標準テンプレートの作成
      • ブロックリストコマンド
      • サンプル テンプレート
    • 複合テンプレートの作成
    • テンプレートの編集
    • テンプレートのシミュレーション
  • テンプレートのエクスポート
  • テンプレートのインポート
  • テンプレートの複製
  • プロジェクトのエクスポート
  • プロジェクトのインポート
  • テンプレート フォーム エディタ
    • 変数バインド
    • 特別なキーワード
  • テンプレートのネットワークプロファイルへの関連付け

デバイス設定の変更を自動化するテンプレートの作成

  • テンプレート エディタについて
  • プロジェクトの作成
  • テンプレートの作成
  • テンプレートのエクスポート
  • テンプレートのインポート
  • テンプレートの複製
  • プロジェクトのエクスポート
  • プロジェクトのインポート
  • テンプレート フォーム エディタ
  • テンプレートのネットワークプロファイルへの関連付け

テンプレート エディタについて

Cisco DNA Center Cisco DNA Center には、CLI テンプレートを作成するためのテンプレートエディタと呼ばれるインタラクティブなエディタがあります。パラメータ化された要素または変数を使用して、事前に定義された設定で簡単にテンプレートを設計できます。テンプレートを作成したら、そのテンプレートを再度使用して、ネットワーク内の任意の場所に設定されている 1 つ以上のサイトにデバイスを展開できます。

テンプレートエディタを使用すると、次のことができます。

  • テンプレートの作成、編集、および削除

  • インタラクティブ コマンドの追加

  • テンプレート内のエラーの検証

  • 追跡のためのテンプレートのバージョン管理

  • テンプレートのシミュレーション

プロジェクトの作成

手順


ステップ 1

[Tools] > [Template Editor]Cisco DNA Center GUI で [Menu] アイコン()をクリックして選択します > を選択します。

ステップ 2

左側のペインで、 > [プロジェクトの作成(Create Project))] の順にクリックします。

[Add New Project] スライドインペインが表示されます。

ステップ 3

[Name] フィールドに、プロジェクトの名前を入力します。

ステップ 4

(任意) [Description] フィールドに、プロジェクトの説明を入力します。

ステップ 5

[Add] をクリックします。

プロジェクトが作成され、左側のペインに表示されます。


テンプレートの作成

テンプレートは、パラメータ要素と変数を使用して構成を簡単に事前定義する方法を提供します。テンプレートにより、管理者は複数のネットワークデバイスを一貫して設定するのに使用する CLI コマンドの設定を定義できるようになり、展開時間を短縮できます。テンプレートの変数を使用すると、デバイスごとに特定の設定をカスタマイズできます。

  • 標準テンプレートの作成
  • 複合テンプレートの作成
  • テンプレートの編集
  • テンプレートのシミュレーション

標準テンプレートの作成

手順


ステップ 1

Cisco DNA Center GUI で [Menu] アイコン()をクリックして選択します[Tools] > [Template Editor] の順に選択します。

デフォルトでは、[Onboarding Configuration] プロジェクトは、day-0 テンプレートの作成に使用できます。独自のカスタムプロジェクトを作成できます。カスタムプロジェクトで作成されたテンプレートは、day-N テンプレートとして分類されます。

ステップ 2

左側のペインで、テンプレートを作成するプロジェクトを選択します。

ステップ 3

左側のペインで、歯車アイコン > [Add Templates] の順にクリックします。

または、左側のペインで > [Add Templates] をクリックします。

(注)   

day-0 用に作成したテンプレートは、day-N にも適用できます。

ステップ 4

[Add New Template] ウィンドウでは、デフォルトで [Regular Template] が選択されています。

ステップ 5

[Template Language] の選択で、[Velocity] または [Jinja] のいずれかのオプションボタンをクリックして、テンプレートの内容を作成するために使用する言語を選択します。

ステップ 6

[Name] フィールドにテンプレートの一意の名前を入力します。

ステップ 7

[Project Name] ドロップダウンリストからプロジェクトを選択します。

[Add Templates] パスから移動してきた場合、ドロップダウンリストが有効になっています。 >

プロジェクトを選択した後に左側のペインで歯車アイコン > [Add Templates] の順に選択した場合、ドロップダウンリストは無効になります。

ステップ 8

[Description] フィールドにテンプレートの説明を入力します。

ステップ 9

[Tags] ドロップダウンリストからテンプレートのタグ名を選択します。

タグはキーワードのようなもので、テンプレートを見つけるのに役立ちます。

(注)   
タグを使用してテンプレートをフィルタ処理する場合は、テンプレートを適用するデバイスに同じタグを適用する必要があります。適用しないと、プロビジョニング中に次のエラーが表示されます。「デバイスを選択できません。テンプレートとの互換性がありません(Cannot select the device. Not compatible with template.)」。
ステップ 10

[Edit] をクリックして、このテンプレートに適用するデバイスタイプを選択します。

[Select Device Type(s)] ウィンドウが表示されます。デフォルトでは、すべてのデバイスタイプが表示されます。

  • [Find] 機能でデバイス名を入力してデバイスをすばやく検索するか、またはデバイスタイプを展開してからテンプレートに適用するデバイスタイプの横にあるチェックボックスをオンにします。

    選択済みのデバイスを表示するには、[Show] ドロップダウンリストから [Selected] を選択します。

階層構造から選択するデバイスタイプには、さまざまな細かいレベルがあります。展開時にデバイスタイプを使用して、指定したデバイスタイプの条件に一致するデバイスをテンプレートが確実に展開できるようにします。これにより、特定のデバイスモデルに対して専用のテンプレートを作成できます。

テンプレートエディタには、デバイスの製品 ID(PID)は表示されません。代わりに、デバイスのシリーズとモデルの説明が表示されます。Cisco.com を使用すると、PID に基づいたデバイスデータシートの検索、デバイスシリーズとモデルの説明の検索、適切なデバイスタイプの選択を実行できます。

ステップ 11

デバイスタイプを選択したら、[Back to Add New Template] をクリックします。

ステップ 12

[Software Type] ドロップダウンリストから、ソフトウェアタイプとして、[IOS]、[IOS XE]、[IOS XR]、[NX-OS]、[Cisco Controller]、[Wide Area Application Services]、[Adaptive Security Appliance]、[NFV-OS]、[Others] を選択します。

シスコ ワイヤレス コントローラのサポート対象ソフトウェアバージョンおよびサポートされている最小バージョンの詳細については、「Cisco DNA Center Supported Devices」を参照してください。

たとえば、ソフトウェアタイプに IOS を選択すると、IOS XE や IOS XR など、すべてのソフトウェアタイプにコマンドを適用できます。この値は、プロビジョニング時に、選択したデバイスがテンプレートの選択に準拠しているかどうかを確認するために使用されます。

ステップ 13

[Software Version] フィールドにソフトウェアのバージョンを入力します。プロビジョニングの間、Cisco DNA Center は、選択したデバイスにテンプレートに記載されているのと同じソフトウェアバージョンがあるか確認します。不一致がある場合、プロビジョニングはテンプレートをスキップします。

ステップ 14

[Add]をクリックします。

テンプレートが作成され、左側のペインの選択したプロジェクトの下に表示されます。

ステップ 15

左側のペインで作成したテンプレートを選択して、テンプレートの内容を編集することができます。テンプレートの内容の編集の詳細については、テンプレートの編集を参照してください。


  • ブロックリストコマンド
  • サンプル テンプレート

ブロックリストコマンド

ブロックリストコマンドは、ブロックリストカテゴリに追加されるコマンドです。これらのコマンドは、Cisco DNA Center アプリケーションを介してのみ使用できます。テンプレートでブラックリストコマンドを使用すると、テンプレートに警告が表示されます。この場合、一部の Cisco DNA Center プロビジョニング アプリケーションと競合している可能性があります。

このリリースでサポートされるブロックリストコマンドを次に示します。

  • Router LISP は、Cisco Catalyst 1000 シリーズ スイッチ、Cisco Catalyst 3000 シリーズ スイッチ、Cisco Catalyst 4000 シリーズ スイッチ、および Cisco Catalyst 6000 シリーズ スイッチでサポートされます。

  • Hostname は、Cisco サービス統合型仮想ルータ(ISRv)および Cisco 適応型セキュリティ仮想アプライアンス(ASAv)でサポートされます。

サンプル テンプレート

テンプレートの変数を作成する際は、次のサンプルテンプレートを参照してください。

ホスト名を設定します
hostname$name
インターフェイスの設定
interface $interfaceName
description $description
シスコ ワイヤレス コントローラでの NTP の設定
config time ntp interval $interval

複合テンプレートの作成

2 つ 以上の標準テンプレートは、連続した複合テンプレートにまとめられます。一連のテンプレートに対し、デバイスに集合的に適用される連続的な複合テンプレートを作成できます。たとえば、ブランチを展開するときに、ブランチ ルータの最小設定を指定する必要があります。作成したすべてのテンプレートは、単一の複合テンプレートに追加できます。これは、ブランチ ルータに必要なすべての個々のテンプレートを集約したものです。複合テンプレートに含まれるテンプレートが、デバイスに展開される順序を指定してください。

(注)  

複合テンプレートには、コミットされたテンプレートのみを追加できます。

手順


ステップ 1

Cisco DNA Center GUI で [Menu] アイコン()をクリックして選択します[Tools] > [Template Editor] の順に選択します。

ステップ 2

左側のペインで、テンプレートを作成するプロジェクトを選択します。

ステップ 3

左側のペインで、歯車アイコン > [Add Templates] の順にクリックします。

[Add New Template] スライドインペインが表示されます。

ステップ 4

複合テンプレートの設定を指定します。

  1. [Template Type] で、複合テンプレートの [Composite Sequence] を選択します。

  2. [Template Language] については、テンプレートのコンテンツに使用する言語([Velocity] または [Jinja])を選択します。

  3. [Name] フィールドにテンプレートの一意の名前を入力します。

  4. (任意) [Description] フィールドにテンプレートの説明を入力します。

  5. [Tags] フィールドで、ドロップダウンリストをクリックし、テンプレートのタグを選択します。

    (注)   

    タグはキーワードのようなもので、テンプレートを見つけるのに役立ちます。

    タグを使用してテンプレートをフィルタ処理する場合は、テンプレートを適用するデバイスに同じタグを適用する必要があります。適用しないと、プロビジョニング中に「Cannot select the device. Not compatible with template.」というエラーメッセージが表示されます。

  6. [Device Type (s)] については、[Edit] をクリックし、このテンプレートを適用するデバイスタイプを選択します。

    [Select Device Type(s)] スライドインペインが表示されます。デフォルトでは、すべてのデバイスタイプが表示されます。

    (注)   
    • [Select Device Type(s)] スライドペインでは、[Full Device List] ビューと [Favorite Devices] ビューを切り替えることができます。

    • [Full Device List] ビューでは、デバイスタイプ階層の各デバイスモデルがアルファベット順に並べ替えられます。

    • [Find] 機能でデバイス名を入力してデバイスをすばやく検索するか、またはデバイスタイプを展開してからテンプレートに適用するデバイスタイプの横にあるチェックボックスをオンにします。

      選択済みのデバイスを表示するには、[Show] ドロップダウンリストから [Selected] を選択します。

  7. 階層で、デバイスタイプを展開し、お気に入りとしてマークするデバイスモデルの横に表示される星のマークをクリックします。

    (注)   

    [Favorite Devices] ビューに切り替えて、お気に入りのマークが付いたデバイスモデルのリストを表示することができます。

  8. デバイスタイプを選択したら、[Back to Add New Template] をクリックします。

  9. [Software Type] については、ドロップダウンリストをクリックし、ソフトウェアのタイプを選択します。

    (注)   

    ソフトウェアタイプに固有のコマンドがある場合は、特定のソフトウェアタイプ(IOS XE や IOS XR など)を選択できます。ソフトウェアタイプに IOS を選択すると、IOS XE や IOS XR など、すべてのソフトウェアタイプにコマンドを適用できます。この値は、プロビジョニング時に、選択したデバイスがテンプレートの選択に準拠しているかどうかを確認するために使用されます。

  10. [Software Version] フィールドにソフトウェアのバージョンを入力します。

    (注)   

    プロビジョニングの間、Cisco DNA Center は、選択したデバイスにテンプレートに記載されているのと同様のソフトウェアバージョンがあるか確認します。不一致がある場合、プロビジョニングはテンプレートをスキップします。

ステップ 5

[Add]をクリックします。

複合テンプレートが作成され、左側のペインの選択したプロジェクトの下に表示されます。

ステップ 6

左側のビューペインで作成した複合テンプレートをクリックします。

ステップ 7

[Template Editor] ウィンドウで、左側のペインからテンプレートを順番にドラッグアンドドロップします。

テンプレートは順序付けされた順序に基づいて導入されます。[テンプレート エディタ(Template Editor)] ウィンドウでテンプレートの順序を変更できます。

(注)   

デフォルトでは、[View] フィルタで [Applicable] オプションが選択されています。複合テンプレートに追加できる適用可能なテンプレートのみが [Template Editor] ウィンドウに表示されます。[View] フィルタで [All] オプションを選択すると、[Template Editor] ウィンドウにすべてのテンプレートを表示できます。[All] オプションビューでは、選択したデバイスタイプとソフトウェアバージョンに一致するテンプレートがプラスアイコンでマークされます。

複合テンプレートと同じデバイスタイプ、ソフトウェアタイプ、およびソフトウェアバージョンを持つテンプレートをドラッグアンドドロップできます。

ステップ 8

最初のテンプレートで障害が発生した場合に展開プロセスをキャンセルするには、[Template Editor] ウィンドウで最初のテンプレートを選択し、[Abort sequence on targets if deployment fails] チェックボックスをオンにします。

ステップ 9

[Actions] ドロップダウンリストで、[Commit] を選択してテンプレートのコンテンツをコミットします。


テンプレートの編集

テンプレートを作成したら、テンプレートを編集して内容を記述できます。

手順


ステップ 1

Cisco DNA Center GUI で [Menu] アイコン()をクリックして選択します[Tools] > [Template Editor] の順に選択します。

ステップ 2

左側のペインで、編集するテンプレートを選択します。

[Template Editor] ウィンドウが表示されます。

ステップ 3

[テンプレート エディタ(Template Editor)] ウィンドウで、テンプレートのコンテンツを入力します。単一行設定または複数選択設定を含むテンプレートを使用できます。

ステップ 4

[Template Language] から、内容の記述に使用する言語を選択します。

  • [Velocity]:Velocity Template Language(VTL)を使用します。詳細については、http://velocity.apache.org/engine/devel/vtl-reference.htmlを参照してください。

    Velocity テンプレートフレームワークでは、数字で始まる変数の使用が制限されます。変数名の先頭は数字ではなく文字にしてください。

    (注)   

    Velocity テンプレートの使用中は、ドル記号($)を使用しないでください。ドル記号($)を使用すると、その後ろの値は変数として扱われます。たとえば、パスワードを「$a123$q1ups1$va112」として設定すると、テンプレートエディタはこれを変数「a123」、「q1ups」、および「va112」として扱います。この問題を回避するために、Velocity テンプレートによるテキスト処理に合わせて Linux シェルスタイルを使用してください。

    (注)   

    Velocity テンプレートでは、変数を宣言する場合にのみドル($)記号を使用してください。

  • [Jinja]:Jinja 言語を使用します。詳細については、https://www.palletsprojects.com/p/jinja/を参照してください。

ステップ 5

[Actions] ドロップダウンリストから [Check for errors] を選択してテンプレートを検証します。

Cisco DNA Center 次のエラーをチェックし、報告します。
  • 言語構文エラー。

  • ブラックリストコマンドとの競合。詳細については、ブロックリストコマンドを参照してください。

ステップ 6

[Actions] ドロップダウンリストから、[Save] を選択します。

テンプレートを保存後、Cisco DNA Center がテンプレート内のすべてのエラーをチェックします。構文エラーがある場合、テンプレートの内容は保存されず、テンプレートで定義されているすべての入力変数が保存プロセス中に自動的に識別されます。ローカルの値(ループ用に使用され、セットを通じて割り当てられる変数など)は無視されます。

ステップ 7

[Actions] ドロップダウンリストから、[Commit] を選択します。

(注)   

ネットワーク プロファイルにコミットされたテンプレートのみを関連付けることができます。


テンプレートのシミュレーション

インタラクティブ テンプレート シミュレーションを使用すると、変数にテストデータを指定することで、変数をデバイスに送信する前に、テンプレートの CLI 生成をシミュレーションすることができます。テストシミュレーションの結果を保存し、必要に応じてそれらを後で使用することができます。

手順


ステップ 1

Cisco DNA Center GUI で [Menu] アイコン()をクリックして選択します >

ステップ 2

左側のペインで、編集するテンプレートを選択します。

[Template Editor] ウィンドウが表示されます。

ステップ 3

右上隅にある [Simulator Editor] アイコンをクリックし、コマンドのシミュレーションを実行します。

ステップ 4

[Actions] ドロップダウンリストから、[Create Simulation] を選択します。

[Simulation Input] フォームが表示されます。

ステップ 5

[Simulation Name name] フィールドにシミュレーションの名前を入力します。

(注)   

テンプレートに暗黙的な変数がある場合、[edit] リンクをクリックし、[Simulation Input] フォームでデバイスまたはサイトを選択して、バインディングに基づいて実際のデバイスに対してシミュレーションを実行できます。

ステップ 6

[シミュレーション入力(Simulation Input)] フォームの必須フィールドを入力し、[実行(Run)] をクリックします。

結果は、 [テンプレート プレビュー(Template Preview)] ウィンドウに表示されます。


テンプレートのエクスポート

テンプレートまたは複数のテンプレートを JSON フォーマットで 1 つのファイルにエクスポートできます。

手順


ステップ 1

[Tools] > [Template Editor]Cisco DNA Center GUI で [Menu] アイコン()をクリックして選択します > を選択します。

ステップ 2

左側のペインで、エクスポートするテンプレートを選択します。[Export] を選択します。 >

  • 1 つのプロジェクトの下に複数のテンプレートをエクスポートするには、左側のペインでプロジェクトを選択し、 > の [Export Template (s)] を選択します。

    [Export Template(s)] ウィンドウからテンプレートを選択し、[Export] をクリックします。

  • 異なるプロジェクトの下に複数のテンプレートをエクスポートするには、左側のペインで の [Export Project(s)] をクリックします。

    [Export Project(s)] ウィンドウからエクスポートするテンプレートを選択し、[Export] をクリックします。

ステップ 3

プロンプトが表示されたら、[Save] をクリックします。

テンプレートの最新バージョンがエクスポートされます。

テンプレートの以前のバージョンをエクスポートするには、[Actions] > [Show History] > [View] からテンプレートを開きます。

[Actions] > [Export] の順にクリックします。


テンプレートのインポート

プロジェクトの下に 1 つまたは複数のテンプレートをインポートできます。

手順


ステップ 1

[Tools] > [Template Editor]Cisco DNA Center GUI で [Menu] アイコン()をクリックして選択します > を選択します。

ステップ 2

左側のペインで、テンプレートをインポートするプロジェクトを選択します。 の [Import Template(s)] を選択します。 >

ステップ 3

[Import Template(s)] ウィンドウで [Select a File from your computer] をクリックし、JSON テンプレートファイルの場所を参照します。

ステップ 4

JSON ファイルを選択し、[Open] をクリックします。

テンプレートは、選択したプロジェクトの下にインポートされます。同じ名前のテンプレートが存在する場合、Cisco DNA Center はエラーメッセージを表示し、テンプレートをインポートしません。

(注)   

既存のものと同じ名前のテンプレートをインポートするには、[Import Template(s)] ウィンドウの [Create new version of imported template/project when template/project with the same name already exists in the hierarchy] チェックボックスをオンにします。

このオプションを選択すると、既存のテンプレートの新しいバージョンが作成されます。


テンプレートの複製

テンプレートのコピーを作成して、その一部を再利用することができます。

手順


ステップ 1

[Tools] > [Template Editor]Cisco DNA Center GUI で [Menu] アイコン()をクリックして選択します > を選択します。

ステップ 2

左側のペインで、エクスポートするテンプレートを選択します。[複製(Clone)] > を選択します。

ステップ 3

[Clone template] ウィンドウの [Name] フィールドに、複製されたテンプレートの名前を入力します。

ステップ 4

[Project Name] ドロップダウンリストからプロジェクトを選択します。

ステップ 5

[Clone] をクリックします。

ステップ 6

複製されたテンプレートを確定するには、ウィンドウの左ペインからテンプレートを選択し、[Actions] > [Commit] をクリックします。

テンプレートの最新バージョンが複製されます。

テンプレートの以前のバージョンを複製するには、[Actions] > [Show History] > [View] からテンプレートを開きます。

[Actions] > [Clone] をクリックします。


プロジェクトのエクスポート

プロジェクトまたは複数のプロジェクト (テンプレートを含む) を JSON フォーマットの 1 つのファイルにエクスポートできます。

手順


ステップ 1

[Tools] > [Template Editor]Cisco DNA Center GUI で [Menu] アイコン()をクリックして選択します > を選択します。

ステップ 2

左側のペインで、エクスポートするプロジェクトを選択します。の [Export Project] を選択します。 >

プロジェクトを一括してエクスポートするには、左側のペインで > の [Export Project (s)] をクリックします。

エクスポートするプロジェクトを選択し、[Export] をクリックします。

ステップ 3

プロンプトが表示されたら、[Save] をクリックします。


プロジェクトのインポート

テンプレートを使用して、1 つまたは複数のプロジェクトを Cisco DNA Center テンプレートエディタにインポートできます。

手順


ステップ 1

[Tools] > [Template Editor]Cisco DNA Center GUI で [Menu] アイコン()をクリックして選択します > を選択します。

ステップ 2

左側のペインで、[Import Project(s)] > をクリックします。

ステップ 3

[Import Project(s)] ウィンドウで [Select a File from your computer] をクリックし、JSON プロジェクトファイルの場所を参照します。

ステップ 4

JSON ファイルを選択し、[Open] をクリックします。

プロジェクトとそのテンプレートがインポートされます。同じ名前のプロジェクトが存在する場合、Cisco DNA Center はエラーメッセージを表示し、プロジェクトをインポートしません。

(注)   

既存のものと同じ名前のプロジェクトをインポートするには、[Import project(s)] ウィンドウの [Create new version of imported template/project when template/project with the same name already exists in the hierarchy] チェックボックスをオンにします。

このオプションを選択すると、既存のプロジェクトの新しいバージョンが作成されます。


テンプレート フォーム エディタ

テンプレート フォーム エディタは、追加のメタデータ情報をテンプレート内のテンプレート変数に追加するために使用します。またフォーム エディタを使用して、最大長や範囲などの変数の検証を提供することもできます。

手順


ステップ 1

Cisco DNA Center GUI で [Menu] アイコン()をクリックして選択します[Tools] > [Template Editor] の順に選択します。

ステップ 2

左側のペインで、プロジェクトを展開し、テンプレートをクリックします。

テンプレートが表示されます。

ステップ 3

[Form Editor] トグル をクリックします。

フォームエディタでは、テンプレート変数にメタデータを追加できます。テンプレートで識別されたすべての変数が表示されます。以下のメタデータを設定できます。

  • 文字列を変数として考慮しない場合は、変数を選択し、[Not a Variable] チェックボックスをオンにします。

  • [Field Name] テキストボックスに、フィールド名を入力します。これは、プロビジョニング中に各変数の UI ウィジェットに使用されるラベルです。

  • [ツールチップ(Tooltip)] テキスト ボックスに、各変数に表示されるツールチップのテキストを入力します。

  • [デフォルト値(Default Value)] テキスト ボックスに、デフォルト値を入力します。この値は、プロビジョニング中にデフォルト値として表示されます。

  • [説明文(Instructional Text)] テキスト ボックスに、任意の説明文を入力します。説明文は UI ウィジェット内に表示されます(たとえば、「ここにホスト名を入力してください」など)。ユーザーがテキストを入力するためにウィジェットをクリックすると、ウィジェット内のテキストは消去されます。

  • [データタイプ(Data Type)] ドロップダウンリストから、データタイプ:[文字列(String)] 、[整数(Integer)] 、[IP アドレス(IP Address)] 、または [MAC アドレス(Mac Address)] を選択します。

  • これがプロビジョニング中に必要な変数の場合、[必須(Required)] チェック ボックスにチェックを付けます。デフォルトでは、すべての変数に [必須(Required)] マークが付いています。これはつまり、プロビジョニング時にこの変数の値を入力する必要があることを意味します。パラメータに [Required] マークがなく、このパラメータに何も値を渡さない場合は、実行時に空の文字列に置換されます。変数の不足は、コマンドの失敗につながります。また、構文上正しくない可能性があります。[Required] マークが付いていない変数に基づいてコマンド全体をオプションにしたい場合は、テンプレートで if-else ブロックを使用します。

  • [表示タイプ(Display Type)] ドロップダウンリストから、プロビジョニング時に作成する UI ウィジェットのタイプ:[テキスト フィールド(Text Field)] 、[単一選択(Single Select)] 、または [複数選択 (Multi Select)] を選択します。

  • [最大文字数 (Maximum Characters)] テキスト ボックスに、入力できる最大文字数を入力します。これは文字列データタイプの場合にのみ適用可能です。

ステップ 4

メタデータ情報を設定したら、[Actions] ドロップダウンリストから [Save] を選択します。

ステップ 5

テンプレートを保存したら、バージョンを付ける必要があります。テンプレートは、変更を加えるたびにバージョンを付ける必要があります。[Actions] ドロップダウンリストから、[Commit] を選択します。[コミット(Commit)] ウィンドウが表示されます。[コミット メモ(Commit Note)] テキスト ボックスに、コミットのメモを入力することができます。バージョン番号はシステムによって自動的に生成されます。

ステップ 6

履歴を表示するには、[アクション(Actions)] ドロップダウンリストから、[履歴の表示(Show History)] を選択します。以前作成してバージョンを付けたテンプレートが表示されます。

ポップアップウィンドウが表示されます。

  • 古いバージョンのコンテンツを表示するには、ポップアップ ウィンドウの [表示(View)] をクリックします。

  • テンプレートを編集するには、ポップアップ ウィンドウの [編集(Edit)] をクリックします。


  • 変数バインド
  • 特別なキーワード

変数バインド

テンプレートを作成する場合、コンテキストに合わせて置き換わる変数を指定できます。これらの変数の多くは、[Template Editor] ドロップダウンリストで使用できます。

テンプレートエディタには、編集中または入力フォーム機能拡張(DHCP サーバー、DNS サーバー、syslog サーバーなど)から、ソースオブジェクト値を使用してテンプレートで変数をバインドまたは使用するオプションがあります。

一部の変数については、対応するソースに常にバインドされ、動作を変更することはできません。[Code Editor] または [Form Editor] ウィンドウでテンプレートの名前の横にある アイコンをクリックすると、暗黙の変数のリストを表示できます。

事前定義済みのオブジェクト値は、次のいずれかにすることができます。

  • インベントリ

    • デバイス オブジェクト

    • インターフェイス オブジェクト

  • [Common Settings]:[Design] > [Network Settings] > [Network] で利用可能な設定。共通設定の変数バインドによって、デバイスが属するサイトに基づいた値が解決されます。

手順


ステップ 1

Cisco DNA Center GUI で [Menu] アイコン()をクリックして選択します[Tools] > [Template Editor] の順に選択します。

ステップ 2

テンプレートを選択し、[Input Form] アイコンをクリックして、テンプレート内の変数をネットワーク設定にバインドします。

ステップ 3

変数をネットワーク設定にバインドするには、[Input Form] ペインで変数を選択し、[Required] チェックボックスをオンにします。

ステップ 4

[Display] ドロップダウンリストから、プロビジョニング時に作成する UI ウィジェットのタイプを選択します。[Text Field]、[Single Select]、または [Multi Select]。

ステップ 5

変数をネットワーク設定にバインドするには、[Input Form] で各変数を選択し、[Content] の下の [Bind to Source] チェックボックスをオンにします。

  • それぞれのドロップダウンリストで、[Source]、[Entity]、および [Attributes] を選択します。

  • ソースタイプが [CommonSettings] の場合は、次のエンティティのいずれかを選択します。[dhcp.server]、[syslog.server]、[snmp.trap.receiver]、[ntp.server]、[timezone.site]、[device.banner]、[dns.server]、[netflow.collector]。

    [dns.server] または [netflow.collector] 属性にフィルタ処理を適用して、デバイスのプロビジョニング時に、[bind] 変数の関連リストのみを表示することができます。属性にフィルタ処理を適用するには、[Filter by] ドロップダウンリストから属性を選択します。[Condition] ドロップダウンリストから、[Value] と一致させるための条件を選択します。

  • ソースタイプが [NetworkProfile] の場合、エンティティタイプとして [SSID] を選択します。入力される SSID エンティティは、[Design] > [Network Profile] で定義されます。 > バインドにより、SSID 名、サイト、および SSID カテゴリの組み合わせであるわかりやすい SSID 名が生成されます。[Attributes] ドロップダウンリストから、[wlanid] を選択します。この属性は、テンプレートのプロビジョニング時の高度な CLI 設定中に使用されます。

  • ソースタイプが [Inventory] の場合、次のいずれかのエンティティを選択します。[Device]、[Interface]、[AP Group]、[Flex Group]、[Wlan]、[Policy Profile]、[Flex Profile]。エンティティタイプ [Device] および [Interface] の場合、[Attribute] ドロップダウンリストにデバイスまたはインターフェイスの属性が表示されます。変数は、テンプレートを適用するデバイスで設定されている AP グループと Flex グループの名前を解決します。

    [Device]、[Interface]、または [Wlan] 属性にフィルタ処理を適用して、デバイスのプロビジョニング時に、[bind] 変数の関連リストのみを表示することができます。属性にフィルタ処理を適用するには、[Filter by] ドロップダウンリストから属性を選択します。[Condition] ドロップダウンリストから、[Value] と一致させるための条件を選択します。

変数を共通設定にバインドしたら、テンプレートをワイヤレスプロファイルに割り当て、テンプレートをプロビジョニングするときに、[Network Settings] > [Network] の下で定義したすべてのネットワーク設定がドロップダウンリストに表示されます。これらの属性は、ネットワークの設計時に [Network Settings] > [Network] の下で定義する必要があります。


特別なキーワード

テンプレートを通じて実行されるすべてのコマンドは、常に config t モードになります。そのため、テンプレートで明示的に enable or config t コマンドを指定する必要はありません。

Day-0 テンプレートは特別なキーワードをサポートしていません。

イネーブル モード コマンド

config t コマンドの他に任意のコマンドを実行する場合は、#MODE_ENABLE コマンドを指定します。

次の構文を使用して、CLI テンプレートに enable mode コマンドを追加します。

#MODE_ENABLE
<<commands>>
#MODE_END_ENABLE

インタラクティブコマンド

ユーザー入力が必要なコマンドを実行する場合は、#INTERACTIVE を指定します。

インタラクティブコマンドには、コマンドの実行後に入力する必要がある入力が含まれています。[CLI Content] 領域にインタラクティブ コマンドを入力するには、次の構文を使用します。

CLI Command<IQ>interactive question 1 <R> command response 1 <IQ>interactive question 2<R>command response 2

ここで、<IQ> および <R> タグは、デバイスに表示される内容に対して提供されるテキストを評価します。

インタラクティブな質問では、正規表現を使用して、デバイスから受け取ったテキストが入力されたテキストと類似しているかどうかを検証します。<IQ><R> タグに入力された正規表現が見つかった場合は、インタラクティブな質問が検証を通過し、出力テキストの一部が表示されます。つまり、質問の一部を入力する必要がありますが、質問全体を入力する必要はありません。<IQ>と <R> タグの間に「Yes」または「No」を入力するだけで十分ですが、デバイスからの質問の出力に「Yes」または「No」のテキストが表示されていることを確認する必要があります。これを行う最善の方法は、デバイスでコマンドを実行し、出力を確認することです。さらに、入力された正規表現のメタ文字または改行が適切に使用されるか、完全に回避されることを確認する必要があります。一般的な正規表現のメタ文字は です。( ) [ ] { } |* + ? \ $ ^: &。

たとえば、次のコマンドには、メタ文字と改行を含む出力があります。

Switch(config)# no crypto pki trustpoint DNAC-CA
% Removing an enrolled trustpoint will destroy all certificates received from the related Certificate Authority
Are you sure you want to do this? [yes/no]:

テンプレートにこれを入力するには、メタ文字または改行がない部分を選択する必要があります。ここでは、使用可能なものの例をいくつか紹介します。

#INTERACTIVE
no crypto pki trustpoint DNAC-CA<IQ>yes/no<R>yes
#ENDS_INTERACTIVE
#INTERACTIVE
no crypto pki trustpoint DNAC-CA<IQ>Removing an enrolled<R>yes
#ENDS_INTERACTIVE
#INTERACTIVE
no crypto pki trustpoint DNAC-CA<IQ>Are you sure you want to do this<R>yes
#ENDS_INTERACTIVE
#INTERACTIVE
crypto key generate rsa general-keys <IQ>yes/no<R> no
#ENDS_INTERACTIVE

ここで、<IQ> タグおよび <R> タグは大文字と小文字を区別し、大文字で入力する必要があります。


(注)  

応答後にインタラクティブな質問に対応するとき、改行文字が必要ない場合は <SF> タグを入力する必要があります。<SF> タグの前にスペースを 1 つ含めます。<SF> タグを入力すると、</SF> タグが自動的にポップアップ表示されます。</SF > タグは不要なため削除できます。

次に例を示します。

#INTERACTIVE
config advanced timers ap-fast-heartbeat local enable 20 <SF><IQ>Apply(y/n)?<R>y
#ENDS_INTERACTIVE

インタラクティブ イネーブル モード コマンドの組み合わせ

次の構文を使用して、インタラクティブな Enable Mode コマンドを結合します。

#MODE_ENABLE
#INTERACTIVE
commands<IQ>interactive question<R> response
#ENDS_INTERACTIVE
#ENDS_END_ENABLE
#MODE_ENABLE
#INTERACTIVE
mkdir <IQ>Create directory<R>xyz
#ENDS_INTERACTIVE
#MODE_END_ENABLE

複数行コマンド

CLI テンプレートで複数行をラップする場合は、MLTCMD タグを使用します。そうしなければ、コマンドは 1 行ずつデバイスに送信されます。[CLI Content] 領域にマルチライン コマンドを入力するには、次の構文を使用します。

<MLTCMD>first line of multiline command
second line of multiline command
...
...
last line of multiline command</MLTCMD>
  • ここで、<MLTCMD> および </MLTCMD> は大文字と小文字を区別し、大文字で入力する必要があります。

  • 複数行のコマンドは、<MLTCMD> タグと </MLTCMD> タグの間に挿入する必要があります。

  • タグをスペースで開始することはできません。

  • 1 行に <MLTCMD> タグと </MLTCMD> タグを使用することはできません。

テンプレートのネットワークプロファイルへの関連付け

始める前に

テンプレートをプロビジョニングする前に、テンプレートがネットワークプロファイルに関連付けられており、そのプロファイルがサイトに割り当てられていることを確認してください。

プロビジョニング中にデバイスが特定のサイトに割り当てられると、ネットワークプロファイルを介してサイトに関連付けられたテンプレートが詳細設定に表示されます。

手順


ステップ 1

Cisco DNA Center GUI で [Menu] アイコン()をクリックして選択します[Design] > [Network Profiles] の順に選択し、[Add Profile] をクリックします。

次のタイプのプロファイルを使用できます。

  • [Firewall]:ファイアウォール プロファイルの作成時にこれを選択します。
  • [NFVIS]:NFV プロファイルの作成時にこれを選択します。
  • [Routing]:ルーティングプロファイルの作成時にこれを選択します。
  • [Switching]:スイッチングプロファイルの作成時にこれを選択します。
    • 必要に応じて、[Onboarding Templates] または [Day-N Templates] をクリックします。

    • プロファイル名を入力します。

    • [+Add Template] をクリックして、[Device Type]、[Tag Name]、および [Template] ドロップダウンリストから、デバイスのタイプ、タグ、およびテンプレートを選択します。

      必要なテンプレートが見つからない場合は、テンプレートエディタで新しいテンプレートを作成できます。標準テンプレートの作成を参照してください。

    • [保存(Save)] をクリックします。

  • [Telemetry Appliance]:Cisco DNA トラフィック テレメトリ アプライアンス プロファイルの作成時にこれをクリックします。
  • [Wireless]:ワイヤレスプロファイルの作成時にこれをクリックします。ワイヤレス ネットワーク プロファイルを割り当てる前に、ワイヤレス SSID が作成されていることを確認してください。
    • プロファイル名を入力します。

    • [+ SSIDの追加(+ Add SSID)] をクリックします。[Network Settings] > [Wireless] の下で作成されたこれらの SSID が追加されます。

    • [Attach Template(s)] で、[Template] ドロップダウンリストからプロビジョニングするテンプレートを選択します。

    • [Save] をクリックします。

(注)   

スイッチングプロファイルとワイヤレスプロファイルは、[Cards] ビューおよび [Table] ビューで表示できます。

ステップ 2

[ネットワーク プロファイル(Network Profiles)] ページには、次のリストが表示されます。

  • Profile Name
  • Type
  • Version
  • Created By
  • [Sites]:[Assign Site] をクリックして、選択したプロファイルにサイトを追加します。
ステップ 3

Day-N プロビジョニングの場合は、[Provision] > [Network Devices] > [Inventory] の順に選択します。

  1. プロビジョニングするデバイス名の横にあるチェックボックスをオンにします。

  2. [Actions] ドロップダウンリストから、[Provision] を選択します。

  3. [サイトの割り当て(Assign Site)] ウィンドウで、プロファイルが添付されたサイトを割り当てます。

  4. [Choose a Site] フィールドで、コントローラと関連付けるサイトの名前を入力するか、[Choose a Site] ドロップダウンリストから選択します。

  5. [次へ (Next)] をクリックします。

  6. [設定(Configuration)]ウィンドウが表示されます。[管理対象 AP ロケーション(Managed AP Locations)] フィールドで、このコントローラによって管理される AP の場所を入力します。サイトの変更、削除、または再割り当てができます。これはワイヤレス プロファイルにのみ適用可能です。

  7. [Next] をクリックします。

  8. [Advanced Configuration(詳細設定)] ウィンドウが表示されます。ネットワークプロファイルを介してサイトに関連付けられたテンプレートが詳細設定に表示されます。

    • テンプレート内のインテントからの構成を上書きして、変更を上書きする場合は、[Provision these templates even if they have been deployed before] チェックボックスをオンにします(このオプションは、デフォルトで無効です)。

    • [Copy running config to startup config] オプションはデフォルトで有効になっています。つまり、テンプレート構成を展開した後、write mem が適用されます。実行コンフィギュレーションをスタートアップコンフィギュレーションに適用しない場合は、このチェック ボックスをオフにする必要があります。

    • [Find] 機能を使用し、デバイス名を入力してすばやくデバイスを検索するか、左側のペインでテンプレートフォルダを展開してテンプレートを選択します。右側のペインで、送信元にバインドされている属性の値を選択します。

    • テンプレートを導入する間にテンプレートの変数を CSV ファイルにエクスポートするには、右側のペインで [エクスポート(Export)] をクリックします。CSV ファイルを使用して変数設定に必要な変更を加え、右側のペインで [Import] をクリックすると、後でそれを Cisco DNA Center にインポートできます。

  9. [次へ(Next)] をクリックしてテンプレートを導入します。

  10. テンプレートを今すぐ展開する場合は [Now] を選択します。または、後で展開するようにスケジュールすることを選択します。

    展開が正常に完了すると、[Device Inventory] ウィンドウの [Status] 列に「SUCCESS」と表示されます。
ステップ 4

[Export Deployment CSV] をクリックして、1 つのファイルに含まれるすべてのテンプレートからテンプレート変数をエクスポートします。

ステップ 5

[Import Deployment CSV] をクリックして、1 つのファイルに含まれるすべてのテンプレートからテンプレート変数をインポートします。

ステップ 6

Day-0 プロビジョニングの場合は、[Provision] > [Network Devices] > [Plug and Play] の順に選択します。

  1. デバイスを選択し、[Actions] ドロップダウンリストから [Claim] をクリックします。

  2. [Next] をクリックし、[Site Assignment] ウィンドウで、[Site] ドロップダウンリストからサイトを選択します。

  3. [Next] をクリックし、[Configuration] ウィンドウで、イメージと Day-0 テンプレートを選択します。

  4. [Next] をクリックし、[Advanced Configuration] ウィンドウで場所を入力します。

  5. [Next] をクリックして、[Device Details]、[Image Details]、[Day-0 Configuration Preview]、および [Template CLI Preview] を表示します。


このドキュメントは役に立ちましたか?

Feedbackフィードバック

シスコに問い合わせ

  • サポート ケースをオープンlogin required
  • (シスコ サービス契約が必要です。)