Administrar trabajos de parche

Organízate con las colecciones Guarda y clasifica el contenido según tus preferencias.

Después de crear un trabajo de parche , puede utilizar los siguientes procedimientos para revisar y administrar sus parches:

• Lista de trabajos de parche : vea una lista de todos los trabajos activos y completados.
• Enumere los detalles de la instancia de VM : revise el estado del parche para sus instancias de VM.
• Describir el trabajo de parche : obtenga detalles sobre un trabajo de parche específico.
• Cancelar un trabajo de parche : cancela un trabajo de parche específico.

Puede administrar sus trabajos de parches mediante la consola de Google Cloud , la CLI de Google Cloud o REST .

Antes de comenzar

• Revise las cuotas de configuración del sistema operativo .
• Si aún no lo has hecho, configura la autenticación. La autenticación es el proceso mediante el cual se verifica su identidad para acceder a Google Cloud servicios y API. Para ejecutar código o muestras desde un entorno de desarrollo local, puedes autenticarte en Compute Engine seleccionando una de las siguientes opciones:
  

  Select the tab for how you plan to use the samples on this page:

  Console

  When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

  gcloud

  1. After installing the Google Cloud CLI, initialize it by running the following command:

     gcloud init

     If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  2. Set a default region and zone.

  REST

  Para usar las muestras de la API de REST en esta página en un entorno de desarrollo local, debes usar las credenciales que proporcionas a la CLI de gcloud.

  After installing the Google Cloud CLI, initialize it by running the following command:

  gcloud init

  If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  Para obtener más información, consulta Autentica para usar REST en la documentación de autenticación de Google Cloud .

Permisos

Los propietarios de un proyecto tienen acceso completo para ejecutar y administrar trabajos de parche. Para todos los demás usuarios, debe otorgar permisos. Puede otorgar uno de los siguientes roles granulares:

• roles/osconfig.patchJobExecutor : contiene permisos para ejecutar, cancelar, obtener y enumerar trabajos de parche. También contiene permisos para ver los detalles de la instancia de un trabajo de parche.
• roles/osconfig.patchJobViewer : contiene permisos de acceso de solo lectura para obtener y enumerar trabajos de parche. También contiene permisos para ver los detalles de la instancia de un trabajo de parche.

Listar trabajos de parche

Vea una lista de todos los trabajos activos y completados.

gcloud compute os-config patch-jobs list

ID                                          NAME    DESCRIPTION               CREATE_TIME               UPDATE_TIME               STATE                  TARGETED_INSTANCES
23b0815e-1c94-4dc6-91b1-30a6da395cb9                                          2019-11-05T20:22:54.150Z  2019-11-06T19:40:08.641Z  COMPLETED_WITH_ERRORS  4
4116ad72-bd57-4e48-94dc-7a577dc707b6                                          2019-08-23T20:36:03.068Z  2019-08-23T20:36:15.984Z  CANCELED               2
06856cbe-9a7b-498e-9105-9ae4eb566511                                          2019-08-12T20:27:38.410Z  2019-08-12T20:28:37.583Z  SUCCEEDED              1
04a15964-9eaa-4282-96f5-9cd535352cf6                                          2019-08-12T17:48:22.938Z  2019-08-12T17:48:42.274Z  SUCCEEDED              0
21dc1e06-deee-4e3a-821e-8082a32abde5                testing patch job reboot  2019-07-24T22:45:07.451Z  2019-07-25T00:44:44.459Z  TIMED_OUT              1

gcloud compute os-config patch-jobs list \
   --filter="state=SUCCEEDED" \
   --sort-by="create_time" --uri

https://osconfig.googleapis.com/v1/projects/1234567/patchJobs/04a15964-9eaa-4282-96f5-9cd535352cf6
https://osconfig.googleapis.com/v1/projects/1234567/patchJobs/06856cbe-9a7b-498e-9105-9ae4eb566511

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

Enumere todos los detalles de la instancia de VM para un trabajo de parche específico

Revise el estado del trabajo de parche para obtener la lista completa de instancias de VM que utilizan la administración de parches del sistema operativo.

gcloud compute os-config patch-jobs list-instance-details patch-job-id

gcloud compute os-config patch-jobs list-instance-details 23b0815e-1c94-4dc6-91b1-30a6da395cb9

NAME                        ZONE           STATE      FAILURE_REASON
instance-1                  us-central1-a  SUCCEEDED
guest-policy-test-instance  us-east1-c     TIMED_OUT  Instance timed out while in state: APPLYING_PATCHES after PT1H2.225S
my-centos                   us-west1-b     SUCCEEDED
my-windows                  us-west1-b     FAILED     Error running pre-patch step: fork/exec /tmp/pre_patch_script.sh: no such file ..."

gcloud compute os-config patch-jobs list-instance-details patch-job-id \
   --filter="state=INACTIVE" \
   --sort-by="~name"

GET https://osconfig.googleapis.com/v1/projects/project-id/patchJobs/patch-job-id/instanceDetails

Describir trabajos de parche

Revise la información detallada para un trabajo de parche.

gcloud compute os-config patch-jobs describe patch-job-id

gcloud compute os-config patch-jobs describe 23b0815e-1c94-4dc6-91b1-30a6da395cb9

createTime: '2019-11-05T20:22:54.150Z'
errorMessage: Completed with 2 instance failure(s).
filter: id=*
instanceDetailsSummary:
  instancesFailed: '1'
  instancesSucceeded: '2'
  instancesTimedOut: '1'
instanceFilter: {}
name: projects/1234567/patchJobs/23b0815e-1c94-4dc6-91b1-30a6da395cb9
patchConfig: {}
percentComplete: 100.0
state: COMPLETED_WITH_ERRORS
updateTime: '2019-11-06T19:40:08.641Z'

GET https://osconfig.googleapis.com/v1/projects/project-id/patchJobs/patch-job-id

Cancelar trabajos de parche

Al cancelar un trabajo de parche, el agente de configuración del sistema operativo finaliza la subtarea en la que se encuentra, pero no continúa después de eso. La subtarea se refiere a una tarea realizada por el agente que no se puede detener.

Por ejemplo, si el trabajo de parche se cancela mientras se reinicia la instancia de VM, el reinicio (y cualquier posible parche automático posterior al reinicio) aún se ejecuta hasta su finalización, pero el agente no inicia tareas adicionales para ese trabajo de parche.

gcloud compute os-config patch-jobs cancel patch-job-id

POST https://osconfig.googleapis.com/v1/projects/project-id/patchJobs/patch-job-id:cancel

¿Qué sigue?

• Obtenga más información sobre el parche .
• Obtenga más información sobre el estado de cumplimiento de parches .
• Cree un trabajo de parche .
• Programe trabajos de parche .