3.4. S3オブジェクトの更新アップロード (handson-cli-s3-versioning-XXXXXXXXXXXX)¶

目的¶

S3バケット"handson-cli-s3-versioning-XXXXXXXXXXXX"にファイルをアップロードします。

パラメータの指定¶

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

0. プロファイルの指定

AWS認証ファイルを指定します。

環境変数の設定:

export AWS_SHARED_CREDENTIALS_FILE="${HOME}/environment/credentials-handson-cli-s3-MaintUser/handson-cli-s3-MaintUser.ini"

プロファイルを指定します。

環境変数の設定:

export AWS_DEFAULT_PROFILE='handson-cli-s3-MaintUser'

1. 転送対象ファイル

転送対象ファイルを指定します。

変数の設定:

DIR_LOCAL="${HOME}/environment/local-handson-cli-s3"

変数の設定:

FILE_LOCAL="${DIR_LOCAL}/handson-cli-s3.txt" \
  && echo ${FILE_LOCAL}

結果(例):

${HOME}/environment/local-handson-cli-s3/handson-cli-s3.txt

2. S3バケット名

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

変数の設定:

S3_BUCKET_PREFIX='handson-cli-s3-versioning'

コマンド:

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-versioning-XXXXXXXXXXXX

3. S3オブジェクトキー

アップロードするファイルの保存先(オブジェクトキー)を指定します。

変数の設定:
S3_OBJECT_KEY='handson-cli-s3.txt'

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

変数の確認:

cat << END

  # 0. AWS_SHARED_CREDENTIALS_FILE:"${HOME}/environment/credentials-handson-cli-s3-MaintUser/handson-cli-s3-MaintUser.ini"
       AWS_SHARED_CREDENTIALS_FILE="${AWS_SHARED_CREDENTIALS_FILE}"
  #    AWS_DEFAULT_PROFILE:"handson-cli-s3-MaintUser"
       AWS_DEFAULT_PROFILE="${AWS_DEFAULT_PROFILE}"

  # 1. FILE_LOCAL:"${HOME}/environment/local-handson-cli-s3/handson-cli-s3.txt"
       FILE_LOCAL="${FILE_LOCAL}"
  # 2. S3_BUCKET_NAME:"handson-cli-s3-versioning-XXXXXXXXXXXX"
       S3_BUCKET_NAME="${S3_BUCKET_NAME}"
  # 3. S3_OBJECT_KEY:"handson-cli-s3.txt"
       S3_OBJECT_KEY="${S3_OBJECT_KEY}"

END

手順¶

オブジェクトのタイムスタンプを取得します。

コマンド:

S3_OBJECT_TIMESTAMP_BEFORE=$( \
  date +%s -d "$( \
    aws s3api head-object \
      --bucket ${S3_BUCKET_NAME} \
      --key ${S3_OBJECT_KEY} \
      --query 'LastModified' \
      --output text \
  )" \
) \
  && echo ${S3_OBJECT_TIMESTAMP_BEFORE}

結果(例):

16xxxxxxxxx

S3バケットにファイルを転送します。

変数の確認:

cat << END

  # FILE_LOCAL:"${HOME}/environment/local-handson-cli-s3/handson-cli-s3.txt"
    FILE_LOCAL="${FILE_LOCAL}"
  # S3_BUCKET_NAME:"handson-cli-s3-versioning-XXXXXXXXXXXX"
    S3_BUCKET_NAME="${S3_BUCKET_NAME}"
  # S3_OBJECT_KEY:"handson-cli-s3.txt"
    S3_OBJECT_KEY="${S3_OBJECT_KEY}"

END

コマンド:

aws s3 cp ${FILE_LOCAL} s3://${S3_BUCKET_NAME}/${S3_OBJECT_KEY}

結果(例):

upload: ${HOME}/environment/local-handson-cli-s3/handson-cli-s3.txt to s3://handson-cli-s3.txt

完了確認¶

「S3バケット"handson-cli-s3-versioning-XXXXXXXXXXXX"にオブジェクト"handson-cli-s3.txt"のタイムスタンプが新しくなっている。」ことを確認します。

コマンド:

S3_OBJECT_TIMESTAMP_AFTER=$( \
  date +%s -d "$( \
    aws s3api head-object \
      --bucket ${S3_BUCKET_NAME} \
      --key ${S3_OBJECT_KEY} \
      --query 'LastModified' \
      --output text \
  )" \
) \
  && echo ${S3_OBJECT_TIMESTAMP_AFTER}

結果(例):

16yyyyyyyy

コマンド:

OFFSET_S3_OBJECT_OUTPUT=$( \
  expr ${S3_OBJECT_TIMESTAMP_AFTER} - ${S3_OBJECT_TIMESTAMP_BEFORE} \
) \
  && echo ${OFFSET_S3_OBJECT_OUTPUT}

結果(例):

環境変数を削除して、プロファイルの権限を無効にします。

環境変数の設定:
export -n AWS_DEFAULT_PROFILE