Configurar os componentes técnicos

Esta página descreve como criar os principais componentes técnicos necessários para distribuir o seu produto de imagem de contentor com o Google Cloud Marketplace.

Se tiver dúvidas durante o processo de integração, fale com o seu engenheiro de parceiros do Cloud Marketplace. Se não souber quem é o seu engenheiro de parceiros atribuído, use o serviço de apoio técnico para parceiros para pedir assistência e inclua a palavra "Marketplace" na descrição. Para mais informações acerca do serviço de apoio técnico para parceiros, visite o artigo Peça assistência com o Google Cloud Marketplace.

Configuração do Artifact Registry e do IAM

Antes de poder criar o seu produto no Producer Portal, tem de criar um repositório de preparação do Artifact Registry e enviar as imagens que quer distribuir no seu produto para esse repositório. No seu projeto, tem de conceder a função de editor do projeto a [e-mail].

Introdução ao Container Registry

Para enviar imagens de contentores etiquetadas para o Container Registry, siga os passos em Antes de começar na documentação do Artifact Registry. Em seguida, siga os passos abaixo para ativar a API Artifact Analysis.

Para parceiros de VMs existentes: o repositório do Artifact Registry de preparação pode estar no seu projeto de desenvolvimento em vez de no seu projeto público.

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

• API Artifact Registry
• API Artifact Analysis

A API Artifact Registry permite-lhe enviar para o Artifact Registry, e a API Artifact Analysis permite a análise de segurança.

Se tiver problemas ao aceder a qualquer uma destas APIs, contacte o seu engenheiro de parceiros.

Etiquetagem e envio de imagens

1. Escolha o caminho do repositório de preparação do Artifact Registry. Recomendamos que o seu repositório siga a estrutura us-docker.pkg.dev/YOUR-PARTNER-ID/YOUR-SOLUTION-ID.

   • O repositório de preparação tem de estar em us-docker.pkg.dev ou gcr.io (outras regiões, como europe-docker.pkg.dev ou eu.gcr.io, ainda não são suportadas).
   • Guarde ou copie o caminho do repositório de preparação para a criação de produtos no Producer Portal.

2. Crie a imagem que quer enviar para o repositório de preparação do Artifact Registry.

3. Etiquete a imagem através do Docker com latest.

   docker tag image_name staging_repo_path:tag

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

   Tenha em atenção que a imagem etiquetada latest é extraída se um utilizador não especificar uma etiqueta.

4. Envie a sua imagem através do gcloud:

   gcloud docker push staging_repo_path:tag

5. Repita o processo para quaisquer etiquetas ou imagens adicionais que queira adicionar ao repositório de preparação. Uma única imagem pode ter várias etiquetas.

   • Lembre-se de que o envio de uma imagem para o repositório de preparação não a torna automaticamente visível para os utilizadores. Isto só acontece com as imagens das etiquetas que selecionar, depois de publicadas.
   • O âmbito de um repositório é o nível único da pasta especificado no respetivo caminho. As imagens que se encontram noutra pasta no repositório não estão efetivamente no próprio repositório. Por outras palavras, se uma imagem estiver em us-docker.pkg.dev/testpartner/testsolution/1.0, NÃO está no repositório us-docker.pkg.dev/testpartner/testsolution. us-docker.pkg.dev/testpartner/testsolution/1.0 é um repositório separado.

Criar o seu produto no Producer Portal

Esta secção descreve como criar e publicar o seu produto de imagem de contentor no Producer Portal.

Para publicar o seu produto no Producer Portal, cria uma entrada para o produto e, em seguida, envia as seguintes informações para revisão:

• Detalhes do produto: adicione informações de marketing e da ficha sobre o seu produto.
• Imagens de contentores: indique o repositório do Google Container Registry que inclui as suas imagens de contentores.

Pode enviar estas críticas em qualquer altura e por qualquer ordem.

Para criar a entrada do seu produto no Cloud Marketplace:

1. Abra o Producer Portal na Google Cloud consola:

   https://console.cloud.google.com/producer-portal?project=YOUR_PUBLIC_PROJECT_ID
   

   Substitua YOUR_PUBLIC_PROJECT_ID pelo ID do projeto público que criou para o Cloud Marketplace, por exemplo, my-organization-public.

   Nota: se não vir o link ou não conseguir aceder ao URL, verifique se selecionou o projeto correto e se tem a função de editor (roles/editor) para o projeto. Se ainda não conseguir aceder ao URL, use o Support Desk para parceiros para pedir assistência e inclua a palavra "Marketplace" na descrição. Para mais informações sobre o serviço de apoio técnico para parceiros, visite o artigo Peça assistência com o Google Cloud Marketplace.

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

3. Selecione Imagem do contentor.

4. Em Nome do produto, atribua um nome ao produto e verifique o ID do produto. O ID do produto é usado no URL da sua ficha do Cloud Marketplace.

   Aviso: não é possível alterar o ID do produto nem o tipo de produto depois de criar o produto. Pode alterar o nome do produto antes de o enviar.

5. Clique em Criar. A criação do produto pode demorar alguns segundos.

Adicionar detalhes do produto

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

Para adicionar os detalhes do produto:

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

2. Na página Vista geral do produto, aceda a Detalhes do produto e clique em Editar.

3. Preencha o separador INFORMAÇÕES DO PRODUTO da secção Detalhes do produto. Ao concluir as INFORMAÇÕES DO PRODUTO, pode adicionar IDs de categorias. Os IDs das categorias permitem que os clientes encontrem o seu produto em categorias ou filtros selecionados enquanto pesquisam no Cloud Marketplace.

4. Para adicionar tutoriais, documentação e, opcionalmente, contratos de licença adicionais, preencha o separador DOCUMENTAÇÃO da secção Detalhes do produto. A sua documentação tem de cumprir os requisitos dos guias do utilizador.

5. Para adicionar metadados de pesquisa ou palavras-chave, ou para personalizar o URL da página de detalhes do seu produto, preencha o separador METADADOS DO PRODUTO da secção Detalhes do produto.

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

A equipa de engenharia de parceiros demora aproximadamente 2 a 5 dias a rever e aprovar os detalhes do produto. Pode começar a editar os detalhes agora e enviar a crítica mais tarde.

Adicionar as suas imagens de contentores

Tem de criar uma versão correspondente à etiqueta do registo do contentor latest (sensível a maiúsculas e minúsculas). Esta é a versão predefinida na página do produto.

Para adicionar as imagens de contentores:

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

2. Na página Vista geral do produto, aceda a Imagens do contentor e clique em Editar.

3. Na secção Imagens de contentores, introduza o URL do seu repositório do Artifact Registry de preparação.

4. Clique em Especificar lançamento. A leitura do repositório e o carregamento das etiquetas podem demorar alguns segundos.

5. Selecione a etiqueta de visualização para o lançamento que quer incluir no seu produto. Tem de incluir o lançamento latest no seu produto, mas pode adicionar versões adicionais. Recomendamos que limite o número de lançamentos disponíveis para o seu produto para conveniência dos utilizadores.

6. Opcionalmente, adicione um Título da versão e uma breve descrição do lançamento. Estas ajudam os utilizadores a implementar a versão que querem.

7. Introduza o sistema operativo que esta versão suporta. Pode especificar a versão do sistema operativo, se necessário.

8. Depois de adicionar todas as informações do lançamento, clique em Concluído.

9. Para adicionar outra versão, clique em Adicionar lançamento e introduza as informações desse lançamento.

10. Quando terminar de adicionar lançamentos suportados ao seu produto, clique em Guardar e validar. As imagens são copiadas para um repositório público e, em seguida, executamos uma série de testes nas imagens.

11. Clique em Enviar para enviar as imagens de contentores para revisão.

Pré-visualize o produto de imagem de contentor

Para pré-visualizar a sua ficha do Cloud Marketplace antes de esta ficar visível para os utilizadores:

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

2. Na página Vista geral do produto, clique em Pré-visualização completa.

Se alterou alguma etiqueta no seu repositório de preparação desde que validou as imagens dos contentores no Producer Portal, as imagens referenciadas na pré-visualização podem estar incorretas.

Publique o produto de imagem de contentor

Para publicar o seu produto no Cloud Marketplace, tem de:

• Conclua as revisões Detalhes do produto e Imagens do contentor.

• Ser aprovado como Google Cloud parceiro de compilação.

Depois de todas as críticas serem aprovadas, pode publicar e lançar o produto em poucos minutos. Para publicar o produto:

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

2. Na página Vista geral do produto, clique em Publicar.