Como criar seu pacote de implantação

Nesta seção, descrevemos as etapas para criar pacotes de implantação para sua solução. Os pacotes de implantação são carregados pelo portal do parceiro e são necessários para o envio da sua solução de VM.

Uma implantação é um conjunto de recursos criados e gerenciados em conjunto, como os recursos necessários para sua solução. Um pacote ou modelo de implantação é uma especificação de um conjunto de recursos que costumam ser implantados juntos, o que simplifica o processo de implantação dessa solução específica. O Deployment Manager permite criar modelos e pacotes de implantação para suas soluções de VM usando arquivos de configuração simples YAML, JSON ou ProtoText.

Se sua solução for uma implantação simples de uma única instância de máquina virtual com regras de firewall básicas, configure seu pacote de implantação diretamente no portal do parceiro.

Para a maioria dos casos de uso, recomendamos o uso da ferramenta de código aberto deploymentmanager-autogen do Deployment Manager para gerar pacotes do Deployment Manager. Com o Deployment Manager Autogen, seu pacote de implantação inclui os seguintes recursos:

  • verificações de cota para CPUs e GPUs, para que os usuários não consigam implantar sua solução se excederem os requisitos de cota;
  • atualizações dinâmicas de preços na página do Deployment Manager;
  • compatibilidade com VPCs compartilhadas;
  • compatibilidade com VMs com várias placas de rede;
  • capacidade de impedir que os usuários escolham tipos de máquina, GPUs ou sub-redes não disponíveis na zona escolhida.

Antes de começar

 Caution: Your deployment must not use Terraform, or have any dependencies
 on Terraform.

Para fazer isso, insira o seguinte:

alias autogen='docker run \
  --rm \
  --workdir /mounted \
  --mount type=bind,source="$(pwd)",target=/mounted \
  --user $(id -u):$(id -g) \
  gcr.io/cloud-marketplace-tools/dm/autogen'

autogen --help

Como criar seu arquivo de configuração do Autogen

Recomendamos criar seu arquivo de configuração inicial modificando o exemplo na pasta example-config do repositório Autogen.

Os comentários dentro do arquivo de configuração e dos arquivos proto (autogen.proto, deployment_package_autogen_spec.proto e marketing_info.proto, em inglês) contêm informações sobre os campos pertinentes, incluindo quais são obrigatórios ou opcionais. Se você estiver gerando um pacote de implantação para uma única solução, seu arquivo de configuração deve seguir as especificações do proto DeploymentPackageInput. Se você estiver gerando um pacote de implantação para várias soluções, seu arquivo de configuração deve seguir as especificações do proto BatchInput. Ambas as especificações são encontradas em autogen.proto (em inglês).

Para criar seu arquivo de configuração, altere cada um dos campos do arquivo de configuração de exemplo para refletir a configuração da sua solução e, em seguida, execute o Autogen no arquivo de configuração editado.

Outras configurações de exemplo também estão disponíveis na pasta testdata (em inglês).

Como gerar seu pacote de implantação

Veja, a seguir, um exemplo de comando que lê as especificações em example-config/solution.yaml e gera um pacote em uma pasta denominada solution-folder:

mkdir solution_folder

autogen \
  --input_type YAML \
  --single_input example-config/solution.yaml \
  --output_type PACKAGE \
  --output solution_folder

Para executar o Autogen pela linha de comando, você precisa incluir um dos dois parâmetros a seguir:

  • --single_input, se você estiver gerando um pacote para uma solução;
  • --batch_input, se você estiver gerando pacotes para várias soluções.

Use parâmetros opcionais, como --input_type e --output_type, para especificar quais formatos o Autogen lê ou grava. Para informações sobre todas as opções possíveis, consulte a documentação do Autogen (em inglês).

Após a criação do pacote de implantação, compacte a pasta solution_folder e faça upload do arquivo compactado para o portal do parceiro.

Como criar pacotes simples do Deployment Manager no portal do parceiro

As soluções que são implantações simples de instâncias de máquina virtual única com regras de firewall básicas podem ter seus pacotes de implantação configurados diretamente no portal do parceiro.

Para configurá-los, abra o portal do parceiro, selecione sua solução na lista de soluções e siga estas etapas:

  1. Ao lado de Pacote de implantação, clique em Editar.
  2. Selecione a opção para Gerar um pacote e clique em Continuar.
  3. Selecione sua imagem de VM usando os menus suspensos Projeto e Imagem e clique em Continuar.
  4. Selecione suas configurações de Tipo de máquina mínimo e Tipo de máquina padrão e clique em Continuar.
  5. Adicione as próximas etapas de pós-implantação que seus clientes devem seguir e clique em Continuar.
  6. Configure suas Regras de firewall e outras opções de rede, se for o caso, e clique em Continuar.
  7. É possível declarar um site ou URL de administrador. Se sua solução exigir login, configure os detalhes de login ao enviar sua solução. Clique em Continuar.
  8. Em Listar o conteúdo do pacote, selecione o Nome do sistema operacional e a Versão do SO referentes ao sistema operacional da imagem de VM. É possível adicionar um Nome e uma Versão para cada software extra incluído como parte da sua solução. Depois de listar todo o conteúdo do seu pacote, clique em Continuar.
  9. Depois de concluir as etapas anteriores, o pacote da solução é mostrado em Revisar. É possível fazer o download do pacote da solução ou clicar em Editar JSON para modificá-lo manualmente. Clique em Salvar para salvar o pacote e retornar à sua solução.

Para implantações mais complexas, é possível criar uma implantação do zero. Se você não tiver certeza sobre qual tipo de solução é melhor para seu projeto, fale com seu engenheiro de parceiros do Google.

Pacotes de implantação na visão do cliente

Nas seções a seguir, mostramos os layouts de tela que seus clientes veem quando implantam sua solução, no caso de soluções baseadas em modelos de solução padrão gerados automaticamente.

Visão do cliente sobre a implantação de um pacote

Os elementos de entrada padrão do cliente são mostrados no lado esquerdo da captura de tela a seguir e incluem a zona, o tipo de máquina, as opções de disco e as opções de rede.

Se a implantação de um cliente exigir várias placas de rede, ele poderá adicionar outras interfaces de rede clicando em Adicionar interface de rede.

Para implantar sua solução, seus clientes precisam preencher os campos de entrada e clicar em Implantar.

Visão do cliente sobre um pacote implantado

Na imagem a seguir, veja como seus clientes verão sua solução após a implantação bem-sucedida.

Os elementos de saída padrão são mostrados no lado direito da captura de tela a seguir. Eles incluem o endereço do site, a senha temporária do administrador e informações sobre a instância.