Configure a imagem da VM para a implementação do Deployment Manager

Se optar por suportar a implementação com o Gestor de Implementações para o seu produto de VM, tem de concluir os seguintes passos.

Atenção: a funcionalidade Ações do Deployment Manager já não é suportada. Se o seu produto depender desta funcionalidade, use o Partner Support Desk para pedir assistência e inclua a palavra "Marketplace" na descrição. Para mais informações acerca da mesa de apoio técnico para parceiros, visite o artigo Peça assistência com o Google Cloud Marketplace.

Determine como criar o pacote de implementação

Recomendamos que use a opção de configuração guiada do Producer Portal para criar o pacote de implementação diretamente na Google Cloud consola.

A configuração guiada suporta produtos de VMs simples, como implementações de VMs únicas com regras de firewall básicas, mas não suporta algumas funcionalidades complexas, como implementações com várias VMs e campos de configuração personalizados. Se precisar de funcionalidades que a configuração guiada não suporta, pode usar a ferramenta de código aberto mpdev para criar o seu pacote de implementação ou personalizar um pacote existente adicionando-lhe capacidades adicionais.

Não recomendamos a utilização de modelos de implementação personalizados que criou sem usar a consola ou a ferramenta de geração automática do Gestor de Implementações com o Cloud Marketplace. Google Cloud Recomendamos que crie o pacote de implementação diretamente na Google Cloud consola.

Alterne entre a configuração guiada e a configuração manual

Se usar a opção de configuração guiada do Producer Portal e, mais tarde, quiser mudar para a configuração manual do pacote de implementação, clique em Aceder à configuração manual.

Quando muda, pode transferir a especificação de geração automática do pacote de implementação que criou na configuração guiada para usar como base para a configuração manual.

Nota: quando alterna entre a configuração guiada e a configuração manual do pacote de implementação, cancela todas as validações que estão a ser executadas para o método de configuração anterior.

Conclua a configuração guiada

Para concluir a configuração e enviar um pacote de implementação simples através da Google Cloud consola, conclua os seguintes passos:

1. No Producer Portal, aceda à secção Pacote de implementação.

2. Em Configuração do Deployment Manager, junto ao campo de entrada com a etiqueta Bucket do Cloud Storage, clique em Procurar.

   Se já tiver criado um contentor do Cloud Storage, selecione-o aqui.

   Se não tiver um contentor do Cloud Storage, clique no ícone com a etiqueta Criar novo contentor. Quando cria um novo depósito:

   • Selecione um nome para o contentor.
   • Especifique em que região ou regiões o contentor armazena dados.
   • Especifique a classe de armazenamento dos seus dados.
   • Determine o nível de detalhe a aplicar às autorizações de gestão de identidade e de acesso (IAM) para os dados do contentor.
   • Configure definições avançadas opcionais, como políticas de encriptação ou de retenção de dados.

3. Certifique-se de que ativa a criação de versões de objetos para o seu contentor do Cloud Storage.

4. Para guardar as definições do contentor e continuar a configurar o pacote de implementação, clique em Configurar.

5. Em Escolha o tipo de máquina, tem de especificar uma zona predefinida, um tipo de máquina mínimo e um tipo de máquina predefinido para o seu produto de VM, juntamente com o tamanho e o tipo do respetivo disco de arranque.

6. Em Especificar sistema operativo, tem de especificar o nome e a versão do SO que a imagem da VM usa, bem como o número da versão da imagem da VM.

7. Opcionalmente, em Configurar acesso à VM, pode especificar URLs do site e do administrador, juntamente com um nome de utilizador e uma palavra-passe, que os utilizadores podem usar para aceder à VM após a implementação.

8. Opcionalmente, em Configurar rede, pode especificar definições para o encaminhamento de IP e configurar regras de firewall.

9. Opcionalmente, em Definir passos seguintes, pode fornecer instruções para os utilizadores do seu produto, de modo a orientá-los sobre como começar a usar o produto. Estas instruções ficam visíveis para os clientes depois de implementarem o seu produto.

10. Depois de concluir os passos anteriores, clique em Gerar para criar o pacote de implementação.

    Se precisar de fazer alterações adicionais ao pacote de implementação mais tarde, pode clicar em Editar para fazer alterações e, de seguida, clicar em Gerar para regenerar o pacote de implementação com essas alterações aplicadas.

    Se planeia mudar para a configuração manual, pode clicar em Transferir para transferir a especificação de geração automática do pacote de implementação que criou na configuração guiada, para usar como base para a sua configuração manual.

11. Envie o pacote de implementação para revisão no Producer Portal. Depois de enviar o pacote, a Google pode demorar até duas semanas a rever e aprovar o pacote.

Conclua a configuração manual

Esta secção explica como usar a ferramenta mpdev para criar um pacote de implementação e enviar o pacote para revisão.

A ferramenta mpdevusa o Deployment Manager Autogen para gerar os modelos do Deployment Manager para o seu pacote de implementação. A ferramenta gera o pacote de implementação com base numa especificação Autogen que contém as entradas de configuração do seu produto de VM.

A um nível elevado, para gerar e enviar o pacote de implementação, tem de fazer o seguinte:

1. Crie e configure um contentor do Cloud Storage para armazenar e gerir o acesso ao pacote de implementação.
2. Crie uma especificação de geração automática que inclua os detalhes da imagem e os requisitos de implementação do seu produto de VM.
3. Gere o pacote de implementação com base na especificação do Autogen e carregue o pacote para o contentor do Cloud Storage.
4. Envie o pacote de implementação para revisão no Producer Portal. Depois de enviar o pacote, a Google pode demorar até duas semanas a rever e aprovar o pacote.

As secções seguintes explicam como concluir os passos para gerar e enviar o seu pacote de implementação.

Antes de começar

Se estiver a usar o mpdev para criar o pacote de implementação, conclua os seguintes passos:

1. Instale a mpdev ferramenta seguindo as instruções no marketplace-tools repositório.

2. Descarregue o SDK do Google Cloud.

Crie o seu contentor do Cloud Storage

Tem de criar o contentor do Cloud Storage no mesmo Google Cloud projeto público que usa para o Producer Portal e configurar o contentor das seguintes formas:

• Ative a Controlo de versões de objetos para o contentor de modo a proteger o pacote de implementação contra a eliminação ou a substituição.
• Conceda a função Storage Object Viewer (roles/storage.objectViewer) a [e-mail].

Para criar e configurar um contentor do Cloud Storage, execute os seguintes comandos gcloud storage:

  BUCKET_NAME=YOUR_BUCKET_NAME
  gcloud storage buckets create gs://$BUCKET_NAME
  gcloud storage buckets update gs://$BUCKET_NAME --versioning
  gcloud storage buckets add-iam-policy-binding gs://$BUCKET_NAME --member=group:[e-mail] --role=roles/storage.objectViewer
  

Em que YOUR_BUCKET_NAME é o nome que indica para o novo contentor, sujeito aos requisitos de nomenclatura.

Crie a sua especificação do Autogen

Para criar a especificação do Autogen, recomendamos que use o single VM example no repositório marketplace-tools como especificação inicial do Autogen e, em seguida, personalize a especificação com os detalhes de configuração da sua VM.

Para exemplos de utilização mais complexos, pode configurar o preenchimento automático em alguns ambientes de desenvolvimento integrados (IDEs) para ajudar a editar e validar ficheiros configurations.yaml.

Nota: se a sua implementação contiver várias VMs, pode criar e personalizar a especificação do Autogen com base no multi VM example do repositório.

Para criar a especificação do Autogen a partir do ícone single VM example:

1. Consulte a especificação do Autogen pré-configurada do exemplo num diretório local:

   PACKAGE=YOUR_PACKAGE_NAME
   mpdev pkg get https://github.com/GoogleCloudPlatform/marketplace-tools.git/examples/deployment-manager/autogen/singlevm $PACKAGE
   

   Onde YOUR_PACKAGE_NAME é o nome que indica para o diretório local. Por exemplo, my-deployment-package.

2. Atualize a especificação com os detalhes de configuração da sua VM modificando o ficheiro configurations.yaml com as seguintes informações:

   • O nome da imagem da VM.
   • O IDprojeto público Google Cloud que aloja a imagem da VM, que é o mesmo projeto que usa para o Producer Portal.

   Para ver os passos para atualizar a imagem da VM e os Google Cloud campos do projeto no ficheiroconfigurations.yaml, consulte o ficheiro single VM exampleREADME.md.

3. Se for necessário para o seu produto, personalize campos adicionais, como passwords, deployInput e postDeploy. Estes campos encontram-se em DeploymentSpec no ficheiro configurations.yaml. Para saber mais sobre os campos disponíveis para personalização, consulte a documentação de referência da geração automática).

Gere o pacote de implementação

Depois de criar e personalizar a especificação de geração automática, use a especificação para gerar os ficheiros de modelo do Gestor de Implementações para o seu pacote de implementação. Para armazenar o pacote, carregue-o para o contentor do Cloud Storage.

Para gerar e carregar o pacote de implementação:

1. Defina a localização de saída do pacote de implementação para o seu contentor do Cloud Storage:

   Nota: pode usar o seguinte comando se tiver usado um dos Autogen specification examples no repositório marketplace-tools. Se criou a especificação Autogen manualmente, tem de editar o ficheiro de especificação diretamente para atualizar a localização de saída.

   mpdev cfg set zipPath gs://BUCKET_NAME/OBJECT
   

   Em que BUCKET_NAME é o nome do contentor que criou para o pacote e OBJECT é o nome que indica para o objeto do Cloud Storage, sujeito às diretrizes de nomenclatura.

2. Gere o pacote de implementação:

   mpdev apply -f $PACKAGE/configurations.yaml
   

O pacote de implementação gerado é comprimido e carregado para o seu contentor.

Para verificar se configurou o modelo corretamente, crie uma implementação executando o seguinte comando:

  TMPDIR=$(mktemp -d)
  unzip $PACKAGE/template.zip -d $TMPDIR
  gcloud deployment-manager deployments create $PACKAGE --config $TMPDIR/test_config.yaml
  

Envie o pacote de implementação para revisão no Producer Portal

Depois de criar e configurar o pacote de implementação, tem de enviar o pacote para o Producer Portal para que a equipa do Cloud Marketplace possa rever e aprovar o pacote.

1. No Producer Portal, aceda à secção Pacote de implementação.

2. Em Especifique a localização do objeto do Cloud Storage, selecione o objeto do pacote de implementação que carregou anteriormente.

3. Clique em Validar. O processo de validação pode demorar até duas horas a ser concluído. Pode sair do ecrã enquanto o processo é concluído.

4. Depois de o Producer Portal ler com êxito o seu pacote de implementação, pode clicar em Pré-visualização da implementação para ver como o cliente vê a configuração da sua VM.

5. Após a validação ser concluída com êxito, clique em Enviar para enviar o pacote de implementação para revisão. Depois de enviar o pacote, a Google pode demorar até duas semanas a rever e aprovar o pacote.