Travaillez avec les composants 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, sélectionnez Composants.

Sur la page Composants, pour Propriétaire du filtre, sélectionnez 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, sélectionnez Rôles.

Choisissez Créer un rôle.

Sélectionnez Politique de confiance personnalisée.

Entrez l'énoncé suivant :

Choisissez Suivant.

Ajoutez la politique Get-component d'Image Builder que vous avez créée précédemment. La politique get-component est obligatoire. Ajoutez les politiques appropriées 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 Marketplaceet connectez-vous à votre compte vendeur.

Dans le menu Produits, sélectionnez Serveur.

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

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

Après avoir soumis des modifications, la demande apparaîtra dans l'onglet Demandes avec le statut « En cours d'examen » et deviendra « Réussi » une fois terminée.

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

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

2. Dans le menu Produits, sélectionnez Serveur.

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

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

À l'aide de l'exemple de code suivant, créez un fichier d'ensemble 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 new-version-name par le titre de votre version. new-delivery-option-titleRemplacez-le 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 du changeset 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 du Portail de gestion AWS Marketplace, obtenez l'identifiant du produit.

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

2. Dans le menu Produits, sélectionnez Serveur.

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

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

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

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

Dans le résultat renvoyé, passez à 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 d'ensemble 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 version. your-delivery-option-IDRemplacez-le par l'identifiant 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 du changeset 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 du Portail de gestion AWS Marketplace, obtenez l'identifiant du produit.

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

2. Dans le menu Produits, sélectionnez Serveur.

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

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

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

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

Dans le résultat renvoyé, passez à 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 d'ensemble 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-delivery-option-IDRemplacez-le par l'identifiant 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 du changeset 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