Skip to content

Commit 6b8ff29

Browse files
author
Peter Spillman
committed
Merged PR 497124: Update docs to show new "Set up the new Azure Artifacts Credential Provider"
The artifacts "Connect to Feed" dialog now shows a new option to install the Azure Artifacts Credential Provider, and no longer advertises the older credentialProviderBundle.zip. This PR updates the screenshot to show the modified UI. The new credential provider also requires nuget 4.8+, so the minimum recommended nuget version is also updated (was 3.5+).
1 parent 1f29adb commit 6b8ff29

7 files changed

+13
-34
lines changed
Loading

docs/artifacts/_shared/nuget/nuget-3x.md

-6
This file was deleted.

docs/artifacts/_shared/nuget/nuget-publish-endpoint.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ ms.topic: include
2020
2121
::: moniker-end
2222

23-
::: moniker range=">=tfs-2017 < azure-devops"
23+
::: moniker range=">=tfs-2017 < azure-devops-2019"
2424

2525
1. Go to your feed ([or create a feed if you haven't](../../feeds/create-feed.md)).
2626

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
---
2+
ms.topic: include
3+
---
4+
5+
> [!NOTE]
6+
> The Azure Artifacts service recommends NuGet 4.8.2 or later. However, Azure Artifacts also supports legacy NuGet 2.x clients. For a complete list of the latest clients, see the [NuGet distribution page](http://dist.nuget.org/index.html).

docs/artifacts/_shared/nuget/publish.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ First, get the tools and your feed URL:
1616
> [!NOTE]
1717
>
1818
> * The NuGet client's push command requires an API key. You can use any non-empty string you want. In this example, we used `key`.
19-
> * If you're prompted for credentials on the command line, ensure that the downloaded credential provider is in the same folder as NuGet.exe. For more help in using credential providers with NuGet, see [Authenticating feeds with nuget.exe credential providers](https://docs.microsoft.com/nuget/reference/extensibility/nuget-exe-credential-providers). For Azure DevOps, use a personal access token when prompted for credentials, see [Authenticate access with personal access tokens](https://docs.microsoft.com/azure/devops/organizations/accounts/use-personal-access-tokens-to-authenticate?view=vsts).
19+
> * If you're prompted for credentials on the command line, ensure that you set up the [Azure Artifacts Credential Provider](https://go.microsoft.com/fwlink/?linkid=2099625). For more help in using credential providers with NuGet, see [NuGet Cross Platform Plugins](https://docs.microsoft.com/nuget/reference/extensibility/nuget-cross-platform-plugins). For Azure DevOps, use a personal access token when prompted for credentials, see [Authenticate access with personal access tokens](https://docs.microsoft.com/azure/devops/organizations/accounts/use-personal-access-tokens-to-authenticate?view=vsts).
2020
2121
## Get or create a sample package to push
2222

docs/artifacts/nuget/move-from-fileshares.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -36,9 +36,9 @@ However, if you have workflows that publish packages with newer binaries without
3636
This prevents invalid packages from entering your development and build environments.
3737
However, any workflow that publishes malformed packages will break when moving to Azure DevOps Services NuGet feeds.
3838

39-
### NuGet 3.x is recommended
39+
### NuGet 4.8+ is recommended
4040

41-
[!INCLUDE [nuget-3x](../_shared/nuget/nuget-3x.md)]
41+
[!INCLUDE [nuget-recommended-version](../_shared/nuget/nuget-recommended-version.md)]
4242

4343
### Authentication and authorization
4444

docs/artifacts/nuget/nuget-exe.md

+3-24
Original file line numberDiff line numberDiff line change
@@ -19,10 +19,10 @@ monikerRange: '>= tfs-2018'
1919
> [!NOTE]
2020
> This page covers interactive scenarios. In Azure Pipelines, use the NuGet step to [restore](/azure/devops/pipelines/packages/nuget-restore) and [publish](/azure/devops/pipelines/artifacts/nuget) packages.
2121
22-
[!INCLUDE [nuget-3x](../_shared/nuget/nuget-3x.md)]
22+
[!INCLUDE [nuget-recommended-version](../_shared/nuget/nuget-recommended-version.md)]
2323

24-
## Add a feed to NuGet 3 or later
25-
NuGet 3 and later supports the Credential Provider, which automatically acquires feed credentials when needed.
24+
## Add a feed to NuGet 4.8.2 or later
25+
NuGet 4.8.2 and later supports the Azure Artifacts Credential Provider, which automatically acquires feed credentials when needed.
2626

2727
1. Navigate to your feed ([or create a feed if you haven't](../feeds/create-feed.md)).
2828

@@ -111,24 +111,3 @@ nuget.exe sources add -name {your feed name} -source {your feed URL} -username {
111111

112112
Then, run any [nuget command](/nuget/tools/nuget-exe-cli-reference).
113113

114-
## Download the credential provider directly
115-
You can download the credential provider directly from this link. Replace `{org_name}` with your organization name:
116-
`https://pkgs.dev.azure.com/{org_name}/_apis/public/nuget/client/CredentialProviderBundle.zip`
117-
118-
## Advanced credential provider scenarios
119-
### Install the credential provider
120-
By default, the credential provider works alongside NuGet.exe.
121-
122-
For advanced scenarios, you can choose where to install the provider:
123-
124-
- **Projects with a developer command prompt or enlistment:** Use the provider from an
125-
[environment variable](http://docs.nuget.org/Consume/Credential-Providers#using-a-credential-provider-from-an-environment-variable) by copying `CredentialProvider.Vss.exe` to any folder, then run this command in PowerShell: `$env:NUGET_CREDENTIALPROVIDERS_PATH = {your folder}`
126-
- **Projects using a non-Azure DevOps Services CI server:** Use the provider from an
127-
[environment variable](http://docs.nuget.org/Consume/Credential-Providers#using-a-credential-provider-from-an-environment-variable)
128-
- **Work on an individual machine:** Install the provider
129-
[globally](http://docs.nuget.org/Consume/Credential-Providers#installing-a-credential-provider-globally) by copying `CredentialProvider.Vss.exe` to `$env:LOCALAPPDATA\NuGet\CredentialProviders`
130-
131-
### Bootstrap into your workflow
132-
133-
You can also add the provider to your enlistment or developer command prompt using our [bootstrap tools](bootstrap-nuget.md).
134-
This is recommended if you're using the provider in a multi-engineer development environment.

0 commit comments

Comments
 (0)