L'AWS Marketplace API Reference è 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 pubblicare offerte di AMI-based 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, fare riferimento a Sviluppo di componenti personalizzati per l'immagine di Image Builder nella Guida per l'utente di Image Builder. Quando create il componente utilizzando Image Builder, assicuratevi di fare quanto segue:
-
Il componente e tutte le sue dipendenze sottostanti, come un bucket Amazon Simple Storage Service (Amazon S3), i segreti o i parametri, devono essere creati nella regione AWS Stati Uniti orientali (Virginia settentrionale) ().
us-east-1 -
Includi l'architettura supportata e tutte le dipendenze software nella descrizione del componente.
-
Testa il componente nel tuo AWS account creando una pipeline di immagini e distribuendo l'AMI creata dalla pipeline.
-
Se il componente contiene istruzioni per copiare binari, pacchetti o file da un bucket S3, usa il modulo di azione.
S3DownloadNelS3Downloadmodulo, persource, 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, assicuratevi che tutti i parametri abbiano valori predefiniti. Ad esempio, se avete un parametro denominato
region, assicuratevi di avere un valore predefinito valido comeus-east-1. Questi valori predefiniti servono per l' Marketplace AWS elaborazione e il test. Il test potrebbe avere esito negativo se non si includono i valori predefiniti. -
Se il componente utilizza Gestione dei segreti AWS Parameter Store o una funzionalità di AWS Systems Manager memorizzazione dei parametri, procedi come segue:
-
-
Per recuperare i valori in un unico passaggio nel 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 AWS account. 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 predefinito ditokenche 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 di Marketplace AWS test. Questi valori non verranno condivisi con gli acquirenti.
-
Marketplace AWS genera automaticamente Amazon Machine Images (AMI) per il tuo componente in tutte le versioni di 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 Marketplace AWS Catalog.
Per copiare l'ARN del componente Image Builder
-
Accedi alla Console di gestione AWS e apri la console Image Builder all'indirizzo. https://console.aws.amazon.com/imagebuilder/
-
Nella barra di navigazione a sinistra, in Risorse salvate, scegli Componenti.
-
Nella pagina Componenti, per Proprietario del filtro, scegli Di mia proprietà.
-
Scegli il nome del componente.
-
Nella pagina dei dettagli del componente, nella sezione Riepilogo, copia l'ARN.
Creazione in corso Marketplace AWS Policy IAM
Crea le seguenti policy 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 politiche di esempio fornite. Associate queste policy a un ruolo Marketplace AWS IAM. Per informazioni sulla creazione di policy, consulta Creating policies 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 di file binari Marketplace AWS da un bucket S3. Questa policy è richiesta solo se il componente utilizza il modulo di
S3Downloadazione e archivia 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 di Marketplace AWS recuperare i segreti archiviati in Secrets Manager. Questa politica è richiesta solo se il componente utilizza Secrets Manager per archiviare segreti. Assegnare un nome alla policy
mp_ib_sm_read_only. Per limitare la politica solo al tuo segreto, sostituisci laResourcesezione*nella sezione 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 politica è 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 policy solo al tuo segreto, sostituisci laResourcesezione*nella sezione con il tuo segreto.
Creando il Marketplace AWS Ruolo IAM
Utilizza la procedura seguente per creare un ruolo Marketplace AWS IAM con policy per concedere Marketplace AWS l'accesso al componente e alle sue dipendenze.
Per creare il 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.
-
Scegli Crea ruolo.
-
Seleziona Politica di fiducia personalizzata.
-
Inserisci la seguente dichiarazione:
-
Scegli Next (Successivo).
-
Aggiungete 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 AWS servizi.
-
Scegli Next (Successivo).
-
Inserisci un nome di ruolo, ad esempio
MPEC2IBIngestion. -
Scegli Crea ruolo.
Copia Marketplace AWS IAM role ARN (ARN del ruolo IAM)
Dopo aver creato il ruolo Marketplace AWS IAM, copia e salva il ruolo ARN. Utilizzerai l'ARN per pubblicare l'inserzione utilizzando l'API Marketplace AWS Catalog.
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.
Preparare 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 istanze 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 del componente: i dettagli includono il componente Amazon Resource Number (ARN), i dettagli sull'utilizzo e il ruolo AWS Identity and Access Management (IAM) che Marketplace AWS assumerà per elaborare il componente.
Pubblicazione dell'elenco dei prodotti dei componenti Image Builder
Questo argomento contiene le istruzioni per pubblicare l' Marketplace AWS elenco dei componenti EC2 Image Builder sull' Marketplace AWS utilizzo dell'API Catalog.
Prerequisiti
Assicuratevi di disporre di quanto segue prima di pubblicare l'elenco dei componenti 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) S3) accessibile pubblicamente per ospitare il logo e l'EULA della tua azienda, 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 Marketplace AWS prodotto componente EC2 Image Builder sull'utilizzo dell'API Catalog, consulta. Crea un prodotto
Aggiornamento delle informazioni sul prodotto del componente Image Builder
È possibile aggiornare le informazioni su un prodotto componente Image Builder sul portale di Marketplace AWS gestione.
Per aggiornare le informazioni sul prodotto dei componenti 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 corso di revisione» e, una volta completata, diventerà «Operata con successo».
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, create un file changeset in formato JSON. Nell'esempio, sostituiscilo
your-product-IDcon l'ID del prodotto ottenuto nel passaggio 1.new-version-nameSostituiscilo con il titolo della tua versione.new-delivery-option-titleSostituiscilo con 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 del changeset con il nome.
addIBversion.json -
Nel tuo 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
I seguenti errori 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 Image Builder. Per i messaggi di errore esistenti in campi come Usage InstructionsRecommended Instance type, eAccessRoleArn, vediAggiungi una nuova versione.
| Codice di errore | Messaggio di errore |
|---|---|
ASSET_NOT_FOUND |
|
ASSET_NOT_FOUND |
|
NOME_COMPONENTE DUPLICATO |
|
NOME_COMPONENTE DUPLICATO |
|
DUPLICATE_COMPONENT_ARN |
|
DUPLICATE_COMPONENT_ARN |
|
SCAN_ERROR |
|
ASSET_ACCESS_EXCEPTION |
|
ASSET_ACCESS_EXCEPTION |
|
ASSET_ACCESS_EXCEPTION |
|
ASSET_ACCESS_EXCEPTION |
|
PACCHETTO_IMAGE_BUILDER_COMPONENT_INVALID_IMAGE_ |
|
PACCHETTO_IMAGE_BUILDER_COMPONENT_COMPONENTE NON VALIDO |
|
TOO_MANY_IMAGE_BUILDER_COMPONENTS |
|
PROFILO_SELLER_PUBBLICO_INCOMPLETO |
|
DESCRIZIONE_NON VALIDA |
|
NOME_COMPONENTE NON VALIDO |
|
VERSIONE_OS_SUPPORTATA NON VALIDA |
|
INVALID_PATH_FORMAT |
|
TIPO_OS_INCOMPATIBILE |
|
ASSET_ACCESS_EXCEPTION |
|
ASSET_ACCESS_EXCEPTION |
|
INVALID_IB_COMPONENT_BUILD_VERSION |
|
INVALID_IB_COMPONENT_PARAMETER |
|
PARAMETRO_IB_COMPONENT_INVALID_ |
|
PARAMETRO_IB_COMPONENT_MANCANTE |
|
PARAMETRO_IB_COMPONENT_INVALID_ |
|
FAILED_LAUNCH_TEST |
|
SSHAuthFailedForUserAndKeypair |
|
INVALID_IB_COMPONENT |
|
DUPLICATE_VERSION_TITLE |
|
INVALID_VERSION_TITLE |
|
INVALID_VERSION_TITLE |
|
TITOLO_VERSIONE NON VALIDA |
|
INVALID_VERSION_TITLE |
|
INVALID_RELEASE_NOTES |
|
INVALID_RELEASE_NOTES |
|
NOTE_DI RILASCIO NON VALIDE |
|
INVALID_RELEASE_NOTES |
|
ISTRUZIONI_UTILIZZO_NON VALIDE |
|
INVALID_USAGE_INSTRUCTIONS |
|
ISTRUZIONI_UTILIZZO_NON VALIDE |
|
DUPLICATE_DELIVERY_OPTION_TITLES |
|
INVALID_DELIVERY_OPTION_TITLES |
|
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,
your-product-IDsostituiscilo con 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, sostituiscilo
your-product-IDcon l'ID del prodotto ottenuto nel passaggio 1.your-release-notesSostituiscilo con le tue note di rilascio. Sostituisciyour-delivery-option-IDcon l'ID dell'opzione di spedizione che hai ottenuto nel passaggio 3.your-usage-instructionsSostituiscilo con 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 del changeset con il nome.
updateVersionInfo.json -
Nel tuo 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 di una versione del prodotto componente Image Builder
La limitazione di una versione la rende non disponibile per gli acquirenti. È possibile limitare l' Marketplace AWS utilizzo dell'API Marketplace AWS Catalog per una versione del prodotto componente Image Builder. È necessario mantenere illimitata l'utilizzo di almeno una versione del prodotto. 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,
your-product-IDsostituiscilo con 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, sostituiscilo
your-product-IDcon l'ID del prodotto ottenuto nel passaggio 1. Sostituisciloyour-delivery-option-IDcon l'ID dell'opzione di spedizione che hai ottenuto 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 tuo 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 aziona Marketplace AWS automaticamente i moduli del WebDownload 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 di software in modo indipendente, esegui script bash che utilizzano i comandi o download. wget curl