L'API Reference di AWS Marketplace è stato ristrutturato. Per ulteriori informazioni sulle operazioni API supportate, consulta l'AWS Marketplace API Reference.
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à.
Lavora con i prodotti componenti EC2 Image Builder
In qualità di venditore di AWS Marketplace, puoi elencare AMI-based i prodotti consegnati agli acquirenti di AWS Marketplace utilizzando i componenti EC2 Image Builder. Per creare il tuo componente e pubblicare un Marketplace AWS elenco, procedi in sequenza attraverso le seguenti sezioni.
Argomenti
Creazione e test del componente Image Builder
Crea e testa il tuo componente su Image Builder. Per istruzioni, consulta Sviluppare componenti personalizzati per l'immagine di Image Builder nella Guida per l'utente di Image Builder. Quando crei il tuo componente usando Image Builder, assicurati di fare quanto segue:
-
Il componente e tutte le sue dipendenze sottostanti, ad esempio un bucket Amazon Simple Storage Service (Amazon S3), i segreti o i parametri, devono essere creati nella regione AWS degli Stati Uniti orientali (Virginia settentrionale) (
us-east-1). -
Includi l'architettura supportata e le eventuali dipendenze software nella descrizione del componente.
-
Testa il componente nel tuo AWS account creando una pipeline di immagini e implementando l'AMI creata dalla pipeline.
-
Se il componente contiene istruzioni per copiare file binari, pacchetti o file da un bucket S3, usa il modulo di azione.
S3DownloadNelS3Downloadmodulo, forsource, inserisci la posizione statica del tuo file nel bucket S3. L'esempio seguente copia un file binario da un bucket S3 come parte dell'installazione del componente.- name: DownloadMyFile action: S3Download inputs: - source: s3://amzn-s3-demo-source-bucket/path/to/package.zip destination: C:\myfolder\package.zip -
I componenti possono importare file fino a 2 GB quando utilizzano l'azione.
S3Download -
Se il componente utilizza parametri, assicurati che tutti i parametri abbiano valori predefiniti. Ad esempio, se hai un parametro denominato
region, assicurati di avere un valore predefinito valido, ad esempious-east-1. Questi valori predefiniti sono destinati all' Marketplace AWS elaborazione e al test. Il test potrebbe fallire se non si includono i valori predefiniti. -
Se il componente utilizza AWS Secrets Manager Parameter Store o una funzionalità di AWS Systems Manager memorizzazione dei parametri, effettuate le seguenti operazioni:
-
-
Per recuperare i valori come fase del componente, incorporate AWS Command Line Interface i comandi nel file di configurazione YAML.
-
Crea una voce corrispondente in Secrets Manager o Parameter Store nel tuo account. AWS Utilizzate la chiave predefinita e fornite un valore valido che vi aiuterà a creare il componente durante il processo di Marketplace AWS test. Ad esempio, supponiamo di avere un parametro chiamato
saas_tokencon un valore predefinitotokenche utilizza Parameter Store. In questo caso, create una coppia chiave-valore in Parameter Store. Usatokencome chiave. Per il valore, inserisci un token SaaS valido per la tua applicazione.Tieni presente che i valori memorizzati nel tuo account Marketplace AWS venditore verranno utilizzati solo a scopo Marketplace AWS di test. Questi valori non saranno condivisi con gli acquirenti.
-
Marketplace AWS genera automaticamente Amazon Machine Images (AMI) per il tuo componente in tutte le versioni del sistema operativo compatibili scelte durante il processo di creazione del componente. Quando crei il tuo componente, scegli almeno una versione del sistema operativo compatibile. Convalida la compatibilità del componente con tutte le versioni del sistema operativo scelte utilizzando le pipeline EC2 Image Builder per creare e testare le AMI.
-
Copiare l'ARN del componente
Dopo aver creato e testato il componente su Image Builder, copiate e salvate l'ARN del componente. Utilizzerai l'ARN quando pubblicherai l'elenco dei prodotti utilizzando l'API del Marketplace AWS catalogo.
Per copiare il componente Image Builder ARN
-
Accedi alla Console di gestione AWS e apri la console Image Builder all'indirizzohttps://console.aws.amazon.com/imagebuilder/
. -
Nella barra di navigazione a sinistra, in Risorse salvate, scegli Componenti.
-
Nella pagina Componenti, per Proprietario del filtro, scegli Proprietario mio.
-
Scegliete il nome del componente.
-
Nella pagina dei dettagli del componente, nella sezione Riepilogo, copiate l'ARN.
Creazione in corso Marketplace AWS Policy IAM
Crea le seguenti politiche IAM per concedere Marketplace AWS l'accesso al tuo componente Image Builder e alle risorse correlate come i bucket e i segreti di Amazon S3. Utilizza le policy di esempio fornite. Alleghi queste politiche a un ruolo Marketplace AWS IAM. Per assistenza nella creazione di policy, consulta Creazione di policy using the JSON editor nella IAM User Guide.
-
Politica get-component di Image Builder, per consentire l'accesso Marketplace AWS al componente su Image Builder. Questa politica è obbligatoria. Assegnare un nome alla policy
mp_ib_ingest. -
Politica di accesso in lettura di Amazon S3, per consentire il recupero dei file binari Marketplace AWS da un bucket S3. Questa policy è richiesta solo se il componente utilizza il modulo di
S3Downloadazione e memorizza i file binari associati in un bucket S3. Assegnare un nome alla policymp_ib_s3_read_only. -
Politica di accesso in lettura di Secrets Manager, per consentire il recupero dei segreti archiviati Marketplace AWS in Secrets Manager. Questa politica è richiesta solo se il componente utilizza Secrets Manager per archiviare i segreti. Assegnare un nome alla policy
mp_ib_sm_read_only. Per limitare la politica solo al tuo segreto, sostituisci la*Resourcesezione con il tuo segreto. -
Politica di accesso in lettura di Parameter Store, Marketplace AWS per consentire il recupero dei segreti archiviati in Parameter Store. Questa policy è richiesta solo se il componente utilizza Parameter Store per archiviare i segreti. Assegnare un nome alla policy
mp_ib_ssm_parameter_read_only. Per limitare la politica solo al tuo segreto, sostituisci laResourcesezione*nella sezione con il tuo segreto.
Creando il Marketplace AWS Ruolo IAM
Usa la seguente procedura per creare un ruolo Marketplace AWS IAM con politiche per concedere Marketplace AWS l'accesso al tuo componente e alle sue dipendenze.
Per creare Marketplace AWS Ruolo IAM
-
Accedi alla console di AWS gestione e apri la console IAM all'indirizzo https://console.aws.amazon.com/iam/
. -
Nella barra di navigazione a sinistra, scegli Ruoli.
-
Scegliere Crea ruolo.
-
Seleziona Politica di fiducia personalizzata.
-
Inserisci la seguente dichiarazione:
-
Scegli Avanti.
-
Aggiungi la policy get-component di Image Builder creata in precedenza. La politica get-component è obbligatoria. Aggiungi le politiche pertinenti per S3, Secrets Manager e Parameter Store se il tuo componente utilizza questi servizi. AWS
-
Scegli Avanti.
-
Inserisci un nome per il ruolo, ad esempio
MPEC2IBIngestion. -
Scegliere Crea ruolo.
Copia Marketplace AWS IAM role ARN (ARN del ruolo IAM)
Dopo aver creato il ruolo Marketplace AWS IAM, copia e salva l'ARN del ruolo. Utilizzerai l'ARN per pubblicare l'elenco utilizzando l'API del Marketplace AWS catalogo.
Per copiare il Marketplace AWS IAM role ARN (ARN del ruolo IAM)
-
Nella console IAM, nella barra di navigazione a sinistra, scegli Ruoli.
-
Scegli il ruolo Marketplace AWS IAM che hai creato in precedenza, ad esempio
MPEC2IBIngestion. -
Nella pagina dei dettagli del ruolo, nella sezione Riepilogo, copia l'ARN.
Prepara l'elenco dei componenti di Image Builder
Prima di pubblicare l' Marketplace AWS inserzione, assicurati di avere a portata di mano le seguenti informazioni:
-
Metadati del prodotto: i metadati includono il logo del prodotto, il titolo del prodotto, il contratto di licenza con l'utente finale, i tipi di istanza supportati e la regione AWS.
-
Informazioni sui prezzi: puoi offrire il tuo prodotto gratuitamente, a una tariffa oraria o a una tariffa oraria con un periodo di prova gratuito iniziale. La licenza Bring your own (BYOL) non è supportata.
-
Dettagli sui componenti: i dettagli includono l'Amazon Resource Number (ARN) del componente, i dettagli di utilizzo e il ruolo AWS Identity and Access Management (IAM) che Marketplace AWS assumerà nell'elaborazione del componente.
Pubblicazione della lista di prodotti dei componenti di Image Builder
Questo argomento contiene le istruzioni per pubblicare l'elenco dei componenti EC2 Image Builder Marketplace AWS utilizzando l'API del Marketplace AWS catalogo.
Prerequisiti
Assicurati di disporre di quanto segue prima di pubblicare l'elenco dei prodotti dei componenti di Image Builder:
-
Registrazione come venditore in Marketplace AWS. Per ulteriori informazioni, consulta Registrati come venditore di AWS Marketplace
. -
Un utente IAM con
AWSMarketplaceSellerFullAccessautorizzazione. -
Un bucket Amazon Simple Storage Service (Amazon S3) accessibile al pubblico per ospitare il logo della tua azienda e l'EULA, se utilizzato nel tuo componente. Inserirai l'URL del bucket S3 nel tuo file JSON.
ChangeSet -
AWS Command Line Interface ().AWS CLI Per ulteriori informazioni, consulta Cos'è l'interfaccia a riga di comando di AWS? nella Guida AWS Command Line Interface per l'utente.
Creazione di un prodotto componente Image Builder su Marketplace AWS
Per creare un prodotto componente EC2 Image Builder Marketplace AWS utilizzando l'API Catalog, fare riferimento aCrea un prodotto.
Aggiornamento delle informazioni sul prodotto del componente Image Builder
È possibile aggiornare le informazioni su un prodotto componente di Image Builder sul portale di Marketplace AWS gestione.
Per aggiornare le informazioni sul prodotto di un componente Image Builder
-
Apri Portale di gestione Marketplace AWS
e accedi al tuo account venditore. -
Nel menu Prodotti, scegli Server.
-
Nella pagina dei prodotti Server, seleziona il prodotto.
-
Nella pagina dei dettagli del prodotto, nel menu Richiedi modifiche, scegli la voce che corrisponde alle informazioni che desideri aggiornare.
-
Dopo aver inviato le modifiche, la richiesta verrà visualizzata nella scheda Richieste con lo stato «In fase di revisione» e diventerà «Completata» una volta completata.
Aggiungere una nuova versione a un prodotto componente Image Builder esistente
È possibile aggiungere una nuova versione a un prodotto componente Image Builder Marketplace AWS utilizzando il AWS Marketplace Catalog API.
Per aggiungere una nuova versione
-
Da Portale di gestione Marketplace AWS, ottieni l'ID del prodotto.
-
Apri Portale di gestione Marketplace AWS
e accedi al tuo Account venditore. -
Nel menu Prodotti, scegli Server.
-
Nella pagina dei prodotti Server, seleziona il prodotto.
-
Nel riepilogo del prodotto, copia l'ID del prodotto.
-
-
Utilizzando il seguente esempio di codice, crea un file changeset in formato JSON. Nell'esempio, sostituisci
your-product-IDcon l'ID del prodotto ottenuto nel passaggio 1. Sostituiscilonew-version-namecon il titolo della tua versione. Sostituiscilonew-delivery-option-titlecon il titolo dell'opzione di spedizione.[ { "ChangeType": "AddDeliveryOptions", "Entity": { "Identifier": "your-product-ID", "Type": "AmiProduct@1.0" }, "DetailsDocument": { "Version": { "VersionTitle": "new-version-name", "ReleaseNotes": "Release notes goes here." }, "DeliveryOptions": [ { "DeliveryOptionTitle": "new title", "Details": { "Ec2ImageBuilderComponentDeliveryOptionDetails": { "UsageInstructions": "Test usage instructions for IB", "AccessRoleArn": "arn:aws:iam::123456789:role/sample", "ComponentArn": "arn:aws:imagebuilder:us-east-1:123456789:component/sample/2.0.0/1" } } } ] } } ] -
Salva il file changeset con il nome.
addIBversion.json -
Nel terminale oppure AWS CloudShell, esegui il seguente comando:
aws marketplace-catalog start-change-set --catalog AWSMarketplace --region us-east-1 --change-set file://addIBversion.json
Il start-change-set comando restituirà un ChangeSetId valore. Per monitorare un set di modifiche, vedereMonitoraggio di un set di modifiche.
Errori asincroni
Gli errori seguenti sono specifici AddDeliveryOptions delle azioni in. AWS Marketplace Catalog API Questi errori vengono restituiti quando si chiama DescribeChangeSet dopo l'elaborazione di un set di modifiche. Per ulteriori informazioni sull'utilizzo DescribeChangeSet per ottenere lo stato di una richiesta di modifica, vedereUtilizzo dei set di modifiche.
Nota
I seguenti codici di errore sono specifici del metodo di consegna di Image Builder. Per i messaggi di errore esistenti su campi comeUsage Instructions,Recommended Instance type, eAccessRoleArn, vedereAggiungi una nuova versione.
| Codice di errore | Messaggio di errore |
|---|---|
ASSET_NOT_FOUND |
|
RISORSA NON TROVATA |
|
NOME_COMPONENTE DUPLICATO |
|
NOME_COMPONENTE DUPLICATO |
|
DUPLICATE_COMPONENT_ARN |
|
DUPLICATE_COMPONENT_ARN |
|
ERRORE DI SCANSIONE |
|
ASSET_ACCESS_EXCEPTION |
|
ASSET_ACCESS_EXCEPTION |
|
ASSET_ACCESS_EXCEPTION |
|
ASSET_ACCESS_EXCEPTION |
|
PACCHETTO_IMAGE_BUILDER_COMPONENT_NON VALIDO |
|
PACCHETTO_IMAGE_BUILDER_COMPONENT_NON VALIDO |
|
TROPPO_MANY_IMAGE_BUILDER_COMPONENTS |
|
PROFILO_PUBBLICO_VENDITORE INCOMPLETO |
|
DESCRIZIONE_NON VALIDA |
|
NOME_COMPONENTE NON VALIDO |
|
VERSIONE_OS_SUPPORTATA NON VALIDA |
|
FORMATO_PERCORSO_NON VALIDO |
|
INCOMPATIBLE_OS_TYPE |
|
ASSET_ACCESS_EXCEPTION |
|
ASSET_ACCESS_EXCEPTION |
|
INVALID_IB_COMPONENT_BUILD_VERSION |
|
INVALID_IB_COMPONENT_PARAMETER |
|
PARAMETRO INVALID_IB_COMPONENT_ |
|
MISSING_IB_COMPONENT_PARAMETER |
|
INVALID_IB_COMPONENT_PARAMETER |
|
TEST_LAUNCH_FALLITO |
|
SSHAuthFailedForUserAndKeypair |
|
COMPONENTE INVALIDO |
|
DUPLICATE_VERSION_TITLE |
|
TITOLO_VERSIONE_NON VALIDO |
|
TITOLO_VERSIONE_NON VALIDO |
|
INVALID_VERSION_TITLE |
|
TITOLO_VERSIONE_NON VALIDO |
|
NOTE_DI_RELEASE NON VALIDE |
|
NOTE_DI_RELEASE NON VALIDE |
|
INVALID_RELEASE_NOTES |
|
NOTE_DI_RELEASE NON VALIDE |
|
ISTRUZIONI_DI_USO NON VALIDE |
|
ISTRUZIONI_DI_USO NON VALIDE |
|
INVALID_USAGE_INSTRUCTIONS |
|
TITOLI DELLE OPZIONI_DI_CONSEGNA DUPLICATI |
|
TITOLI DELLE OPZIONI_DI_CONSEGNA NON VALIDI |
|
Aggiornamento delle informazioni su una versione esistente
Per aggiornare le informazioni su una versione esistente
-
Da Portale di gestione Marketplace AWS, ottieni l'ID del prodotto.
-
Apri Portale di gestione Marketplace AWS
e accedi al tuo Account venditore. -
Nel menu Prodotti, scegli Server.
-
Nella pagina dei prodotti Server, seleziona il prodotto.
-
Nel riepilogo del prodotto, copia l'ID del prodotto.
-
-
Nel tuo terminale, esegui il seguente comando. Nel comando, sostituisci
your-product-IDcon l'ID ottenuto nel passaggio 1.aws marketplace-catalog describe-entity --catalog AWSMarketplace --region us-east-1 --entity-id 'your-product-ID' -
Nell'output restituito, vai alla
VersionssezioneDetailsDocument, Copia ilIdvaloreDeliveryOptions, per la versione che desideri aggiornare. -
Utilizzando il seguente esempio di codice, create un file changeset in formato JSON. Nell'esempio, sostituisci
your-product-IDcon l'ID del prodotto ottenuto nel passaggio 1. Sostituisciyour-release-notescon le tue note di rilascio. Sostituisciyour-delivery-option-IDcon l'ID dell'opzione di spedizione ottenuta nel passaggio 3. Sostituisciloyour-usage-instructionscon le tue istruzioni per l'uso.[ { "ChangeType": "UpdateDeliveryOptions", "Entity": { "Identifier": "your-product-ID", "Type": "AmiProduct@1.0" }, "DetailsDocument": { "Version": { "ReleaseNotes": "your-release-notes" }, "DeliveryOptions": [ { "Id": "your-delivery-option-ID", "Details": { "Ec2ImageBuilderComponentDeliveryOptionDetails": { "UsageInstructions": "your-usage-instructions" } } } ] } } ] -
Salva il file changeset con il nome.
updateVersionInfo.json -
Nel terminale oppure AWS CloudShell, esegui il seguente comando:
aws marketplace-catalog start-change-set --catalog AWSMarketplace --region us-east-1 --change-set file://updateVersionInfo.json
Il start-change-set comando restituirà un ChangeSetId valore. Per monitorare un set di modifiche, vedereMonitoraggio di un set di modifiche.
Limitazione della versione del prodotto di un componente Image Builder
La limitazione di una versione la rende non disponibile per gli acquirenti. Puoi limitare l' Marketplace AWS utilizzo dell'API Marketplace AWS Catalog per una versione del tuo componente Image Builder. È necessario mantenere almeno una versione del prodotto senza restrizioni Marketplace AWS. Non puoi limitare l'accesso all'unica versione pubblica.
Per aggiornare le informazioni su una versione esistente
-
Da Portale di gestione Marketplace AWS, ottieni l'ID del prodotto.
-
Apri Portale di gestione Marketplace AWS
e accedi al tuo Account venditore. -
Nel menu Prodotti, scegli Server.
-
Nella pagina dei prodotti Server, seleziona il prodotto.
-
Nel riepilogo del prodotto, copia l'ID del prodotto.
-
-
Nel tuo terminale, esegui il seguente comando. Nel comando, sostituisci
your-product-IDcon l'ID ottenuto nel passaggio 1.aws marketplace-catalog describe-entity --catalog AWSMarketplace --region us-east-1 --entity-id 'your-product-ID' -
Nell'output restituito, vai alla
VersionssezioneDetailsDocument, Copia ilIdvaloreDeliveryOptions, per la versione che desideri aggiornare. -
Utilizzando il seguente esempio di codice, create un file changeset in formato JSON. Nell'esempio, sostituisci
your-product-IDcon l'ID del prodotto ottenuto nel passaggio 1. Sostituisciyour-delivery-option-IDcon l'ID dell'opzione di spedizione ottenuta nel passaggio 3.[ { "ChangeType": "RestrictDeliveryOptions", "Entity": { "Identifier": "your-product-ID", "Type": "AmiProduct@1.0" }, "DetailsDocument": { "DeliveryOptionIds": [ "your-delivery-option-ID" ] } } ] -
Salva il file changeset con il nome.
restrictec2ibversion.json -
Nel terminale oppure AWS CloudShell, esegui il seguente comando:
aws marketplace-catalog start-change-set --catalog AWSMarketplace --region us-east-1 --change-set file://restrictec2ibversion.json
Il start-change-set comando restituirà un ChangeSetId valore. Per monitorare un set di modifiche, vedereMonitoraggio di un set di modifiche.
Monitoraggio di un set di modifiche
Il start-change-set comando restituirà un ChangeSetId valore. È possibile monitorare l'avanzamento del set di modifiche nei seguenti modi:
-
Esegui il seguente comando nel tuo terminale. Nel comando. sostituisci
changeset-IDcon ilChangeSetIdvalore restituito dalstart-change-setcomando.aws marketplace-catalog describe-change-set ‐‐catalog AWSMarketplace ‐‐change-set-idchangesetID -
Visualizza lo stato della richiesta nella scheda Richieste del portale di
Marketplace AWS gestione.
Protezione dei download di software
Per salvaguardare la proprietà intellettuale del software ISV e garantire una distribuzione stabile e coerente del software agli Marketplace AWS acquirenti, analizza S3Download e Marketplace AWS WebDownload interviene automaticamente sui moduli presenti nel componente. I file di riferimento vengono quindi archiviati in modo sicuro in un bucket Amazon S3 privato gestito da. Marketplace AWS Per disattivare questo processo di inserimento e gestire i download del software in modo indipendente, esegui script bash che utilizzano i comandi or download. wget curl