Se você escolher a implantação com o Deployment Manager para seu produto de VM, siga as etapas abaixo.
Determinar como criar o pacote de implantação
Recomendamos que você use a opção de configuração guiada do Portal do Produtor para criar 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 não compatíveis com a configuração guiada,
use a
ferramenta mpdev
de código aberto
para criar seu pacote de implantação ou personalizar um pacote atual
ao adicionar outros recursos a ele.
Não recomendamos o uso de modelos de implantação personalizados criados sem o console do Google Cloud ou a ferramenta de geração automática do Deployment Manager com o Cloud Marketplace. Recomendamos que você crie seu pacote de 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 mudar para a configuração manual do seu pacote de implantação, clique em Acessar 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.
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:
No Portal do Produtor, acesse a seção Pacote de implantação.
Em Deployment Manager configuration, ao lado do campo de entrada Bucket do Cloud Storage, clique em Browse.
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 às permissões do Identity and Access Management (IAM) para os dados do bucket.
- Defina configurações avançadas opcionais, como criptografia ou políticas de retenção de dados.
Ative o controle de versões de objeto no bucket do Cloud Storage.
Para salvar as configurações do bucket e continuar a configurar o pacote de implantação, clique em Configurar.
Em Escolher o tipo de máquina, você precisa especificar uma zona padrão, Tipo de máquina mínimo e Tipo de máquina padrão para seu produto de VM, além do tamanho e do tipo do disco de inicialização.
Em Especificar sistema operacional, você precisa especificar o nome e a versão do sistema operacional que sua imagem de VM usa, bem como o número da versão da imagem da VM.
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.
Outra opção é, em Configurar rede, especificar as configurações de Encaminhamento de IP e configurar as regras de Firewall.
Também é possível, na opção Definir próximas etapas, fornecer instruções aos usuários para orientá-los sobre como começar a usar seu produto. Essas instruções vão ficar visíveis após a implantação do produto.
Depois de concluir as etapas anteriores, clique em Generate para criar o pacote de implantação.
Se precisar fazer outras mudanças no pacote de implantação mais tarde, clique em Edit para fazer as alterações e em Generate para gerar novamente o pacote de implantação com as 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.
Envie o pacote de implantação para revisão no Portal do Produtor. Depois do envio, pode levar até duas semanas para que o Google analise e aprove 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 Autogen
do Deployment Manager para gerar os modelos do Deployment Manager para o pacote de
implantação. A ferramenta gera o pacote de implantação com base em uma especificação do Autogen
que contém as entradas de configuração do produto da VM.
Em geral, para gerar e enviar seu pacote de implantação, é necessário fazer o seguinte:
- Crie e configure um bucket do Cloud Storage para armazenar e gerenciar o acesso ao pacote de implantação.
- Crie uma especificação do Autogen que inclua os detalhes da imagem e os requisitos de implantação do produto da VM.
- 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.
- Envie o pacote de implantação para revisão no Portal do Produtor. Depois do envio, 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 seu pacote de implantação, siga
estas etapas:
Instale a ferramenta
mpdev
seguindo as instruções no repositóriomarketplace-tools
.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ões do objeto do bucket para evitar que o pacote de implantação seja excluído ou substituído.
- Conceda o papel Leitor de objetos do Storage
(
roles/storage.objectViewer
) acloud-commerce-marketplace-onboarding@twosync-src.google.com
.
Para criar e configurar um bucket 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:cloud-commerce-marketplace-onboarding@twosync-src.google.com --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.
Em casos de uso mais complexos, é possível configurar o preenchimento automático em alguns ambientes
de desenvolvimento integrados (IDEs)
para ajudar a editar e validar arquivos configurations.yaml
.
Para criar sua especificação do Autogen no single VM example
:
Confira a especificação do Autogen pré-configurada do exemplo em um diretório local:
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ê fornece para o diretório local. Por exemplo,my-deployment-package
.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 arquivoREADME.md
dosingle VM example
.Se necessário para seu produto, personalize outros campos, como
passwords
,deployInput
epostDeploy
. Esses campos estão localizados abaixo deDeploymentSpec
no arquivoconfigurations.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 a especificação para gerar os arquivos de modelo do Deployment Manager para o pacote de implantação. Para armazenar o pacote, faça upload dele para o bucket do Cloud Storage.
Para gerar e fazer upload do pacote de implantação:
Defina o local de saída do pacote de implantação no bucket do Cloud Storage:
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.
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, envie-o ao Portal do Produtor para que a equipe do Cloud Marketplace possa analisar e aprovar o pacote.
No Portal do Produtor, acesse a seção Pacote de implantação.
Em Especificar o local do objeto do Cloud Storage, selecione o objeto do pacote de implantação que você enviou anteriormente.
Clique em Validate (Validar). O processo de validação pode levar até duas horas para ser concluído, e você pode sair da tela enquanto ela é concluída.
Depois que o Portal do Produtor ler o pacote de implantação, clique em Visualização da implantação para ver como o cliente visualiza sua configuração de VM.
Depois que a validação for concluída, clique em Enviar para enviar o pacote de implantação para revisão. Depois do envio, pode levar até duas semanas para que o Google analise e aprove o pacote.