Guida introduttiva: Distribuire un'immagine del contenitore esistente con la riga di comando

Articolo
12/04/2024

Il servizio App contenitore di Azure consente di eseguire microservizi e applicazioni in contenitori in una piattaforma serverless. Con App contenitore è possibile sfruttare i vantaggi dell'esecuzione di contenitori, eliminando qualsiasi preoccupazione relativa alla configurazione manuale dell'infrastruttura cloud e degli agenti di orchestrazione dei contenitori complessi.

Questo articolo illustra come distribuire un contenitore esistente in App contenitore di Azure.

Nota

L'autorizzazione con registro privato è supportata tramite nome utente e password del registro.

Prerequisiti

Un account Azure con una sottoscrizione attiva.
- Se non hai un account, puoi crearlo gratuitamente.
Installare l'interfaccia della riga di comando di Azure.
Accesso a un registro contenitori pubblico o privato, ad esempio Registro Azure Container.

Attrezzaggio

Per accedere ad Azure dall'interfaccia della riga di comando, eseguire il comando seguente e seguire le istruzioni per completare il processo di autenticazione.

Bash
Azure PowerShell

az login

Connect-AzAccount

Assicurarsi di eseguire l'ultima versione dell'interfaccia della riga di comando eseguire il comando di aggiornamento.

Bash
Azure PowerShell

az upgrade

Install-Module -Name Az -Scope CurrentUser -Repository PSGallery -Force

Ignorare eventuali avvisi sui moduli attualmente in uso.

Installare o aggiornare quindi l'estensione App contenitore di Azure per l'interfaccia della riga di comando.

Se si ricevono errori relativi ai parametri mancanti quando si eseguono comandi az containerapp nell'interfaccia della riga di comando di Azure o nei cmdlet del modulo Az.App in Azure PowerShell, assicurarsi di avere installato la versione più recente dell'estensione App contenitore di Azure.

Bash
Azure PowerShell

az extension add --name containerapp --upgrade

Nota

A partire da maggio 2024, le estensioni dell'interfaccia della riga di comando di Azure non abilitano più le funzionalità di anteprima per impostazione predefinita. Per accedere alle funzionalità di anteprima di App contenitore, installare l'estensione App contenitore con --allow-preview true.

az extension add --name containerapp --upgrade --allow-preview true

Install-Module -Name Az.App

Assicurarsi di aggiornare il modulo Az.App alla versione più recente.

Update-Module -Name Az.App

Ora che l'estensione o il modulo corrente è installato, registrare gli spazi dei nomi Microsoft.App e Microsoft.OperationalInsights.

Bash
Azure PowerShell

az provider register --namespace Microsoft.App

az provider register --namespace Microsoft.OperationalInsights

Register-AzResourceProvider -ProviderNamespace Microsoft.App

Register-AzResourceProvider -ProviderNamespace Microsoft.OperationalInsights

Impostare le variabili di ambiente

Impostare le variabili di ambiente seguenti. Sostituire con i <PLACEHOLDERS> valori:

Bash
Azure PowerShell

RESOURCE_GROUP="<RESOURCE_GROUP>"
LOCATION="<LOCATION>"
CONTAINERAPPS_ENVIRONMENT="<CONTAINERAPPS_ENVIRONMENT>"

$ResourceGroupName = '<RESOURCE_GROUP>'
$Location = '<LOCATION>'
$ContainerAppsEnvironment = '<CONTAINERAPPS_ENVIRONMENT>'

Creare un gruppo di risorse di Azure

Creare un gruppo di risorse per organizzare i servizi correlati alla distribuzione dell'app contenitore.

Bash
Azure PowerShell

az group create \
  --name $RESOURCE_GROUP \
  --location "$LOCATION"

New-AzResourceGroup -Location $Location -Name $ResourceGroupName

Crea un ambiente

Un ambiente di App contenitore di Azure crea un limite sicuro intorno a un gruppo di app contenitore. Le app contenitore nello stesso ambiente vengono distribuite nella stessa rete virtuale e scrivono log nella stessa area di lavoro Log Analytics.

Per creare l'ambiente, eseguire il comando seguente:

Bash
Azure PowerShell

az containerapp env create \
  --name $CONTAINERAPPS_ENVIRONMENT \
  --resource-group $RESOURCE_GROUP \
  --location "$LOCATION"

Per l'ambiente App contenitore è necessaria un'area di lavoro Log Analytics. I comandi seguenti creano un'area di lavoro Log Analytics e salvano l'ID dell'area di lavoro e la chiave condivisa primaria nelle variabili di ambiente.

$WorkspaceArgs = @{
    Name = 'myworkspace'
    ResourceGroupName = $ResourceGroupName
    Location = $Location
    PublicNetworkAccessForIngestion = 'Enabled'
    PublicNetworkAccessForQuery = 'Enabled'
}
New-AzOperationalInsightsWorkspace @WorkspaceArgs
$WorkspaceId = (Get-AzOperationalInsightsWorkspace -ResourceGroupName $ResourceGroupName -Name $WorkspaceArgs.Name).CustomerId
$WorkspaceSharedKey = (Get-AzOperationalInsightsWorkspaceSharedKey -ResourceGroupName $ResourceGroupName -Name $WorkspaceArgs.Name).PrimarySharedKey

Per creare l'ambiente, eseguire il comando seguente:

$EnvArgs = @{
    EnvName = $ContainerAppsEnvironment
    ResourceGroupName = $ResourceGroupName
    Location = $Location
    AppLogConfigurationDestination = 'log-analytics'
    LogAnalyticConfigurationCustomerId = $WorkspaceId
    LogAnalyticConfigurationSharedKey = $WorkspaceSharedKey
}

New-AzContainerAppManagedEnv @EnvArgs

Creare un'app contenitore

Dopo aver creato un ambiente, è possibile distribuire la prima app contenitore.

Impostare le variabili di ambiente.

Sostituire con i <PLACEHOLDERS> valori. Il nome dell'entità utente sarà in genere nel formato di un indirizzo di posta elettronica , ad esempio username@domain.com.

Bash
Azure PowerShell

 CONTAINER_APP_NAME=my-container-app
 KEY_VAULT_NAME=my-key-vault
 USER_PRINCIPAL_NAME=<USER_PRINCIPAL_NAME>
 SECRET_NAME=my-secret-name
 CONTAINER_IMAGE_NAME=<CONTAINER_IMAGE_NAME>
 REGISTRY_SERVER=<REGISTRY_SERVER>
 REGISTRY_USERNAME=<REGISTRY_USERNAME>

 $ContainerAppName = "my-container-app"
 $KeyVaultName = "my-key-vault"
 $UserPrincipalName = "<USER_PRINCIPAL_NAME>"
 $SecretName = "my-secret-name"
 $ContainerImageName = "<CONTAINER_IMAGE_NAME>"
 $RegistryServer = "<REGISTRY_SERVER>"
 $RegistryUsername = "<REGISTRY_USERNAME>"

Creare l'insieme di credenziali delle chiavi.

L'archiviazione della password del registro contenitori tramite un servizio come Azure Key Vault mantiene sempre protetti i valori. I passaggi descritti in questa sezione illustrano come creare un insieme di credenziali delle chiavi, archiviare la password del registro contenitori nell'insieme di credenziali delle chiavi e quindi recuperare la password da usare nel codice.
- Bash
- Azure PowerShell
```
 az keyvault create --name $KEY_VAULT_NAME --resource-group $RESOURCE_GROUP
```
Installare il modulo Key Vault .
```
 Install-Module Az.KeyVault -Repository PSGallery -Force
```
```
 New-AzKeyVault -Name "$KeyVaultName" -ResourceGroupName "$ResourceGroupName" -Location "$Location"
```

Concedere all'account utente le autorizzazioni per gestire i segreti nell'insieme di credenziali delle chiavi.

Bash
Azure PowerShell

 KEY_VAULT_ID=$(az keyvault show --name $KEY_VAULT_NAME --query id --output tsv)
 az role assignment create --role "Key Vault Secrets Officer" --assignee "$USER_PRINCIPAL_NAME" --scope "$KEY_VAULT_ID"

 $KeyVault=Get-AzKeyVault -VaultName $KeyVaultName
 New-AzRoleAssignment -SignInName "$UserPrincipalName" -RoleDefinitionName "Key Vault Secrets Officer" -Scope $KeyVault.ResourceID

Archiviare la password del registro contenitori nell'insieme di credenziali delle chiavi.

Sostituire <REGISTRY_PASSWORD> con il valore.

Bash
Azure PowerShell

 az keyvault secret set --vault-name $KEY_VAULT_NAME --name $SECRET_NAME --value "<REGISTRY_PASSWORD>"

 $Secret = ConvertTo-SecureString -String "<REGISTRY_PASSWORD>" -AsPlainText -Force
 Set-AzKeyVaultSecret -VaultName "$KeyVaultName" -Name "$SecretName" -SecretValue "$Secret"

Recuperare la password del registro contenitori dall'insieme di credenziali delle chiavi.

Bash
Azure PowerShell

 REGISTRY_PASSWORD=$(az keyvault secret show --name $SECRET_NAME --vault-name $KEY_VAULT_NAME --query value --output tsv)

 $RegistryPassword = Get-AzKeyVaultSecret -VaultName "$KeyVaultName" -Name "$SecretName" -AsPlainText

Distribuire un'immagine del contenitore in App Azure Container.

Bash
Azure PowerShell

 az containerapp create \
   --name $CONTAINER_APP_NAME \
   --location $LOCATION \
   --resource-group $RESOURCE_GROUP \
   --image $CONTAINER_IMAGE_NAME \
   --environment $CONTAINERAPPS_ENVIRONMENT \
   --registry-server $REGISTRY_SERVER \
   --registry-username $REGISTRY_USERNAME \
   --registry-password $REGISTRY_PASSWORD

Se è stato abilitato l'ingresso nell'app contenitore, è possibile aggiungere --query properties.configuration.ingress.fqdn al create comando per restituire l'URL pubblico per l'applicazione.

 $EnvId = (Get-AzContainerAppManagedEnv -ResourceGroupName $ResourceGroupName -EnvName $ContainerAppsEnvironment).Id

 $TemplateObj = New-AzContainerAppTemplateObject -Name $ContainerAppName -Image $ContainerImageName

 $RegistrySecretObj = New-AzContainerAppSecretObject -Name $SecretName -Value $RegistryPassword

 $RegistryArgs = @{
 	PasswordSecretRef = $SecretName
 	Server = $RegistryServer
 	Username = $RegistryUsername
 }

 $RegistryObj = New-AzContainerAppRegistryCredentialObject @RegistryArgs

 $ContainerAppArgs = @{
 	Name = $ContainerAppName
 	Location = $Location
 	ResourceGroupName = $ResourceGroupName
 	ManagedEnvironmentId = $EnvId
 	TemplateContainer = $TemplateObj
 	ConfigurationRegistry = $RegistryObj
 	ConfigurationSecret = $RegistrySecretObj
 }

 New-AzContainerApp @ContainerAppArgs

Impostare le variabili di ambiente.

Bash
Azure PowerShell

 CONTAINER_APP_NAME=my-container-app
 CONTAINER_IMAGE_NAME=mcr.microsoft.com/k8se/quickstart:latest

 $ContainerAppName = "my-container-app"
 $ContainerImageName = "mcr.microsoft.com/k8se/quickstart:latest"

Distribuire un'immagine del contenitore in App Azure Container.

Bash
Azure PowerShell

 az containerapp create \
   --image $CONTAINER_IMAGE_NAME \
   --name $CONTAINER_APP_NAME \
   --resource-group $RESOURCE_GROUP \
   --environment $CONTAINERAPPS_ENVIRONMENT

Se è stato abilitato l'ingresso nell'app contenitore, è possibile aggiungere --query properties.configuration.ingress.fqdn al create comando per restituire l'URL pubblico per l'applicazione.

 $TemplateObj = New-AzContainerAppTemplateObject -Name $ContainerAppName  -Image $ContainerImageName

 $EnvId = (Get-AzContainerAppManagedEnv -ResourceGroupName $ResourceGroupName -EnvName $ContainerAppsEnvironment).Id

 $ContainerAppArgs = @{
 	Name = $ContainerAppName
 	Location = $Location
 	ResourceGroupName = $ResourceGroupName
 	ManagedEnvironmentId = $EnvId
 	TemplateContainer = $TemplateObj
 }

 New-AzContainerApp @ContainerAppArgs

Verificare la distribuzione

Per verificare la corretta distribuzione, è possibile eseguire una query sull'area di lavoro Log Analytics. Prima di poter eseguire query sui log, potrebbe essere necessario attendere alcuni minuti dopo la distribuzione affinché l'analisi arrivi per la prima volta. Questo dipende dalla registrazione della console implementata nell'app contenitore.

Usare i comandi seguenti per visualizzare i messaggi di log della console.

Bash
Azure PowerShell

LOG_ANALYTICS_WORKSPACE_CLIENT_ID=`az containerapp env show --name $CONTAINERAPPS_ENVIRONMENT --resource-group $RESOURCE_GROUP --query properties.appLogsConfiguration.logAnalyticsConfiguration.customerId --out tsv`

az monitor log-analytics query \
  --workspace $LOG_ANALYTICS_WORKSPACE_CLIENT_ID \
  --analytics-query "ContainerAppConsoleLogs_CL | where ContainerAppName_s == $CONTAINER_APP_NAME | project ContainerAppName_s, Log_s, TimeGenerated" \
  --out table

$queryResults = Invoke-AzOperationalInsightsQuery -WorkspaceId $WorkspaceId -Query "ContainerAppConsoleLogs_CL | where ContainerAppName_s == $ContainerAppName | project ContainerAppName_s, Log_s, TimeGenerated"
$queryResults.Results

Pulire le risorse

Se non si intende continuare a usare questa applicazione, eseguire il comando seguente per eliminare il gruppo di risorse insieme a tutte le risorse create in questa guida introduttiva.

Attenzione

Nell'esempio seguente, il gruppo di risorse specificato e tutte le risorse al suo interno vengono eliminati. Se nel gruppo di risorse specificato sono presenti anche risorse diverse da quelle usate in questa guida di avvio rapido, verranno eliminate.

Bash
Azure PowerShell

az group delete --name $RESOURCE_GROUP

Remove-AzResourceGroup -Name $ResourceGroupName -Force

Suggerimento

Problemi? Segnalare i problemi su GitHub aprendo un ticket nel repository App contenitore di Azure.

Passaggi successivi

Comunicazione tra microservizi

Condividi tramite