Halaman ini berisi prosedur untuk menemukan dan menetapkan masa pemeliharaan pada instance Cloud SQL. Untuk mempelajari lebih lanjut tentang cara dan alasan Cloud SQL melakukan pemeliharaan, lihat Ringkasan pemeliharaan pada instance Cloud SQL.
Sebelum memulai
- Login ke akun Google Cloud Anda. Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru juga mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.
-
Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.
-
Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.
- Menginstal Google Cloud CLI.
-
Untuk initialize gcloud CLI, jalankan perintah berikut:
gcloud init
-
Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.
-
Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.
- Menginstal Google Cloud CLI.
-
Untuk initialize gcloud CLI, jalankan perintah berikut:
gcloud init
Menetapkan periode pilihan untuk pemeliharaan pada instance
Konsol
-
Di konsol Google Cloud, buka halaman Instance Cloud SQL.
- Untuk membuka halaman Ringkasan sebuah instance, klik nama instance.
- Di bagian Pemeliharaan, klik Edit preferensi pemeliharaan.
- Di bagian Opsi konfigurasi, buka Pemeliharaan.
- Konfigurasikan opsi berikut:
- Periode pilihan. Tetapkan rentang hari dan jam saat update dapat dilakukan pada instance ini.
- Urutan update. Tetapkan urutan update instance ini, terkait dengan update untuk instance lainnya. Tetapkan pengaturan waktu ke Any, Earlier, or Later. Instance yang menggunakan setelan Earlier menerima update hingga seminggu sebelum instance menggunakan setelan Later saat membandingkan instance yang berada di lokasi yang sama.
gcloud
Sebelum menggunakan perintah gcloud di bawah ini, buat pengganti berikut:
- instance-id: Instance yang dijadwalkan ulang
- day: Hari saat Anda ingin melakukan pemeliharaan. Tetapkan ke salah satu dari
SUN
,MON
,TUE
,WED
,THU
,FRI
,SAT
. - hour: Jam berlangsungnya masa pemeliharaan dalam zona waktu UTC (0-23).
gcloud sql instances patch instance-id \ --maintenance-window-day=day \ --maintenance-window-hour=hour
gcloud sql instances patch
.
Jika Anda membuat perubahan pada setelan masa pemeliharaan saat instance sedang menjalani pemeliharaan atau dijadwalkan untuk pemeliharaan, perubahan tersebut tidak akan langsung diterapkan. Perubahan ini akan diterapkan dalam tindakan pemeliharaan mendatang.
Jika Anda mengaktifkan notifikasi pemeliharaan, maka Cloud SQL akan mengirimkan notifikasi setelah instance sudah dijadwalkan untuk pemeliharaan, dengan tanggal dan waktu tepat saat pemeliharaan dijadwalkan untuk dilaksanakan. Cloud SQL akan mengirimkan notifikasi ini berdasarkan urutan masa pemeliharaan instance dari setelan update, sebagai berikut:
- Jika urutan setelan update ditetapkan ke
Earlier
, maka Cloud SQL akan mengirimkan notifikasi pemeliharaan setidaknya satu minggu sebelumnya. - Jika urutan setelan update ditetapkan ke
Later
, maka Cloud SQL akan mengirimkan notifikasi pemeliharaan setidaknya dua minggu sebelumnya.
Mengaktifkan notifikasi pemeliharaan
Sebelum mengaktifkan notifikasi pemeliharaan, Anda harus menetapkan periode pilihan untuk pemeliharaan pada instance
- Buka halaman Komunikasi. Buka Komunikasi
- Di baris untuk Cloud SQL, Masa pemeliharaan, pilih tombol pilihan pada bagian Email untuk mengAKTIFkannya.
Setiap pengguna yang perlu menerima notifikasi harus mengaktifkannya secara terpisah.
Menemukan notifikasi pemeliharaan di konsol Google Cloud
Anda dapat melihat notifikasi pemeliharaan di beberapa tempat pada konsol Google Cloud:
Di dasbor AKTIVITAS, cari instance yang ditandai dengan Pemeliharaan SQL.
Buka AktivitasSaat instance dijadwalkan untuk pemeliharaan, tanggal pemeliharaan tercantum pada halaman Instance di kolom Pemeliharaan. Kolom Pemeliharaan biasanya disembunyikan, tetapi otomatis ditampilkan saat pemeliharaan dijadwalkan. Anda juga dapat memilih Pemeliharaan dari Opsi tampilan kolom (
) jika Anda ingin menu Pemeliharaan selalu muncul.
Selain itu, Anda dapat memilih instance untuk membuka halaman Detail instance. Jika instance dijadwalkan untuk pemeliharaan, Anda akan melihat pesan di panel Pemeliharaan.
Buka instance Cloud SQL
Menemukan masa pemeliharaan terjadwal menggunakan API
gcloud
Sebelum menggunakan perintah gcloud
di bawah ini, buat pengganti berikut
- instance-id: Instance yang dijadwalkan ulang
gcloud sql instances describe instance-id
Cari bagian scheduledMaintenance
dalam respons.
REST v1
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- PROJECT_ID: ID atau nomor project project Google Cloud yang berisi instance
- INSTANCE_NAME: nama instance yang Anda konfigurasi untuk ketersediaan tinggi
Metode HTTP dan URL:
GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME
Untuk mengirim permintaan, perluas salah satu opsi berikut:
Anda akan melihat respons JSON seperti berikut:
{ "kind": "sql#instance", "state": "RUNNABLE", "databaseVersion": "MYSQL_8_0" }
Cari bagian scheduledMaintenance
dalam respons.
REST v1beta4
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- PROJECT_ID: ID atau nomor project project Google Cloud yang berisi instance
- INSTANCE_NAME: nama instance yang Anda konfigurasi untuk ketersediaan tinggi
Metode HTTP dan URL:
GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME
Untuk mengirim permintaan, perluas salah satu opsi berikut:
Anda akan melihat respons JSON seperti berikut:
{ "kind": "sql#instance", "state": "RUNNABLE", "databaseVersion": "MYSQL_8_0" }
Cari bagian scheduledMaintenance
dalam respons.
Menjadwalkan ulang pemeliharaan terencana
Anda dapat menjadwalkan ulang pemeliharaan menggunakan konsol Google Cloud, gcloud
, atau Cloud SQL Admin API.
Konsol
-
Di konsol Google Cloud, buka halaman Instance Cloud SQL.
- Filter istilah Pemeliharaan untuk menampilkan daftar semua instance yang dijadwalkan untuk pemeliharaan.
- Di kolom Pemeliharaan, klik Jadwalkan Ulang.
- Di dialog Jadwalkan Ulang, pilih apakah akan segera menerapkan pemeliharaan, menjadwalkan ulang pemeliharaan agar terjadi pada waktu tertentu dalam periode penundaan selama 28 hari, atau menunda ke periode pemeliharaan berikutnya yang tersedia.
gcloud
Sebelum menggunakan perintah gcloud
di bawah ini, lakukan beberapa penggantian
berikut:
- instance-id: Instance yang dijadwalkan ulang
- reschedule-type: Gunakan salah satu dari IMMEDIATE,
NEXT_AVAILABLE_WINDOW, atau SPECIFIC_TIME.
Jika memilih NEXT_AVAILABLE_WINDOW, pemeliharaan akan dijadwalkan ulang ke masa pemeliharaan berikutnya yang tersedia mengikuti waktu yang dijadwalkan saat ini.
- reschedule-time: Jika memilih SPECIFIC_TIME untuk reschedule-type, Anda juga harus menetapkan flag ini guna menentukan hari dan waktu baru untuk melakukan pemeliharaan. Gunakan format ISO 8601. Misalnya, 2020-01-16T16:56:00.000Z
gcloud sql reschedule-maintenance instance-id \ --reschedule-type=reschedule-type \ [--schedule-time=reschedule-time]
gcloud sql reschedule-maintenance
.
Jika Anda ingin menjadwalkan ulang pemeliharaan hingga 28 hari, periksa nomor
versi gcloud
. Jika nomor versinya di bawah 390.0.0_RC00
,
instal ulang gcloud
.
REST v1
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- project-id: ID project
- instance-id: ID instance
- reschedule-type: Gunakan salah satu dari IMMEDIATE, NEXT_AVAILABLE_WINDOW, atau
SPECIFIC_TIME.
Jika Anda memilih NEXT_AVAILABLE_WINDOW, pemeliharaan dijadwalkan ulang ke masa pemeliharaan berikutnya yang tersedia.
Metode HTTP dan URL:
POST https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/rescheduleMaintenance
Meminta isi JSON:
{ "reschedule": { "reschedule_type": "reschedule-type" } }
Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:
Anda akan melihat respons JSON seperti berikut:
{ "kind": "sql#operation", "targetLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id", "status": "PENDING", "user": "user@example.com", "insertTime": "2020-01-16T02:32:12.281Z", "startTime": "08:00", "endTime": "08:01", "operationType": RESCHEDULE_MAINTENANCE, "name": "operation-id", "targetId": "instance-id", "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id", "targetProject": "project-id" }
REST v1beta4
Sebelum menggunakan salah satu dari data permintaan, lakukan penggantian berikut:
- project-id: ID project
- instance-id: ID instance
- reschedule-type: Gunakan salah satu dari IMMEDIATE, NEXT_AVAILABLE_WINDOW, atau
SPECIFIC_TIME.
Jika Anda memilih NEXT_AVAILABLE_WINDOW, pemeliharaan dijadwalkan ulang ke masa pemeliharaan berikutnya yang tersedia.
Metode HTTP dan URL:
POST https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/rescheduleMaintenance
Meminta isi JSON:
{ "reschedule": { "reschedule_type": "reschedule-type" } }
Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:
Anda akan melihat respons JSON seperti berikut:
{ "kind": "sql#operation", "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id", "status": "PENDING", "user": "user@example.com", "insertTime": "2020-01-16T02:32:12.281Z", "startTime": "08:00", "endTime": "08:01", "operationType": RESCHEDULE_MAINTENANCE, "name": "operation-id", "targetId": "instance-id", "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id", "targetProject": "project-id" }
Untuk melihat cara permintaan REST API yang mendasarinya dibuat untuk tugas ini, lihat APIs Explorer pada halaman instances:post.
Mengonfigurasi periode penolakan pemeliharaan
Anda dapat mengonfigurasi maksimum satu periode penolakan pemeliharaan instance Cloud SQL pada waktu tertentu. Periode penolakan pemeliharaan lebih diutamakan daripada masa pemeliharaan terjadwal. Jika ada konflik antara waktu masa pemeliharaan dan periode penolakan pemeliharaan, periode penolakan pemeliharaan akan menggantikan masa pemeliharaan.
Anda dapat menghapus periode penolakan pemeliharaan secara manual, baik saat sudah terjadi maupun belum terjadi.
Untuk mengonfigurasi periode penolakan pemeliharaan, tetapkan tanggal mulai, tanggal akhir, dan waktu saat interval dimulai dan berakhir. Periode penolakan pemeliharaan dapat berkisar dari satu hingga 90 hari.
Untuk tanggal mulai dan tanggal akhir, ada dua format:
yyyy-mm-dd
: menunjukkan tanggal tertentumm-dd
: menunjukkan tanggal yang berulang setiap tahun
Tanggal mulai dan tanggal akhir menggunakan zona waktu UTC. Untuk menetapkan zona waktu, gunakan kolom waktu untuk menyesuaikan waktu mulai. Misalnya, tanggal mulai = 2020-10-10 dan waktu = 07.00.00 menunjukkan waktu mulai 2020-10-10 07.00.00 UTC (2020-10-10 00.00.00 PST)
Untuk waktu, formatnya adalah: HH:mm:SS
.
- Jam memiliki rentang antara 0 dan 23 (inklusif).
- Menit dan detik memiliki rentang antara 0 dan 59 (inklusif).
Konsol
-
Di konsol Google Cloud, buka halaman Instance Cloud SQL.
- Untuk membuka halaman Ringkasan sebuah instance, klik nama instance.
- Di bagian Pemeliharaan, klik Edit preferensi pemeliharaan.
- Di bagian Tolak periode pemeliharaan, tetapkan tanggal mulai dan akhir.
- Di bagian Opsi lanjutan, Anda juga dapat memilih Ulangi setiap tahun.
- Klik Save.
gcloud
Sebelum menggunakan perintah gcloud
di bawah ini, buat pengganti
berikut:
- instance-id: id instance Cloud SQL
- start-date: Tanggal saat interval dimulai. Misalnya, 2021-11-29
- end-date: Tanggal saat interval berakhir. Misalnya, 2021-12-02
- time: Waktu untuk memulai dan mengakhiri interval. Misalnya, 00.00.00
gcloud sql instances patch instance-id\ --deny-maintenance-period-start-date=start-date \ --deny-maintenance-period-end-date=end-date \ --deny-maintenance-period-time=time
REST v1
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- project-id: ID project
- instance-id: ID instance
- start-date: Tanggal mulai (tttt-bb-hh) atau (bb-hh) untuk pengulangan tahunan
- end-date: Tanggal akhir (tttt-bb-hh) atau (bb-hh) untuk pengulangan tahunan
- time: Waktu mulai dan berakhir (JJ.mm.DD)
Metode HTTP dan URL:
POST https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id
Meminta isi JSON:
{ "settings": { "denyMaintenancePeriods": [{ "start_date": "start-date", "end_date": "end-date" "time": "time" }] } }
Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:
Anda akan melihat respons JSON seperti berikut:
{ "kind": "sql#operation", "targetLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id", "status": "PENDING", "user": "user@example.com", "insertTime": "2020-01-16T02:32:12.281Z", "startTime": "08:00", "endTime": "08:01", "operationType": MAINTENANCE_DENY_PERIOD, "name": "operation-id", "targetId": "instance-id", "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id", "targetProject": "project-id" }
REST v1beta4
Sebelum menggunakan salah satu dari data permintaan, lakukan penggantian berikut:
- project-id: ID project
- instance-id: ID instance
- start-date: Tanggal mulai (tttt-bb-hh) atau (bb-hh) untuk pengulangan tahunan
- end-date: Tanggal akhir (tttt-bb-hh) atau (bb-hh) untuk pengulangan tahunan
- time: Waktu mulai dan berakhir (JJ.mm.DD)
Metode HTTP dan URL:
POST https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id
Meminta isi JSON:
{ "settings": { "denyMaintenancePeriods": [{ "start_date": "start-date", "end_date": "end-date" "time": "time" }] } }
Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:
Anda akan melihat respons JSON seperti berikut:
{ "kind": "sql#operation", "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id", "status": "PENDING", "user": "user@example.com", "insertTime": "2020-01-16T02:32:12.281Z", "startTime": "08:00", "endTime": "08:01", "operationType": MAINTENANCE_DENY_PERIOD, "name": "operation-id", "targetId": "instance-id", "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id", "targetProject": "project-id" }
Menghapus periode penolakan pemeliharaan
Konsol
-
Di konsol Google Cloud, buka halaman Instance Cloud SQL.
- Untuk membuka halaman Ringkasan sebuah instance, klik nama instance.
- Di bagian Pemeliharaan, klik Edit preferensi pemeliharaan.
- Di bagian Tolak periode pemeliharaan, klik Hapus.
- Klik Save.
gcloud
Sebelum menggunakan perintah gcloud
di bawah ini, lakukan beberapa penggantian
berikut:
- instance-id: id instance Cloud SQL
gcloud sql instances patch instance-id \ --remove-deny-maintenance-period
REST v1
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- project-id: ID project
- instance-id: ID instance
Metode HTTP dan URL:
POST https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id
Meminta isi JSON:
{ "settings": { "denyMaintenancePeriods": [] } }
Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:
Anda akan melihat respons JSON seperti berikut:
{ "kind": "sql#operation", "targetLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id", "status": "PENDING", "user": "user@example.com", "insertTime": "2020-01-16T02:32:12.281Z", "startTime": "08:00", "endTime": "08:01", "operationType": MAINTENANCE_DENY_PERIOD, "name": "operation-id", "targetId": "instance-id", "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id", "targetProject": "project-id" }
REST v1beta4
Sebelum menggunakan salah satu dari data permintaan, lakukan penggantian berikut:
- project-id: ID project
- instance-id: ID instance
Metode HTTP dan URL:
POST https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id
Meminta isi JSON:
{ "settings": { "denyMaintenancePeriods": [] } }
Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:
Anda akan menerima respons JSON yang mirip seperti berikut ini:
{ "kind": "sql#operation", "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id", "status": "PENDING", "user": "user@example.com", "insertTime": "2020-01-16T02:32:12.281Z", "startTime": "08:00", "endTime": "08:01", "operationType": MAINTENANCE_DENY_PERIOD, "name": "operation-id", "targetId": "instance-id", "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id", "targetProject": "project-id" }
Menolak notifikasi masa pemeliharaan
Notifikasi Masa Pemeliharaan tidak dikirim saat waktu pemeliharaan yang direncanakan berada dalam periode penolakan pemeliharaan dan dilarang oleh setelan periode penolakan pemeliharaan.
Jika Anda mengubah setelan periode penolakan pemeliharaan untuk mencegah pemeliharaan pada waktu yang telah dijadwalkan sebelumnya, instance Cloud SQL akan melewati pemeliharaan dan mengirimkan notifikasi tentang pembatalan pemeliharaan. Cloud SQL mengirimkan pemberitahuan pembatalan ini setiap kali instance dijadwalkan untuk update.
Notifikasi pemeliharaan terencana dikirim selama periode penolakan pemeliharaan dengan ketentuan bahwa pemeliharaan dijadwalkan di luar periode tersebut.
Langkah selanjutnya
- Memulai, menghentikan, dan memulai ulang instance
- Pelajari lebih lanjut periode penolakan pemeliharaan