Esta página descreve as diretrizes para fazer manutenção e atualizar seu produto depois que ele é lançado 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. Em seguida, 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. Depois, siga as etapas abaixo para atualizar no Portal do Produtor.
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
.Na lista de produtos, clique no ID do produto.
Na página Visão geral do seu produto, acesse Imagens de contêiner. e clique em Editar.
Em Versões propostas, clique em Editar. Pode levar alguns segundos para ler e carregar suas tags.
Clique na versão que você quer atualizar.
Em Tag de exibição, selecione a versão que usa o resumo correspondente à imagem atualizada no Container Registry.
Depois de atualizar todas as informações da versão, clique em Concluído.
Quando você terminar de adicionar as versões compatíveis ao seu produto, clique em Salvar e validar.
Clique em Enviar para encaminhar as imagens do contêiner para análise.
Depois que todas as análises forem aprovadas, você poderá publicar e lançar o produto abrindo a página Visão geral do seu produto e clicando em Publicar.
Assim como no envio inicial, a equipe do Cloud Marketplace realiza tarefas testar e analisar seu 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 do produto do Cloud Marketplace são sempre fixadas nos 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 das APIs descontinuadas do Kubernetes
À medida que as APIs do Kubernetes evoluem, as APIs antigas são descontinuadas e removidas. Isso significa que o app pode se tornar incompatível com os clusters atuais do GKE. Normalmente, os objetos existentes são mantidos, para que as implantações em execução dos clientes não sejam afetadas.
Para evitar falhas em novas implantações de apps:
- Consulte as versões atuais do GKE nas notas da versão do GKE e as próximas versões na Programação de lançamentos do GKE.
- Atualize os manifestos do app para remover todas as dependências de versões
descontinuadas da API Kubernetes que são removidas em qualquer versão atual ou futura
do GKE no canal regular ou estável. Consulte a
Guia de migração de API descontinuado do Kubernetes.
- Por exemplo, atualize os usos de
batch/v1beta1
CronJob
parabatch/v1
. comobatch/v1beta1
será removido na versão 1.25 do Kubernetes, de acordo ao guia. - Se não for possível atualizar os manifestos para versões anteriores do
app, recomendamos remover a versão ou configurar
k8sVersion
restrição de cluster no seu esquema.
- Por exemplo, atualize os usos de
- Conclua o teste de todas as imagens de contêiner recriadas usando a
ferramenta mpdev (em inglês), idealmente em um cluster com uma versão do Kubernetes que
não oferece suporte à API descontinuada que você está removendo.
- Por exemplo, use um cluster do Kubernetes versão 1.22 para testar a atualização do
CustomResourceDefinition
apiextensions.k8s.io/v1beta1
, que foi removido na versão 1.22 do Kubernetes.
- Por exemplo, use um cluster do Kubernetes versão 1.22 para testar a atualização do
- Siga as instruções para adicionar uma nova versão ou atualizar uma versão existente para enviar suas mudanças no portal.
Alterações nos preços
As mudanças de preço entram em vigor após um determinado período de espera e não são imediatas. Para detalhes, consulte o contrato.
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
.Na lista de produtos, clique no ID do produto.
Na página Visão geral do produto, acesse Revisão de preços e clique em Editar.
Faça mudanças nos preços.
Clique em Enviar para enviar os preços para análise.
Depois que todas as avaliações forem aprovadas, você poderá 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, convém disponibilizar determinadas versões no Cloud Marketplace.
Como remover uma versão do app
Quando você remove uma versão do produto, ela é imediatamente removida da página de detalhes do produto quando o produto é publicado. No entanto, a remoção uma versão não remove as imagens publicadas para o público Container Registry.
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
.Na lista de produtos, clique no ID do produto.
Na página Visão geral do produto, acesse a seção Imagens do contêiner e clique em Editar.
Ao lado de Versões propostas, clique em Editar. Pode levar alguns segundos para ler o repositório e carregar suas tags.
Destaque a versão que você quer remover.
Clique em
Excluir para remover a versão.Clique em Concluído.
Quando terminar de remover as versões do produto, clique em Salvar e validar.
Clique em Enviar para enviar as imagens do contêiner para revisão.
Depois que todas as análises forem aprovadas, você poderá publicar e lançar o produto abrindo a página Visão geral do seu produto e clicando em Publicar.