About This Page
This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.
Bias Analysis
Bias Types:
⚠️
powershell_heavy
⚠️
windows_first
Summary:
The documentation provides both Bash and PowerShell examples for all Azure CLI and Docker commands, ensuring cross-platform coverage. However, in several key sections, the PowerShell workflow is more verbose and detailed, especially for deploying the frontend application, where the PowerShell path uses multiple custom objects and cmdlets, while the Bash path uses a single CLI command. Additionally, in the deployment section, the Bash example is presented first, followed by the PowerShell example, which may subtly prioritize Bash/Linux users, but the PowerShell path is more elaborate and may imply a Windows-centric workflow.
Recommendations:
- Ensure that both Bash and PowerShell examples are equally detailed and cover the same workflow steps, especially for complex operations like deploying container apps.
- Where possible, provide simplified PowerShell examples that match the simplicity of the Bash/CLI approach, or explain why the PowerShell workflow is more complex.
- Consider explicitly mentioning that both Bash and PowerShell can be used on Windows, macOS, and Linux, to avoid the perception that PowerShell is only for Windows users.
- If advanced PowerShell workflows are included, consider providing advanced Bash equivalents (e.g., using jq for JSON parsing) to maintain parity.
- Review the ordering of examples to ensure neither platform is consistently prioritized over the other.
Create pull request
Flagged Code Snippets
$APIBaseURL = (Get-AzContainerApp -Name $APIName -ResourceGroupName $ResourceGroup).IngressFqdn
$RegistryCredentials = Get-AzContainerRegistryCredential -Name $ACRName -ResourceGroupName $ResourceGroup
$RegistryArgs = @{
Server = $ACRName + '.azurecr.io'
PasswordSecretRef = 'registrysecret'
Username = $RegistryCredentials.Username
}
$RegistryObj = New-AzContainerAppRegistryCredentialObject @RegistryArgs
$SecretObj = New-AzContainerAppSecretObject -Name 'registrysecret' -Value $RegistryCredentials.Password
$AppArgs = @{
Name = $FrontendName
Location = $Location
ResourceGroupName = $ResourceGroup
ManagedEnvironmentId = $EnvId
TemplateContainer = $ContainerObj
ConfigurationRegistry = $RegistryObj
ConfigurationSecret = $SecretObj
IngressTargetPort = 3000
IngressExternal = $true
}
$FrontEndApp = New-AzContainerApp @AppArgs
# show the app's FQDN
$FrontEndApp.IngressFqdn