Programar jobs de patch

Console

1. No console do Google Cloud, acesse a página Compute Engine > VM Manager > Patch.

   Acesse a página "Patch"

2. Clique em Nova implantação de patch.

3. Na seção VMs de destino, selecione a zona que contém as VMs que você quer corrigir. Se preferir, selecione todas as zonas.

   Por exemplo, para corrigir VMs específicas nas zonas selecionadas, insira os filtros de nome e rótulo semelhantes aos seguintes:

   • Prefixo de nome: test-
   • Rótulos: env=dev e app=web

4. Na seção Configuração do patch, configure o patch.

   1. Especifique um Nome para seu patch.
   2. Selecione as atualizações necessárias para o sistema operacional. Para mais informações, consulte o que está incluído em um job de patch do SO.

5. Na seção Programação, conclua o seguinte:

   • Selecione uma programação. É possível programar um job de patch único ou jobs de patch recorrentes.
   • (Opcional) Defina uma duração ou janela de manutenção.

6. Na seção Opções de lançamento, configure as opções de lançamento do patch:

   • Selecione se quer corrigir uma zona por vez ou várias zonas simultaneamente.
   • Defina um orçamento de interrupção. Um orçamento de interrupção é o número ou a porcentagem de VMs em uma zona que você quer que seja interrompida de uma só vez pelo processo de aplicação de patches.

7. (Opcional) Na seção Opções avançadas, é possível concluir as seguintes tarefas:

   • Selecione uma opção de reinicialização.
   • Faça upload de scripts pré-patch e pós-patch. Para mais informações sobre scripts pré-patch e pós-patch, consulte Como especificar scripts pré-patch e pós-patch.

8. Clique em Implantar.

gcloud

Use o comando os-config patch-deployments create para criar uma implantação de patch.

gcloud compute os-config patch-deployments create patch-deployment-id \
    --file patch-deployment-file

Substitua:

• patch-deployment-id: o nome da implantação de patch.
• patch-deployment-file: o caminho para o arquivo YAML ou JSON que contém as configurações da implantação de patch.

Exemplo de arquivos YAML de implantação de patch

O arquivo YAML de amostra a seguir pode ser usado para criar uma programação recorrente em todas as instâncias nas zonas us-west2-b e us-west2-c. A programação recorrente tem as seguintes especificações:

• A data de início é 9 de janeiro de 2019, às 19h30.
• A data de término é 9 de janeiro de 2020, às 19h30.
• O fuso horário a ser usado é "América/Los_Angeles"
• Executada toda semana em uma terça-feira

instanceFilter:
  zones:
  - us-west2-b
  - us-west2-c
recurringSchedule:
  frequency: WEEKLY
  weekly:
    dayOfWeek: TUESDAY
  timeOfDay:
    hours: 19
    minutes: 30
  timeZone:
    id: America/Los_Angeles
  startTime: '2019-09-01T12:00:00Z'
  endTime: '2020-09-01T12:00:00Z'

REST

Na API, crie uma solicitação POST para criar uma nova implantação de patch. Você precisa definir explicitamente todos os campos de configuração obrigatórios, conforme descrito na documentação da API patchDeployments.create. Por exemplo, uma implantação de patch com os campos mínimos obrigatórios (filtro e programação da instância) tem a seguinte aparência. Substitua project-id pelo ID do projeto.

POST https://osconfig.googleapis.com/v1/projects/project-id/patchJobs:execute

{
  "instanceFilter": instance-filter

  // Add one of the following parameters:
  "recurringSchedule": schedule
  "oneTimeSchedule": schedule
}

Substitua:

• project-id: o ID do projeto
• instance-filter: os parâmetros de filtro que você quer Para mais informações sobre filtros de instância, consulte filtros de instância.
• schedule: forneça o parâmetro oneTimeSchedule ou recurringSchedule que detalha os parâmetros de programação, como data, hora e frequência, para executar o job de patch.

Exemplos

Exemplo 1: crie uma programação única para executar um job de patch em 10 de janeiro de 2020 às 12h UTC em todas as instâncias nas zonas us-west2-b e us-west2-c.

{
 "instanceFilter":{
   "zones":[
     "us-west2-b",
     "us-west2-c"
   ]
 },
 "oneTimeSchedule": {
   "executeTime": "2020-01-10T00:00:00Z"
 }
}

Exemplo 2: crie uma programação recorrente para todas as instâncias nas zonas us-west2-b e us-west2-c. A programação recorrente tem as seguintes especificações:

• A data de início é 9 de janeiro de 2019, às 19h30.
• A data de término é 9 de janeiro de 2020, às 19h30.
• O fuso horário a ser usado é "América/Los_Angeles"
• Executada toda semana em uma terça-feira

POST https://osconfig.googleapis.com/v1/projects/project-id/patchDeployments
{
  "instanceFilter":{
    "zones":[
      "us-west2-b",
      "us-west2-c"
    ]
  },
  "recurringSchedule":{
    "frequency":"WEEKLY",
    "weekly":{
      "dayOfWeek":"TUESDAY"
    },
    "timeOfDay":{
      "hours":19,
      "minutes":30
    },
    "timeZone":{
      "id":"America/Los_Angeles"
    },
    "startTime":"2019-09-01T12:00:00Z",
    "endTime":"2020-09-01T12:00:00Z"
  }
}

Console

1. No console do Google Cloud, acesse a página Compute Engine > VM Manager > Patch.

   Acesse a página "Patch"

2. Selecione a guia Implantações programadas.

gcloud

Use o comando os-config patch-deployments list para listar implantações de patch.

gcloud compute os-config patch-deployments list

Este comando retorna todas as implantações de patch. A saída será assim:

NAME              LAST_RUN                  NEXT_RUN              FREQUENCY
first-deployment  2019-12-18T00:07:00.738Z  ---                   Once: Scheduled for 2019-12-18T00:07:00.000Z
my-deployment1    2020-01-05T14:00:00.228Z  2020-01-12T14:00:00Z  Recurring - Weekly
my-deployment2    ---                       2020-01-15T05:30:00Z  Recurring - Monthly on specific date(s)

Também é possível usar mais sinalizações para limitar e formatar sua pesquisa. Por exemplo, para listar as 10 primeiras implantações de patch em páginas de dois, execute o seguinte comando. Substitua project-id pelo código do projeto:

gcloud compute os-config patch-deployments list --limit 10 --page-size 2

REST

Na API, crie uma solicitação GET para o método patchDeployments.list. Substitua project-id pelo ID do projeto.

GET https://osconfig.googleapis.com/v1/projects/project-id/patchDeployments

Console

1. No console do Google Cloud, acesse a página Compute Engine > VM Manager > Patch.

   Acesse a página "Patch"

2. Selecione a guia Implantações programadas.
3. Clique no nome da implantação que você quer analisar.

gcloud

Use o comando os-config patch-deployments describe para descrever uma implantação de patch. Substitua patch-deployment-id pelo nome da implantação de patch.

gcloud compute os-config patch-deployments describe patch-deployment-id

REST

Na API, crie uma solicitação GET para o método patchDeployments.get.

GET https://osconfig.googleapis.com/v1/projects/project-id/patchDeployments/patch-deployment-id

Substitua:

• project-id: o ID do projeto.
• patch-deployment-id: o nome da implantação de patch.

Console

1. No console do Google Cloud, acesse a página Compute Engine > VM Manager > Patch.

   Acesse a página "Patch"

2. Selecione a guia Implantações programadas.
3. Clique no nome da implantação que você quer excluir.
4. Clique em Excluir esta programação.

gcloud

Use o comando os-config patch-deployments delete para excluir uma implantação de patch. Substitua patch-deployment-id pelo nome da implantação de patch.

gcloud compute os-config patch-deployments delete patch-deployment-id

REST

Na API, crie uma solicitação DELETE para o método patchDeployments.delete.

DELETE https://osconfig.googleapis.com/v1/projects/project-id/patchDeployments/patch-deployment-id

Substitua:

• project-id: o ID do projeto.
• patch-deployment-id: o nome da implantação de patch.