Servicio Citrix Application Delivery Management

Crear un StyleBook para cargar archivos a Citrix ADM

Los StyleBooks de Citrix Application Delivery Management (Citrix ADM) permiten crear configuraciones de Citrix ADC que pueden incluir, entre otras cosas, al cargar archivos de cualquier tipo desde su sistema de archivos local a la instancia de Citrix ADC, mediante la GUI de Citrix ADM o las API. Estos archivos pueden ser archivos de certificado de ejemplo o archivos de geolocalización. También puede especificar el directorio para cargar estos archivos.

Configuración de StyleBook

A continuación se muestra un ejemplo de StyleBook que describe cómo cargar un archivo de ubicación geográfica en la instancia de Citrix 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:

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

Nota

El parámetro utilizado en este ejemplo es de un archivo de tipo. Puede importar este StyleBook en Citrix 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 Citrix ADC a través de Citrix ADM sin copiarlo primero en el sistema de archivos Citrix 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 Citrix 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 ubicación geográfica:

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)

Creación de configuraciones para cargar archivos

El siguiente procedimiento crea una configuración en una instancia de Citrix 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 Citrix ADM, vaya a Aplicaciones > Configuración y haga clic en Crear nuevo. La página Elegir StyleBook muestra todos los StyleBooks disponibles en Citrix ADM. Desplázate hacia abajo y selecciona el StyleBook que importaste.

    Los parámetros de StyleBook aparecen como una página de interfaz de usuario que le 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 carga.

  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 se encuentra solo en la carpeta del arrendatario actual. Utilice cualquier protocolo de transferencia de archivos para copiar el archivo en el 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 Citrix ADC de destino en la que se debe crear la configuración y haga clic en Crear.

Nota

Citrix recomienda que seleccione Ejecutar en seco para 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 instancias de Citrix ADC en 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 Citrix ADM para crear un paquete de configuración

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

Crear un StyleBook para cargar archivos a Citrix ADM