Fonctionne avec les composants d'EC2 Image Builder

Connectez-vous à l'AWS Management Console et ouvrez la console Image Builder à l'adressehttps://console.aws.amazon.com/imagebuilder/.

Dans la barre de navigation de gauche, sous Ressources enregistrées, choisissez Composants.

Sur la page Composants, pour Propriétaire du filtre, choisissez Owned by me.

Choisissez le nom du composant.

Sur la page détaillée du composant, dans la section Résumé, copiez l'ARN.

Connectez-vous à la console de AWS gestion et ouvrez la console IAM à https://console.aws.amazon.com/iam/ l'adresse.

Dans la barre de navigation de gauche, choisissez Rôles.

Choisissez Créer un rôle.

Sélectionnez Politique de confiance personnalisée.

Entrez la déclaration suivante :

Choisissez Suivant.

Ajoutez la politique d'obtention des composants d'Image Builder que vous avez créée précédemment. La politique Get-Component est obligatoire. Ajoutez les politiques pertinentes pour S3, Secrets Manager et Parameter Store si votre composant utilise ces AWS services.

Choisissez Suivant.

Entrez un nom de rôle, tel queMPEC2IBIngestion.

Choisissez Créer un rôle.

Dans la console IAM, dans la barre de navigation de gauche, sélectionnez Rôles.

Choisissez le rôle AWS Marketplace IAM que vous avez créé précédemment, par exempleMPEC2IBIngestion.

Sur la page détaillée du rôle, dans la section Résumé, copiez l'ARN.

Ouvrez le Portail de gestion AWS Marketplace et connectez-vous à votre compte vendeur.

Dans le menu Produits, choisissez Serveur.

Sur la page Produits du serveur, sélectionnez le produit.

Sur la page détaillée du produit, dans le menu Demander des modifications, choisissez l'article qui correspond aux informations que vous souhaitez mettre à jour.

Une fois les modifications soumises, la demande apparaîtra dans l'onglet Demandes avec le statut « En cours de révision » et passera à « Succès » une fois terminée.

À partir de Portail de gestion AWS Marketplace, obtenez l'ID du produit.

1. Ouvrez le Portail de gestion AWS Marketplace et connectez-vous à votre compte vendeur.

2. Dans le menu Produits, choisissez Serveur.

3. Sur la page Produits du serveur, sélectionnez le produit.

4. Dans le récapitulatif du produit, copiez l'identifiant du produit.

À l'aide de l'exemple de code suivant, créez un fichier de modifications au format JSON. Dans l'exemple, remplacez-le your-product-ID par l'identifiant du produit que vous avez obtenu à l'étape 1. Remplacez-le new-version-name par le titre de votre version. Remplacez-le new-delivery-option-title par le titre de votre option de livraison.

[
    {
        "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"
                        }
                    }
                }
            ]
        }
    }
]

Enregistrez le fichier de modifications sous son nomaddIBversion.json.

Dans votre terminal ou AWS CloudShell exécutez la commande suivante :

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

À partir de Portail de gestion AWS Marketplace, obtenez l'ID du produit.

1. Ouvrez le Portail de gestion AWS Marketplace et connectez-vous à votre compte vendeur.

2. Dans le menu Produits, choisissez Serveur.

3. Sur la page Produits du serveur, sélectionnez le produit.

4. Dans le récapitulatif du produit, copiez l'identifiant du produit.

Dans votre terminal, exécutez la commande suivante. Dans la commande, remplacez-le your-product-ID par l'ID que vous avez obtenu à l'étape 1.

aws marketplace-catalog describe-entity --catalog AWSMarketplace --region us-east-1 --entity-id 'your-product-ID'

Dans la sortie renvoyée, accédez à la Versions sectionDetailsDocument,. Copiez la Id valeurDeliveryOptions, pour la version que vous souhaitez mettre à jour.

À l'aide de l'exemple de code suivant, créez un fichier de modifications au format JSON. Dans l'exemple, remplacez-le your-product-ID par l'identifiant du produit que vous avez obtenu à l'étape 1. your-release-notesRemplacez-le par vos notes de publication. Remplacez-le your-delivery-option-ID par l'ID de l'option de livraison que vous avez obtenue à l'étape 3. your-usage-instructionsRemplacez-le par vos instructions d'utilisation.

[
    {
        "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"
                        }
                    }
                }
            ]
        }
    }
]

Enregistrez le fichier de modifications sous son nomupdateVersionInfo.json.

Dans votre terminal ou AWS CloudShell exécutez la commande suivante :

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

À partir de Portail de gestion AWS Marketplace, obtenez l'ID du produit.

1. Ouvrez le Portail de gestion AWS Marketplace et connectez-vous à votre compte vendeur.

2. Dans le menu Produits, choisissez Serveur.

3. Sur la page Produits du serveur, sélectionnez le produit.

4. Dans le récapitulatif du produit, copiez l'identifiant du produit.

Dans votre terminal, exécutez la commande suivante. Dans la commande, remplacez-le your-product-ID par l'ID que vous avez obtenu à l'étape 1.

aws marketplace-catalog describe-entity --catalog AWSMarketplace --region us-east-1 --entity-id 'your-product-ID'

Dans la sortie renvoyée, accédez à la Versions sectionDetailsDocument,. Copiez la Id valeurDeliveryOptions, pour la version que vous souhaitez mettre à jour.

À l'aide de l'exemple de code suivant, créez un fichier de modifications au format JSON. Dans l'exemple, remplacez-le your-product-ID par l'identifiant du produit que vous avez obtenu à l'étape 1. Remplacez-le your-delivery-option-ID par l'ID de l'option de livraison que vous avez obtenue à l'étape 3.

[
    {
        "ChangeType": "RestrictDeliveryOptions",
        "Entity": {
            "Identifier": "your-product-ID",
            "Type": "AmiProduct@1.0"
        },
        "DetailsDocument": {
            "DeliveryOptionIds": [
                "your-delivery-option-ID"
            ]
        }
    }
]

Enregistrez le fichier de modifications sous son nomrestrictec2ibversion.json.

Dans votre terminal ou AWS CloudShell exécutez la commande suivante :

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