Product Documentation

개인 StyleBook을 검색하는 방법

Nov 14, 2017

NetScaler MAS GUI에 표시되지 않아야 하는 Citrix StyleBook을 개인 StyleBook으로 표시할 수 있습니다. 직접 사용되지 않지만 다른 StyleBook의 기반이 되는 StyleBook 또한 개인 StyleBook으로 표시할 수 있습니다. 아래에 표시된 것과 같이 StyleBook의 헤더 섹션에서 private 특성을 설정할 수 있습니다. 이 특성을 설정하면 StyleBook이 NetScaler MAS GUI에 나열되지 않습니다.

name: basic-lb-config
description: This stylebook defines a simple load balancing configuration.
display-name: Load Balancing Configuration
namespace: com.example.stylebooks
private: true
schema-version: "1.0"
version: "0.1"

NetScaler MAS GUI에 표시되는 공개 StyleBook은 주로 일련의 개인 StyleBook을 사용하여 작성됩니다. 가끔 이러한 개인 StyleBook을 보고 검사하여 이러한 StyleBook이 수행하는 작업과 공개 StyleBook에서 어떻게 사용되는지 파악해야 할 수 있습니다. 나중에 자체 StyleBook을 작성할 때 개인 StyleBook을 사용할 수도 있습니다. 개인 StyleBook은 NetScaler MAS GUI에는 표시되지 않지만 API를 통해 사용할 수 있습니다. 개인 StyleBook을 사용하여 공개 StyleBook과 마찬가지로 구성 팩을 작성할 수 있습니다.

NetScaler MAS의 개인 StyleBook 목록을 검색하고 자체 StyleBook에 사용하려면 StyleBook REST API를 사용합니다.

GET https:///stylebook/nitro/v1/config/stylebooks?filter=private:true

URL 쿼리 텍스트 문자열 “filter=private:true”를 지정합니다.

이 REST API 호출은 NetScaler MAS에서 사용 가능한 모든 개인 StyleBook의 정보(원본 YAML 정의 포함)를 검색합니다.

이 요청의 응답은 아래에 표시된 것과 유사합니다.

 

{

  "stylebooks": [

    {

      "author": null,

      "builtin": "false",

      "builtins": "{}",

      "description": "This StyleBook defines advanced settings for CS or LB Vservers.",

      "display_name": "vserver-advanced-params",

      "filename": "vserver-advanced-params.yaml",

      "hide": null,

      "id": "vserf6db6a7f66b73aa2b660955dbd81e376",

      "imported_by": "",

      "imported_datetime": "2017-07-31 20:16:28.832204",

      "name": "vserver-advanced-params",

      "namespace": "com.citrix.adc.commontypes",

      "pkg_id": "vserf6db6a7f66b73aa2b660955dbd81e376",

      "primary_keys": "[]",

      "private": "true",

      "recompile": "false",

      "schema_version": "1.0",

      "source":

"LS0tIApuYW1lOiB2c2VydmVyLWFkdmFuY2VkLXBhcmFtcwpuYW1lc3BhY2U6IGNvbS5jaXRyaX
guYWRjLmNvbW1vbnR5cGVzCnZlcnNpb246ICIxLjAiCmRlc2NyaXB0aW9uOiAiVGhpcyBTdHlsZ
UJvb2sgZGVmaW5lcyBhZHZhbmNlZCBzZXR0aW5ncyBmb3IgQ1Mgb3IgTEIgVnNlcnZlcnMuIgp
wcml2YXRlOiB0cnVlCnNjaGVtYS12ZXJzaW9uOiAiMS4wIgpwYXJhbWV0ZXJzOiAgICAgIAogICA
gICAtIAogICAgICAgIG5hbWU6IGNsaWVudC10aW1lb3V0CiAgICAgICAgbGFiZWw6ICJMb2FkIEJh
bGFuY2VkIEFwcCBDbGllbnQgVGltZW91dCIKICAgICAgICBkZXNjcmlwdGlvbjogIkNsaWVudCBjb
25uZWN0aW9uIHRpbWVvdXQgYWZ0ZXIgaW5hY3Rpdml0eSBpbiBzZWNvbmRzIgogICAgICAgI
HR5cGU6IG51bWJlcgogICAgICAtIAogICAgICAgIG5hbWU6IHRpbWVvdXQKICAgICAgICBsYWJlbD
ogIkxvYWQgQmFsYW5jZWQgQXBwIFBlcnNpc3RlbmNlIFRpbWVvdXQiCiAgICAgICAgZGVzY3Jp
cHRpb246ICJUaW1lIHBlcmlvZCBmb3Igd2hpY2ggYSBwZXJzaXN0ZW5jZSBzZXNzaW9uIGlzIGluI
GVmZmVjdC4iCiAgICAgICAgdHlwZTogbnVtYmVyCiAgICAgIC0gCiAgICAgICAgbmFtZTogaW5zZ
XJ0LXZzZXJ2ZXItaXBwb3J0CiAgICAgICAgbGFiZWw6ICJMb2FkIEJhbGFuY2VkIEFwcCBIVFRQIG
hlYWRlciIKICAgICAgICBkZXNjcmlwdGlvbjogIkluc2VydCBhbiBIVFRQIGhlYWRlciwgd2hvc2Ugdm
FsdWUgaXMgdGhlIElQIGFkZHJlc3MgYW5kIHBvcnQgbnVtYmVyIG9mIHRoZSB2aXJ0dWFsIHNlc
nZlciwgYmVmb3JlIGZvcndhcmRpbmcgYSByZXF1ZXN0IHRvIHRoZSBzZXJ2ZXIuIgogICAgICAgIH
R5cGU6IHN0cmluZwogICAgICAgIGFsbG93ZWQtdmFsdWVzOiAKICAgICAgICAgIC0gIk9GRiIKIC
AgICAgICAgIC0gVklQQUREUiAgICAgICAgCiAgICAgIC0gCiAgICAgICAgbmFtZTogcmVkaXJlY3Qt
dXJsCiAgICAgICAgbGFiZWw6ICJMb2FkIEJhbGFuY2VkIEFwcCBVUkwgUmVkaXJlY3QiCiAgICAgI
CAgZGVzY3JpcHRpb246ICJVUkwgdG8gd2hpY2ggdG8gcmVkaXJlY3QgdHJhZmZpYyBpZiB0aGU
gdmlydHVhbCBzZXJ2ZXIgYmVjb21lcyB1bmF2YWlsYWJsZS4iCiAgICAgICAgdHlwZTogc3RyaW5n
CiAgICAgIC0gCiAgICAgICAgbmFtZTogc3BpbGxvdmVyLW1ldGhvZAogICAgICAgIGxhYmVsOiAiT
G9hZCBCYWxhbmNlZCBBcHAgVGhyZXNob2xkIFR5cGUiCiAgICAgICAgZGVzY3JpcHRpb246ICJ
UeXBlIG9mIHRocmVzaG9sZCB0aGF0LCB3aGVuIGV4Y2VlZGVkLCB0cmlnZ2VycyBzcGlsbG92Z
XIuIgogICAgICAgIHR5cGU6IHN0cmluZwogICAgICAgIGFsbG93ZWQtdmFsdWVzOiAKICAgICAgI
CAgIC0gTk9ORQogICAgICAgICAgLSBDT05ORUNUSU9OCiAgICAgICAgICAtIERZTkFNSUNDT05
ORUNUSU9OCiAgICAgICAgICAtIEJBTkRXSURUSAogICAgICAgICAgLSBIRUFMVEggIAogICAgICA
tIAogICAgICAgIG5hbWU6IHNwaWxsb3Zlci10aHJlc2hvbGQKICAgICAgICBsYWJlbDogIkxvYWQgQ
mFsYW5jZWQgQXBwIFRocmVzaG9sZCIKICAgICAgICBkZXNjcmlwdGlvbjogIlZhbHVlIG9mIHRo
ZSB0aGVyc2hvbGQsIHdoZW4gZXhjZWVkZWQsIHRyaWdnZXJzIHNwaWxsb3Zlci4iCiAgICAgIC
AgdHlwZTogbnVtYmVyICAgICAgIAogICAgICAtIAogICAgICAgIG5hbWU6IGNvbW1lbnQKICAgICA
gICBsYWJlbDogIkxvYWQgQmFsYW5jZWQgQXBwIENvbW1lbnQiCiAgICAgICAgZGVzY3JpcHRpb
246ICJBbnkgY29tbWVudHMgdGhhdCB5b3UgbWlnaHQgd2FudCB0byBhc3NvY2lhdGUgd2l0aC
B0aGUgdmlydHVhbCBzZXJ2ZXIuIgogICAgICAgIHR5cGU6IHN0cmluZwogICAgICAtCiAgICAgIC
AgbmFtZTogaHR0cC1wcm9maWxlCiAgICAgICAgbGFiZWw6ICJOYW1lIG9mIEhUVFAgUHJvZm
lsZSIKICAgICAgICBkZXNjcmlwdGlvbjogIk5hbWUgb2YgSFRUUCBQcm9maWxlIHRvIHVzZSBmb
3IgdGhpcyBWSVAiCiAgICAgICAgdHlwZTogc3RyaW5nCiAgICAgIC0KICAgICAgICBuYW1lOiBmbH
VzaC1vbi1zdGF0ZS1kb3duCiAgICAgICAgbGFiZWw6ICJDbGVhbnVwIENvbm5lY3Rpb25zIHdoZW
4gZG93biIKICAgICAgICBkZXNjcmlwdGlvbjogIkNsZWFudXAgYWxsIGNvbm5lY3Rpb25zIG9uIHR
oaXMgVklQIHdoZW4gaXQgZ29lcyBkb3duIgogICAgICAgIHR5cGU6IHN0cmluZwogICAgICAgIGR
lZmF1bHQ6IEVOQUJMRUQKICAgICAgICBhbGxvd2VkLXZhbHVlczoKICAgICAgICAgICAgLSBFTk
FCTEVECiAgICAgICAgICAgIC0gRElTQUJMRUQKICAgICAgLQogICAgICAgIG5hbWU6IGF1dGgtcG
FyYW1zCiAgICAgICAgbGFiZWw6ICJBdXRoZW50aWNhdGlvbiBQYXJhbWV0ZXJzIgogICAgICAgI
GRlc2NyaXB0aW9uOiAiUGFyYW1ldGVycyByZWxhdGVkIHRvIGVuYWJsaW5nIGF1dGhlbnRpY2F
0aW9uIG9uIHRoaXMgdmlydHVhbCBJUCIKICAgICAgICB0eXBlOiBvYmplY3QKICAgICAgICBwYX
JhbWV0ZXJzOgogICAgICAgICAgICAtCiAgICAgICAgICAgICAgICBuYW1lOiBhdXRoZW50aWNhdG
lvbgogICAgICAgICAgICAgICAgbGFiZWw6ICJFbmFibGUgQXV0aGVudGljYXRpb24iCiAgICAgICAg
ICAgICAgICBkZXNjcmlwdGlvbjogIkF1dGhlbnRpY2F0ZSB1c2VycyB3aG8gcmVxdWVzdCBhIGNvb
m5lY3Rpb24gdG8gdGhpcyB2aXJ0dWFsIElQIgogICAgICAgICAgICAgICAgdHlwZTogc3RyaW5nCi
AgICAgICAgICAgICAgICBkZWZhdWx0OiAiT0ZGIgogICAgICAgICAgICAgICAgYWxsb3dlZC12YWx
1ZXM6CiAgICAgICAgICAgICAgICAgICAgLSAiT04iCiAgICAgICAgICAgICAgICAgICAgLSAiT0ZGIgo
gICAgICAgICAgICAtCiAgICAgICAgICAgICAgICBuYW1lOiBhdXRoZW50aWNhdGlvbi1ob3N0CiAgI
CAgICAgICAgICAgICBsYWJlbDogIkZRRE4gb2YgQXV0aCBWU2VydmVyIgogICAgICAgICAgICAgI
CAgZGVzY3JpcHRpb246ICJUaGUgQXV0aGVudGljYXRpb24gVlNlcnZlciBGUUROIHRvIHdoaWN
oIHVzZXJzIHRvIHRoaXMgVklQIGFyZSByZWRpcmVjdGVkIHRvIGZvciBhdXRoZW50aWNhdGlvb
iIKICAgICAgICAgICAgICAgIHR5cGU6IHN0cmluZwogICAgICAgICAgICAtIAogICAgICAgICAgICAgI
CAgbmFtZTogYXV0aGVudGljYXRpb24tdnNlcnZlci1uYW1lCiAgICAgICAgICAgICAgICBsYWJlbDog
Ik5hbWUgb2YgQXV0aCBWU2VydmVyIgogICAgICAgICAgICAgICAgdHlwZTogc3RyaW5nCiAgICA
gICAgICAgIC0gCiAgICAgICAgICAgICAgICBuYW1lOiBhdXRoZW50aWNhdGlvbi1odHRwLTQwMQ
ogICAgICAgICAgICAgICAgbGFiZWw6ICJFbmFibGUgSFRUUCA0MDEgQXV0aCIKICAgICAgICAgI
CAgICAgIHR5cGU6IHN0cmluZwogICAgICAgICAgICAgICAgZGVmYXVsdDogIk9GRiIKICAgICAgIC
AgICAgICAgIGFsbG93ZWQtdmFsdWVzOgogICAgICAgICAgICAgICAgICAgIC0gIk9OIgogICAgICA
gICAgICAgICAgICAgIC0gIk9GRiIKICAgICAgLQogICAgICAgICAgbmFtZTogYXBwZmxvdy1sb2cKIC
AgICAgICAgIGxhYmVsOiAiRW5hYmxlIEFwcEZsb3ciCiAgICAgICAgICB0eXBlOiBzdHJpbmcKICAgI
CAgICAgIGRlZmF1bHQ6IEVOQUJMRUQKICAgICAgICAgIGFsbG93ZWQtdmFsdWVzOgogICAgIC
AgICAgICAgIC0gRU5BQkxFRAogICAgICAgICAgICAgIC0gRElTQUJMRUQ=",    

        "system": null,

             "tags": "",

             "tenant_id": null,

             "user_sb": "false",

             "version": "1.0"

    },

   …

  ]

}
 

위의 예에서 처음으로 반환된 개인 StyleBook은 "vserver-advanced-params"입니다. 이 StyleBook의 YAML 콘텐츠는 StyleBook 콘텐츠의 BASE64 인코딩을 포함하는 source 특성의 콘텐츠에서 검색될 수 있습니다.

참고: www.base64decode.org 같은 온라인 도구를 사용하여 source 특성의 콘텐츠를 YAML 텍스트로 디코딩할 수 있습니다. 디코딩되면 “vserver-advanced-params.yaml” 같은 로컬 파일에 출력을 저장합니다.

REST API를 사용하지 않고 다른 방법으로 개인 StyleBook에 액세스할 수도 있습니다.

SSH를 사용하여 NetScaler MAS 서버에 액세스하는 경우 다음 위치에서 제공된 모든 StyleBook(개인 StyleBook 포함)으로 쉽게 이동할 수 있습니다.

/var/mps/stylebooks/definitions

참고: 테넌트별 사용자 지정 StyleBook(모든 사용자 지정 또는 개인 StyleBook 포함)은 다음 위치의 각 테넌트별 디렉터리에 저장됩니다.

/var/mps/tenants//stylebooks/

개인 StyleBook 제거

NetScaler MAS와 함께 제공된 StyleBook의 일부가 아닌 개인 StyleBook은 StyleBook REST API를 사용하여 제거할 수 있습니다. 개인 StyleBook을 제거하려면 다음 API를 사용합니다.

DELETE https:///stylebook/nitro/v1/config/stylebooks///

HTTP 응답 상태 코드 200이 수신되면 개인 StyleBook이 NetScaler MAS에서 성공적으로 제거되었음을 의미합니다.

참고: 다른 StyleBook에서 사용되는 개인 StyleBook은 종속 StyleBook이 중단될 수 있으므로 NetScaler MAS에서 제거할 수 없습니다. 종속 StyleBook을 NetScaler MAS에서 먼저 제거하여 종속성을 중단한 후 개인 StyleBook을 제거해야 합니다. StyleBook을 NetScaler MAS에서 제거하기 전에 로컬 시스템에 저장하는 것이 좋습니다. 이렇게 하면 나중에 필요할 때 다시 가져올 수 있습니다.