Ajouter une nouvelle version de votre produit en conteneur sur AWS Marketplace

En tant que AWS Marketplace vendeur, vous pouvez ajouter de nouvelles versions de votre produit conteneur, gérer les versions et mettre à jour les informations relatives aux versions. Votre produit peut avoir plusieurs versions au cours de sa durée de vie. Chaque version possède un ensemble d'images de conteneur spécifiques à cette version. Les rubriques suivantes expliquent comment gérer les versions de produits pour vos produits en conteneur.

Note

Vous ne pouvez pas ajouter de version à votre produit tant que vous n'avez pas créé l'identifiant du produit et le prix de celui-ci. Pour plus d'informations sur ces étapes, consultezÉtape 1 : Créez l'ID de produit et le code de produit pour votre produit en conteneur.

Étape 1 : ajouter des référentiels

Les images de vos conteneurs et les autres artefacts de votre produit sont stockés dans des référentiels dans AWS Marketplace. Généralement, vous créez un dépôt pour chaque artefact nécessaire, mais le référentiel peut stocker plusieurs versions de l'artefact (avec des balises différentes).

Note

Toutes les images du déploiement de votre produit doivent utiliser des images provenant des AWS Marketplace référentiels.

La procédure suivante décrit comment ajouter les référentiels nécessaires. AWS Marketplace

Pour ajouter des référentiels

1. Connectez-vous à la Portail de gestion AWS Marketplace.

2. Sélectionnez Serveur dans le menu Produits.

3. Dans l'onglet Produits du serveur, sélectionnez le produit que vous souhaitez modifier, puis choisissez Ajouter des référentiels dans le menu déroulant Demander des modifications.

4. Entrez le nom du référentiel que vous souhaitez créer. Si vous souhaitez créer plusieurs nouveaux référentiels, choisissez Ajouter un nouveau référentiel pour chaque dépôt supplémentaire et donnez-lui un nom unique.

   Note

   Le référentiel aura cette structure :<repositoryID>.dkr.ecr.us-east-1.amazonaws.com/<sellerName>/<repositoryName>. Lorsque vous ajoutez des éléments au référentiel (dans la procédure suivante), ils reçoivent une balise et ont cette structure :<repositoryID>.dkr.ecr.us-east-1.amazonaws.com/<sellerName>/<repositoryName>:<tag>. repositoryIDIl s'agit d'un identifiant interne pour AWS Marketplace. sellerNameIl est basé sur le nom que vous avez créé pour votre compte vendeur. Vous définissez le respositoryName dans cette étape. Le tag est défini lorsque vous téléchargez un artefact dans le référentiel.

5. Sélectionnez Submit (Envoyer).

Note

Vous pouvez avoir jusqu'à 50 référentiels par produit.

Une nouvelle demande est créée et affichée dans l'onglet Demandes. Une fois l'opération terminée, en quelques minutes, vous pouvez commencer à ajouter des images de conteneurs et d'autres artefacts aux référentiels que vous avez créés.

Étape 2 : télécharger des images et des artefacts de conteneurs dans des référentiels

Pour télécharger des images et des artefacts de conteneurs dans des référentiels

1. Connectez-vous à la Portail de gestion AWS Marketplace.

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

3. Dans l'onglet Produits du serveur, sélectionnez le produit que vous souhaitez modifier.

4. Choisissez Ajouter des référentiels dans le menu déroulant Demander des modifications.

5. Choisissez Afficher les référentiels existants.

6. Sélectionnez le référentiel vers lequel vous souhaitez effectuer le téléchargement.

7. Sélectionnez Afficher les commandes push pour ouvrir une liste d'instructions, y compris les commandes que vous pouvez utiliser pour appuyer Docker images de conteneurs et Helm graphiques vers ce référentiel.

   Pour obtenir des informations générales sur la manière de transférer des images de conteneurs et d'autres artefacts vers des référentiels, consultez la section Transmission d'une image dans le guide de l'utilisateur d'Amazon Elastic Container Registry.

   Note

   Vous pouvez utiliser les API opérations Amazon Elastic Container Registry (AmazonECR) suivantes lorsque vous appelez docker pull ou docker push :

   • DescribeImages— Utilisez-le pour examiner les métadonnées relatives aux images d'un référentiel.

   • GetAuthorizationToken— À utiliser pour vous authentifier avant de télécharger des artefacts dans le référentiel, puis utilisez les commandes docker pull ordocker push.

   • ListImages— À utiliser pour afficher la liste des images que vous avez envoyées.

8. Utilisez les commandes répertoriées pour transférer les artefacts nécessaires de votre référentiel local vers le AWS Marketplace référentiel de votre produit.

   Note

   Les informations tag que vous fournissez dans les push commandes sont utilisées pour différencier la version de l'artefact que vous téléchargez dans le référentiel. Utilisez une balise adaptée à la version dont font partie les artefacts.

9. Répétez l'opération pour chaque image de conteneur ou artefact dont vous avez besoin dans votre version.

   Note

   Votre version peut inclure jusqu'à 50 images ou artefacts du conteneur dans chaque option de livraison. Reportez-vous à la procédure suivante pour plus d'informations sur les options de livraison.

Une fois que vous avez chargé vos artefacts, vous êtes prêt à créer la version de votre produit.

Note

Les images de vos conteneurs sont numérisées automatiquement pour voir si elles répondent auxExigences relatives aux produits basées sur les conteneurs pour AWS Marketplace. Pour plus d’informations, consultez Analyses des produits en conteneur pour détecter des problèmes de sécurité.

Ajouter une nouvelle option de livraison

Chaque version de votre produit en conteneur nécessiterait une option de livraison. L'option de livraison indique les options de déploiement disponibles pour l'acheteur. Selon l'une des options de livraison ci-dessous, vous devrez télécharger les artefacts appropriés dans les référentiels.

• Pour une option de livraison d'images de conteneurs, téléchargez toutes les images de conteneur requises pour l'installation du produit dans le référentiel Amazon Elastic Container Registry (AmazonECR) créé dans la AWS Marketplace console.

• Pour un Helm option de livraison de cartes, téléchargez le Helm images de graphiques et de conteneurs dans le ECR référentiel Amazon créé dans la AWS Marketplace console.

• Pour une option de livraison d'un module complémentaire pour EKS console Amazon, téléchargez le Helm images de graphiques et de conteneurs dans le ECR référentiel Amazon créé dans la AWS Marketplace console.

Étape 3 : Ajoutez une nouvelle version à votre produit en conteneur

Note

Si vous recevez des erreurs lors de l'ajout d'une nouvelle version à votre conteneur, consultez le tableau des erreurs asynchrones relatives à l'ajout d'une nouvelle version dans la AWS Marketplace Catalog API référence.

Pour ajouter une nouvelle version à votre produit en conteneur

1. Connectez-vous à la Portail de gestion AWS Marketplace.

2. Choisissez Serveur dans le menu Produits.

3. Dans l'onglet Produits du serveur, sélectionnez le produit auquel vous souhaitez ajouter une version. Choisissez ensuite Ajouter une nouvelle version dans le menu déroulant Demander des modifications.

4. Sur la page Ajouter une nouvelle version, entrez le titre de la version et les notes de version de votre version.

5. Après avoir saisi les détails de la version, l'étape suivante consiste à ajouter des options de livraison. Les options de livraison sont des ensembles d'instructions et d'informations que les acheteurs peuvent utiliser pour lancer le logiciel à partir de la version de votre produit. Les options de livraison sont connues sous le nom d'options d'expédition pour les acheteurs.

   Note

   Votre produit peut prendre en charge plusieurs plateformes avec différentes images de conteneur (par exemple, Kubernetes and Ubuntu déploiements). Vous pouvez créer une option de livraison pour chaque manière dont les clients peuvent configurer votre produit, jusqu'à quatre options de livraison par version du produit.

   1. Si le produit possède déjà des options de livraison dans d'autres versions, vous pouvez utiliser l'option existante comme modèle pour ajouter une option de livraison à la nouvelle version. Dans Options de livraison, choisissez l'option de livraison que vous souhaitez ajouter dans la liste. Vous pouvez modifier l'option en suivant les instructions décrites dans les étapes suivantes.

   2. Pour ajouter une nouvelle option de livraison, sélectionnez Nouvelle option de livraison. Après avoir ajouté une option, suivez les instructions des étapes suivantes pour la configurer.

6. Choisissez un mode de livraison pour l'option de livraison. Le mode de livraison détermine la manière dont les acheteurs lanceront votre logiciel.

   • Pour une option de livraison d'images de conteneurs, indiquez les chemins d'accès aux images de conteneurs dans un référentiel Amazon Elastic Container Registry (AmazonECR) créé dans la AWS Marketplace console. Les acheteurs utilisent les chemins des images du conteneur pour lancer le logiciel en extrayant les images directement dans leur environnement.

   • Pour un Helm option de livraison de graphiques, fournir des chemins vers Helm graphiques dans un ECR référentiel Amazon créé dans la AWS Marketplace console. Les acheteurs installent le Helm des graphiques dans leur environnement de déploiement pour lancer le logiciel.

   • Pour une option de livraison d'un module complémentaire pour EKS console Amazon, indiquez les chemins vers Helm graphiques dans un ECR référentiel Amazon créé dans la AWS Marketplace console. Les acheteurs installent le conteneur à l'aide de la EKS console Amazon ou du EKS module complémentaire Amazon natif APIs pour lancer le logiciel. Pour plus d'informations, consultez les EKSmodules complémentaires Amazon disponibles sur Amazon EKS.

   1. Pour ajouter une option de diffusion d'images Container, effectuez les opérations suivantes :

      1. Dans Images du conteneur, ajoutez l'Amazon ECR URL aux images du conteneur contenant la version logicielle du produit.

      2. Dans Titre de l'option de livraison et Description de l'option de déploiement, entrez le titre et la description de cette option de livraison.

      3. Dans Instructions d'utilisation, entrez des informations détaillées pour aider vos acheteurs à utiliser votre logiciel après son lancement.

      4. Dans Services pris en charge, sélectionnez les environnements dans lesquels les acheteurs peuvent lancer le logiciel.

      5. Dans les modèles de déploiement, ajoutez des ressources que les acheteurs peuvent utiliser pour lancer le logiciel. Entrez un titre et un URL pour la ressource pour chaque modèle.

   2. Pour ajouter un Helm option de livraison du graphique, effectuez les étapes suivantes :

      1. Dans Helm graphique, ajoutez l'Amazon ECR URL au Helm graphique que les acheteurs installeront dans leur environnement de déploiement pour lancer votre logiciel.

      2. Dans Images du conteneur, ajoutez l'Amazon ECR URL aux images du conteneur contenant la version logicielle du produit.

      3. Dans Titre de l'option de livraison et Description de l'option de déploiement, entrez le titre et la description de cette option de livraison.

      4. Dans Instructions d'utilisation, entrez des informations détaillées pour aider vos acheteurs à utiliser votre logiciel après son lancement.

      5. Dans Services pris en charge, sélectionnez les environnements dans lesquels les acheteurs peuvent lancer le logiciel.

      6. Facultatif - Dans Helm nom de la version, entrez le nom du Kubernetes espace de noms où Helm le graphique sera installé.

      7. Facultatif - Dans Helm espace de noms d'installation, entrez le nom du Helm version qui sera utilisée par la helm install commande.

      8. Facultatif - Dans Kubernetes nom du compte de service, entrez le nom du Kubernetes compte de service qui sera utilisé pour se connecter à AWS Identity and Access Management (IAM). Le Kubernetes un compte de service appelle AWS des services tels que les licences ou les compteurs.

      9. Choisissez d'QuickLaunchactiver cette version du produit. QuickLaunch est une fonctionnalité de AWS Marketplace. Les acheteurs peuvent l'utiliser QuickLaunch pour créer rapidement un EKS cluster Amazon et y lancer votre logiciel en utilisant AWS CloudFormation. Pour plus d'informations, voir QuickLaunch dans AWS Marketplace.

      10. Dans Paramètres de remplacement, entrez les paramètres qui seront utilisés dans Helm CLIcommandes qui lancent le logiciel. Ces paramètres permettent aux acheteurs de remplacer les valeurs par défaut fournies. Si vous l'avez activé QuickLaunch, entrez également un nom de paramètre et une description pour le CloudFormation formulaire. Il y a une limite de 15 paramètres lors de l'utilisation de la console AWS Marketplace de gestion, mais il n'y a aucune limite lors de l'utilisation de AWS Marketplace Catalog API. Pour plus d'informations, consultez la section Ajout d'une nouvelle version à un produit basé sur un conteneur.

          Note

          Certains paramètres de remplacement sont obligatoires. Les produits Amazon EKS Anywhere nécessitent un paramètre Override pour le secret de licence avec un DefaultValue de"${AWSMP_LICENSE_SECRET}". Pour les produits payants, vous devez fournir un paramètre Override pour la configuration du compte de service avec le nom DefaultValue de"${AWSMP_SERVICE_ACCOUNT}".

      11. Choisissez Masquer les mots de passe et les secrets pour masquer les informations sensibles dans les consoles, les outils de ligne de commande etAPIs. Pour plus d'informations, consultez la NoEcho documentation des paramètres dans la section Paramètres du guide de AWS CloudFormation l'utilisateur.

   3. Pour ajouter une option de livraison de modules complémentaires à la EKS console Amazon, assurez-vous que les artefacts sont conformesExigences relatives aux produits EKS complémentaires Amazon, puis effectuez les étapes suivantes :

      Note

      Une seule option de livraison des EKS modules complémentaires Amazon est prise en charge par version. Vous ne pouvez pas ajouter de nouvelle version tant que la version actuelle avec laquelle vous travaillez n'est pas publiée sur la EKS console Amazon.

      1. Dans Helm graphique, ajoutez l'Amazon ECR URL au Helm graphique que les acheteurs installeront dans leur environnement de déploiement pour lancer votre logiciel.

      2. Dans Images du conteneur, ajoutez l'Amazon ECR URL aux images du conteneur contenant la version logicielle du produit. Assurez-vous que toutes les images figurant dans le Helm les graphiques sont répertoriés.

      3. Dans Titre de l'option de livraison et Description de l'option de déploiement, entrez le titre et la description de cette option de livraison.

      4. Dans Visibilité, maintenez la valeur par défaut de Limité sélectionnée.

      5. Dans Nom du module complémentaire, entrez un nom unique pour ce module complémentaire. Le nom du module complémentaire que vous saisissez sera ajouté au nom du vendeur lors de son affichage dans la EKS console Amazon.

      6. Dans Version du module complémentaire, entrez la version du module complémentaire qui sera visible lors de l'installation ou de la mise à niveau de ce module complémentaire. Suivez le formatmajor.minor.patch.

      7. Dans Type de module complémentaire, sélectionnez une catégorie pour votre module complémentaire dans la liste déroulante.

      8. Dans Kubernetes Version, sélectionnez tous les Kubernetes versions prises en charge par votre module complémentaire.

      9. Dans Architecture, sélectionnez les architectures de plate-forme prises en charge par votre module complémentaire. Les options sont AMD64et ARM64. Nous recommandons de prendre en charge les deux architectures pour optimiser la compatibilité. Si votre module complémentaire n'est pas compatible avec ARM64 les appareils, vous devez spécifier une date prévue pour l'ajout du support avant que votre produit puisse être publié dans toutes les publicités Régions AWS.

      10. Dans Namespace, entrez une valeur unique Kubernetes espace de noms dans lequel votre module complémentaire sera installé. Les kube-public espaces de noms defaultkube-system, et ne sont pas pris en charge pour l'installation de modules complémentaires tiers.

      11. Dans les paramètres Environment Override, vous pouvez sélectionner jusqu'à 2 paramètres d'environnement dans le framework EKS complémentaire Amazon. Vous pouvez associer les noms de paramètres de votre fichier values.yaml à ces variables d'environnement, qui sont et. ${AWS_REGION} ${AWS_EKS_CLUSTER_NAME}

7. Pour ajouter des options de livraison supplémentaires, choisissez Nouvelle option de livraison et répétez les instructions des étapes précédentes pour les configurer.

8. Sélectionnez Envoyer.

Étape 4 : Mettre à jour les informations de version

Après la création d'une version, il peut être utile de fournir des informations actualisées à vos acheteurs en modifiant les informations associées à la version. Par exemple, si vous prévoyez de restreindre la version 1.0 après la publication de la version 1.1, vous pouvez mettre à jour la description de la version 1.0 pour rediriger les acheteurs vers la version 1.1. Indiquez la date à laquelle la version 1.0 sera restreinte. Vous mettez à jour les informations de version à partir du Portail de gestion AWS Marketplace.

Pour mettre à jour les informations de version

1. Connectez-vous à la Portail de gestion AWS Marketplace.

2. Sélectionnez Serveur dans le menu Produits.

3. Dans l'onglet Produits du serveur, sélectionnez le produit que vous souhaitez modifier.

4. Dans le menu déroulant Demander des modifications, choisissez Mettre à jour les informations de version.

5. Sur la page Mettre à jour la version, sélectionnez la version que vous souhaitez mettre à jour.

6. Apportez des mises à jour à la version sélectionnée. Les champs disponibles pour la mise à jour dépendent de l'état de la version du produit ou de l'option de livraison.

   1. Pour toutes les versions, vous pouvez mettre à jour les notes de publication.

   2. Pour les versions qui ne sont pas encore accessibles au public, vous pouvez mettre à jour le titre de la version.

   3. Pour les options de livraison qui n'ont pas été restreintes, vous pouvez mettre à jour les champs suivants :

      • Description

      • Instructions d'utilisation

      • Services pris en charge

   4. Pour les options de livraison dans les versions qui ne sont pas encore accessibles au public, vous pouvez mettre à jour les champs suivants :

      • Titres des options de livraison

      • Helm graphique (pour Helm (options de livraison de cartes uniquement)

      • Images de conteneur

      • Ressources de déploiement

      • AddOn Nom

      • AddOn Version

      • AddOn Type

      • Helm Graphique URI

      • CompatibleKubernetesVersions

      • SupportedArchitectures

      • Namespace

      • EnvironmentOverrideParameters

   5. Pour les options de livraison dans les versions accessibles au public, vous pouvez les mettre à jour SupportedArchitectures.

7. Sélectionnez Envoyer.

8. Vérifiez que la demande apparaît dans l'onglet Demandes avec le statut En cours d'examen.

Vous pouvez vérifier le statut de votre demande à tout moment dans l'onglet Demandes de la page Produits pour serveurs.

Restreindre une version de votre EKS module complémentaire Amazon

Pour restreindre une version de votre produit conteneur publiée en tant que module complémentaire, contactez l'équipe AWS Marketplace des opérations en utilisant le formulaire de contact au bas du Portail de gestion AWS Marketplace.