Lightsail データベースのメジャーバージョンをアップグレードしてみた

Lightsail データベースのメジャーバージョンをアップグレードしてみた

2026.01.15

はじめに

テクニカルサポートの 片方 です。
Amazon Lightsail データベースのメジャーバージョンアップグレードについて検証する機会があったのでご紹介します。

注意点

メジャーバージョンのアップグレードは、以前のバージョンとの間にさまざまな非互換性を引き起こす可能性があります。
このような非互換性が原因でアップグレード中に問題が生じる可能性があります。アップグレードを成功させるには、データベースの準備が必要になる場合があります。データベースのメジャーバージョンのアップグレードについては、MySQL および PostgreSQL ウェブサイトの以下のトピックを参照してください。

やってみた

MySQL データベース 8.0.44 エンジン Ver を 8.4.7 へアップグレードしてみました。

0001

今回は、アップグレードをすぐに適用するために AWS CLI コマンド実行時に--apply-immediately パラメータを付与しています。
ドキュメント記載の手順を参考に実施します。

https://docs.aws.amazon.com/ja_jp/lightsail/latest/userguide/amazon-lightsail-upgrade-database-major-version.html

  1. Lightsail コンソール にサインインします。
  2. 左のナビゲーションペインの [データベース] を選択します。
  3. アップグレードするデータベースインスタンスの名前と AWS リージョンのメモをします。
  4. Lightsail コンソールの左下にある [CloudShell] アイコンを選択します。
  5. CloudShell プロンプトで以下の AWS CLI コマンドを入力して、使用可能なデータベースブループリント ID のリストを取得します。
$ aws lightsail get-relational-database-blueprints
AWS CLI コマンド実行例
$ aws lightsail get-relational-database-blueprints
{
    "blueprints": [
        {
            "blueprintId": "mysql_8_0",
            "engine": "mysql",
            "engineVersion": "8.0.44",
            "engineDescription": "MySQL Community Edition",
            "engineVersionDescription": "MySQL 8.0.44",
            "isEngineDefault": true
        },
        {
            "blueprintId": "mysql_8_4",
            "engine": "mysql",
            "engineVersion": "8.4.7",
            "engineDescription": "MySQL Community Edition",
            "engineVersionDescription": "MySQL 8.4.7",
            "isEngineDefault": false
        },
        {
            "blueprintId": "postgres_13",
            "engine": "postgres",
            "engineVersion": "13.23",
            "engineDescription": "PostgreSQL",
            "engineVersionDescription": "PostgreSQL 13.23-R2",
            "isEngineDefault": false
        },
        {
            "blueprintId": "postgres_14",
            "engine": "postgres",
            "engineVersion": "14.20",
            "engineDescription": "PostgreSQL",
            "engineVersionDescription": "PostgreSQL 14.20-R2",
            "isEngineDefault": false
        },
        {
            "blueprintId": "postgres_15",
            "engine": "postgres",
            "engineVersion": "15.15",
            "engineDescription": "PostgreSQL",
            "engineVersionDescription": "PostgreSQL 15.15-R1",
            "isEngineDefault": false
        },
        {
            "blueprintId": "postgres_16",
            "engine": "postgres",
            "engineVersion": "16.11",
            "engineDescription": "PostgreSQL",
            "engineVersionDescription": "PostgreSQL 16.11-R1",
            "isEngineDefault": false
        },
        {
            "blueprintId": "postgres_17",
            "engine": "postgres",
            "engineVersion": "17.7",
            "engineDescription": "PostgreSQL",
            "engineVersionDescription": "PostgreSQL 17.7-R1",
            "isEngineDefault": true
        },
        {
            "blueprintId": "postgres_18",
            "engine": "postgres",
            "engineVersion": "18.1",
            "engineDescription": "PostgreSQL",
            "engineVersionDescription": "PostgreSQL 18.1-R1",
            "isEngineDefault": false
        }
    ]
}
(END)
  1. アップグレード先のメジャーバージョンのブループリント ID (blueprintId) をメモします。例: mysql_8_4

本検証時点では、MySQL エンジンバージョン 8.4.7 が最新として確認できました。
こちらの エンジン Ver を対象にアップグレードします。

  1. データベースのメジャーバージョンをアップグレードするには、以下のコマンドを入力します。
aws lightsail update-relational-database \
 --relational-database-name DatabaseName \
 --relational-database-blueprint-id blueprintId \
 --region DatabaseRegion
  • DatabaseName : 対象データベースの名前
  • blueprintId : アップグレード先のメジャーバージョンのブループリント ID
  • DatabaseRegion : データベースが存在する AWS リージョン
AWS CLI コマンド実行例
{
    "operations": [
        {
            "id": "36f959ca-f278-4d73-a60e-a397d05146b2",
            "resourceName": "Database-2",
            "resourceType": "RelationalDatabase",
            "createdAt": "2026-01-15T02:09:45.026000+00:00",
            "location": {
                "availabilityZone": "ap-northeast-1a",
                "regionName": "ap-northeast-1"
            },
            "isTerminal": true,
            "operationDetails": "",
            "operationType": "UpdateRelationalDatabase",
            "status": "Succeeded",
            "statusChangedAt": "2026-01-15T02:09:47.615000+00:00"
        }
    ]
}

https://docs.aws.amazon.com/cli/latest/reference/lightsail/update-relational-database.html

※ アップグレードをすぐに適用するには、AWS CLI コマンドに --apply-immediately パラメータを含めます。
アップグレードの適用中にデータベースが使用できなくなります。

AWS CLI コマンド実行例
aws lightsail update-relational-database \
  --relational-database-name Database-1 \
  --relational-database-blueprint-id mysql_8_4 \
  --region ap-northeast-1 \
  --apply-immediately
  {
    "operations": [
        {
            "id": "f62947d1-9649-4e62-a00b-4cc5f5535a52",
            "resourceName": "Database-1",
            "resourceType": "RelationalDatabase",
            "createdAt": "2026-01-15T00:35:53.256000+00:00",
            "location": {
                "availabilityZone": "ap-northeast-1a",
                "regionName": "ap-northeast-1"
            "location": {
                "availabilityZone": "ap-northeast-1a",
                "regionName": "ap-northeast-1"
            },
            "isTerminal": true,
            "operationDetails": "",
            "operationType": "UpdateRelationalDatabase",
            "status": "Succeeded",
            "statusChangedAt": "2026-01-15T00:35:57.563000+00:00"
        }
    ]
}
~ $ 

今回は --apply-immediately パラメータを付与して実行しているため、アップグレード処理が即時開始されます。

0002

メジャーバージョンが正常にアップグレードされるまで暫く待ちます。
あくまで本検証環境 (データなし・小規模構成) での参考値ですが、完了までおよそ 60 分程度かかりました。

0003
0004

以下の通り、正常に完了しました。

0005

お疲れさまでした。

補足

AWS CLI コマンドに --apply-immediately パラメータを付与せず、次のメンテナンス期間中にアップグレードを実施した場合、以下の AWS CLI コマンドを入力してスケジュールされていることを確認可能です。

$ aws lightsail get-relational-database \
 --relational-database-name DatabaseName \
 --region DatabaseRegion

※ 一部マスクします

AWS CLI コマンド実行例
{
    "relationalDatabase": {
        "name": "Database-2",
        "arn": "arn:aws:lightsail:ap-northeast-1:1233456789012:RelationalDatabase/xxxxxxxx-583e-4b05-1234-123456789012",
        "supportCode": "69953xxxxxxx/ls-aa8be40c9c0541eb261fxxxxxxxxxxxxxxxxxxxx",
        "createdAt": "2026-01-15T01:46:34.587000+00:00",
        "location": {
            "availabilityZone": "ap-northeast-1a",
            "regionName": "ap-northeast-1"
        },
        "resourceType": "RelationalDatabase",
        "tags": [],
        "relationalDatabaseBlueprintId": "mysql_8_0",
        "relationalDatabaseBundleId": "micro_2_0",
        "masterDatabaseName": "dbmaster",
        "hardware": {
            "cpuCount": 2,
            "diskSizeInGb": 40,
            "ramSizeInGb": 1.0
        },
        "state": "available",
        "backupRetentionEnabled": true,
        "pendingModifiedValues": {
            "engineVersion": "8.4.7"
        },
        "engine": "mysql",
        "engineVersion": "8.0.44",
        "latestRestorableTime": "2026-01-15T02:10:00+00:00",
        "masterUsername": "dbmasteruser",
        "parameterApplyStatus": "in-sync",
        "preferredBackupWindow": "16:12-16:42",
        "preferredMaintenanceWindow": "sat:20:09-sat:20:39",
        "publiclyAccessible": false,
        "masterEndpoint": {
            "port": 3306,
            "address": "ls-aa8be40c9c0541eb261fxxxxxxxxxxxxxxxxxxxx.cbsqiic0idje.ap-northeast-1.rds.amazonaws.com"
        },
        "pendingMaintenanceActions": [],
        "caCertificateIdentifier": "rds-ca-rsa2048-g1"
    }
}
(END)

こちらの実行結果より、以下の日時 (UTC) で実行されること確認可能です。

  • "preferredMaintenanceWindow": "sat:20:09-sat:20:39"

https://docs.aws.amazon.com/lightsail/2016-11-28/api-reference/API_UpdateRelationalDatabase.html#Lightsail-Type-RelationalDatabase-preferredMaintenanceWindow

0006

まとめ

以下のように 2 つのパターンを確認することができました。

  • 次回のメンテナンス期間中の実行
  • AWS CLI コマンドに --apply-immediately パラメータを付与して即時実行

本ブログが誰かの参考になれば幸いです。

参考資料

クラスメソッドオペレーションズ株式会社について

クラスメソッドグループのオペレーション企業です。
運用・保守開発・サポート・情シス・バックオフィスの専門チームが、IT・AIをフル活用した「しくみ」を通じて、お客様の業務代行から課題解決や高付加価値サービスまでを提供するエキスパート集団です。
当社は様々な職種でメンバーを募集しています。
「オペレーション・エクセレンス」と「らしく働く、らしく生きる」を共に実現するカルチャー・しくみ・働き方にご興味がある方は、クラスメソッドオペレーションズ株式会社 コーポレートサイト をぜひご覧ください。※2026年1月 アノテーション㈱から社名変更しました

この記事をシェアする

FacebookHatena blogX

関連記事