Riferimento allo schema del manifesto di distribuzione - AWS Elastic Beanstalk

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Riferimento allo schema del manifesto di distribuzione

Il manifesto di distribuzione è un file JSON che definisce in che modo Elastic Beanstalk deve distribuire e configurare le applicazioni Windows. Questa sezione fornisce un riferimento completo per tutte le proprietà e le opzioni di configurazione supportate nello schema del manifesto.

Struttura del manifesto

Il manifesto di distribuzione segue uno schema JSON specifico con la seguente struttura di primo livello:

Esempio Struttura del manifesto di base
{ "manifestVersion": 1, "skipIISReset": false, "iisConfig": { "appPools": [...] }, "deployments": { "msDeploy": [...], "aspNetCoreWeb": [...], "custom": [...] } }

Proprietà di primo livello

manifestVersion(richiesto)

Tipo: numero

Impostazione predefinita: 1

Valori validi: 1

Speciifica la versione dello schema del manifesto. Attualmente è supportata solo la versione 1.

skipIISReset (facoltativo)

Tipo: Booleano

Di default: false

Controlla se IIS viene ripristinato durante le distribuzioni delle applicazioni. Questo flag influisce su entrambi i tipi msDeploy di aspNetCoreWeb distribuzione.

Comportamento:

  • Non specificato o false (impostazione predefinita): le reimpostazioni di IIS vengono eseguite durante le operazioni di installazione, disinstallazione e aggiornamento. Questo è il comportamento tradizionale.

  • true: le reimpostazioni IIS vengono ignorate durante le operazioni di distribuzione.

Vantaggi:

  • Tempi di inattività ridotti: le applicazioni subiscono interruzioni del servizio più brevi durante le implementazioni.

  • Implementazioni più rapide: elimina il tempo necessario a IIS per riavviare e reinizializzare completamente IIS.

Nota

Durante l'utilizzoskipIISReset, l'RestartAppServeroperazione esegue un ripristino di IIS indipendentemente dall'impostazione di questa bandiera.

Esempio:

{ "manifestVersion": 1, "skipIISReset": true, "deployments": { "aspNetCoreWeb": [ { "name": "my-dotnet-core-app", "parameters": { "archive": "dotnet-core-app.zip", "iisPath": "/" } } ] } }
deployments(obbligatorio)

Tipo: oggetto

Contiene le configurazioni di distribuzione per le applicazioni. Questo oggetto può includere msDeploy e aspNetCoreWeb tipi di custom distribuzione.

iisConfig (facoltativo)

Tipo: oggetto

Definisce le impostazioni di configurazione IIS da applicare prima di distribuire le applicazioni. Attualmente supporta la configurazione del pool di applicazioni.

Configurazione IIS

La iisConfig sezione consente di configurare le impostazioni IIS prima di distribuire le applicazioni. Ciò è particolarmente utile per configurare pool di applicazioni con configurazioni specifiche.

Pool di applicazioni

I pool di applicazioni forniscono l'isolamento tra le applicazioni e consentono di configurare le impostazioni di runtime per gruppi di applicazioni.

Esempio Configurazione del pool di applicazioni
{ "iisConfig": { "appPools": [ { "name": "MyAppPool", "enable32Bit": false, "managedPipelineMode": "Integrated", "managedRuntimeVersion": "v4.0", "queueLength": 1000, "cpu": { "limitPercentage": 80, "limitAction": "Throttle", "limitMonitoringInterval": 5 }, "recycling": { "regularTimeInterval": 1440, "requestLimit": 10000, "memory": 1048576, "privateMemory": 524288 } } ] } }
Proprietà del pool di applicazioni
name(richiesto)

Tipo: stringa

Il nome del pool di applicazioni. Questo nome viene utilizzato per fare riferimento al pool nelle configurazioni di distribuzione.

enable32Bit (facoltativo)

Tipo: Booleano

Consente l'esecuzione di un'applicazione a 32 bit su una versione a 64 bit di Windows. Impostato su true per le applicazioni legacy che richiedono la compatibilità a 32 bit.

managedPipelineMode (facoltativo)

Tipo: stringa

Valori validi: «Integrato», «Classico»

Speciifica la modalità di elaborazione delle richieste per il pool di applicazioni.

managedRuntimeVersion (facoltativo)

Tipo: stringa

Valori validi: «No Managed Code», «v2.0", «v4.0"

Speciifica la versione.NET Framework per il pool di applicazioni.

queueLength (facoltativo)

Tipo: integer

Numero massimo di richieste che HTTP.sys mette in coda per il pool di applicazioni prima di rifiutare richieste aggiuntive.

Configurazione della CPU

L'cpuoggetto configura i limiti di utilizzo della CPU e il monitoraggio per il pool di applicazioni.

limitPercentage (facoltativo)

Tipo: numero

Percentuale massima di tempo di CPU che i processi di lavoro nel pool di applicazioni possono consumare.

limitAction (facoltativo)

Tipo: stringa

Valori validi: "NoAction«, «killW3WP», «Throttle», "» ThrottleUnderLoad

Azione da intraprendere quando viene raggiunto il limite della CPU.

limitMonitoringInterval (facoltativo)

Tipo: numero

Periodo di ripristino (in minuti) per il monitoraggio della CPU e i limiti di limitazione.

Configurazione del riciclaggio

L'recyclingoggetto configura quando e come i processi di lavoro del pool di applicazioni vengono riciclati.

regularTimeInterval (facoltativo)

Tipo: integer

Intervallo di tempo (in minuti) dopo il quale il pool di applicazioni viene riciclato. Impostare su 0 per disabilitare il riciclo basato sul tempo.

requestLimit (facoltativo)

Tipo: integer

Numero massimo di richieste elaborate dal pool di applicazioni prima del riciclaggio.

memory (facoltativo)

Tipo: integer

Quantità di memoria virtuale (in kilobyte) che attiva il riciclaggio dei processi di lavoro.

privateMemory (facoltativo)

Tipo: integer

Quantità di memoria privata (in kilobyte) che attiva il riciclaggio dei processi di lavoro.

Tipi di distribuzione

L'deploymentsoggetto contiene matrici di configurazioni di distribuzione per diversi tipi di applicazioni. Ogni tipo di distribuzione ha proprietà e casi d'uso specifici.

MSDeploy distribuzioni

MSDeploy le distribuzioni vengono utilizzate per le tradizionali applicazioni.NET Framework che possono essere distribuite utilizzando Web Deploy (). MSDeploy

Esempio MSDeploy configurazione di distribuzione
{ "deployments": { "msDeploy": [ { "name": "WebApp", "description": "Main web application", "parameters": { "appBundle": "webapp.zip", "iisPath": "/", "appPool": "DefaultAppPool" } } ] } }
MSDeploy proprietà di distribuzione
name(richiesto)

Tipo: stringa

Nome univoco per la distribuzione. Questo nome deve essere univoco in tutte le distribuzioni del manifesto.

description (facoltativo)

Tipo: stringa

Descrizione della distribuzione in formato leggibile dall'uomo.

parameters(richiesto)

Tipo: oggetto

Parametri di configurazione per l' MSDeploy operazione.

scripts (facoltativo)

Tipo: oggetto

PowerShell script da eseguire in varie fasi del ciclo di vita dell'implementazione.

MSDeploy parametri

appBundle(richiesto)

Tipo: stringa

Percorso del pacchetto dell'applicazione (file ZIP) relativo al file manifest. Questo pacchetto contiene i file dell'applicazione da distribuire.

iisPath (facoltativo)

Tipo: stringa

Predefinito: «/»

Percorso della directory virtuale in IIS in cui verrà distribuita l'applicazione. Usa «/» per il percorso principale o «/api» per una sottodirectory.

appPool (facoltativo)

Tipo: stringa

Nome del pool di applicazioni per eseguire questa applicazione.

Distribuzioni ASP.NET Core

Le distribuzioni ASP.NET Core sono progettate specificamente per le applicazioni.NET Core e.NET 5+.

Esempio Configurazione della distribuzione di ASP.NET Core
{ "deployments": { "aspNetCoreWeb": [ { "name": "CoreAPI", "description": "ASP.NET Core Web API", "parameters": { "appBundle": "coreapi.zip", "iisPath": "/api", "appPool": "CoreAppPool" } } ] } }

Le distribuzioni ASP.NET Core utilizzano la stessa struttura di proprietà delle MSDeploy distribuzioni, con la differenza fondamentale nell'ambiente di runtime e nel modello di hosting utilizzati per l'applicazione.

Parametri di distribuzione di ASP.NET Core
appBundle(richiesto)

Tipo: stringa

Percorso del bundle dell'applicazione relativo al file manifest. Può trattarsi di un archivio ZIP o di un percorso di directory contenente l'applicazione ASP.NET Core pubblicata.

iisPath (facoltativo)

Tipo: stringa

Predefinito: «/»

Percorso della directory virtuale in IIS per l'applicazione ASP.NET Core.

appPool (facoltativo)

Tipo: stringa

Pool di applicazioni per l'applicazione ASP.NET Core. Il pool verrà configurato in modo appropriato per l'hosting ASP.NET Core.

Distribuzioni personalizzate

Le distribuzioni personalizzate forniscono il controllo completo sul processo di distribuzione tramite script. PowerShell Questo tipo di distribuzione è utile per scenari complessi che richiedono installazione, configurazione o logica di distribuzione personalizzate.

Esempio Configurazione di distribuzione personalizzata
{ "deployments": { "custom": [ { "name": "CustomService", "description": "Custom Windows service deployment", "architecture": 32, "scripts": { "install": { "file": "install-service.ps1" }, "restart": { "file": "restart-service.ps1" }, "uninstall": { "file": "uninstall-service.ps1", "ignoreErrors": true } } } ] } }
Proprietà di distribuzione personalizzate
name(obbligatorio)

Tipo: stringa

Nome univoco per la distribuzione personalizzata.

description (facoltativo)

Tipo: stringa

Descrizione della distribuzione personalizzata.

architecture (facoltativo)

Tipo: integer

Valore predefinito: 32

Valori validi: 32, 64

Le specifiche di architettura per la modalità di esecuzione degli script PowerShell

scripts(richiesto)

Tipo: oggetto

PowerShell script che definiscono il comportamento di distribuzione. Le distribuzioni personalizzate supportano tipi di script aggiuntivi rispetto ad altri tipi di distribuzione.

Script di distribuzione

Gli script di distribuzione sono PowerShell script che vengono eseguiti in momenti specifici durante il ciclo di vita della distribuzione. Diversi tipi di distribuzione supportano diversi set di eventi di script.

Eventi di script

I seguenti eventi di script sono disponibili a seconda del tipo di distribuzione:

Script di distribuzione standard (MSDeploy e Web) aspNetCore
preInstall

Viene eseguito prima dell'installazione o dell'aggiornamento dell'applicazione.

postInstall

Viene eseguito dopo l'installazione o l'aggiornamento dell'applicazione.

preRestart

Viene eseguito prima del riavvio dell'applicazione.

postRestart

Viene eseguito dopo il riavvio dell'applicazione.

preUninstall

Viene eseguito prima della disinstallazione dell'applicazione.

postUninstall

Viene eseguito dopo la disinstallazione dell'applicazione.

Script di distribuzione personalizzati (solo distribuzioni personalizzate)
install

Script di installazione principale per distribuzioni personalizzate. Questo script è responsabile dell'installazione dell'applicazione o del servizio.

restart

Script per riavviare l'applicazione o il servizio. Chiamato al riavvio dell'ambiente.

uninstall

Script per disinstallare l'applicazione o il servizio. Chiamato durante la chiusura dell'ambiente o la rimozione dell'applicazione.

Proprietà dello script

Ogni script è definito come un oggetto con le seguenti proprietà:

file(obbligatorio)

Tipo: stringa

Percorso del file di PowerShell script relativo al file manifest. Lo script deve avere un'.ps1estensione.

ignoreErrors (facoltativo)

Tipo: Booleano

Di default: false

Se impostato sutrue, la distribuzione continua anche se lo script fallisce. Usalo per script non critici o operazioni di pulizia.

Esempio di configurazione dello script
{ "scripts": { "preInstall": { "file": "backup-config.ps1", "ignoreErrors": true }, "postInstall": { "file": "configure-app.ps1" } } }