1.3. S3バケット WebsiteHosting設定¶
作業の目的 [why]¶
コンテンツ用のS3バケット"handson20170904web-XXXXXXXXXXXX"にWebsiteホスティングの設定をし、静的Webサーバとして利用できるようにします。
作業対象 [what]¶
- S3バケット
標準時間¶
8分
前提条件¶
作業環境条件 [where]¶
本作業は、以下の作業環境で行います。
作業環境条件1: OSとバージョン
Amazon Linuxの以下のバージョンで動作確認済
コマンド:
cat /etc/issue | head -1
結果(例):
Amazon Linux AMI release 2016.09
作業環境条件2: シェルとバージョン
bashの以下のバージョンで動作確認済
コマンド:
bash --version -v | head -1
結果(例):
GNU bash, バージョン 4.2.46(1)-release (x86_64-redhat-linux-gnu)
作業環境条件3: AWS CLIのバージョン
以下のバージョンで動作確認済
- AWS CLI 1.11.117
コマンド:
aws --version
結果(例):
aws-cli/1.11.144 Python/2.7.12 Linux/4.4.11-23.53.amzn1.x86_64 botocore/1.7.2
バージョンが古い場合は最新版に更新しましょう。
コマンド:
sudo -H pip install -U awscli
開始条件¶
作業に必要なモノ・情報 [resource]¶
作業開始には、以下が全て揃っていることが必要です。
リソース1: S3バケット名
- Webサイトホスティングの設定をするS3バケットの名称です。
- 今回は"handson20170904web-XXXXXXXXXXXX"とします。
タスクの実施¶
0. パラメータの指定¶
まず変数の確認をします。
変数の確認:
cat << ETX 0.a. AWS_DEFAULT_PROFILE: actual: ${AWS_DEFAULT_PROFILE} expect: <S3のフル権限が許可されているプロファイル> 0.b. AWS_DEFAULT_REGION: actual: ${AWS_DEFAULT_REGION} expect: ap-northeast-1 0.1. S3_BUCKET_NAME: actual: ${S3_BUCKET_NAME} expect: handson20170904web-XXXXXXXXXXXX 0.2. S3_DOC_INDEX: actual: ${S3_DOC_INDEX} expect: index.html 0.3. S3_DOC_ERROR: actual: ${S3_DOC_ERROR} expect: error.html ETX
変数が入っていない、適切でない場合は、それぞれの手順番号について作業を行います。
0.a. プロファイルの指定¶
プロファイルの一覧を確認します。
コマンド:
cat ~/.aws/credentials \ | grep '\[' \ | sed 's/\[//g' | sed 's/\]//g'
結果(例):
iamFull-prjz-mbpr13 <S3のフル権限が許可されているプロファイル>
変数の設定:
export AWS_DEFAULT_PROFILE='<S3のフル権限が許可されているプロファイル>'
再確認¶
設定されている変数の内容を再確認します。
変数の確認:
cat << ETX 0.a. AWS_DEFAULT_PROFILE: actual: ${AWS_DEFAULT_PROFILE} expect: <S3のフル権限が許可されているプロファイル> 0.b. AWS_DEFAULT_REGION: actual: ${AWS_DEFAULT_REGION} expect: ap-northeast-1 0.1. S3_BUCKET_NAME: actual: ${S3_BUCKET_NAME} expect: handson20170904web-XXXXXXXXXXXX 0.2. S3_DOC_INDEX: actual: ${S3_DOC_INDEX} expect: index.html 0.3. S3_DOC_ERROR: actual: ${S3_DOC_ERROR} expect: error.html ETX
1. 前処理¶
処理対象の状態確認¶
主処理の実施は、以下の状態であることを前提とします。
前提と異なることが判明した場合、直ちに処理を中止します。
事前条件1: S3バケット"handson20170904web-XXXXXXXXXXXX"Webサイトホスティングの設定が有効になっていない。
「S3バケット"handson20170904web-XXXXXXXXXXXX"Webサイトホスティングの設定が有効になっていない。」ことを確認します。
コマンド:
aws s3api get-bucket-website \ --bucket ${S3_BUCKET_NAME}
結果(例):
A client error (NoSuchWebsiteConfiguration) occurred when calling the GetBucketWebsite operation: The specified bucket does not have a website configuration
主処理の実施は、以下の状態であることを前提とします。
前提と異なることが判明した場合、直ちに処理を中止します。
2. 主処理¶
websiteホスティングの設定¶
変数の確認
cat << ETX S3_BUCKET_NAME: actual: ${S3_BUCKET_NAME} expect: handson20170904web-XXXXXXXXXXXX S3_DOC_INDEX: actual: ${S3_DOC_INDEX} expect: index.html S3_DOC_ERROR: actual: ${S3_DOC_ERROR} expect: error.html ETX
コマンド:
aws s3 website "s3://${S3_BUCKET_NAME}" \ --index-document ${S3_DOC_INDEX} \ --error-document ${S3_DOC_ERROR}
結果(例):
(出力なし)
3. 後処理¶
1.1. 完了条件の確認¶
主処理は、以下を満たしたときに成功したものとします。
完了条件1: S3バケット"handson20170904web-XXXXXXXXXXXX"のWebサイトホスティングの設定が有効になっている。
「S3バケット"handson20170904web-XXXXXXXXXXXX"のWebサイトホスティングの設定が有効になっている。」ことを確認します。
コマンド:
aws s3api get-bucket-website \ --bucket ${S3_BUCKET_NAME}
結果(例):
{ "IndexDocument": { "Suffix": "index.html" }, "ErrorDocument": { "Key": "error.html" } }
1.2. テスト用コンテンツの作成と転送¶
変数の設定:
FILE_INPUT="${HOME}/index.html"
コマンド:
cat << EOF > ${FILE_INPUT} <!DOCTYPE html> <html lang="ja"> <meta charset="utf-8"> <title>サンプル</title> <h1>サンプル</h1> <p>サンプル</p> </html> EOF cat ${FILE_INPUT}
結果(例):
<!DOCTYPE html> <html lang="ja"> <meta charset="utf-8"> <title>サンプル</title> <h1>サンプル</h1> <p>サンプル</p> </html>
コマンド:
aws s3 cp ${FILE_INPUT} s3://${S3_BUCKET_NAME}/
結果(例):
upload: ${HOME}/index.html to s3://handson20170904web-XXXXXXXXXXXX/index.html
コマンド:
rm ${FILE_INPUT}
コマンド:
aws s3 ls s3://${S3_BUCKET_NAME}/
結果(例):
2017-09-04 01:23:45 139 index.html
1.3. テスト用コンテンツの確認¶
変数の設定:
S3_BUCKET_REGION=$( \ aws s3api get-bucket-location \ --bucket ${S3_BUCKET_NAME} \ --output text \ ) \ && echo ${S3_BUCKET_REGION}
結果(例):
ap-northeast-1
変数の設定:
URL_S3_BUCKET="http://${S3_BUCKET_NAME}.s3-website-${S3_BUCKET_REGION}.amazonaws.com" \ && echo ${URL_S3_BUCKET}
結果(例)
http://handson20170904web-XXXXXXXXXXXX.s3-ap-northeast-1.amazonaws.com
ブラウザでサンプルコンテンツにアクセスできることを確認します。