-
-
-
-
StyleBook groups
-
Importing and synchronizing StyleBooks from GitHub repository
-
Simplified migration of Citrix ADC application configuration using StyleBooks
-
-
-
Use ADM log messages for managing and monitoring your infrastructure
-
-
Citrix ADC automation using Citrix ADM in Cisco ACI hybrid mode
-
Citrix ADC device package in Cisco ACI's cloud orchestrator mode
-
This content has been machine translated dynamically.
Dieser Inhalt ist eine maschinelle Übersetzung, die dynamisch erstellt wurde. (Haftungsausschluss)
Cet article a été traduit automatiquement de manière dynamique. (Clause de non responsabilité)
Este artículo lo ha traducido una máquina de forma dinámica. (Aviso legal)
此内容已经过机器动态翻译。 放弃
このコンテンツは動的に機械翻訳されています。免責事項
이 콘텐츠는 동적으로 기계 번역되었습니다. 책임 부인
Este texto foi traduzido automaticamente. (Aviso legal)
Questo contenuto è stato tradotto dinamicamente con traduzione automatica.(Esclusione di responsabilità))
This article has been machine translated.
Dieser Artikel wurde maschinell übersetzt. (Haftungsausschluss)
Ce article a été traduit automatiquement. (Clause de non responsabilité)
Este artículo ha sido traducido automáticamente. (Aviso legal)
この記事は機械翻訳されています.免責事項
이 기사는 기계 번역되었습니다.책임 부인
Este artigo foi traduzido automaticamente.(Aviso legal)
这篇文章已经过机器翻译.放弃
Questo articolo è stato tradotto automaticamente.(Esclusione di responsabilità))
Translation failed!
StyleBook categories
There are two StyleBook categories in Citrix Application Delivery Management (ADM). They are the default StyleBooks and the custom StyleBooks. Whether it is a default or custom, a StyleBook is either a public or a private StyleBook. In Citrix ADM, you can view all the StyleBooks that are present in the system, regardless of their type or visibility status. You can also view a graphical display of how StyleBooks are connected with each other.
This document explains the different types of StyleBooks. Also, it explains the following actions that you can perform on the StyleBooks from Citrix ADM:
- Download a custom StyleBook and make modifications, or create a StyleBook based on an existing one.
- Hide ADM default StyleBooks.
- Delete a custom StyleBook from Citrix ADM.
- Add tags to the StyleBooks.
Default and custom StyleBooks
- Default StyleBooks are the StyleBooks shipped with Citrix ADM and they allow you to create configurations that you can deploy on your Citrix ADC instances. You cannot delete default StyleBooks, but you can hide them from the ADM GUI.
- Custom StyleBooks are your own StyleBooks that you imported in to Citrix ADM.
Both default and custom StyleBooks can be either public or private.
Public and private StyleBooks
StyleBooks from which you can create configuration packs can be categorized as public StyleBooks. That is, they are all available for your direct usage to create configurations from the Citrix ADM GUI and APIs.
But, some StyleBooks are used as building blocks for other StyleBooks. Such StyleBooks are marked as private. The private StyleBooks cannot be directly used to create configuration packs from the Citrix ADM GUI. But, you can still display and view these StyleBooks on Citrix ADM. To mark any of your custom StyleBooks as private, set the private attribute in the StyleBook to true. You can still use private StyleBooks to create configuration packs using the Citrix ADM APIs.
Example of a StyleBook marked as private
name: basic-lb-config
namespace: com.example.stylebooks
version: "0.1"
display-name: Load Balancing Configuration
description: |
This StyleBook defines a simple load balancing configuration and is a building block to build other load balancing configurations.
schema-version: "1.0"
private: true
<!--NeedCopy-->
View StyleBooks
The number of StyleBooks - both default and private are increasing in Citrix ADM. You might want to search for the particular StyleBook that you want to access. You might also want to view both types of StyleBooks separately.
In Citrix ADM, when you navigate to Applications > StyleBooks, you can view a list of StyleBooks that are present in the system.
A default public StyleBook has the following icon on its panel:
Whereas a default private StyleBook has an icon that declares it as a private StyleBook:
While you can view the definition and dependencies of a private StyleBook, you cannot create a configuration packs from a private StyleBook using the GUI. The main purpose of a private StyleBook is to use it as a building block for another StyleBook. Using the building-blocks-StyleBooks encourages the reuse of common configuration patterns.
A custom public StyleBook has a different icon as shown in the following image:
While a custom private StyleBook appears with this icon:
At the top right-side of the page, you can see an option to select the type of StyleBooks to view. There are three options - all, public, or private StyleBooks. Click one of the options.
You can also search for a particular StyleBook by clicking the search icon. You can search by name, namespace, and version attributes or a combination of these options. The search operation is not case-sensitive.
Download custom StyleBooks
To download the custom StyleBooks from Citrix ADM, navigate to Applications > StyleBooks > Configurations. In the list of StyleBooks that are displayed on the right-side panel, check the option to download the custom-defined StyleBooks. Click Download. If the StyleBook has dependent custom StyleBooks, you can include the dependent StyleBooks in the downloaded bundle.
Note:
You can download custom StyleBooks that are marked as either public or private.
Note:
You cannot download Citrix ADM default StyleBooks. You can view their definitions and dependencies. To do so, click View Definition and View Dependencies links on the StyleBook panel.
Delete custom StyleBooks
You can also delete a custom StyleBook by clicking the Delete button. A pop-up window prompts you to confirm if you want to remove the StyleBook from Citrix ADM. If the StyleBook uses other custom StyleBooks, you can choose to remove such StyleBooks by selecting the check box.
Note:
Do not delete a custom StyleBook if it has dependent StyleBooks in Citrix ADM. Otherwise, it would break the existing StyleBooks.
View StyleBook dependencies
An important and powerful feature of StyleBooks is that they can be used as building blocks for other StyleBooks. You can import a StyleBook into another StyleBook. An imported StyleBook is declared as a type and is used by components or parameters of the second StyleBook. You can study the existing default StyleBooks in Citrix ADM to learn how one StyleBook can be built on top of another StyleBook.
Citrix ADM allows you to view a graphical display of how StyleBooks are connected with each other. This representation is especially useful for complex StyleBooks that are built using other StyleBooks as building blocks. By looking at the dependency graph, it is possible to see the relationships and dependencies among multiple StyleBooks.
A StyleBook used by other StyleBooks cannot be removed from the system because it would break the existing StyleBooks. Using the dependency graph display, you can identify which StyleBooks are preventing the removal of a StyleBook.
To view StyleBook dependencies
In Citrix ADM, navigate to Applications > StyleBooks. The StyleBooks page displays all the StyleBooks available for your use in Citrix ADM. Scroll down and find your StyleBook. The StyleBook tile displays links to create a configuration, to view the StyleBook definition, and to view the StyleBook dependencies. Click View Dependencies.
Forward dependencies
The Forward Dependencies tab allows you to view the different default StyleBooks that your StyleBook is using. Follow the arrows to find the StyleBook that a StyleBook is using. When you point your mouse to one of the arrows, the arrow and the StyleBooks that are connected to one another are highlighted. You can also click the StyleBook names to view the definition of that StyleBook.
Reverse dependencies
The Reverse Dependencies tab allows you to graphically view the StyleBooks that are using your StyleBook. If you follow the arrows, you can see that all the StyleBooks in the display point towards your StyleBook. Some StyleBooks might be directly using the StyleBook and some StyleBooks might be using the StyleBook through another StyleBook.
Audit ADC configuration against configuration pack
You can compare the changes made by a StyleBook configuration pack to the current ADC configuration. With this comparison, you can do the following:
-
Detect the configuration drift between StyleBook configuration pack and ADC configuration.
-
Identify any modified and deleted objects on the ADC that do not reflect the changes made by the configuration pack.
To compare the configuration pack changes to the ADCs config, do the following.
-
Navigate to Applications > StyleBooks > Configurations.
-
Click Configuration Audit.
The Configuration Audit page displays the objects created and audited.
Create a tag for the StyleBook
You can add tags to any StyleBook in Citrix ADM. Tags are key-value pairs that allow you to group StyleBooks using different criteria. You can use these tags while searching or filtering for StyleBooks in Citrix ADM.
To add a tag to the StyleBook:
-
Navigate to Applications > StyleBooks.
-
Select Tags on the StyleBook for which you want to add tags.
You can add tags to all types of StyleBooks.
-
Specify the required Key and Value information that helps you filter the StyleBook.
For example, Key=team and Value=bizdata
To add more tags, click +.
-
Click Create.
To filter StyleBooks using tags, in the search bar, click Tags and select key and value from the list. The StyleBooks that are matching the specified tag are displayed.
The following is an example search for the StyleBooks that have a tag where key=team
and value=bizdata
:
You can associate the StyleBook tags to its configuration pack. So, you can search the configuration packs using the StyleBook tags itself.
When you create a configuration pack, use one the following options in the Tag Association section:
-
Associate all present and future StyleBook tags with the configuration – This option associates all the StyleBook tags to a configuration pack. It also makes sure to associate the new tags that you might add to the StyleBooks in future.
-
Select tags – This option displays the tags of the selected StyleBook. You can select the required StyleBook tags and associate with a configuration pack.
Share
Share
This Preview product documentation is Cloud Software Group Confidential.
You agree to hold this documentation confidential pursuant to the terms of your Cloud Software Group Beta/Tech Preview Agreement.
The development, release and timing of any features or functionality described in the Preview documentation remains at our sole discretion and are subject to change without notice or consultation.
The documentation is for informational purposes only and is not a commitment, promise or legal obligation to deliver any material, code or functionality and should not be relied upon in making Cloud Software Group product purchase decisions.
If you do not agree, select I DO NOT AGREE to exit.