RDS+ECSで定期的にダンプをS3に保存してみる

概要#

AWS にて RDS の定期ダンプを取得したかったので ECS にある cron 的な機能を使ってダンプを定期取得する設定をしてみた
ECS で動かす定期実行用のコンテナのイメージやタスクも管理を自動化してみた
今回 postgres が対象です mysql 等は適宜 dockerfile を変更してください

前提条件#

AWS のアカウント取得済み
RDS 構築済み
bitbucket のアカウント取得済み

準備#

IAM ユーザーの作成#

今回 bitbucket pipeline からのデプロイとダンプデータ S3 へのアップロード用にユーザーを作成する。
通常はデプロイと S3 でユーザーを分けた方がいいのだが今回は管理コストの面で一つで作成します。

IAM を開き左メニューにあるユーザーを開くその後ユーザーの追加を開くと下記の様な画面になる
ユーザー名を適宜入力,アクセスの種類をプログラムによるアクセスに制限

console.aws.amazon.com_iam_home_.png

AmazonECS_FullAccess, AmazonEC2ContainerRegistryFullAccess, AmazonS3FullAccessを選択(今回 CLI で同一ユーザーを使いたかったので広に権限取ってあります。わかる人は適宜絞ってください。)

console.aws.amazon.com_iam_home_ (1).png

その後特に設定項目はないのでユーザーの作成まで進む
最後にこのような画面が表示されるのでアクセスキー ID とシークレットアクセスキーをメモしておいてください。シークレットアクセスキーに関しては追加発行できますが二度と再表示できないので絶対にメモしておいてください。

console.aws.amazon.com_iam_home_ (2).png

IAM ロールの作成#

タスクを実行するためのロールだが自動で作られるものではあるのだが ECS を全く使っていない場合は作成されていないので手動で作成する。
(ecsTaskExecutionRoleと最後に付くロールが既にある場合はその ARN をメモしておいてください)
IAM を開き左メニューにあるロールを開くその後ロールの作成を開くと下記の様な画面になる
Elastic Container Serviceを選択次にElastic Container Service Taskを選択次へ

console.aws.amazon.com_iam_home_region=ap-northeast-1 (1).png

AmazonECSTaskExecutionRolePolicyを選択その後特に設定項目はないのでロールの作成まで進む

console.aws.amazon.com_iam_home_region=ap-northeast-1 (2).png

作成が完了したら元の画面に戻ってくるので先ほど作成したロールを開く下記画面のロール ARNをメモしておいてください。

console.aws.amazon.com_iam_home_region=ap-northeast-1 (4).png

バケットの作成#

特別設定する項目はありません。適宜設定の上作成しておいてください。
その際作成した名前をメモしておいてください。

ECR リポジトリの作成#

こちらも特別設定する項目はありませんが、パイプラインでタグを上書きする関係上タグのイミュータビリティは無効化しておいてください(デフォルトで無効)
作成した後 URI のカラムにある URL みたいなものをメモしておいてください。

bitbucket でリポジトリの作成#

いつも通りリポジトリを作成してください。
ローカルで下記の通りファイルを作成してください。

1
~/
2
 ├ .pgpass
3
 ├ bitbucket-pipelines.yml
4
 ├ Dockerfile
5
 └ docker-entrypoint.sh

.pgpass は postgres にパスワードを省略してアクセスするためのパスワードファイルですダ下記の通り記述してください。

1
hostname:port:database:username:password

bitbucket-pipelines.yml は bitbucket のパイプラインの定義を記述するファイルです下記の通り記述してください。
execution-role-arn のところに先ほどメモしたロール ARNを記入してください。

1
# enable Docker for your repository
2
options:
3
  docker: true
4

5
pipelines:
6
  default:
7
    - step:
8
        name: build-push
9
        image: atlassian/pipelines-awscli:latest
10
        deployment: test
11
        caches:
12
          - docker
13
        script:
14
          # aws login
15
          - eval $(aws ecr get-login --no-include-email --region ${AWS_DEFAULT_REGION})
16
          # docker
17
          - export BUILD_ID=$BITBUCKET_BRANCH_$BITBUCKET_COMMIT_$BITBUCKET_BUILD_NUMBER
18
          - docker build -t ${AWS_REGISTRY_URL}:$BUILD_ID -t ${AWS_REGISTRY_URL}:development .
19
          - docker push ${AWS_REGISTRY_URL}
20

21
    - step:
22
        name: deploy
23
        image: atlassian/pipelines-awscli:latest
24
        deployment: production
25
        script:
26
          - export BUILD_ID=$BITBUCKET_BRANCH_$BITBUCKET_COMMIT_$BITBUCKET_BUILD_NUMBER
27
          - export IMAGE_NAME="${AWS_REGISTRY_URL}:$BUILD_ID"
28
          # ECS variables
29
          - export ECS_CLUSTER_NAME="${BITBUCKET_REPO_OWNER}"
30
          - export ECS_SERVICE_NAME="${BITBUCKET_REPO_SLUG}"
31
          - export ECS_TASK_NAME="${BITBUCKET_REPO_SLUG}"
32
          # Create ECS cluster, task, service
33
          - aws ecs list-clusters | grep "${ECS_CLUSTER_NAME}" || aws ecs create-cluster --cluster-name "${ECS_CLUSTER_NAME}"
34
          # Updating the existing cluster, task, service
35
          - export TASK_VERSION=$(aws ecs register-task-definition
36
            --family "${ECS_TASK_NAME}"
37
            --execution-role-arn ""
38
            --network-mode "awsvpc"
39
            --requires-compatibilities "FARGATE"
40
            --cpu "256"
41
            --memory "512"
42
            --container-definitions "[{\"name\":\"${ECS_TASK_NAME}\",\"image\":\"${IMAGE_NAME}\",\"logConfiguration\":{\"logDriver\":\"awslogs\",\"options\":{\"awslogs-group\":\"/ecs\",\"awslogs-region\":\"${AWS_DEFAULT_REGION}\",\"awslogs-stream-prefix\":\"${ECS_TASK_NAME}\"}}}]"
43
            | jq --raw-output '.taskDefinition.revision')
44
          - echo "Registered ECS Task Definition:" "${TASK_VERSION}"

Dockerfile は ECS でデプロイする用のコンテナ定義です下記の通り記述してください。
補足がある箇所は先ほどメモしたものから適宜いれてください。

1
FROM alpine
2

3
RUN apk --no-cache add postgresql-client python3
4
RUN pip3 install awscli
5
ENV AWS_DEFAULT_REGION ap-northeast-1
6
ENV AWS_ACCESS_KEY_ID {アクセスキーID}
7
ENV AWS_SECRET_ACCESS_KEY {シークレットアクセスキー}
8
RUN mkdir dump
9
WORKDIR /root/dump
10
ADD .pgpass /root/.pgpass
11
RUN chmod 0600 /root/.pgpass
12
ADD docker-entrypoint.sh /root/docker-entrypoint.sh
13
RUN chmod +x /root/docker-entrypoint.sh
14

15
CMD ["/root/docker-entrypoint.sh"]

docker-entrypoint.sh は docker 起動時に実行するコマンド群ですいわゆる cron の中身です。
補足がある箇所は先ほどメモしたものから適宜いれてください。
保存構成的には最初のプレフィックスが削除周期次に DB 名最後にファイルの接頭辞が今回はダンプの周期を入れています。

1
#!/bin/sh
2

3
mkdir -p yearly/{DB名}
4
pg_dump -Fc -h {DBのホスト} -U {ユーザー} {DB名} > yearly/{DB名}/weekly-`date "+%Y%m%d_%H%M%S"`.custom
5
aws s3 sync . s3://{S3のバケット}