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).
Argomenti
- Autorizzazioni necessarie per sincronizzare i prodotti con file modello esterni
- Crea una connessione all'account
- Visualizzazione delle connessioni di prodotti sincronizzate con Git
- Aggiornamento delle connessioni dei prodotti sincronizzate con Git
- Eliminazione delle connessioni di prodotti sincronizzate con Git
- Sincronizzazione dei prodotti Terraform con i file modello di GitHub GitHub Enterprise o Bitbucket
- Regione AWS supporto per prodotti sincronizzati con Git
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 CatalogAWSServiceCatalogAdminFullAccess
gestita quando si abilitano prodotti sincronizzati con il repository.
{ "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. Puoi creare una connessione utilizzando la AWS Service Catalog console, la CodeConnections console AWS Command Line Interface (CLI) o CodeConnections le API.
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
Per creare un nuovo prodotto sincronizzato con Git
-
Nel pannello di navigazione a sinistra, scegli Elenco prodotti, quindi scegli Crea prodotto.
-
Inserisci i dettagli del prodotto.
-
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.
-
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
-
(Facoltativo quando si crea una nuova risorsa di AWS Service Catalog prodotto) Nella sezione Dettagli del supporto, aggiungi i metadati per il prodotto.
-
(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.
-
-
Scegli Crea nuovo prodotto.
Per creare più prodotti sincronizzati con Git
-
Nel pannello di navigazione a sinistra della AWS Service Catalog console, scegli Elenco prodotti, quindi scegli Crea più prodotti gestiti da git.
-
Inserisci i dettagli comuni del prodotto.
-
In Dettagli del repository esterno, seleziona una AWS CodeStar connessione, quindi specifica il repository e il ramo.
-
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.
-
Dopo aver aggiunto tutti i prodotti desiderati, scegli Creazione in blocco.
Per connettere un AWS Service Catalog prodotto esistente a un archivio esterno
-
Nel pannello di navigazione a sinistra della AWS Service Catalog console, scegli Elenco prodotti, quindi scegli Connetti i prodotti a un repository esterno.
-
Nella pagina Seleziona prodotti, seleziona i prodotti che desideri connettere a un repository esterno, quindi scegli Avanti.
-
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.
-
Seleziona Successivo.
-
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 nelle CodeConnections API per visualizzare i dettagli del repository. Per ulteriori informazioni sulla policy richiesta per queste autorizzazioni IAM, consulta Autorizzazioni richieste per sincronizzare i AWS Service Catalog prodotti con i file modello.
Per visualizzare i dettagli della connessione e del repository utilizzando AWS Management Console
-
Nel pannello di navigazione a sinistra, scegli Elenco prodotti.
-
Seleziona il prodotto dall'elenco.
-
Nella pagina Prodotto, accedi alla sezione Dettagli sull'origine del prodotto.
-
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.
Per aggiornare i prodotti esistenti ai prodotti sincronizzati con Git
-
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.
-
-
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.
-
-
Seleziona Salvataggio delle 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
-
Nel pannello di navigazione a sinistra della AWS Service Catalog console, scegli Elenco prodotti, quindi seleziona un prodotto attualmente connesso a un repository esterno.
-
Nella sezione Dettagli sull'origine del prodotto, scegli Modifica l'origine del prodotto.
-
Nella sezione Dettagli sull'origine del prodotto, specifica il nuovo repository desiderato.
-
Seleziona Salvataggio delle 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
-
Nella AWS Management Console, scegli Elenco prodotti dal pannello di navigazione a sinistra.
-
Seleziona un prodotto dall'elenco.
-
Nella pagina Prodotto, accedi alla sezione Dettagli sull'origine del prodotto.
-
Scegli Disconnetti.
-
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.