Servicio Citrix Application Delivery Management

Construcción Parameters-Default-sources

Puede utilizar este componente fijo para reutilizar definiciones de parámetros de otros StyleBooks.

Considere un caso en el que un parámetro o un grupo de parámetros se utiliza repetidamente en varios StyleBooks. Para evitar redefinir estos parámetros, cada vez que quiera crear un StyleBook, puede definirlos una vez y, a continuación, importar sus definiciones en los StyleBooks que necesiten estos parámetros mediante la construcción parameters-default-sources.

Por ejemplo, si muchos de sus StyleBooks necesitan configurar una IP virtual, es posible que tenga que definir los mismos parámetros relacionados con las IP virtuales en cada nuevo StyleBook que cree. En su lugar, puede crear un StyleBook separado llamado, por ejemplo, “vip-params” donde define todos los parámetros relacionados con él como se muestra en el siguiente ejemplo:

     -

     name: vip-params

     namespace: com.acme.commontypes

     version: "1.0"

     description: This StyleBook defines a typical virtual IP config.

     private: true

     schema-version: "1.0"

     parameters:

       -

           name: lb-appname

           label: Load Balanced Application Name

          description: Name of the Load Balanced application

           type: string

           required: true

       -

           name: lb-virtual-ip

           label: Load Balanced App Virtual IP address

           description: Virtual IP address representing the Load Balanced application

           type: ipaddress

           required: true

       -

           name: lb-virtual-port

           label: Load Balanced App Virtual Port

           description: TCP port representing the Load Balanced application

           type: tcp-port

           default: 80

       -

           name: lb-service-type

           label: Load Balanced App Protocol

           description: Protocol used for the Load Balanced application.

           type: string

           default: HTTP

           required: true

           allowed-values:

                - HTTP

                - SSL

                - TCP

A continuación, puede crear otros StyleBooks que hagan uso de estos parámetros. Lo que sigue es un ejemplo de tal StyleBook.

     -

     name: acme-biz-app

     namespace: com.acme.stylebooks

     version: "1.0"

     description: This stylebook defines the Citrix ADC configuration for Biz App

     schema-version: "1.0"

     import-stylebooks:

       -

          namespace: com.acme.commontypes

          prefix: cmtypes

          version: "1.0"

     \*\*parameters-default-sources:\*\*

**            - cmtypes::vip-params**

     parameters:

         -

           name: monitorname

           label: Monitor Name

           description: Name of the monitor

           type: string

           required: true

         -

           name: type

           label: Monitor Type

           description: Type of the monitor

           type: string

           required: true

           allowed-values:

             - PING

             - TCP

             - HTTP

             - HTTP-ECV

             - TCP-ECV

             - HTTP-INLINE

En el StyleBook, acme-biz-app, primero, el espacio de nombres y la versión de vip-params StyleBook se importan mediante la sección “import-stylebooks”. A continuación, se agrega la construcción parameters-default-sources y se especifica el nombre de StyleBook, es decir, vip-params. Esto tiene el mismo efecto que definir los parámetros de los vip-params StyleBook directamente en este StyleBook.

Puede incluir parámetros de varios StyleBooks porque los parameters-default-sources es una lista y se espera que cada elemento de la lista sea un StyleBook.

Además de incluir parámetros de otros StyleBooks, también puede definir sus propios parámetros mediante la sección de parámetros. La lista completa de parámetros del StyleBook es la combinación de parámetros incluidos de otros StyleBooks y parámetros definidos en este StyleBook. Por lo tanto, la expresión $parameters hace referencia a esta combinación de parámetros.

Tenga en cuenta que si se define un parámetro tanto en un StyleBook importado como en el StyleBook actual, la definición del StyleBook actual anula la definición importada de otro StyleBook. Puede utilizar esto de manera eficaz personalizando algunos de los parámetros importados si es necesario, mientras utiliza el resto de los parámetros importados tal como están.

La construcción parameters-default-sources también se puede utilizar en parámetros anidados como se muestra:

parameters:

    -

      name: vip-details

      label: Virtual IP details

      description: Details of the Virtual IP

      type: object

      required: true

      parameters-default-sources:

              - cmtypes::vip-params

Esto es similar a tener los parámetros de los vip-params de StyleBook agregados directamente como parámetros secundarios del parámetro vip-details en este StyleBook.

Construcción Parameters-Default-sources