Avviso di fine del supporto: il 7 ottobre 2026, AWS terminerà il supporto per AWS Proton. Dopo il 7 ottobre 2026, non potrai più accedere alla AWS Proton console o AWS Proton alle risorse. L'infrastruttura implementata rimarrà intatta. Per ulteriori informazioni, consulta [AWS Proton Service Deprecation](https://docs.aws.amazon.com/proton/latest/userguide/proton-end-of-support.html) and Migration Guide.
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à.
# Aggiornare un ambiente
Se l' AWS Proton ambiente è associato a una connessione con un account di ambiente, *non* aggiornare né includere il `protonServiceRoleArn` parametro per aggiornare o connettersi a una connessione a un account di ambiente.
È possibile eseguire l'aggiornamento a una nuova connessione all'account di ambiente solo se sono soddisfatte entrambe le seguenti condizioni:
+ La connessione all'account di ambiente è stata creata nello stesso account di ambiente in cui è stata creata la connessione all'account di ambiente corrente.
+ >La connessione all'account di ambiente è associata all'ambiente corrente.
Se l'ambiente *non è* associato a una connessione all'account di ambiente, *non* aggiornare o includere il `environmentAccountConnectionId` parametro.
È possibile aggiornare il `protonServiceRoleArn` parametro e il valore `environmentAccountConnectionId` o. Non puoi aggiornare entrambi.
Se il tuo ambiente utilizza il provisioning autogestito, *non* aggiornare il `provisioning-repository` parametro e *ometti* i `environmentAccountConnectionId` parametri and. `protonServiceRoleArn`
Esistono quattro modalità per aggiornare un ambiente, come descritto nell'elenco seguente. Quando si utilizza AWS CLI, il `deployment-type` campo definisce la modalità. Quando si utilizza la console, queste modalità sono mappate alle azioni **Modifica**, **Aggiorna****, Aggiorna secondarie** e **Aggiorna principali** che si trovano in **Azioni**.
`NONE`
In questa modalità, *non* si verifica una distribuzione. Vengono aggiornati solo i parametri dei metadati richiesti.
`CURRENT_VERSION`
In questa modalità, l'ambiente viene distribuito e aggiornato con le nuove specifiche fornite dall'utente. Vengono aggiornati solo i parametri richiesti. *Non* includere i parametri della versione minore o principale quando lo usi`deployment-type`.
`MINOR_VERSION`
In questa modalità, l'ambiente viene distribuito e aggiornato con la versione secondaria pubblicata, consigliata (più recente) della versione principale corrente in uso per impostazione predefinita. È inoltre possibile specificare una versione secondaria diversa della versione principale corrente in uso.
`MAJOR_VERSION`
In questa modalità, l'ambiente viene distribuito e aggiornato con la versione principale e secondaria pubblicata, consigliata (più recente) del modello corrente per impostazione predefinita. È inoltre possibile specificare una versione principale diversa che sia superiore alla versione principale in uso e una versione secondaria (opzionale).
**Topics**
+ [Aggiornare un ambiente di provisioning AWS gestito](#ag-env-std-update)
+ [Aggiornare un ambiente di provisioning autogestito](#ag-env-pr-update)
+ [Annullare l'implementazione di un ambiente in corso](#ag-env-cancel)
## Aggiornare un ambiente di provisioning AWS gestito
Il provisioning standard è supportato solo dagli ambienti che forniscono con. CloudFormation
**Usa la console o AWS CLI per aggiornare il tuo ambiente.**
------
#### [ Console di gestione AWS ]
**Aggiorna un ambiente utilizzando la console come illustrato nei passaggi seguenti.**
1.
**Scegli uno dei 2 passaggi seguenti.**
1.
**Nell'elenco degli ambienti.**
1. Nella [AWS Proton console](https://console.aws.amazon.com//proton/), scegli **Ambienti**.
1. Nell'elenco degli ambienti, scegli il pulsante di opzione a sinistra dell'ambiente che desideri aggiornare.
1.
****Nella pagina dei dettagli dell'ambiente della console.****
1. Nella [AWS Proton console](https://console.aws.amazon.com//proton/), scegli **Ambienti**.
1. Nell'elenco degli ambienti, scegli il nome dell'ambiente che desideri aggiornare.
1.
**Scegli uno dei 4 passaggi successivi per aggiornare l'ambiente.**
1.
**Per apportare una modifica che non richieda la distribuzione nell'ambiente.**
1. Ad esempio, per modificare una descrizione.
Scegli **Modifica**.
1. Compila il modulo e scegli **Avanti**.
1. Controlla la modifica e scegli **Aggiorna**.
1.
**Per aggiornare solo gli input dei metadati.**
1. **Scegli **Azioni** e poi Aggiorna.**
1. Compila il modulo e scegli **Modifica**.
1. Compila i moduli e scegli **Avanti** fino a raggiungere la pagina di **revisione**.
1. Controlla gli aggiornamenti e scegli **Aggiorna**.
1.
**Per effettuare un aggiornamento a una nuova versione secondaria del relativo modello di ambiente.**
1. Scegli **Azioni** e poi **Aggiorna secondario**.
1. Compila il modulo e scegli **Avanti**.
1. Compila i moduli e scegli **Avanti** fino a raggiungere la pagina di **revisione**.
1. Controlla gli aggiornamenti e scegli **Aggiorna**.
1.
**Per effettuare un aggiornamento a una nuova versione principale del relativo modello di ambiente.**
1. Scegli **Azioni** e poi **Aggiorna principale**.
1. Compila il modulo e scegli **Avanti**.
1. Compila i moduli e scegli **Avanti** fino a raggiungere la pagina di **revisione**.
1. Controlla gli aggiornamenti e scegli **Aggiorna**.
------
#### [ AWS CLI ]
**Usa il AWS Proton AWS CLI per aggiornare un ambiente a una nuova versione secondaria.**
Esegui il comando seguente per aggiornare l'ambiente:
```
$ aws proton update-environment \
--name "MySimpleEnv" \
--deployment-type "MINOR_VERSION" \
--template-major-version "1" \
--template-minor-version "1" \
--proton-service-role-arn arn:aws:iam::123456789012:role/service-role/ProtonServiceRole \
--spec "file:///spec.yaml"
```
Risposta:
```
{
"environment": {
"arn": "arn:aws:proton:region-id:123456789012:environment/MySimpleEnv",
"createdAt": "2021-04-02T17:29:55.472000+00:00",
"deploymentStatus": "IN_PROGRESS",
"lastDeploymentAttemptedAt": "2021-04-02T17:48:26.307000+00:00",
"lastDeploymentSucceededAt": "2021-04-02T17:29:55.472000+00:00",
"name": "MySimpleEnv",
"protonServiceRoleArn": "arn:aws:iam::123456789012:role/service-role/ProtonServiceRole",
"templateMajorVersion": "1",
"templateMinorVersion": "0",
"templateName": "simple-env"
}
}
```
Esegui il comando seguente per ottenere e confermare lo stato:
```
$ aws proton get-environment \
--name "MySimpleEnv"
```
Risposta:
```
{
"environment": {
"arn": "arn:aws:proton:region-id:123456789012:environment/MySimpleEnv",
"createdAt": "2021-04-02T17:29:55.472000+00:00",
"deploymentStatus": "SUCCEEDED",
"environmentName": "MySimpleEnv",
"lastDeploymentAttemptedAt": "2021-04-02T17:48:26.307000+00:00",
"lastDeploymentSucceededAt": "2021-04-02T17:48:26.307000+00:00",
"protonServiceRoleArn": "arn:aws:iam::123456789012:role/service-role/ProtonServiceRole",
"spec": "proton: EnvironmentSpec\n\nspec:\n my_sample_input: hello\n my_other_sample_input: everybody\n",
"templateMajorVersion": "1",
"templateMinorVersion": "1",
"templateName": "simple-env"
}
}
```
------
## Aggiornare un ambiente di provisioning autogestito
Il provisioning autogestito è supportato solo dagli ambienti che utilizzano Terraform.
**Usa la console o AWS CLI per aggiornare il tuo ambiente.**
------
#### [ Console di gestione AWS ]
**Aggiorna un ambiente utilizzando la console come illustrato nei passaggi seguenti.**
1.
**Scegli uno dei 2 passaggi seguenti.**
1.
**Nell'elenco degli ambienti.**
1. Nella [AWS Proton console](https://console.aws.amazon.com//proton/), scegli **Ambienti**.
1. Nell'elenco degli ambienti, scegli il pulsante di opzione a sinistra del modello di ambiente che desideri aggiornare.
1.
****Nella pagina dei dettagli dell'ambiente della console.****
1. Nella [AWS Proton console](https://console.aws.amazon.com//proton/), scegli **Ambienti**.
1. Nell'elenco degli ambienti, scegli il nome dell'ambiente che desideri aggiornare.
1.
**Scegli uno dei 4 passaggi successivi per aggiornare l'ambiente.**
1.
**Per apportare una modifica che non richieda la distribuzione nell'ambiente.**
1. Ad esempio, per modificare una descrizione.
Scegli **Modifica**.
1. Compila il modulo e scegli **Avanti**.
1. Controlla la modifica e scegli **Aggiorna**.
1.
**Per aggiornare solo gli input dei metadati.**
1. **Scegli **Azioni** e poi Aggiorna.**
1. Compila il modulo e scegli **Modifica**.
1. Compila i moduli e scegli **Avanti** fino a raggiungere la pagina di **revisione**.
1. Controlla gli aggiornamenti e scegli **Aggiorna**.
1.
**Per effettuare un aggiornamento a una nuova versione secondaria del relativo modello di ambiente.**
1. Scegli **Azioni** e poi **Aggiorna secondario**.
1. Compila il modulo e scegli **Avanti**.
1. Compila i moduli e scegli **Avanti** fino a raggiungere la pagina di **revisione**.
1. Controlla gli aggiornamenti e scegli **Aggiorna**.
1.
**Per effettuare un aggiornamento a una nuova versione principale del relativo modello di ambiente.**
1. Scegli **Azioni** e poi **Aggiorna principale**.
1. Compila il modulo e scegli **Avanti**.
1. Compila i moduli e scegli **Avanti** fino a raggiungere la pagina di **revisione**.
1. Controlla gli aggiornamenti e scegli **Aggiorna**.
------
#### [ AWS CLI ]
**Usa il AWS CLI per aggiornare un ambiente Terraform a una nuova versione minore con provisioning autogestito.**
1. Esegui il seguente comando per aggiornare il tuo ambiente:
```
$ aws proton update-environment \
--name "pr-environment" \
--deployment-type "MINOR_VERSION" \
--template-major-version "1" \
--template-minor-version "1" \
--provisioning-repository "branch=main,name=myrepos/env-repo,provider=GITHUB" \
--spec "file://env-spec-mod.yaml"
```
Risposta:
```
{
"environment": {
"arn": "arn:aws:proton:region-id:123456789012:environment/pr-environment",
"createdAt": "2021-11-18T21:09:15.745000+00:00",
"deploymentStatus": "IN_PROGRESS",
"lastDeploymentAttemptedAt": "2021-11-18T21:25:41.998000+00:00",
"lastDeploymentSucceededAt": "2021-11-18T21:09:15.745000+00:00",
"name": "pr-environment",
"provisioningRepository": {
"arn": "arn:aws:proton:region-id:123456789012:repository/github:myrepos/env-repo",
"branch": "main",
"name": "myrepos/env-repo",
"provider": "GITHUB"
},
"templateMajorVersion": "1",
"templateMinorVersion": "0",
"templateName": "pr-env-template"
}
}
```
1. Esegui il comando seguente per ottenere e confermare lo stato:
```
$ aws proton get-environment \
--name "pr-environment"
```
Risposta:
```
{
"environment": {
"arn": "arn:aws:proton:region-id:123456789012:environment/pr-environment",
"createdAt": "2021-11-18T21:09:15.745000+00:00",
"deploymentStatus": "SUCCEEDED",
"lastDeploymentAttemptedAt": "2021-11-18T21:25:41.998000+00:00",
"lastDeploymentSucceededAt": "2021-11-18T21:25:41.998000+00:00",
"name": "pr-environment",
"provisioningRepository": {
"arn": "arn:aws:proton:region-id:123456789012:repository/github:myrepos/env-repo",
"branch": "main",
"name": "myrepos/env-repo",
"provider": "GITHUB"
},
"spec": "proton: EnvironmentSpec\nspec:\n ssm_parameter_value: \"test\"\n ssm_another_parameter_value: \"update\"\n",
"templateMajorVersion": "1",
"templateMinorVersion": "1",
"templateName": "pr-env-template"
}
}
```
1. Controlla la pull request che è stata inviata da AWS Proton.
+ Se approvi la richiesta, il provisioning è in corso.
+ Se si rifiuta la richiesta, la creazione dell'ambiente viene annullata.
+ Se la richiesta pull scade, la creazione dell'ambiente non è completa.
1. Fornisci lo stato di approvvigionamento a. AWS Proton
```
$ aws proton notify-resource-deployment-status-change \
--resource-arn "arn:aws:proton:region-id:123456789012:environment/pr-environment" \
--status "SUCCEEDED"
```
------
## Annullare l'implementazione di un ambiente in corso
È possibile tentare di annullare la distribuzione di un aggiornamento dell'ambiente se `deploymentStatus` è attiva`IN_PROGRESS`. AWS Proton tenta di annullare la distribuzione. L'annullamento riuscito *non è* garantito.
Quando annulli la distribuzione di un aggiornamento, AWS Proton tenta di annullare la distribuzione come indicato nei passaggi seguenti.
**Con AWS-managed provisioning, AWS Proton effettua le seguenti operazioni:**
+ Imposta lo stato di distribuzione su. `CANCELLING`
+ Interrompe la distribuzione in corso ed elimina tutte le nuove risorse create dalla distribuzione quando`IN_PROGRESS`.
+ Imposta lo stato di distribuzione su`CANCELLED`.
+ Riporta lo stato della risorsa allo stato precedente all'avvio della distribuzione.
**Con il provisioning autogestito, AWS Proton effettua le seguenti operazioni:**
+ Tenta di chiudere la pull request per impedire l'unione delle modifiche al repository.
+ Imposta lo stato di distribuzione `CANCELLED` se la pull request è stata chiusa con successo.
Per istruzioni su come annullare la distribuzione di un ambiente, consulta [CancelEnvironmentDeployment](https://docs.aws.amazon.com/proton/latest/APIReference/API_CancelEnvironmentDeployment.html)l'*AWS Proton API Reference*.
È possibile utilizzare la console o la CLI per annullare gli ambienti in corso.
------
#### [ Console di gestione AWS ]
**Utilizza la console per annullare la distribuzione di un aggiornamento dell'ambiente, come illustrato nei passaggi seguenti.**
1. Nella [AWS Proton console](https://console.aws.amazon.com//proton/), scegli **Ambienti** nel pannello di navigazione.
1. Nell'elenco degli ambienti, scegli il nome dell'ambiente con l'aggiornamento di distribuzione che desideri annullare.
1. Se lo stato di distribuzione dell'aggiornamento è **In corso**, nella pagina dei dettagli dell'ambiente, scegli **Azioni** e quindi **Annulla distribuzione**.
1. Una finestra modale richiede di confermare l'annullamento. **Scegli Annulla distribuzione.**
1. Lo stato di distribuzione degli aggiornamenti è impostato su **Annullamento** e quindi su **Annullato per completare l'annullamento**.
------
#### [ AWS CLI ]
**Utilizzate il AWS Proton AWS CLI per annullare la distribuzione di un aggiornamento dell'ambiente IN\$1PROGRESS a una nuova versione secondaria 2.**
Nel modello utilizzato per questo esempio è inclusa una condizione di attesa in modo che l'annullamento inizi prima del completamento della distribuzione dell'aggiornamento.
Esegui il comando seguente per annullare l'aggiornamento:
```
$ aws proton cancel-environment-deployment \
--environment-name "MySimpleEnv"
```
Risposta:
```
{
"environment": {
"arn": "arn:aws:proton:region-id:123456789012:environment/MySimpleEnv",
"createdAt": "2021-04-02T17:29:55.472000+00:00",
"deploymentStatus": "CANCELLING",
"lastDeploymentAttemptedAt": "2021-04-02T18:15:10.243000+00:00",
"lastDeploymentSucceededAt": "2021-04-02T17:48:26.307000+00:00",
"name": "MySimpleEnv",
"protonServiceRoleArn": "arn:aws:iam::123456789012:role/service-role/ProtonServiceRole",
"spec": "proton: EnvironmentSpec\n\nspec:\n my_sample_input: hello\n my_other_sample_input: everybody\n",
"templateMajorVersion": "1",
"templateMinorVersion": "1",
"templateName": "simple-env"
}
}
```
Esegui il comando seguente per ottenere e confermare lo stato:»
```
$ aws proton get-environment \
--name "MySimpleEnv"
```
Risposta:
```
{
"environment": {
"arn": "arn:aws:proton:region-id:123456789012:environment/MySimpleEnv",
"createdAt": "2021-04-02T17:29:55.472000+00:00",
"deploymentStatus": "CANCELLED",
"deploymentStatusMessage": "User initiated cancellation.",
"lastDeploymentAttemptedAt": "2021-04-02T18:15:10.243000+00:00",
"lastDeploymentSucceededAt": "2021-04-02T17:48:26.307000+00:00",
"name": "MySimpleEnv",
"protonServiceRoleArn": "arn:aws:iam::123456789012:role/service-role/ProtonServiceRole",
"spec": "proton: EnvironmentSpec\n\nspec:\n my_sample_input: hello\n my_other_sample_input: everybody\n",
"templateMajorVersion": "1",
"templateMinorVersion": "1",
"templateName": "simple-env"
}
}
```
------