Product Documentation

NetScaler MAS에 파일을 업로드하기 위한 StyleBook을 만드는 방법

Jul 18, 2017

NetScaler MAS StyleBook을 사용하여 NetScaler 구성을 만들 수 있습니다. 여기에는 NetScaler MAS GUI 또는 API를 사용하여 로컬 파일 시스템에서 모든 형식의 파일을 NetScaler 인스턴스에 업로드하는 구성이 포함될 수 있습니다.

StyleBook 구성

아래에 제공된 예제 StyleBook은 NetScaler 인스턴스에 지리적 위치 파일을 업로드하는 방법을 설명합니다. 지리 파일은 주로 GSLB 구성에서 지리적 위치에 기반한 정적 근접성을 정의할 때 사용됩니다.

name: upload-geolocations
namespace: com.citrix.adc.stylebooks.samples
version: "1.0"
display-name: GeoLocation File Upload
description: |
    This StyleBook is used to upload a geolocation file to NetScaler
schema-version: "1.0"

import-stylebooks:
 -
   namespace: netscaler.nitro.config
   version: "11.1"
   prefix: ns

parameters:

 -
   name: locationfile
   label: Location File
   description: The systemfile path of the geolocation file on MAS
   type: file
   required: true


components:

 -
   name: upload-file-comp
   type: ns::systemfile
   properties:
      filename: $parameters.locationfile.filename
      filelocation: "/var/netscaler/inbuilt_db/"
      filecontent: base64.encode($parameters.locationfile.contents)

이 예제에 사용된 매개 변수 유형은 파일입니다. 이 StyleBook을 NetScaler MAS로 가져와 지리적 위치 파일을 업로드할 때 사용할 수 있습니다.

이 StyleBook을 사용하려면 해당 파일이 NetScaler MAS에 있어야 합니다(예: scp 같은 유틸리티를 사용하여 NetScaler MAS에 파일을 미리 복사해야 함).
NetScaler MAS 파일 시스템에 복사하지 않고 NetScaler MAS를 통해 NetScaler에 파일을 업로드하려면 “string” 매개 변수가 2개인 StyleBook을 작성합니다. 하나는 NetScaler에서 사용할 파일 이름을 지정하고 다른 하나는 파일의 콘텐츠를 지정합니다. 이 매개 변수 2개를 upload-file-comp 구성 요소에 사용합니다. 이 대체 StyleBook이 아래에 나와 있습니다.

name: upload-geolocations-alt
namespace: com.citrix.adc.stylebooks.samples
version: “1.0”
display-name: GeoLocation File Upload
description: |
This StyleBook is used to upload a geolocation file to NetScaler
schema-version: “1.0”

import-stylebooks:
 -
   namespace: netscaler.nitro.config
   version: “11.1”
   prefix: ns

parameters:
 -
   name: filename
   label: Location Filename
   description: The name of the location file on the NetScaler
   type: string
   required: true
 -
   name: filecontents
   label: Location File Contents
   description: The contents of the location file
   type: string
   required: true

components:
 -
   name: upload-file-comp
   type: ns::systemfile
   properties:
       filename: $parameters.filename
       filelocation: “/var/netscaler/inbuilt_db/”
       filecontent: base64.encode($parameters.filecontents)

NetScaler MAS 사용자 인터페이스에서 파일 업로드를 위한 구성 만들기

다음 절차는 위에 설명된 첫 번째 StyleBook을 사용하여 지리적 위치 파일을 업로드하는 구성을 선택한 NetScaler 인스턴스에 만듭니다.    

파일 업로드를 위한 구성을 만들려면

       1. NetScaler MAS에서 Applications(응용 프로그램) > Configuration(구성)으로 이동하고 Create New(새로 만들기)를 클릭합니다. Choose StyleBook(StyleBook 선택) 페이지에 NetScaler MAS에서 사용할 수 있는 모든 StyleBook이 표시됩니다. 아래로 스크롤하고 가져온 StyleBook을 선택합니다.

          StyleBook 매개 변수는 이 StyleBook에 정의되어 있는 모든 매개 변수의 값을 입력할 수 있도록 사용자 인터페이스로 표시됩니다.

       2.  기본 부하 분산 장치 설정 섹션에서 부하 분산 장치의 이름과 가상 IP 주소를 입력합니다.

       3.  Location File(위치 파일) 섹션에서 파일의 이름 또는 위치를 입력합니다.

 참고: NetScaler MAS에서 파일은 현재 테넌트의 폴더에만 위치해야 합니다. 파일 전송 프로토콜을 사용하여 NetScaler MAS 파일 시스템에 파일을 복사하십시오. 

       4.  대상 인스턴스에 액세스하기 전에 사용자 자격 증명을 입력해야 할 수 있습니다.

       5. 구성을 만들어야 하는 대상 NetScaler 인스턴스를 선택하고 Create(만들기)를 클릭합니다.     

참고: 인스턴스에서 실제 구성을 실행하기 전에 Dry Run(가상 동작 확인)을 선택하여 대상 인스턴스에 만들어지는 구성 개체를 확인하는 것이 좋습니다.  

구성 팩이 성공적으로 만들어지면 NetScaler 인스턴스 파일 시스템의 /var/netscaler/inbuilt_db/에 파일이 저장됩니다.

NetScaler MAS API를 사용하여 구성 팩 만들기

선택한 NetScaler 인스턴스에 파일을 업로드하는 구성 팩을 NetScaler MAS API를 사용하여 만들 수도 있습니다. API 사용 방법에 대한 자세한 내용은 API를 사용하여 모든 형식의 파일 업로드를 위한 구성을 만드는 방법을 참조하십시오.