はじめに

この記事は、前回AWS CLIを使用して作成したRDSインスタンスの続きとなります。

AWS CLIを使用すると、Amazon RDSのデータベース（DB）エンジンを簡単にバージョンアップすることが可能です！

未来の自分への備忘録として体系的に整理していますが、この記事が誰かの技術の支えになれば幸いです！

知識整理

今回解説するRDSやその操作については、以下の記事で詳しくまとめています。興味のある方はぜひ参考にしてください。

前提条件

AWS CLIがインストール済みで、初期セットアップが完了していることを前提に進めます。

この記事では、以下のイメージで、前回作成したRDSインスタンスを手動操作ではなくコマンドラインでバージョンアップしていきます！

引用画像：https://qiita.com/kokichi8/items/834ca1f26e80fe264733

AWS CLIのインストール手順やセットアップについては、過去の記事を参考にしてみてください！

また、今回の記事ではrootユーザーで技術検証を行っていますが、IAMユーザーで作業する場合は、IAMポリシーに「AmazonRDSFullAccess」または同等の権限が付与されていることを確認してください。

IAMポリシーの設定手順については、上記の記事をご参考ください！

補足事項

バージョンアップを行う前に、以下の点を確認してください。

RDSインスタンスが停止していない（available状態である）こと。
アップグレード対象のDBエンジンが互換性を持つこと（互換性リストを確認してください）。

さらに、事前にスナップショットやバックアップを取得することを強く推奨します！

実際にバージョンアップしてみた

バージョンアップ前の確認

以下のコマンドで、現在のDBエンジンバージョンを確認します。

aws rds describe-db-instances \
    --db-instance-identifier <your-db-instance-identifier> \
    --query "DBInstances[0].EngineVersion" \
    --output text

your-db-instance-identifierの部分は、実際のRDSのインスタンス名に置き換えてください！

現在のDBエンジンバージョンを確認した際の出力例は以下の通りです。

8.0.39

次に、アップグレード可能なDBエンジンバージョンを確認します。

aws rds describe-db-engine-versions \
    --engine mysql \
    --query "DBEngineVersions[].EngineVersion"

以下は、利用可能なDBエンジンバージョンの出力例です。

[
    "5.7.44",
    "5.7.44-rds.20240408",
    "5.7.44-rds.20240529",
    "5.7.44-rds.20240808",
    "8.0.32",
    "8.0.33",
    "8.0.34",
    "8.0.35",
    "8.0.36",
    "8.0.37",
    "8.0.39",
    "8.0.40",
    "8.4.3"
]

今回の技術検証では、8.0.40 へのメジャーバージョンアップを行います。

バージョンアップ前の状態では、マネジメントコンソール上で「8.0.39」であることが確認できました。

DBバージョンアップ

以下のコマンドを使用して、指定したバージョンにアップグレードを実行します。

aws rds modify-db-instance \
    --db-instance-identifier <your-db-instance-identifier> \
    --engine-version <target-engine-version> \
    --apply-immediately

パラメータ説明

--db-instance-identifier: アップグレード対象のRDSインスタンス名
--engine-version: アップグレードするDBエンジンのバージョン（例: 8.0.30）
--apply-immediately: trueにすると即時適用、falseの場合は次回のメンテナンスウィンドウに適用

アップグレードが進行中であるか確認するには、以下のコマンドを実行します。

aws rds describe-db-instances \
    --db-instance-identifier <your-db-instance-identifier> \
    --query "DBInstances[0].DBInstanceStatus"

実際の出力例は以下になります。

"upgrading"

DBInstanceStatusがavailableに戻れば、アップグレード完了です！

バージョンアップ後の確認

アップグレードが成功したかどうかを確認するには、以下のコマンドを実行してください。

aws rds describe-db-instances \
    --db-instance-identifier <your-db-instance-identifier> \
    --query "DBInstances[0].EngineVersion" \
    --output text

ターミナル上で、以下のように出力されていることを確認しました。

8.0.40

また、マネジメントコンソール上でもバージョンが正常に 8.0.40 に更新されていることを確認できました！

RDSインスタンスのステータスが「利用可能」と表示されていることも確認できました。これにより、検証は大成功です！

まとめ

AWS CLIを使用して、RDSインスタンス（MySQL）のバージョンアップ手順を解説しました。

基本的な手順を説明しましたが、IDや設定値を適切に修正すれば、そのままハンズオン形式で実践できる内容です。ぜひ試してみてください！

この記事が、どなたかの技術的な支えになれば幸いです。

関連記事