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à. # Gestione di prodotti Puoi creare prodotti, aggiornare i prodotti creando una nuova versione basata su un modello aggiornato e raggruppare i prodotti in portafogli per distribuirli agli utenti. Le nuove versioni dei prodotti vengono propagate a tutti gli utenti che hanno accesso al prodotto tramite un portafoglio. Quando distribuisci un aggiornamento, gli utenti finali possono aggiornare i prodotti forniti esistenti. **Topics** + [Visualizzazione della pagina dei prodotti](#productmgmt-menu) + [Creazione di prodotti](productmgmt-cloudresource.md) + [Aggiungere prodotti ai portafogli](catalogs_portfolios_adding-products.md) + [Aggiornamento dei prodotti](productmgmt-update.md) + [Sincronizzazione dei prodotti con i file modello di GitHub GitHub Enterprise o Bitbucket](git-synced-sc-products.md) + [Eliminazione di prodotti](productmgmt-delete.md) + [Gestione delle versioni](managing-versions.md) ## Visualizzazione della pagina dei prodotti È possibile gestire i prodotti dalla pagina con l'**elenco dei prodotti** nella console di AWS Service Catalog amministrazione. **Per visualizzare la pagina con l'**elenco dei prodotti**** 1. Aprire la console Service Catalog all'indirizzo [https://console.aws.amazon.com/servicecatalog/](https://console.aws.amazon.com/servicecatalog/). 1. Scegli **Elenco prodotti**. # Creazione di prodotti Puoi creare prodotti dalla pagina **Prodotti** nella console dell' AWS Service Catalog amministratore. **Nota** La creazione di prodotti Terraform richiede una configurazione aggiuntiva, tra cui un motore di provisioning Terraform e un ruolo di lancio. Per ulteriori informazioni, consulta. [Guida introduttiva a un prodotto Terraform](getstarted-Terraform.md) **Per creare un nuovo AWS Service Catalog prodotto** 1. Vai alla pagina con l'**elenco dei prodotti**. 1. Scegli **Crea prodotto**, quindi scegli **Crea prodotto**. 1. **Dettagli del prodotto**: ti consente di scegliere il tipo di prodotto che desideri creare. AWS Service Catalog supporta CloudFormation i tipi di prodotto Terraform Cloud ed External (supporta Terraform Community Edition). I dettagli del prodotto contengono anche i metadati che appaiono quando cerchi e visualizzi i prodotti in un elenco o in una pagina prodotto. Immetti i seguenti dati: + **Product name** (Nome prodotto) – Il nome del prodotto. + **Descrizione del prodotto**: la descrizione viene visualizzata nell'elenco dei prodotti per aiutarti a scegliere il prodotto corretto. + **Proprietario**: la persona o l'organizzazione che pubblica questo prodotto. Il proprietario potrebbe essere il nome dell'organizzazione IT o l'amministratore. + **Distributore** (opzionale): il nome dell'editore dell'applicazione. Questo campo consente di ordinare l'elenco dei prodotti per facilitarne la ricerca. 1. **I dettagli sulla versione** consentono di aggiungere il file modello e creare il prodotto. Immetti i seguenti dati: + **Scegli il metodo**: esistono quattro modi per aggiungere un file modello. + **Usa un file modello locale**: carica un CloudFormation modello o un file di configurazione Terraform tar.gz da un'unità locale. + **Usa un URL Amazon S3: specifica un URL** che punti a un CloudFormation modello o a un file di configurazione Terraform tar.gz archiviato in Amazon S3. Se specifichi un URL Amazon S3, deve iniziare con. `https://` + **Usa un repository esterno**: specifica il tuo repository di GitHub codice, GitHub Enterprise o Bitbucket. AWS Service Catalog consente di sincronizzare i prodotti con i file modello. Per i prodotti Terraform, il formato di file modello deve essere un singolo file archiviato in Tar e compresso in Gzip. + **Usa uno CloudFormation stack esistente**: inserisci l'ARN per uno CloudFormation stack esistente. Questo metodo non supporta Terraform Cloud o prodotti esterni. + **Nome della versione** (opzionale): il nome della versione del prodotto (ad esempio, «v1", «v2beta»). Gli spazi non sono consentiti. + **Descrizione** (opzionale): una descrizione della versione del prodotto, incluso il modo in cui questa versione si differenzia dalle altre versioni. + **Guida**: gestita nella scheda delle versioni in una pagina dei **dettagli del prodotto**. Quando viene creata una versione del prodotto, durante il flusso di lavoro di creazione del prodotto, le linee guida per quella versione sono impostate come predefinite. [Per ulteriori informazioni sulle linee guida, consulta Gestione delle versioni.](https://docs.aws.amazon.com/servicecatalog/latest/adminguide/managing-versions.html) 1. **Support Details** identifica l'organizzazione all'interno dell'azienda e fornisce un punto di contatto per l'assistenza. Immetti i seguenti dati: + **Email contact** (E-mail di contatto) (facoltativo) – L'indirizzo e-mail a cui segnalare i problemi relativi al prodotto. + **Link di supporto** (opzionale): un URL a un sito in cui gli utenti possono trovare informazioni di supporto o ticket di file. L'URL deve iniziare con `http://` o `https://`. Gli amministratori sono responsabili del mantenimento dell'accuratezza e dell'accesso alle informazioni di supporto. + **Descrizione dell'assistenza** (opzionale): una descrizione di come utilizzare il collegamento **Email contact** and **Support**. 1. **Gestione dei tag** (opzionale): oltre a utilizzare i tag per classificare le risorse, puoi utilizzarli anche per autenticare le autorizzazioni necessarie per creare questa risorsa. 1. **Crea prodotto****: dopo aver completato il modulo, seleziona Crea prodotto.** Dopo alcuni secondi, il prodotto viene visualizzato nella pagina con l'**elenco dei prodotti**. È possibile che sia necessario aggiornare il browser per visualizzare il prodotto. È inoltre possibile utilizzarlo CodePipeline per creare e configurare una pipeline in cui distribuire il modello di prodotto AWS Service Catalog e apportare le modifiche apportate nell'archivio di origine. Per ulteriori informazioni, consulta [Tutorial: Create a pipeline](https://docs.aws.amazon.com/codepipeline/latest/userguide/tutorials-S3-servicecatalog.html) that deploys to. AWS Service Catalog È possibile definire le proprietà dei parametri nel modello CloudFormation o nel modello Terraform e applicare tali regole durante il provisioning. Queste proprietà possono definire la lunghezza minima e massima, i valori minimo e massimo, i valori consentiti e un'espressione regolare per il valore. AWS Service Catalog emette un avviso durante il provisioning se il valore fornito non aderisce alla proprietà del parametro. Per ulteriori informazioni sulle proprietà dei parametri, vedere [Parametri nella Guida](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/parameters-section-structure.html) per l'*CloudFormation utente*. ## Risoluzione dei problemi È necessario disporre dell'autorizzazione per recuperare oggetti dai bucket Amazon S3. Altrimenti, potresti riscontrare il seguente errore durante l'avvio o l'aggiornamento di un prodotto. ``` Error: failed to process product version s3 access denied exception ``` Se visualizzi questo messaggio, assicurati di disporre dell'autorizzazione per recuperare oggetti dai seguenti bucket: + Il bucket in cui è archiviato il modello di artefatto di provisioning. + Il bucket che inizia con "***cf-templates-\$1***" e dove memorizza il modello di artefatto di provisioning. AWS Service Catalog + ***Il bucket interno che inizia con "sc-\$1" e dove memorizza i metadati.*** AWS Service Catalog Non sarai in grado di vedere questo bucket dal tuo account. La seguente politica di esempio mostra le autorizzazioni minime necessarie per recuperare oggetti dai bucket menzionati in precedenza. ``` { "Sid": "VisualEditor1", "Effect": "Allow", "Action": "s3:GetObject*", "Resource": [ "arn:aws:s3:::YOUR_TEMPLATE_BUCKET", "arn:aws:s3:::YOUR_TEMPLATE_BUCKET/*", "arn:aws:s3:::cf-templates-*", "arn:aws:s3:::cf-templates-*/*", "arn:aws:s3:::sc-*", "arn:aws:s3:::sc-*/*" ] } ``` # Aggiungere prodotti ai portafogli Puoi aggiungere prodotti a qualsiasi numero di portafogli. Quando un prodotto viene aggiornato, tutti i portafogli (compresi i portafogli condivisi) che contengono il prodotto ricevono automaticamente la nuova versione. **Aggiunta di un prodotto dal catalogo a un portafoglio** 1. Vai alla pagina con l'**elenco dei prodotti**. 1. Seleziona un prodotto, quindi scegli **Azioni**. Dal menu a discesa, scegli **Aggiungi prodotto al portafoglio**. Verrai indirizzato alla pagina **Aggiungi *name-of-product* al portfolio**. 1. Scegli un portfolio, quindi scegli **Aggiungi prodotto al portafoglio**. Quando si aggiunge un prodotto Terraform a un portafoglio, il prodotto richiede un vincolo di lancio. Devi selezionare un ruolo IAM dal tuo account, inserire un ARN del ruolo IAM o inserire un nome di ruolo. Se specifichi un nome di ruolo e se un account utilizza il vincolo di avvio, l'account utilizza quel nome per il ruolo IAM. Ciò consente ai vincoli relativi al ruolo di avvio di essere indipendenti dall'account, garantendo la possibilità di creare meno risorse per account condiviso. Per dettagli e istruzioni, consulta [Passaggio 6: aggiungi un vincolo di lancio al tuo prodotto Terraform](getstarted-launchconstraint-Terraform.md) Un portafoglio può contenere numerosi prodotti che sono una combinazione di tipi di prodotti Terraform CloudFormation e diversi. # Aggiornamento dei prodotti Quando aggiorni il modello di un prodotto, crei una nuova versione del prodotto. Le nuove versioni del prodotto sono automaticamente disponibili per tutti gli utenti che hanno accesso a un portafoglio contenente il prodotto. **Nota** Quando si aggiorna un prodotto esistente, non è possibile modificare il tipo di prodotto (CloudFormation o Teraform). Ad esempio, se aggiorni un CloudFormation prodotto, non puoi sostituire il CloudFormation modello esistente con un file di configurazione Terraform tar.gz. È necessario aggiornare il file CloudFormation modello esistente con un nuovo file CloudFormation modello. Gli utenti finali che attualmente utilizzano un prodotto fornito della versione precedente del prodotto possono aggiornare il prodotto fornito alla nuova versione. Quando è disponibile una nuova versione di un prodotto, gli utenti possono utilizzare il comando **Update provisioned product nell'elenco dei prodotti Provisioned** **o nelle pagine dei dettagli del prodotto **Provisioned****. Prima di creare una nuova versione di un prodotto, AWS Service Catalog consiglia di testare gli aggiornamenti del prodotto nel CloudFormation o nel motore Terraform per assicurarsi che funzionino correttamente. **Creazione di una nuova versione di un prodotto** 1. Vai alla pagina con l'**elenco dei prodotti**. 1. Scegli il prodotto che desideri aggiornare. Verrai indirizzato alla pagina dei *dettagli del prodotto*. 1. Nella pagina dei *dettagli del prodotto*, espandi la scheda **Versioni**, quindi scegli **Crea nuova versione**. 1. In **Dettagli della versione**, procedi come segue: + **Scegli modello**: esistono quattro modi per aggiungere un file modello. *Usa un file modello locale*: carica un CloudFormation modello o un file di configurazione Terraform tar.gz da un'unità locale. *Usa un URL Amazon S3: specifica un URL* che punti a un CloudFormation modello o a un file di configurazione Terraform tar.gz archiviato in Amazon S3. Se specifichi un URL Amazon S3, deve iniziare con https://. *Usa un repository esterno*: specifica il tuo repository di GitHub codice, GitHub Enterprise o Bitbucket. AWS Service Catalog consente di sincronizzare i prodotti con i file modello. Per i prodotti Terraform, il formato di file modello deve essere un singolo file archiviato in Tar e compresso in Gzip. *Usa uno CloudFormation stack esistente*: inserisci l'ARN per uno CloudFormation stack esistente. Questo metodo non supporta Terraform Cloud o prodotti esterni. + **Titolo della versione**: il nome della versione del prodotto (ad esempio «v1", «v2beta»). Gli spazi non sono consentiti. + **Descrizione** (opzionale): una descrizione della versione del prodotto, incluso il modo in cui questa versione si differenzia dalla versione precedente. 1. Scegli **Crea versione del prodotto**. Puoi anche utilizzarla CodePipeline per creare e configurare una pipeline in cui distribuire il modello di prodotto e inserire AWS Service Catalog le modifiche nel tuo repository di origine. Per ulteriori informazioni, consulta [Tutorial: Create a pipeline](https://docs.aws.amazon.com/codepipeline/latest/userguide/tutorials-S3-servicecatalog.html) that deploys to. AWS Service Catalog # 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 | # Eliminazione di prodotti Quando elimini un prodotto, AWS Service Catalog rimuove tutte le versioni del prodotto da ogni portafoglio contenente il prodotto. AWS Service Catalog consente di eliminare un prodotto utilizzando la AWS Service Catalog console o AWS CLI. Per eliminare correttamente un prodotto, è necessario innanzitutto dissociare tutte le risorse associate al prodotto. Esempi di associazioni di risorse di prodotto includono associazioni di portafoglio TagOptions, budget e Service Actions. **Importante** Non è possibile ripristinare un prodotto dopo che è stato eliminato. **Per eliminare un prodotto utilizzando la AWS Service Catalog console** 1. Vai alla pagina **Portafogli** e seleziona il portfolio contenente il prodotto che desideri eliminare. 1. Seleziona il prodotto che desideri eliminare, quindi scegli **Elimina** nella parte superiore destra del riquadro del prodotto. 1. Per i prodotti *senza risorse associate*, conferma il prodotto che desideri eliminare inserendo **delete** nella casella di testo, quindi scegli **Elimina**. Per i prodotti *con risorse associate*, continua con il passaggio 4. 1. Nella finestra **Elimina prodotto**, esamina la tabella **Associazioni**, che mostra tutte le risorse associate al prodotto. AWS Service Catalog tenta di dissociare queste risorse quando si elimina il prodotto. 1. Conferma di voler eliminare il prodotto e rimuovere tutte le risorse associate inserendo **delete** nella casella di testo. 1. Scegli **Dissocia ed elimina**. Se non AWS Service Catalog è possibile dissociare tutte le risorse del prodotto, il prodotto non viene eliminato. La finestra **Elimina prodotto** mostra il numero di disassociazioni non riuscite e una descrizione per ogni errore. Per ulteriori informazioni sulla risoluzione delle disassociazioni di risorse non riuscite durante l'eliminazione di un prodotto, vedere *Risoluzione delle disassociazioni di risorse non riuscite durante l'eliminazione di un prodotto di seguito*. **Topics** + [Eliminazione di prodotti utilizzando il AWS CLI](product-delete-cli.md) + [Risoluzione delle disassociazioni di risorse non riuscite durante l'eliminazione di un prodotto](product-delete-exception.md) # Eliminazione di prodotti utilizzando il AWS CLI AWS Service Catalog ti consente di utilizzare il [AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html)(AWS CLI) per eliminare prodotti dal tuo portafoglio. AWS CLI È uno strumento open source che consente di interagire con i AWS servizi utilizzando i comandi nella shell della riga di comando. La funzione AWS Service Catalog force-delete richiede un [AWS CLI alias](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-alias.html), che è una scorciatoia che è possibile creare AWS CLI per abbreviare i comandi o gli script che si utilizzano di frequente. ## Prerequisiti + Istalla e configura la AWS CLI. [Per ulteriori informazioni, vedere [Installazione o aggiornamento della versione più recente di e Nozioni di base sulla configurazione](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html). AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-quickstart.html) Usa una AWS CLI versione minima di 1.11.24 o 2.0.0. + L'alias CLI di eliminazione del prodotto richiede un terminale compatibile con bash e il processore JSON a riga di comando JQ. [Per ulteriori informazioni sull'installazione del processore JSON a riga di comando, consulta Download jq.](https://stedolan.github.io/jq/download/) + Crea un AWS CLI alias per le chiamate `Disassociation` API in batch, che ti consente di eliminare un prodotto con un solo comando. Per eliminare correttamente un prodotto, devi prima dissociare tutte le risorse associate al prodotto. Esempi di associazioni di risorse di prodotto includono associazioni di portafoglio, budget, opzioni di tag e azioni di servizio. Quando si utilizza la CLI per eliminare un prodotto, l'`force-delete-product`alias CLI consente di chiamare l'`Disassociate`API per dissociare tutte le risorse che potrebbero impedire l'API. `DeleteProduct` In questo modo si evita una chiamata separata per le disassociazioni individuali. **Nota** I percorsi dei file illustrati nelle procedure seguenti possono variare a seconda del sistema operativo utilizzato per eseguire queste azioni. ## Creazione di un AWS CLI alias per eliminare i prodotti AWS Service Catalog Quando si utilizza AWS CLI per eliminare un AWS Service Catalog prodotto, l'`force-delete-product`alias CLI consente di chiamare l'`Disassociate`API per dissociare tutte le risorse che potrebbero impedire la chiamata. `DeleteProduct` **Crea un `alias` file nella tua cartella di configurazione AWS CLI** 1. Nella AWS CLI console, accedi alla cartella di configurazione. Per impostazione predefinita, il percorso della cartella di configurazione è `~/.aws/` su Linux e macOS o `%USERPROFILE%\.aws\` su Windows. 1. Crea una sottocartella denominata `cli` utilizzando la navigazione dei file o inserendo il seguente comando nel tuo terminale preferito: ``` $ mkdir -p ~/.aws/cli ``` Il percorso predefinito della `cli` cartella risultante è `~/.aws/cli/` su Linux e macOS o `%USERPROFILE%\.aws\cli` su Windows. 1. Nella nuova `cli` cartella, create un file di testo denominato `alias` senza estensione. È possibile creare il `alias` file utilizzando la navigazione dei file o inserendo il seguente comando nel terminale preferito: ``` $ touch ~/.aws/cli/alias ``` 1. Inserisci `[toplevel]` sulla prima riga. 1. Salvare il file. Successivamente, puoi aggiungere l' force-delete-productalias al tuo `alias` file incollando manualmente lo script di alias nel file o utilizzando un comando nella finestra del terminale. **Aggiungi manualmente l' force-delete-productalias al tuo file `alias`** 1. Nella AWS CLI console, accedi alla cartella di AWS CLI configurazione e apri il `alias` file. 1. Inserisci il seguente alias di codice nel file, sotto la `[toplevel]` riga: ``` [command servicecatalog] force-delete-product = !f() { if [ "$#" -ne 1 ]; then echo "Illegal number of parameters" exit 1 fi if [[ "$1" != prod-* ]]; then echo "Please provide a valid product id." exit 1 fi productId=$1 describeProductAsAdminResponse=$(aws servicecatalog describe-product-as-admin --id $productId) listPortfoliosForProductResponse=$(aws servicecatalog list-portfolios-for-product --product-id $productId) tagOptions=$(echo "$describeProductAsAdminResponse" | jq -r '.TagOptions[].Id') budgetName=$(echo "$describeProductAsAdminResponse" | jq -r '.Budgets[].BudgetName') portfolios=$(echo "$listPortfoliosForProductResponse" | jq -r '.PortfolioDetails[].Id') provisioningArtifacts=$(echo "$describeProductAsAdminResponse" | jq -r '.ProvisioningArtifactSummaries[].Id') provisioningArtifactServiceActionAssociations=() for provisioningArtifactId in $provisioningArtifacts; do listServiceActionsForProvisioningArtifactResponse=$(aws servicecatalog list-service-actions-for-provisioning-artifact --product-id $productId --provisioning-artifact-id $provisioningArtifactId) serviceActions=$(echo "$listServiceActionsForProvisioningArtifactResponse" | jq -r '[.ServiceActionSummaries[].Id] | join(",")') if [[ -n "$serviceActions" ]]; then provisioningArtifactServiceActionAssociations+=("${provisioningArtifactId}:${serviceActions}") fi done echo "Before deleting a product, the following associated resources must be disassociated. These resources will not be deleted. This action may take some time, depending on the number of resources being disassociated." echo "Portfolios:" for portfolioId in $portfolios; do echo "\t${portfolioId}" done echo "Budgets:" if [[ -n "$budgetName" ]]; then echo "\t${budgetName}" fi echo "Tag Options:" for tagOptionId in $tagOptions; do echo "\t${tagOptionId}" done echo "Service Actions on Provisioning Artifact:" for association in "${provisioningArtifactServiceActionAssociations[@]}"; do echo "\t${association}" done read -p "Are you sure you want to delete ${productId}? y,n " if [[ ! $REPLY =~ ^[Yy]$ ]]; then exit fi for portfolioId in $portfolios; do echo "Disassociating ${portfolioId}" aws servicecatalog disassociate-product-from-portfolio --product-id $productId --portfolio-id $portfolioId done if [[ -n "$budgetName" ]]; then echo "Disassociating ${budgetName}" aws servicecatalog disassociate-budget-from-resource --budget-name "$budgetName" --resource-id $productId fi for tagOptionId in $tagOptions; do echo "Disassociating ${tagOptionId}" aws servicecatalog disassociate-tag-option-from-resource --tag-option-id $tagOptionId --resource-id $productId done for association in "${provisioningArtifactServiceActionAssociations[@]}"; do associationPair=(${association//:/ }) provisioningArtifactId=${associationPair[0]} serviceActionsList=${associationPair[1]} serviceActionIds=${serviceActionsList//,/ } for serviceActionId in $serviceActionIds; do echo "Disassociating ${serviceActionId} from ${provisioningArtifactId}" aws servicecatalog disassociate-service-action-from-provisioning-artifact --product-id $productId --provisioning-artifact-id $provisioningArtifactId --service-action-id $serviceActionId done done echo "Deleting product ${productId}" aws servicecatalog delete-product --id $productId }; f ``` 1. Salvare il file. **Usa la finestra del terminale per aggiungere l' force-delete-productalias al tuo file `alias`** 1. Apri la finestra del terminale ed esegui il seguente comando `$ cat >> ~/.aws/cli/alias` 1. Incolla lo script di alias nella finestra del terminale, quindi premi *CTRL\$1D* per uscire dal comando. `cat` **Chiama l' force-delete-productalias** 1. Nella finestra del terminale, esegui il comando seguente per richiamare l'alias di eliminazione del prodotto `$ aws servicecatalog force-delete-product {product-id} ` L'esempio seguente mostra il comando `force-delete-product` alias e la risposta risultante ``` $ aws servicecatalog force-delete-product prod-123 ``` ``` Before deleting a product, the following associated resources must be disassociated. These resources will not be deleted. This action may take some time, depending on the number of resources being disassociated. Portfolios: port-123 Budgets: budgetName Tag Options: tag-123 Service Actions on Provisioning Artifact: pa-123:act-123 Are you sure you want to delete prod-123? y,n ``` 1. Inserisci `y` per confermare che desideri eliminare il prodotto. Dopo aver eliminato con successo il prodotto, la finestra del terminale visualizza i seguenti risultati ``` Disassociating port-123 Disassociating budgetName Disassociating tag-123 Disassociating act-123 from pa-123 Deleting product prod-123 ``` ## Risorse aggiuntive Per ulteriori informazioni sull' AWS CLI utilizzo degli alias e sull'eliminazione AWS Service Catalog dei prodotti, consulta le seguenti risorse: + [Creazione e utilizzo di AWS CLI alias](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-alias.html) nella guida per l'*AWS Command Line Interface utente (CLI*). + AWS CLI repository di [alias repository git](https://github.com/awslabs/awscli-aliases). + [Eliminazione di prodotti. AWS Service Catalog](https://docs.aws.amazon.com/servicecatalog/latest/adminguide/productmgmt-delete.html) + [AWS re:Invent 2016: The](https://youtu.be/Xc1dHtWa9-Q?t=1593) Effective User on. AWS CLI *YouTube* # Risoluzione delle disassociazioni di risorse non riuscite durante l'eliminazione di un prodotto Se il tuo precedente tentativo di [eliminare un prodotto](https://docs.aws.amazon.com/servicecatalog/latest/adminguide/productmgmt-delete.html) non è riuscito a causa di eccezioni relative alla dissociazione delle risorse, consulta l'elenco delle eccezioni e delle relative risoluzioni riportato di seguito. **Nota** Se hai chiuso la finestra **Eliminazione dei prodotti** prima di ricevere il messaggio di dissociazione delle risorse non riuscita, puoi seguire i passaggi da uno a tre della sezione *Elimina un prodotto* procedente per aprire nuovamente la finestra. **Per risolvere una disassociazione delle risorse non riuscita** Nella finestra **Elimina prodotto**, esamina la colonna **Stato** della tabella Associazioni. Identifica l'eccezione di dissociazione delle risorse non riuscita e le risoluzioni suggerite: **** | Tipo di eccezione di stato | Causa | Risoluzione | | --- | --- | --- | | Prodotto prod-\$1\$1\$1\$1 | AWS Service Catalog non è stato possibile eliminare il prodotto perché al prodotto sono ancora associati dei budget TagOptions, almeno uno alle azioni ProvisioningArtifact associate, il prodotto è ancora assegnato a un portfolio, il prodotto ha utenti o il prodotto ha dei vincoli. | Tenta di eliminare nuovamente il prodotto. | | Utente: non username è autorizzato a eseguire: | L'utente che tenta di eliminare il prodotto non dispone delle autorizzazioni necessarie per dissociare le risorse del prodotto. | AWS Service Catalog consiglia di contattare l'amministratore dell'account per ulteriori informazioni sulla dissociazione delle risorse del prodotto, per le quali attualmente non si dispone delle autorizzazioni necessarie. | # Gestione delle versioni Quando si crea un prodotto, è possibile assegnare le versioni del prodotto e aggiornarle in qualsiasi momento. Le versioni hanno un CloudFormation modello, un titolo, una descrizione, uno stato e una guida. ## Stato della versione Una versione può avere uno dei tre stati: + **Attiva** - Una versione attiva viene visualizzata nell'elenco delle versioni e consente agli utenti di avviarla. + **Inattiva** - Una versione inattiva è nascosta nell'elenco delle versioni. I prodotti con provisioning esistenti lanciati da questa versione non saranno interessati. + **Eliminata**: una versione eliminata viene rimossa dall'elenco delle versioni. L'eliminazione di una versione non può essere annullata. ## Indicazioni sulla versione È possibile impostare le indicazioni sulla versione per fornire informazioni agli utenti finali sulla versione del prodotto. Le indicazioni sulla versione riguardano solo le versioni attive del prodotto. Ci sono due opzioni per le indicazioni sulla versione: + **Nessuna**: per impostazione predefinita, le versioni del prodotto non dispongono di alcuna guida. Gli utenti finali possono utilizzare tale versione per aggiornare e lanciare i prodotti forniti. + **Obsoleto**: gli utenti non possono lanciare nuovi prodotti forniti utilizzando una versione del prodotto obsoleta. Se un prodotto con provisioning p lanciato in precedenza utilizza una versione ormai obsoleta, gli utenti possono aggiornare quel prodotto fornito solo utilizzando la versione esistente o una nuova versione. ## Aggiornamento delle versioni Quando si crea un prodotto, si assegnano le versioni del prodotto e si può anche aggiornare una versione in qualsiasi momento. Per ulteriori informazioni sulla creazione di un prodotto, consultare [Creazione di prodotti](productmgmt-cloudresource.md). **Per aggiornare la versione di un prodotto** 1. **Nella console, scegli Prodotti. AWS Service Catalog ** 1. Dall'elenco dei prodotti, scegliere il prodotto di cui si desidera aggiornare la versione. 1. Nella pagina **Product details (Dettagli prodotto)** scegliere la scheda **Versions (Versioni)**, quindi scegliere la versione che desideri aggiornare. 1. Nella pagina **Version details (Dettagli versione)** modificare la versione del prodotto, quindi scegliere **Save changes (Salva modifiche)**.