StyleBook の最初の6行はヘッダーセクションで構成されます。このセクションでは、StyleBook の ID を定義し、その機能について説明できます。これは必須セクションです。
次の表は、ヘッダーセクションの属性について説明しています。
| 属性 |
説明 |
| name |
StyleBook を識別するための名前。この属性は必須です。 |
| display-name |
StyleBook の説明的な名前。この名前は NetScaler ADM GUI に表示されます。これはオプションの属性です。 |
| description |
この StyleBook の機能について定義する説明テキスト。この説明は ADM GUI に表示されます。これはオプションの属性です。注: これは HTML フラグメントであり、HTML タグを使用して見出しをカスタマイズしたり、URL または埋め込み画像を含む <img> タグを使用して画像を挿入したりできます。 |
| author |
StyleBook を作成する作成者または組織。これはオプションの属性です。 |
| namespace |
名前空間は、名前の衝突を避けるために StyleBook の一意の識別子の一部を形成します。名前空間は任意の文字列にできますが、StyleBook のセットを作成または所有する会社、部署、または部門の名前付けに使用するのが良い慣行です。たとえば、<company>.<department>.<unit>.stylebooks の形式を使用できます。これは必須属性です。 |
| version |
StyleBook のバージョン番号。StyleBook を更新する際にバージョン番号を変更できます。異なるバージョンの StyleBook は共存できます。これは必須属性です。 |
| schema-version |
StyleBook スキーマのバージョン。NetScaler ADM の現在のリリースでは「1.0」の値を取ります。これは必須属性です。 |
| private |
この属性が true に設定されている場合、StyleBook は NetScaler ADM GUI に表示されません。これは、他の StyleBook の構成要素であり、ユーザーが直接使用することを意図していない StyleBook にとって便利な設定です。これはオプションの属性です。デフォルト値は false です。 |
例:
name: lb
description: "This stylebook defines a sample load balancing configuration."
display-name: "Load Balancing StyleBook (HTTP)"
author: Mike Smith (ACME Infra team)
namespace: com.example.stylebooks
schema-version: "1.0"
version: "0.1"
name、namespace、および version の組み合わせは、システム内で StyleBook を一意に識別します。NetScaler® ADM では、name、namespace、および version の組み合わせが同じ2つの StyleBook を持つことはできません。ただし、name と version が同じで namespace が異なる StyleBook や、namespace と version が同じで name が異なる StyleBook を持つことはできます。