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

Configuração do Artifact Registry e IAM

Antes de criar seu produto no Portal do Produtor, crie um repositório de teste do Artifact Registry e envie as imagens que você quer distribuir no seu produto nesse repositório. Em projeto, é preciso conceder o papel Editor do projeto [e-mail]:

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 no Documentação do Artifact Registry. Em seguida, use as etapas abaixo para ativar a API Artifact Analysis.

Para parceiros de VM atuais: seu preparo O repositório do Artifact Registry pode estar dentro do seu projeto dev seu projeto público.

Depois de instalar o gcloud e o Docker, ative as seguintes APIs do Página da biblioteca de APIs:

• API Artifact Registry
• API Artifact Analysis

A API Artifact Registry permite enviar por push para o Artifact Registry e a API Artifact Analysis permitem e 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 em us-docker.pkg.dev ou gcr.io (outras regiões, como europe-docker.pkg.dev ou eu.gcr.io, não são mas compatíveis).
   • Salve ou copie o caminho do repositório de teste para a criação do produto em Portal do Produtor.

2. Crie a imagem que você quer enviar ao preparo do Artifact Registry repositório de dados.

3. Marque a imagem via 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 com latest será extraída se um usuário não especificar um 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 está em us-docker.pkg.dev/testpartner/testsolution/1.0, está NÃO em us-docker.pkg.dev/testpartner/testsolution repositório de dados. us-docker.pkg.dev/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 listagens e de marketing sobre seu item.
• Imagens de contêiner: forneça o repositório do Google Container Registry. que inclui as imagens de contêiner.

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

Para criar a 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 público. projeto que você criou para o Cloud Marketplace, por exemplo, my-organization-public.

   Observação: se você não vir o link ou não conseguir acessar o URL, verifique se selecionou o projeto correto e se o Editor (roles/editor). Se ainda não conseguir acessar o URL, use o Partner Support Desk para solicitar e inclua a palavra "Marketplace" na sua descrição. Para mais informações sobre o Partner Support Desk, acesse Solicite assistência com o Cloud Marketplace.

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

3. Selecione Imagem de contêiner.

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

   Atenção: o ID e o tipo de produto não podem ser alterados após o produto é criado. É possível mudar o nome do produto antes de enviá-lo.

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 Cloud Marketplace, informações de marketing e links para documentação.

Para adicionar detalhes do produto:

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

2. Na página Visão geral do seu 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. Os IDs de categoria permitem para que os clientes encontrem seu produto em categorias ou filtros selecionados pesquisar no Cloud Marketplace.

4. Para adicionar tutoriais, documentações e, opcionalmente, outros contratos de licença, conclua oDOCUMENTAÇÃO guia deDetalhes do produto. Sua documentação precisa atender aos requisitos para 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

É preciso criar uma versão correspondente ao contêiner Tag de registro latest (diferencia maiúsculas de minúsculas). Essa é a versão padrão no página do produto.

Para adicionar 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 de contêiner, e clique em Editar.

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

4. Clique em Especificar versão. Pode levar alguns segundos para ler e carregar suas tags.

5. 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 é possível adicionar outras versões. Recomendamos limitar o número de versões disponíveis do seu produto para os usuários comodidade.

6. Como opção, adicione um Título da versão e uma breve descrição. Isso ajuda os usuários a implantar a versão desejada.

7. Informe 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 digite as informações para esse lançamento.

10. 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 depois executamos uma série de testes nas imagens.

11. Clique em Enviar para encaminhar as imagens do contêiner para análise.

Visualizar o produto de imagem do contêiner

Para visualizar a listagem do Cloud Marketplace antes que ela fique visível para os usuários:

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ê alterou as tags no repositório de teste desde a validação do imagens de contêiner no Portal do Produtor, as imagens mencionadas na visualização podem dos dados.

Publique seu produto de imagem de contêiner

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

• Conclua as revisões de Detalhes do produto e Imagens de contêiner.

• Ter aprovação como Parceiro de criação do Google Cloud.

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.