Supporto per la distribuzione di Docker Compose in Azure Service Fabric

Docker usa il file docker-compose.yml per la definizione di applicazioni multi-contenitore. Per consentire ai clienti che hanno familiarità con Docker di orchestrare facilmente le applicazioni contenitore presenti in Azure Service Fabric, nella piattaforma è stato incluso il supporto nativo per la distribuzione Docker Compose, disponibile in anteprima. Service Fabric può accettare la versione 3 (o successiva) dei file docker-compose.yml.

Poiché questo supporto è disponibile in anteprima, è supportato solo un subset delle direttive Compose.

Per usare questa versione di anteprima, creare il cluster con la versione 5.7 o versione successiva del runtime di Service Fabric tramite il portale di Azure con l'SDK corrispondente.

Distribuire un file Docker Compose in Service Fabric

I comandi seguenti creano un'applicazione di Service Fabric, denominata fabric:/TestContainerApp, che è possibile monitorare e gestire analogamente a qualsiasi altra applicazione di Service Fabric. Per eseguire query sull'integrità, è possibile usare il nome dell'applicazione specificato. Service Fabric riconosce "DeploymentName" come identificatore della distribuzione Compose.

Utilizzare PowerShell

Creare una distribuzione Compose di Service Fabric da un file docker-compose.yml eseguendo il comando seguente in PowerShell:

New-ServiceFabricComposeDeployment -DeploymentName TestContainerApp -Compose docker-compose.yml [-RegistryUserName <>] [-RegistryPassword <>] [-PasswordEncrypted]

RegistryUserName e RegistryPassword fanno riferimento al nome utente e alla password del registro contenitori. Dopo aver completato la distribuzione, è possibile controllarne lo stato usando il comando seguente:

Get-ServiceFabricComposeDeploymentStatus -DeploymentName TestContainerApp

Per eliminare la distribuzione Compose tramite PowerShell, usare il comando seguente:

Remove-ServiceFabricComposeDeployment  -DeploymentName TestContainerApp

Per avviare un aggiornamento della distribuzione Compose tramite PowerShell, usare il comando seguente:

Start-ServiceFabricComposeDeploymentUpgrade -DeploymentName TestContainerApp -Compose docker-compose-v2.yml -Monitored -FailureAction Rollback

Per eseguire il rollback dell'aggiornamento della distribuzione Compose tramite PowerShell, usare il comando seguente:

Start-ServiceFabricComposeDeploymentRollback -DeploymentName TestContainerApp

Dopo l'accettazione dell'aggiornamento, è possibile tenere traccia del relativo stato di avanzamento con il comando seguente:

Get-ServiceFabricComposeDeploymentUpgrade -DeploymentName TestContainerApp

Usare l'interfaccia della riga di comando di Azure Service Fabric (sfctl)

In alternativa, è possibile usare il comando dell'interfaccia della riga di comando di Service Fabric seguente:

sfctl compose create --deployment-name TestContainerApp --file-path docker-compose.yml [ [ --user --encrypted-pass ] | [ --user --has-pass ] ] [ --timeout ]

Dopo aver creato la distribuzione, è possibile controllarne lo stato con il comando seguente:

sfctl compose status --deployment-name TestContainerApp [ --timeout ]

Per eliminare la distribuzione Compose, usare il comando seguente:

sfctl compose remove  --deployment-name TestContainerApp [ --timeout ]

Per avviare un aggiornamento della distribuzione Compose, usare il comando seguente:

sfctl compose upgrade --deployment-name TestContainerApp --file-path docker-compose-v2.yml [ [ --user --encrypted-pass ] | [ --user --has-pass ] ] [--upgrade-mode Monitored] [--failure-action Rollback] [ --timeout ]

Per eseguire il rollback dell'aggiornamento della distribuzione Compose, usare il comando seguente:

sfctl compose upgrade-rollback --deployment-name TestContainerApp [ --timeout ]

Dopo l'accettazione dell'aggiornamento, è possibile tenere traccia del relativo stato di avanzamento con il comando seguente:

sfctl compose upgrade-status --deployment-name TestContainerApp

Direttive Compose supportate

Questa versione di anteprima supporta un subset delle opzioni di configurazione a partire dal formato Compose versione 3, incluse le primitive seguenti:

• Services > Deploy > Replicas
• Services > Deploy > Placement > Constraints
• Services > Deploy > Resources > Limits
  • -cpu-shares
  • -memory
  • -memory-swap
• Services > Commands
• Services > Environment
• Services > Ports
• Services > Image
• Services > Isolation (solo per Windows)
• Services > Logging > Driver
• Services > Logging > Driver > Options
• Volume & Deploy > Volume

Configurare il cluster in modo da applicare i limiti delle risorse, come descritto in Governance delle risorse di Service Fabric. Tutte le altre direttive Docker Compose non sono supportate per questa versione di anteprima.

Sezione delle porte

Nella sezione delle porte che verrà usata dal listener del servizio di Service Fabric, specificare il protocollo http o https. Ciò garantisce che il protocollo di endpoint venga pubblicato correttamente con il Naming Service per consentire al proxy inverso di inoltrare le richieste:

• Per il routing a servizi Compose di Service Fabric non sicuri, specificare /http. Ad esempio, - "80:80/http".
• Per il routing a servizi Compose di Service Fabric sicuri, specificare /https. Ad esempio, - "443:443/https".

Calcolo di ServiceDnsName

Se il nome del servizio specificato nel file Compose è un nome di dominio completo (ovvero contiene un punto [.]), il nome DNS registrato da Service Fabric è <ServiceName>, incluso il punto. In caso contrario, ogni segmento di percorso nel nome dell'applicazione diventa un'etichetta di dominio nel nome DNS del servizio, con il primo segmento di percorso che diventa l'etichetta di dominio di primo livello.

Se, ad esempio, il nome specificato per l'applicazione è fabric:/SampleApp/MyComposeApp, il nome DNS registrato sarà <ServiceName>.MyComposeApp.SampleApp.

Distribuzione Compose (definizione di istanza) e modello di app di Service Fabric (definizione di tipo)

Un file docker-compose.yml descrive un set distribuibile di contenitori, incluse le relative proprietà e configurazioni. Il file può contenere, ad esempio, variabili di ambiente e porte. Nel file docker-compose.yml è possibile specificare anche i parametri di distribuzione, ad esempio i vincoli di posizionamento, i limiti delle risorse e i nomi DNS.

Il modello di applicazione di Service Fabric usa tipi di servizio e tipi di applicazione, in cui possono coesistere numerose istanze dell'applicazione dello stesso tipo. È possibile, ad esempio, che sia presente un'istanza dell'applicazione per ogni cliente. Questo modello basato sul tipo supporta più versioni dello stesso tipo di applicazione registrato con il runtime.

Il cliente A, ad esempio, può avere un'applicazione di cui è stata creata un'istanza con il tipo 1.0 di AppTypeA e il cliente B può avere un'altra applicazione di cui è stata creata un'istanza con lo stesso tipo e la stessa versione. I tipi di applicazione vengono definiti nei manifesti dell'applicazione e il nome dell'applicazione e i parametri di distribuzione vengono specificati al momento della creazione dell'applicazione.

Questo modello offre flessibilità, ma è previsto anche il supporto di un modello di distribuzione basato su istanze più semplice, in cui i tipi sono impliciti nel file manifesto. In questo modello, ogni applicazione ottiene il proprio manifesto indipendente. Questa funzionalità viene offerta in anteprima aggiungendo il supporto per docker-compose.yml, che è un formato di distribuzione basato su istanze.

Passaggi successivi

• Leggere le informazioni sul modello di applicazione di Service Fabric
• Introduzione all'interfaccia della riga di comando di Service Fabric