Como criar uma solução baseada no Deployment Manager

Ao criar soluções do catálogo de serviços para usuários na organização, é possível criar uma solução do Deployment Manager (DM, na sigla em inglês) que os usuários iniciam usando um modelo do Deployment Manager. Depois de criar uma solução, você pode compartilhá-la com os usuários adicionando-a a catálogos.

Antes de começar

  • É necessário ter o papel de Administrador de catálogo (roles/cloudprivatecatalogproducer.admin) ou de Gerenciador de catálogo (roles/cloudprivatecatalogproducer.manager) no projeto do Google Cloud em que o catálogo de serviços está ativado. Se você não tiver nenhum desses papéis, entre em contato com o administrador da organização para solicitar o acesso.

  • Enable the Cloud Deployment Manager and Compute Engine APIs.

    Enable the APIs

Como preparar o modelo de implantação

Para criar uma solução do Deployment Manager no catálogo de serviços, prepare primeiro um arquivo ZIP do modelo do Deployment Manager para upload, que precisa conter os arquivos a seguir:

  • Um arquivo de modelo Jinja que termina com a extensão .jinja ou um arquivo de modelo Python que termina com extensão .py.
  • Um arquivo de esquema termina com extensão .jinja.schema para um modelo Jinja ou a extensão py.schema para um modelo Python.

O nome do arquivo ZIP precisa ser igual aos nomes dos arquivos de esquema, Jinja ou Python. Por exemplo, se o arquivo zip tiver o nome android-dev-environment.zip, o arquivo de esquema Jinja dentro do ZIP precisará ser nomeado como android-dev-environment.jinja.schema, e o modelo Jinja precisa ter o nome android-dev-environment.jinja.

No exemplo de código a seguir, ilustramos um arquivo de esquema para criar um formulário de implantação:



info:
  title: Single Google Compute Engine Machine
  author: Google Inc.
  description: Creates a virtual machine based on zone and machine type selection.

required:
  - machinetype
  - zone

properties:
  machinetype:
    title: Machine type
    type: string
    enum:
      - n1-standard-1
      - n1-standard-2
      - n1-standard-4
      - n1-highmem-2
      - n1-highmem-4
      - n1-highmem-8
      - n1-highcpu-2
      - n1-highcpu-4
      - n1-highcpu-8
      - f1-micro
      - g1-small
  zone:
    title: Zone
    type: string
    enum:
      - us-central1-a
      - us-central1-c
      - us-east1-b
      - us-east1-c
      - us-west1-a
      - us-west1-b
      - us-west1-c

No exemplo de código a seguir, ilustramos um arquivo Jinja para criar uma VM permanente:



# Creates a Persistent VM
resources:
- type: compute.v1.instance
  name: vm-{{ env["deployment"] }}
  properties:
    zone: {{ properties["zone"] }}
    # Note the machineType definition at the end. custom-4-5120 specifies 4 CPUs and 5GB (5120 MB) of RAM
    machineType: https://www.googleapis.com/compute/v1/projects/{{ env["project"] }}/zones/{{ properties["zone"] }}/machineTypes/{{ properties["machinetype"] }}
    disks:
    - deviceName: boot
      type: PERSISTENT
      boot: true
      autoDelete: true
      initializeParams:
        diskName: disk-{{ env["deployment"] }}
        sourceImage: https://www.googleapis.com/compute/v1/projects/debian-cloud/global/images/family/debian-9
    networkInterfaces:
    - network: https://www.googleapis.com/compute/v1/projects/{{ env["project"] }}/global/networks/default
      # Access Config required to give the instance a public IP address
      accessConfigs:
      - name: External NAT
        type: ONE_TO_ONE_NAT

Como criar a solução no catálogo de serviços

Para criar uma solução baseada em um modelo do Deployment Manager:

  1. Acesse a página Soluções de administrador do catálogo de serviços no Console do Cloud.
    Acessar a página "Soluções"

  2. Clique em Selecionar para escolher o projeto do Google Cloud.

  3. Clique em CRIAR SOLUÇÃO. Na lista suspensa, selecione Criar uma solução de DM.

  4. Insira nome, descrição e uma frase para a solução. O slogan é uma breve descrição de uma solução que os usuários veem ao navegar pelo catálogo de serviços.

  5. Faça upload de um arquivo ZIP contendo os arquivos de uma configuração de implantação.

  6. Opcionalmente, faça upload de um ícone para a solução. As dimensões recomendadas para um ícone são 80 por 80 pixels.

  7. Opcionalmente, insira um link de suporte e informações de contato do criador.

  8. Opcionalmente, adicione um link da documentação da solução.

  9. Clique em CRIAR.

A captura de tela a seguir ilustra a criação de uma solução baseada no DM:

Criar uma solução com base em modelos do Cloud Deployment Manager

Próximas etapas

  • Atribua a solução a um catálogo para que os usuários da organização possam acessar e implantar a solução.