StyleBooks構成ビルダーを使用したCitrix ADC アプリケーション構成の移行
StyleBooks構成ビルダーは、既存のADC設定をStyleBooksに移行するために使用されます。この機能により、あるCitrix ADCインスタンスから別のインスタンスまたはAutoScaleグループへのアプリケーション構成の移行も自動化されます。
構成ビルダーは、ADC構成の任意のバリアントに使用できる構造化アプリケーションStyleBookを提供します。この機能により、StyleBooks の文法や構造に関する深い知識がなくても、StyleBooks の使用を開始できます。それ以外の場合は、StyleBooksの作成にはStyleBooksの文法と構文の知識が必要です。
また、構成ビルダーは、新しい ADC インスタンス上で同じ ADC 構成を反映する構成パックも作成します。この構成パックを使用すると、あるADCインスタンスの初期ADC設定を別のADCインスタンスに複製できます。初期設定ソースは、次のいずれかになります。
-
NetScaler インスタンス： 複製するアプリケーション構成をホストするインスタンスを指定します。
ターゲット・インスタンスを指定しない場合でも、構成ビルダーは、ADC構成をStyleBookおよび構成パックに変換します。後でこの構成パックを使用して、ADC 設定を他の ADC インスタンスに移行できます。
ターゲットインスタンスがAutoScaleグループの場合、構成パックは [ネットワーク] > [AutoScaleグループ ] ページに表示されます。[ 構成 ] タブの下にあります。
-
CLI コマンドのセット：
ns.confまたはApplication configから設定を貼り付けます。
構成ビルダーは、ソース構成に埋め込まれている個別のアプリケーションのリストを識別します。目的のアプリケーション構成を選択すると、Configuration Builderは選択したアプリケーションのCLIコマンドのセットを抽出します。これらの CLI コマンドは、ソース設定から抽出されます。また、入力を必要とする可能性のあるデプロイメントおよび構成属性も識別します。
-
IPアドレス/ポート ：元の構成から仮想サーバ、サービス、サービスグループメンバーのIPアドレスとポートを表示および編集できます。
-
設定ファイル/シークレット -これらの属性は、ソース構成で指定されたパスワードまたは証明書にすることができます。
必要な情報を指定したら、ターゲットADCインスタンスでアプリケーション構成の移行または複製を開始します。
アプリケーションの作成と移行後、adc_nitro_applicationStyleBookを使用してCitrix ADMに構成パックが作成されます。このStyleBookは、ADCのNITRO リソースに基づいて作成されます。この構成パックは、ターゲットADCインスタンス上のアプリケーション構成を表します。作成した構成パックを表示するには、[ アプリケーション] > [構成] > [構成パック] に移動します。
サポートされているCitrix ADC 機能
StyleBook構成ビルダーは、ソース構成内の以下のCitrix ADC機能を認識してサポートします。
- コンテンツスイッチ
- 負荷分散
- 監視
- SSLオフロード
- レート制限
- 書き換え
- レスポンダー
- Web アプリケーションファイアウォール (WAF)
- ボットの管理
- 圧縮制御
StyleBookを作成してCitrix ADCアプリケーション構成を移行する
以下の手順は、NetScaler ADM でCitrix ADCアプリケーションの移行を移行するStyleBookを作成することです。
-
[ アプリケーション] > [構成] > [構成パック] に移動します。
-
「 ADC 構成を移行」をクリックします。
-
[ 始める] をクリックします。
-
「 構成を指定」で、構成ソースを選択します。
-
ADCからインポート:このオプションは、選択したADCインスタンス上のアクティブなアプリケーションを検出します。
-
CLIコマンドを使用してインポート:このオプションはCLIコマンドを分析し、CLIコマンドからアプリケーションを抽出します。
-
-
アプリケーション構成の移行 元または複製元の ADC インスタンスを 指定します。
アプリケーション構成を Autocale グループに移行するには、次の情報がソース構成に含まれていないことを確認します。
IPset- デバイスプロファイル
- Protocol
- ポート
-
アプリケーション構成の移行先または複製先となる ターゲットADCインスタンスを 指定します。
アプリケーション構成を Autocale グループに移行するには、リストからAutoScaleグループを選択します。
-
「 アプリケーションの定義」で、
-
「 アプリケーション名」で、アプリケーションの名前を指定します。
ターゲットインスタンスがAutoScaleグループの場合は、次のAutoScaleパラメータを指定します。
-
アクセスタイプ -NetScaler ADM 自動スケーリングソリューションは、外部アプリケーションと内部アプリケーションの両方に使用できます。必要なアプリケーションアクセスタイプを選択します。
-
ドメイン名 -アプリケーションのドメイン名を指定します。このオプションは、[ユーザー定義 FQDN タイプ] を選択した場合にのみ適用されます。
-
[ ドメインのゾーン ]：リストからアプリケーションのゾーン名を選択します。このオプションは、[ユーザー定義 FQDN タイプ] を選択した場合にのみ適用されます。
このドメイン名とゾーン名は、Azure の仮想サーバーにリダイレクトされます。たとえば、
app.example.comでアプリケーションをホストする場合 、appはドメイン名、example.comはゾーン名です。
-
-
移行する仮想サーバーを選択します。
-
［次へ］ をクリックします。
-
-
「 等価CLIコマンド」でコマンドを確認し、「 次へ」をクリックします。
これらのコマンドは、選択したアプリケーション構成に固有です。
注:
必要に応じて、構成を追加または編集することもできます。
-
展開属性では、仮想サーバー、サービス、およびサービスグループメンバーの IP アドレスとポートを表示および編集できます。
IP アドレスとポートを編集するには、フロー図の仮想サーバ、サービス、またはサービスグループメンバーの編集アイコンをクリックします。
注：
ターゲットインスタンスが Autosale グループの場合、フロントエンド 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" }] <!--NeedCopy-->このエラーは、Citrix ADCがサービスグループとモニターの間のバインディングを無効な形式で保存するために発生します。この問題は、NetScaler 12.1.52.15 ビルドから修正されます。