Como configurar os componentes técnicos

Nesta página, descrevemos como criar os principais componentes técnicos obrigatórios para distribuir o produto de imagem de contêiner com o Google Cloud Marketplace.

Se você tiver dúvidas durante o processo de integração, fale com seu engenheiro de parceiros do Google Cloud Marketplace. Se você não souber quem é o engenheiro de parceiros atribuído, entre em contato conosco pelo e-mail cloud-partner-onboarding@google.com.

Configuração do Container Registry e do IAM

Antes de criar seu produto no Portal do Produtor, é necessário criar um repositório de teste do Container Registry e enviar as imagens que você quer distribuir no seu produto para esse repositório. No projeto, é necessário conceder o papel Editor de projetos a cloud-commerce-marketplace-onboarding@twosync-src.google.com.

Primeiros passos com o Container Registry

Para enviar imagens de contêiner com tags para o Container Registry, siga as etapas em Antes de começar na documentação do Container Registry. Depois, siga as etapas abaixo para ativar a API Container Analysis.

Depois de instalar o gcloud e o Docker, você precisa ativar as seguintes APIs na página da Biblioteca de APIs:

  • API Container Registry
  • API Container Analysis

Com a Container Registry API, você pode fazer envios para o Container Registry. Além disso, ela possibilita a verificação de segurança.

Se você tiver problemas para acessar uma dessas APIs, entre em contato com seu engenheiro de parceiros.

Como marcar e enviar imagens

  1. Escolha o caminho do repositório de teste do Container Registry. É recomendável que seu repositório siga a estrutura gcr.io/YOUR-PARTNER-ID/YOUR-SOLUTION-ID.

    • O repositório de preparação precisa estar dentro de gcr.io (outras regiões, como eu.gcr.io, ainda não são compatíveis).
    • Salve ou copie o caminho do repositório de preparo para a criação de produtos no Portal do Produtor.
  2. Crie a imagem que você quer enviar ao repositório de teste do Container Registry.

  3. Marque a imagem pelo Docker com latest.

    docker tag image_name staging_repo_path:tag

    Por exemplo: docker tag test-image gcr.io/testpartner/testsolution:latest

    A imagem marcada com latest será extraída se um usuário não especificar uma tag.

  4. Envie a imagem usando gcloud:

    gcloud docker push staging_repo_path:tag

  5. Repita para as outras tags ou imagens que você gostaria de adicionar ao seu repositório de teste. Uma única imagem pode ter várias tags.

    • Lembre-se de que enviar uma imagem ao seu repositório de preparação não a tornará automaticamente visível para os usuários. Osso acontece apenas com as imagens das tags que você seleciona, depois que elas são publicadas.
    • O escopo do repositório é o único nível da pasta que seu caminho especifica. Quaisquer imagens que estão dentro de outra pasta no repositório não estão realmente no próprio repositório. Em outras palavras, se uma imagem estiver em gcr.io/testpartner/testsolution/1.0, ela NÃO estará no repositório gcr.io/testpartner/testsolution. gcr.io/testpartner/testsolution/1.0 é um repositório separado.

Como criar seu produto no portal

Nesta seção, descrevemos como criar e publicar seu produto de imagem de contêiner no Portal do Produtor ou no Portal do Parceiro.

Portal do Produtor

Para publicar seu produto no Portal do Produtor, crie uma entrada para ele e envie as seguintes informações para análise:

  • Detalhes do produto: adicione informações de listagem e marketing sobre seu produto.
  • Imagens de contêiner: forneça o repositório do Google Container Registry que inclui suas imagens de contêiner.

Essas avaliações podem ser enviadas a qualquer momento e em qualquer ordem.

Para criar uma entrada do Google Cloud Marketplace do seu produto:

  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 Google Cloud Marketplace, por exemplo, my-organization-public.

  2. Na parte superior da página, clique em Adicionar produto.

  3. Selecione Imagem do contêiner.

  4. Em Nome do produto, dê um nome para a solução e verifique o ID do produto. O ID do produto é usado no URL da sua listagem do Google Cloud Marketplace.

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

Como adicionar detalhes do produto

Os detalhes do produto incluem as informações do produto no Google Cloud Marketplace, as informações de marketing e os links para a documentação.

Para adicionar detalhes de produtos:

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

  2. Na página Visão geral do produto, acesse Detalhes do produto e clique em Editar.

  3. Preencha a guia INFORMAÇÕES SOBRE O PRODUTO da seção Detalhes do produto. É possível adicionar os IDs de categoria enquanto você conclui as INFORMAÇÕES SOBRE O PRODUTO. Com os ID de categorias, os clientes podem encontrar sua solução em categorias ou filtros selecionados enquanto pesquisam no Google Cloud Marketplace.

  4. Para adicionar tutoriais, documentações e, opcionalmente, outros contratos de licença, conclua oDOCUMENTAÇÃO guia deDetalhes do produto. A documentação precisa atender aos requisitos dos guias do usuário.

  5. Para adicionar metadados de pesquisa ou palavras-chave ou personalizar o URL da página de detalhes da solução, preencha a guia METADADOS DE PRODUTO da seção Detalhes do produto.

  6. Quando estiver pronto para enviar os detalhes do produto para processamento, clique em Enviar.

A equipe de Engenharia de parceiros leva de 2 a 5 dias para analisar e aprovar os detalhes do produto. Comece a editar os detalhes agora e envie a análise mais tarde.

Como adicionar imagens de contêiner

É necessário criar uma versão correspondente à tag latest do Container Registry (diferencia maiúsculas de minúsculas). Esta é a versão padrão na página do produto.

Para adicionar suas imagens de contêiner:

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

  2. Na página Visão geral do seu produto, acesse Imagens do contêiner e clique em Editar.

  3. Na seção Imagens de contêiner, insira o URL do seu repositório de teste do Container Registry.

  4. Clique em Especificar versão de lançamento. Pode levar alguns segundos para ler o repositório e carregar suas tags.

  5. Selecione a Tag de exibição da versão que você quer incluir no produto. Você precisa incluir a versão latest no produto, mas pode adicionar outras versões. Recomendamos limitar o número de versões disponíveis para seu produto para os usuários.

  6. Se quiser, adicione um título da versão e uma breve descrição da versão. Isso ajuda os usuários a implantar a versão que eles querem.

  7. Insira o sistema operacional compatível com esta versão. É possível especificar a versão do sistema operacional, se necessário.

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

  9. Para adicionar outra versão, clique em Adicionar versão e insira as informações dessa versão.

  10. Quando terminar de adicionar as versões compatíveis ao produto, clique em Salvar e validar. As imagens são copiadas em um repositório público e, em seguida, executamos uma série de testes nelas.

  11. Clique em Enviar para enviar as imagens do contêiner para revisão.

Publicar o produto de imagem de contêiner

Depois que todas as avaliações forem aprovadas, será possível publicar e lançar o produto em alguns minutos.

Clique em Visualização completa para visualizar a lista do Google Cloud Marketplace antes que ela fique visível para os usuários. As imagens referenciadas na visualização poderão ser imprecisas se você tiver alterado as tags no seu repositório de preparo desde a validação das imagens de contêiner no portal.

Para publicar seu produto de imagem de contêiner, faça o seguinte:

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

  2. Na página Visão geral do seu produto, clique em Publicar.

Portal do parceiro

O link direto para o Portal do parceiro é:

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

Em seguida, navegue até a seção Soluções.

Se você não vê o link ou não consegue acessar o URL, verifique se selecionou o projeto correto. Se você ainda não consegue vê-lo, entre em contato com cloud-partners@google.com para mais informações.

Etapa 2: criar seu produto como uma nova solução

  1. Clique em ADICIONAR SOLUÇÃO na parte superior da página.
  2. Nomeie a solução e verifique o código da solução.
  3. Selecione o tipo de solução Contêiner.
  4. Digite o URL do seu repositório de teste.

    • É o mesmo caminho do repositório de teste usado para marcar e enviar sua imagem.
    • O prompt validará o caminho do repositório de teste (certifique-se de que ele existe e está acessível pelo Portal do parceiro). O botão CRIAR ficará desativado até que um repositório válido seja fornecido.

Etapa 3: editar as informações de marketing do produto

  1. Para editá-las, clique no código da solução.
  2. Preencha as seções Metadados da solução, Detalhes da solução e Documentação e suporte.

Etapa 4: criar uma versão do latest (e qualquer outra)

É necessário criar uma versão correspondente à tag latest do Container Registry (diferencia maiúsculas de minúsculas). Ela será a versão padrão no menu suspenso e será extraída do repositório oficial do Container Registry se nenhuma tag for informada. Como opção, você pode criar versões adicionais, mas recomendamos ter apenas algumas para não sobrecarregar ou confundir os usuários finais.

  1. Clique no botão de edição ao lado de Versões no menu do editor da solução.
  2. Clique em Criar versão.
  3. Preencha as informações da versão:

    • Observe que todas as alterações que você faz são refletidas na visualização ao vivo no lado esquerdo do painel de edição. Lembre-se de que é possível clicar nos menus suspensos Versão ao lado do título da solução e na seção de metadados, mas o menu suspenso estará desativado se você tiver apenas uma versão:

    • Selecione a tag do Container Registry à qual a versão precisa corresponder. Ela servirá para identificar a versão e não poderá ser alterada após a criação.

    • Especifique um título (ele será exibido no menu suspenso).

    • Especifique uma descrição (opcional, será exibida no menu suspenso e nos metadados).

    • Indique o sistema operacional e o software do pacote (no mínimo um) para sua solução. Eles não podem ser alterados após o envio da solução.

    • Clique em Save.

  4. Repita para todas as versões subsequentes que você quiser adicionar.

  5. Organize suas versões na ordem desejada clicando no identificador e arrastando-o.

    • Suas alterações são refletidas na visualização ao vivo.

Você pode sair do Portal do parceiro e voltar mais tarde para continuar trabalhando ou concluir e enviar seu rascunho. Seu progresso será salvo.

Etapa 5: fazer as eventuais revisões de versão

Faça as revisões de versão necessárias clicando na tag (Container Registry) da versão que você quer editar na tabela existente na página "Visão geral da versão".

  • É possível editar o título, a descrição, a imagem atual, o sistema operacional ou o software do pacote de uma versão antes do envio.

    • Observe que o sistema operacional e o software do pacote estão associados a resumos específicos. Não será possível alterar o sistema operacional ou o software do pacote após o envio do rascunho. No entanto, se você atualizar o resumo da sua versão, será necessário confirmar/editar o sistema operacional e o software do pacote desse resumo específico.

    • Se a imagem atual em seu repositório de teste com a tag não corresponder à atual em seu rascunho, o botão Atualizar para resumo atual será ativado. Clique nele e confirme/edite o sistema operacional e o software do pacote para a nova imagem.

    • Também é possível excluir uma versão que ainda não foi enviada (é apenas parte do rascunho), exceto a versão latest, que é obrigatória.

Etapa 6: enviar

Depois de confirmar que o produto tem a aparência e o comportamento esperados, clique no botão Enviar para análise no menu principal do editor de soluções.