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'istanza di servizio Scopri come aggiornare un'istanza del AWS Proton servizio e annullare l'aggiornamento. Un'istanza di servizio appartiene a un servizio. È possibile creare o eliminare un'istanza solo nell'ambito delle azioni di [modifica](ag-svc-update.md), [creazione](ag-create-svc.md) ed [eliminazione](ag-svc-delete.md) del servizio. Per informazioni su come aggiungere e rimuovere istanze da un servizio, consulta[Modifica un servizio](ag-svc-update.md). Esistono quattro modalità per aggiornare un'istanza del servizio, 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** e **Aggiornamento all'ultima versione secondaria** e **Aggiornamento all'ultima versione principale**, disponibili in **Azioni** nella pagina di dettaglio dell'istanza del servizio. `NONE` In questa modalità, *non* si verifica una distribuzione. Vengono aggiornati solo i parametri dei metadati richiesti. `CURRENT_VERSION` In questa modalità, l'istanza del servizio viene distribuita e aggiornata 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'istanza del servizio viene distribuita e aggiornata con la versione secondaria pubblicata, consigliata (più recente) della versione principale corrente, utilizzata per impostazione predefinita. È inoltre possibile specificare una versione secondaria diversa della versione principale corrente in uso. `MAJOR_VERSION` In questa modalità, per impostazione predefinita, l'istanza del servizio viene distribuita e aggiornata con la versione principale e secondaria pubblicata, consigliata (più recente) del modello corrente. È inoltre possibile specificare una versione principale diversa che sia superiore alla versione principale in uso e una versione secondaria (opzionale). È possibile tentare di annullare la distribuzione di un aggiornamento di un'istanza di servizio, se lo `deploymentStatus` è`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. + Imposta lo stato di distribuzione su`CANCELLING`. + Interrompe il processo di distribuzione 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. Per ulteriori informazioni sull'annullamento della distribuzione di un'istanza di servizio, consulta l'*AWS Proton API [CancelServiceInstanceDeployment](https://docs.aws.amazon.com/proton/latest/APIReference/API_CancelServiceInstanceDeployment.html)*Reference. **Usa la console o AWS CLI per effettuare aggiornamenti o annullare le distribuzioni degli aggiornamenti.** ------ #### [ Console di gestione AWS ] **Aggiorna un'istanza del servizio utilizzando la console seguendo questi passaggi.** 1. Nella [AWS Proton console](https://console.aws.amazon.com//proton/), scegli **Istanze di servizio** nel riquadro di navigazione. 1. Nell'elenco delle istanze del servizio, scegli il nome dell'istanza di servizio che desideri aggiornare. 1. Scegli **Azioni**, quindi scegli una delle opzioni di aggiornamento, **Modifica** per aggiornare le specifiche o **Azioni** e quindi **Aggiorna all'ultima versione secondaria** o **Aggiorna all'ultima versione principale**. 1. Compila ogni modulo e scegli **Avanti** fino a raggiungere la pagina di **revisione**. 1. Controlla le modifiche e scegli **Aggiorna**. ------ #### [ AWS CLI ] **Aggiorna un'istanza del servizio a una nuova versione secondaria, come mostrato nei comandi e nelle risposte di esempio della CLI.** Quando si aggiorna l'istanza del servizio con un'istanza modificata`spec`, è possibile utilizzarla `"${Proton::CURRENT_VAL}"` per indicare quali valori dei parametri preservare rispetto all'originale`spec`, se i valori esistono in. `spec` `get-service`Da utilizzare per visualizzare l'originale `spec` di un'istanza di servizio, come descritto in[Visualizza i dati del servizio](ag-svc-view.md). L'esempio seguente mostra come è possibile utilizzare `"${Proton::CURRENT_VAL}"` in un`spec`. Spec: ``` proton: ServiceSpec pipeline: my_sample_pipeline_optional_input: "${Proton::CURRENT_VAL}" my_sample_pipeline_required_input: "${Proton::CURRENT_VAL}" instances: - name: "my-instance" environment: "simple-env" spec: my_sample_service_instance_optional_input: "${Proton::CURRENT_VAL}" my_sample_service_instance_required_input: "${Proton::CURRENT_VAL}" - name: "my-other-instance" environment: "simple-env" spec: my_sample_service_instance_required_input: "789" ``` Comando: aggiornare ``` $ aws proton update-service-instance \ --name "instance-one" \ --service-name "simple-svc" \ --spec "file://service-spec.yaml" \ --template-major-version "1" \ --template-minor-version "1" \ --deployment-type "MINOR_VERSION" ``` Risposta: ``` { "serviceInstance": { "arn": "arn:aws:proton:region-id:123456789012:service/simple-svc/service-instance/instance-one", "createdAt": "2021-04-02T21:29:59.962000+00:00", "deploymentStatus": "IN_PROGRESS", "environmentName": "arn:aws:proton:region-id:123456789012:environment/simple-env", "lastDeploymentAttemptedAt": "2021-04-02T21:38:00.823000+00:00", "lastDeploymentSucceededAt": "2021-04-02T21:29:59.962000+00:00", "name": "instance-one", "serviceName": "simple-svc", "templateMajorVersion": "1", "templateMinorVersion": "0", "templateName": "svc-simple" } } ``` Comando: per ottenere e confermare lo stato ``` $ aws proton get-service-instance \ --name "instance-one" \ --service-name "simple-svc" ``` Risposta: ``` { "serviceInstance": { "arn": "arn:aws:proton:region-id:123456789012:service/simple-svc/service-instance/instance-one", "createdAt": "2021-04-02T21:29:59.962000+00:00", "deploymentStatus": "SUCCEEDED", "environmentName": "simple-env", "lastDeploymentAttemptedAt": "2021-04-02T21:38:00.823000+00:00", "lastDeploymentSucceededAt": "2021-04-02T21:38:00.823000+00:00", "name": "instance-one", "serviceName": "simple-svc", "spec": "proton: ServiceSpec\n\npipeline:\n my_sample_pipeline_optional_input: \"abc\"\n my_sample_pipeline_required_input: \"123\"\n\ninstances:\n - name: \"instance-one\"\n environment: \"simple-env\"\n spec:\n my_sample_service_instance_optional_input: \"def\"\n my_sample_service_instance_required_input: \"456\"\n - name: \"my-other-instance\"\n environment: \"kls-simple-env\"\n spec:\n my_sample_service_instance_required_input: \"789\"\n", "templateMajorVersion": "1", "templateMinorVersion": "1", "templateName": "svc-simple" } } ``` ------ ------ #### [ Console di gestione AWS ] **Annulla la distribuzione di un'istanza di servizio utilizzando la console, come illustrato nei passaggi seguenti.** 1. Nella [AWS Proton console](https://console.aws.amazon.com//proton/), scegli **Istanze di servizio** nel riquadro di navigazione. 1. Nell'elenco delle istanze del servizio, scegli il nome dell'istanza del servizio con l'aggiornamento di distribuzione che desideri annullare. 1. Se lo stato di distribuzione dell'aggiornamento è **In corso**, nella pagina dei dettagli dell'istanza di servizio, scegli **Azioni** e quindi **Annulla distribuzione**. 1. Un modale ti chiede 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 ] **Annulla l'aggiornamento della distribuzione dell'istanza del servizio IN\$1PROGRESS alla nuova versione secondaria 2, come mostrato nei seguenti comandi e risposte di esempio CLI.** Nel modello utilizzato per questo esempio è inclusa una condizione di attesa, in modo che l'annullamento inizi prima del completamento della distribuzione dell'aggiornamento. Comando: annullare ``` $ aws proton cancel-service-instance-deployment \ --service-instance-name "instance-one" \ --service-name "simple-svc" ``` Risposta: ``` { "serviceInstance": { "arn": "arn:aws:proton:region-id:123456789012:service/simple-svc/service-instance/instance-one", "createdAt": "2021-04-02T21:29:59.962000+00:00", "deploymentStatus": "CANCELLING", "environmentName": "simple-env", "lastDeploymentAttemptedAt": "2021-04-02T21:45:15.406000+00:00", "lastDeploymentSucceededAt": "2021-04-02T21:38:00.823000+00:00", "name": "instance-one", "serviceName": "simple-svc", "spec": "proton: ServiceSpec\npipeline:\n my_sample_pipeline_optional_input: abc\n my_sample_pipeline_required_input: '123'\ninstances:\n- name: my-instance\n environment: MySimpleEnv\n spec:\n my_sample_service_instance_optional_input: def\n my_sample_service_instance_required_input: '456'\n- name: my-other-instance\n environment: MySimpleEnv\n spec:\n my_sample_service_instance_required_input: '789'\n", "templateMajorVersion": "1", "templateMinorVersion": "1", "templateName": "svc-simple" } } ``` Comando: per ottenere e confermare lo stato ``` $ aws proton get-service-instance \ --name "instance-one" \ --service-name "simple-svc" ``` Risposta: ``` { "serviceInstance": { "arn": "arn:aws:proton:region-id:123456789012:service/simple-svc/service-instance/instance-one", "createdAt": "2021-04-02T21:29:59.962000+00:00", "deploymentStatus": "CANCELLED", "deploymentStatusMessage": "User initiated cancellation.", "environmentName": "simple-env", "lastDeploymentAttemptedAt": "2021-04-02T21:45:15.406000+00:00", "lastDeploymentSucceededAt": "2021-04-02T21:38:00.823000+00:00", "name": "instance-one", "serviceName": "simple-svc", "spec": "proton: ServiceSpec\n\npipeline:\n my_sample_pipeline_optional_input: \"abc\"\n my_sample_pipeline_required_input: \"123\"\n\ninstances:\n - name: \"instance-one\"\n environment: \"simple-env\"\n spec:\n my_sample_service_instance_optional_input: \"def\"\n my_sample_service_instance_required_input: \"456\"\n - name: \"my-other-instance\"\n environment: \"kls-simple-env\"\n spec:\n my_sample_service_instance_required_input: \"789\"\n", "templateMajorVersion": "1", "templateMinorVersion": "1", "templateName": "svc-simple" } } ``` ------