Como atualizar uma implantação

Quando você tiver uma implantação, poderá atualizá-la à medida que o aplicativo evolui. Use o Deployment Manager para atualizar uma implantação:

  • adicionando ou removendo recursos da implantação;
  • atualizando algumas propriedades de recursos atuais na implantação.

O Deployment Manager usa as APIs de base dos serviços do Google Cloud para gerenciar recursos na implantação. O Deployment Manager pode atualizar os recursos atuais se houver um método update ou patch na API correspondente.

Implantar a configuração original

Nesta etapa, implante a configuração que você atualizará mais tarde. Navegue até a pasta no repositório do GitHub e implante a configuração:

cd deploymentmanager-samples/examples/v2/step_by_step_guide/step8_metadata_and_startup_scripts/python

gcloud deployment-manager deployments create deployment-to-update --config config-with-many-templates.yaml

A configuração implanta duas máquinas virtuais (VMs) que executam um script de inicialização. O modelo de VM é:

# Copyright 2016 Google Inc. All rights reserved.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#     http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

"""Creates the virtual machine with environment variables and startup script."""

COMPUTE_URL_BASE = 'https://www.googleapis.com/compute/v1/'

def GenerateConfig(context):
  """Creates the virtual machine."""

  resources = [{
      'name': context.env['name'],
      'type': 'compute.v1.instance',
      'properties': {
          'zone': context.properties['zone'],
          'machineType': ''.join([COMPUTE_URL_BASE, 'projects/',
                                  context.env['project'], '/zones/',
                                  context.properties['zone'], '/machineTypes/',
                                  context.properties['machineType']]),
          'disks': [{
              'deviceName': 'boot',
              'type': 'PERSISTENT',
              'boot': True,
              'autoDelete': True,
              'initializeParams': {
                  'sourceImage': ''.join([COMPUTE_URL_BASE, 'projects/',
                                          'debian-cloud/global/',
                                          'images/family/debian-11'])
              }
          }],
          'networkInterfaces': [{
              'network': '$(ref.' + context.properties['network']
                         + '.selfLink)',
              'accessConfigs': [{
                  'name': 'External NAT',
                  'type': 'ONE_TO_ONE_NAT'
              }]
          }],
          'metadata': {
              'items': [{
                  'key': 'startup-script',
                  'value': ''.join(['#!/bin/bash\n',
                                    'python -m SimpleHTTPServer 80'])
              }]
          }
      }
  }]
  return {'resources': resources}

Abrir o modelo atualizado

Agora, abra o modelo atualizado:

cd deploymentmanager-samples/examples/v2/step_by_step_guide/step9_update_a_deployment/python

nano vm-template.py

No modelo atualizado, na seção metadata, o script de inicialização da VM foi alterado:

# Copyright 2016 Google Inc. All rights reserved.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#     http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

"""Creates the virtual machine with environment variables and startup script."""

COMPUTE_URL_BASE = 'https://www.googleapis.com/compute/v1/'

def GenerateConfig(context):
  """Creates the virtual machine."""

  resources = [{
      'name': context.env['name'],
      'type': 'compute.v1.instance',
      'properties': {
          'zone': context.properties['zone'],
          'machineType': ''.join([COMPUTE_URL_BASE, 'projects/',
                                  context.env['project'], '/zones/',
                                  context.properties['zone'], '/machineTypes/',
                                  context.properties['machineType']]),
          'disks': [{
              'deviceName': 'boot',
              'type': 'PERSISTENT',
              'boot': True,
              'autoDelete': True,
              'initializeParams': {
                  'sourceImage': ''.join([COMPUTE_URL_BASE, 'projects/',
                                          'debian-cloud/global/',
                                          'images/family/debian-11'])
              }
          }],
          'networkInterfaces': [{
              'network': '$(ref.' + context.properties['network']
                         + '.selfLink)',
              'accessConfigs': [{
                  'name': 'External NAT',
                  'type': 'ONE_TO_ONE_NAT'
              }]
          }],
          'metadata': {
              'items': [{
                  'key': 'startup-script',
                  'value': ''.join(['#!/bin/bash\n',
                                    'INSTANCE=$(curl http://metadata.google.',
                                    'internal/computeMetadata/v1/instance/',
                                    'hostname -H "Metadata-Flavor: Google")\n',
                                    '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\n',
                                    'python -m SimpleHTTPServer 80\n'])
              }]
          }
      }
  }]
  return {'resources': resources}

Você usará esse modelo atualizado para alterar a implantação criada anteriormente.

Visualizar a atualização

Para visualizar a implantação atualizada, execute o comando update com uma sinalização --preview:

gcloud deployment-manager deployments update deployment-to-update --config config-with-many-templates.yaml --preview

Confirmar a atualização

Para confirmar a atualização, execute:

gcloud deployment-manager deployments update deployment-to-update

Verificar a atualização

Para verificar se a atualização funcionou, você precisa primeiro reiniciar as instâncias para usar o novo script de inicialização. Restart the-first-vm:

gcloud compute instances reset the-first-vm

A instância pode levar algum tempo para iniciar novamente. Espere alguns minutos antes de verificar a alteração.

Confirmar o novo script de inicialização

  1. Consiga o IP externo de the-first-vm:

    gcloud compute instances describe the-first-vm | grep "natIP"
    
  2. Copie o valor.

  3. Abra um navegador e cole o endereço IP na barra de endereço para visitar sua instância.

    Agora a página deve mostrar uma mensagem de boas-vindas dizendo "Deployment Manager bids you good day!"

Também é possível repetir essas etapas com the-second-vm e ver uma mensagem um pouco diferente.

Excluir a implantação

Assim como nas etapas anteriores, recomendamos que você exclua a implantação para evitar cobranças. Execute o seguinte comando para excluir a implantação:

gcloud deployment-manager deployments delete deployment-to-update

A seguir

Veja algumas áreas a serem exploradas à medida que você usa mais o Deployment Manager: