Application Delivery Management

Crear un StyleBook para cargar archivos a NetScaler ADM

Los StyleBooks de NetScaler Application Delivery Management (NetScaler ADM) le permiten crear configuraciones de NetScaler que pueden incluir, entre otras cosas, cargar archivos de cualquier tipo desde el sistema de archivos local a la instancia de NetScaler, mediante la GUI de NetScaler ADM 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:

Crea tu 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 ADM
 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 ADM y utilizarlo para cargar archivos de geolocalización.

Este StyleBook requiere que el archivo ya esté presente en NetScaler ADM (por ejemplo, ya lo habría copiado en NetScaler ADM mediante una utilidad como scp). Si desea cargar un archivo a NetScalers a través de NetScaler ADM sin copiarlo primero en el sistema de archivos ADM de NetScaler, 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 utilizar estos dos parámetros en los componentes de compilación de archivos de carga. 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 ADM, vaya a Aplicaciones > Configuracióny haga clic en Crear nuevo. La página Choose StyleBook muestra todos los StyleBooks que están disponibles en su NetScaler ADM. 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 ADM el archivo esté ubicado únicamente en la carpeta del arrendatario actual. Utilice cualquier protocolo de transferencia de archivos para copiar el archivo al sistema de archivos ADM de NetScaler.

  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 que seleccioneEjecutar en secopara comprobar los objetos de configuración que se crean 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 agregar instancias de NetScaler detectadas recientemente en NetScaler ADM a la lista de instancias disponibles en esta ventana.

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

También puede utilizar la API de NetScaler ADM para crear un paquete de configuración que cargue archivos en la instancia de NetScaler seleccionada. Para obtener más información sobre cómo usar las API, consulteCómo usar la API para crear configuraciones para cargar cualquier tipo de archivo.

Crear un StyleBook para cargar archivos a NetScaler ADM