Como configurar seu ambiente do Google Cloud

Esta página descreve as etapas para configurar seu ambiente do Google Cloud, para que você possa distribuir seus aplicativos Kubernetes.

Crie um projeto

Como parte de se tornar um parceiro do Google Cloud Marketplace, configure um projeto que possa ser usado para testar e distribuir seu app.

Se você já tiver projetos configurados para vender produtos de VM, poderá reutilizá-los e pular para a configuração de um registro de contêiner.

Para gerenciar os produtos que você envia ao Google Cloud Marketplace, recomendamos que você crie um novo projeto com um ID de projeto terminado em -public. Para criar um projeto para seus produtos, consulte Como criar e gerenciar projetos.

Depois de criar o projeto, conceda o papel Visualizador de projetos a [e-mail]. Para ver as etapas para conceder acesso ao projeto, consulte Como conceder, alterar e revogar acesso aos recursos.

Enquanto cria seu produto, se você precisar de ajuda para depurar o projeto, por exemplo, para resolver problemas com seu repositório do Container Registry, conceda o papel de Editor do projeto a [e-mail].

Depois de criar o projeto, preencha o formulário de informações do projeto fornecido pela equipe do Google Cloud Marketplace.

Configurar um Container Registry

Você precisa de um repositório do Container Registry para hospedar as imagens do contêiner para seu aplicativo. O Container Analysis verifica continuamente as imagens do aplicativo em busca de vulnerabilidades, para que você possa revisar e solucionar problemas antes que os clientes implantem seu aplicativo.

Para configurar o Container Registry, o Docker e o SDK do Google Cloud, siga o início rápido do Container Registry.

Depois de configurar o Container Registry, no projeto que contém seu registro, conceda a função Leitor de Projeto a [e-mail].

Ativar a API Container Analysis

Você deve habilitar a API Container Analysis, que verifica as imagens do contêiner no Container Registry quanto a vulnerabilidades. Para ter uma visão geral da verificação de vulnerabilidades no Container Analysis, consulte a Documentação do Container Registry.

Adicione seu produto ao Portal do parceiro

Você usa o Portal do Google Partners para adicionar informações de marketing sobre seu aplicativo e inserir seu modelo de preços. Seu Engenheiro de parceiros habilita o Portal do Google Partners para você depois de preencher o formulário Informações do projeto.

Nesta etapa, você só precisa criar a entrada da solução para seu produto no Portal do parceiro. Você adiciona suas informações de marketing nas etapas posteriores.

O link direto para o Portal do parceiro é:

https://console.cloud.google.com/partner/solutions?project=YOUR_PUBLIC_PROJECT_ID

Observação: se você não vir o link ou não conseguir acessar o URL, verifique se selecionou o projeto correto. Se depois disso ainda não for possível acessar o URL, entre em contato com a equipe de parceiros do Cloud pelo e-mail [e-mail].

Para criar sua solução:

1. Na parte superior da página, clique em Adicionar solução.

2. Nomeie a solução e verifique o código dela. O ID da solução é usado no URL da sua listagem do Google Cloud Marketplace.

3. Em "Tipo de solução", selecione Aplicativo Kubernetes.

4. Na caixa URL do repositório de preparo, insira o URL do seu repositório do Container Registry.

   Cuidado: o ID e o tipo da solução não podem ser alterados após ela ser criada. Mas é possível alterar o nome da solução antes de enviá-la.

5. Clique em Criar. A criação da sua solução pode levar alguns segundos.

Você adiciona seu modelo de preços e informações de marketing para sua solução nas etapas posteriores.

Criar um cluster de desenvolvimento no Kubernetes Engine

Você usa o Google Kubernetes Engine para gerenciar e dimensionar clusters do Kubernetes. Para criar um cluster de teste e implantar um aplicativo básico, siga o Guia de início rápido do Google Kubernetes Engine.

Observação: se você não estiver usando ativamente o cluster em testes, pense em excluí-lo. Se quiser manter o cluster e economizar, você poderá redimensioná-lo e alterar o número de nós para zero. Para os passos de redimensionamento do cluster, consulte a documentação do Google Kubernetes Engine.

Instalar a ferramenta de desenvolvimento mpdev

A ferramenta mpdev é um contêiner que agrupa utilitários para testar e publicar imagens do app. Embora a instalação de mpdev não seja obrigatória para enviar um app para lançamento, é possível executar mpdev para verificar o ambiente de desenvolvimento e testar se o app é instalado corretamente no cluster de desenvolvimento.

Instale mpdev no repositório GitHub das ferramentas do Google Cloud Marketplace.

Para informações sobre como usar o mpdev para verificar o ambiente e testar o aplicativo, consulte a referência mpdev no GitHub (em inglês).

Como organizar seus lançamentos

Em geral, cada versão do aplicativo precisa adotar a versão semântica de versões 2.0, que segue a convenção de numeração de MAJOR.MINOR.PATCH. Toda versão deve ter um número de versão exclusivo, como 1.0.1, 1.0.2, 1.3.1 e assim por diante. Opcionalmente, adicione um hífen após o número da versão para adicionar um modificador de pré-lançamento, como 1.3.1-alpha201910. Modificadores de pré-lançamento podem ser usados para armazenar e destacar qualquer informação adicional que você achar útil, como datas de criação que indicam quando as versões foram criadas.

Recomendamos que você libere seu software em faixas. Cada faixa é uma série de versões com atualizações compatíveis com versões anteriores. Essa abordagem garante que seus usuários possam atualizar suas instalações com etapas manuais mínimas. Se você ativar as atualizações gerenciadas para o aplicativo, os usuários poderão atualizar as implantações por meio do Console do Cloud com apenas alguns cliques.

Suas faixas de lançamento podem ser baseadas em uma versão principal, como 4.x, ou em versões secundárias, como 4.1.x. Como prática recomendada, evite usar nomes genéricos de versão como latest.

Por exemplo, se você estiver lançando a versão 2.0 do seu software no Google Cloud Marketplace e esperar que as versões 2.0.1, 2.0.5 e assim por diante sejam compatíveis com versões anteriores com 2.0, organize esses lançamentos na faixa de lançamento 2.0. Quando você libera atualizações nessa faixa, os usuários são solicitados a atualizar suas instalações no Console do Cloud.

Ao lançar uma versão incompatível com versões anteriores do seu app ou uma versão que exija que os usuários passem por etapas de migração manual, libere-a em uma nova faixa para que os usuários possam planejar as atualizações.

Escolher os identificadores de produto

Você deve selecionar os seguintes identificadores para sua empresa, produto e imagens de contêiner, usados para criar seus URLs do Google Cloud Marketplace e os URIs para suas imagens de contêiner:

• O nome da empresa. Por exemplo, se o nome da sua empresa for Examplesoft Inc., você poderá usar o identificador examplesoft.

• O nome do produto. Por exemplo, se o nome do produto for Example Pro, use o identificador example-pro.

• A faixa de lançamento do seu produto, como 4.0.

  Veja os requisitos para organizar seus lançamentos.

• As imagens do contêiner. Selecione um identificador exclusivo para cada imagem de contêiner no seu aplicativo. Os seguintes identificadores são necessários para todos os aplicativos:

  • A imagem principal: essa imagem de contêiner é a principal do produto e usa o mesmo identificador do produto. Por exemplo, se o identificador do produto for example-pro, a imagem principal usará o mesmo identificador.
  • deployer: a imagem do contêiner de implantação para a faixa. O contêiner de implantação é executado quando os usuários implantam seu aplicativo no Console do Google Cloud. Você cria uma imagem de implantação quando cria seu pacote de aplicativos.

Cuidado: os identificadores selecionados aparecem nos URLs do produto e nos URIs da imagem do contêiner. É difícil alterar esses identificadores após a publicação do seu produto nos clientes do Google Cloud Marketplace.

Por exemplo, a empresa Examplesoft Inc. escolhe os seguintes identificadores para o produto, Example Pro:

	Nome	Identificador
Empresa	Examplesoft Inc	examplesoft
Produto	Example Pro	example-pro
Imagem [1] (principal)	Example Pro server	n/d
Imagem [2]	Example Queue	example-queue
Imagem [implantador]	n/d	deployer
Faixa de lançamento [1]	Version 4.x.x	4,0
Faixa de lançamento [2]	Version 5.x.x	5.0

Para esses identificadores, as seguintes informações são geradas automaticamente:

• O URL do produto no Google Cloud Marketplace: https://console.cloud.google.com/marketplace/details/examplesoft/example-pro

• Os URIs da imagem do contêiner:

  • marketplace.gcr.io/examplesoft/example-pro:4.0
  • marketplace.gcr.io/examplesoft/example-pro/example-queue:4.0
  • marketplace.gcr.io/examplesoft/example-pro/deployer:4.0
  • marketplace.gcr.io/examplesoft/example-pro:5.0
  • marketplace.gcr.io/examplesoft/example-pro/example-queue:5.0
  • marketplace.gcr.io/examplesoft/example-pro/deployer:5.0