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à.
# Configurazioni di sincronizzazione dei servizi
Con la sincronizzazione dei servizi, puoi configurare e distribuire i tuoi AWS Proton servizi utilizzando Git. Puoi usare service sync per gestire le distribuzioni e gli aggiornamenti iniziali del tuo AWS Proton servizio con una configurazione definita in un repository Git. Tramite Git, puoi utilizzare funzionalità come il monitoraggio delle versioni e le richieste pull per configurare, gestire e distribuire i tuoi servizi. Service sync combina AWS Proton e Git per aiutarti a fornire un'infrastruttura standardizzata definita e gestita tramite AWS Proton modelli. Gestisce le definizioni dei servizi nel tuo repository Git e riduce il cambio di strumento. Rispetto all'utilizzo esclusivo di Git, la standardizzazione dei modelli e dell'implementazione AWS Proton consente di dedicare meno tempo alla gestione dell'infrastruttura. AWS Proton offre inoltre una maggiore trasparenza e verificabilità sia per gli sviluppatori che per i team di piattaforma.
## AWS Proton File OPS
Il `proton-ops` file definisce dove si AWS Proton trova il file delle specifiche utilizzato per aggiornare l'istanza del servizio. Definisce inoltre in quale ordine aggiornare le istanze del servizio e quando promuovere le modifiche da un'istanza all'altra.
Il `proton-ops` file supporta la sincronizzazione di un'istanza del servizio utilizzando il file spec, o più file di specifiche, presenti nell'archivio collegato. È possibile farlo definendo un blocco di sincronizzazione nel `proton-ops` file, come nell'esempio seguente.
**Esempio. /configuration/proton-ops.yaml**:
```
sync:
services:
frontend-svc:
alpha:
branch: dev
spec: ./frontend-svc/test/frontend-spec.yaml
beta:
branch: dev
spec: ./frontend-svc/test/frontend-spec.yaml
gamma:
branch: pre-prod
spec: ./frontend-svc/pre-prod/frontend-spec.yaml
prod-one:
branch: prod
spec: ./frontend-svc/prod/frontend-spec-second.yaml
prod-two:
branch: prod
spec: ./frontend-svc/prod/frontend-spec-second.yaml
prod-three:
branch: prod
spec: ./frontend-svc/prod/frontend-spec-second.yaml
```
Nell'esempio precedente, `frontend-svc` è il nome del servizio e,,,, e `alpha` sono le istanze. `beta` `gamma` `prod-one` `prod-two` `prod-three`
Il `spec` file può essere composto da tutte le istanze o da un sottoinsieme delle istanze definite all'interno del file. `proton-ops` Tuttavia, come minimo, deve avere l'istanza definita all'interno del ramo e le specifiche da cui viene sincronizzata. Se le istanze non sono definite nel `proton-ops` file, con il ramo e la posizione del `spec` file specifici, la sincronizzazione del servizio non creerà o aggiornerà tali istanze.
Gli esempi seguenti mostrano l'aspetto dei `spec` file. Ricorda che il `proton-ops` file viene sincronizzato da questi `spec` file.
**Esempio`./frontend-svc/test/frontend-spec.yaml`:**
```
proton: "ServiceSpec"
instances:
- name: "alpha"
environment: "frontend-env"
spec:
port: 80
desired_count: 1
task_size: "x-small"
image: "public.ecr.aws/z9d2n7e1/nginx:1.21.0"
- name: "beta"
environment: "frontend-env"
spec:
port: 80
desired_count: 1
task_size: "x-small"
image: "public.ecr.aws/z9d2n7e1/nginx:1.21.0"
```
**Esempio`./frontend-svc/pre-prod/frontend-spec.yaml`:**
```
proton: "ServiceSpec"
instances:
- name: "gamma"
environment: "frontend-env"
spec:
port: 80
desired_count: 1
task_size: "x-small"
image: "public.ecr.aws/z9d2n7e1/nginx:1.21.0"
```
**Esempio`./frontend-svc/prod/frontend-spec-second.yaml`:**
```
proton: "ServiceSpec"
instances:
- name: "prod-one"
environment: "frontend-env"
spec:
port: 80
desired_count: 1
task_size: "x-small"
image: "public.ecr.aws/z9d2n7e1/nginx:1.21.0"
- name: "prod-two"
environment: "frontend-env"
spec:
port: 80
desired_count: 1
task_size: "x-small"
image: "public.ecr.aws/z9d2n7e1/nginx:1.21.0"
- name: "prod-three"
environment: "frontend-env"
spec:
port: 80
desired_count: 1
task_size: "x-small"
image: "public.ecr.aws/z9d2n7e1/nginx:1.21.0"
```
Se un'istanza non si sincronizza e il problema persiste durante il tentativo di sincronizzazione, chiamare l'[https://docs.aws.amazon.com//proton/latest/APIReference/API_GetServiceInstanceSyncStatus.html](https://docs.aws.amazon.com//proton/latest/APIReference/API_GetServiceInstanceSyncStatus.html)API può aiutare a risolvere il problema.
**Nota**
I clienti che utilizzano la sincronizzazione del servizio sono ancora limitati da AWS Proton limiti.
**Bloccanti**
Sincronizzando il servizio utilizzando AWS Proton service sync, puoi aggiornare le specifiche del servizio e creare e aggiornare le istanze del servizio dal tuo repository Git. Tuttavia, in alcuni momenti potrebbe essere necessario aggiornare manualmente un servizio o un'istanza tramite o. Console di gestione AWS AWS CLI
AWS Proton aiuta a evitare di sovrascrivere eventuali modifiche manuali apportate tramite il Console di gestione AWS sistema operativo AWS CLI, ad esempio l'aggiornamento di un'istanza del servizio o l'eliminazione di un'istanza del servizio. A tal fine, crea AWS Proton automaticamente un blocco della sincronizzazione dei servizi disabilitando la sincronizzazione del servizio quando rileva una modifica manuale.
Per ottenere tutti i blocker associati a un servizio, è necessario eseguire le seguenti operazioni in ordine per ciascuno `serviceInstance` associato al servizio:
+ Chiama l'`getServiceSyncBlockerSummary`API solo con. `serviceName`
+ Chiama l'`getServiceSyncBlockerSummary`API con `serviceName` e`serviceInstanceName`.
Ciò restituisce un elenco dei bloccanti più recenti e lo stato ad essi associato. Se alcuni bloccanti sono contrassegnati come **ATTIVI**, è necessario risolverli chiamando l'`UpdateServiceSyncBlocker`API con `blockerId` e `resolvedReason` per ognuno di essi.
Se aggiorni o crei manualmente un'istanza del servizio, AWS Proton crea un blocco della sincronizzazione dei servizi sull'istanza del servizio. AWS Proton continua a sincronizzare tutte le altre istanze del servizio, ma disabilita la sincronizzazione di questa istanza di servizio fino alla risoluzione del blocco. Se elimini un'istanza del servizio da un servizio, AWS Proton crea un blocco della sincronizzazione dei servizi sul servizio. Ciò AWS Proton impedisce la sincronizzazione di qualsiasi istanza del servizio fino a quando il blocco non è stato risolto.
Dopo aver installato tutti i bloccanti attivi, è necessario risolverli chiamando l'`UpdateServiceSyncBlocker`API con `blockerId` e `resolvedReason` per ciascuno dei bloccanti attivi.
Utilizzando Console di gestione AWS, è possibile determinare se la sincronizzazione di un servizio è disabilitata accedendo alla scheda **Service** Sync AWS Proton e selezionandola. Se il servizio o le istanze del servizio sono bloccati, viene visualizzato il pulsante **Abilita.** Per abilitare la sincronizzazione del servizio, scegli **Abilita.**
**Topics**
+ [AWS Proton File OPS](#service-sync-ops)
+ [Crea una configurazione di sincronizzazione del servizio](create-service-sync.md)
+ [Visualizza i dettagli di configurazione per una sincronizzazione del servizio](get-service-sync.md)
+ [Modifica una configurazione di sincronizzazione del servizio](update-service-sync.md)
+ [Eliminare una configurazione di sincronizzazione del servizio](delete-service-sync.md)
# Crea una configurazione di sincronizzazione del servizio
Puoi creare una configurazione di sincronizzazione del servizio utilizzando la console o AWS CLI.
------
#### [ Console di gestione AWS ]
1. Nella pagina **Scegli un modello di servizio**, seleziona un modello e scegli **Configura**.
1. Nella pagina **Configura servizio**, nella sezione **Dettagli del servizio**, inserisci un nuovo **nome di servizio**.
1. (Facoltativo) Inserisci una descrizione per il servizio.
1. Nella sezione **Archivio del codice sorgente dell'applicazione**, scegli **Scegli un repository Git collegato per selezionare un repository** a cui ti sei già collegato. AWS Proton Se non hai già un repository collegato, scegli **Collega un altro repository Git** e segui le istruzioni in [Creare un link al tuo](https://docs.aws.amazon.com//proton/latest/userguide/ag-create-repo.html) repository.
1. Per **Repository**, scegli il nome del tuo repository di codice sorgente dall'elenco.
1. Per **Branch**, scegli il nome del ramo del repository per il tuo codice sorgente dall'elenco.
1. (Facoltativo) Nella sezione **Tag**, scegli **Aggiungi nuovo tag** e inserisci una chiave e un valore per creare un tag gestito dal cliente.
1. Scegli **Next (Successivo)**.
1. Nella pagina **Configura istanze del servizio**, nella sezione **Sorgente della definizione del servizio**, seleziona **Sincronizza il servizio da Git**.
1. Nella sezione **File di definizione del servizio**, se desideri AWS Proton creare il tuo `proton-ops` file, seleziona **Voglio che AWS Proton crei i** file. Con questa opzione, AWS Proton crea il `proton-ops` file `spec` and nelle posizioni specificate. Seleziona **Sto fornendo i miei file** per creare il tuo file OPS.
1. Nella sezione **Service definition repository**, scegli **Scegli un repository Git collegato per selezionare un repository** a cui ti sei già collegato. AWS Proton
1. Per **Nome del repository**, scegli il nome del tuo repository di codice sorgente dall'elenco.
1. Per **`proton-ops`il ramo di file**, scegli il nome del tuo ramo dall'elenco in cui AWS Proton verranno inseriti il tuo file OPS e spec.
1. Nella sezione **Istanze di servizio**, ogni campo viene compilato automaticamente in base ai valori del file. `proton-ops`
1. Scegli **Avanti** e controlla i dati inseriti.
1. Scegli **Create** (Crea).
------
#### [ AWS CLI ]
**Crea una configurazione di sincronizzazione del servizio utilizzando AWS CLI**
+ Esegui il comando seguente.
```
$ aws proton create-service-sync-config \
--resource "service-arn" \
--repository-provider "GITHUB" \
--repository "example/proton-sync-service" \
--ops-file-branch "main" \
--proton-ops-file "./configuration/custom-proton-ops.yaml" (optional)
```
La risposta è la seguente.
```
{
"serviceSyncConfig": {
"branch": "main",
"filePath": "./configuration/custom-proton-ops.yaml",
"repositoryName": "example/proton-sync-service",
"repositoryProvider": "GITHUB",
"serviceName": "service name"
}
}
```
------
# Visualizza i dettagli di configurazione per una sincronizzazione del servizio
È possibile visualizzare i dati dei dettagli di configurazione per una sincronizzazione del servizio utilizzando la console o AWS CLI.
------
#### [ Console di gestione AWS ]
**Utilizza la console per visualizzare i dettagli di configurazione per una sincronizzazione del servizio**
1. Nel riquadro di navigazione, scegli **Servizi**.
1. Per visualizzare i dati di dettaglio, scegli il nome di un servizio per cui hai creato una configurazione di sincronizzazione del servizio.
1. Nella pagina dei dettagli del servizio, seleziona la scheda **Service sync** per visualizzare i dati di dettaglio della configurazione per la sincronizzazione del servizio.
------
#### [ AWS CLI ]
**Utilizza il AWS CLI per ottenere un servizio sincronizzato.**
Esegui il comando seguente.
```
$ aws proton get-service-sync-config \
--service-name "service name"
```
La risposta è la seguente.
```
{
"serviceSyncConfig": {
"branch": "main",
"filePath": "./configuration/custom-proton-ops.yaml",
"repositoryName": "example/proton-sync-service",
"repositoryProvider": "GITHUB",
"serviceName": "service name"
}
}
```
**Usa il AWS CLI per ottenere lo stato di sincronizzazione del servizio.**
Esegui il comando seguente.
```
$ aws proton get-service-sync-status \
--service-name "service name"
```
------
# Modifica una configurazione di sincronizzazione del servizio
Puoi modificare una configurazione di sincronizzazione del servizio utilizzando la console o AWS CLI.
------
#### [ Console di gestione AWS ]
Modifica una configurazione di sincronizzazione del servizio utilizzando la console.
1. Nel riquadro di navigazione, scegli **Servizi**.
1. Per visualizzare i dati di dettaglio, scegli il nome di un servizio per cui hai creato una configurazione di sincronizzazione del servizio.
1. Nella pagina dei dettagli del servizio, scegli la scheda **Sincronizzazione del servizio**.
1. Nella sezione **Sincronizzazione del servizio**, scegli **Modifica**.
1. Nella pagina **Modifica**, aggiorna le informazioni che desideri modificare, quindi scegli **Salva**.
------
#### [ AWS CLI ]
**Il comando e la risposta di esempio seguenti mostrano come modificare una configurazione di sincronizzazione del servizio utilizzando AWS CLI.**
Esegui il comando seguente.
```
$ aws proton update-service-sync-config \
--service-name "service name" \
--repository-provider "GITHUB" \
--repository "example/proton-sync-service" \
--ops-file-branch "main" \
--ops-file "./configuration/custom-proton-ops.yaml"
```
La risposta è la seguente.
```
{
"serviceSyncConfig": {
"branch": "main",
"filePath": "./configuration/custom-proton-ops.yaml",
"repositoryName": "example/proton-sync-service",
"repositoryProvider": "GITHUB",
"serviceName": "service name"
}
}
```
------
# Eliminare una configurazione di sincronizzazione del servizio
È possibile eliminare una configurazione di sincronizzazione del servizio utilizzando la console o AWS CLI.
------
#### [ Console di gestione AWS ]
**Eliminare una configurazione di sincronizzazione del servizio utilizzando la console**
1. Nella pagina dei dettagli del servizio, scegli la scheda **Sincronizzazione del servizio**.
1. Nella sezione **Dettagli di sincronizzazione del servizio**, scegli **Disconnetti per disconnettere** il repository. Dopo la disconnessione del repository, non sincronizziamo più il servizio da quel repository.
------
#### [ AWS CLI ]
**I comandi e le risposte di esempio seguenti mostrano come utilizzare le configurazioni sincronizzate del servizio AWS CLI per eliminare.**
Esegui il comando seguente.
```
$ aws proton delete-service-sync-config \
--service-name "service name"
```
La risposta è la seguente.
```
{
"serviceSyncConfig": {
"branch": "main",
"filePath": "./configuration/custom-proton-ops.yaml",
"repositoryName": "example/proton-sync-service",
"repositoryProvider": "GITHUB",
"serviceName": "service name"
}
}
```
**Nota**
La sincronizzazione dei servizi non elimina le istanze del servizio. Elimina solo la configurazione.
------