Application Delivery Management

Crear un StyleBook para cargar archivos a NetScaler ADM

Los StyleBooks de Citrix Application Delivery Management (Citrix ADM) permiten crear configuraciones de Citrix ADC que pueden incluir, entre otras cosas, la carga de archivos de cualquier tipo desde el sistema de archivos local a la instancia de Citrix ADC, mediante la GUI de Citrix 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 ADC. 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 Citrix ADC
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 Citrix 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 Citrix ADM (por ejemplo, ya lo habría copiado en Citrix ADM mediante una utilidad como scp). Si quiere cargar un archivo en NetScaler ADC a través de NetScaler ADM sin copiarlo primero en el sistema de archivos NetScaler ADM, puede crear un StyleBook que tenga dos parámetros de “cadena”, uno es para especificar el nombre de archivo que se va a utilizar en NetScaler ADC y el otro para especificar el contenido de la y utilice 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 Citrix ADC
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 Citrix ADC
  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/Citrix ADC/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 ADC 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 Citrix ADM el archivo esté ubicado únicamente en la carpeta del inquilino actual. Utilice cualquier protocolo de transferencia de archivos para copiar el archivo al sistema de archivos Citrix ADM.

  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 ADC 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 ADC bajo la ubicación: /var/netscaler/inbuilt_db/

Nota

También puede hacer clic en el icono de actualización para agregar instancias de Citrix ADC detectadas recientemente en Citrix 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 ADC 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