Adicionando uma nova versão do seu produto de contêiner no AWS Marketplace - AWS Marketplace

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Adicionando uma nova versão do seu produto de contêiner no AWS Marketplace

Como AWS Marketplace vendedor, você pode adicionar novas versões do seu produto de contêiner, gerenciar versões e atualizar as informações da versão. Seu produto pode ter várias versões ao longo da vida útil. Cada versão tem um conjunto de imagens de contêiner que são específicas dessa versão. Os tópicos a seguir mostram como gerenciar versões de produtos para seus produtos de contêiner.

nota

Você não pode adicionar uma versão ao produto até criar o ID e o preço do produto. Para mais informações sobre essas etapas, consulte Etapa 1: criar o ID do produto e do código do produto para seu produto de contêiner.

Etapa 1: adicionar repositórios

As imagens do contêiner e outros artefatos do produto são armazenados em repositórios no AWS Marketplace. Normalmente, você cria um repositório para cada artefato necessário, mas o repositório pode armazenar várias versões do artefato (com tags diferentes).

nota

Todas as imagens na implantação do produto devem usar imagens dos repositórios do AWS Marketplace .

O procedimento a seguir descreve como adicionar os repositórios necessários em AWS Marketplace.

Para adicionar repositórios
  1. Faça login no Portal de gerenciamento do AWS Marketplace.

  2. Selecione Servidor no menu Produtos.

  3. Na guia Produtos de servidor, selecione o produto que você deseja modificar e, em seguida, escolha Adicionar repositórios no menu suspenso Solicitar alterações.

  4. Insira o nome do repositório que você deseja criar. Se você quiser criar mais de um novo repositório:

    • Escolha Adicionar novo repositório para cada repositório adicional.

    • Dê a ele um nome exclusivo. O nome exclusivo que você escolher deve estar em todos os produtos em sua conta de vendedor.

    nota

    O repositório terá essa estrutura: <repositoryID>.dkr.ecr.us-east-1.amazonaws.com/<sellerName>/<repositoryName>. Quando você adicionar itens ao repositório (no procedimento a seguir), eles receberão uma tag e terão essa estrutura: <repositoryID>.dkr.ecr.us-east-1.amazonaws.com/<sellerName>/<repositoryName>:<tag>. repositoryIDÉ um ID interno para AWS Marketplace. sellerName é baseado no nome que você criou para sua conta de vendedor. Você define o respositoryName nesta etapa. A tag é definida quando você carrega um artefato no repositório.

  5. Selecione Submit (Enviar).

nota

É possível ter até 50 repositórios por produto.

Uma nova solicitação é criada e exibida na guia Solicitações. Quando estiver concluído, em minutos, você poderá começar a adicionar imagens de contêiner e outros artefatos aos repositórios que criou.

Etapa 2: upload de imagens de contêiner e artefatos para repositórios

Para fazer upload de imagens de contêiner e artefatos para repositórios
  1. Faça login no Portal de gerenciamento do AWS Marketplace.

  2. No menu Produtos, escolha Servidor.

  3. Na guia Produtos de servidor, selecione o produto que você deseja modificar.

  4. Escolha Adicionar repositórios no menu suspenso Solicitar alterações.

  5. Escolha Exibir repositórios existentes.

  6. Selecione o repositório para o qual deseja fazer upload.

  7. Selecione Exibir comandos push para abrir uma lista de instruções, incluindo comandos que você pode usar para enviar Docker imagens de contêineres e Helm gráficos para esse repositório.

    Para obter informações gerais sobre como enviar imagens de contêiner e outros artefatos para repositórios, consulte Enviar uma imagem no Guia do usuário do Amazon Elastic Container Registry.

    nota

    É possível usar as seguintes operações de API do Amazon Elastic Container Registry (Amazon ECR) ao chamar docker pull ou docker push:

    • DescribeImages: use para revisar os metadados sobre as imagens em um repositório.

    • GetAuthorizationToken: use para autenticar antes de enviar artefatos para o repositório e, em seguida, use os comandos docker pull ou docker push.

    • ListImages: use para ver uma lista de imagens que você enviou.

  8. Use os comandos listados para enviar todos os artefatos necessários do seu repositório local para o AWS Marketplace repositório do seu produto.

    nota

    A tag que você fornece nos comandos push é usada para diferenciar a versão do artefato que está carregando no repositório. Use uma tag que faça sentido para a versão da qual os artefatos fazem parte.

  9. Repita o procedimento para cada imagem de contêiner ou artefato que você precisa em sua versão.

    nota

    Sua versão pode incluir até 50 imagens de contêiner ou artefatos em cada opção de entrega. Consulte o procedimento a seguir para obter mais informações sobre as opções de entrega.

Depois de fazer o upload dos artefatos, você estará pronto para criar a versão do produto.

nota

As imagens do contêiner são digitalizadas automaticamente para ver se elas cumprem as Requisitos de produtos baseados em contêineres para AWS Marketplace. Para obter mais informações, consulte O produto de contêiner verifica se há problemas de segurança.

Adição de uma nova opção de entrega

Cada versão do seu produto de contêiner precisaria de uma opção de entrega. A opção de entrega especifica as opções de implantação disponíveis para o comprador. Dependendo de uma das opções de entrega abaixo, você precisaria carregar os artefatos apropriados nos repositórios.

  • Para uma opção de entrega de imagens de contêiner, faça o upload de todas as imagens de contêiner necessárias para a instalação do produto no repositório Amazon Elastic Container Registry (Amazon ECR) criado no console. AWS Marketplace

  • Para um Helm opção de entrega do gráfico, faça o upload do Helm imagens de gráficos e contêineres no repositório Amazon ECR criado no AWS Marketplace console.

  • Para uma opção de entrega complementar do console Amazon EKS, faça o upload do Helm imagens de gráficos e contêineres no repositório Amazon ECR criado no AWS Marketplace console.

Etapa 3: adicionar uma nova versão ao produto de contêiner

nota

Se você receber algum erro ao adicionar uma nova versão ao seu contêiner, consulte a tabela Adicionar uma nova versão de erros assíncronos na Referência AWS Marketplace Catalog API .

Para adicionar uma nova versão ao produto de contêiner
  1. Faça login no Portal de gerenciamento do AWS Marketplace.

  2. Escolha Servidor no menu Produtos.

  3. Na guia Produtos de servidor, selecione o produto ao qual você deseja adicionar uma versão. Em seguida, escolha Adicionar nova versão no menu suspenso Solicitar alterações.

  4. Na página Adicionar nova versão, insira o Título da versão e as Notas de lançamento da sua versão.

  5. Depois de inserir os detalhes da versão, a próxima etapa é adicionar opções de entrega. As opções de entrega são conjuntos de instruções e informações que os compradores podem usar para executar o software a partir da versão do produto. As opções de entrega são conhecidas como opções de execução aos compradores.

    nota

    Seu produto pode oferecer suporte a várias plataformas com diferentes imagens de contêiner (por exemplo, Kubernetes and Ubuntu implantações). Você pode criar uma opção de entrega para cada forma de configuração, até quatro opções de entrega para uma versão do produto.

    1. Se o produto já tiver opções de entrega em outras versões, você poderá usar a opção existente como modelo para adicionar uma opção de entrega à nova versão. Em Opções de entrega, escolha a opção de entrega que você deseja adicionar na lista. Você pode editar a opção usando as instruções nas etapas a seguir.

    2. Para adicionar uma nova opção de entrega, escolha Nova opção de entrega. Depois de adicionar uma opção, siga as instruções nas etapas a seguir para configurá-la.

  6. Escolha um método de entrega para a opção de entrega. O método de entrega determina como os compradores vão executar seu software.

    • Para uma opção de entrega Imagem de contêiner, forneça caminhos para imagens de contêiner em um repositório do Amazon Elastic Container Registry (Amazon ECR) que foi criado no console do AWS Marketplace . Os compradores usam os caminhos de imagem do contêiner para executar o software, inserindo as imagens diretamente em seus ambientes.

    • Para um Helm opção de entrega de gráficos, forneça caminhos para Helm gráficos em um repositório Amazon ECR que foi criado no AWS Marketplace console. Os compradores instalam o Helm gráficos em seu ambiente de implantação para iniciar o software.

    • Para uma opção de entrega complementar do console Amazon EKS, forneça caminhos para Helm gráficos em um repositório Amazon ECR que foi criado no AWS Marketplace console. Os compradores instalam o contêiner usando o console Amazon EKS ou o complemento nativo do Amazon EKS APIs para iniciar o software. Para obter mais informações consulte Complementos do Amazon EKS do Amazon EKS disponível.

    1. Para adicionar uma opção de entrega Imagem de contêiner, realize as seguintes etapas:

      1. Em Imagens de contêiner, adicione o URL do Amazon ECR às imagens de contêiner que possuem o software da versão do produto.

      2. Em Título da opção de entrega e Descrição da opção de implantação, insira um título e uma descrição para essa opção de entrega.

      3. Em Instruções de uso, insira informações detalhadas para ajudar os compradores a usar seu software depois de executá-lo.

      4. Em Serviços suportados, selecione os ambientes nos quais os compradores podem executar o software.

      5. Em Modelos de implantação, adicione recursos que os compradores possam usar para executar o software. Insira um título e um URL para o recurso para cada modelo.

    2. Para adicionar um Helm opção de entrega do gráfico, execute as seguintes etapas:

      1. EmHelm gráfico, adicione o URL do Amazon ECR ao Helm gráfico que os compradores instalarão em seu ambiente de implantação para lançar seu software.

      2. Em Imagens de contêiner, adicione o URL do Amazon ECR às imagens de contêiner que possuem o software da versão do produto.

      3. Em Título da opção de entrega e Descrição da opção de implantação, insira um título e uma descrição para essa opção de entrega.

      4. Em Instruções de uso, insira informações detalhadas para ajudar os compradores a usar seu software depois de executá-lo.

      5. Em Serviços suportados, selecione os ambientes nos quais os compradores podem executar o software.

      6. Opcional - Em Helm nome da versão, insira o nome do Kubernetes namespace onde o Helm o gráfico será instalado.

      7. Opcional - Em Helm namespace de instalação, insira o nome do Helm versão que será usada pelo helm install comando.

      8. Opcional - Em Kubernetes nome da conta de serviço, insira o nome do Kubernetes conta de serviço que será usada para se conectar ao AWS Identity and Access Management (IAM). A ferramenta Kubernetes a conta de serviço chama AWS serviços como licenciamento ou medição.

      9. Escolha ativar QuickLaunchnesta versão do produto. QuickLaunch é um recurso do AWS Marketplace. Os compradores podem usar QuickLaunch para criar um cluster Amazon EKS rapidamente e lançar seu software nele usando AWS CloudFormation. Para obter mais informações, consulte QuickLaunch em AWS Marketplace.

      10. Em Substituir parâmetros, insira os parâmetros que serão usados no Helm Comandos da CLI que iniciam o software. Esses parâmetros permitem que os compradores substituam os valores padrão fornecidos. Se você tiver ativado QuickLaunch, insira também um nome de parâmetro e uma descrição para o CloudFormation formulário. Há um limite de 15 parâmetros ao usar o AWS Marketplace Management Console, mas não há limite ao usar AWS Marketplace Catalog API o. Para obter mais informações, consulte Adicionar uma nova versão a um produto baseado em contêiner.

        nota

        Alguns Parâmetros de substituição são obrigatórios. Os produtos Amazon EKS Anywhere exigem um Parâmetro de substituição para o segredo da licença com um DefaultValue de "${AWSMP_LICENSE_SECRET}". Para produtos pagos, você deve fornecer um Parâmetro de substituição para a configuração da conta de serviço com o DefaultValue de "${AWSMP_SERVICE_ACCOUNT}".

      11. Escolha Ocultar senhas e segredos para mascarar informações confidenciais em consoles, ferramentas de linha de comando e. APIs Para obter mais informações, consulte a documentação do parâmetro NoEcho em Parâmetros no Guia do usuário do AWS CloudFormation .

    3. Para adicionar uma opção de entrega Complemento do console do Amazon EKS, verifique se os artefatos estão em conformidade para Requisitos para produtos complementares do Amazon EKS, em seguida, execute as seguintes etapas:

      nota

      Somente uma opção de entrega complementar do Amazon EKS é suportada por versão. Você não poderá adicionar uma nova versão até que a versão atual com a qual você está trabalhando seja publicada no console do Amazon EKS.

      1. EmHelm gráfico, adicione o URL do Amazon ECR ao Helm gráfico que os compradores instalarão em seu ambiente de implantação para lançar seu software.

      2. Em Imagens de contêiner, adicione o URL do Amazon ECR às imagens de contêiner que possuem o software da versão do produto. Certifique-se de que todas as imagens dentro do Helm os gráficos estão listados.

      3. Em Título da opção de entrega e Descrição da opção de implantação, insira um título e uma descrição para essa opção de entrega.

      4. Em Visibilidade, mantenha o valor padrão de Limitado selecionado.

      5. Em Nome do complemento, insira um nome exclusivo para esse complemento. O nome do complemento que você inserir será anexado ao nome do vendedor enquanto é exibido no console do Amazon EKS.

      6. Em Versão do complemento, insira a versão do complemento que ficará visível ao instalar ou atualizar esse complemento. Ele segue o formato major.minor.patch.

      7. Em Tipo de complemento, selecione uma categoria para seu complemento na lista suspensa.

      8. EmKubernetes Versão, selecione todas as Kubernetes versões que seu complemento suportará.

      9. Em Arquitetura, selecione as arquiteturas de plataforma compatíveis com o complemento. As opções são AMD64 e ARM64. Recomendamos oferecer suporte às duas arquiteturas para maximizar a compatibilidade. Se seu complemento não for compatível com ARM64 dispositivos, você deverá especificar uma data planejada para adicionar suporte antes que seu produto possa ser publicado em todos os comerciais Regiões da AWS.

      10. Em Namespace, insira um exclusivo Kubernetes namespace em que seu complemento será instalado. Os namespaces default, kube-system e kube-public não são compatíveis com a instalação de complementos de terceiros.

      11. No parâmetro Substituição do ambiente, você pode selecionar até 2 parâmetros de ambiente da estrutura complementar do Amazon EKS. Você pode mapear os nomes dos parâmetros do seu values.yaml para essas variáveis de ambiente, que são ${AWS_REGION} e ${AWS_EKS_CLUSTER_NAME}.

  7. Para adicionar outras opções de entrega, escolha Nova opção de entrega e realize as instruções nas etapas anteriores para configurá-las.

  8. Selecione Enviar.

Etapa 4: atualizar as informações da versão

Depois que uma versão é criada, pode ser útil fornecer informações atualizadas aos compradores modificando as informações associadas à versão. Por exemplo, se você planeja restringir a versão 1.0 após o lançamento da versão 1.1, atualize a descrição da versão 1.0 para direcionar os compradores para a versão 1.1. Forneça a data em que a versão 1.0 será restrita. Você atualiza as informações da versão no Portal de gerenciamento do AWS Marketplace.

Para atualizar as informações da versão
  1. Faça login no Portal de gerenciamento do AWS Marketplace.

  2. Selecione Servidor no menu Produtos.

  3. Na guia Produtos de servidor, selecione o produto que você deseja modificar.

  4. No menu suspenso Solicitar alterações, escolha Atualizar informações da versão.

  5. Na página Atualizar versão, selecione a versão que você deseja atualizar.

  6. Faça atualizações na versão selecionada. Os campos disponíveis para atualização dependem do status da versão do produto ou da opção de entrega.

    1. Para todas as versões, você pode atualizar as Notas de lançamento.

    2. Para versões que ainda não estão disponíveis publicamente, você pode atualizar o Título da versão.

    3. Para opções de entrega que não foram restritas, você pode atualizar os seguintes campos:

      • Descrição

      • Instruções de uso

      • Serviços com suporte

    4. Para opções de entrega em versões que ainda não estão disponíveis publicamente, você pode atualizar os seguintes campos:

      • Títulos das opções de entrega

      • Helm gráfico (para Helm (somente opções de entrega de gráficos)

      • Imagens de contêiner

      • Recursos de implantação

      • AddOn Nome

      • AddOn Versão

      • AddOn Tipo

      • Helm URI do gráfico

      • CompatibleKubernetesVersions

      • SupportedArchitectures

      • Namespace

      • EnvironmentOverrideParameters

    5. Para opções de entrega em versões que estão disponíveis publicamente, você pode atualizar SupportedArchitectures.

  7. Selecione Enviar.

  8. Verifique se a solicitação aparece na guia Solicitações com o status Em análise.

Você pode verificar o status da solicitação a qualquer momento na guia Solicitações da página Produtos do servidor.

Restringir uma versão do complemento do Amazon EKS

Para restringir uma versão do seu produto de contêiner publicada como um complemento, entre em contato com a equipe de operações do AWS Marketplace usando o formulário de contato na parte inferior do Portal de gerenciamento do AWS Marketplace.