StyleBooks Configuration Builder を使用したNetScalerアプリケーション構成の移行
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™グループの場合、構成パックはネットワーク > AutoScaleグループページに表示されます。構成タブの下です。
-
CLIコマンドのセット:
ns.confまたはApplication configから構成を貼り付けます。
Configuration Builder は、ソース構成に埋め込まれた個別のアプリケーションのリストを識別します。関心のあるアプリケーション構成を選択すると、Configuration Builder は選択したアプリケーションのCLIコマンドのセットを抽出します。これらのCLIコマンドはソース構成から抽出されます。また、入力が必要となる可能性のある展開属性と構成属性も識別します。
-
IPアドレス/ポート - 仮想サーバー、サービス、サービスグループメンバーのIPアドレスとポートを元の構成から表示および編集できます。
-
構成ファイル/シークレット - これらの属性は、ソース構成で指定されたパスワードまたは証明書である場合があります。
必要な情報を指定したら、ターゲットNetScalerインスタンスでアプリケーション構成の移行または複製を開始します。
アプリケーションの作成と移行後、
adc_nitro_application StyleBook を使用してNetScaler Consoleに構成パックが作成されます。このStyleBookはNetScaler NITROリソースに基づいて作成されます。この構成パックは、ターゲットNetScalerインスタンス上のアプリケーション構成を表します。作成された構成パックを表示するには、アプリケーション > 構成 > 構成パックに移動します。
Related information
移行された構成間での構成エンティティの共有
Config Migrationユーティリティを使用して構成を移行する際に、構成エンティティを再利用できます。その後の移行では、既存の構成エンティティが正常に再利用されます。以前は、一部の構成エンティティを共有する2つの構成を移行する際に、「リソースはすでに存在します」というエラーで構成の移行が失敗していました。このオプションは、複数の構成で構成エンティティが使用されるシナリオで、構成エンティティの再利用を許可することで、移行ワークフローを効率化します。
サポートされているNetScaler機能
StyleBook構成ビルダーは、ソース構成で次のNetScaler機能を認識し、サポートします。
-
コンテンツスイッチング
-
ロードバランシング
-
モニタリング
-
SSLオフロード
-
レート制限
-
リライト
-
レスポンダー
-
Webアプリケーションファイアウォール (WAF)
-
ボット管理
-
圧縮制御
NetScalerアプリケーション構成を移行するためのStyleBookを作成する
NetScaler ConsoleでNetScalerアプリケーションの移行を移管するStyleBookを作成する手順は次のとおりです。
-
「アプリケーション > 構成 > 構成パック」に移動します。
-
「NetScaler構成の移行」をクリックします。
-
「開始」をクリックします。
-
「構成の指定」で、構成ソースを選択します。
-
「NetScalerからインポート」: このオプションは、選択したNetScalerインスタンス上のアクティブなアプリケーションを検出します。
-
「CLIコマンドを使用してインポート」: このオプションは、CLIコマンドを分析し、CLIコマンドからアプリケーションを抽出します。
-
-
アプリケーション構成を移行または複製するソースNetScalerインスタンスを指定します。アプリケーション構成をオートスケールグループに移行するには、ソース構成に以下の情報が含まれていないことを確認してください。
-
IPset -
デバイスプロファイル
-
プロトコル
-
ポート
-
-
アプリケーション構成を移行または複製するターゲットNetScalerインスタンスを指定します。アプリケーション構成をオートスケールグループに移行するには、リストからオートスケールグループを選択します。
-
「アプリケーションの定義」で、,
-
「アプリケーション名」に、アプリケーションの名前を指定します。ターゲットインスタンスがAutoscaleグループである場合は、次のAutoscaleパラメータを指定します。
-
アクセスタイプ - NetScaler Consoleの自動スケーリングソリューションは、外部アプリケーションと内部アプリケーションの両方に使用できます。必要なアプリケーションアクセスタイプを選択します。
-
ドメイン名 - アプリケーションのドメイン名を指定します。このオプションは、ユーザー定義FQDNタイプを選択した場合にのみ適用されます。
-
ドメインのゾーン - リストからアプリケーションのゾーン名を選択します。このオプションは、ユーザー定義FQDNタイプを選択した場合にのみ適用されます。このドメイン名とゾーン名は、Azureの仮想サーバーにリダイレクトされます。たとえば、
app.example.comでアプリケーションをホストしている場合、appがドメイン名で、example.comがゾーン名です。
-
-
移行する仮想サーバーを選択します。
-
次へをクリックします。
-
-
「同等のCLIコマンド」で、コマンドを確認し、次へをクリックします。これらのコマンドは、選択したアプリケーション構成に固有のものです。注：必要に応じて、構成を追加または編集することもできます。
-
「展開属性」では、仮想サーバー、サービス、およびサービスグループメンバーのIPアドレスとポートを表示および編集できます。IPアドレスとポートを編集するには、フロー図の仮想サーバー、サービス、またはサービスグループメンバーの編集アイコンをクリックします。
注記:ターゲットインスタンスがAutoscaleグループの場合、フロントエンドIPアドレスの編集は無効になります。このタブは、次の場合にのみ表示されます。-
ソースインスタンスとターゲットインスタンスが異なる場合。
-
CLIコマンドを使用して構成をインポートします。
-
-
構成属性で、必要な詳細を指定し、次へをクリックします。このタブには、パスワードと証明書を復号化するためのキーなどのシークレットが一覧表示されます。注記:移行を開始する前に、見つからない構成またはサポートされていない構成が次のいずれかのタブに表示されます。
-
サポートされていない構成
-
サポートされていないグローバル構成
これらの構成を正常に移行するには、見つからない構成またはサポートされていない構成をターゲットインスタンスに個別に適用する必要があります。そして、次へをクリックします。 -
-
移行で、移行をクリックします。
制限事項
-
ソースインスタンスで言及されている名前付き式と
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 ビルド以降で修正されています。