View a markdown version of this page

Arbeiten Sie mit EC2 Image Builder-Komponentenprodukten - AWS Marketplace

Die AWS Marketplace-API-Referenz wurde umstrukturiert. Weitere Informationen zu den unterstützten API-Vorgängen finden Sie in der AWS Marketplace-API-Referenz.

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Arbeiten Sie mit EC2 Image Builder-Komponentenprodukten

Als AWS Marketplace-Verkäufer können Sie AMI-based Produkte anbieten, die mithilfe von EC2 Image Builder-Komponenten an AWS Marketplace-Käufer geliefert werden. Gehen Sie nacheinander durch die folgenden Abschnitte, um Ihre Komponente zu erstellen und ein AWS Marketplace Angebot zu veröffentlichen.

Erstellen und Testen Ihrer Image Builder-Komponente

Erstellen und testen Sie Ihre Komponente in Image Builder. Anweisungen finden Sie unter Entwickeln benutzerdefinierter Komponenten für Ihr Image Builder-Image im Image Builder-Benutzerhandbuch. Wenn Sie Ihre Komponente mit Image Builder erstellen, stellen Sie sicher, dass Sie Folgendes tun:

  • Die Komponente und alle ihr zugrunde liegenden Abhängigkeiten, wie z. B. ein Amazon Simple Storage Service (Amazon S3) -Bucket, Geheimnisse oder Parameter, müssen in der AWS-Region USA Ost (Nord-Virginia) (us-east-1) erstellt werden.

  • Nehmen Sie die unterstützte Architektur und alle Softwareabhängigkeiten in die Komponentenbeschreibung auf.

  • Testen Sie Ihre Komponente in Ihrem AWS Konto, indem Sie eine Image-Pipeline erstellen und das von der Pipeline erstellte AMI bereitstellen.

  • Wenn Ihre Komponente Anweisungen zum Kopieren von Binärdateien, Paketen oder Dateien aus einem S3-Bucket enthält, verwenden Sie das S3Download Aktionsmodul. Geben Sie im S3Download Modul z. source B. den statischen Speicherort Ihrer Datei im S3-Bucket ein. Im folgenden Beispiel wird im Rahmen der Komponenteninstallation eine Binärdatei aus einem S3-Bucket kopiert.

    - name: DownloadMyFile action: S3Download inputs: - source: s3://amzn-s3-demo-source-bucket/path/to/package.zip destination: C:\myfolder\package.zip
  • Komponenten können Dateien mit bis zu 2 GB aufnehmen, wenn sie die S3Download Aktion verwenden.

  • Wenn Ihre Komponente Parameter verwendet, stellen Sie sicher, dass alle Parameter Standardwerte haben. Wenn Sie beispielsweise einen Parameter benannt habenregion, stellen Sie sicher, dass Sie einen gültigen Standardwert wie habenus-east-1. Diese Standardwerte dienen der AWS Marketplace Verarbeitung und dem Testen. Das Testen kann fehlschlagen, wenn Sie keine Standardwerte angeben.

  • Wenn Ihre Komponente Parameter Store oder eine Funktion von AWS Systems Manager zum Speichern von Parametern verwendet AWS Secrets Manager, gehen Sie wie folgt vor:

    • Um Werte als Schritt in Ihrer Komponente abzurufen, betten Sie AWS Command Line Interface Befehle in Ihre YAML-Konfigurationsdatei ein.

    • Erstellen Sie einen entsprechenden Eintrag in Secrets Manager oder Parameter Store in Ihrem AWS Konto. Verwenden Sie den Standardschlüssel und geben Sie einen gültigen Wert an, der beim Erstellen der Komponente während des AWS Marketplace Testvorgangs hilft. Nehmen wir zum Beispiel an, Sie haben einen Parameter saas_token mit dem Standardwert aufgerufentoken, der Parameter Store verwendet. Erstellen Sie in diesem Fall ein Schlüssel-Wert-Paar im Parameter Store. tokenAls Schlüssel verwenden. Geben Sie für den Wert ein gültiges SaaS-Token für Ihre Anwendung ein.

      Beachten Sie, dass die in Ihrem AWS Marketplace Verkäuferkonto gespeicherten Werte nur zu AWS Marketplace Testzwecken verwendet werden. Diese Werte werden nicht an Käufer weitergegeben.

    • AWS Marketplace generiert automatisch Amazon Machine Images (AMIs) für Ihre Komponente für alle kompatiblen Betriebssystemversionen, die Sie bei der Komponentenerstellung ausgewählt haben. Wählen Sie beim Erstellen Ihrer Komponente mindestens eine kompatible Betriebssystemversion aus. Überprüfen Sie die Kompatibilität Ihrer Komponente mit allen ausgewählten Betriebssystemversionen, indem Sie EC2 Image Builder-Pipelines verwenden, um AMIs zu erstellen und zu testen.

Kopieren des Komponenten-ARN

Nachdem Sie die Komponente in Image Builder erstellt und getestet haben, kopieren und speichern Sie den Komponenten-ARN. Sie verwenden den ARN, wenn Sie die Produktliste mithilfe der AWS Marketplace Catalog API veröffentlichen.

Um den ARN der Image Builder-Komponente zu kopieren
  1. Melden Sie sich bei der AWS Management Console an und öffnen Sie die Image Builder-Konsole unterhttps://console.aws.amazon.com/imagebuilder/.

  2. Wählen Sie in der linken Navigationsleiste unter Gespeicherte Ressourcen die Option Komponenten aus.

  3. Wählen Sie auf der Seite Komponenten für Filterbesitzer die Option Mir gehört aus.

  4. Wählen Sie den Komponentennamen aus.

  5. Kopieren Sie auf der Komponentendetailseite im Abschnitt Zusammenfassung den ARN.

Erstellen AWS Marketplace IAM-Richtlinien

Erstellen Sie die folgenden IAM-Richtlinien, um AWS Marketplace Zugriff auf Ihre Image Builder-Komponente und zugehörige Ressourcen wie Amazon S3-Buckets und Secrets zu gewähren. Verwenden Sie die bereitgestellten Beispielrichtlinien. Sie fügen diese Richtlinien einer AWS Marketplace IAM-Rolle hinzu. Hilfe beim Erstellen von Richtlinien finden Sie unter Erstellen von Richtlinien mit dem JSON-Editor im IAM-Benutzerhandbuch.

  • Image Builder-Get-Component-Richtlinie, um den Zugriff auf Ihre Komponente in Image Builder AWS Marketplace zu ermöglichen. Diese Richtlinie ist erforderlich. Speichern Sie die Richtlinie unter dem Namen mp_ib_ingest.

    JSON
    { "Version":"2012-10-17", "Statement": [ { "Sid": "VisualEditor0", "Effect": "Allow", "Action": "imagebuilder:GetComponent", "Resource": "*" } ] }
  • Amazon S3-Richtlinie für Lesezugriff, um das Abrufen von Binärdateien aus einem S3-Bucket AWS Marketplace zu ermöglichen. Diese Richtlinie ist nur erforderlich, wenn Ihre Komponente das S3Download Aktionsmodul verwendet und die zugehörigen Binärdateien in einem S3-Bucket speichert. Speichern Sie die Richtlinie unter dem Namen mp_ib_s3_read_only.

    JSON
    { "Version":"2012-10-17", "Statement": [ { "Sid": "ListObjectsInBucket", "Effect": "Allow", "Action": [ "s3:ListBucket" ], "Resource": [ "arn:aws:s3:::bucket_name" ] }, { "Sid": "ReadObjectsInBucket", "Effect": "Allow", "Action": [ "s3:GetObject", "s3:GetObjectAttributes" ], "Resource": [ "arn:aws:s3:::bucket_name/*" ] } ] }
  • Secrets Manager-Richtlinie für den Lesezugriff, um das Abrufen von Geheimnissen AWS Marketplace zu ermöglichen, die in Secrets Manager gespeichert sind. Diese Richtlinie ist nur erforderlich, wenn Ihre Komponente Secrets Manager zum Speichern von Geheimnissen verwendet. Speichern Sie die Richtlinie unter dem Namen mp_ib_sm_read_only. Um die Richtlinie nur auf Ihr Geheimnis zu beschränken, ersetzen Sie das * im Resource Abschnitt durch Ihr Geheimnis.

    JSON
    { "Version":"2012-10-17", "Statement": [ { "Sid": "VisualEditor0", "Effect": "Allow", "Action": [ "secretsmanager:GetSecretValue" ], "Resource": [ "*" ] } ] }
  • Richtlinie für den Lesezugriff auf den Parameterspeicher, um das Abrufen von Geheimnissen AWS Marketplace zu ermöglichen, die im Parameterspeicher gespeichert sind. Diese Richtlinie ist nur erforderlich, wenn Ihre Komponente Parameter Store zum Speichern von Geheimnissen verwendet. Speichern Sie die Richtlinie unter dem Namen mp_ib_ssm_parameter_read_only. Um die Richtlinie nur auf Ihr Geheimnis zu beschränken, ersetzen Sie das * im Resource Abschnitt durch Ihr Geheimnis.

    JSON
    { "Version":"2012-10-17", "Statement": [ { "Sid": "Statement1", "Effect": "Allow", "Action": [ "ssm:getParameter" ], "Resource": [ "*" ] } ] }

Erstellen der AWS Marketplace IAM role (IAM-Rolle)

Gehen Sie wie folgt vor, um eine AWS Marketplace IAM-Rolle mit Richtlinien zu erstellen, die AWS Marketplace den Zugriff auf Ihre Komponente und ihre Abhängigkeiten gewähren.

Um das zu erstellen AWS Marketplace IAM role (IAM-Rolle)
  1. Melden Sie sich bei der AWS Management Console an und öffnen Sie die IAM-Konsole unter https://console.aws.amazon.com/iam/.

  2. Wählen Sie in der linken Navigationsleiste Rollen aus.

  3. Wählen Sie Rolle erstellen aus.

  4. Wählen Sie Benutzerdefinierte Vertrauensrichtlinie aus.

  5. Geben Sie die folgende Aussage ein:

    JSON
    { "Version":"2012-10-17", "Statement": [ { "Sid": "Statement1", "Effect": "Allow", "Principal": { "Service": "assets.marketplace.amazonaws.com" }, "Action": "sts:AssumeRole" } ] }
  6. Wählen Sie Weiter aus.

  7. Fügen Sie die Image Builder-Get-Component-Richtlinie hinzu, die Sie zuvor erstellt haben. Die Get-Component-Richtlinie ist erforderlich. Fügen Sie die relevanten Richtlinien für S3, Secrets Manager und Parameter Store hinzu, wenn Ihre Komponente diese AWS Dienste verwendet.

  8. Wählen Sie Weiter aus.

  9. Geben Sie einen Rollennamen ein, z. MPEC2IBIngestion B.

  10. Wählen Sie Rolle erstellen aus.

Kopieren AWS Marketplace IAM role ARN (IAM-Rollen-ARN)

Nachdem Sie die AWS Marketplace IAM-Rolle erstellt haben, kopieren und speichern Sie den Rollen-ARN. Sie verwenden den ARN, wenn Sie den Eintrag mithilfe der AWS Marketplace Catalog API veröffentlichen.

Um das zu kopieren AWS Marketplace IAM role ARN (IAM-Rollen-ARN)
  1. Wählen Sie in der IAM-Konsole in der linken Navigationsleiste Rollen aus.

  2. Wählen Sie die AWS Marketplace IAM-Rolle aus, die Sie zuvor erstellt haben, z. B. MPEC2IBIngestion

  3. Kopieren Sie auf der Rollendetailseite im Abschnitt Zusammenfassung den ARN.

Bereiten Sie Ihre Image Builder-Komponentenliste vor

Stellen Sie vor der Veröffentlichung Ihres AWS Marketplace Angebots sicher, dass Sie über die folgenden Informationen verfügen:

  • Produktmetadaten — Zu den Metadaten gehören das Produktlogo, der Produkttitel, die Endbenutzer-Lizenzvereinbarung, unterstützte Instanztypen und die AWS-Region.

  • Preisinformationen — Sie können Ihr Produkt kostenlos, zu einem Stundensatz oder zu einem Stundensatz mit einer ersten kostenlosen Testphase anbieten. Bring Your Own License (BYOL) wird nicht unterstützt.

  • Komponentendetails — Zu den Details gehören die Amazon Resource Number (ARN) der Komponente, Nutzungsdetails und die Rolle AWS Identity and Access Management (IAM), die bei der Verarbeitung Ihrer Komponente übernommen AWS Marketplace wird.

Veröffentlichen Sie Ihre Produktliste für die Image Builder-Komponente

Dieses Thema enthält Anweisungen zur Veröffentlichung Ihrer EC2 Image Builder-Komponentenliste AWS Marketplace mithilfe der AWS Marketplace Catalog API.

Voraussetzungen

Stellen Sie sicher, dass Sie über Folgendes verfügen, bevor Sie Ihre Produktliste für Image Builder-Komponenten veröffentlichen:

  • Registrierung als Verkäufer in AWS Marketplace. Weitere Informationen finden Sie unter Als AWS Marketplace-Verkäufer registrieren.

  • Ein IAM-Benutzer mit AWSMarketplaceSellerFullAccess Genehmigung.

  • Ein öffentlich zugänglicher Amazon Simple Storage Service (Amazon S3) -Bucket zum Hosten Ihres Firmenlogos und Ihrer EULA, sofern sie in Ihrer Komponente verwendet werden. Sie geben die URL für den S3-Bucket in Ihre ChangeSet JSON-Datei ein.

  • AWS Command Line Interface (AWS CLI). Weitere Informationen finden Sie unter Was ist die AWS-Befehlszeilenschnittstelle? im AWS Command Line Interface Benutzerhandbuch.

Erstellen eines Image Builder-Komponentenprodukts auf AWS Marketplace

Informationen zum Erstellen eines EC2 Image Builder-Komponentenprodukts AWS Marketplace mithilfe der Catalog API finden Sie Erstellen Sie ein Produkt unter.

Aktualisierung der Produktinformationen der Image Builder-Komponente

Sie können Informationen zu einem Image Builder-Komponentenprodukt im AWS Marketplace Management Portal aktualisieren.

Um die Produktinformationen der Image Builder-Komponente zu aktualisieren
  1. Öffnen Sie das AWS Marketplace Management Portal und melden Sie sich bei Ihrem Verkäuferkonto an.

  2. Wählen Sie im Menü Produkte die Option Server aus.

  3. Wählen Sie auf der Serverproduktseite das Produkt aus.

  4. Wählen Sie auf der Produktdetailseite im Menü Änderungen anfordern den Artikel aus, der den Informationen entspricht, die Sie aktualisieren möchten.

  5. Nachdem Sie alle Änderungen eingereicht haben, erscheint die Anfrage auf der Registerkarte „Anfragen“ mit dem Status „Wird geprüft“ und ändert sich nach Abschluss in „Erfolgreich“.

Hinzufügen einer neuen Version zu einem vorhandenen Image Builder-Komponentenprodukt

Sie können einem Image Builder-Komponentenprodukt eine neue Version hinzufügen, AWS Marketplace indem Sie die verwenden AWS Marketplace Catalog API.

Um eine neue Version hinzuzufügen
  1. Rufen Sie AWS Marketplace Management Portal die Produkt-ID von ab.

    1. Öffnen Sie das AWS Marketplace Management Portal und melden Sie sich bei Ihrem Verkäuferkonto an.

    2. Wählen Sie im Menü Produkte die Option Server aus.

    3. Wählen Sie auf der Serverproduktseite das Produkt aus.

    4. Kopieren Sie in der Produktübersicht die Produkt-ID.

  2. Erstellen Sie anhand des folgenden Codebeispiels eine Changeset-Datei im JSON-Format. Ersetzen Sie im Beispiel your-product-ID durch die Produkt-ID, die Sie in Schritt 1 erhalten haben. new-version-nameErsetzen Sie es durch Ihren Versionstitel. new-delivery-option-titleErsetzen Sie ihn durch den Titel Ihrer Lieferoption.

    [ { "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" } } } ] } } ]
  3. Speichern Sie die Changeset-Datei mit dem Namen. addIBversion.json

  4. Führen Sie in Ihrem Terminal oder AWS CloudShell den folgenden Befehl aus:

    aws marketplace-catalog start-change-set --catalog AWSMarketplace --region us-east-1 --change-set file://addIBversion.json

Der start-change-set Befehl gibt einen ChangeSetId Wert zurück. Informationen zur Überwachung eines Änderungssatzes finden Sie unterEinen Änderungssatz überwachen.

Asynchrone Fehler

Die folgenden Fehler beziehen sich spezifisch auf AddDeliveryOptions Aktionen in der. AWS Marketplace Catalog API Diese Fehler werden zurückgegeben, wenn Sie DescribeChangeSet nach der Verarbeitung eines Änderungssatzes aufrufen. Weitere Hinweise zur VerwendungDescribeChangeSet, um den Status einer Änderungsanforderung abzurufen, finden Sie unterMit Änderungssätzen arbeiten.

Anmerkung

Die folgenden Fehlercodes sind spezifisch für die Image Builder-Bereitstellungsmethode. Bestehende Fehlermeldungen in Feldern wie Usage Instructions Recommended Instance typeAccessRoleArn, und finden Sie unterFügen Sie eine neue Version hinzu.

Fehlercode Fehlermeldung

ASSET_NICHT_GEFUNDEN

Prüfen Sie, ob [component arn] im AWS Konto [account-id] vorhanden ist und das von AccessArn bereitgestellte [ARN] über die Berechtigungen verfügt, diese Image Builder-Komponente mit anderen zu teilen. AWS Marketplace

ASSET_NICHT_GEFUNDEN

Der angegebene S3-Link [x] in der Komponente [x] existiert nicht. Geben Sie einen gültigen S3-Link innerhalb der Komponente an.

DUPLIZIERTER_KOMPONENTENNAME

Der Komponentenname [x] ist bereits in derselben Version vorhanden. Geben Sie einen anderen Komponentennamen an.

DUPLIZIERTER_KOMPONENTENNAME

Der von Ihnen angegebene Komponentenname [x] wird bereits von einem anderen Produkt verwendet. Geben Sie einen anderen Komponentennamen an.

DUPLIZIERTE_KOMPONENTE_ARN

Die Komponente Arn [x] muss sich von der Komponente Arn unterscheiden, die in anderen Lieferoptionen derselben Version dieses Produkts verwendet wird.

DUPLIZIERTE_KOMPONENTE_ARN

Die Komponenten-ARN [x] muss sich von der Komponenten-ARN unterscheiden, die in anderen Versionen dieses Produkts verwendet wird.

SCAN_ERROR

Behebt die Sicherheitslücke [y] auf der Komponente [x].

ASSET_ACCESS_EXCEPTION

Wir haben nicht die erforderlichen Berechtigungen, um den Inhalt aus dem angegebenen S3-Bucket [x] zu lesen. Stellen Sie sicher, dass der S3-Bucket über die entsprechenden Leseberechtigungen verfügt.

ASSET_ACCESS_EXCEPTION

Wir haben nicht die erforderlichen Berechtigungen, um den Inhalt der angegebenen Komponente ARN [x] zu lesen. Stellen Sie sicher, dass der Komponenten-ARN über die entsprechenden Leseberechtigungen verfügt.

ASSET_ACCESS_EXCEPTION

Wir haben nicht die erforderlichen Berechtigungen, um den Inhalt der angegebenen Paket-URI [x] zu lesen. Stellen Sie sicher, dass der Paket-URI über die entsprechenden Leseberechtigungen verfügt.

ASSET_ACCESS_EXCEPTION

Fehler beim Lesen aus der HTTP-Quelle [x]. Stellen Sie sicher, dass die angegebene HTTP-Quelle korrekt ist.

INVALID_IMAGE_BUILDER_COMPONENT_PACKAGE

Komponenten-Assets überschreiten die Größenbeschränkung für die Aufnahme. Reduzieren Sie die Größe der S3/web Downloads oder entfernen Sie unnötige Downloads, um fortzufahren.

INVALID_IMAGE_BUILDER_COMPONENT_PACKAGE

Die Aufnahme von Komponenten-Assets dauert zu lange. Stellen Sie sicher, dass Ihre Netzwerkverbindung stabil ist und über eine ausreichende Bandbreite verfügt.

ZUVIELE_IMAGE_BUILDER_KOMPONENTEN

Pro Produkt werden maximal 5 eindeutige Komponentennamen unterstützt. Schränken Sie die zusätzliche Lieferoption ein.

UNVOLLSTÄNDIGES_ÖFFENTLICHES VERKÄUFERPROFIL

Ihr öffentliches Verkäuferprofil ist nicht vollständig. Vervollständigen Sie Ihr öffentliches Profil, bevor Sie dem Produkt Versionen hinzufügen.

UNGÜLTIGE_BESCHREIBUNG

Die Beschreibung fehlt. Geben Sie in der Komponente [x] eine Beschreibung mit weniger als 1024 Zeichen ein.

UNGÜLTIGER_KOMPONENTENNAME

Geben Sie einen Komponentennamen mit weniger als [x] Zeichen an.

UNGÜLTIGE_UNTERSTÜTZTE_BETRIEBSSYSTEMVERSION

Die Betriebssystemversion fehlt. Geben Sie in Komponente [x] eine gültige unterstützte Betriebssystemversion an.

UNGÜLTIGES_PFADFORMAT

Schritt [STEP_NAME] in Phase [PHASE_NAME] darf keine S3- oder Web-URLs für die Aktionen verwenden. InstallMSI/UninstallMSI Stellen Sie sicher, dass der angegebene Pfad ein gültiger lokaler Pfad ist, auf den vom System aus zugegriffen werden kann, das die Aktion ausführt.

INKOMPATIBLE_BETRIEBSSYSTEMTYP

Der angegebene Komponenten-Betriebssystemtyp [x] ist nicht mit der Plattform des Basisimages kompatibel. Geben Sie einen Betriebssystemtyp an, der mit dem Basisimage kompatibel ist.

ASSET_ACCESS_EXCEPTION

Wir haben nicht die erforderlichen Berechtigungen, um den Inhalt des angegebenen SSM-Parameters [x] zu lesen. Stellen Sie sicher, dass die in der API-Eingabe angegebene IAM-Zugriffsrolle über die erforderlichen Leseberechtigungen verfügt.

ASSET_ACCESS_EXCEPTION

Wir haben nicht die erforderlichen Berechtigungen, um den Inhalt des angegebenen SecretsManager Geheimnisses [x] zu lesen. Stellen Sie sicher, dass die in der API-Eingabe angegebene IAM-Zugriffsrolle über die erforderlichen Leseberechtigungen verfügt.

UNGÜLTIGE_IB_COMPONENT_BUILD_VERSION

Die Komponente ARN [x] hat eine Build-Version von [y]. AWS Marketplace unterstützt nur Build-Version 1. Erstellen Sie eine neue EC2 Image Builder-Version mit Build-Versionen 1 und versuchen Sie es erneut AWS Marketplace

UNGÜLTIGER_IB_COMPONENT_PARAMETER

Der SSM-Parameter in der Eingabe [x] für die Komponente [y] konnte nicht analysiert werden.

UNGÜLTIGER_IB_KOMPONENTENPARAMETER

Das SecretsManager Geheimnis in der Eingabe [x] für die Komponente [y] konnte nicht analysiert werden.

FEHLENDER_IB_COMPONENT_PARAMETER

Der Parameter wurde in der Komponente [x] für die Eingabe [y] nicht gefunden

UNGÜLTIGER_IB_COMPONENT_PARAMETER

Geben Sie einen Standardwert für den Parameter [x] in der Komponente [y] an.

FEHLGESCHLAGEN_STARTTEST

Der Starttest für die Komponente [x] ist fehlgeschlagen. Fehlermeldung: [z]

SSHAuthFailedForUserAndKeypair

Die Anmeldung bei der Instanz mit dem Betriebssystem-Standardbenutzernamen [X] ist nicht möglich.

UNGÜLTIGE_IB_COMPONENT

Eine Phase der Komponentenerstellung ist erforderlich. Fügt der Komponente [x] eine gültige Build-Phase hinzu

DUPLIZIERTER_VERSIONSTITEL

Der Versionstitel muss sich von allen anderen Versionstiteln dieses Produkts unterscheiden.

UNGÜLTIGER_VERSIONSTITEL

Entfernen Sie Leerzeichen vor dem Markensymbol.

UNGÜLTIGER_VERSIONSTITEL

Nicht unterstützte Zeichen entfernen: [x, y, z]

UNGÜLTIGER_VERSIONSTITEL

Entfernen Sie Leerzeichen am Anfang des Versionstitels.

UNGÜLTIGER_VERSIONSTITEL

Geben Sie den Versionstitel mit weniger als [x] Zeichen an.

UNGÜLTIGE_VERSIONSHINWEIS

Entfernen Sie Leerzeichen vor dem Markensymbol.

UNGÜLTIGE_VERSIONSHINWEIS

Nicht unterstützte Zeichen entfernen: [x, y, z]

INVALID_RELEASE_NOTES

Entfernen Sie Leerzeichen am Anfang der Versionshinweise.

UNGÜLTIGE_VERSIONSHINWEIS

Geben Sie Versionshinweise mit weniger als (x) Zeichen an.

UNGÜLTIGE_NUTZUNGSANWEISUNGEN

Entfernen Sie Leerzeichen vor dem Markensymbol.

UNGÜLTIGE_NUTZUNGSANWEISUNGEN

Nicht unterstützte Zeichen entfernen: [x, y, z]

UNGÜLTIGE_USAGE_INSTRUCTIONS

Geben Sie Nutzungsanweisungen mit weniger als (x) Zeichen an.

DUPLIZIERTE_LIEFEROPTION_TITEL

Geben Sie einen eindeutigen Titel der Lieferoption an.

UNGÜLTIGE_LIEFEROPTION_TITEL

Der Titel der Versandoption ist bereits vorhanden. Versuchen Sie es erneut mit einem anderen Titel.

Informationen zu einer vorhandenen Version aktualisieren

Um Informationen zu einer vorhandenen Version zu aktualisieren
  1. Rufen Sie AWS Marketplace Management Portal die Produkt-ID von ab.

    1. Öffnen Sie das AWS Marketplace Management Portal und melden Sie sich bei Ihrem Verkäuferkonto an.

    2. Wählen Sie im Menü Produkte die Option Server aus.

    3. Wählen Sie auf der Serverproduktseite das Produkt aus.

    4. Kopieren Sie in der Produktübersicht die Produkt-ID.

  2. Führen Sie in Ihrem Terminal den folgenden Befehl aus. Ersetzen Sie den Befehl your-product-ID durch die ID, die Sie in Schritt 1 erhalten haben.

    aws marketplace-catalog describe-entity --catalog AWSMarketplace --region us-east-1 --entity-id 'your-product-ID'
  3. Gehen Sie in der zurückgegebenen Ausgabe zum Versions AbschnittDetailsDocument,. Kopieren Sie den Id WertDeliveryOptions, für die Version, die Sie aktualisieren möchten.

  4. Erstellen Sie anhand des folgenden Codebeispiels eine Changeset-Datei im JSON-Format. Ersetzen Sie im Beispiel your-product-ID durch die Produkt-ID, die Sie in Schritt 1 erhalten haben. your-release-notesErsetzen Sie es durch Ihre Versionshinweise. your-delivery-option-IDErsetzen Sie es durch die ID der Lieferoption, die Sie in Schritt 3 erhalten haben. your-usage-instructionsErsetzen Sie es durch Ihre Nutzungsanweisungen.

    [ { "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" } } } ] } } ]
  5. Speichern Sie die Changeset-Datei unter dem Namen. updateVersionInfo.json

  6. Führen Sie in Ihrem Terminal oder AWS CloudShell den folgenden Befehl aus:

    aws marketplace-catalog start-change-set --catalog AWSMarketplace --region us-east-1 --change-set file://updateVersionInfo.json

Der start-change-set Befehl gibt einen ChangeSetId Wert zurück. Informationen zur Überwachung eines Änderungssatzes finden Sie unterEinen Änderungssatz überwachen.

Einschränkung der Produktversion einer Image Builder-Komponente

Wenn Sie eine Version einschränken, ist sie für Käufer nicht verfügbar. Sie können eine Version Ihres Image Builder-Komponentenprodukts auf die AWS Marketplace Verwendung der AWS Marketplace Catalog API einschränken. Sie müssen mindestens eine Version Ihres Produkts uneingeschränkt aktivieren AWS Marketplace. Sie können den Zugriff auf die einzige öffentliche Version nicht einschränken.

Um Informationen zu einer vorhandenen Version zu aktualisieren
  1. Rufen Sie AWS Marketplace Management Portal die Produkt-ID von ab.

    1. Öffnen Sie das AWS Marketplace Management Portal und melden Sie sich bei Ihrem Verkäuferkonto an.

    2. Wählen Sie im Menü Produkte die Option Server aus.

    3. Wählen Sie auf der Serverproduktseite das Produkt aus.

    4. Kopieren Sie in der Produktübersicht die Produkt-ID.

  2. Führen Sie in Ihrem Terminal den folgenden Befehl aus. Ersetzen Sie den Befehl your-product-ID durch die ID, die Sie in Schritt 1 erhalten haben.

    aws marketplace-catalog describe-entity --catalog AWSMarketplace --region us-east-1 --entity-id 'your-product-ID'
  3. Gehen Sie in der zurückgegebenen Ausgabe zum Versions AbschnittDetailsDocument,. Kopieren Sie den Id WertDeliveryOptions, für die Version, die Sie aktualisieren möchten.

  4. Erstellen Sie anhand des folgenden Codebeispiels eine Changeset-Datei im JSON-Format. Ersetzen Sie im Beispiel your-product-ID durch die Produkt-ID, die Sie in Schritt 1 erhalten haben. your-delivery-option-IDErsetzen Sie es durch die ID der Lieferoption, die Sie in Schritt 3 erhalten haben.

    [ { "ChangeType": "RestrictDeliveryOptions", "Entity": { "Identifier": "your-product-ID", "Type": "AmiProduct@1.0" }, "DetailsDocument": { "DeliveryOptionIds": [ "your-delivery-option-ID" ] } } ]
  5. Speichern Sie die Changeset-Datei mit dem Namen. restrictec2ibversion.json

  6. Führen Sie in Ihrem Terminal oder AWS CloudShell den folgenden Befehl aus:

    aws marketplace-catalog start-change-set --catalog AWSMarketplace --region us-east-1 --change-set file://restrictec2ibversion.json

Der start-change-set Befehl gibt einen ChangeSetId Wert zurück. Informationen zur Überwachung eines Änderungssatzes finden Sie unterEinen Änderungssatz überwachen.

Einen Änderungssatz überwachen

Der start-change-set Befehl gibt einen ChangeSetId Wert zurück. Sie können den Fortschritt des Änderungssatzes auf folgende Weise überwachen:

  • Führen Sie den folgenden Befehl in Ihrem Terminal aus. Ersetzen Sie im Befehl. changeset-ID durch den vom start-change-set Befehl zurückgegebenen ChangeSetId Wert.

    aws marketplace-catalog describe-change-set ‐‐catalog AWSMarketplace ‐‐change-set-id changesetID
  • Sehen Sie sich den Anforderungsstatus auf der Registerkarte Anfragen im AWS Marketplace Management Portal an.

Sicherung von Softwaredownloads

Um das geistige Eigentum von ISV-Software zu schützen und eine stabile, konsistente Softwarebereitstellung an AWS Marketplace Käufer zu gewährleisten, AWS Marketplace werden in Ihrer Komponente automatische Analysen S3Download und WebDownload Aktionsmodule installiert. Die referenzierten Dateien werden dann sicher in einem privaten Amazon S3-Bucket gespeichert, der von verwaltet wird. AWS Marketplace Um diesen Aufnahmevorgang zu deaktivieren und Softwaredownloads unabhängig zu verwalten, führen Sie Bash-Skripts aus, die die Befehle wget oder curl download verwenden.