Setelah membuat tugas patch, Anda dapat menggunakan prosedur berikut untuk meninjau dan mengelola patch:
- Cantumkan tugas patch: Melihat daftar semua tugas yang aktif dan sudah selesai.
- Cantumkan detail instance VM: Meninjau status patch untuk instance VM Anda.
- Deskripsikan tugas patch: Mendapatkan detail tentang tugas patch tertentu.
- Batalkan tugas patch: Membatalkan tugas patch tertentu.
Anda dapat mengelola tugas patch menggunakan konsol Google Cloud, Google Cloud CLI, atau REST.
Sebelum memulai
- Tinjau kuota OS Config.
-
Jika Anda belum melakukannya, siapkan autentikasi.
Autentikasi adalah
proses verifikasi identitas Anda untuk mengakses layanan dan API Google Cloud.
Untuk menjalankan kode atau contoh dari lingkungan pengembangan lokal, Anda dapat mengautentikasi ke Compute Engine dengan memilih salah satu opsi berikut:
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
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
roles/osconfig.patchJobExecutor
: Berisi izin untuk menjalankan, membatalkan, mendapatkan, dan mencantumkan tugas patch. Ini juga berisi izin untuk melihat detail instance untuk tugas patch.roles/osconfig.patchJobViewer
: Berisi izin akses hanya baca untuk mendapatkan dan mencantumkan tugas patch. Ini juga berisi izin untuk melihat detail instance untuk tugas patch.- Di konsol Google Cloud, buka halaman Compute Engine > VM Manager > Patch.
- Pilih tab Tugas Patch.
- Di konsol Google Cloud, buka halaman Compute Engine > VM Manager > Patch.
- Pilih tab Tugas Patch.
- Klik nama tugas patch yang ingin Anda tinjau.
- Scroll ke bawah ke bagian Instance VM yang diperbarui.
project-id
: Project ID Anda.patch-job-id
: ID tugas patch Anda.- Di konsol Google Cloud, buka halaman Compute Engine > VM Manager > Patch.
- Pilih tab Tugas Patch.
- Klik nama tugas patch yang ingin Anda tinjau.
- Tinjau bagian Perbarui info.
project-id
: Project ID Anda.patch-job-id
: ID tugas patch Anda.- Di konsol Google Cloud, buka halaman Compute Engine > VM Manager > Patch.
- Pilih tab Tugas Patch.
- Luaskan menu Tindakan untuk tugas patch yang ingin dibatalkan.
- Pilih Batal.
project-id
: Project ID Anda.patch-job-id
: ID tugas patch Anda.- Pelajari Patch lebih lanjut.
- Pelajari status kepatuhan patch lebih lanjut.
- Membuat tugas patch.
- Menjadwalkan tugas patch.
REST
Untuk menggunakan contoh REST API di halaman ini dalam lingkungan pengembangan lokal, gunakan kredensial yang Anda berikan ke gcloud CLI.
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
Untuk informasi selengkapnya, lihat Melakukan autentikasi untuk menggunakan REST dalam dokumentasi autentikasi Google Cloud.
Izin
Pemilik project memiliki akses penuh untuk menjalankan dan mengelola tugas patch. Untuk semua pengguna lainnya, Anda harus memberikan izin. Anda dapat memberikan salah satu peran terperinci berikut:
Mencantumkan tugas patch
Melihat daftar semua tugas yang aktif dan selesai.
console
gcloud
Gunakan perintah
os-config patch-jobs list
untuk mencantumkan tugas patch.gcloud compute os-config patch-jobs list
Untuk Google Cloud CLI, output default akan menampilkan 10 tugas patch terbaru, baik tugas tersebut sudah selesai maupun aktif. Anda dapat mengganti setelan ini menggunakan flag
--limit
.Outputnya akan terlihat seperti berikut:
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
Anda dapat menggunakan lebih banyak flag untuk memfilter, mengurutkan, dan memformat penelusuran. Misalnya, untuk memfilter output di atas agar hanya mencantumkan URI untuk tugas patch yang memiliki status
SUCCEEDED
yang diurutkan berdasarkan waktu pembuatan dan dalam urutan naik, jalankan perintah berikut:gcloud compute os-config patch-jobs list \ --filter="state=SUCCEEDED" \ --sort-by="create_time" --uri
Outputnya akan terlihat seperti berikut:
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
Untuk melihat daftar lengkap flag, tinjau perintah
os-config patch-jobs list
.REST
Di API, buat permintaan
GET
ke metodepatchJobs.list
. Gantiproject-id
dengan project ID Anda.GET https://osconfig.googleapis.com/v1/projects/project-id/patchJobs
Mencantumkan semua detail instance VM untuk tugas patch tertentu
Tinjau status tugas patch untuk melihat daftar lengkap instance VM yang menggunakan OS patch management.
console
gcloud
Gunakan perintah
os-config patch-jobs list-instance-details
untuk mencantumkan detail semua VM dalam tugas patch tertentu. Gantipatch-job-id
dengan ID untuk tugas patch Anda.gcloud compute os-config patch-jobs list-instance-details patch-job-id
Misalnya, untuk melihat detail semua instance yang merupakan bagian dari tugas patch
23b0815e-1c94-4dc6-91b1-30a6da395cb9
, jalankan perintah berikut:gcloud compute os-config patch-jobs list-instance-details 23b0815e-1c94-4dc6-91b1-30a6da395cb9
Outputnya akan terlihat seperti berikut:
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 ..."
Anda dapat menggunakan lebih banyak flag untuk memfilter, mengurutkan, dan memformat penelusuran. Misalnya, untuk mencantumkan detail semua VM tidak aktif yang diurutkan berdasarkan nama instance dalam urutan menurun, jalankan perintah berikut. Ganti
patch-job-id
dengan ID untuk tugas patch Anda.gcloud compute os-config patch-jobs list-instance-details patch-job-id \ --filter="state=INACTIVE" \ --sort-by="~name"
Untuk melihat daftar lengkap flag, tinjau perintah
os-config patch-jobs list-instance-details
.REST
Di API, buat permintaan
GET
ke metodepatchJobs.instanceDetails
.GET https://osconfig.googleapis.com/v1/projects/project-id/patchJobs/patch-job-id/instanceDetails
Ganti kode berikut:
Menjelaskan tugas patch
Tinjau informasi mendetail tentang tugas patch.
console
gcloud
Gunakan perintah
os-config patch-jobs describe
untuk mendeskripsikan tugas patch. Gantipatch-job-id
dengan ID untuk tugas patch Anda.gcloud compute os-config patch-jobs describe patch-job-id
Misalnya, untuk melihat informasi tentang tugas patch
23b0815e-1c94-4dc6-91b1-30a6da395cb9
, jalankan perintah berikut:gcloud compute os-config patch-jobs describe 23b0815e-1c94-4dc6-91b1-30a6da395cb9
Outputnya akan terlihat seperti berikut:
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'
REST
Di API, buat permintaan
GET
ke metodepatchJobs.get
.GET https://osconfig.googleapis.com/v1/projects/project-id/patchJobs/patch-job-id
Ganti kode berikut:
Membatalkan tugas patch
Saat membatalkan tugas patch, agen Konfigurasi OS menyelesaikan sub-tugas yang berada di sana, tetapi tidak akan melanjutkan tugas setelahnya. Sub-tugas mengacu pada tugas yang dilakukan oleh agen yang tidak dapat dihentikan.
Misalnya, jika tugas patch dibatalkan saat instance VM di-reboot, proses mulai ulang (dan kemungkinan patch otomatis setelah mulai ulang) masih akan berjalan hingga selesai, tetapi agen tidak memulai tugas tambahan untuk patch tersebut.
console
gcloud
Gunakan perintah
os-config patch-jobs cancel
untuk membatalkan tugas patch. Gantipatch-job-id
dengan ID untuk tugas patch Anda.gcloud compute os-config patch-jobs cancel patch-job-id
REST
Di API, buat permintaan
POST
ke metodepatchJobs.cancel
.POST https://osconfig.googleapis.com/v1/projects/project-id/patchJobs/patch-job-id:cancel
Ganti kode berikut:
Apa langkah selanjutnya?
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2024-12-04 UTC.
-