Configurar a imagem da VM para a implantação do Deployment Manager

Se você optar por oferecer suporte à implantação com o Deployment Manager para seu produto de VM, conclua as etapas a seguir.

Atenção: o recurso Ações do Deployment Manager não é mais compatível. Se as produto depende disso, use o Partner Support Desk para solicitar assistência e inclua a palavra "Marketplace" na sua descrição. Para mais informações sobre a Central de suporte a parceiros, acesse Solicitar assistência com o Cloud Marketplace.

Determinar como criar o pacote de implantação

Recomendamos que você use a opção de configuração guiada do Portal do Produtor para crie seu pacote de implantação diretamente no console do Google Cloud.

A configuração guiada é compatível com produtos de VM simples, como implantações de VM única com regras básicas de firewall, mas não com alguns recursos complexos, como implantações com várias VMs e campos de configuração personalizados. Se você precisar de recursos que não são compatíveis com a configuração guiada, use o ferramenta mpdev de código aberto para criar o pacote de implantação ou personalizar um pacote existente adicionando outros recursos a ela.

Não recomendamos o uso de modelos de implantação personalizados criados sem usando o console do Google Cloud ou o Deployment Manager Autogen com o Cloud Marketplace. Recomendamos que você crie sua implantação diretamente no console do Google Cloud.

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

Se você usar a opção de configuração guiada do Portal do Produtor e depois quiser configurar manualmente o pacote de implantação, clique em Acesse a configuração manual.

Ao mudar, você pode fazer o download da especificação do Autogen para o pacote de implantação criado na configuração guiada, que será usada como base para a configuração manual.

Observação: ao alternar entre a configuração guiada e a configuração manual do pacote de implantação, você cancela todas as validações que estão sendo executadas para o método de configuração anterior.

Concluir a configuração guiada

Para concluir a configuração e enviar um pacote de implantação simples usando o console do Google Cloud, siga estas etapas:

1. No Portal do Produtor, acesse a seção Pacote de implantação.

2. Em Configuração do Deployment Manager, ao lado do campo de entrada identificado Bucket do Cloud Storage, clique em Procurar.

   Se você já tiver criado um bucket do Cloud Storage, selecione-o aqui.

   Se você não tiver um bucket do Cloud Storage, clique no ícone rotulado Criar novo bucket. Após criar um novo bucket, siga estas etapas:

   • Selecione um nome para o bucket.
   • Especifique em qual região ou regiões o bucket armazena dados.
   • Especifique a classe de armazenamento dos seus dados.
   • Determine o nível de granularidade a ser aplicado ao Permissões do Identity and Access Management (IAM) para os dados do bucket.
   • Defina configurações avançadas opcionais, como criptografia ou dados de retenção de itens.

3. Certifique-se de Ativar o controle de versões de objetos para o bucket do Cloud Storage.

4. Para salvar as configurações do bucket e continuar a configurar o pacote de implantação, clique em Configurar.

5. Em Escolha o tipo de máquina, especifique uma Zona padrão. Tipo de máquina mínimo e Tipo de máquina padrão para sua VM além do tamanho e tipo do disco de inicialização.

6. Em Especificar sistema operacional, você deve especificar o nome e a versão. do SO usado pela imagem da VM e o número da versão da VM imagem.

7. Como alternativa, em Configurar acesso à VM, especifique os URLs do site e do administrador, além do nome de usuário e da senha, que os usuários poderão usar para acessar a VM após a implantação.

8. Em Configurar rede, é possível especificar as configurações Encaminhamento de IP e configure regras de Firewall.

9. Opcionalmente, em Definir as próximas etapas, é possível fornecer instruções para os usuários do seu produto para orientá-los sobre como começar a usá-lo. Essas instruções ficarão visíveis para eles depois que eles implantarem seu produto.

10. Depois de concluir as etapas anteriores, clique em Gerar para criar seu pacote de implantação.

    Se você precisar fazer outras alterações no pacote de implantação mais tarde, clique em Editar para fazer alterações e depois em Gerar para gere novamente o pacote de implantação com essas alterações aplicadas.

    Se você planeja mudar para a configuração manual, clique em Fazer o download para fazer o download da especificação do Autogen para o pacote de implantação que você criou na configuração guiada: use como base para sua configuração manual.

11. Envie o pacote de implantação para revisão no Portal do Produtor. Depois de enviar o pacote, pode levar até dois semanas para o Google analisar e aprovar o pacote.

Concluir a configuração manual

Nesta seção, explicamos como usar a ferramenta mpdev para criar um pacote de implantação e enviá-lo para revisão.

A ferramenta mpdev usa o Deployment Manager Autogen (link em inglês) para gerar os modelos do Deployment Manager para sua implantação . A ferramenta gera o pacote de implantação com base em um especificação que contém as entradas de configuração para seu produto de VM.

Em geral, para gerar e enviar seu pacote de implantação, é necessário fazer o seguinte:

1. Crie e configure um bucket do Cloud Storage para armazenar e gerenciar o acesso ao pacote de implantação.
2. Crie uma especificação do Autogen que inclua os detalhes da imagem e os requisitos de implantação do produto da VM.
3. Gere o pacote de implantação com base na especificação do Autogen e faça upload do pacote para o bucket do Cloud Storage.
4. Envie o pacote de implantação para revisão no Portal do Produtor. Depois do envio do pacote, pode levar até duas semanas para o Google analisar e aprovar o pacote.

As seções a seguir explicam como concluir as etapas para gerar e enviar o pacote de implantação.

Antes de começar

Se você estiver usando mpdev para criar o pacote de implantação, conclua o seguintes etapas:

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

2. Faça o download do SDK do Google Cloud.

Criar o bucket do Cloud Storage

Crie o bucket do Cloud Storage no mesmo projeto público do Google Cloud usado para o Portal do Produtor e configure o bucket das seguintes maneiras:

• Ative o Controle de versão de objeto para para proteger o pacote de implantação contra exclusão ou substituída.
• Conceda ao papel Leitor de objetos do Storage (roles/storage.objectViewer) para [e-mail].

Para criar e configurar um bucket do Cloud Storage, execute este comando: 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 você fornece para o novo bucket, sujeito a requisitos de nomenclatura.

Criar sua especificação do Autogen

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

Para casos de uso mais complexos, é possível configurar o preenchimento automático em algumas ambientes de desenvolvimento (IDEs) para ajudar a editar e validar arquivos configurations.yaml.

Observação: se a implantação contiver várias VMs, você poderá criar e personalizar a especificação do Autogen com base namulti VM example de dados.

Para criar sua especificação do Autogen no single VM example:

1. Confira a especificação pré-configurada do Autogen do exemplo em um diretório:

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

   Em que YOUR_PACKAGE_NAME é o nome que você para o diretório local. Por exemplo, my-deployment-package.

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

   • O nome da imagem da VM.
   • O ID do projeto público do Google Cloud que hospeda a imagem de VM, que é o mesmo projeto que você usa no Portal do Produtor.

   Para seguir as etapas de atualização da imagem da VM e dos campos do projeto do Google Cloud no arquivo configurations.yaml, consulte o arquivo README.md do single VM example.

3. Se necessário para seu produto, personalize outros campos, como passwords, deployInput e postDeploy. Esses campos estão localizados abaixo de DeploymentSpec no arquivo configurations.yaml. Para saber mais sobre os campos disponíveis para personalização, consulte a documentação de referência do Autogen.

Gerar seu pacote de implantação

Depois de criar e personalizar a especificação do Autogen, use o especificação para gerar os arquivos de modelo do Deployment Manager para o pacote de implantação. Para armazenar o pacote, faça o upload dele no do bucket do Cloud Storage.

Para gerar e fazer upload do pacote de implantação:

1. Defina o local de saída do pacote de implantação no bucket do Cloud Storage:

   Observação: é possível usar o comando a seguir se você tiver usado um dos comandos Autogen specification examples no repositório marketplace-tools. Se você criou sua especificação do Autogen manualmente, será necessário editar seu arquivo de especificação diretamente para atualizar o local de saída.

   mpdev cfg set zipPath gs://BUCKET_NAME/OBJECT
   

   Em que BUCKET_NAME é o nome do bucket que você criou para o pacote e OBJECT é o nome que você fornece para o objeto do Cloud Storage, sujeito às diretrizes de nomenclatura.

2. Gere o pacote de implantação:

   mpdev apply -f $PACKAGE/configurations.yaml
   

O pacote de implantação gerado é compactado e enviado ao seu bucket.

Para verificar se você configurou o modelo corretamente, crie uma implantaçã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
  

Enviar seu pacote de implantação para revisão no Portal do Produtor

Depois de criar e configurar o pacote de implantação, é preciso enviar o do pacote ao Portal do Produtor para que a equipe do Cloud Marketplace possa analisar e aprovar o pacote.

1. No Portal do Produtor, acesse a seção Pacote de implantação.

2. Em Especificar o local do objeto do Cloud Storage, selecione o objeto do pacote de implantação que você enviou anteriormente.

3. Clique em Validate (Validar). O processo de validação pode levar até duas horas para concluído, e é possível sair da tela durante esse processo.

4. Depois que o Portal do Produtor tiver lido o pacote de implantação, será pode clicar em Visualização da implantação para confira como o cliente vê a configuração da sua VM.

5. Após a conclusão da validação, para enviar a implantação para análise, clique em Enviar. Depois de enviar o pacote, ele pode o Google vai levar até duas semanas para analisar e aprovar o pacote.