You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: installation/nuget.md
+37Lines changed: 37 additions & 0 deletions
Original file line number
Diff line number
Diff line change
@@ -18,6 +18,14 @@ There are several approaches:
18
18
*[Manual Steps - CLI](#manual-steps---cli)
19
19
*[Nuget Config File](#nuget-config-file)
20
20
21
+
This article also offers some troubleshooting information in case you encounter problems:
22
+
23
+
24
+
*[Troubleshooting](#troubleshooting)
25
+
* [I do not see the Telerik Packages](#i-do-not-see-the-telerik-packages)
26
+
* [CI and CD Automated Builds](#ci-and-cd-automated-builds)
27
+
* Azure
28
+
21
29
## Video Tutorial - Visual Studio
22
30
23
31
The following video explains how you can add the Telerik NuGet feed. If you prefer to do this yourself, follow the rest of this article.
@@ -93,6 +101,12 @@ To use a `nuget.config` file for the Telerik feed, you need to:
93
101
94
102
## Troubleshooting
95
103
104
+
This section lists problems related to the Telerik NuGet feed and their solutions
105
+
106
+
*[I do not see the Telerik Packages](#i-do-not-see-the-telerik-packages)
107
+
*[CI and CD Automated Builds](#ci-and-cd-automated-builds)
108
+
* Azure
109
+
96
110
### I do not see the Telerik Packages
97
111
98
112
There are two common reasons for the Telerik packages to be missing in the Telerik Online Feed:
@@ -116,6 +130,29 @@ Here is a sample process of removing stored credentials from Windows so you can
116
130
7. Enter the Telerik nuget package source again through Visual Studio or CLI. If you are using the feed in .NET Core application, [store your credentials as plain text](#store-credentials-in-clear-text-for-the-telerik-nuget-feed).
117
131
118
132
133
+
### CI and CD Automated Builds
134
+
135
+
Often enough, you would want to set up Continuous Integration and/or Continuous Delivery (CI/CD) pipelines or builds for your project that uses the Telerik components. This is a valid scenario and the "one license per developer" license does not prevent you from doing so. The Telerik components are commercial software and as such can only be distributed through channels that are private and/or behind authentication.
136
+
137
+
There are a couple of common ways people implement CI/CD automated builds:
138
+
139
+
* You can put your own credentials (or the credentials of the license holder, depending on how your licenses are set up) in the nuget.config of the build machine/pipeline. In many cases, when doing so, they will even be encrypted when you add the Telerik feed source through the CLI. Alternatively, you can copy an encrypted version from your own local config if you have one and if plain text is an issue.
140
+
141
+
* Creating a local folder (for example, on a shared network drive or other suitable location accessible by your builds and team) that holds the `.nupkg` files we provide (you can download them from your telerik.com account).
142
+
143
+
You must protect your credentials and/or the Telerik packages and ensure they are used only by you and not by other developers, according to the [license-per-developer policy](https://www.telerik.com/purchase/license-agreement/blazor-ui). They can by such colleagues (like other developers, QAs, designers, front-end devs, DBAs and so on) for building and running a solution, provided they do not use the Telerik components to create functionality. Of course, you must ensure that such credentials or package sources are not available to the general public (for example, in public repositories).
144
+
145
+
#### Azure
146
+
147
+
When using Azure pipelines, we encourage you to review the following blog post on setting things up: [Azure DevOps and Telerik NuGet Packages](https://www.telerik.com/blogs/azure-devops-and-telerik-nuget-packages).
148
+
149
+
There are a couple of common questions and issues:
150
+
151
+
* Obtaining credentials - see the points above for either using your own credentials, or using a shared package source.
152
+
153
+
* Telerik feed not being found - the most common reason for a problem is that the path to the `nuget.config` file is wrong (it should, by default, be at the root level).
154
+
155
+
* An `index.json not found` error can occur from many root causes. If you have successfully authenticated, this error usually means that the feed wasn't able to be searched or connected to. A common reason is an incorrect feed URL, such as including a trailing slash - Correct: `https://nuget.telerik.com/nuget` and Incorrect: `https://nuget.telerik.com/nuget/`, or a connectivity issue such as a firewall rule in your organization.
0 commit comments