LLI Wiki — My Digital Knowledge Base

Tester l'accès Azure SQL avec une identité managée en PowerShell

Séquence de test Az PowerShell avec une identité managée pour diagnostiquer un job Azure Batch, et vérification de syntaxe d'un script.

Lorsqu'un script d'automatisation Azure (par exemple un export ou une copie de base exécuté sur Azure Batch) fonctionne depuis une machine et échoue depuis une autre, il est utile de tester pas à pas les mêmes appels Az PowerShell avec l'identité managée utilisée par le job. Cet article présente une séquence de test minimale et une vérification rapide de la syntaxe du script.

Vérifier la syntaxe du script sans l'exécuter

Parser.ParseFile signale les erreurs de syntaxe avec la ligne et la colonne, sans rien exécuter :

$errs = $null
[void][System.Management.Automation.Language.Parser]::ParseFile(
  "C:\scripts\New-BatchJobs.ps1",
  [ref]$null,
  [ref]$errs
)

if ($errs) {
  $errs | ForEach-Object {
    "{0}:{1} {2}" -f $_.Extent.StartLineNumber, $_.Extent.StartColumnNumber, $_.Message
  }
} else {
  "OK"
}

Tester avec l'identité managée affectée à l'utilisateur

À exécuter sur la machine qui lancera le job (nœud Azure Batch, hôte Azure Virtual Desktop, VM). Connect-AzAccount -Identity ne fonctionne que si l'identité est réellement affectée à la ressource de calcul ; il échoue sur un poste hors d'Azure, où l'on s'authentifie plutôt de façon interactive avec Connect-AzAccount.

# Connexion avec l'identité managée affectée à l'utilisateur (client ID de l'identité)
Connect-AzAccount -Identity -AccountId "00000000-0000-0000-0000-000000000000"

# Sélectionner l'abonnement qui contient le serveur SQL
Set-AzContext -SubscriptionName "Production Subscription"
Get-AzContext

# Lister les serveurs SQL du groupe de ressources
Get-AzSqlServer -ResourceGroupName "rg-example" | Format-Table ServerName

Vérifier ensuite que l'identité peut lire le serveur et ses pools élastiques :

$server = Get-AzSqlServer -ResourceGroupName "rg-example" -ServerName "sqlsrv-example-01"
Get-AzSqlElasticPool -ServerName $server.ServerName -ResourceGroupName $server.ResourceGroupName |
    Format-Table ServerName, ElasticPoolName

Répétez la séquence pour chaque abonnement que le job doit atteindre (production, préproduction, ...) et depuis chaque endroit où le job peut s'exécuter. Comparez les combinaisons qui réussissent et celles qui échouent : un échec sur un hôte ou dans un abonnement alors que les autres fonctionnent indique une différence d'affectation de l'identité sur cet hôte ou d'attributions de rôles sur l'abonnement ou le groupe de ressources. Vérifiez d'abord ces deux points.

Copier une base dans un pool élastique

La copie d'une base Azure SQL vers un pool élastique du même serveur se fait avec New-AzSqlDatabaseCopy. Le journal d'un tel job passe en général par ces étapes : résolution du serveur source, recherche de la base source, vérification du serveur et du pool élastique de destination, puis démarrage de la copie. La copie est asynchrone : un message « copie initiée » ne signifie pas qu'elle est terminée.

New-AzSqlDatabaseCopy -ResourceGroupName "rg-example" -ServerName "sqlsrv-example-01" `
    -DatabaseName "AppDb" `
    -CopyDatabaseName "AppDb-copy" `
    -ElasticPoolName "elasticpool-example-01"

Voir la référence de New-AzSqlDatabaseCopy pour tous les paramètres.

Remarques

Mastodon LLIMastodon SocialFosstodon