Visualizar um manifesto

Cada implementação tem um manifesto correspondente. Um manifesto é uma propriedade só de leitura que descreve todos os recursos na sua implementação e é criado automaticamente com cada nova implementação. Não é possível modificar os manifestos depois de criados. Um manifesto não é o mesmo que um ficheiro de configuração, mas é criado com base no ficheiro de configuração.

Antes de começar

Estrutura do manifesto

Um manifesto oferece três vistas de uma implementação:

  • A configuração inicial
  • A configuração totalmente avaliada após a expansão de todos os modelos e importações
  • O esquema da implementação, que descreve todos os recursos da implementação numa estrutura hierárquica.

Configuração original

A configuração original é a configuração que forneceu à implementação antes de qualquer expansão de modelos. A configuração inicial é indicada pela propriedade config:

config: |
  imports:
  - path: vm-template.jinja
  - path: network-template.jinja
  - path: firewall-template.jinja
  - path: compute-engine-template.jinja

  resources:
  - name: compute-engine-setup
    type: compute-engine-template.jinja

Configuração expandida

A configuração expandida é uma descrição completa da sua implementação, incluindo todos os recursos e respetivas propriedades, após o processamento de todos os seus modelos. Este é o estado final da sua configuração.

A parte da configuração expandida do manifesto é indicada pela propriedade expandedConfig:

expandedConfig: |
  resources:
  - name: datadisk-example-config-with-templates
    properties:
      sizeGb: 100
      type: https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/diskTypes/pd-standard
      zone: us-central1-a
    type: compute.v1.disk
  - name: vm-example-config-with-templates
    properties:
      disks:
      - autoDelete: true
        boot: true
        deviceName: boot
        initializeParams:
          diskName: disk-example-config-with-templates
          sourceImage: https://www.googleapis.com/compute/v1/projects/debian-cloud/global/images/debian-7-wheezy-v20140619
        type: PERSISTENT
      - autoDelete: true
        deviceName: datadisk-example-config-with-templates
        source: $(ref.datadisk-example-config-with-templates.selfLink)
        type: PERSISTENT
      machineType: https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/machineTypes/f1-micro
      metadata:
        items:
        - key: startup-script
          value: |
            #!/bin/bash
            python -m http.server 8080
      networkInterfaces:
      - accessConfigs:
        - name: External NAT
          type: ONE_TO_ONE_NAT
        network: https://www.googleapis.com/compute/v1/projects/myproject/global/networks/default
      zone: us-central1-a
    type: compute.v1.instance

Modelos importados

A propriedade imports no manifesto mostra o conteúdo de todos os modelos que importou para esta configuração. A secção de importações do manifesto é indicada pela secção imports:

imports:
- content: |
    resources:
    - name: {{ env["name"] }}
      type: compute.v1.instance
      properties:
        disks:
        - autoDelete: true
          type: PERSISTENT
          boot: true
          deviceName: boot
          initializeParams:
            sourceImage:  https://www.googleapis.com/compute/v1/projects/debian-cloud/global/images/debian-7-wheezy-v20140619
        machineType: https://www.googleapis.com/compute/v1/projects/{{ env["project"] }}/zones/{{ properties["zone"] }}/machineTypes/{{ properties["machineType"] }}
        networkInterfaces:
        - network: $(ref.{{ properties["network"] }}.selfLink)
          accessConfigs:
          - name: External NAT
            type: ONE_TO_ONE_NAT
        zone: {{ properties["zone"] }}
        metadata:
          items:
          - key: startup-script
            value: |
              #!/bin/bash
              INSTANCE=$(curl http://metadata.google.internal/computeMetadata/v1/instance/hostname -H "Metadata-Flavor: Google")
              echo "<html><header><title>Hello from Deployment Manager!</title></header>
              <body><h2>Hello from $INSTANCE</h2>
              <p>Deployment Manager bids you good day!</p>
              </body>
              </html>" > index.html
              python -m http.server 80
  name: vm-template.jinja
- content: |
    resources:
    - name: {{ env["name"] }}
      type: compute.v1.network
      properties:
        IPv4Range: 10.0.0.1/16
  name: network-template.jinja
- content: |
    resources:
    - name: {{ env["name"]}}
      type: compute.v1.firewall
      properties:
        network: $(ref.{{ properties["network"] }}.selfLink)
        sourceRanges: ["0.0.0.0/0"]
        allowed:
        - IPProtocol: TCP
          ports: ["80"]
  name: firewall-template.jinja
- content: |
    {% set  NETWORK_NAME = "a-new-network" %}

    resources:
    - name: the-first-vm
      type: vm-template.jinja
      properties:
        machineType: f1-micro
        zone: us-central1-f
        network: {{ NETWORK_NAME }}
    - name: the-second-vm
      type: vm-template.jinja
      properties:
        machineType: g1-small
        zone: us-central1-f
        network: {{ NETWORK_NAME }}
    - name: {{ NETWORK_NAME }}
      type: network-template.jinja
    - name: {{ NETWORK_NAME }}-firewall
      type: firewall-template.jinja
      properties:
        network: {{ NETWORK_NAME }}
  name: compute-engine-template.jinja

Esquema

O esquema é um resumo da sua implementação e dos respetivos recursos, e mostra os nomes e os tipos de recursos.

Use o esquema para visualizar a estrutura da sua implementação, ver as propriedades do modelo que foram definidas durante a implementação inicial e outras informações sobre a sua configuração antes de ser expandida.

No manifesto, pode ver o esquema na propriedade layout:

layout: |
  resources:
  - name: compute-engine-setup
    resources:
    - name: the-first-vm
      properties:
        machineType: f1-micro
        network: a-new-network
        zone: us-central1-f
      resources:
      - name: the-first-vm
        type: compute.v1.instance
      type: vm-template.jinja
    - name: the-second-vm
      properties:
        machineType: g1-small
        network: a-new-network
        zone: us-central1-f
      resources:
      - name: the-second-vm
        type: compute.v1.instance
      type: vm-template.jinja
    - name: a-new-network
      resources:
      - name: a-new-network
        type: compute.v1.network
      type: network-template.jinja
    - name: a-new-network-firewall
      properties:
        network: a-new-network
      resources:
      - name: a-new-network-firewall
        type: compute.v1.firewall
      type: firewall-template.jinja
    type: compute-engine-template.jinja

Identifique um manifesto

Pode identificar um manifesto pelo respetivo ID único, no formato manifest-TIMESTAMP. Por exemplo:

manifest-1436393348324

Normalmente, pode obter o ID do manifesto através de informações sobre a implementação correspondente ou listando os manifestos de uma implementação.

gcloud

Com a Google Cloud CLI, use o subcomando deployments describe:

gcloud deployment-manager deployments describe example-deployment

gcloud devolve uma resposta semelhante à seguinte:

id: '7428522736135856060'
manifest: https://www.googleapis.com/deploymentmanager/v2beta1/projects/myproject/global/deployments/example-deployment/manifests/manifest-1436393348324
name: example-deployment
resources:
NAME    TYPE      ID     STATE   ERRORS
...

API

Na API, faça um pedido GET, indicando o nome da implementação no pedido:

GET https://www.googleapis.com/deploymentmanager/v2beta1/projects/myproject/global/deployments/example-deployment-with-config

Deve receber uma resposta semelhante à seguinte:

{
 "id": "5899501332770090517",
 "creationTimestamp": "2015-03-30T15:40:58.809-07:00",
 "name": "example-deployment-with-config",
 "fingerprint": "",
 "manifest": "https://www.googleapis.com/deploymentmanager/v2/projects/myproject/global/deployments/example-deployment-with-config/manifests/manifest-1427755258810-2b3498d9-530b-4f8e-b014-0342d3c9c66b",
 "state": "DEPLOYED"
}

Veja um manifesto

Pode ver um manifesto fazendo um pedido get() a um recurso de manifesto ou através do Google Cloud console ou gcloud.

Consola

Para ver um manifesto de uma implementação no Google Cloud console:

  1. Aceda à página Implementações na Google Cloud consola.
  2. Na lista, clique na implementação que quer ver.
  3. Nos detalhes da implementação, clique em Vista geral.

gcloud

Com a CLI do Google Cloud, veja o manifesto completo através do comando manifests describe. O comando apresenta o manifesto completo e o esquema:

gcloud deployment-manager manifests describe manifest-1436393348324 \
    --deployment example-config-with-templates

gcloud devolve uma resposta semelhante à seguinte:

 config: |
   imports: ["vm_template.jinja"]



resources:



    

  • name: vm-instance
 type: vm_template.jinja
 properties:
   zone: us-central1-a
   project: myproject
creationTimestamp: '2015-03-30T15:40:58.815-07:00'
evaluatedConfig: |
resources:
    • 

  • name: datadisk-example-config-with-templates
 properties:
   sizeGb: 100
   type: https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/diskTypes/pd-standard
   zone: us-central1-a
 type: compute.v1.disk
    • 

  • name: vm-example-config-with-templates
 properties:
   disks:

      

    • autoDelete: true
 boot: true
 deviceName: boot
 initializeParams:
   diskName: disk-example-config-with-templates
   sourceImage: https://www.googleapis.com/compute/v1/projects/debian-cloud/global/images/debian-7-wheezy-v20140619
 type: PERSISTENT
      • 

    • autoDelete: true
 deviceName: datadisk-example-config-with-templates
 source: $(ref.datadisk-example-config-with-templates.selfLink)
 type: PERSISTENT
machineType: https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/machineTypes/f1-micro
metadata:
 items:

        

      • key: startup-script
value: |
 #!/bin/bash
 python -m http.server 8080
networkInterfaces:
        • 

      • 

    • accessConfigs:

        

      • name: External NAT
type: ONE_TO_ONE_NAT
network: https://www.googleapis.com/compute/v1/projects/myproject/global/networks/default
zone: us-central1-a
type: compute.v1.instance
id: '7174699452487462421'
layout: |
resources:
        • 

      • 

    • 

  • name: vm-instance
 type: vm_template.jinja
 properties:
   project: myproject
   zone: us-central1-a
 resources:

      

    • name: datadisk-example-config-with-templates
type: compute.v1.disk
      • 

    • name: vm-example-config-with-templates
type: compute.v1.instance
name: manifest-1427755258810-2b3498d9-530b-4f8e-b014-0342d3c9c66b
selfLink: https://www.googleapis.com/deploymentmanager/v2/projects/myproject/global/deployments/example-config-with-templates/manifests/manifest-1436393348324

API

Na API, forneça o nome da implementação e o nome do manifesto num GETpedido:

 GET https://www.googleapis.com/deploymentmanager/v2beta1/projects/myproject/global/deployments/example-deployment/manifests/manifest-1436393348324

Deve receber uma resposta semelhante à seguinte:

{
 "id": "7174699452487462421",
 "selfLink": "https://www.googleapis.com/deploymentmanager/v2/projects/myproject/global/deployments/example-config-with-templates/manifests/manifest-1436393348324",
 "creationTimestamp": "2015-03-30T15:40:58.815-07:00",
 "name": "manifest-1427755258810-2b3498d9-530b-4f8e-b014-0342d3c9c66b",
 "config": "imports: [\"vm_template.jinja\"]\n\nresources:\n- name: vm-instance\n  type: vm_template.jinja\n  properties:\n    zone: us-central1-a\n    project: myproject\n",
 "evaluatedConfig": "resources:\n- name: datadisk-example-config-with-templates\n  properties:\n    sizeGb: 100\n    type: https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/diskTypes/pd-standard\n    zone: us-central1-a\n  type: compute.v1.disk\n- name: vm-example-config-with-templates\n  properties:\n    disks:\n    - autoDelete: true\n      boot: true\n      deviceName: boot\n      initializeParams:\n        diskName: disk-example-config-with-templates\n        sourceImage: https://www.googleapis.com/compute/v1/projects/debian-cloud/global/images/debian-7-wheezy-v20140619\n      type: PERSISTENT\n    - autoDelete: true\n      deviceName: datadisk-example-config-with-templates\n      source: $(ref.datadisk-example-config-with-templates.selfLink)\n      type: PERSISTENT\n    machineType: https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/machineTypes/f1-micro\n    metadata:\n      items:\n      - key: startup-script\n        value: |\n          #!/bin/bash\n          python -m http.server 8080\n    networkInterfaces:\n    - accessConfigs:\n      - name: External NAT\n        type: ONE_TO_ONE_NAT\n      network: https://www.googleapis.com/compute/v1/projects/myproject/global/networks/default\n    zone: us-central1-a\n  type: compute.v1.instance\n",
 "layout": "resources:\n- name: vm-instance\n  properties:\n    project: myproject\n    zone: us-central1-a\n  resources:\n  - name: datadisk-example-config-with-templates\n    type: compute.v1.disk\n  - name: vm-example-config-with-templates\n    type: compute.v1.instance\n  type: vm_template.jinja\n"
}