Configuración de StyleBook

Crea un StyleBook para subir archivos

Los StyleBooks de NetScaler Console le permiten crear configuraciones de NetScaler que pueden incluir, entre otras cosas, la carga de archivos de cualquier tipo desde su sistema de archivos local a la instancia de NetScaler, mediante la GUI de NetScaler Console o las API. Estos archivos pueden ser los archivos de certificado o los archivos de geolocalización de ejemplo. También puede especificar el directorio para cargar estos archivos.

Configuración de StyleBook

El siguiente es un ejemplo de StyleBook que describe cómo cargar un archivo de geolocalización en la instancia de NetScaler. Los archivos geográficos se utilizan normalmente en configuraciones GSLB para definir la proximidad estática en función de la ubicación geográfica:

Construye su StyleBook: 1

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 system file path of the geolocation file on NetScaler Console
 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)
<!--NeedCopy-->

Nota

El parámetro utilizado en este ejemplo es de un archivo de tipo. Puede importar este StyleBook en NetScaler Console y usarlo para cargar archivos de geolocalización.

Este StyleBook requiere que el archivo ya esté presente en NetScaler Console (por ejemplo, ya lo habría copiado en NetScaler Console con una utilidad como SCP). Si desea cargar un archivo a NetScaler a través de NetScaler Console sin copiarlo primero en el sistema de archivos de NetScaler Console, puede crear un StyleBook que tenga dos parámetros de «cadena»: uno para especificar el nombre del archivo que se utilizará en NetScaler y el otro para especificar el contenido del archivo, y usar estos dos parámetros en los componentes upload-file-comp. El siguiente es un StyleBook alternativo para cargar un archivo de geolocalización:

Construye su StyleBook: 2

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)
<!--NeedCopy-->

Crear configuraciones para subir archivos

El siguiente procedimiento crea una configuración en una instancia de NetScaler seleccionada que cargaría un archivo de geolocalización mediante el primer StyleBook descrito anteriormente.

Para crear una configuración para cargar archivos:

  1. En NetScaler Console, vaya a AplicacionesConfiguracióny haga clic enCrear nuevo. La página Elegir un StyleBook muestra todos los StyleBooks que están disponibles en la consola de NetScaler. Desplázate hacia abajo y selecciona el StyleBook que has importado.

    Los parámetros de StyleBook aparecen como una página de interfaz de usuario que permite introducir los valores de todos los parámetros definidos en este StyleBook.

  2. Introduzca el nombre del equilibrador de carga y la dirección IP virtual en la sección de configuración básica del equilibrador de cargas.

  3. En la sección Archivo de ubicación, introduzca el nombre o la ubicación del archivo.

    Nota

    Asegúrese de que, en NetScaler Console, el archivo se encuentre únicamente en la carpeta del inquilino actual. Utilice cualquier FTP para copiar el archivo al sistema de archivos de NetScaler Console.

  4. Es posible que se le pida que proporcione sus credenciales de usuario antes de acceder a las instancias de destino.

  5. Seleccione la instancia de NetScaler de destino en la que se debe crear la configuración y haga clic en Crear.

Nota

Citrix recomienda seleccionar Dry Run para comprobar los objetos de configuración creados en la instancia de destino antes de ejecutar la configuración real en la instancia.

Cuando la creación del paquete de configuración se realiza correctamente, el archivo se guarda en el sistema de archivos de instancia de NetScaler bajo la ubicación: /var/netscaler/inbuilt_db/

Nota

También puede hacer clic en el icono de actualización para añadir las instancias de NetScaler descubiertas recientemente en NetScaler Console a la lista de instancias disponibles en esta ventana.

Uso de la API de la consola de NetScaler para crear un paquete de configuración

También puede usar la API de la consola de NetScaler para crear un paquete de configuración que suba los archivos a la instancia de NetScaler seleccionada. Para obtener más información sobre cómo usar las API, consulte Cómo usar la API para crear configuraciones para cargar cualquier tipo de archivo .

Crea un StyleBook para subir archivos