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à.
# Sincronizzazione dei prodotti con i file modello di GitHub GitHub Enterprise o Bitbucket
AWS Service Catalog consente di sincronizzare i prodotti con i file modello gestiti tramite un provider di repository esterno. AWS Service Catalog si riferisce ai prodotti con questo tipo di connessione modello come prodotti sincronizzati con *Git*. Le opzioni di repository includono Enterprise o GitHub Bitbucket GitHub . Dopo aver autorizzato il tuo account Account AWS con un account di repository esterno, puoi creare nuovi AWS Service Catalog prodotti o aggiornare i prodotti esistenti per la sincronizzazione con un file modello nel repository. Quando vengono apportate modifiche al file modello e salvate nel repository (ad esempio, utilizzando git-push), rileva AWS Service Catalog automaticamente le modifiche e crea una nuova versione del prodotto (artefatto).
**Topics**
+ [Autorizzazioni necessarie per sincronizzare i prodotti con file modello esterni](#required-perms-synced-repo)
+ [Crea una connessione all'account](#create-synced-product)
+ [Visualizzazione delle connessioni di prodotti sincronizzate con Git](#view-repo-sync)
+ [Aggiornamento delle connessioni dei prodotti sincronizzate con Git](#update-repo-sync)
+ [Eliminazione delle connessioni di prodotti sincronizzate con Git](#delete-repo-sync)
+ [Sincronizzazione dei prodotti Terraform con i file modello di GitHub GitHub Enterprise o Bitbucket](#git-synced-Terraform)
+ [Regione AWS supporto per prodotti sincronizzati con Git](git-sync-supported-regions.md)
## Autorizzazioni necessarie per sincronizzare i prodotti con file modello esterni
È possibile utilizzare la seguente politica AWS Identity and Access Management (IAM) come modello per consentire agli AWS Service Catalog amministratori di sincronizzare i prodotti con i file modello da un repository esterno. Questa politica include le autorizzazioni richieste da entrambi e. CodeConnections AWS Service Catalog AWS Service Catalog consiglia di copiare il modello di policy riportato di seguito e di utilizzare anche la [policy AWS Service Catalog`AWSServiceCatalogAdminFullAccess` gestita](https://docs.aws.amazon.com/servicecatalog/latest/adminguide/security-iam-awsmanpol) quando si abilitano prodotti sincronizzati con il repository.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "CodeStarAccess",
"Effect": "Allow",
"Action": [
"codestar-connections:UseConnection",
"codestar-connections:PassConnection",
"codestar-connections:CreateConnection",
"codestar-connections:DeleteConnection",
"codestar-connections:GetConnection",
"codestar-connections:ListConnections",
"codestar-connections:ListInstallationTargets",
"codestar-connections:GetInstallationUrl",
"codestar-connections:StartOAuthHandshake",
"codestar-connections:UpdateConnectionInstallation",
"codestar-connections:GetIndividualAccessToken"
],
"Resource": "arn:aws:codestar-connections:*:*:connection/*"
},
{
"Sid": "CreateSLR",
"Effect": "Allow",
"Action": "iam:CreateServiceLinkedRole",
"Resource": "arn:aws:iam::*:role/aws-service-role/sync.servicecatalog.amazonaws.com/AWSServiceRoleForServiceCatalogArtifactSync",
"Condition": {
"StringLike": {
"iam:AWSServiceName": "sync.servicecatalog.amazonaws.com"
}
}
}
]
}
```
------
## Crea una connessione all'account
Prima di sincronizzare un file modello con un AWS Service Catalog prodotto, devi creare e autorizzare una connessione unica. account-to-account Questa connessione viene utilizzata per specificare i dettagli del repository contenente il file modello desiderato. È possibile creare una connessione utilizzando la AWS Service Catalog console, la CodeConnections console AWS Command Line Interface (CLI) o. CodeConnections APIs
Dopo aver stabilito una connessione, puoi utilizzare la AWS Service Catalog console, l' AWS Service Catalog API o la CLI per creare un prodotto sincronizzato AWS Service Catalog . AWS Service Catalog gli amministratori possono creare nuovi AWS Service Catalog prodotti o aggiornare quelli esistenti sulla base di un file modello in un repository e in una filiale. Se viene salvata una modifica nel repository, rileva AWS Service Catalog automaticamente la modifica e crea una nuova versione del prodotto. Le versioni precedenti del prodotto vengono mantenute fino al limite di versioni prescritto e viene assegnato uno stato **obsoleto**.
Inoltre, crea AWS Service Catalog automaticamente un ruolo collegato al servizio (SLR) dopo la creazione della connessione. Questa SLR consente di AWS Service Catalog rilevare eventuali modifiche al file modello salvate nel repository. La SLR consente inoltre di AWS Service Catalog creare automaticamente nuove versioni di prodotto per prodotti sincronizzati. [Per ulteriori informazioni sulle autorizzazioni e sulle funzionalità SLR, consulta Ruoli collegati al servizio per. AWS Service Catalog](#required-perms-synced-repo)
**Per creare un nuovo prodotto sincronizzato con Git**
1. **Nel pannello di navigazione a sinistra, scegli **Elenco prodotti, quindi scegli Crea prodotto**.**
1. Inserisci i **dettagli del prodotto**.
1. In Dettagli sulla versione, scegli **Specificare il repository di codice utilizzando un AWS CodeStar provider**, quindi scegli il link **Crea una nuova AWS CodeStar connessione**.
1. Dopo aver creato la connessione, aggiorna l'elenco delle connessioni, quindi seleziona la nuova connessione. Specificate i dettagli del repository, inclusi il **repository**, il **ramo** e il percorso del file **del modello**.
Per informazioni sull'utilizzo di un file di configurazione Terraform, vedere. [Sincronizzazione dei prodotti Terraform con i file modello di GitHub GitHub Enterprise o Bitbucket](#git-synced-Terraform)
1. (Facoltativo quando si crea una nuova risorsa di AWS Service Catalog prodotto) Nella sezione **Dettagli del supporto**, aggiungi i metadati per il prodotto.
1. (Facoltativo quando si crea una nuova risorsa di AWS Service Catalog prodotto) Nella sezione **Tag**, scegli **Aggiungi nuovo tag** e inserisci le coppie **Chiave** e **Valore**.
1. Scegli **Crea nuovo prodotto**.
**Per creare più prodotti sincronizzati con Git**
1. Nel pannello di navigazione a sinistra della AWS Service Catalog console, scegli **Elenco prodotti**, quindi scegli **Crea** più prodotti gestiti da git.
1. Inserisci i dettagli **comuni del prodotto**.
1. **In Dettagli del repository esterno, seleziona una **AWS CodeStar connessione**, quindi specifica il **repository e il ramo**.**
1. Nel riquadro Aggiungi prodotti, inserisci il **percorso del file del modello** e il nome **del prodotto**. Scegli **Aggiungi nuovo articolo** e continua ad aggiungere prodotti come desideri.
1. Dopo aver aggiunto tutti i prodotti desiderati, scegli **Creazione in blocco**.
**Per connettere un AWS Service Catalog prodotto esistente a un archivio esterno**
1. Nel pannello di navigazione a sinistra della AWS Service Catalog console, scegli **Elenco prodotti**, quindi scegli **Connetti i prodotti a un repository esterno**.
1. **Nella pagina Seleziona prodotti, seleziona i prodotti che desideri connettere a un repository esterno, quindi scegli Avanti.**
1. Nella pagina Specificare i dettagli dell'origine, seleziona una AWS CodeStar connessione esistente, quindi specifica il **repository**, il **ramo** e il percorso del **file modello**.
1. Scegli **Next (Successivo)**.
1. Nella pagina Rivedi e invia, verifica i dettagli della connessione, quindi scegli **Connetti i prodotti a un repository esterno**.
## Visualizzazione delle connessioni di prodotti sincronizzate con Git
Puoi utilizzare la AWS Service Catalog console, l'API o visualizzare i dettagli di connessione AWS CLI al repository. **Per AWS Service Catalog i prodotti collegati a un file modello, puoi recuperare le informazioni sulla connessione al repository e sull'ultima volta in cui il modello è stato sincronizzato con il prodotto dallo stato dell'ultima sincronizzazione.**
**Nota**
È possibile visualizzare le informazioni del repository e **lo stato dell'ultima sincronizzazione** a livello di prodotto. Gli utenti devono disporre delle autorizzazioni IAM CodeConnections APIs per visualizzare i dettagli del repository. Consulta [Autorizzazioni richieste per sincronizzare i AWS Service Catalog prodotti con i file modello](#required-perms-synced-repo) per ulteriori informazioni sulla politica richiesta per queste autorizzazioni IAM.
**Per visualizzare i dettagli della connessione e del repository utilizzando Console di gestione AWS**
1. Nel pannello di navigazione a sinistra, scegli **Elenco prodotti**.
1. Seleziona il prodotto dall'elenco.
1. Nella pagina **Prodotto**, accedi alla sezione **Dettagli sull'origine del prodotto**.
1. Per visualizzare l'ID di revisione di origine per una versione del prodotto, scegli il link **Ultima versione creata**. La sezione **Dettagli della versione** mostra l'ID di revisione di origine.
**Per visualizzare i dettagli della connessione e del repository utilizzando AWS CLI**
Da AWS CLI, esegui i seguenti comandi:
`$ aws servicecatalog describe-product-as-admin`
`$ aws servicecatalog describe-provisioning-artifact`
`$ aws servicecatalog search-product-as-admin`
`$ aws servicecatalog list-provisioning-artifacts`
## Aggiornamento delle connessioni dei prodotti sincronizzate con Git
Puoi aggiornare le connessioni degli account esistenti e i prodotti sincronizzati con Git utilizzando la AWS Service Catalog console, AWS Service Catalog l'API o. AWS CLI
Per informazioni su come collegare un AWS Service Catalog prodotto esistente a un file modello, consulta [Creazione di nuove connessioni di prodotto sincronizzate con Git](#create-synced-product).
**Per aggiornare i prodotti esistenti ai prodotti sincronizzati con Git**
1. Nel pannello di navigazione a sinistra, scegli **Elenco prodotti**, quindi scegli una delle seguenti opzioni:
+ Per aggiornare un **singolo prodotto**, seleziona il prodotto, vai alla sezione **Dettagli sull'origine del prodotto**, quindi scegli **Modifica dettagli**.
+ Per aggiornare **più prodotti**, scegli **Connetti prodotti a un repository esterno**, seleziona fino a dieci prodotti, quindi scegli **Avanti**.
1. Nella sezione **Dettagli sull'origine del prodotto**, esegui i seguenti aggiornamenti:
+ Specificare la connessione.
+ Specificare il repository.
+ Specificare il ramo.
+ Assegna un nome al file modello.
1. Scegli **Save changes** (Salva modifiche).
**Nota**
Per i prodotti non ancora collegati a un archivio esterno, puoi utilizzare l'opzione **Connetti a un archivio esterno** visualizzata nell'avviso nella parte superiore della pagina di informazioni sul prodotto dopo aver selezionato il prodotto.
Puoi anche utilizzare la AWS Service Catalog console o AWS CLI
+ Connect un AWS Service Catalog prodotto esistente a un file modello in un repository esterno
+ Aggiorna i metadati del prodotto, inclusi il nome, la descrizione e i tag del prodotto.
+ Riconfigura (aggiorna la sincronizzazione per utilizzare una fonte di repository diversa) una connessione per un prodotto precedentemente connesso. AWS Service Catalog
**Per aggiornare i dettagli della connessione e del repository utilizzando la console AWS Service Catalog**
1. Nel pannello di navigazione a sinistra della AWS Service Catalog console, scegli **Elenco prodotti**, quindi seleziona un prodotto attualmente connesso a un repository esterno.
1. Nella sezione **Dettagli sull'origine del prodotto**, scegli **Modifica l'origine del prodotto**.
1. Nella sezione **Dettagli sull'origine del prodotto**, specifica il nuovo repository desiderato.
1. Scegli **Save changes** (Salva modifiche).
**Per aggiornare i dettagli della connessione e del repository utilizzando AWS CLI**
Dal AWS CLI comando esegui il `$ aws servicecatalog update-provisioning-artifact` comando `$ aws servicecatalog update-product` and.
## Eliminazione delle connessioni di prodotti sincronizzate con Git
Puoi eliminare una connessione tra un AWS Service Catalog prodotto e un file modello utilizzando la AWS Service Catalog console, l'API o. CodeConnections AWS CLI Quando disconnetti un prodotto da un file modello, il AWS Service Catalog prodotto sincronizzato passa a un prodotto gestito regolarmente. *Dopo aver disconnesso il prodotto, se il file modello viene modificato e salvato nell'archivio precedentemente connesso, le modifiche non vengono riflesse.* Per ricollegare un AWS Service Catalog prodotto a un file modello in un repository esterno, consulta [Aggiornamento delle connessioni]() e dei prodotti sincronizzati. AWS Service Catalog
**Per disconnettere un prodotto sincronizzato con Git utilizzando la console AWS Service Catalog**
1. Nella Console di gestione AWS, scegli **Elenco prodotti** dal pannello di navigazione a sinistra.
1. Seleziona un prodotto dall'elenco.
1. Nella pagina **Prodotto**, accedi alla sezione **Dettagli sull'origine del prodotto**.
1. Scegli **Disconnetti**.
1. Conferma l'azione, quindi scegli **Disconnetti**.
**Per disconnettere un prodotto sincronizzato con Git utilizzando AWS CLI**
Da, esegui il comando. AWS CLI`$ aws servicecatalog update-product` Nell'`ConnectionParameters`input, rimuovi la connessione specificata.
**Per eliminare una connessione utilizzando l' CodeConnections API o AWS CLI**
Nell' CodeConnections API o AWS CLI, esegui il `$ aws codestar-connections delete-connection` comando.
## Sincronizzazione dei prodotti Terraform con i file modello di GitHub GitHub Enterprise o Bitbucket
Quando si crea un prodotto sincronizzato con Git utilizzando un file di configurazione Terraform, il percorso del file accetta solo il formato tar.gz. I formati delle cartelle Terraform non sono accettati nel percorso del file.
# Regione AWS supporto per prodotti sincronizzati con Git
AWS Service Catalog supporta prodotti sincronizzati con Git come indicato nella tabella Regioni AWS seguente.
****
| Regione AWS nome | Regione AWS identità | Support per prodotti sincronizzati con Git |
| --- | --- | --- |
| Stati Uniti orientali (Virginia settentrionale) | us-east-1 | Sì |
| Stati Uniti orientali (Ohio) | us-east-2 | Sì |
| Stati Uniti occidentali (California settentrionale) | us-west-1 | Sì |
| Stati Uniti occidentali (Oregon) | us-west-2 | Sì |
| Africa (Città del Capo) | af-south-1 | No |
| Asia Pacific (Hong Kong) | ap-east-1 | No |
| Asia Pacifico (Giacarta) | ap-southeast-3 | No |
| Asia Pacifico (Mumbai) | ap-south-1 | Sì |
| Asia Pacifico (Osaka) | ap-northeast-3 | No |
| Asia Pacific (Seoul) | ap-northeast-2 | Sì |
| Asia Pacifico (Singapore) | ap-southeast-1 | Sì |
| Asia Pacifico (Sydney) | ap-southeast-2 | Sì |
| Asia Pacifico (Tokyo) | ap-northeast-1 | Sì |
| Canada (Centrale) | ca-central-1 | Sì |
| Europa (Francoforte) | eu-central-1 | Sì |
| Europa (Irlanda) | eu-west-1 | Sì |
| Europa (Londra) | eu-west-2 | Sì |
| Europe (Milan) | eu-south-1 | No |
| Europa (Parigi) | eu-west-3 | Sì |
| Europa (Stoccolma) | eu-north-1 | Sì |
| Medio Oriente (Bahrein) | me-south-1 | No |
| Sud America (San Paolo) | sa-east-1 | Sì |
| AWS GovCloud (Stati Uniti orientali) | us-gov-east-1 | No |
| AWS GovCloud (Stati Uniti occidentali) | us-gov-west-1 | No |