Como fazer manutenção do seu produto

Nesta página, descrevemos as diretrizes para manter e atualizar seu produto depois que ele estiver ativo no Cloud Marketplace.

Como gerenciar atualizações para seu app

O processo de atualização do produto é semelhante ao de criação do pacote inicial de apps. Primeiro, você precisa gerar um novo conjunto de imagens de contêiner para a atualização e enviá-lo para o repositório de armazenamento temporário do Container Registry. Dependendo de você estar adicionando uma nova versão ou atualizando uma versão atual, siga as etapas abaixo para atualizar seu aplicativo.

Como adicionar uma nova versão

No repositório de preparação do Container Registry, marque as imagens do aplicativo com uma nova tag de versão secundária. Depois, siga as etapas para enviar seu app no Portal do Produtor.

Como atualizar uma versão

No repositório de preparação do Container Registry, marque suas imagens com a tag da versão secundária atual. Em seguida, use as etapas abaixo para atualizar o app no Portal do Produtor.

  1. Abra o Portal do Produtor no console do Google Cloud:

    https://console.cloud.google.com/producer-portal?project=YOUR_PUBLIC_PROJECT_ID
    

    Substitua YOUR_PUBLIC_PROJECT_ID pelo ID do projeto público que você criou para o Cloud Marketplace, por exemplo, my-organization-public.

  2. Na lista de produtos, clique no ID do produto.

  3. Na página Visão geral do produto, vá para a seção Imagens de contêiner e clique em Editar.

  4. Em Versões propostas, clique em Editar. A leitura do repositório e o carregamento das tags podem levar alguns segundos.

  5. Clique na versão que você quer atualizar.

  6. Em Tag de exibição, selecione a versão que usa o resumo correspondente à imagem atualizada no Container Registry.

  7. Depois de atualizar todas as informações da versão, clique em Concluído.

  8. Quando você terminar de adicionar as versões compatíveis ao produto, clique em Salvar e validar.

  9. Clique em Enviar para mandar as imagens do contêiner para análise.

  10. Depois que todas as avaliações forem aprovadas, será possível publicar e lançar o produto. Basta abrir a página Visão geral do produto e clicar em Publicar.

Assim como no envio inicial, a equipe do Cloud Marketplace realiza testes automatizados e analisa o envio.

Após a publicação da versão atualizada, ela se torna o padrão para novos clientes. Os clientes atuais verão novas imagens enviadas para tags existentes. As implantações da página de produto do Cloud Marketplace são sempre fixadas em resumos de imagens e não são atualizadas automaticamente. Também recomendamos fixar imagens nos resumos dos clientes que implantam seu aplicativo por meio da linha de comando.

Para ajudar seus usuários a atualizar suas imagens de aplicativos, recomendamos adicionar as etapas de atualização ao seu guia do usuário.

Como migrar de APIs descontinuadas do Kubernetes

À medida que as APIs do Kubernetes evoluem, as APIs antigas acabam sendo descontinuadas e removidas. Isso significa que seu app pode ficar incompatível com os clusters atuais do GKE. Normalmente, os objetos atuais são mantidos, portanto, as implantações em execução dos clientes não são afetadas.

Para evitar falhas em novas implantações de aplicativos:

  1. Analise as versões atuais do GKE nas Notas de lançamento do GKE e as próximas versões na programação de lançamentos do GKE.
  2. Atualize os manifestos do app para remover todas as dependências nas versões descontinuadas da API Kubernetes que foram removidas de todas as versões atuais ou futuras do GKE no canal normal ou estável. Consulte o guia de migração da API descontinuada do Kubernetes.
    • Por exemplo, atualize os usos do batch/v1beta1 CronJob para batch/v1, já que o batch/v1beta1 será removido na versão 1.25 do Kubernetes, de acordo com o guia.
    • Se não for possível atualizar os manifestos para versões anteriores do app, recomendamos remover a versão ou definir a restrição de cluster k8sVersion no esquema.
  3. Conclua o teste de todas as imagens de contêiner recriadas usando a ferramenta mpdev, de preferência em um cluster com uma versão do Kubernetes que não seja compatível com a API descontinuada que você está removendo.
    • Por exemplo, use um cluster da versão 1.22 do Kubernetes para testar a atualização do apiextensions.k8s.io/v1beta1 CustomResourceDefinition, que foi removido na versão 1.22 do Kubernetes.
  4. Siga as instruções sobre Como adicionar uma nova versão ou Atualizar uma versão existente para enviar suas mudanças no portal.

Alterações nos preços

As alterações de preços entram em vigor após um determinado período de espera e não são imediatas. Para detalhes, consulte o contrato.

  1. Abra o Portal do Produtor no console do Google Cloud:

    https://console.cloud.google.com/producer-portal?project=YOUR_PUBLIC_PROJECT_ID
    

    Substitua YOUR_PUBLIC_PROJECT_ID pelo ID do projeto público que você criou para o Cloud Marketplace, por exemplo, my-organization-public.

  2. Na lista de produtos, clique no ID do produto.

  3. Na página Visão geral do produto, acesse Revisão de preços e clique em Editar.

  4. Faça as mudanças nos preços.

  5. Clique em Submit para enviar o preço para análise.

  6. Depois que todas as avaliações forem aprovadas, será possível publicar e lançar o produto abrindo a página Visão geral do produto e clicando em Publicar.

Como suspender o uso de apps

À medida que você desenvolve seu software, talvez queira deixar determinadas versões indisponíveis no Cloud Marketplace.

Como remover uma versão do app

Quando você remove uma versão do produto, ela é removida imediatamente da página de detalhes do produto quando o produto é publicado. No entanto, remover uma versão não remove as imagens publicadas no Container Registry público.

  1. Abra o Portal do Produtor no console do Google Cloud:

    https://console.cloud.google.com/producer-portal?project=YOUR_PUBLIC_PROJECT_ID
    

    Substitua YOUR_PUBLIC_PROJECT_ID pelo ID do projeto público que você criou para o Cloud Marketplace, por exemplo, my-organization-public.

  2. Na lista de produtos, clique no ID do produto.

  3. Na página Visão geral do produto, vá para a seção Imagens de contêiner e clique em Editar.

  4. Ao lado de Versões propostas, clique em Editar. A leitura do repositório e o carregamento das tags podem levar alguns segundos.

  5. Destaque a versão que você quer remover.

  6. Clique em Excluir para remover a versão.

  7. Clique em Concluído.

  8. Quando terminar de remover as versões do seu produto, clique em Salvar e validar.

  9. Clique em Enviar para mandar as imagens do contêiner para análise.

  10. Depois que todas as avaliações forem aprovadas, será possível publicar e lançar o produto. Basta abrir a página Visão geral do produto e clicar em Publicar.