Product Documentation

구성 요소

Dec 06, 2016

StyleBook의 Components 구조는 StyleBook에서 가장 중요한 섹션이라고 할 수 있습니다. 이 섹션에서는 만들어야 하는 구성 개체를 정의합니다. 이 구조를 사용하면 동일한 유형의 구성 개체를 하나 이상 작성할 수 있습니다.

components 구조는 parameters 섹션에 제공된 입력을 사용하여 StyleBook이 생성한 구성을 적용합니다. 대부분의 StyleBooks에 components 섹션이 있지만 이 섹션은 선택적입니다.

다음 표에서는 구성 요소의 주요 특성에 대해 설명합니다.

특성 설명
name 구성 요소의 이름입니다. 영숫자 이름을 지정할 수 있습니다. 이름은 알파벳으로 시작해야 하며 추가로 알파벳, 숫자, 하이픈(-) 또는 밑줄(_)을 포함할 수 있습니다.
description StyleBook에서 이 구성 요소의 역할에 대한 설명입니다.
type 이 구성 요소가 제공하는 속성을 결정하는 유형입니다. 구성 요소에는 두 종류의 유형이 있습니다.
  • Built-in type(기본 제공 유형): 이 유형은 시스템을 통해 제공되므로 정의할 필요가 없습니다. 예를 들어 NITRO 엔터티 유형은 "lbvserver" 또는 "servicegroup"입니다.

    구성 요소에 기본 제공 유형의 특성이 있으면 해당 유형의 구성 개체가 NetScaler에 만들어집니다. 예를 들어 구성 요소가 기본 제공 유형 “lbvserver”를 참조하는 경우 이 구성 요소는 구성의 대상인 NetScaler 인스턴스에서 부하 분산 가상 서버를 만듭니다.
  • Composite type(복합 유형): 이 유형은 사용자가 만들어 NetScaler MAS로 가져오는 기존 StyleBook을 나타냅니다.

    구성 요소에 복합 유형 특성이 있으면 구성 대상인 NetScaler 인스턴스에서 참조된 StyleBook에 지정된 모든 구성 개체가 만들어집니다. 이 유형을 사용하면 각 StyleBook이 최종 구성의 일부를 이루는 여러 StyleBook을 조합할 수 있습니다.

    복합 StyleBook에 대한 자세한 내용은 복합 StyleBook 만들기를 참조하십시오.
properties 구성 요소 유형 특성에 사용할 수 있는 하위 특성입니다.

구성 요소에 유효한 properties 특성은 구성 요소 유형에 따라 다릅니다. 기본 제공 유형의 경우 해당 Nitro 개체의 속성 또는 특성입니다. 유형이 다른 StyleBook인 구성 요소 즉, 복합 유형 구성 요소의 경우 properties는 해당 StyleBook에 정의된 매개 변수와 일치합니다. 


예제
:

components:

   -

     name: my-lbvserver-comp

     type: ns::lbvserver

     properties:

           name: $parameters.name

           servicetype: HTTP

           ipv46: $parameters.ip

           port: 80

           lbmethod: $parameters.lb-alg

이 예에는 my-lbvserver-comp라고 하는 구성 요소가 정의되어 있습니다. 이 구성 요소의 유형은 ns::lbvserver(기본 제공 유형)이며 여기서 "ns"는 import-stylebooks 섹션에서 정의한 netscaler.nitro.config 네임스페이스 및 10.5 버전을 나타내는 접두사이고 "lbvserver"는 이 네임스페이스의 NITRO 리소스입니다.

이 섹션의 속성에는 "lbvserver" 리소스의 필수 특성 네 개와 선택적 특성 하나(lbmethod)가 포함되며 이러한 특성에 대한 값을 지정할 수 있습니다. 이 예에서는 servicetype 및 port에 대해 정적 값을 지정하고 이름인 ipv46과 lbmethod 속성은 입력 매개 변수의 값을 사용합니다. parameter 섹션에 정의된 매개 변수 이름을 참조할 때는 $parameters. 표기법(예: $parameters.ip)을 사용합니다.

사용 가능한 모든 NetScaler NITRO 리소스 및 해당하는 특성/속성에 대한 자세한 내용은 NetScaler NITRO REST API 설명서를 참조하십시오.

메모

NITRO 리소스 유형의 특성 이름(해당 구성 요소 속성)에 소문자를 사용해야 합니다. 그렇지 않으면 StyleBook 가져오기가 실패합니다.