ハンズオン(簡易版): S3基礎 ライフサイクル

2.1. S3ライフサイクルドキュメントの作成

目的

S3バケットライフサイクルドキュメント"${HOME}/environment/conf-handson-cli-s3-lifecycle/handson-cli-s3-lifecycle-lifecycle-XXXXXXXXXXXX-s3-bucket-lifecycle.json"を作成します。

パラメータの指定

作業に必要なパラメータを変数に格納をします。

1. S3バケット名

S3バケット名を指定します。

変数の設定:

S3_BUCKET_PREFIX='handson-cli-s3-lifecycle-lifecycle'

コマンド:

AWS_ID=$( \
  aws sts get-caller-identity \
    --query 'Account' \
    --output text \
) \
  && echo ${AWS_ID}

結果(例):

XXXXXXXXXXXX

変数の設定:

S3_BUCKET_NAME="${S3_BUCKET_PREFIX}-${AWS_ID}" \
  && echo ${S3_BUCKET_NAME}

結果(例):

handson-cli-s3-lifecycle-lifecycle-XXXXXXXXXXXX

2. S3ライフサイクルドキュメント用ディレクトリ

S3ライフサイクルドキュメント用ディレクトリを指定します。

変数の設定:

DIR_S3_BUCKET_LIFECYCLE_DOC="${HOME}/environment/conf-handson-cli-s3-lifecycle"

ディレクトリが存在することを確認します。

コマンド:

ls -d ${HOME}/environment/conf-handson-cli-s3-lifecycle

結果(例:存在する場合):

${HOME}/environment/conf-handson-cli-s3-lifecycle

存在しない場合は作成します。

コマンド:

mkdir -p ${HOME}/environment/conf-handson-cli-s3-lifecycle

3. S3ライフサイクルドキュメントファイル名

S3ライフサイクルドキュメントファイル名を指定します。

変数の設定:

FILE_S3_BUCKET_LIFECYCLE_DOC="${DIR_S3_BUCKET_LIFECYCLE_DOC}/${S3_BUCKET_NAME}-s3-bucket-lifecycle.json" \
  && echo ${FILE_S3_BUCKET_LIFECYCLE_DOC}

結果(例):

${HOME}/environment/conf-handson-cli-s3-lifecycle/handson-cli-s3-lifecycle-lifecycle-XXXXXXXXXXXX-s3-bucket-lifecycle.json

各変数に正しいパラメータ値が格納されていることを確認します。

変数の確認:

cat << END

  # 0.1. S3_BUCKET_NAME:"handson-cli-s3-lifecycle-lifecycle-XXXXXXXXXXXX"
         S3_BUCKET_NAME="${S3_BUCKET_NAME}"
  # 0.2. DIR_S3_BUCKET_LIFECYCLE_DOC:"${HOME}/environment/conf-handson-cli-s3-lifecycle"
         DIR_S3_BUCKET_LIFECYCLE_DOC="${DIR_S3_BUCKET_LIFECYCLE_DOC}"
  # 0.3. FILE_S3_BUCKET_LIFECYCLE_DOC:"${HOME}/environment/conf-handson-cli-s3-lifecycle/handson-cli-s3-lifecycle-lifecycle-XXXXXXXXXXXX-s3-bucket-lifecycle.json"
         FILE_S3_BUCKET_LIFECYCLE_DOC="${FILE_S3_BUCKET_LIFECYCLE_DOC}"

END

手順

S3ライフサイクルドキュメントを作成します。

変数の確認:

cat << ETX

  # FILE_S3_BUCKET_LIFECYCLE_DOC:"${HOME}/environment/conf-handson-cli-s3-lifecycle/handson-cli-s3-lifecycle-lifecycle-XXXXXXXXXXXX-s3-bucket-lifecycle.json"
    FILE_S3_BUCKET_LIFECYCLE_DOC="${FILE_S3_BUCKET_LIFECYCLE_DOC}"

ETX

コマンド:

cat << EOF > ${FILE_S3_BUCKET_LIFECYCLE_DOC}
{
  "Rules": [
    {
      "ID": "temporary-objects",
      "Filter": {
        "Prefix": "tmp/"
      },
      "Status": "Enabled",
      "Expiration": {
        "Days": 1
      }
    },
    {
      "ID": "archive-objects",
      "Filter": {
        "Prefix": "archive/"
      },
      "Status": "Enabled",
      "Transitions": [
        {
          "Days": 0,
          "StorageClass": "GLACIER"
        }
      ],
      "Expiration": {
        "Days": 1
      }
    },
    {
      "ID": "short-keep-objects",
      "Filter": {
        "Prefix": "logs/"
      },
      "Status": "Enabled",
      "Transitions": [
        {
          "Days": 30,
          "StorageClass": "STANDARD_IA"
        },
        {
          "Days": 60,
          "StorageClass": "INTELLIGENT_TIERING"
        },
        {
          "Days": 90,
          "StorageClass": "ONEZONE_IA"
        },
        {
          "Days": 120,
          "StorageClass": "GLACIER"
        },
        {
          "Days": 210,
          "StorageClass": "DEEP_ARCHIVE"
        }
      ],
      "Expiration": {
        "Days": 211
      }
    }
  ]
}
EOF

cat ${FILE_S3_BUCKET_LIFECYCLE_DOC}

結果(例):

{
  "Rules": [
    {
      "ID": "temporary-objects",
      "Filter": {
        "Prefix": "tmp/"
      },
      "Status": "Enabled",
      "Expiration": {
        "Days": 1
      }
    },
    {
      "ID": "archive-objects",
      "Filter": {
        "Prefix": "archive/"
      },
      "Status": "Enabled",
      "Transition": {
        "Days": 0,
        "StorageClass": "GLACIER"
      },
      "Expiration": {
        "Days": 1
      }
    },
    {
      "ID": "short-keep-objects",
      "Filter": {
        "Prefix": "logs/"
      },
      "Status": "Enabled",
      "Transitions": [
        {
          "Days": 30,
          "StorageClass": "STANDARD_IA"
        },
        {
          "Days": 60,
          "StorageClass": "INTELLIGENT_TIERING"
        },
        {
          "Days": 90,
          "StorageClass": "ONEZONE_IA"
        },
        {
          "Days": 120,
          "StorageClass": "GLACIER"
        },
        {
          "Days": 210,
          "StorageClass": "DEEP_ARCHIVE"
        },
      ],
      "Expiration": {
        "Days": 211
      }
    }
  ]
}

コマンド:

cat ${FILE_S3_BUCKET_LIFECYCLE_DOC} \
  |  python3 -m json.tool \
  > /dev/null

結果(例):

(出力なし)

完了確認

「ライフサイクルキュメントファイル"${HOME}/environment/conf-handson-cli-s3-lifecycle/handson-cli-s3-lifecycle-lifecycle-XXXXXXXXXXXX-s3-bucket-lifecycle.json"が存在する。」ことを確認します。

コマンド:

ls ${FILE_S3_BUCKET_LIFECYCLE_DOC}

結果(例):

${HOME}/environment/conf-handson-cli-s3-lifecycle/handson-cli-s3-lifecycle-lifecycle-XXXXXXXXXXXX-s3-bucket-lifecycle.json