AWS CodeBuildを使用してS3とAuroraを連携する手順ガイド

AWS CodeBuildは、ソフトウェアのビルドとテストを自動化する強力なツールです。このガイドでは、AWS CodeBuildを使用してS3にデプロイし、Auroraデータベースと連携する具体的な手順を紹介します。これにより、効率的な開発と運用が可能になります。

CodeBuildの基本設定

CodeBuildプロジェクトの作成

まず、AWS CodeBuildプロジェクトを作成します。AWSコンソールにログインし、CodeBuildサービスを選択します。「プロジェクトの作成」をクリックし、以下の情報を入力します。

• プロジェクト名: 任意の名前を設定します。
• ソースプロバイダー: GitHubやS3を選択可能です。ここではGitHubを使用します。
• ビルド環境: 適切なオペレーティングシステムとランタイムを選択します。例: Ubuntu、Standard:4.0。

ビルド仕様の設定

次に、buildspec.ymlファイルをプロジェクトのルートディレクトリに作成します。このファイルには、ビルドプロセス中に実行される指示が含まれています。

version: 0.2

phases:
  install:
    runtime-versions:
      nodejs: 12
    commands:
      - echo Installing dependencies...
      - npm install
  build:
    commands:
      - echo Building project...
      - npm run build
  post_build:
    commands:
      - echo Build completed!
artifacts:
  files:
    - '**/*'

この設定では、Node.jsの依存関係をインストールし、ビルドプロセスを実行します。ビルドが成功すると、成果物がアーカイブされます。

S3へのデプロイ

S3バケットの作成と設定

次に、ビルドされたアーティファクトを保存するためのS3バケットを作成します。AWSコンソールのS3セクションで「バケットの作成」を選択し、適切な設定を行います。

S3バケットに対するアクセス権を設定するため、IAMロールにS3への書き込み権限を付与します。以下はポリシーの一例です。

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "s3:PutObject",
            "Resource": "arn:aws:s3:::your-bucket-name/*"
        }
    ]
}

CodeBuildからS3へのアップロード

buildspec.ymlファイルのpost_buildフェーズにS3へのアップロードコマンドを追加します。

post_build:
  commands:
    - echo Uploading to S3...
    - aws s3 cp ./dist s3://your-bucket-name/ --recursive

これにより、ビルド完了後に成果物が指定のS3バケットにアップロードされます。

Auroraデータベースとの連携

Auroraの設定

AWS Auroraデータベースを作成し、接続情報を確認します。Auroraは高可用性とスケーラビリティを提供するリレーショナルデータベースサービスです。

接続には、CodeBuildプロジェクト内で使用するためのデータベース認証情報が必要です。これらの情報はAWS Secrets Managerに保存しておくと便利です。

ビルドプロセスでのデータベース操作

buildspec.ymlを編集して、Auroraデータベースへの接続と操作を行うスクリプトを追加します。例として、データベースのテーブルを作成する手順を示します。

build:
  commands:
    - echo Connecting to Aurora...
    - mysql -h your-db-endpoint -u your-username -p your-password -e "CREATE TABLE IF NOT EXISTS example (id INT PRIMARY KEY, data VARCHAR(100));"

これにより、ビルドプロセス中にデータベースへの接続と操作が自動化されます。

まとめ

この記事では、AWS CodeBuildを利用してS3とAuroraを連携する方法を紹介しました。CodeBuildのプロジェクト設定から、S3へのデプロイ、Auroraデータベースとの連携までの具体的な手順を示しました。これにより、開発と運用の効率化が図れるでしょう。AWSの各サービスを組み合わせることで、より強力で柔軟な自動化ワークフローを構築できます。ぜひ、この記事を参考にして、あなたのプロジェクトに役立ててください。