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 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,
você precisa criar um repositório de teste do Container Registry e enviar
as imagens que quiser distribuir para esse repositório. No
projeto, conceda 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 tag para o Container Registry, siga as etapas descritas 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, é necessário 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
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, comoeu.gcr.io
, ainda não são compatíveis). - Salve ou copie o caminho do repositório de teste para criação de produtos no Portal do produtor.
- O repositório de preparação precisa estar dentro de
Crie a imagem que você quer enviar ao repositório de teste do Container Registry.
Marque a imagem usando o 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.Envie sua imagem usando
gcloud
:gcloud docker push staging_repo_path:tag
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óriogcr.io/testpartner/testsolution
.gcr.io/testpartner/testsolution/1.0
é um repositório separado.
Como criar seu produto no Portal do Produtor
Nesta seção, descrevemos como criar e publicar seu produto de imagem de contêiner no Portal do Produtor.
Para publicar seu produto no Portal do Produtor, crie uma entrada para o produto 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 a entrada do seu produto no Cloud Marketplace:
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 parte superior da página, clique em Adicionar produto.
Selecione Imagem do contêiner.
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 Cloud Marketplace.
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 Cloud Marketplace, as informações de marketing e links para a documentação.
Para adicionar os detalhes dele, siga estas etapas:
Na lista de produtos, clique no ID do produto.
Na página Visão geral do produto, acesse Detalhes do produto e clique em Editar.
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. Os IDs de categoria permitem que os clientes encontrem seu produto em categorias ou filtros selecionados durante a pesquisa no Cloud Marketplace.
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.
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.
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
É preciso 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 as imagens de contêiner, faça o seguinte:
Na lista de produtos, clique no ID do produto.
Na página Visão geral do produto, acesse Imagens de contêiner e clique em Editar.
Na seção Imagens de contêiner, insira o URL do repositório de teste do Container Registry.
Clique em Especificar versão. Pode levar alguns segundos para ler o repositório e carregar suas tags.
Selecione a Tag de exibição para a versão que você quer incluir no seu produto. Você precisa incluir a versão
latest
no seu produto, mas pode adicionar outras versões. Recomendamos limitar o número de versões disponíveis para o produto para facilitar a experiência dos usuários.É possível adicionar 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 procuram.
Insira o sistema operacional compatível com esta versão. Você pode especificar a versão do sistema operacional, se necessário.
Depois de adicionar todas as informações da versão, clique em Concluído.
Para adicionar outra versão, clique em Adicionar versão e insira as informações dela.
Quando terminar de adicionar as versões compatíveis ao seu 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 nas imagens.
Clique em Enviar para enviar as imagens do contêiner para revisão.
Visualizar o produto de imagem de contêiner
Para visualizar sua ficha do Cloud Marketplace antes que ela fique visível para os usuários, faça o seguinte:
Na lista de produtos, clique no ID do produto.
Na página Visão geral do produto, clique em Visualização completa.
Se você mudou alguma tag no repositório de teste depois de validar suas imagens de contêiner no Portal do Produtor, as imagens referenciadas na visualização podem estar imprecisas.
Publicar o produto de imagem de contêiner
Para publicar seu produto no Cloud Marketplace, é preciso:
Conclua as revisões de detalhes do produto e das imagens do contêiner.
Ter a aprovação para ser um parceiro do Google Cloud Build.
Depois que todas as avaliações forem aprovadas, você poderá publicar e lançar o produto em alguns minutos. Siga estas instruções para publicar seu produto:
Na lista de produtos, clique no ID do produto.
Na página Visão geral do produto, clique em Publicar.