Application Delivery Management

Import and synchronize StyleBooks from GitHub repository

December 31, 2023

Contributed by:

Consider a scenario where you are using CI/CD processes for your development. Or, a scenario where you are managing all the application source code and deployment objects in GitHub.

In the GitHub repository, you might have created several StyleBooks for deploying the Citrix ADC configurations and managing these StyleBooks. These StyleBooks are also required in Citrix Applications and Delivery Management (ADM). Now, you can directly import these StyleBooks into Citrix ADM. You don’t need to manually copy them from GitHub and then upload them into Citrix ADM or manually synchronize the files in both ADM and GitHub.

You can now define a repository in Citrix ADM that represents a GitHub repository. Provide the GitHub repository URL and your user name and password (or API token) created in GitHub. That means, only authorized users who have a valid account in GitHub can import and sync StyleBooks.

After creating the repository, you can sync Citrix ADM with your GitHub repository. Citrix ADM connects to GitHub and imports StyleBooks found in that repository. ADM then validates the StyleBooks and adds them to the list of StyleBooks in Citrix ADM. StyleBooks are not added to Citrix ADM if they fail validation. Correct the errors and commit updated versions into your GitHub repository. Later you can try importing them or syncing them again into Citrix ADM.

Note

StyleBooks files can be imported and synchronized from any branch of a GitHub repository.

You can import and synchronize StyleBooks that have dependent StyleBooks associated with them too.

The synchronization of StyleBooks from a GitHub repository must be initiated manually from the Citrix ADM GUI or API. That is, currently, importing and syncing of StyleBooks does not happen automatically based on GitHub commit activity.

Add a repository and import StyleBooks from GitHub repository

Before you begin, ensure you have a valid account in GitHub.

You can import StyleBook files to ADM from any folder in the GitHub repository.

In Citrix ADM, navigate to Applications > StyleBooks > Repositories.
Click Add. In the Add Repository window, enter the following parameters:
- Name. Type the name of the repository. This name can be the same as the repository name in GitHub or a different one.
- Repository URL. Type the GitHub repository URL.
- User name and password. Type the user name and password with which you access the GitHub account.
Note

You can also provide the API token in place of a password. API tokens can be used instead of a password for GitHub over HTTPS. For information on how to create API tokens for your GitHub repository, see the GitHub documentation for creating personal access tokens.
Click Create.

The repository is created in Citrix ADM.
To import or sync StyleBooks, select the repository in the Repositories page, and click Sync.

The other actions that you can use here are:

Edit. You can edit the repository URL, user name, and password (or API token).
Delete. You can delete the repository along with all StyleBooks present in Citrix ADM that were imported previously from that GitHub repository.

Note

You cannot delete a repository from Citrix ADM if it has any StyleBooks that have ConfigPacks associated with them. First, delete all the configuration packs of these StyleBooks. You can later remove the repository from Citrix ADM to clean up the StyleBooks from that repository.
Reset. You can remove all StyleBooks in Citrix ADM synced from that repository without actually deleting the repository entry from Citrix ADM.
List files. You can see a list of all StyleBooks present in Citrix ADM that originates from the GitHub repository.

The official version of this content is in English. Some of the Cloud Software Group documentation content is machine translated for your convenience only. Cloud Software Group has no control over machine-translated content, which may contain errors, inaccuracies or unsuitable language. No warranty of any kind, either expressed or implied, is made as to the accuracy, reliability, suitability, or correctness of any translations made from the English original into any other language, or that your Cloud Software Group product or service conforms to any machine translated content, and any warranty provided under the applicable end user license agreement or terms of service, or any other agreement with Cloud Software Group, that the product or service conforms with any documentation shall not apply to the extent that such documentation has been machine translated. Cloud Software Group will not be held responsible for any damage or issues that may arise from using machine-translated content.

Import and synchronize StyleBooks from GitHub repository

December 31, 2023

Contributed by:

December 31, 2023

Contributed by:

Import and synchronize StyleBooks from GitHub repository

Add a repository and import StyleBooks from GitHub repository

In this article