View a markdown version of this page

Modificare un servizio - AWS Proton
Modifica la descrizione del servizioAggiungere o rimuovere istanze di servizio

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 la AWS Proton Service Deprecation 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à.

Modificare un servizio

È possibile apportare le seguenti modifiche a un AWS Proton servizio.

  • Modifica la descrizione del servizio.

  • Modifica un servizio aggiungendo e rimuovendo le istanze del servizio.

Modifica la descrizione del servizio

È possibile utilizzare la console o il AWS CLI per modificare la descrizione di un servizio.

Console di gestione AWS

Modifica un servizio utilizzando la console come descritto nei passaggi seguenti.

Nell'elenco dei servizi.

  1. Nella AWS Proton console, scegli Servizi.

  2. Nell'elenco dei servizi, scegli il pulsante di opzione a sinistra del servizio che desideri aggiornare.

  3. Scegli Modifica.

  4. Nella pagina Configura il servizio, compila il modulo e scegli Avanti.

  5. Nella pagina Configura impostazioni personalizzate, scegli Avanti.

  6. Rivedi le modifiche e scegli Salva modifiche.

Nella pagina dei dettagli del servizio.

  1. Nella AWS Proton console, scegli Servizi.

  2. Nell'elenco dei servizi, scegli il nome del servizio che desideri modificare.

  3. Nella pagina dei dettagli del servizio, scegli Modifica.

  4. Nella pagina Configura il servizio, compila il modulo e scegli Avanti.

  5. Nella pagina Configura le impostazioni personalizzate, compila il modulo e scegli Avanti.

  6. Rivedi le modifiche e scegli Salva modifiche.

AWS CLI

Modifica una descrizione come mostrato nel seguente comando e risposta di esempio della CLI.

Comando:

$ aws proton update-service \
    --name "MySimpleService" \
    --description "Edit by updating description"

Risposta:

{
    "service": {
        "arn": "arn:aws:proton:region-id:123456789012:service/MySimpleService",
        "branchName": "main",
        "createdAt": "2021-03-12T22:39:42.318000+00:00",
        "description": "Edit by updating description",
        "lastModifiedAt": "2021-03-12T22:44:21.975000+00:00",
        "name": "MySimpleService",
        "repositoryConnectionArn": "arn:aws:codestar-connections:region-id:123456789012:connection/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
        "repositoryId": "my-repository/myorg-myapp",
        "status": "ACTIVE",
        "templateName": "fargate-service"
    }
}

Modifica un servizio per aggiungere o rimuovere istanze del servizio

Per qualsiasi AWS Proton servizio, puoi aggiungere o eliminare istanze del servizio inviando una specifica modificata. Affinché una richiesta abbia esito positivo, devono essere soddisfatte le seguenti condizioni:

  • Il servizio e la pipeline non sono già stati modificati o eliminati quando invii la richiesta di modifica.

  • Le specifiche modificate non includono le modifiche che modificano la pipeline del servizio o le modifiche alle istanze di servizio esistenti che non devono essere eliminate.

  • La specifica modificata non rimuove alcuna istanza di servizio esistente a cui è collegato un componente. Per eliminare un'istanza di servizio di questo tipo, è necessario innanzitutto aggiornare il componente per scollegarlo dalla relativa istanza del servizio. Per ulteriori informazioni sui componenti, vedereAWS Proton componenti.

Deletion-failed le istanze sono istanze di servizio nello DELETE_FAILED stato. Quando richiedi una modifica al servizio, AWS Proton tenta di rimuovere automaticamente le istanze non riuscite, come parte del processo di modifica. Se una delle tue istanze del servizio non è stata eliminata, potrebbero esserci ancora risorse associate alle istanze, anche se non sono visibili dalla console o. AWS CLI Controlla le risorse dell'infrastruttura delle istanze non riuscite a eliminarle e puliscile in modo da rimuoverle al posto AWS Proton tuo.

Per la quota di istanze di servizio per un servizio, consulta. AWS Proton quote È inoltre necessario mantenere almeno un'istanza di servizio per il servizio dopo la creazione. Durante il processo di aggiornamento, AWS Proton effettua un conteggio delle istanze del servizio esistenti e delle istanze da aggiungere o rimuovere. Deletion-failed le istanze sono incluse in questo conteggio e devi tenerne conto quando modifichi le tue. spec

Usa la console o AWS CLI per aggiungere o rimuovere istanze di servizio

Console di gestione AWS

Modifica il servizio per aggiungere o rimuovere istanze del servizio utilizzando la console.

Nella AWS Proton console

  1. Nel riquadro di navigazione, scegli Servizi.

  2. Seleziona il servizio che desideri modificare.

  3. Scegli Modifica.

  4. (Facoltativo) Nella pagina Configura il servizio, modifica il nome o la descrizione del servizio, quindi scegli Avanti.

  5. Nella pagina Configura impostazioni personalizzate, scegli Elimina per eliminare un'istanza del servizio e scegli Aggiungi nuova istanza per aggiungere un'istanza del servizio e compilare il modulo.

  6. Scegli Avanti.

  7. Rivedi l'aggiornamento e scegli Salva modifiche.

  8. Una finestra modale ti chiede di verificare l'eliminazione delle istanze del servizio. Segui le istruzioni e scegli Sì, elimina.

  9. Nella pagina dei dettagli del servizio, visualizza i dettagli sullo stato del servizio.

AWS CLI

Aggiungi ed elimina le istanze del servizio con una modificaspec, come mostrato nel seguente AWS CLI esempio di comandi e risposte.

Quando si utilizza la CLI, è spec necessario escludere le istanze del servizio da eliminare e includere sia le istanze del servizio da aggiungere sia le istanze di servizio esistenti che non sono state contrassegnate per l'eliminazione.

L'elenco seguente mostra l'esempio spec prima della modifica e un elenco delle istanze di servizio distribuite dalla specifica. Questa specifica è stata utilizzata nell'esempio precedente per modificare la descrizione di un servizio.

Specifiche:

proton: ServiceSpec

pipeline:
  my_sample_pipeline_optional_input: "abc"
  my_sample_pipeline_required_input: "123"

instances:
  - name: "my-instance"
    environment: "simple-env"
    spec:
      my_sample_service_instance_optional_input: "def"
      my_sample_service_instance_required_input: "456"
  - name: "my-other-instance"
    environment: "simple-env"
    spec:
      my_sample_service_instance_required_input: "789"

L'esempio seguente di list-service-instances comando e risposta CLI mostra le istanze attive prima di aggiungere o eliminare un'istanza del servizio.

Comando:

$ aws proton list-service-instances \
    --service-name "MySimpleService"

Risposta:

{
    "serviceInstances": [
        {
            "arn": "arn:aws:proton:region-id:123456789012:service/MySimpleService/service-instance/my-other-instance",
            "createdAt": "2021-03-12T22:39:42.318000+00:00",
            "deploymentStatus": "SUCCEEDED",
            "environmentName": "simple-env",
            "lastDeploymentAttemptedAt": "2021-03-12T22:39:43.109000+00:00",
            "lastDeploymentSucceededAt": "2021-03-12T22:39:43.109000+00:00",
            "name": "my-other-instance",
            "serviceName": "example-svc",
            "templateMajorVersion": "1",
            "templateMinorVersion": "0",
            "templateName": "fargate-service"
        },
        {
            "arn": "arn:aws:proton:region-id:123456789012:service/MySimpleService/service-instance/my-instance",
            "createdAt": "2021-03-12T22:39:42.318000+00:00",
            "deploymentStatus": "SUCCEEDED",
            "environmentName": "simple-env",
            "lastDeploymentAttemptedAt": "2021-03-12T22:39:43.160000+00:00",
            "lastDeploymentSucceededAt": "2021-03-12T22:39:43.160000+00:00",
            "name": "my-instance",
            "serviceName": "example-svc",
            "serviceTemplateArn": "arn:aws:proton:region-id:123456789012:service-template/fargate-service",
            "templateMajorVersion": "1",
            "templateMinorVersion": "0",
            "templateName": "fargate-service"
        }
    ]
}

L'elenco seguente mostra l'esempio modificato spec utilizzato per eliminare e aggiungere un'istanza. L'istanza esistente denominata my-instance viene rimossa e yet-another-instance viene aggiunta una nuova istanza denominata.

Specifiche:

proton: ServiceSpec

pipeline:
  my_sample_pipeline_optional_input: "abc"
  my_sample_pipeline_required_input: "123"

instances:
  - name: "my-other-instance"
    environment: "simple-env"
    spec:
      my_sample_service_instance_required_input: "789"
  - name: "yet-another-instance"
    environment: "simple-env"
    spec:
      my_sample_service_instance_required_input: "789"

È possibile utilizzare "${Proton::CURRENT_VAL}" per indicare quali valori dei parametri conservare rispetto all'originalespec, se i valori esistono in. spec get-serviceDa utilizzare per visualizzare l'originale spec di un servizio, come descritto inVisualizza i dati del servizio.

L'elenco seguente mostra come è possibile fare in modo che spec non vengano incluse modifiche "${Proton::CURRENT_VAL}" ai valori dei parametri affinché le istanze dei servizi esistenti rimangano invariate.

Specifiche:

proton: ServiceSpec

pipeline:
  my_sample_pipeline_optional_input: "${Proton::CURRENT_VAL}"
  my_sample_pipeline_required_input: "${Proton::CURRENT_VAL}"

instances:
  - name: "my-other-instance"
    environment: "simple-env"
    spec:
      my_sample_service_instance_required_input: "${Proton::CURRENT_VAL}"
  - name: "yet-another-instance"
    environment: "simple-env"
    spec:
      my_sample_service_instance_required_input: "789"

L'elenco successivo mostra il comando e la risposta CLI per modificare il servizio.

Comando:

$ aws proton update-service 
    --name "MySimpleService" \
    --description "Edit by adding and deleting a service instance" \
    --spec "file://spec.yaml"

Risposta:

{
    "service": {
        "arn": "arn:aws:proton:region-id:123456789012:service/MySimpleService",
        "branchName": "main",
        "createdAt": "2021-03-12T22:39:42.318000+00:00",
        "description": "Edit by adding and deleting a service instance",
        "lastModifiedAt": "2021-03-12T22:55:48.169000+00:00",
        "name": "MySimpleService",
        "repositoryConnectionArn": "arn:aws:codestar-connections:region-id:123456789012:connection/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
        "repositoryId": "my-repository/myorg-myapp",
        "status": "UPDATE_IN_PROGRESS",
        "templateName": "fargate-service"
    }
}

Il list-service-instances comando e la risposta seguenti confermano che l'istanza esistente denominata my-instance viene rimossa e yet-another-instance viene aggiunta una nuova istanza denominata.

Comando:

$ aws proton list-service-instances \
    --service-name "MySimpleService"

Risposta:

{
    "serviceInstances": [
        {
            "arn": "arn:aws:proton:region-id:123456789012:service/MySimpleService/service-instance/yet-another-instance",
            "createdAt": "2021-03-12T22:39:42.318000+00:00",
            "deploymentStatus": "SUCCEEDED",
            "environmentName": "simple-env",
            "lastDeploymentAttemptedAt": "2021-03-12T22:56:01.565000+00:00",
            "lastDeploymentSucceededAt": "2021-03-12T22:56:01.565000+00:00",
            "name": "yet-another-instance",
            "serviceName": "MySimpleService",
            "templateMajorVersion": "1",
            "templateMinorVersion": "0",
            "templateName": "fargate-service"
        },
        {
            "arn": "arn:aws:proton:region-id:123456789012:service/MySimpleService/service-instance/my-other-instance",
            "createdAt": "2021-03-12T22:39:42.318000+00:00",
            "deploymentStatus": "SUCCEEDED",
            "environmentName": "simple-env",
            "lastDeploymentAttemptedAt": "2021-03-12T22:39:43.109000+00:00",
            "lastDeploymentSucceededAt": "2021-03-12T22:39:43.109000+00:00",
            "name": "my-other-instance",
            "serviceName": "MySimpleService",
            "templateMajorVersion": "1",
            "templateMinorVersion": "0",
            "templateName": "fargate-service"
        }
    ]
}

Cosa succede quando si aggiungono o si rimuovono istanze di servizio

Dopo aver inviato una modifica al servizio per eliminare e aggiungere istanze del servizio, AWS Proton esegue le seguenti azioni.

  • Imposta il servizio su. UPDATE_IN_PROGRESS

  • Se il servizio dispone di una pipeline, ne imposta lo stato IN_PROGRESS e ne blocca le azioni.

  • Imposta tutte le istanze del servizio su cui eliminare. DELETE_IN_PROGRESS

  • Blocca le azioni del servizio.

  • Blocca le azioni sulle istanze del servizio contrassegnate per l'eliminazione.

  • Crea nuove istanze di servizio.

  • Elimina le istanze elencate per l'eliminazione.

  • Tenta di rimuovere le istanze non riuscite a eliminare.

  • Una volta completate le aggiunte e le eliminazioni, rieffettua il provisioning della pipeline di servizi (se presente), imposta il servizio su e abilita le azioni relative al servizio e alla pipeline. ACTIVE

AWS Proton tenta di rimediare alle modalità di guasto nel modo seguente.

  • Se una o più istanze di servizio non sono state create, AWS Proton tenta di annullare il provisioning di tutte le istanze di servizio appena create e ripristina lo stato precedente. spec Non elimina alcuna istanza del servizio e non modifica in alcun modo la pipeline.

  • Se una o più istanze del servizio non vengono eliminate, AWS Proton rifornisce la pipeline senza le istanze eliminate. specViene aggiornato per includere le istanze aggiunte ed escludere le istanze contrassegnate per l'eliminazione.

  • Se la pipeline non riesce a eseguire il provisioning, non viene tentato un rollback e sia il servizio che la pipeline indicano uno stato di aggiornamento non riuscito.

Etichettatura e modifiche al servizio

Quando aggiungi istanze di servizio come parte della modifica del servizio, i tag AWS gestiti si propagano e vengono creati automaticamente per le nuove istanze e le risorse assegnate. Se crei nuovi tag, questi tag vengono applicati solo alle nuove istanze. I tag esistenti gestiti dai clienti del servizio si propagano anche alle nuove istanze. Per ulteriori informazioni, consulta AWS Proton risorse e tag.