Publier un module PowerShell sur un flux Azure Artifacts
Enregistrer un flux Azure Artifacts comme dépôt PowerShell privé et y publier un module avec PowerShellGet, PSResourceGet ou nuget.
Cet article montre comment enregistrer un flux Azure Artifacts comme dépôt PowerShell privé et y publier un module ou un package, avec PowerShellGet v2 (Register-PSRepository), PSResourceGet (Register-PSResourceRepository / Publish-PSResource) ou nuget.exe. L'authentification utilise un jeton d'accès personnel (PAT) avec droits sur les packages. Ne mettez jamais le PAT dans un script : stockez-le dans un coffre de secrets.
Référence : Use a private PowerShell library with Azure Artifacts.
Valeurs à remplacer
| Valeur | Signification |
|---|---|
<ORGANIZATION_NAME> |
Organisation Azure DevOps |
<PROJECT_NAME> |
Projet propriétaire du flux (à omettre si le flux est au niveau de l'organisation) |
<FEED_NAME> |
Flux Azure Artifacts |
<PAT> |
Jeton d'accès personnel avec l'étendue Packaging (lecture et écriture) |
Stocker le PAT dans un coffre de secrets
Register-SecretVault -Name "MySecretVault" -ModuleName Microsoft.PowerShell.SecretStore -DefaultVault
# $credentials est un PSCredential : un nom d'utilisateur quelconque, le PAT comme mot de passe
$credentials = Get-Credential
Set-Secret -Name "MyCredential" -Secret $credentials -Vault "MySecretVault"
$CredentialInfo = [Microsoft.PowerShell.PSResourceGet.UtilClasses.PSCredentialInfo]::new('MySecretVault', 'MyCredential')
Option 1 : PowerShellGet v2
$patToken = "<PAT>" | ConvertTo-SecureString -AsPlainText -Force
$myCredentialsObject = New-Object System.Management.Automation.PSCredential("user", $patToken)
Register-PSRepository -Name "PSGalleryUpstream" `
-SourceLocation "https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/nuget/v2" `
-PublishLocation "https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/nuget/v2" `
-InstallationPolicy Trusted -Credential $myCredentialsObject
Option 2 : PSResourceGet
Enregistrez le flux avec l'identifiant stocké dans le coffre, listez les dépôts puis publiez :
Register-PSResourceRepository -Name "PowershellPSResourceRepository" `
-Uri "https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json" `
-Trusted `
-CredentialInfo $CredentialInfo
Get-PSResourceRepository
Publish-PSResource -Path C:\work\demo -Repository PowershellPSResourceRepository -ApiKey (Get-Secret MyCredential)
Publish-PSResource peut aussi cibler un dépôt enregistré avec Register-PSRepository (ici PSGalleryUpstream) en changeant -Repository.
Option 3 : nuget.exe
Ajoutez le flux comme source NuGet (remplacez <PAT> ; ne le versionnez pas) :
nuget sources Add -Name "MyModuleFeed" `
-Source "https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json" `
-username "user" -password '<PAT>'
Créez un .nuspec pour le module, empaquetez-le, puis poussez le .nupkg :
& .\nuget spec Get-Hello
& .\nuget pack Get-Hello.nuspec
& .\nuget.exe push -Source "MyModuleFeed" -ApiKey '<PAT>' C:\work\demo\Get-Hello.1.0.1.nupkg
Un push réussi se termine ainsi :
Pushing Get-Hello.1.0.1.nupkg to 'https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json'...
PUT https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json
Using credentials from config. UserName: user
Accepted https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json 1325ms
Your package was pushed.
Remarques
- Chaque push exige une nouvelle version du package : incrémentez la version dans le
.nuspec(ou le manifeste du module) avant de ré-empaqueter. - Gardez le PAT hors des scripts et du dépôt de sources ; utilisez le coffre de secrets ou une variable secrète de pipeline.