Amazon non CodeCatalyst è più aperta a nuovi clienti. I clienti esistenti possono continuare a utilizzare il servizio normalmente. Per ulteriori informazioni, consulta [Come migrare da CodeCatalyst](migration.md). 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à. # Azione «Distribuisci su Amazon ECS» YAML Di seguito è riportata la definizione YAML dell'azione **Deploy to Amazon ECS**. Per informazioni su come utilizzare questa azione, consulta. [Distribuzione su Amazon ECS con un flusso di lavoro](deploy-action-ecs.md) Questa definizione di azione esiste come sezione all'interno di un file di definizione del flusso di lavoro più ampio. Per ulteriori informazioni su questo file, consulta [Definizione YAML del flusso di lavoro](workflow-reference.md). **Nota** La maggior parte delle proprietà YAML che seguono hanno elementi dell'interfaccia utente corrispondenti nell'editor visivo. **Per cercare un elemento dell'interfaccia utente, usa Ctrl\$1F.** L'elemento verrà elencato con la proprietà YAML associata. ``` # The workflow definition starts here. # See Proprietà di primo livello for details. Name: MyWorkflow SchemaVersion: 1.0 Actions: # The action definition starts here. ECSDeployAction\$1nn: Identifier: aws/ecs-deploy@v1 DependsOn: - build-action Compute: Type: EC2 | Lambda Fleet: fleet-name Timeout: timeout-minutes Environment: Name: environment-name Connections: - Name: account-connection-name Role: iam-role-name Inputs: # Specify a source or an artifact, but not both. Sources: - source-name-1 Artifacts: - task-definition-artifact Configuration: region: us-east-1 cluster: ecs-cluster service: ecs-service task-definition: task-definition-path force-new-deployment: false|true codedeploy-appspec: app-spec-file-path codedeploy-application: application-name codedeploy-deployment-group: deployment-group-name codedeploy-deployment-description: deployment-description ``` ## ECSDeployAction (Obbligatorio) Specificare il nome dell'azione. Tutti i nomi delle azioni devono essere univoci all'interno del flusso di lavoro. I nomi delle azioni sono limitati a caratteri alfanumerici (a-z, A-Z, 0-9), trattini (-) e caratteri di sottolineatura (\$1). Gli spazi non sono consentiti. Non è possibile utilizzare le virgolette per abilitare caratteri e spazi speciali nei nomi delle azioni. Default: `ECSDeployAction_nn`. Interfaccia utente corrispondente: scheda di configurazione/nome visualizzato **dell'azione** ## Identifier (*ECSDeployAction*/**Identifier**) (Obbligatorio) Identifica l'azione. Non modificate questa proprietà a meno che non vogliate cambiare la versione. Per ulteriori informazioni, consulta [Specificare la versione dell'azione da utilizzare](workflows-action-versions.md). Default: `aws/ecs-deploy@v1`. **Interfaccia utente corrispondente: Workflow diagram/ ECSDeploy Action\$1NN/ aws/ecs-deploy @v1 label** ## DependsOn (*ECSDeployAction*/**DependsOn**) (Facoltativo) Specificare un'azione, un gruppo di azioni o un gate che deve essere eseguito correttamente per eseguire questa azione. Per ulteriori informazioni sulla funzionalità «dipende da», vedere. [Azioni di sequenziamento](workflows-depends-on.md) **Interfaccia utente corrispondente: scheda Input/Dipende da - opzionale** ## Compute (*ECSDeployAction*/**Compute**) (Facoltativo) Il motore di calcolo utilizzato per eseguire le azioni del flusso di lavoro. È possibile specificare l'elaborazione a livello di flusso di lavoro o a livello di azione, ma non entrambi. Se specificata a livello di flusso di lavoro, la configurazione di calcolo si applica a tutte le azioni definite nel flusso di lavoro. A livello di flusso di lavoro, puoi anche eseguire più azioni sulla stessa istanza. Per ulteriori informazioni, consulta [Condivisione dell'elaborazione tra le azioni](compute-sharing.md). Interfaccia utente corrispondente: *nessuna* ## Type (*ECSDeployAction*/Compute/**Type**) (Richiesto [Compute](#deploy.action.ecs.computename) se incluso) Il tipo di motore di calcolo. È possibile utilizzare uno dei seguenti valori: + **EC2** (editor visivo) o `EC2` (editor YAML) Ottimizzato per la flessibilità durante le operazioni. + **Lambda** (editor visivo) o `Lambda` (editor YAML) Velocità di avvio delle azioni ottimizzate. Per ulteriori informazioni sui tipi di calcolo, consulta [Tipi di calcolo](workflows-working-compute.md#compute.types). **Interfaccia utente corrispondente: configurazione tab/Advanced : opzionale/tipo di calcolo** ## Fleet (*ECSDeployAction*/Compute/**Fleet**) (Facoltativo) Specificate la macchina o il parco macchine che eseguiranno il flusso di lavoro o le azioni del flusso di lavoro. Con le flotte on-demand, all'avvio di un'azione, il flusso di lavoro fornisce le risorse necessarie e le macchine vengono distrutte al termine dell'azione. Esempi di flotte on-demand:,. `Linux.x86-64.Large` `Linux.x86-64.XLarge` Per ulteriori informazioni sulle flotte on-demand, vedere. [Proprietà del parco istanze on demand](workflows-working-compute.md#compute.on-demand) Con le flotte assegnate, puoi configurare una serie di macchine dedicate per eseguire le azioni del flusso di lavoro. Queste macchine rimangono inattive, pronte a elaborare immediatamente le azioni. Per ulteriori informazioni sulle flotte rifornite, vedere. [Proprietà del parco istanze con provisioning](workflows-working-compute.md#compute.provisioned-fleets) Se `Fleet` viene omesso, l'impostazione predefinita è. `Linux.x86-64.Large` **Interfaccia utente corrispondente: Configurazione tab/Advanced : parco opzionale/di calcolo** ## Timeout (*ECSDeployAction*/**Timeout**) (Facoltativo) Specificate il periodo di tempo, in minuti (editor YAML) o in ore e minuti (editor visivo), che l'azione può essere eseguita prima che termini l'azione. CodeCatalyst Il minimo è 5 minuti e il massimo è descritto in. [Quote per i flussi di lavoro in CodeCatalyst](workflows-quotas.md) Il timeout predefinito è lo stesso del timeout massimo. **Interfaccia utente corrispondente: scheda di configurazione/timeout - opzionale** ## Environment (*ECSDeployAction*/**Environment**) (Obbligatorio) Specificare l' CodeCatalyst ambiente da utilizzare con l'azione. L'azione si connette Account AWS all'Amazon VPC opzionale specificato nell'ambiente scelto. L'azione utilizza il ruolo IAM predefinito specificato nell'ambiente per connettersi a e utilizza il ruolo IAM specificato nella [connessione Amazon VPC](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-vpcs.add.html) per connettersi ad Amazon VPC. Account AWS **Nota** Se il ruolo IAM predefinito non dispone delle autorizzazioni richieste dall'azione, puoi configurare l'azione per utilizzare un ruolo diverso. Per ulteriori informazioni, consulta [Modifica del ruolo IAM di un'azione](deploy-environments-switch-role.md). Per ulteriori informazioni sugli ambienti, consulta [Implementazione in e Account AWS VPCs](deploy-environments.md) e[Creazione di un ambiente](deploy-environments-creating-environment.md). **Interfaccia utente corrispondente: scheda di configurazione/ambiente** ## Name (*ECSDeployAction*/Environment/**Name**) (Richiesto se [Environment](#deploy.action.ecs.environment) incluso) Specificate il nome di un ambiente esistente che desiderate associare all'azione. **Interfaccia utente corrispondente: scheda di configurazione/ambiente** ## Connections (*ECSDeployAction*/Environment/**Connections**) (Facoltativo nelle versioni più recenti dell'azione; richiesto nelle versioni precedenti) Specificare la connessione dell'account da associare all'azione. È possibile specificare al massimo una connessione a un account in`Environment`. Se non si specifica una connessione all'account: + L'azione utilizza la Account AWS connessione e il ruolo IAM predefinito specificati nell'ambiente della CodeCatalyst console. Per informazioni sull'aggiunta di una connessione all'account e del ruolo IAM predefinito all'ambiente, consulta[Creazione di un ambiente](deploy-environments-creating-environment.md). + Il ruolo IAM predefinito deve includere le policy e le autorizzazioni richieste dall'azione. Per determinare quali sono tali politiche e autorizzazioni, consulta la descrizione della proprietà **Role nella documentazione** sulla definizione YAML dell'azione. Per ulteriori informazioni sulle connessioni degli account, vedere. [Consentire l'accesso alle AWS risorse con connessione Account AWS](ipa-connect-account.md) Per informazioni sull'aggiunta di una connessione tramite account a un ambiente, vedere[Creazione di un ambiente](deploy-environments-creating-environment.md). Interfaccia utente corrispondente: una delle seguenti a seconda della versione dell'azione: + (Versioni più recenti) tab/Environment/What La configurazione è attiva? *my-environment* **/three dot menu/ Cambia ruolo** + **(Versioni precedenti) Scheda di configurazione/' '/ connessione all'account Environment/account/role AWS ** ## Name (*ECSDeployAction*/Environment/Connections/**Name**) (Richiesto se incluso[Connections](#deploy.action.ecs.environment.connections)) Specificare il nome della connessione all'account. Interfaccia utente corrispondente: una delle seguenti a seconda della versione dell'azione: + (Versioni più recenti) tab/Environment/What La configurazione è attiva? *my-environment* **/three dot menu/ Cambia ruolo** + **(Versioni precedenti) Scheda di configurazione/' '/ connessione all'account Environment/account/role AWS ** ## Role (*ECSDeployAction*/Environment/Connections/**Role**) (Richiesto se incluso[Connections](#deploy.action.ecs.environment.connections)) Specificare il nome del ruolo IAM a cui l'azione **Deploy to Amazon ECS** utilizza per accedere. AWS Assicurati di aver [aggiunto il ruolo al tuo CodeCatalyst spazio](ipa-connect-account-addroles.md) e che il ruolo includa le seguenti politiche. Se non specifichi un ruolo IAM, l'azione utilizza il ruolo IAM predefinito elencato nell'[ambiente](deploy-environments.md) nella CodeCatalyst console. Se utilizzi il ruolo predefinito nell'ambiente, assicurati che abbia le seguenti politiche. + La seguente politica di autorizzazioni: **avvertimento** Limita le autorizzazioni a quelle mostrate nella seguente politica. L'utilizzo di un ruolo con autorizzazioni più ampie potrebbe rappresentare un rischio per la sicurezza. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [{ "Action":[ "ecs:DescribeServices", "ecs:CreateTaskSet", "ecs:DeleteTaskSet", "ecs:ListClusters", "ecs:RegisterTaskDefinition", "ecs:UpdateServicePrimaryTaskSet", "ecs:UpdateService", "elasticloadbalancing:DescribeTargetGroups", "elasticloadbalancing:DescribeListeners", "elasticloadbalancing:ModifyListener", "elasticloadbalancing:DescribeRules", "elasticloadbalancing:ModifyRule", "lambda:InvokeFunction", "lambda:ListFunctions", "cloudwatch:DescribeAlarms", "sns:Publish", "sns:ListTopics", "s3:GetObject", "s3:GetObjectVersion", "codedeploy:CreateApplication", "codedeploy:CreateDeployment", "codedeploy:CreateDeploymentGroup", "codedeploy:GetApplication", "codedeploy:GetDeployment", "codedeploy:GetDeploymentGroup", "codedeploy:ListApplications", "codedeploy:ListDeploymentGroups", "codedeploy:ListDeployments", "codedeploy:StopDeployment", "codedeploy:GetDeploymentTarget", "codedeploy:ListDeploymentTargets", "codedeploy:GetDeploymentConfig", "codedeploy:GetApplicationRevision", "codedeploy:RegisterApplicationRevision", "codedeploy:BatchGetApplicationRevisions", "codedeploy:BatchGetDeploymentGroups", "codedeploy:BatchGetDeployments", "codedeploy:BatchGetApplications", "codedeploy:ListApplicationRevisions", "codedeploy:ListDeploymentConfigs", "codedeploy:ContinueDeployment" ], "Resource":"*", "Effect":"Allow" },{"Action":[ "iam:PassRole" ], "Effect":"Allow", "Resource":"*", "Condition":{"StringLike":{"iam:PassedToService":[ "ecs-tasks.amazonaws.com", "codedeploy.amazonaws.com" ] } } }] } ``` ------ **Nota** La prima volta che il ruolo viene utilizzato, utilizza il seguente carattere jolly nell'informativa sulla politica delle risorse, quindi definisci la politica inserendo il nome della risorsa dopo che è disponibile. ``` "Resource": "*" ``` + La seguente politica di fiducia personalizzata: **Nota** Puoi usare il `CodeCatalystWorkflowDevelopmentRole-spaceName` ruolo con questa azione, se lo desideri. Per ulteriori informazioni su questo ruolo, consulta [Creazione del **CodeCatalystWorkflowDevelopmentRole-*spaceName***ruolo per il tuo account e il tuo spazio](ipa-iam-roles.md#ipa-iam-roles-service-create). Tieni presente che il `CodeCatalystWorkflowDevelopmentRole-spaceName` ruolo dispone di autorizzazioni di accesso complete, il che può rappresentare un rischio per la sicurezza. Ti consigliamo di utilizzare questo ruolo solo in tutorial e scenari in cui la sicurezza è meno preoccupante. Interfaccia utente corrispondente: una delle seguenti a seconda della versione di azione: + (Versioni più recenti) tab/Environment/What La configurazione è attiva? *my-environment* **/three dot menu/ Cambia ruolo** + **(Versioni precedenti) Scheda di configurazione/' '/ Ruolo Environment/account/role** ## Inputs (*ECSDeployAction*/**Inputs**) (Facoltativo) La `Inputs` sezione definisce i dati `ECSDeployAction` necessari durante l'esecuzione di un flusso di lavoro. **Nota** È consentito un solo input (fonte o artefatto) per azione **Deploy to Amazon ECS**. **Interfaccia utente corrispondente: scheda Input** ## Sources (*ECSDeployAction*/Inputs/**Sources**) (Richiesto se il file di definizione delle attività è archiviato in un repository di origine) Se il file di definizione delle attività è archiviato in un repository di origine, specifica l'etichetta di tale repository di origine. Attualmente, l'unica etichetta supportata è. `WorkflowSource` Se il file di definizione dell'attività non è contenuto in un repository di origine, deve risiedere in un artefatto generato da un'altra azione. Per ulteriori informazioni sulle origini, consulta [Connessione degli archivi di origine ai flussi di lavoro](workflows-sources.md). **Interfaccia utente corrispondente: scheda Input/Sources - opzionale** ## Artifacts - input (*ECSDeployAction*/Inputs/**Artifacts**) (Richiesto se il file di definizione dell'attività è memorizzato in un elemento [di output di un'azione precedente](workflows-working-artifacts-output.md)) Se il file di definizione dell'attività che desideri distribuire è contenuto in un artefatto generato da un'azione precedente, specifica l'artefatto qui. Se il file di definizione dell'attività non è contenuto in un artefatto, deve risiedere nel repository di origine. Per ulteriori informazioni sugli artefatti, inclusi esempi, vedere. [Condivisione di artefatti e file tra azioni](workflows-working-artifacts.md) **Interfaccia utente corrispondente: scheda di configurazione/artefatti - opzionale** ## Configuration (*ECSDeployAction*/**Configuration**) (Obbligatorio) Una sezione in cui è possibile definire le proprietà di configurazione dell'azione. Interfaccia utente corrispondente: scheda **Configurazione** ## region (Configuration/**region**) (Obbligatorio) Specificare la AWS regione in cui risiedono il cluster e il servizio Amazon ECS. Per un elenco dei codici regionali, consulta [Endpoint regionali](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints) nel. *Riferimenti generali di AWS* **Interfaccia utente corrispondente: scheda/regione di configurazione** ## cluster (*ECSDeployAction*/Configuration/**cluster**) (Obbligatorio) Specificare il nome di un cluster Amazon ECS esistente. L'azione **Deploy to Amazon ECS** distribuirà la tua applicazione containerizzata come attività in questo cluster. Per ulteriori informazioni sui cluster Amazon ECS, consulta [Clusters](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/Welcome.html#welcome-clusters) nella *Amazon Elastic Container Service* Developer Guide. **Interfaccia utente corrispondente: scheda Configurazione/Cluster** ## service (*ECSDeployAction*/Configuration/**service**) (Obbligatorio) Specificare il nome di un servizio Amazon ECS esistente che creerà un'istanza del file di definizione delle attività. Questo servizio deve risiedere nel cluster specificato nel campo. `cluster` Per ulteriori informazioni sui servizi Amazon ECS, consulta i servizi [Amazon ECS](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs_services.html) nella *Amazon Elastic Container Service Developer Guide*. **Interfaccia utente corrispondente: scheda di configurazione/servizio** ## task-definition (*ECSDeployAction*/Configuration/**task-definition**) (Obbligatorio) Specificare il percorso di un file di definizione delle attività esistente. Se il file si trova nel repository di origine, il percorso è relativo alla cartella principale del repository di origine. Se il file si trova in un elemento di un'azione precedente del flusso di lavoro, il percorso è relativo alla cartella principale dell'elemento. Per ulteriori informazioni sui file di definizione delle attività, consulta [Definizioni delle attività](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/Welcome.html#welcome-task-definitions) nella *Amazon Elastic Container Service Developer Guide*. Interfaccia utente corrispondente: scheda di configurazione/definizione dell'**attività** ## force-new-deployment (*ECSDeployAction*/Configuration/**force-new-deployment**) (Obbligatorio) Se abilitato, il servizio Amazon ECS è in grado di avviare nuove distribuzioni senza modifiche alla definizione del servizio. Forzare una distribuzione fa sì che il servizio interrompa tutte le attività attualmente in esecuzione e avvii nuove attività. Per ulteriori informazioni su come forzare nuove distribuzioni, consulta [Updating a service](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/update-service.html) nella *Amazon Elastic Container Service Developer Guide*. Impostazione predefinita: `false` Interfaccia utente corrispondente: scheda Configurazione/ **Forza una nuova distribuzione** del servizio ## codedeploy-appspec (*ECSDeployAction*/Configuration/**codedeploy-appspec**) (Obbligatorio se hai configurato il servizio Amazon ECS per utilizzare le blue/green distribuzioni, altrimenti omettilo) Specificare il nome e il percorso di un file di specifiche CodeDeploy dell'applicazione () esistente. AppSpec Questo file deve risiedere nella directory principale del repository di CodeCatalyst origine. Per ulteriori informazioni sui AppSpec file, consultate i file [delle specifiche CodeDeploy dell'applicazione (AppSpec) nella Guida](https://docs.aws.amazon.com/codedeploy/latest/userguide/application-specification-files.html) per l'*AWS CodeDeploy utente*. **Nota** Fornisci CodeDeploy informazioni solo se hai configurato il servizio Amazon ECS per eseguire blue/green distribuzioni. Per le distribuzioni di aggiornamento in sequenza (impostazione predefinita), ometti le informazioni. CodeDeploy Per ulteriori informazioni sulle distribuzioni di Amazon ECS, consulta i tipi di [distribuzione di Amazon ECS nella](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/deployment-types.html) *Amazon Elastic Container* Service Developer Guide. **Nota** I **CodeDeploy**campi possono essere nascosti nell'editor visuale. Per farli apparire, vedi[Perché mancano CodeDeploy dei campi nell'editor visivo?](troubleshooting-workflows.md#troubleshooting-workflows-codedeploy). Interfaccia utente corrispondente: scheda Configurazione/ **CodeDeploy AppSpec** ## codedeploy-application (*ECSDeployAction*/Configuration/**codedeploy-application**) (Richiesto se `codedeploy-appspec` incluso) Specificate il nome di un' CodeDeploy applicazione esistente. Per ulteriori informazioni sulle CodeDeploy applicazioni, vedere [Lavorare con le applicazioni CodeDeploy nella](https://docs.aws.amazon.com/codedeploy/latest/userguide/applications.html) *Guida per l'AWS CodeDeploy utente*. **Interfaccia utente corrispondente: scheda di configurazione/applicazione CodeDeploy ** ## codedeploy-deployment-group (*ECSDeployAction*/Configuration/**codedeploy-deployment-group**) (Richiesto se `codedeploy-appspec` incluso) Specificare il nome di un gruppo CodeDeploy di distribuzione esistente. Per ulteriori informazioni sui gruppi di CodeDeploy distribuzione, vedere [Lavorare con i gruppi di distribuzione CodeDeploy nella](https://docs.aws.amazon.com/codedeploy/latest/userguide/deployment-groups.html) *Guida per l'AWS CodeDeploy utente*. Interfaccia utente corrispondente: scheda di configurazione/gruppo **CodeDeploy di distribuzione** ## codedeploy-deployment-description (*ECSDeployAction*/Configuration/**codedeploy-deployment-description**) (Facoltativo) Specificare una descrizione della distribuzione che verrà creata con questa azione. Per ulteriori informazioni, consulta [Lavorare con le distribuzioni CodeDeploy nella Guida](https://docs.aws.amazon.com/codedeploy/latest/userguide/deployments.html) per l'*AWS CodeDeploy utente*. **Interfaccia utente corrispondente: scheda di configurazione/descrizione della distribuzione CodeDeploy **