Configuración de StyleBook

Utilice fuentes de datos personalizadas

Además de las instancias administradas de NetScaler como fuente de datos , puede definir y usar fuentes de datos personalizadas si los datos de entrada se utilizan repetidamente para crear varias configuraciones. Puede guardar los datos de entrada en NetScaler Console como fuente de datos. Además, puede modificar StyleBooks para que consuma estos datos sin necesidad de que los usuarios de StyleBook proporcionen entradas repetidamente.

Antes de utilizar una fuente de datos personalizada en la definición de StyleBook, haga lo siguiente para definir una fuente de datos personalizada:

  1. Agregue un tipo de fuente de datos.
  2. Agregue una fuente de datos.
  3. Agregue un tipo de colección.
  4. Agregue una colección.

Tras agregar una fuente de datos, puede utilizarla en la definición de StyleBook. Para obtener más información, consulte Uso de fuentes de datos personalizadas en la definición de StyleBook.

Agregar un tipo de fuente de datos

Especifique un tipo de fuente de datos para distinguir la fuente de la que se recuperan los datos.

  1. En Aplicaciones > Configuración > Fuentes de datos.

  2. Seleccione el tipo de fuente de datos.

  3. Especifique el nombre y la descripción del tipo de fuente de datos.

  4. Haga clic en Crear.

Tipo de fuente de datos

En este ejemplo, el tipo de fuente de datos se establece en Entorno. Este tipo se puede utilizar para definir los entornos de la aplicación como fuentes de datos.

Agregar una fuente de datos

Defina una fuente de datos para un tipo de fuente de datos específico.

  1. Vaya a Aplicaciones > Configuración > Fuentes de datos.

  2. Haga clic en Agregar.

  3. Especifique el nombre, el tipo de fuentede datos y la **descripciónde la fuente**de datos.

  4. Haga clic en Crear.

Fuente de datos personalizada

En este ejemplo, se agrega el entorno de producción como fuente de datos.

Agregar un tipo de colección

Agregue un tipo de colección para describir el tipo de datos que se pueden almacenar en una colección.

  1. Vaya a Aplicaciones > Configuración > Fuentes de datos.

  2. Seleccione Tipos de colección.

  3. Haga clic en Agregar.

  4. Especifique el nombre de un tipo de colección.

  5. Seleccione el tipo de fuente de datos.

  6. Agregue el nombre del atributo y su tipo.

  7. Haga clic en Crear.

Tipo de colección

En este ejemplo, el tipo de colección App-Virtual-servers tiene cuatro atributos. Por lo tanto, la colección que quiere almacenar debe tener estos atributos de los tipos de datos establecidos.

Agregar una colección

Agregue las colecciones correspondientes al tipo de colección seleccionado.

  1. Vaya a Aplicaciones > Configuración > Fuentes de datos.

  2. En Tipos de colección, seleccione el tipo de colección al que quiere agregar colecciones.

  3. Especifique el nombre de una colección.

  4. Seleccione la fuente de datos.

  5. Agregue datos a la colección. Puede agregar datos uno por uno o cargar un archivo CSV.

    Si vas a subir un archivo CSV, asegúrate de que los nombres de las columnas coincidan con los nombres de los atributos del tipo de colección.

  6. Haga clic en Crear.

Collections

Utilice una fuente de datos personalizada sin recopilación

En la siguiente sección parameters se explica cómo definir una fuente de datos personalizada en la definición de StyleBook sin recopilación.

parameters:
    -
      name: selected-environment
      label: Select a custom datasource environment
      type: datum
      required: true
      data-source:
        type: "Environment"
<!--NeedCopy-->

La GUI del paquete de configuración muestra las fuentes de datos aplicables y los usuarios de StyleBook pueden seleccionar cualquiera de ellas para crear un paquete de configuración.

Fuente de datos personalizada sin recopilación

En este ejemplo, utiliza la fuente de datos Production para recuperar datos.

En el tipo de fuente de datos Environment, para acceder al tipo de colección App-virtual-servers, utilice la siguiente expresión:

$parameters.selected-environment.collections.App-virtual-servers
<!--NeedCopy-->

Fragmento de ejemplo:

components:
  -
    name: lbvserver-comp
    type: ns::lbvserver
    repeat: $parameters.selected-environment.collections.App-virtual-servers
    repeat-item: app
    properties:
      name: $app.attributes.Name + "-lb"
      ipv46: ip($app.attributes.IPv46 )
      port: $app.attributes.Port
      servicetype: $app.attributes.Protocol
    components:

      -
        name: servicegroup-comp
        type: ns::servicegroup
        properties:
          servicegroupname: $parent.properties.name + "-svcgrp"
          servicetype: $parent.properties.servicetype

        components:
          -
            name: lbvserver-svg-binding
            type: ns::lbvserver_servicegroup_binding
            properties:
              name: $parent.parent.properties.name
              servicegroupname: $parent.properties.servicegroupname
<!--NeedCopy-->

Utilice fuentes de datos personalizadas con recopilación

En la siguiente sección parameters se explica cómo definir una fuente de datos personalizada en la definición de StyleBook. Permite a los usuarios de StyleBook seleccionar un elemento específico de una colección.

parameters:
  -
    name: selected-app-vserver
    label: Select a collection from the datasource
    type: datum
    required: true
    data-source:
      type: Environment
      collection: App-virtual-servers
<!--NeedCopy-->

En este ejemplo, el parámetro datum se utiliza para definir la fuente de datos personalizada. Utiliza la fuente de datos Production para recuperar datos del tipo de colección App-virtual-servers.

En el tipo de fuente de datos Environment, para acceder al protocolo desde la colección App-virtual-servers, utilice la siguiente expresión:

$parameters.selected-app-vserver.attributes.Protocol
<!--NeedCopy-->

Fragmento de ejemplo:

components:
  -
    name: lbvserver-comp
    type: ns::lbvserver
    properties:
      name: $parameters.selected-app-vserver.attributes.Name
      ipv46: $parameters.selected-app-vserver.attributes.IPv46
      port: $parameters.selected-app-vserver.attributes.Port
      servicetype: $parameters.selected-app-vserver.attributes.Protocol
<!--NeedCopy-->

Al definir un tipo de colección en la sección parameters, los usuarios de StyleBook pueden seleccionar la fuente de datos y la colección.

Utilice fuentes de datos personalizadas