diff --git a/licensing/add-license-to-ci-cd.md b/licensing/add-license-to-ci-cd.md index 6327c93db..f7cde152d 100644 --- a/licensing/add-license-to-ci-cd.md +++ b/licensing/add-license-to-ci-cd.md @@ -9,22 +9,25 @@ position: 2 # Adding Your License Key to CI/CD Services -This article describes how to set up and activate your Telerik UI for .NET WinForms [license key]({%slug license-key%}) across a few popular CI/CD services by using environment variables. +This article describes how to set up and activate your Telerik UI for .NET WinForms [license key]({%slug license-key%}) across a few popular CI/CD services by using deployment keys. -When working with CI/CD platforms, always add the `Telerik.Licensing` NuGet package as a project dependency. This package activates the Telerik UI for .NET WinForms components at build time by using the provided license key. +Deployment keys are a dedicated type of license key for build pipelines. They're tied to a specific application and the set of products that the application uses. Deployment keys cannot be used for application development. -> If you cannot use NuGet packages in your project, see the workaround in the [Adding Your License Key to CI Platforms as a Code Snippet]({%slug add-license-as-snippet-ci-cd%}) KB article. +To activate your license in a CI/CD environment: -The license activation process in a CI/CD environment involves the following steps: +1. Navigate to the [Deployment Keys](https://www.telerik.com/account/downloads/deployment-keys) page. -1. [Download a Telerik UI for .NET WinForms license key]({%slug license-key%}) from your Telerik account. +1. Click **Add Application**. In the form that opens: -1. Add the `Telerik.Licensing` NuGet package as a project dependency. + - Add the application name. - ````XML - - ```` -1. [Create an environment variable](#creating-an-environment-variable) named `TELERIK_LICENSE` and add your Telerik UI for .NET WinForms license key as a value. + - Select the type of application—public or private. + + - Select the set of products used in the application. + +1. Copy the key value and store it securely. + +1. [Create an environment variable](#creating-an-environment-variable) named **TELERIK_LICENSE** and set it to the obtained key value. Alternatively, the key can be stored in a `telerik-license.txt` file, for example when using the [Azure Secure files approach](#using-secure-files-on-azure-devops). ## Creating an Environment Variable The recommended approach for providing your license key to the `Telerik.Licensing` NuGet package is to use environment variables. Each CI/CD platform has a different process for setting environment variables and this article lists only some of the most popular examples.