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 o engenheiro de parceiros do Google Cloud Marketplace. Se você não souber quem é o engenheiro de parceiros atribuído, use a Central de suporte ao parceiro para solicitar ajuda e incluir a palavra "Marketplace" na sua descrição. Para mais informações sobre Partner Support Desk, acesse Solicitar assistência com o Cloud Marketplace.

Configuração do Artifact Registry e do IAM

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

Primeiros passos com o Container Registry

Para enviar imagens de contêineres marcadas ao Container Registry, siga as etapas em Antes de começar na documentação do Artifact Registry. Em seguida, siga as etapas abaixo para ativar a API Artifact Analysis.

Depois de instalar o gcloud e o Docker, é necessário ativar as seguintes APIs na página da biblioteca de APIs:

  • API Artifact Registry
  • API Artifact Analysis

Com a API Artifact Registry, você pode fazer envios para o Artifact 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 Artifact Registry. É recomendável que seu repositório siga a estrutura us-docker.pkg.dev/YOUR-PARTNER-ID/YOUR-SOLUTION-ID.

    • O repositório de teste precisa estar dentro de us-docker.pkg.dev ou gcr.io (outras regiões, como europe-docker.pkg.dev ou eu.gcr.io, ainda não são compatíveis).
    • Salve ou copie o caminho do repositório de teste para a criação do produto no Portal do Produtor.
  2. Crie a imagem que você quer enviar para o repositório de teste do Artifact Registry.

  3. Marque a imagem no Docker com latest.

    docker tag image_name staging_repo_path:tag

    Por exemplo: docker tag test-image us-docker.pkg.dev/testpartner/testsolution:latest

    A imagem marcada como latest é 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 us-docker.pkg.dev/testpartner/testsolution/1.0, ela NÃO estará no repositório us-docker.pkg.dev/testpartner/testsolution. us-docker.pkg.dev/testpartner/testsolution/1.0 é um repositório separado.

Como criar seu produto no Portal do Produtor

Esta seção descreve 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 de marketing sobre o produto.
  • Imagens de contêiner: forneça o repositório do Google Container Registry que inclui as imagens do contêiner.

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

Para criar uma entrada do 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 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 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 informações do produto no Cloud Marketplace, informações de marketing e links para a documentação.

Para adicionar os detalhes do produto:

  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 IDs de categoria, os clientes podem encontrar seu produto em categorias ou filtros selecionados, enquanto pesquisam no 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 estar em conformidade com os 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). Essa é a versão padrão na página do produto.

Para adicionar as imagens do contêiner:

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

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

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

  4. Clique em Especificar versão. Pode levar alguns segundos para ler o repositório e carregar as tags.

  5. Selecione a tag de display para a versão que você quer incluir no produto. É necessário incluir a versão latest no seu produto, mas é possível adicionar outras versões. Recomendamos limitar o número de versões disponíveis para o produto para a conveniência dos usuários.

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

  7. Insira o sistema operacional compatível com essa 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 dela.

  10. Quando terminar de adicionar versões compatíveis ao produto, clique em Salvar e validar. As imagens são copiadas para 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.

Visualizar o produto da imagem do contêiner

Para conferir a listagem do Cloud Marketplace antes que ela fique visível para os usuários, faça o seguinte:

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

  2. Na página Visão geral do produto, clique em Visualização completa.

Se você tiver alterado tags no repositório de teste desde que validou as imagens do contêiner no Portal do Produtor, as imagens referenciadas na visualização poderão estar incorretas.

Publicar o produto de imagem do contêiner

Para publicar seu produto no Cloud Marketplace, você precisa:

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:

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

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