Creación de instrucciones de uso de productos de AMI y contenedor para AWS Marketplace - AWS Marketplace

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.

Creación de instrucciones de uso de productos de AMI y contenedor para AWS Marketplace

Como vendedor de AWS Marketplace, entrega sus productos a los compradores de diferentes maneras. Al hacer envíos con Imagen de máquina de Amazon (AMI) e imágenes de contenedores, es responsable de escribir las instrucciones de uso de las mismas. En las siguientes secciones se proporcionan requisitos y recomendaciones sobre cómo escribir instrucciones de uso para estos tipos de productos.

Para obtener más información, consulte Productos basados en AMI en AWS Marketplace.

Requisitos

Al crear las instrucciones de uso del producto, debe incluir la siguiente información:

  • Ubicación de toda la información confidencial guardada por los clientes.

  • Explique toda la configuración de cifrado de datos. Proporcione instrucciones detalladas sobre la forma en que el usuario interactúa con la aplicación para descifrar los datos necesarios si la aplicación utiliza alguna técnica de cifrado.

  • Si su producto incluye material criptográfico, debe incluir los requisitos de rotación en las instrucciones de uso. Consulte Requisitos de producto basados en AMI para AWS Marketplace para obtener información sobre los requisitos básicos de los listados que utilizan credenciales y claves criptográficas.

  • Si alguno de los almacenes de datos en su producto está patentado, proporcione instrucciones paso a paso para la configuración, la copia de seguridad y la recuperación.

  • Instrucciones paso a paso sobre cómo evaluar y controlar el estado y el correcto funcionamiento de la aplicación. Por ejemplo:

    • Diríjase a la consola de Amazon EC2 y compruebe que se encuentra en la región correcta.

    • Elija Instancia y seleccione su instancia lanzada.

    • Seleccione el servidor para mostrar su página de metadatos y elija la pestaña Comprobaciones de estado situada en la parte inferior de la página para verificar si las comprobaciones de estado se han aprobado o no.

  • Guía prescriptiva sobre la gestión de las cuotas de servicio de AWS. Para obtener más información, consulte la Guía de referencia general de AWS.

  • Un desglose de precios que incluya el costo de ejecutar los recursos de AWS agregados por encima de la cuota estándar. Esto se puede incluir en las instrucciones de uso del producto o se puede vincular a la documentación que contenga información detallada sobre la gestión y la solicitud de un aumento de las cuotas de servicio.

Cómo escribir notas de la versión

Cada vez que actualice un producto, debe proporcionar una descripción de los cambios en las notas de la versión. Las notas de la versión deben contener información específica que ayude al usuario a tomar una decisión sobre si desea instalar la actualización. Utilice etiquetas claras para la actualización, como, por ejemplo, "Importancia crítica" para una actualización de seguridad o "Importante" u "Opcional" para otros tipos de actualizaciones.

Escritura de instrucciones de uso

Proporcione instrucciones de uso que contribuyan a garantizar que el comprador pueda configurar y ejecutar correctamente el software. Las instrucciones de uso que proporcione se muestran durante el proceso de configuración.

Para escribir instrucciones de uso efectivas, siga estas instrucciones:

  • Supongamos que el usuario está interesado pero cuenta con información suficiente.

  • Proporcione al usuario toda la información necesaria para lanzar y utilizar el producto, incluidos los ajustes de configuración y los pasos especiales.

Ejemplo de instrucciones de uso:

  1. Lance el producto con 1-Click.

  2. Use un navegador web para acceder a la aplicación en https://<EC2_Instance_Public_DNS>/index.html.

  3. Inicie sesión con las siguientes credenciales:

    • Nombre del usuario: user

    • Contraseña: el ID de la instancia (instance_id)

Escritura de instrucciones de actualización

Proporcione detalles sobre cómo el comprador puede actualizarse desde una versión anterior del producto. Incluya información sobre cómo conservar los datos y la configuración al crear otra instancia. Si no hay ninguna ruta de actualización, edite este campo para indicarlo específicamente.

Instrucciones de actualización de ejemplo:

  1. Haga ****, y a continuación ****.

  2. Compruebe que todos los complementos utilizados en el proyecto sean compatibles con la versión*.*, mediante ***. Si no son compatibles, realice ***.

  3. Haga una copia de seguridad de sus datos, mediante ***.

Redacción de instrucciones de entrega de CloudFormation

Cuando utilice la entrega de CloudFormation, también debe incluir lo siguiente:

  • Un propósito para cada rol de AWS Identity and Access Management (IAM) y política de IAM creados por la plantilla CloudFormation

  • Un propósito y una ubicación de cada clave creada por la plantilla CloudFormation

  • Detalles de configuración de red en implementaciones que incluyan más de un elemento

  • Una guía detallada sobre cómo se lanzan las aplicaciones y cómo se configuran para comunicarse si la implementación incluye varios recursos de AWS

  • Un desglose de precios que incluya el coste de ejecutar los recursos de AWS agregados por encima de los límites estándar. Proporcione una guía prescriptiva sobre la gestión de los límites de servicio de AWS.

  • Toda la configuración de cifrado de datos. Por ejemplo: cifrado del lado del servidor de Amazon S3, cifrado de Amazon Elastic Block Store (Amazon EBS), configuración de claves unificadas de Linux (LUKS), etc.