Pembaruan perangkat lunak layanan di Amazon OpenSearch Service

Amazon OpenSearch Service secara teratur merilis pembaruan perangkat lunak layanan yang menambahkan fitur atau meningkatkan domain Anda. Panel Notifikasi di konsol adalah cara termudah untuk melihat apakah pembaruan tersedia atau untuk memeriksa status pembaruan. Setiap notifikasi menyertakan detail tentang pembaruan perangkat lunak layanan. Semua pembaruan perangkat lunak layanan menggunakan penerapan biru/hijau untuk meminimalkan waktu henti.

Pembaruan perangkat lunak layanan berbeda dari peningkatan OpenSearch versi. Untuk informasi tentang memutakhirkan ke versi yang lebih baru OpenSearch, lihatMemutakhirkan domain OpenSearch Layanan Amazon.

Pembaruan opsional versus yang diperlukan

OpenSearch Layanan memiliki dua kategori pembaruan perangkat lunak layanan yang luas:

Pembaruan opsional

Pembaruan perangkat lunak layanan opsional umumnya mencakup peningkatan dan dukungan untuk fitur atau fungsionalitas baru. Pembaruan opsional tidak diberlakukan pada domain Anda, dan tidak ada tenggat waktu yang sulit untuk menginstalnya. Ketersediaan pembaruan dikomunikasikan melalui email dan pemberitahuan konsol. Anda dapat memilih untuk segera menerapkan pembaruan atau menjadwal ulang untuk tanggal dan waktu yang lebih tepat. Anda juga dapat menjadwalkannya selama jendela off-peak domain. Sebagian besar pembaruan perangkat lunak bersifat opsional.

Terlepas dari apakah Anda menjadwalkan pembaruan atau tidak, jika Anda membuat perubahan pada domain yang menyebabkan penyebaran biru/hijau, OpenSearch Layanan secara otomatis memperbarui perangkat lunak layanan Anda untuk Anda.

Anda dapat mengonfigurasi domain Anda untuk menerapkan pembaruan opsional secara otomatis selama jam sibuk. Ketika opsi ini diaktifkan, OpenSearch Layanan menunggu setidaknya 13 hari sejak pembaruan opsional tersedia dan kemudian menjadwalkan pembaruan setelah 72 jam (tiga hari). Anda menerima pemberitahuan konsol saat pembaruan dijadwalkan dan Anda dapat memilih untuk menjadwal ulang untuk kemudian hari.

Untuk mengaktifkan pembaruan perangkat lunak otomatis, pilih Aktifkan pembaruan perangkat lunak otomatis saat Anda membuat atau memperbarui domain Anda. Untuk mengonfigurasi pengaturan yang sama menggunakan AWS CLI, atur --software-update-options ke true saat Anda membuat atau memperbarui domain Anda.

Pembaruan yang diperlukan

Pembaruan perangkat lunak layanan yang diperlukan umumnya mencakup perbaikan keamanan penting atau pembaruan wajib lainnya untuk memastikan integritas dan fungsionalitas domain Anda yang berkelanjutan. Contoh pembaruan yang diperlukan adalah Log4j Common Vulnerabilities and Exposures (CVE) dan penegakan Instance Metadata Service Version 2 (IMDSv2). Jumlah pembaruan wajib dalam setahun biasanya kurang dari tiga.

OpenSearch Layanan secara otomatis menjadwalkan pembaruan ini dan memberi tahu Anda 72 jam (tiga hari) sebelum pembaruan yang dijadwalkan melalui email dan pemberitahuan konsol. Anda dapat memilih untuk segera menerapkan pembaruan atau menjadwalkannya kembali untuk tanggal dan waktu yang lebih tepat dalam jangka waktu yang diizinkan. Anda juga dapat menjadwalkannya selama jendela off-peak domain berikutnya. Jika Anda tidak mengambil tindakan pada pembaruan yang diperlukan dan Anda tidak membuat perubahan domain apa pun yang menyebabkan penyebaran biru/hijau, OpenSearch Layanan dapat memulai pembaruan kapan saja di luar batas waktu yang ditentukan (biasanya 14 hari sejak ketersediaan), di dalam jendela luar puncak domain.

Terlepas dari kapan pembaruan dijadwalkan, jika Anda membuat perubahan pada domain yang menyebabkan penyebaran biru/hijau, OpenSearch Layanan secara otomatis memperbarui domain Anda untuk Anda.

Pembaruan tambalan

Versi perangkat lunak layanan yang diakhiri dengan “-P” dan angka, seperti R20211203- P4, adalah rilis patch. Patch cenderung mencakup peningkatan kinerja, perbaikan bug kecil, dan perbaikan keamanan atau perbaikan postur. Rilis patch tidak menyertakan fitur baru atau perubahan yang melanggar, dan umumnya tidak memiliki dampak langsung atau nyata pada pengguna. Pemberitahuan perangkat lunak layanan memberi tahu Anda jika rilis patch bersifat opsional atau wajib.

Pertimbangan

Pertimbangkan hal berikut saat memutuskan apakah akan memperbarui domain Anda:

Memulai pembaruan perangkat lunak layanan

Anda dapat meminta pembaruan perangkat lunak layanan melalui konsol OpenSearch Layanan AWS CLI, atau salah satu SDK.

aws opensearch start-service-software-update \
  --domain-name my-domain \
  --schedule-at "NOW"

{
    "ServiceSoftwareOptions": {
        "CurrentVersion": "R20220928-P1",
        "NewVersion": "R20220928-P2",
        "UpdateAvailable": true,
        "Cancellable": true,
        "UpdateStatus": "PENDING_UPDATE",
        "Description": "",
        "AutomatedUpdateDate": "1969-12-31T16:00:00-08:00",
        "OptionalDeployment": true
    }
}

import boto3
from botocore.config import Config
import time

# Build the client using the default credential configuration.
# You can use the CLI and run 'aws configure' to set access key, secret
# key, and default region.

my_config = Config(
    # Optionally lets you specify a Region other than your default.
    region_name='us-east-1'
)

domain_name = ''  # The name of the domain to check and update

client = boto3.client('opensearch', config=my_config)


def getUpdateStatus(client):
    """Determines whether the domain is eligible for an update"""
    response = client.describe_domain(
        DomainName=domain_name
    )
    sso = response['DomainStatus']['ServiceSoftwareOptions']
    if sso['UpdateStatus'] == 'ELIGIBLE':
        print('Domain [' + domain_name + '] is eligible for a service software update from version ' +
              sso['CurrentVersion'] + ' to version ' + sso['NewVersion'])
        updateDomain(client)
    else:
        print('Domain is not eligible for an update at this time.')


def updateDomain(client):
    """Starts a service software update for the eligible domain"""
    response = client.start_service_software_update(
        DomainName=domain_name
    )
    print('Updating domain [' + domain_name + '] to version ' +
          response['ServiceSoftwareOptions']['NewVersion'] + '...')
    waitForUpdate(client)


def waitForUpdate(client):
    """Waits for the domain to finish updating"""
    response = client.describe_domain(
        DomainName=domain_name
    )
    status = response['DomainStatus']['ServiceSoftwareOptions']['UpdateStatus']
    if status == 'PENDING_UPDATE' or status == 'IN_PROGRESS':
        time.sleep(30)
        waitForUpdate(client)
    elif status == 'COMPLETED':
        print('Domain [' + domain_name +
              '] successfully updated to the latest software version')
    else:
        print('Domain is not currently being updated.')

def main():
    getUpdateStatus(client)

Menjadwalkan pembaruan perangkat lunak selama jendela off-peak

Setiap domain OpenSearch Layanan yang dibuat setelah 16 Februari 2023 memiliki jendela 10 jam harian antara pukul 22:00 dan 8:00 pagi waktu setempat yang kami anggap sebagai jendela off-peak. OpenSearch Layanan menggunakan jendela ini untuk menjadwalkan pembaruan perangkat lunak layanan untuk domain. Pembaruan off-peak membantu meminimalkan ketegangan pada node master khusus cluster selama periode lalu lintas yang lebih tinggi. OpenSearch Layanan tidak dapat memulai pembaruan di luar jendela 10 jam ini tanpa persetujuan Anda.

Untuk setiap domain, Anda dapat memilih untuk mengganti waktu mulai 10:00 P.M. default dengan waktu khusus. Untuk petunjuk, lihat Mengonfigurasi jendela off-peak khusus.

aws opensearch start-service-software-update \
  --domain-name my-domain \
  --schedule-at "OFF_PEAK_WINDOW"

Pemantauan pembaruan perangkat lunak layanan

OpenSearch Layanan mengirimkan pemberitahuan ketika pembaruan perangkat lunak layanan tersedia, diperlukan, dimulai, selesai, atau gagal. Anda dapat melihat notifikasi ini di panel Notifikasi konsol OpenSearch Layanan. Kepelikan notifikasi adalah Informational jika pembaruan bersifat opsional dan High jika diperlukan.

OpenSearch Layanan juga mengirimkan acara perangkat lunak layanan ke Amazon EventBridge. Anda dapat menggunakan EventBridge untuk mengonfigurasi aturan yang mengirim email atau melakukan tindakan tertentu saat acara diterima. Untuk panduan contoh, lihat Tutorial: Mengirim peringatan Amazon SNS untuk pembaruan perangkat lunak yang tersedia.

Untuk melihat format setiap peristiwa perangkat lunak layanan yang dikirim ke Amazon EventBridge, lihatPeristiwa pembaruan perangkat lunak layanan.

Ketika domain tidak memenuhi syarat untuk pembaruan

Domain Anda tidak memenuhi syarat untuk pembaruan perangkat lunak layanan jika berada di salah satu status berikut: