作成するプレイタイプを選択し、[次へ（Next）] をクリックします。

チェックプレイまたはデータ収集プレイを作成する場合は、シスコ製品向けの YANG モジュールを利用できます。このセクションで説明するプロセスでは、使用するセンサーまたは変更するフィールドがシスコから提供される YANG モジュールに含まれていることを前提としています。センサーまたはフィールドがデフォルトの YANG モジュールにない場合は、デバイスカバレッジを拡大できます。新規または変更したモジュールのロードについては、『Cisco Crosswork Network Controller Administration』のトピック「Manage device packages」を参照してください。

作成しようとしている構成が NSO で利用可能であることを確認します。利用できない場合、エラーが表示されます。

サービスプレイを作成するときは、NSO 向けのサービスを新規に作成するのではなく、1 つ以上の NSO インスタンスで既存のサービスを管理およびプロビジョニングするためのプレイを作成します。詳細については、https://developer.cisco.com/docs/nso/ を参照してください。

[名前（Name）] と [説明（Description）] に一意の値を入力して、プレイのラベルとします。

プレイにラベルを追加して、後でグループ化することもできます（オプション）。

[プレイリスト（Play List）] ウィンドウが開いて、プレイリストに新しいカスタムプレイが表示されます。

インポート対象のプレイと同じ名前のシスコ提供のプレイがないことを確認します。同じ名前のプレイをインポートすると失敗します。

プレイブックで目的のプレイをすべて選択し、[次へ（Next）] をクリックします。

[デバイスでのチェック同期の実行（Perform Check Sync on the device）] プレイは、NSO とのデバイス同期ステータスをチェックし、プレイブックの sync パラメータ値に基づいて、必要な場合にのみ同期を実行します。これによりプレイブックの実行時間が短縮され、NSO 設定がデバイス設定と一致します。

• プレイブックの sync パラメータが [True] に設定されていて、デバイスが同期していない場合、[デバイスでのチェック同期の実行（Perform Check Sync on the device）] プレイにより、デバイスは NSO 設定と同期されます。

• sync パラメータが [False] に設定されていて、デバイスが同期していない場合、プレイはコミットメッセージを表示して実行に失敗します。

• デバイスがすでに同期している場合、プレイは成功します。

選択したプレイのタイプによっては、特定のフェーズでの使用が制限されることがあります。たとえば、構成プレイはメンテナンスフェーズ以外では使用できません。

各実行フェーズの詳細については、プレイブック実行順序を参照してください。

Change Automation では、プレイ名がインジケータでフォーマットされます。たとえば、構成の場合は「cfg」、チェックの場合は「chk」などとなり、プレイを正しく整理する場合に便利です。自分で作成するプレイにも同じようなタグ付けを使用できます。

また、所定のアイコンをクリックして、プレイを複製または削除することもできます。

[次へ（Next）] をクリックします。

次を実行します。

[次へ（Next）] をクリックして続行します。

[プレイブックリスト（Playbook List）] ウィンドウが開いて、リストに新しいカスタムプレイブックが表示されます。

カスタムプレイを作成するには、UI（テンプレートを使用したカスタムプレイの作成を参照）または API（API コール //crosswork_ip:30603/crosswork/nca/v1/Plays/device/config を使用）を利用します。

API コール：//crosswork_ip:30603/crosswork/nca/v1/mops

既存のプレイブックを上書きする場合を除き、インポート対象のプレイブックと同じ名前のプレイブックが存在しないことを確認します。

プレイブックの改良バージョンを作成する場合は、バージョン番号やその他のインジケータを使用して、名前が一意で、改良バージョンのテストが完了するまで元のプレイブックが上書きされないようにすることをお勧めします。

このウィンドウを使用して、次の操作が可能です。

• ウィンドウの左上隅にあるドロップダウンボタンで適切なオプションをクリックして選択することで、テーブルビューとトポロジマップビューとを切り替えることができます。[リストからデバイスを選択（Select Devices From List）] または [マップからデバイスを選択（Select Devices From Map）] を選択して、テーブルビューまたはトポロジマップビューをそれぞれ選択します。デフォルトでは、テーブルビューが表示されます。

• トポロジマップビューが表示されている場合、 または をクリックして、マップの地理的ビューと論理ビューとを切り替えることができます。また、メインメニューから [トポロジ（Topology）] を選択すると表示されるトポロジマップの場合と同じく、ズーム、帯域幅使用率の表示、および論理ビューレイアウトの変更を行うことができます。

• デバイスは手動で、またはタグを使用して選択できます。[デバイスタグの選択（Select device tag）] オプションを選択すると、テーブルからデバイスではなく適切なタグを選択して、そのタグに関連付けられているすべてのデバイスを選択できます。[デバイスを手動で選択（Select device manually）] オプションを選択すると、簡易フィルタと拡張フィルタを使用してリストからデバイスを選択し、左側のタグでフィルタ処理できます。オプションの横にある アイコンの上にマウスポインタを置くと、詳細な情報が表示されます。選択したプレイブックに必要なデバイスの数などの選択基準を表示することもできます。

  （注）

  管理者以外のユーザーがデバイスを手動で選択する場合は、次の点に注意してください。 プレイブックを実行するデバイスは、デバイスアクセスグループに属し、このデバイスアクセスグループにアクセスできる必要があります。デバイスアクセスグループおよびユーザーとデバイスアクセスグループとの関連付けの詳細については、『 Cisco Crosswork Network Controller Administration Guide』の「Manage Device Access Groups」のセクションを参照してください。 ロールが空のデバイスアクセスグループに関連付けられている場合、エラーメッセージが表示されます。 ロールが複数のデバイスアクセスグループに関連付けられていて、デバイスがそれらのデバイスアクセスグループのいずれかに属している場合、このデバイスでプレイブックを実行できます。デバイスがどのデバイスアクセスグループにも属していない場合、操作は失敗します。 （[一括ジョブの許可（Allow bulk jobs）] オプションまたはタグを使用して）複数のデバイスを選択し、いずれかのデバイスにアクセス権がない場合、このデバイスのリストにはプレイブックを実行するためのアクセス権がないことを示すエラーメッセージが表示されます。

• [デバイスを手動で選択（Select device manually）] 選択モードでは、[一括ジョブを許可（Allow Bulk Jobs）] チェックボックスをオンにして、複数のデバイスを選択し、選択したプレイブックをそれらのデバイスで同時に実行できます。選択した内容に基づいて、複数のジョブの静的グループが作成されます。チェックボックスの横にある アイコンの上にマウスポインタを置くと、詳細が表示されます。一括ジョブに対して選択できるデバイスの数に制限はありません。

  （注）	[一括ジョブを許可（Allow Bulk Jobs）] オプションは、単一のデバイスで実行できるプレイブックに対して有効です。

[パラメータ（Parameters）] ウィンドウが表示されている場合、次の操作も実行できます。

• をクリックして、目的のパラメータ値で JSON ファイルをアップロードします。ブラウザとオペレーティングシステムに応じて以前に作成した（あるいは以前のプレイブック実行からダウンロードした）JSON パラメータファイルに移動して、そのファイルをアップロードするように求められます。

• をクリックして、JSON 形式でパラメータ値を入力します。ポップアップテキストウィンドウに、JSON パラメータの詳細なリストが表示されます。空の値は引用符で囲まれています。値を編集し、必要な作業を終えたら、[保存（Save）] をクリックします。

  

• をクリックして、設定する項目を選択します。ポップアップテキストウィンドウが開き、設定可能なプレイまたはパラメータの完全なリストが表示されます。プレイブックの場合、プレイのリストが表示され、選択したプレイごとに、そのプレイに設定できるパラメータのリストが表示されます。いずれかの項目を選択解除すると、その項目は設定用に表示されません。編集不可能なオプションは、選択解除できない必須項目です。

  

  

• 現在実行しているプレイブックに必要であれば、 をクリックして特定のパラメータのさらに別のインスタンスを追加します。こうして追加したインスタンスを削除するには、 をクリックします。

• をクリックして、これまで入力したすべてのパラメータ値をクリアします。

このウィンドウでの操作は次のとおりです。

• [名前（Name）] にジョブの適切な名前を指定する必要があります。

• [ラベル（Labels）] フィールドを使用して、ジョブのラベルを入力できます。

• [ジョブの確認（Review your Job）] ウィンドウサマリーでいずれかの [変更（Change）] リンクをクリックして、選択内容を変更します。

• [リハーサル（Dry Run）] タブをクリックし、これがリハーサルでなければデバイスにプッシュされることになる構成変更を検証します。変更が加えられていなければ、このタブに no config change メッセージが表示されます。このタブに表示されるのは、個別に加えた各変更ではなく、累積された構成変更のみであることに注意してください。たとえば、プレイブックがあるステップで set-overload-bit を構成し、後で no set-overload-bit を使用してその構成を解除した場合は、no config change が表示されます。

• [イベント（Events）] タブをクリックして、プレイブックのステップごとに成功と失敗のメッセージを表示します。こうしたメッセージは、個々のプレイや実行全体に関する問題を診断して修正する場合に便利です。トラブルシューティング情報については、Change Automation のトラブルシューティングを参照してください。

• [コンソール（Console）] タブをクリックして、実行中に生成されたメッセージを表示します。

リハーサルでは syslog 収集が無効であるため、そのことを示すメッセージのみが [syslog] タブに含まれます。

このウィンドウを使用して、次の操作が可能です。

• ウィンドウの左上隅にあるドロップダウンボタンで適切なオプションをクリックして選択することで、テーブルビューとトポロジマップビューとを切り替えることができます。[リストからデバイスを選択（Select Devices From List）] または [マップからデバイスを選択（Select Devices From Map）] を選択して、テーブルビューまたはトポロジマップビューをそれぞれ選択します。デフォルトでは、テーブルビューが表示されます。

• トポロジマップビューが表示されている場合、 または をクリックして、マップの地理的ビューと論理ビューとを切り替えることができます。また、メインメニューから [トポロジ（Topology）] を選択すると表示されるトポロジマップの場合と同じく、ズーム、帯域幅使用率の表示、および論理ビューレイアウトの変更を行うことができます。

• デバイスは手動で、またはタグを使用して選択できます。[デバイスタグの選択（Select device tag）] オプションを選択すると、テーブルからデバイスではなく適切なタグを選択して、そのタグに関連付けられているすべてのデバイスを選択できます。[デバイスを手動で選択（Select device manually）] オプションを選択すると、簡易フィルタと拡張フィルタを使用してリストからデバイスを選択し、左側のタグでフィルタ処理できます。オプションの横にある アイコンの上にマウスポインタを置くと、詳細な情報が表示されます。選択したプレイブックに必要なデバイスの数などの選択基準を表示することもできます。

  （注）

  管理者以外のユーザーがデバイスを手動で選択する場合は、次の点に注意してください。 プレイブックを実行するデバイスは、デバイスアクセスグループに属し、このデバイスアクセスグループにアクセスできる必要があります。デバイスアクセスグループおよびユーザーとデバイスアクセスグループとの関連付けの詳細については、『 Cisco Crosswork Network Controller Administration Guide』の「Manage Device Access Groups」のセクションを参照してください。 ロールが空のデバイスアクセスグループに関連付けられている場合は、エラーメッセージが表示されます。 ロールが複数のデバイスアクセスグループに関連付けられていて、デバイスがそれらのデバイスアクセスグループのいずれかに属している場合、このデバイスでプレイブックを実行できます。デバイスがどのデバイスアクセスグループにも属していない場合、操作は失敗します。 （[一括ジョブの許可（Allow bulk jobs）] オプションまたはタグを使用して）複数のデバイスを選択し、そのいずれかにアクセス権がない場合は、このデバイスのリストにはプレイブックを実行するためのアクセス権がないというエラーメッセージが表示されます。

• [デバイスを手動で選択（Select device manually）] 選択モードでは、[一括ジョブを許可（Allow Bulk Jobs）] チェックボックスをオンにして、複数のデバイスを選択し、選択したプレイブックをそれらのデバイスで同時に実行できます。選択した内容に基づいて、複数のジョブの静的グループが作成されます。チェックボックスの横にある アイコンの上にマウスポインタを置くと、詳細が表示されます。一括ジョブに対して選択できるデバイスの数に制限はありません。

  （注）	[一括ジョブを許可（Allow Bulk Jobs）] オプションは、単一のデバイスで実行できるプレイブックに対して有効です。

[パラメータ（Parameters）] ウィンドウが表示されている場合、次の操作も実行できます。

• をクリックして、目的のパラメータ値で JSON ファイルをアップロードします。ブラウザとオペレーティングシステムに応じて以前に作成した（あるいは以前のプレイブック実行からダウンロードした）JSON パラメータファイルに移動して、そのファイルをアップロードするように求められます。

• をクリックして、JSON 形式でパラメータ値を入力します。ポップアップテキストウィンドウに、JSON パラメータの詳細なリストが表示されます。空の値は引用符で囲まれています。値を編集し、必要な作業を終えたら、[保存（Save）] をクリックします。

  

• をクリックして、設定する項目を選択します。ポップアップテキストウィンドウが開き、設定可能なプレイまたはパラメータの完全なリストが表示されます。プレイブックの場合、プレイのリストが表示され、選択したプレイごとに、そのプレイに設定できるパラメータのリストが表示されます。いずれかの項目を選択解除すると、その項目は設定用に表示されません。編集不可能なオプションは、選択解除できない必須項目です。

  

  

• 現在実行しているプレイブックに必要であれば、 をクリックして特定のパラメータのさらに別のインスタンスを追加します。こうして追加したインスタンスを削除するには、 をクリックします。

• をクリックして、これまで入力したすべてのパラメータ値をクリアします。

[カスタマイズ（Customize）] を選択すると、[チェックポイントのカスタマイズ（Customize check point）] ポップアップにプレイブック内のすべてのプレイのリストが表示されます。各プレイ間のステップには があります。ブレークポイントを設定する各ステップで をクリックします。作業が終了したら、[完了（Done）] をクリックします。

• [名前（Name）] にジョブの適切な名前を指定する必要があります。

• [ラベル（Labels）] フィールドを使用して、ジョブのラベルを入力できます。

• [ジョブの確認（Review your Job）] ウィンドウサマリーでいずれかの [変更（Change）] リンクをクリックして、選択内容を変更します。

• ウィンドウの左側にある [メンテナンス（Maintenance）] プレイリストに、プレイブック内の各プレイの実行ステータスを表示します。失敗したプレイは赤色のアイコンで示され、成功したプレイは緑色のアイコンで示されます。

• ウィンドウの上部にある [プレイブック（Playbook）] タイルと [デバイス（Devices）] タイルで、選択内容のリマインダを確認します。

• ウィンドウの上部にある [実行中（Running）] タイルで、実行の現在のステータスを確認します。

• [パラメータ（Parameters）] タイルの [表示（View）] をクリックして、実行のパラメータを表示します。パラメータを表示しているときに、[パラメータのダウンロード（Download Parameters）] をクリックして、JSON ファイルにパラメータを保存できます。ブラウザとオペレーティングシステムに応じた名前をファイルに付けて適切に保存するように求められます。

• ウィンドウの右側にあるマップでネットワークトポロジを使用して、デバイスとそこからネットワークの他の部分への接続とを表示します。

• [イベント（Events）] タブをクリックして、プレイブックのステップごとに成功と失敗のメッセージを表示します。こうしたメッセージは、個々のプレイや実行全体に関する問題を診断して修正する場合に便利です。

• [Syslog] タブをクリックして、実行中および実行直後に収集された syslog メッセージにアクセスします。syslog 収集が有効になっている場合、収集された syslog が保存されている syslog ストレージプロバイダーを指すパスへのポインタがこのタブに表示されます。syslog を収集しないことにした場合や、syslog ストレージプロバイダーが構成されていない場合は、syslog 収集が無効になっていることを示すメッセージがこのタブに表示されます。

• [コンソール（Console）] タブをクリックして、実行中にデバイスコンソールでやり取りされたコマンドと応答を表示します。これらのメッセージは、診断にも役立ちます。

• 監査ログにイベントが作成されます（[管理（Administration）] > [監査ログ（Audit log）]）。監査ログには、プレイブックの名前、プレイブックを実行したユーザー、コミットラベル（存在する場合）などの詳細が含まれます。

このウィンドウを使用して、次の操作が可能です。

• ウィンドウの左上隅にあるドロップダウンボタンで適切なオプションをクリックして選択することで、テーブルビューとトポロジマップビューとを切り替えることができます。[リストからデバイスを選択（Select Devices From List）] または [マップからデバイスを選択（Select Devices From Map）] を選択して、テーブルビューまたはトポロジマップビューをそれぞれ選択します。デフォルトでは、テーブルビューが表示されます。

• トポロジマップビューが表示されている場合、 または をクリックして、マップの地理的ビューと論理ビューとを切り替えることができます。また、メインメニューから [トポロジ（Topology）] を選択すると表示されるトポロジマップの場合と同じく、ズーム、帯域幅使用率の表示、および論理ビューレイアウトの変更を行うことができます。

• デバイスは手動で、またはタグを使用して選択できます。[デバイスタグの選択（Select device tag）] オプションを選択すると、テーブルからデバイスではなく適切なタグを選択して、そのタグに関連付けられているすべてのデバイスを選択できます。[デバイスを手動で選択（Select device manually）] オプションを選択すると、簡易フィルタと拡張フィルタを使用してリストからデバイスを選択し、左側のタグでフィルタ処理できます。オプションの横にある アイコンの上にマウスポインタを置くと、詳細な情報が表示されます。選択したプレイブックに必要なデバイスの数などの選択基準を表示することもできます。

  （注）

  管理者以外のユーザーがデバイスを手動で選択する場合は、次の点に注意してください。 プレイブックを実行するデバイスは、デバイスアクセスグループに属し、このデバイスアクセスグループにアクセスできる必要があります。デバイスアクセスグループおよびユーザーとデバイスアクセスグループとの関連付けの詳細については、『 Cisco Crosswork Network Controller Administration Guide』の「Manage Device Access Groups」のセクションを参照してください。 ロールが空のデバイスアクセスグループに関連付けられている場合は、エラーメッセージが表示されます。 ロールが複数のデバイスアクセスグループに関連付けられていて、デバイスがそれらのデバイスアクセスグループのいずれかに属している場合、このデバイスでプレイブックを実行できます。デバイスがどのデバイスアクセスグループにも属していない場合、操作は失敗します。 （[一括ジョブの許可 （Allow bulk jobs ）] オプションまたはタグを使用して）複数のデバイスを選択し、いずれかのデバイスにもアクセス権がない場合は、このデバイスのリストにはプレイブックを実行するためのアクセス権がないことを示すエラーメッセージが表示されます。

• [デバイスを手動で選択（Select device manually）] 選択モードでは、[一括ジョブを許可（Allow Bulk Jobs）] チェックボックスをオンにして、複数のデバイスを選択し、選択したプレイブックを同時に実行できます。選択した内容に基づいて、複数のジョブの静的グループが作成されます。チェックボックスの横にある アイコンの上にマウスポインタを置くと、詳細が表示されます。一括ジョブに対して選択できるデバイスの数に制限はありません。

  （注）	[一括ジョブを許可（Allow Bulk Jobs）] オプションは、単一のデバイスで実行できるプレイブックに対して有効です。

[パラメータ（Parameters）] ウィンドウが表示されている場合、次の操作も実行できます。

• をクリックして、目的のパラメータ値で JSON ファイルをアップロードします。ブラウザとオペレーティングシステムに応じて以前に作成した（あるいは以前のプレイブック実行からダウンロードした）JSON パラメータファイルに移動して、そのファイルをアップロードするように求められます。

• をクリックして、JSON 形式でパラメータ値を入力します。ポップアップテキストウィンドウに、JSON パラメータの詳細なリストが表示されます。空の値は引用符で囲まれています。値を編集し、必要な作業を終えたら、[保存（Save）] をクリックします。

  

• をクリックして、設定する項目を選択します。ポップアップテキストウィンドウが開き、設定可能なプレイまたはパラメータの完全なリストが表示されます。プレイブックの場合、プレイのリストが表示され、選択したプレイごとに、そのプレイに設定できるパラメータのリストが表示されます。いずれかの項目を選択解除すると、その項目は設定用に表示されません。編集不可能なオプションは、選択解除できない必須項目です。

  

  

• 現在実行しているプレイブックに必要であれば、 をクリックして特定のパラメータのさらに別のインスタンスを追加します。こうして追加したインスタンスを削除するには、 をクリックします。

• をクリックして、これまで入力したすべてのパラメータ値をクリアします。

• [名前（Name）] にジョブの適切な名前を指定する必要があります。

• [ラベル（Labels）] フィールドを使用して、ジョブのラベルを入力できます。

• [ジョブの確認（Review your Job）] ウィンドウサマリーで [変更（Change）] リンクをクリックして、選択内容を変更します。

• ウィンドウの左側にある [メンテナンス（Maintenance）] プレイリストに、プレイブック内の各プレイの実行ステータスを表示します。失敗したプレイは赤色のアイコンで示され、成功したプレイは緑色のアイコンで示されます。

• ウィンドウの上部にある [プレイブック（Playbook）] タイルと [デバイス（Devices）] タイルで、選択内容のリマインダを確認します。

• ウィンドウの上部にある [実行中（Running）] タイルで、実行の現在のステータスを確認します。

• [パラメータ（Parameters）] タイルの [表示（View）] をクリックして、実行のパラメータを表示します。パラメータを表示しているときに、[パラメータのダウンロード（Download Parameters）] をクリックして、JSON ファイルにパラメータを保存できます。ブラウザとオペレーティングシステムに応じた適切な名前をファイルに付けて保存するように求められます。

• ウィンドウの右側にあるマップでネットワークトポロジを使用して、デバイスとそこからネットワークの他の部分への接続とを表示します。

• [イベント（Events）] タブをクリックして、プレイブックのステップごとに成功と失敗のメッセージを表示します。こうしたメッセージは、個々のプレイや実行全体に関する問題を診断して修正する場合に便利です。

• [Syslog] タブをクリックして、実行中および実行直後に収集された syslog メッセージにアクセスします。syslog 収集が有効になっている場合、収集された syslog が保存されている syslog ストレージプロバイダーを指すパスへのポインタがこのタブに表示されます。syslog を収集しないことにした場合や、syslog ストレージプロバイダーが構成されていない場合は、syslog 収集が無効になっていることを示すメッセージがこのタブに表示されます。

• [コンソール（Console）] タブをクリックして、実行中にデバイスコンソールでやり取りされたコマンドと応答を表示します。これらのメッセージは、診断にも役立ちます。

• 監査ログにイベントが作成されます（[管理（Administration）] > [監査ログ（Audit log）]）。監査ログには、プレイブックの名前、プレイブックを実行したユーザー、コミットラベル（存在する場合）などの詳細が含まれます。

[自動化ジョブ履歴（Automation Job History）] ウィンドウのリストは、最終更新時間でソートされ、実行中のジョブまたは最近実行されたジョブが一番上に表示されます。他のテーブルウィンドウの列と同じように、簡易フィルタまたは拡張フィルタをテーブルに適用できます。