LLI Wiki — My Digital Knowledge Base

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

Mastodon LLIMastodon SocialFosstodon