Como configurar discos permanentes com estado em MIGs

Console

1. No Console do Google Cloud, acesse a página Grupos de instâncias.

   Acesse grupo de instâncias

2. Selecione o projeto e clique em Continuar.

3. Clique em Criar grupo de instâncias.

4. Selecione Novo grupo gerenciado de instâncias (com estado).

5. Especifique um Nome para o grupo de instâncias.

6. Selecione um modelo de instância. Se nenhum modelo estiver disponível, crie um modelo de instância.

7. Em Número de instâncias, especifique o número de instâncias do grupo.

8. A seção Configuração com estado exibe os discos especificados no modelo da instância. Clique em um disco para editar a configuração com estado dele.

   1. Em Com estado, selecione Sim.

   2. Na lista suspensa Na exclusão permanente da instância, selecione a ação que será executada no disco com estado quando a instância de VM for excluída. As opções disponíveis são estas:

      • Remover disco: (padrão). Nunca exclua o disco. Remova-o quando a VM dele for excluída.
      • Exclua o disco: exclua o disco com estado quando a respectiva VM for excluída permanentemente do grupo de instâncias. Por exemplo, quando a instância gerenciada for excluída manualmente ou quando o tamanho do grupo for reduzido.

   3. Depois de concluir a configuração com estado, clique em Concluído.

9. Clique em Criar.

gcloud

Para especificar os discos de um modelo de instância que precisam ser "com estado" na criação do MIG, use a sinalização --stateful-disk com o comando gcloud compute instance-groups managed create:

gcloud compute instance-groups managed create INSTANCE_GROUP_NAME \
    --template INSTANCE_TEMPLATE \
    --size SIZE \
    --stateful-disk device-name=DEVICE_NAME[,auto-delete=DELETE_RULE]

Substitua:

• INSTANCE_GROUP_NAME: o nome do grupo de instâncias gerenciadas que será criado;
• INSTANCE_TEMPLATE: o nome do modelo de instância que será usado ao criar instâncias;
• SIZE: o número inicial de VMs que você precisa nesse grupo;
• DEVICE_NAME: o nome de dispositivo de um disco especificado no modelo de instância;

• DELETE_RULE: um valor que determina o que precisa acontecer em um disco com estado quando uma VM é excluída. As opções disponíveis são estas:

  • never: padrão. Nunca exclua o disco. Em vez disso, remova-o quando a VM dele for excluída.
  • on-permanent-instance-deletion: exclua o disco quando a respectiva instância de VM for excluída permanentemente do grupo. Por exemplo, quando a instância gerenciada for excluída manualmente ou quando o tamanho do grupo for reduzido.

  Seja qual for o valor da regra de exclusão, os discos com estado sempre serão preservados nas operações de recuperação automática, atualização e recriação da VM.

Exemplo

Para implantar um banco de dados com 12 fragmentos, cada um com um disco de inicialização sem estado, que contém os binários do sistema operacional e do banco de dados, e cada uma com um disco de dados com estado. siga estas etapas:

1. Crie um modelo de instância com um disco de inicialização sem estado com base na imagem img-example-db-v01, que tem um SO e um banco de dados pré-instalados, e com um disco de dados com estado:

   gcloud compute instance-templates create example-database-template-v01 \
       --image img-example-db-v01 \
       --create-disk device-name=data-disk,mode=rw,image=empty10GBext4
   

   A sinalização --create-disk instrui o MIG a:

   1. criar um novo disco de 10 GB para cada instância de VM com base em uma imagem ext4 vazia, preparada previamente;
   2. anexar o disco à respectiva VM no modo de leitura/gravação usando o nome de dispositivo data-disk;

2. criar um MIG com base no modelo de instância e definir o disco de dados como sendo "com estado":

   gcloud compute instance-groups managed create example-database-group \
     --template example-database-template-v01 \
     --base-instance-name shard \
     --size 12 \
     --stateful-disk device-name=data-disk,auto-delete=on-permanent-instance-deletion
   

   O nome de dispositivo data-disk é retirado do modelo de instância. O disco de dados é configurado para ser excluído com a instância de VM quando ela é excluída permanentemente, seja por exclusão manual da instância ou por redução manual do tamanho do grupo. O disco de dados é preservado na recuperação automática, nas atualizações e na recriação de VMs.

3. Verifique se o disco de dados está configurado na política com estado:

   gcloud compute instance-groups managed describe example-database-group
   
   
   baseInstanceName: shard
   ...
   name: example-database-group
   ...
   statefulPolicy:
     preservedState:
       disks:
         data-disk:
           autoDelete: ON_PERMANENT_INSTANCE_DELETION
   ...
   

   Veja que a política com estado declara os discos com o nome de dispositivo data-disk como sendo "com estado", com uma regra para excluir esses discos na exclusão permanente da VM.

REST

Para especificar os discos do modelo de instância que precisam ser "com estado" na criação do MIG, inclua-os no campo statefulPolicy no corpo da solicitação do método instanceGroupManagers.insert:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT/zones/ZONE/instanceGroupManagers

{
  "name": "NAME",
  "versions": [
    {
      "instanceTemplate": "global/instanceTemplates/TEMPLATE"
    }
  ],
  "targetSize": SIZE,
  "statefulPolicy": {
    "preservedState": {
      "disks": {
        "DEVICE_NAME": {"autoDelete": "DELETE_RULE" },
        "DEVICE_NAME": {"autoDelete": "DELETE_RULE" }
      }
    }
  }
}

Substitua:

• PROJECT: o ID do projeto para a solicitação.
• ZONE: a zona onde o MIG está localizado, aplicável a um MIG zonal.
  • zones/ZONE por regions/REGION e especifique a região do MIG se ele for regional;
• NAME: o nome do MIG que será criado;
• TEMPLATE: o nome do modelo de instância que será usado ao criar instâncias;
• SIZE: o número inicial de instâncias necessárias nesse grupo;
• DEVICE_NAME: o nome de dispositivo de um disco especificado no modelo de instância;

• DELETE_RULE: um valor que determina o que precisa acontecer no disco com estado quando a instância de VM é excluída. As opções disponíveis são estas:

  • never: padrão. Nunca exclua o disco. Remova-o quando a VM dele for excluída.
  • on_permanent_instance_deletion: exclua o disco com estado quando a respectiva VM for excluída permanentemente do grupo de instâncias. Por exemplo, quando a instância gerenciada for excluída manualmente ou quando o tamanho do grupo for reduzido.

Exemplo

Para implantar um banco de dados com 12 fragmentos, cada um com um disco de inicialização sem estado, que contém os binários do sistema operacional e do banco de dados, e cada uma com um disco de dados com estado. siga estas etapas:

1. Crie um modelo de instância com um disco de inicialização sem estado com base na imagem img-example-db-v01, que tem o SO e o banco de dados pré-instalados, e com um disco de dados com estado usando o método instanceTemplates.insert:

   POST https://compute.googleapis.com/compute/v1/projects/example-project/global/instanceTemplates
   
   {
     "name": "example-database-template-v01",
     "properties": {
       "machineType":"e2-standard-2",
       "disks": [
         {
           "boot": true,
           "deviceName": "boot-disk",
           "initializeParams": {
             "sourceImage": "projects/example-project/global/images/mg-example-db-v01"
           }
         },
         {
           "deviceName": "data-disk",
           "mode": "READ_WRITE",
           "initializeParams": {
             "sourceImage": "projects/example-project/global/images/empty10GBext4"
           }
         }
       ],
       "networkInterfaces": [
         {
           "network": "global/networks/default"
         }
       ]
     }
   }
   

   O disco de dados no modelo de instância tem o nome de dispositivo data-disk e está configurado para ser criado com base em uma imagem ext4 vazia, preparada previamente, e para ser anexado no modo de leitura/gravação.

2. Crie um MIG com base no modelo de instância e defina o disco de dados como sendo "com estado" usando o método instanceGroupManagers.insert:

   POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-east1-c/instanceGroupManagers
   
   {
     "name": "example-database-group",
     "baseInstanceName": "shard",
     "versions": [
       {
         "instanceTemplate": "global/instanceTemplates/example-database-template-v01"
       }
     ],
     "targetSize": 12,
     "statefulPolicy": {
       "preservedState": {
         "disks": {
           "data-disk": {"autoDelete": "ON_PERMANENT_INSTANCE_DELETION" }
         }
       }
     }
   }
   

   O MIG cria 12 instâncias, cada uma com um disco que tem as propriedades a seguir:

   • O nome de dispositivo data-disk retirado do modelo de instância.
   • Uma regra de exclusão para excluir o disco de dados quando a VM é excluída, seja por exclusão manual da instância ou por redução manual do tamanho do grupo.
   • Uma entrada no estado preservado da política (preservedStateFromPolicy) de cada instância gerenciada para que o disco de dados seja preservado na recuperação automática, nas atualizações e na recriação de instâncias.

3. Use o método instanceGroupManagers.get para verificar se o disco de dados está configurado na política com estado do novo recurso instanceGroupManagers:

   GET https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-east1-c/instanceGroupManagers/example-database-group
   

   
   {
     "name": "example-database-group",
     "baseInstanceName": "shard",
     ...
     "statefulPolicy": {
       "preservedState": {
         "disks": {
           "data-disk": {"autoDelete": "ON_PERMANENT_INSTANCE_DELETION" }
         }
       }
     }
     ...
   }
   

   é possível ver que a política com estado declara os discos com o nome de dispositivo data-disk como sendo "com estado" com a regra para excluir esses discos na exclusão permanente da instância.

Console

1. No Console do Google Cloud, acesse a página Grupos de instâncias.

   Acesse grupo de instâncias

2. Clique no nome do grupo de instâncias em que você quer especificar a configuração com estado do disco.

3. Clique em Editar para modificar o grupo gerenciado de instâncias.

4. Em Configuração com estado, expanda o disco que você quer tornar com estado.

   1. Em Com estado, selecione Sim.

   2. Na lista suspensa Na exclusão permanente da instância, selecione a ação que será executada no disco com estado quando a instância de VM for excluída.

      • Remover disco: (padrão). Nunca exclua o disco. Remova-o quando a VM dele for excluída.

      • Exclua o disco: exclua o disco com estado quando a respectiva VM for excluída permanentemente do grupo de instâncias. Por exemplo, quando a instância gerenciada for excluída manualmente ou quando o tamanho do grupo for reduzido.

   3. Depois de atualizar a configuração com estado, clique em Concluído.

5. Clique em Salvar para concluir a atualização.

gcloud

Para especificar os discos do modelo de instância que precisam ser "com estado" ou para atualizar a configuração do disco com estado de um MIG, use uma ou várias sinalizações --stateful-disk com o comando gcloud compute instance-groups managed update:

gcloud compute instance-groups managed update NAME \
  --stateful-disk device-name=DEVICE_NAME[,auto-delete=DELETE_RULE]

Substitua:

• NAME: o nome do grupo de instâncias gerenciadas que será atualizado;
• DEVICE_NAME: o nome de dispositivo de um disco especificado no modelo de instância;

• DELETE_RULE: um valor que determina o que precisa acontecer no disco com estado quando uma instância de VM é excluída. As opções disponíveis são estas:

  • never: padrão. Nunca exclua o disco. Remova-o quando a VM dele for excluída.
  • on-permanent-instance-deletion: exclua o disco com estado quando a instância for excluída permanentemente do grupo. Por exemplo, quando a instância gerenciada for excluída manualmente ou quando o tamanho do grupo for reduzido.

Se um nome de dispositivo especificado já estiver configurado na política com estado, o comando atualizará a configuração.

Exemplo

Você executa um banco de dados com vários fragmentos em um MIG chamado example-database- group. Cada VM no MIG armazena um fragmento em um disco extra com o nome de dispositivo data-disk, que é definido pelo modelo de instância. O MIG não tem configuração com estado, e você quer preservar os discos de dados na recriação, na recuperação automática e nas atualizações de instância. Você também quer proteger os discos de dados contra exclusão quando uma VM é excluída.

1. Atualize o MIG para definir o disco de dados como sendo "com estado" executando o comando a seguir:

   gcloud compute instance-groups managed update example-database-group \
     --stateful-disk device-name=data-disk,auto-delete=never
   

   Como resultado, o MIG aplica as atualizações de configuração da política com estado aos discos de dados de todas as instâncias de maneira automática e assíncrona. Os discos de dados agora são preservados na recuperação automática, nas atualizações e na recriação de instâncias. Além disso, eles são removidos na exclusão da instância porque a regra auto-delete está definida como never.

2. Verifique se o disco de dados está configurado na política com estado executando o comando gcloud compute instance-groups managed describe example-database-group.

REST

Para especificar os discos do modelo de instância que precisam ser "com estado" ou para atualizar a configuração do disco com estado de um MIG atual, configure os discos na política com estado do MIG usando o método instanceGroupManagers.patch:

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT/zones/ZONE/instanceGroupManagers/NAME

{
  "statefulPolicy": {
    "preservedState": {
      "disks": {
        "DEVICE_NAME": {"autoDelete": "DELETE_RULE" },
        "DEVICE_NAME": {"autoDelete": "DELETE_RULE" }
      }
    }
  }
}

Substitua:

• PROJECT: o ID do projeto para a solicitação.
• ZONE: a zona onde o MIG está localizado, aplicável a um MIG zonal.
  • zones/ZONE por regions/REGION e especifique a região do MIG se ele for regional;
• NAME: o nome do MIG que será atualizado;
• DEVICE_NAME: o nome de dispositivo de um disco, especificado no modelo de instância, em que você quer atualizar a configuração com estado;

• DELETE_RULE: um valor que determina o que precisa acontecer no disco com estado quando uma instância de VM é excluída. As opções disponíveis são estas:

  • never: padrão. Nunca exclua o disco. Remova-o quando a VM dele for excluída.
  • on-permanent-instance-deletion: exclua o disco com estado quando a instância for excluída permanentemente do grupo de instâncias. Por exemplo, quando a instância for excluída manualmente ou quando o tamanho do grupo for reduzido.

Se o nome de dispositivo especificado já estiver configurado na política com estado, o método patch atualizará a configuração.

Exemplo

Você executa um banco de dados com vários fragmentos em um MIG chamado example-database- group. Cada VM no MIG armazena um fragmento em um disco extra com o nome de dispositivo data-disk, que é definido pelo modelo de instância. O MIG não tem configuração com estado, e você quer preservar os discos de dados na recriação, na recuperação automática e nas atualizações de instância. Você também quer proteger os discos de dados contra exclusão quando uma VM é excluída.

1. Corrija o MIG para definir o disco de dados como sendo "com estado":

   PATCH https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-east1-c/instanceGroupManagers/example-database-group
   
   {
     "statefulPolicy": {
       "preservedState": {
         "disks": {
           "data-disk": {"autoDelete": "NEVER" }
         }
       }
     }
   }
   

   O MIG aplica essa configuração com estado aos discos de dados de todas as instâncias de maneira automática e assíncrona. Os discos de dados serão preservados na recuperação automática, nas atualizações e na recriação de instâncias. Os discos de dados serão removidos na exclusão da instância porque a regra autoDelete está definida como NEVER.

2. Veja o recurso instanceGroupManagers retornado pelo método instanceGroupManagers.get para verificar se o disco de dados está configurado na política com estado.

Console

1. No Console do Google Cloud, acesse a página Grupos de instâncias.

   Acesse grupo de instâncias

2. Clique no nome do grupo de instâncias do qual você quer remover a configuração com estado dos discos.

3. Clique em Editar para modificar o grupo gerenciado de instâncias.

4. Em Configuração com estado, expanda os discos com estado que você quer tornar sem estado.

   1. Altere a opção Com estado para Não.
   2. Clique em Concluído.

5. Depois de fazer as alterações, clique em Salvar.

gcloud

Para especificar os discos de uma política com estado do MIG que precisam ser "sem estado", use a sinalização --remove-stateful-disks com o comando gcloud compute instance-groups managed update:

gcloud compute instance-groups managed update NAME \
  --remove-stateful-disks DEVICE_NAME[,DEVICE_NAME,...]

Substitua:

• NAME: o nome do MIG que será atualizado;
• DEVICE_NAME: o nome de dispositivo de um disco que será removido da política com estado e será tratado como "sem estado". É possível inserir um ou vários nomes de dispositivo na lista.

Exemplo

Você executa um aplicativo legado com vários nós em um MIG chamado example-legacy-group. Cada VM no MIG armazena os dados do aplicativo em um disco de inicialização com o nome de dispositivo boot-disk, que você configurou como "com estado" na política com estado do MIG. Você moveu os dados do aplicativo para um disco extra e agora quer tornar o disco de inicialização sem estado a fim de facilitar a atualização para as novas imagens.

Para remover a configuração com estado do disco de inicialização, atualize o grupo de instâncias gerenciadas:

gcloud compute instance-groups managed update example-legacy-group \
  --remove-stateful-disks boot-disk

O MIG remove a configuração com estado do nome de dispositivo boot-disk de maneira automática e assíncrona dos discos de inicialização de todas as instâncias no grupo. Os discos de inicialização permanecem anexados às instâncias, mas não são mais "com estado". Quando você recria ou atualiza as instâncias ou quando as instâncias são recuperadas automaticamente, o MIG recria os discos de inicialização com base na imagem especificada no modelo de instância.

REST

Para especificar os discos de uma política com estado do MIG que se tornarão sem estado, remova a configuração de cada disco da política com estado do MIG usando o método instanceGroupManagers.patch:

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT/zones/ZONE/instanceGroupManagers/NAME

{
  "statefulPolicy": {
    "preservedState": {
      "disks": {
        "DEVICE_NAME": null,
        ...
      }
    }
  }
}

Substitua:

• PROJECT: o ID do projeto para a solicitação.
• ZONE: a zona onde o MIG está localizado, aplicável a um MIG zonal.
  • zones/ZONE por regions/REGION e especifique a região do MIG se ele for regional;
• NAME: o nome do MIG que será atualizado;
• DEVICE_NAME: o nome de dispositivo de um disco que você quer remover da política com estado. Um valor null faz com que a configuração com estado desse disco seja removida. É possível inserir um ou vários nomes de dispositivo para remoção.

Exemplo

Você executa um aplicativo legado com vários nós em um MIG chamado example-legacy-group. Cada VM no MIG armazena os dados do aplicativo em um disco de inicialização com o nome de dispositivo boot-disk, que você configurou como sendo "com estado" na política com estado do MIG. Você moveu os dados do aplicativo para um disco extra e agora quer tornar o disco de inicialização sem estado a fim de facilitar a atualização para as novas imagens.

Para remover a configuração com estado do disco de inicialização, corrija o grupo de instâncias gerenciadas:

PATCH https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-east1-c/instanceGroupManagers/example-legacy-group

{
  "statefulPolicy": {
    "preservedState": {
      "disks": {
        "boot-disk": null
      }
    }
  }
}

O MIG remove a configuração com estado do nome de dispositivo boot-disk de maneira automática e assíncrona dos discos de inicialização de todas as instâncias no grupo. Os discos de inicialização permanecem anexados às instâncias, mas não são mais "com estado". Quando você recria ou atualiza as instâncias ou quando as instâncias são recuperadas automaticamente, o MIG recria os discos de inicialização com base na imagem especificada no modelo de instância.

gcloud

Para criar uma VM com um nome personalizado e anexar um ou mais discos com estado atuais a ela, use o comando gcloud compute instance-groups managed create-instance com uma ou várias sinalizações --stateful-disk.

gcloud compute instance-groups managed create-instance NAME \
  --instance VM_NAME \
  [--zone ZONE | --region REGION] \
  --stateful-disk device-name=DEVICE_NAME,source=DISK[,mode=MODE][,auto-delete=DELETE_RULE]

Substitua:

• NAME: o nome do MIG em que você precisa criar uma instância;
• VM_NAME: o nome da nova instância que será criada;
• ZONE: a zona em que o MIG está localizado, aplicável a um MIG zonal;
• REGION: a região em que o MIG está localizado, aplicável a um MIG regional;
• DEVICE_NAME: o nome de dispositivo que será usado ao anexar o disco;
• DISK: o URI de um disco permanente que será anexado ao DEVICE_NAME especificado no formato projects/project-id/zones/zone/disks/disk-name para um disco por zona e projects/project-id/regions/region/disks/disk-name para um disco regional;
• MODE: especifica o modo do disco. As opções aceitas são estas:
  • ro: somente leitura.
  • rw: padrão. Leitura/gravação

• DELETE_RULE: um valor que determina o que precisa acontecer em um disco com estado quando uma instância de VM é excluída. As opções disponíveis são estas:

  • never: padrão. Nunca exclua o disco. Em vez disso, remova-o quando a instância dele for excluída.
  • on-permanent-instance-deletion: exclua o disco com estado quando a instância for excluída permanentemente do grupo de instâncias. Por exemplo, quando a instância for excluída manualmente ou quando o tamanho do grupo for reduzido.

  Seja qual for o valor da regra de exclusão, os discos com estado sempre serão preservados nas operações de recuperação automática, atualização e recriação de instâncias.

Exemplo

Você quer ter a recuperação automática em um servidor de banco de dados executado em uma VM autônoma chamada db-instance e que armazena os dados em um disco chamado db-data-disk-1.

Crie um MIG com estado que tenha a recuperação automática, crie uma VM semelhante dentro do MIG e anexe o disco de dados atual db-data-disk-1 à nova instância como um disco com estado:

1. Pare a VM, db-instance, durante uma janela de manutenção.
2. Crie um modelo de instância chamado db-template usando a configuração db-instance.
3. Remova db-data-disk-1 de db-instance e exclua db-instance.
4. Crie um MIG vazio, example-database-mig, de db-template e configure a recuperação automática.

5. Crie uma instância gerenciada com o nome db-instance original e anexe db-data-disk-1 como um disco com estado:

   gcloud compute instance-groups managed create-instance example-database-mig \
     --instance db-instance \
     --zone us-east1-c \
     --stateful-disk device-name=data-disk,source=projects/example-project/zones/us-east1-c/disks/db-data-disk-1,auto-delete=never
   

   O comando cria uma instância db-instance no MIG, gera uma configuração por instância correspondente com o disco com estado db-data-disk-1 e anexa-o à nova VM usando data-disk como o nome do dispositivo.

REST

Para criar uma ou várias instâncias em um MIG, defina nomes de VM personalizados e anexe um ou vários discos com estado atuais a essas instâncias. Para isso, use o método instanceGroupManagers.createInstances.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/NAME/createInstances

{
  "instances": [
    {
      "name": "VM_NAME",
      "preservedState" : {
        "disks": {
          "DEVICE_NAME" : {
            "source": "DISK",
            "mode": "MODE",
            "autoDelete": "DELETE_RULE"
          },
          ...
        }
      }
    },
    ...
  ]
}

Substitua:

• PROJECT_ID: o ID do projeto para a solicitação.
• ZONE: a zona onde o MIG está localizado, aplicável a um MIG zonal.
  • zones/ZONE por regions/REGION e especifique a região do MIG se ele for regional;
• NAME: o nome do MIG em que uma instância será criada;
• VM_NAME: o nome da instância que será criada;
• DEVICE_NAME: o nome de dispositivo que será usado ao anexar o disco;
• DISK: o URI de um disco permanente atual a ser anexado ao DEVICE_NAME especificado no formato projects/project-id/zones/zone/disks/disk-name para um disco zonal ou projects/project-id/regions/region/disks/disk-name para um disco regional.
• MODE: especifica o modo do disco. As opções aceitas são estas:
  • READ_ONLY: somente leitura.
  • READ_WRITE: padrão. Leitura/gravação

• DELETE_RULE: um valor que determina o que precisa acontecer em um disco com estado quando uma VM é excluída. As opções disponíveis são estas:

  • never: padrão. Nunca exclua o disco. Em vez disso, remova-o quando a VM dele for excluída.
  • on-permanent-instance-deletion: exclua o disco com estado quando a instância for excluída permanentemente do grupo. Por exemplo, quando a instância for excluída manualmente ou quando o tamanho do grupo for reduzido.

  Seja qual for o valor da regra de exclusão, os discos com estado sempre serão preservados nas operações de recuperação automática, atualização e recriação de instâncias.

Exemplo

Você quer ter a recuperação automática em um servidor de banco de dados executado em uma VM autônoma chamada db-instance e que armazena os dados em um disco chamado db-data-disk-1.

Crie um MIG com estado que tenha a recuperação automática, crie uma instância semelhante dentro do MIG e anexe o disco de dados atual db-data-disk-1 à nova VM como um disco com estado:

1. Pare a VM, db-instance, durante uma janela de manutenção.
2. Crie um modelo de instância chamado db-template usando a configuração db-instance.
3. Remova db-data-disk-1 de db-instance e exclua db-instance.
4. Crie um MIG vazio, example-database-mig, de db-template e configure a recuperação automática.

5. Crie uma instância com o nome original db-instance e anexe o db-data-disk-1 como um disco com estado:

   POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-east1-c/instanceGroupManagers/example-database-mig/createInstances
   
   {
     "instances": [
       {
         "name": "db-instance",
         "preservedState" : {
           "disks": {
             "data-disk" : {
               "source": "projects/example-project/zones/us-east1-c/disks/db-data-disk-1",
               "mode": "READ_WRITE",
               "autoDelete": "never"
             }
           }
         }
       }
     ]
   }
   

   O método cria uma instância db-instance no MIG, gera uma configuração por instância correspondente com o disco com estado db-data-disk-1 e anexa-o à nova instância usando data-disk como o nome de dispositivo.

gcloud

Para configurar discos com estado individualmente para uma VM em um MIG, adicione ou atualize a configuração do disco com estado na configuração por instância associada e atualize a instância para aplicar a nova configuração.

Se uma configuração por instância ainda não existir para a instância, use o comando gcloud compute instance-groups managed instance-configs create com uma ou várias sinalizações --stateful-disk:

gcloud compute instance-groups managed instance-configs create NAME \
--instance VM_NAME \
--stateful-disk device-name=DEVICE_NAME[,source=DISK][,mode=MODE][,auto-delete=DELETE_RULE] \
[--no-update-instance | --update-instance] \
[--instance-update-minimal-action MINIMAL_ACTION]

Se já houver uma configuração por instância, use o comando gcloud compute instance-groups managed instance-configs update com uma ou várias sinalizações --stateful-disk.

A sinalização --update-instance (padrão) aplica as alterações imediatamente à instância. Se você usar --no-update-instance, as alterações permanecerão não aplicadas e serão aplicadas na próxima vez que você recriar ou atualizar a instância.

gcloud compute instance-groups managed instance-configs update NAME \
--instance VM_NAME \
--stateful-disk device-name=DEVICE_NAME[,source=DISK][,mode=MODE][,auto-delete=DELETE_RULE] \
[--no-update-instance | --update-instance] \
[--instance-update-minimal-action MINIMAL_ACTION]

Substitua:

• NAME: o nome do grupo de instâncias gerenciadas;
• VM_NAME: o nome da instância de VM em que os discos com estado serão configurados;
• DEVICE_NAME: o nome do dispositivo usado para anexar o disco;

• DISK: o URI de um disco permanente atual a ser anexado ao DEVICE_NAME especificado no formato projects/project-id/zones/zone/disks/disk-name para um disco zonal e projects/project-id/regions/region/disks/disk-name para um disco regional;

  A subsinalização source=DISK é opcional se o dispositivo já estiver definido na configuração por instância da instância. Caso contrário, ela será obrigatória.

  Em caso de omissão, o URI do disco atualmente configurado permanecerá inalterado.

• MODE: especifica o modo do disco. Será possível especificar mode apenas se você também especificar source. As opções compatíveis são:

  • ro: somente leitura
  • rw: padrão. Leitura/gravação

  Em caso de omissão, o valor padrão será definido na nova configuração de disco com estado. O valor permanece inalterado em uma configuração atual.

• DELETE_RULE: um valor que determina o que precisa acontecer em um disco com estado quando uma VM é excluída. As opções disponíveis são estas:

  • never: padrão. Nunca exclua o disco. Em vez disso, remova-o quando a instância dele for excluída.
  • on-permanent-instance-deletion: exclua o disco com estado quando a instância for excluída permanentemente do grupo. Por exemplo, quando a instância for excluída manualmente ou quando o tamanho do grupo for reduzido.

  Em caso de omissão, o valor padrão será definido na nova configuração de disco com estado. O valor permanece inalterado em uma configuração atual.

  Seja qual for o valor da regra de exclusão, os discos com estado sempre serão preservados nas operações de recuperação automática, atualização e recriação de instâncias.

• MINIMAL_ACTION: executa, pelo menos, a ação especificada ao aplicar a atualização da configuração por instância à instância. Use-a com a sinalização --update-instance. O valor precisa ser uma das opções a seguir:

  • none: nenhuma ação.
  • refresh: aplicar as atualizações possíveis sem parar a VM.
  • restart: interromper a VM e iniciá-la novamente.
  • replace: recriar a VM.

  Se omitida, a ação menos interruptiva exigida pela atualização será usada.

Exemplo

Os dados em um disco com estado anexado atualmente, data-disk-1, foram corrompidos e você quer restaurá-los com base no backup mais recente. Você criou um disco data-disk-2 com base em um snapshot para substituir o disco corrompido na instância db-instance-1, gerenciada por um MIG com estado example-database-mig. O disco original data-disk-1 foi anexado ao nome de dispositivo data-disk com uma regra de exclusão automática para nunca excluir o disco.

Para substituir data-disk-1 por data-disk-2, execute o comando a seguir:

gcloud compute instance-groups managed instance-configs update example-database-mig \
  --instance db-instance-1 \
  --stateful-disk device-name=data-disk,source=projects/example-project/zones/us-east1-c/disks/data-disk-2 \
  --update-instance \
  --instance-update-minimal-action restart

O comando faz o seguinte:

1. Atualiza a configuração por instância para db-instance-1:
   1. Atualiza a origem do disco com o nome de dispositivo data-disk de data-disk-1 (última configuração) para data-disk-2 (nova configuração).
   2. Mantém a regra de exclusão automática para nunca excluir o disco porque o parâmetro auto-delete foi omitido na sinalização --stateful-disk e, por padrão, a regra de exclusão é never.
2. Aplica a atualização da configuração por instância à VM db-instance-1 imediatamente, porque a sinalização --update-instance foi incluída. O MIG remove data-disk-1 e anexa data-disk-2 com o mesmo nome de dispositivo data-disk.
3. Como a ação mínima está definida como restart, o MIG reinicia a instância db-instance-1 para atualizar a VM, o que ajuda o aplicativo de banco de dados a começar a usar o novo disco.

REST

Para configurar discos com estado individualmente nas VMs em um MIG, adicione ou atualize a configuração do disco com estado nas configurações por instância associadas. Em seguida, atualize as instâncias para aplicar a configuração.

Se as VMs especificadas ainda não tiverem configurações por instância, use o método instanceGroupManagers.updatePerInstanceConfigs ou o método regionInstanceGroupManagers.updatePerInstanceConfigs com a configuração com estado para um ou vários discos:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/NAME/updatePerInstanceConfigs

{
  "perInstanceConfigs": [
    {
      "name": "VM_NAME",
      "preservedState" : {
        "disks": {
          "DEVICE_NAME" : {
            "source": "DISK",
            "mode": "MODE",
            "autoDelete": "DELETE_RULE"
          },
          ...
        }
      },
      "fingerprint: "FINGERPRINT"
    },
    ...
  ]
}

Se as VMs especificadas já tiverem configurações por instância, use o método instanceGroupManagers.patchPerInstanceConfigs ou o método regionInstanceGroupManagers.patchPerInstanceConfigs com a configuração com estado para um ou vários discos:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/NAME/patchPerInstanceConfigs

{
  "perInstanceConfigs": [
    {
      "name": "VM_NAME",
      "preservedState" : {
        "disks": {
          "DEVICE_NAME" : {
            "source": "DISK",
            "mode": "MODE",
            "autoDelete": "DELETE_RULE"
          },
          ...
        }
      },
      "fingerprint: "FINGERPRINT"
    },
    ...
  ]
}

Substitua:

• PROJECT_ID: o ID do projeto para a solicitação.
• ZONE: a zona onde o MIG está localizado, aplicável a um MIG zonal.
  • zones/ZONE por regions/REGION e especifique a região do MIG se ele for regional;
• NAME: o nome do MIG;
• VM_NAME: o nome da VM em que os discos com estado serão configurados;
• DEVICE_NAME: o nome do dispositivo usado para anexar o disco;

• DISK: o URI de um disco permanente atual a ser anexado ao DEVICE_NAME especificado no formato projects/project-id/zones/zone/disks/disk-name para um disco zonal e projects/project-id/regions/region/disks/disk-name para um disco regional;

  O campo "source": "DISK" é opcional se o dispositivo já estiver definido na configuração por instância da instância. Caso contrário, ela será obrigatória.

  Se o campo source for omitido, o URI do disco configurado atualmente permanecerá inalterado.

• MODE: opcional. Especifica o modo do disco. mode só poderá ser especificado se source for fornecido. As opções aceitas são estas:

  • READ_ONLY: somente leitura
  • READ_WRITE: padrão. Leitura/gravação

  Em caso de omissão, o valor padrão será definido na nova configuração de disco com estado. O valor permanece inalterado em uma configuração atual.

• DELETE_RULE: opcional. Um valor que determina o que precisa acontecer em um disco com estado quando uma VM é excluída. As opções disponíveis são estas:

  • never: padrão. Nunca exclua o disco. Em vez disso, remova-o quando a instância dele for excluída.
  • on-permanent-instance-deletion: exclua o disco com estado quando a instância for excluída permanentemente do grupo. Por exemplo, quando a instância for excluída manualmente ou quando o tamanho do grupo for reduzido.

  Se o campo autoDelete for omitido, o valor padrão será definido na nova configuração de disco com estado. O valor permanece inalterado em uma configuração atual

  Seja qual for o valor da regra de exclusão, os discos com estado sempre serão preservados nas operações de recuperação automática, atualização e recriação de instâncias.

• FINGERPRINT: opcional. A impressão digital da configuração especificada, se já houver. Usada para bloqueio otimista. Para ver a impressão digital mais recente, faça uma solicitação get() para recuperar o recurso.

Os métodos updatePerInstanceConfigs e patchPerInstanceConfigs atualizam as configurações por instância especificadas, mas não aplicam as atualizações às VMs gerenciadas associadas. As alterações são aplicadas a uma instância quando o MIG recebe a instrução para recriá-la ou atualizá-la. Também é possível atualizar seletivamente a instância para aplicar as alterações.

Exemplo

Os dados em um disco com estado anexado atualmente, data-disk-1, foram corrompidos e você quer restaurá-los com base no backup mais recente. Você criou um disco data-disk-2 com base em um snapshot para substituir o disco corrompido na instância db-instance-1, gerenciada por um MIG com estado example-database-mig. O disco original data-disk-1 foi anexado ao nome de dispositivo data-disk com uma regra de exclusão automática para nunca excluir o disco.

Para atualizar a configuração por instância de db-instance-1 com o novo disco, chame o método patchPerInstanceConfigs:

POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-east1-c/instanceGroupManagers/example-database-mig/patchPerInstanceConfigs

{
  "perInstanceConfigs": [
    {
      "name": "db-instance-1",
      "preservedState" : {
        "disks": {
          "data-disk" : {
            "source": "projects/example-project/zones/us-east1-c/disks/data-disk-2"
          }
        }
      }
    }
  ]
}

O método corrige a configuração por instância para db-instance-1:

1. Atualiza a source de um disco com o nome de dispositivo data-disk de data-disk-1 (última configuração) para data-disk-2 (nova configuração).
2. Mantém os parâmetros mode e autoDelete inalterados porque eles foram omitidos na solicitação.

A atualização da config ainda não foi aplicada à VM db-instance-1. O MIG aplica a atualização da config quando você recria ou atualiza a instância.

Para aplicar a atualização da configuração por instância à VM db-instance-1, chame o método instanceGroupManagers.applyUpdatesToInstances para a instância:

POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-east1-c/instanceGroupManagers/example-database-mig/applyUpdatesToInstances
{
  "instances": ["/zones/us-east1-c/instances/db-instance-1"],
  "minimalAction": "RESTART"
}

O método atualiza o estado preservado da instância gerenciada, removendo data-disk-1 e anexando data-disk-2 com mesmo nome de dispositivo data-disk. Como a minimalAction está definida como RESTART, o método reinicia a VM db-instance-1, o que permite ao aplicativo de banco de dados começar a usar o novo disco.

gcloud

Para remover discos com estado ou declará-los sem estado individualmente para uma VM em um MIG, remova a configuração de disco com estado da configuração por instância associada ou exclua toda a configuração por instância se ele não tiver outro estado. Atualize a instância para aplicar a configuração.

Para remover uma configuração de disco com estado da config por instância associada, use o comando gcloud compute instance-groups managed instance-configs update com a sinalização --remove-stateful-disks. A sinalização --update-instance (padrão) aplica as alterações imediatamente à instância. Se você usar --no-update-instance, as alterações permanecerão não aplicadas e serão aplicadas na próxima vez que você recriar ou atualizar a instância.

gcloud compute instance-groups managed instance-configs update NAME \
  --instance VM_NAME \
  --remove-stateful-disks DEVICE_NAME[,DEVICE_NAME,...] \
  [--no-update-instance | --update-instance] \
  [--instance-update-minimal-action MINIMAL_ACTION]

Substitua:

• NAME: o nome do MIG;
• VM_NAME: o nome da VM da qual remover a configuração com estado;
• DEVICE_NAME: o nome do dispositivo usado para anexar o disco;

• MINIMAL_ACTION: execute pelo menos a ação especificada ao atualizar a VM com a configuração por instância dela. Ela pode ser usada apenas com --update-instance. O valor precisa ser um dos seguintes:

  • none: nenhuma ação.
  • refresh: aplicar as atualizações possíveis sem parar a VM.
  • restart: interromper a VM e iniciá-la novamente.
  • replace: recriar a VM.

  Se omitida, a ação menos interruptiva exigida pela atualização será usada.

Exemplo

Você executa um aplicativo legado em um MIG chamado example-legacy-group. Cada VM no MIG armazena os dados do aplicativo em um disco de inicialização com o nome de dispositivo boot-disk. Usando as configurações por instância, você configurou cada disco de inicialização como "com estado". Agora você moveu os dados do aplicativo para um disco extra e quer tornar o disco de inicialização sem estado para cada VM a fim de facilitar a atualização para novas imagens.

Por exemplo, para cada instância de node-1, execute o comando:

gcloud compute instance-groups managed instance-configs update example-legacy-group \
  --instance node-1 \
  --remove-stateful-disks boot-disk \
  --update-instance

O comando faz o seguinte:

1. Remove a configuração do disco com o nome de dispositivo boot-disk da configuração por instância para node-1.
2. Aplica a atualização da configuração por instância à VM node-1 imediatamente, porque a sinalização --update-instance foi incluída. O MIG remove o disco de inicialização da preservedStateFromConfig da instância gerenciada e o trata como "sem estado". Isso significa que ele recria o disco com base na imagem de inicialização dele no modelo de instância nos eventos subsequentes de recriação, atualização ou recuperação automática de instâncias.

REST

Para remover discos com estado ou declará-los sem estado individualmente para uma VM em um MIG, remova a configuração de disco com estado da configuração por instância associada ou exclua toda a configuração por instância se ele não tiver outro estado. Em seguida, atualize a instância para aplicar a configuração.

Para remover uma configuração de disco com estado da configuração por instância associada, use o método instanceGroupManagers.patchPerInstanceConfigs ou o método regionInstanceGroupManagers.patchPerInstanceConfigs:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/NAME/patchPerInstanceConfigs

{
  "perInstanceConfigs": [
    {
      "name": "VM_NAME",
      "preservedState" : {
        "disks": {
          "DEVICE_NAME" : null
        },
        ...
      },
      "fingerprint: "FINGERPRINT"
      ...
    }
  ]
}

Substitua:

• PROJECT_ID: o ID do projeto para a solicitação.
• ZONE: a zona onde o MIG está localizado, aplicável a um MIG zonal.
  • zones/ZONE por regions/REGION e especifique a região do MIG se ele for regional;
• NAME: o nome do MIG;
• VM_NAME: o nome da VM da qual remover a configuração com estado;
• DEVICE_NAME: o nome do dispositivo usado para anexar o disco;
• FINGERPRINT: a impressão digital da configuração especificada, se já houver. Usada para bloqueio otimista. Para ver a impressão digital mais recente, faça uma solicitação get() para recuperar o recurso.

O método patchPerInstanceConfigs corrige as configurações por instância especificadas, mas não aplica as alterações às VMs associadas. As alterações são aplicadas a uma VM quando você recria ou atualiza a instância. É possível aplicar as alterações manualmente ou usar atualizações graduais automatizadas.

Exemplo

Você executa um aplicativo legado em um MIG chamado example-legacy-group. Cada VM no MIG armazena os dados do aplicativo em um disco de inicialização com o nome de dispositivo boot-disk. Você configurou o disco de inicialização como "com estado" nas configurações por instância do MIG ao migrar as VMs autônomas para o MIG. Você moveu os dados do aplicativo para um disco extra e agora quer tornar o disco de inicialização sem estado para cada VM a fim de facilitar a atualização para as novas imagens.

1. Chame o método patchPerInstanceConfigs para as instâncias. Por exemplo, em node-1 com um valor null para o disco de inicialização:

   POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-east1-c/instanceGroupManagers/example-legacy-group/patchPerInstanceConfigs
   
   {
     "perInstanceConfigs": [
       {
         "name": "node-1",
         "preservedState" : {
           "disks": {
             "boot-disk" : null
           }
         }
       }
     ]
   }
   

   O método remove a configuração do disco com o nome de dispositivo boot- disk da configuração por instância para node-1. A atualização da config ainda não foi aplicada à instância de VM node-1. A atualização da config será aplicada na próxima recriação ou atualização da instância.

2. Para aplicar a atualização da configuração por instância à instância de VM node-1, chame o método instanceGroupManagers.applyUpdatesToInstances para a instância:

   POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-east1-c/instanceGroupManagers/example-legacy-group/applyUpdatesToInstances
   {
     "instances": ["/zones/us-east1-c/instances/node-1"]
   }
   

   O MIG remove o disco de inicialização da preservedStateFromConfig para a instância node-1 e o trata como sem estado. Ou seja, o MIG recria o disco com base na imagem de inicialização no modelo de instância nos eventos subsequentes de recriação, atualização ou recuperação automática de instâncias.