StyleBooks Configuration Builder を使用した NetScaler アプリケーション構成の移行
StyleBooks Configuration Builder は、既存の NetScaler 構成を StyleBooks に移行するために使用されます。この機能は、アプリケーション構成をある NetScaler インスタンスから別のインスタンス、またはオートスケールグループに移行する作業も自動化します。
Configuration Builder は、NetScaler 構成のあらゆるバリアントに使用できる構造化されたアプリケーション StyleBook を提供します。この機能は、StyleBooks の文法や構成要素に関する深い知識がなくても、StyleBooks の使用を開始するのに役立ちます。そうでない場合、StyleBook を作成するには StyleBooks の文法と構成要素の知識が必要です。
Configuration Builder は、新しい NetScaler インスタンスで同じ NetScaler 構成を反映する構成パックも作成します。この構成パックを使用すると、ある NetScaler インスタンスの初期 NetScaler 構成を別の NetScaler インスタンスに複製できます。初期構成ソースは次のいずれかです。
-
NetScaler インスタンス: 複製するアプリケーション構成がホストされているインスタンスを指定します。
ターゲットインスタンスを指定しない場合でも、Configuration Builder は NetScaler 構成を StyleBook および構成パックに変換します。この構成パックは、後で NetScaler 構成を他の NetScaler インスタンスに移行するために使用できます。
ターゲットインスタンスがオートスケールグループの場合、構成パックは [Network] > [AutoScale Group] ページに表示されます。[Configuration] タブの下にあります。
-
CLI コマンドのセット:
ns.confまたはApplication configから構成を貼り付けます。
Configuration Builder は、ソース構成に埋め込まれている個別のアプリケーションのリストを識別します。関心のあるアプリケーション構成を選択すると、Configuration Builder は選択したアプリケーションの CLI コマンドのセットを抽出します。これらの CLI コマンドはソース構成から抽出されます。また、入力が必要になる可能性のある展開属性と構成属性も識別します。
-
IP アドレス/ポート - 元の構成から、仮想サーバー、サービス、サービスグループメンバーの IP アドレスとポートを表示および編集できます。
-
構成ファイル/シークレット - これらの属性は、ソース構成で指定されたパスワードまたは証明書です。
必要な情報を指定したら、ターゲット NetScaler インスタンスでアプリケーション構成の移行または複製を開始します。
アプリケーションの作成と移行後、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 を作成する手順は次のとおりです。
-
[Applications] > [Configuration] > [Confg Packs] に移動します。
-
[Migrate NetScaler Configuration] をクリックします。
-
[Get Started] をクリックします。
-
[Specify Configuration] で、構成ソースを選択します。
-
NetScaler からインポート: このオプションは、選択した NetScaler インスタンス上のアクティブなアプリケーションを検出します。
-
CLI コマンドを使用してインポート: このオプションは、CLI コマンドを分析し、CLI コマンドからアプリケーションを抽出します。
-
-
アプリケーション構成を移行または複製する元の [Source NetScaler Instance] を指定します。
アプリケーション構成をオートスケールグループに移行するには、ソース構成に次の情報が含まれていないことを確認してください。
IPset- デバイスプロファイル
- プロトコル
- ポート
-
アプリケーション構成を移行または複製する先の [Target NetScaler Instance] を指定します。
アプリケーション構成をオートスケールグループに移行するには、リストからオートスケールグループを選択します。
-
[Define Application] で、
-
[Application Name] で、アプリケーションの名前を指定します。
ターゲットインスタンスがオートスケールグループの場合、次のオートスケールパラメーターを指定します。
-
アクセスタイプ - NetScaler Console のオートスケーリングソリューションを外部アプリケーションと内部アプリケーションの両方に使用できます。必要なアプリケーションアクセスタイプを選択します。
-
ドメイン名 - アプリケーションのドメイン名を指定します。このオプションは、ユーザー定義の FQDN タイプを選択した場合にのみ適用されます。
-
ドメインのゾーン - リストからアプリケーションのゾーン名を選択します。このオプションは、ユーザー定義の FQDN タイプを選択した場合にのみ適用されます。
このドメインとゾーン名は、Azure の仮想サーバーにリダイレクトされます。たとえば、
app.example.comでアプリケーションをホストしている場合、appがドメイン名で、example.comがゾーン名です。
-
-
移行する仮想サーバーを選択します。
-
[Next] をクリックします。
-
-
[Equivalent CLI Commands] で、コマンドを確認し、[Next] をクリックします。
これらのコマンドは、選択したアプリケーション構成に固有のものです。
注:
必要に応じて、構成を追加または編集することもできます。
-
[Deployment Attributes] で、仮想サーバー、サービス、サービスグループメンバーの IP アドレスとポートを表示および編集できます。
IP アドレスとポートを編集するには、フロー図の仮想サーバー、サービス、またはサービスグループメンバーの編集アイコンをクリックします。
注:
ターゲットインスタンスがオートスケールグループの場合、フロントエンド IP アドレスの編集は無効になります。
このタブは、次の場合にのみ表示されます。
-
ソースインスタンスとターゲットインスタンスが異なる場合。
-
CLI コマンドを使用して構成をインポートする場合。
-
-
[Configuration Attributes] で、必要な詳細を指定し、[Next] をクリックします。
このタブには、パスワードと証明書を復号化するためのキーなどのシークレットが一覧表示されます。
注:
移行を開始する前に、次のいずれかのタブに、見つからない構成またはサポートされていない構成が表示されます。
-
サポートされていない構成
-
サポートされていないグローバル構成
これらの構成を正常に移行するには、見つからない構成またはサポートされていない構成をターゲットインスタンスに個別に適用する必要があります。次に、[Next] をクリックします。
-
-
[Migrate] で、[Migrate] をクリックします。
制限事項
-
ソースインスタンスで言及されている名前付き式と
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" }] <!--NeedCopy-->このエラーは、NetScaler がサービスグループとモニター間のバインディングを無効な形式で保存するために発生します。この問題は、NetScaler 12.1.52.15 ビルド以降で修正されています。