Agregación de una nueva versión del producto de contenedor en AWS Marketplace - AWS Marketplace
Paso 1: agregación de repositorios Paso 2: carga de imágenes y artefactos de contenedores a repositoriosPaso 3: agregación de una nueva versión del producto de contenedorPaso 4: actualización de la información de la versiónRestricción de una versión del complemento de Amazon EKS

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Agregación de una nueva versión del producto de contenedor en AWS Marketplace

Como vendedor de AWS Marketplace, puede agregar nuevas versiones del producto de contenedor, administrar las versiones y actualizar la información de las versiones. Es posible que el producto tenga varias versiones a lo largo de su vida útil. Cada versión tiene un conjunto de imágenes de contenedor que son específicas de esa versión. En los siguientes temas, se explica cómo administrar las versiones de los productos de contenedor.

nota

No puede agregar una versión a su producto hasta que haya creado el ID del producto y el precio de su producto. Para obtener más información sobre estos pasos, consulte Paso 1: creación del ID de producto y el código de producto para el producto de contenedor.

Paso 1: agregación de repositorios

Las imágenes del contenedor y otros artefactos del producto se almacenan en repositorios de AWS Marketplace. Normalmente, se crea un repositorio para cada artefacto necesario, pero el repositorio puede almacenar varias versiones del artefacto (con etiquetas diferentes).

nota

Todas las imágenes de la implementación del producto deben usar imágenes de los repositorios de AWS Marketplace.

En el siguiente procedimiento, se describe cómo agregar los repositorios necesarios en AWS Marketplace.

Para agregar repositorios

  1. Inicie sesión en AWS Marketplace Management Portal.

  2. Seleccione Servidor en el menú Productos.

  3. En la pestaña Productos de servidor, seleccione el producto que desea modificar y, a continuación, seleccione Agregar repositorios en el menú desplegable Solicitar cambios.

  4. Introduzca el nombre del repositorio que desea crear. Si desea crear más de un nuevo repositorio:

    • Seleccione Agregar nuevo repositorio para cada repositorio adicional.

    • Introduzca un nombre único. El nombre único que elija debe figurar en todos los productos de su cuenta de vendedor.

    nota

    El repositorio tendrá esta estructura: <repositoryID>.dkr.ecr.us-east-1.amazonaws.com/<sellerName>/<repositoryName>. Cuando agregue elementos al repositorio (en el siguiente procedimiento), obtendrán una etiqueta y tendrán esta estructura: <repositoryID>.dkr.ecr.us-east-1.amazonaws.com/<sellerName>/<repositoryName>:<tag>. El repositoryID es un ID interno de AWS Marketplace. El sellerName se basa en el nombre que ha creado para su cuenta de vendedor. Usted define el respositoryName en este paso. La tag se establece al cargar un artefacto en el repositorio.

  5. Seleccione Enviar.

nota

Puede tener hasta 70 repositorios por producto.

Se crea una nueva solicitud y se muestra en la pestaña Solicitudes. Cuando se complete, en cuestión de minutos podrá empezar a agregar imágenes de contenedores y otros artefactos a los repositorios que haya creado.

Paso 2: carga de imágenes y artefactos de contenedores a repositorios

Para cargar imágenes y artefactos de contenedores a los repositorios

  1. Inicie sesión en AWS Marketplace Management Portal.

  2. En el menú Productos, seleccione Servidor.

  3. En la pestaña Productos de servidor, seleccione el producto que desee modificar.

  4. Seleccione Agregar repositorios en el menú desplegable Solicitar cambios.

  5. Seleccione Ver los repositorios existentes.

  6. Seleccione el repositorio en el que desea cargar.

  7. Seleccione Ver comandos push para abrir una lista de instrucciones, incluidos los comandos que puede usar para enviar imágenes de contenedores de Docker y gráficos de Helm a ese repositorio.

    Para obtener información general sobre cómo enviar imágenes de contenedores y otros artefactos a los repositorios, consulte Envío de una imagen en la Guía del usuario de Amazon Elastic Container Registry.

    nota

    Puede usar las siguientes operaciones de API de Amazon Elastic Container Registry (Amazon ECR) cuando se llama a docker pull o a docker push:

    • DescribeImages: úselo para revisar los metadatos sobre las imágenes de un repositorio.

    • GetAuthorizationToken: úselo para autenticarse antes de cargar los artefactos en el repositorio y, a continuación, utilice nuestros comandos docker pull o docker push.

    • ListImages: úselo para ver una lista de las imágenes que ha introducido.

  8. Utilice los comandos de la lista para enviar cualquier artefacto necesario de su repositorio local al repositorio de AWS Marketplace de su producto.

    nota

    La tag que proporciona en los comandos push se utiliza para diferenciar la versión del artefacto que está cargando en el repositorio. Use una etiqueta que tenga sentido para la versión de la que forman parte los artefactos.

  9. Repita el procedimiento para cada imagen o artefacto del contenedor que necesite en su versión.

    nota

    Su versión puede incluir hasta 50 imágenes o artefactos de contenedores en cada opción de entrega. Consulte el siguiente procedimiento para obtener más información sobre las opciones de entrega.

Una vez que haya subido sus artefactos, estará listo para crear la versión de su producto.

nota

Las imágenes de su contenedor se escanean automáticamente para comprobar si cumplen Requisitos de productos basados en contenedores para AWS Marketplace. Para obtener más información, consulte Los contenedores escanean los productos para detectar problemas de seguridad.

Agregar una nueva opción de entrega

Cada versión del producto de contenedor requeriría una opción de entrega. La opción de entrega especifica las opciones de implementación disponibles para el comprador. En función de una de las siguientes opciones de entrega, tendrá que cargar los artefactos correspondientes en los repositorios.

  • Para obtener una opción de entrega de Imagen de contenedor, cargue todas imágenes de contenedores necesarias para la instalación del producto en el repositorio de Amazon Elastic Container Registry (Amazon ECR) que se creó en la consola de AWS Marketplace.

  • Para una opción de entrega de Gráfico de Helm, cargue el gráfico de Helm y las imágenes del contenedor en el repositorio de Amazon ECR creado en la consola de AWS Marketplace.

  • Para una opción de entrega de Complemento de consola de Amazon EKS, cargue el gráfico de Helm y las imágenes del contenedor en el repositorio de Amazon ECR creado en la consola de AWS Marketplace.

Paso 3: agregación de una nueva versión del producto de contenedor

nota

Si se genera algún error al añadir una nueva versión al contenedor, consulte la tabla Asynchronous Errors en Add a new version, en la Referencia de AWS Marketplace Catalog API.

Para agregar una nueva versión de su producto de contenedor

  1. Inicie sesión en AWS Marketplace Management Portal.

  2. Elija Servidor en el menú Archivo.

  3. En la pestaña Productos de servidor, seleccione el producto al que desee agregar una versión. A continuación, seleccione Agregar nueva versión en el menú desplegable Solicitar cambios.

  4. En la página Agregar nueva versión, introduzca el Título de la versión y las Notas de la versión de su versión.

  5. Tras introducir los detalles de la versión, el siguiente paso es agregar las opciones de entrega. Las opciones de entrega son conjuntos de instrucciones e información que los compradores pueden utilizar para lanzar el software desde la versión de su producto. Los compradores conocen las opciones de entrega como opciones de tramitación de producto.

    nota

    Su producto puede ser compatible con varias plataformas con diferentes imágenes de contenedor (por ejemplo, implementaciones de Kubernetes y Ubuntu). Puede crear una opción de entrega para cada forma en que los clientes puedan configurar su producto, hasta cuatro opciones de entrega por versión del producto.

    1. Si el producto ya tiene opciones de entrega en otras versiones, puede usar la opción existente como plantilla para agregar una opción de entrega a la nueva versión. En Opciones de envío, seleccione la opción de envío que desee agregar de la lista. Puede editar la opción siguiendo las instrucciones de los pasos siguientes.

    2. Para agregar una nueva opción de envío, seleccione Nueva opción de envío. Después de agregar una opción, siga las instrucciones de los siguientes pasos para configurarla.

  6. Elija un método de entrega para la opción de entrega. El método de entrega determina la forma en que los compradores lanzarán su software.

    • Para obtener una opción de entrega de imágenes de contenedores, proporcione rutas a imágenes de contenedores en un repositorio de Amazon Elastic Container Registry (Amazon ECR) que se creó en la consola de AWS Marketplace. Los compradores utilizan las rutas de imágenes de contenedor para lanzar el software, ya que llevan las imágenes directamente a sus entornos.

    • Si opta por una opción de entrega de Gráfico de Helm, proporcione rutas a los gráficos de Helm en un repositorio de Amazon ECR creado en la consola de AWS Marketplace. Los compradores instalan los gráficos de Helm en su entorno de implementación para lanzar el software.

    • Si opta por una opción de entrega de Complemento de consola de Amazon EKS, proporcione rutas a los gráficos de Helm en un repositorio de Amazon ECR creado en la consola de AWS Marketplace. Los compradores instalan el contenedor mediante la consola de Amazon EKS o las API nativas de complemento de Amazon EKS para lanzar el software. Para obtener más información, consulte Complementos de Amazon EKS.

    1. Para agregar una opción de entrega de Imagen de contenedor, lleve a cabo los siguientes pasos:

      1. En Imágenes de contenedor, agregue la URL de Amazon ECR a las imágenes del contenedor que contienen la versión del software del producto.

      2. En Título de la opción de entrega y en Descripción de la opción de implementación, introduzca un título y una descripción para esta opción de entrega.

      3. En Instrucciones de uso, introduzca información detallada para ayudar a los compradores a utilizar el software después de lanzarlo.

      4. En Servicios compatibles, seleccione los entornos en los que los compradores pueden lanzar el software.

      5. En Plantillas de implementación, agregue recursos que los compradores puedan utilizar para lanzar el software. Introduzca un título y una URL del recurso para cada plantilla.

    2. Para agregar una opción de entrega de Gráfico de Helm, lleve a cabo los siguientes pasos:

      1. En Gráfico de Helm, agregue la URL de Amazon ECR al gráfico de Helm que los compradores instalarán en su entorno de implementación para lanzar su software.

      2. En Imágenes de contenedor, agregue la URL de Amazon ECR a las imágenes del contenedor que contienen la versión del software del producto.

      3. En Título de la opción de entrega y en Descripción de la opción de implementación, introduzca un título y una descripción para esta opción de entrega.

      4. En Instrucciones de uso, introduzca información detallada para ayudar a los compradores a utilizar el software después de lanzarlo.

      5. En Servicios compatibles, seleccione los entornos en los que los compradores pueden lanzar el software.

      6. Opcional: en Nombre de la versión de Helm, introduzca el nombre del espacio de nombres de Kubernetes en el que se instalará el gráfico de Helm.

      7. Opcional: en Espacio de nombres de instalación de Helm, introduzca el nombre de la versión de Helm que utilizará el comando helm install.

      8. Opcional: en KubernetesNombre de la cuenta de servicio de , introduzca el nombre de la cuenta de servicio de Kubernetes que se utilizará para conectarse a AWS Identity and Access Management (IAM). La cuenta de servicio de Kubernetes llama a servicios de AWS como la concesión de licencias o la medición.

      9. Seleccione para habilitar QuickLaunch en esta versión del producto. Lanzamiento rápido es una característica de AWS Marketplace. Los compradores pueden usar Lanzamiento rápido para crear rápidamente un clúster de Amazon EKS y lanzar su software en él utilizando AWS CloudFormation. Para obtener más información, consulte Lanzamiento rápido en AWS Marketplace.

      10. En Anular parámetros, introduzca los parámetros que se utilizarán en los comandos de la CLI de Helm que inician el software. Estos parámetros permiten a los compradores anular los valores predeterminados proporcionados. Si ha activado Lanzamiento rápido, introduzca también un nombre de parámetro y una descripción para el formulario CloudFormation. Hay un límite de 15 parámetros cuando se usa la consola de administración de AWS Marketplace, pero no hay límite cuando se usa AWS Marketplace Catalog API. Para obtener más información, consulte Agregar una nueva versión a un producto basado en contenedores.

        nota

        Se requieren una serie de parámetros de anulación. Los productos Amazon EKS Anywhere requieren un parámetro de anulación para el secreto de licencia con un DefaultValue de "${AWSMP_LICENSE_SECRET}". En el caso de los productos de pago, debe proporcionar un parámetro de anulación para la configuración de la cuenta de servicio con el DefaultValue de "${AWSMP_SERVICE_ACCOUNT}".

      11. Elija Ocultar contraseñas y secretos para ocultar la información confidencial en las consolas, las herramientas de línea de comandos y las API. Para obtener más información, consulte la documentación sobre el parámetro NoEcho en la sección Parámetros de la Guía del usuario de AWS CloudFormation.

    3. Para añadir una opción de entrega de Complemento de consola de Amazon EKS, asegúrese de que los artefactos cumplen con Requisitos de los productos complementarios de Amazon EKS y, a continuación, lleve a cabo los siguientes pasos:

      nota

      Solo se admite una opción de entrega de complemento de Amazon EKS por versión. No podrá añadir una versión nueva hasta que la versión actual con la que está trabajando esté publicada en la consola de Amazon EKS.

      1. En Gráfico de Helm, agregue la URL de Amazon ECR al gráfico de Helm que los compradores instalarán en su entorno de implementación para lanzar su software.

      2. En Imágenes de contenedor, agregue la URL de Amazon ECR a las imágenes del contenedor que contienen la versión del software del producto. Asegúrese de que todas las imágenes del gráfico de Helm estén recopiladas.

      3. En Título de la opción de entrega y en Descripción de la opción de implementación, introduzca un título y una descripción para esta opción de entrega.

      4. En Visibilidad, mantenga el valor predeterminado de Limitado seleccionado.

      5. En Nombre del complemento, introduzca un nombre único para este complemento. El nombre del complemento que introduzca se adjuntará al nombre del vendedor al mostrarse en la consola de Amazon EKS.

      6. En Versión del complemento, introduzca la versión del complemento que estará visible al instalar o actualizar este complemento. Siga el formato major.minor.patch.

      7. En Tipo de complemento, seleccione una categoría para el complemento en la lista desplegable.

      8. En Versión de Kubernetes, seleccione todas las versiones de Kubernetes compatibles con el complemento.

      9. En Arquitectura, seleccione las arquitecturas de plataforma compatibles con el complemento. Las opciones son AMD64 y ARM64. Recomendamos admitir ambas arquitecturas para maximizar la compatibilidad. Si el complemento no es compatible con los dispositivos ARM64, para que el producto pueda publicarse en todas las Regiones de AWS comerciales, antes debe especificar una fecha prevista de compatibilidad.

      10. En Espacio de nombres, introduzca un espacio de nombres de Kubernetes único en el que se instalará el complemento. Los espacios de nombres default, kube-system y kube-public no son compatibles para la instalación de complementos de terceros.

      11. En Parámetros de anulación del entorno, puede seleccionar hasta 2 parámetros de entorno del marco de complementos de Amazon EKS. Puede asignar los nombres de los parámetros del values.yaml a estas variables de entorno, que son ${AWS_REGION} y ${AWS_EKS_CLUSTER_NAME}.

  7. Para agregar opciones de entrega adicionales, elija Nueva opción de entrega y siga las instrucciones de los pasos anteriores para configurarlas.

  8. Elija Enviar.

Paso 4: actualización de la información de la versión

Una vez creada una versión, puede resultar útil proporcionar información actualizada a los compradores modificando la información asociada a la versión. Por ejemplo, si piensa restringir la versión 1.0 después del lanzamiento de la versión 1.1, puede actualizar la descripción de la versión 1.0 para dirigir a los compradores a la versión 1.1. Indique la fecha en la que se restringirá la versión 1.0. Actualiza la información de la versión desde el AWS Marketplace Management Portal.

Para actualizar la información de la versión

  1. Inicie sesión en AWS Marketplace Management Portal.

  2. Seleccione Servidor en el menú Productos.

  3. En la pestaña Productos de servidor, seleccione el producto que desee modificar.

  4. En el menú desplegable Solicitar cambios, seleccione Actualizar la información de la versión.

  5. En la página Actualizar la versión, seleccione la versión que desea actualizar.

  6. Actualice la versión seleccionada. Los campos que están disponibles para la actualización dependen del estado de la versión del producto o de la opción de entrega.

    1. Para todas las versiones, puede actualizar las Notas de la versión.

    2. En el caso de las versiones que aún no están disponibles públicamente, puede actualizar el Título de la versión.

    3. Para las opciones de entrega que no están restringidas, puede actualizar los siguientes campos:

      • Descripción

      • Instrucciones de uso

      • Servicios admitidos

    4. Para las opciones de entrega en las versiones que aún no están disponibles públicamente, puede actualizar los siguientes campos:

      • Títulos de las opciones de entrega

      • Gráfico de Helm (solo para las opciones de entrega de Gráfico de Helm)

      • Imágenes de contenedor

      • Recursos de implementación

      • Nombre de complemento

      • Versión de complemento

      • Tipo de complemento

      • URI del gráfico de Helm

      • CompatibleKubernetesVersions

      • SupportedArchitectures

      • Espacio de nombres

      • EnvironmentOverrideParameters

    5. Para las opciones de entrega en las versiones disponibles públicamente, puede actualizar SupportedArchitectures.

  7. Elija Enviar.

  8. Compruebe que la solicitud aparezca en la pestaña Solicitudes con el estado En proceso de revisión.

Puede comprobar el estado de su solicitud en cualquier momento desde la pestaña Solicitudes de la página de Productos de servidor.

Restricción de una versión del complemento de Amazon EKS

Para restringir una versión del producto de contenedor publicada como complemento, póngase en contacto con el equipo de operaciones de AWS Marketplace mediante el formulario de contacto que aparece en la parte inferior del AWS Marketplace Management Portal.