Cada implantação tem um manifesto correspondente. Um manifesto é uma propriedade somente leitura que descreve todos os recursos na sua implantação e é criado automaticamente a cada nova implantação. Os manifestos não podem ser modificados depois de terem sido criados. Um manifesto não é igual a um arquivo de configuração, embora seja criado com base no arquivo de configuração.
Antes de começar
- Para usar os exemplos de linha de comando deste guia, instale a ferramenta de linha de comando "gcloud".
- Para usar os exemplos de API deste guia, configure o acesso de API.
- Entenda as configurações.
- Entenda os modelos.
- Entenda como criar uma configuração.
Estrutura do manifesto
Um manifesto oferece três visualizações de uma implantação:
- a configuração inicial;
- a configuração totalmente avaliada após a expansão de todos os modelos e importações;
- o layout da implantação, que descreve todos os recursos para a implantação em uma estrutura hierárquica.
Configuração original
A configuração original é a fornecida para a implantação, antes da expansão de qualquer modelo. 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 implantação, inclusive todos os recursos e todas as propriedades do recurso, após processar todos os seus modelos. Este é o estado final da sua configuração.
A parte de configuração expandida do seu 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 seu manifesto exibe o conteúdo dos modelos que você importou para essa configuração. A seção de importações no manifesto é indicada pela seçã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
Layout
O layout é uma descrição da implantação e os recursos e exibe os nomes e tipos de recurso.
Use o layout para visualizar a estrutura da implantação, as propriedades do modelo que foram definidas durante a implantação inicial e outras informações sobre a configuração antes da expansão.
No seu manifesto, é possível ver o layout 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
Identificar um manifesto
Identifique um manifesto pelo ID exclusivo dele, no formato manifest-TIMESTAMP. Exemplo:
manifest-1436393348324
Normalmente, você consegue o ID do manifesto por meio das informações sobre a implantação correspondente ou da listagem de manifestos para uma implantação.
gcloud
Com a Google Cloud CLI, use o subcomando deployments describe:
gcloud deployment-manager deployments describe example-deployment
gcloud retorna uma resposta semelhante a esta:
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 uma solicitação GET, fornecendo o nome da implantação na solicitação:
GET https://www.googleapis.com/deploymentmanager/v2beta1/projects/myproject/global/deployments/example-deployment-with-config
Você receberá uma resposta semelhante a esta:
{
"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"
}Ver um manifesto
É possível visualizar um manifesto fazendo uma solicitação get() para um recurso de manifesto ou por meio do console do Google Cloud ou do gcloud.
Console
Para conferir um manifesto de uma implantação no console do Google Cloud, siga estas etapas:
- Acesse a página Implantações no console do Google Cloud.
- Na lista, clique na implantação que você quer visualizar.
- Nos detalhes da implantação, clique em Visão geral.
gcloud
Com a Google Cloud CLI, use o comando manifests describe para ver o manifesto completo. O comando lista o manifesto completo e o layout:
gcloud deployment-manager manifests describe manifest-1436393348324 \
--deployment example-config-with-templates
gcloud retorna uma resposta semelhante a esta:
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 implantação e o nome do manifesto em uma solicitação GET:
GET https://www.googleapis.com/deploymentmanager/v2beta1/projects/myproject/global/deployments/example-deployment/manifests/manifest-1436393348324
Você receberá uma resposta semelhante a esta:
{
"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"
}