StyleBooks Configuration Builder を使用した NetScaler アプリケーション構成の移行

最終公開日 : Oct 02, 2026
StyleBooks Configuration Builder は、既存の NetScaler 構成を StyleBooks に移行するために使用されます。この機能は、アプリケーション構成の移行を、ある NetScaler インスタンスから別のインスタンスまたは Autoscale グループへ自動化します。
Configuration Builder は、NetScaler 構成のあらゆるバリアントに使用できる構造化されたアプリケーション StyleBook を提供します。この機能は、StyleBooks の文法や構成要素に関する深い知識がなくても StyleBooks を使い始めるのに役立ちます。そうでない場合、StyleBook を作成するには StyleBooks の文法と構成要素の知識が必要です。
Configuration Builder は、新しい NetScaler インスタンスで同じ NetScaler 構成を反映する構成パックも作成します。この構成パックを使用すると、ある NetScaler インスタンスからの初期 NetScaler 構成を別の NetScaler インスタンスに複製できます。初期構成ソースは次のいずれかです。
  • NetScaler インスタンス: 複製したいアプリケーション構成がホストされているインスタンスを指定します。
    ターゲットインスタンスを指定しない場合でも、Configuration Builder は NetScaler 構成を StyleBook および構成パックに変換します。この構成パックは、後で NetScaler 構成を他の NetScaler インスタンスに移行するために使用できます。
    ターゲットインスタンスが Autoscale™ グループの場合、構成パックは Network > AutoScale Group ページに表示されます。Configuration タブの下です。
  • CLI コマンドのセット: ns.conf または Application config から構成を貼り付けます。
Configuration Builder は、ソース構成に埋め込まれた個別のアプリケーションのリストを識別します。関心のあるアプリケーション構成を選択すると、Configuration Builder は選択したアプリケーションの CLI コマンドのセットを抽出します。これらの CLI コマンドはソース構成から抽出されます。また、入力が必要となる可能性のある展開属性と構成属性も識別します。
  • IP アドレス/ポート - 仮想サーバー、サービス、サービスグループメンバーの IP アドレスとポートを元の構成から表示および編集できます。
  • 構成ファイル/シークレット - これらの属性は、ソース構成で指定されたパスワードまたは証明書である場合があります。
必要な情報を指定した後、ターゲット NetScaler インスタンスでアプリケーション構成の移行または複製を開始します。
StyleBooks Configuration Builder ワークフロー
アプリケーションの作成と移行後、adc_nitro_application StyleBook を使用して NetScaler Console に構成パックが作成されます。この StyleBook は NetScaler NITRO リソースに基づいて作成されます。この構成パックは、ターゲット NetScaler インスタンス上のアプリケーション構成を表します。作成された構成パックを表示するには、Applications > Configuration > Confg Packs に移動します。

移行された構成間での構成エンティティの共有

Config Migrationユーティリティを使用して構成を移行する際に、構成エンティティを再利用できます。その後の移行では、既存の構成エンティティが正常に再利用されます。以前は、一部の構成エンティティを共有する2つの構成を移行する際に、「Resource already exists」というエラーで構成の移行が失敗していました。このオプションにより、複数の構成で構成エンティティが使用されるシナリオで、それらの再利用が可能になり、移行ワークフローが効率化されます。

サポートされているNetScaler機能

StyleBook Configuration Builderは、ソース構成内の以下のNetScaler機能を認識し、サポートしています。
  • コンテンツスイッチング
  • 負荷分散
  • 監視
  • SSLオフロード
  • レート制限
  • 書き換え
  • レスポンダー
  • Webアプリケーションファイアウォール (WAF)
  • ボット管理
  • 圧縮制御

NetScalerアプリケーション構成を移行するためのStyleBookの作成

NetScaler ConsoleでNetScalerアプリケーションの移行を行うStyleBookを作成する手順は次のとおりです。
  1. アプリケーション > 設定 > 設定パック に移動します。
  2. Migrate NetScaler Configuration をクリックします。
  3. Get Started をクリックします。
  4. Specify Configuration で、構成ソースを選択します。
    • Import from a NetScaler: このオプションは、選択したNetScalerインスタンス上のアクティブなアプリケーションを検出します。
    • Import using CLI Commands: このオプションは、CLIコマンドを分析し、CLIコマンドからアプリケーションを抽出します。
  5. アプリケーション構成を移行または複製する元の Source NetScaler Instance を指定します。
    アプリケーション構成をAutoscaleグループに移行するには、ソース構成に以下の情報が含まれていないことを確認してください。
    • IPset
    • デバイスプロファイル
    • プロトコル
    • ポート
  6. アプリケーション構成を移行または複製する先の Target NetScaler Instance を指定します。
    アプリケーション構成をAutoscaleグループに移行するには、リストからAutoscaleグループを選択します。
  7. アプリケーションの定義 で、,
    1. 「アプリケーション名」で、アプリケーションの名前を指定します。
      ターゲットインスタンスがAutoscaleグループである場合は、次のAutoscaleパラメータを指定します。
      • 「アクセスタイプ」 - NetScaler Consoleのオートスケーリングソリューションは、外部アプリケーションと内部アプリケーションの両方に使用できます。必要なアプリケーションアクセスタイプを選択します。
      • 「ドメイン名」 - アプリケーションのドメイン名を指定します。このオプションは、ユーザー定義FQDNタイプを選択した場合にのみ適用されます。
      • 「ドメインのゾーン」 - リストからアプリケーションのゾーン名を選択します。このオプションは、ユーザー定義FQDNタイプを選択した場合にのみ適用されます。
        このドメイン名とゾーン名は、Azureの仮想サーバーにリダイレクトされます。たとえば、app.example.comでアプリケーションをホストしている場合、appがドメイン名で、example.comがゾーン名です。
    2. 移行する仮想サーバーを選択します。
    3. 「次へ」をクリックします。
  8. 「同等のCLIコマンド」で、コマンドを確認し、「次へ」をクリックします。
    これらのコマンドは、選択したアプリケーション構成に固有のものです。
    「注:」:
    必要に応じて、構成を追加または編集することもできます。
  9. 「展開属性」で、仮想サーバー、サービス、およびサービスグループメンバーのIPアドレスとポートを表示および編集できます。
    IPアドレスとポートを編集するには、フロー図の仮想サーバー、サービス、またはサービスグループメンバーの編集アイコンをクリックします。
    展開属性を編集する(/en-us/netscaler-console-service/media/edit-deployment-attributes.png)
    注:
    ターゲットインスタンスがAutoscaleグループの場合、フロントエンドIPアドレスの編集は無効になります。
    このタブは、次の場合にのみ表示されます。
    • ソースインスタンスとターゲットインスタンスが異なる場合。
    • CLIコマンドを使用して構成をインポートする場合。
  10. 構成属性で、必要な詳細を指定し、次へをクリックします。
    このタブには、パスワードと証明書を復号化するためのキーなどのシークレットが一覧表示されます。
    注:
    移行を開始する前に、見つからない構成またはサポートされていない構成が次のいずれかのタブに表示されます。
    • サポートされていない構成
    • サポートされていないグローバル構成
    これらの構成を正常に移行するには、ターゲットインスタンスで、見つからない構成またはサポートされていない構成を個別に適用する必要があります。そして、次へをクリックします。
  11. 移行で、移行をクリックします。

制限事項

  • ソースインスタンスで言及されている名前付き式とresponderhtmlpagesは識別されません。移行前に、ターゲットインスタンスで名前付き式とresponderhtmlpagesを構成してください。
  • ソースにservicegroupとモニターバインディングが次のように設定されている場合:
    bind serviceGroup <Name> <Port> -monitorName <Monitor_Name>
    次のエラーが表示されます:
    CLI Command conversion failed: 100 - No such command [{ "errorcode": 1090, "message": "No such argument [XXX]", "severity": "ERROR" }]
    このエラーは、NetScaler がサービスグループとモニター間のバインディングを無効な形式で保存するため発生します。この問題は、NetScaler 12.1.52.15 ビルド以降で修正されています。