LocalStack環境の構築(と好きなラーメンの話)

はじめに

今年はAWSの技術習得に挑戦した一年でした！
テーマが「今年がんばった技術と好きなラーメン」ということなので
自己学習のためにLocalStack環境を構築した記事を投稿します。

LocalStackとは

ローカルマシンでAWS環境をエミュレートできる機能を持つクラウドサービスエミュレータです。
AWS Lambda、S3、DynamoDB、Kinesis、SQS、SNS などのAWSサービスをローカル環境で実行できます。
無料で使える「Community版」と有料の「Pro版」があります。
詳しくは以下の公式サイトを参照してください。

構築した環境

WSL2を使用しました。

• Windows11
• WSL2
• Ubuntu
• docker
• docker-compose
• awscli
• awslocal
• LocalStack

WSL2とUbuntuインストール

• コマンドプロンプトを起動して以下のコマンドを実行

> wsl --install

• インストール後にUbuntuのユーザ名とパスワードを設定

dockerインストール

• dockerの公式サイトからインストーラをダウンロードしてインストール

LocalStack接続準備

• awscliインストール

$ curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip"
$ unzip awscliv2.zip
$ sudo ./aws/install

• awscli-localインストール

必須ではないがインストールすることでLocalStackでawscliを使うときにエンドポイントを入力しなくてもよくなる。

$ sudo apt -y install python3-pip
$ pip3 install awscli-local

• コマンドのパスを通す

$ echo 'export PATH="$PATH:~/.local/bin"' >> ~/.bashrc
$ source ~/.bashrc

• LocalStack接続用ダミーファイル作成

$ aws configure --profile=localstack
AWS Access Key ID [None]: dummy
AWS Secret Access Key [None]: dummy
Default region name [None]: ap-northeast-1
Default output format [None]: json

LocalStack設定

• githubからLocalStackをクローン

$ git clone https://github.com/localstack/localstack.git
$ cd localstack

• Pro版は使用しないのでdocker-compose.ymlを編集して、Pro用の設定を削除する

$ vi ./docker-compose.yml

「only required for Pro」と記載されている行を削除しました。

LocalStack起動

$ docker-compose up -d

停止するときはdocker-compose down

• 起動したらhttp://localhost:4566/healthにアクセスしてサービスの起動状況を確認する。

S3を試してみる

• バケットの作成

$ awslocal s3 mb s3://test-bucket --profile=localstack

awscli-localをインストールしていると上記のようにエンドポイントの指定なしでコマンドが実行できる。

• バケットの確認

$ awslocal s3 ls --profile=localstack
2022-12-12 01:22:44 test-bucket

• 画像ファイルをアップロード

$ awslocal s3 cp ./test.JPG s3://test-bucket --profile=localstack
upload: ./test.JPG to s3://test-bucket/test.JPG

• http://localhost:4566/test-bucket/test.JPGにアクセスしてアップロードされていることを確認。

アップロードできました！

Lambdaを試してみる

• テストファイル作成

$ vi test.py
def handler(event, context):
    print(event)
    return 'localstackてすと'

• Lamda関数作成

$ zip test.zip test.py
  adding: test.py (deflated 8%)
$ awslocal lambda create-function --function-name test5 --runtime python3.8
--role localstack --handler test.handler --zip-file fileb://test.zip --profile=localstack
{
    "FunctionName": "test5",
    "FunctionArn": "arn:aws:lambda:us-east-1:000000000000:function:test5",
    "Runtime": "python3.8",
    "Role": "localstack",
    "Handler": "test.handler",
　　～
    "LastUpdateStatus": "Successful",
    "PackageType": "Zip",
    "Architectures": [
        "x86_64"
    ]
}

• 実行

$ awslocal lambda invoke --function-name test5 output.log --profile=localsta
ck
{
    "StatusCode": 200,
    "LogResult": "",
    "ExecutedVersion": "$LATEST"
}

• 実行結果確認

$ echo -e `cat output.log`
"localstackてすと"

結果が出力されました！

DynamoDBを試してみる

• テーブル作成

$ awslocal dynamodb create-table \
--table-name 'test' \
--attribute-definitions '[{ "AttributeName": "id", "AttributeType": "N"}, { "AttributeName": "name", "AttributeType": "S" }]' \
--key-schema '[{ "AttributeName": "id", "KeyType": "HASH" }, { "AttributeName": "name", "KeyType": "RANGE" }]' \
--provisioned-throughput '{"ReadCapacityUnits": 10, "WriteCapacityUnits": 10}' --profile=localstack

• テーブル確認

$ awslocal dynamodb list-tables --profile=localstack
{
    "TableNames": [
        "test"
    ]
}

$ awslocal dynamodb describe-table --table-name test --profile=localstack
{
    "Table": {
        "AttributeDefinitions": [
            {
                "AttributeName": "id",
                "AttributeType": "N"
            },
            {
                "AttributeName": "name",
                "AttributeType": "S"
            }
        ],
        "TableName": "test",
        "KeySchema": [
            {
                "AttributeName": "id",
                "KeyType": "HASH"
            },
            {
                "AttributeName": "name",
                "KeyType": "RANGE"
            }
        ],
～
}

• テーブルにitem挿入

$ awslocal dynamodb put-item --table-name test --item '{ "id": { "N": "1" }, "name": { "S": "sio" } }' --profile=localstack
$ awslocal dynamodb put-item --table-name test --item '{ "id": { "N": "2" }, "name": { "S": "miso" } }' --profile=localstack
$ awslocal dynamodb put-item --table-name test --item '{ "id": { "N": "3" }, "name": { "S": "tonkotu" } }' --profile=localstack

• 挿入した全itemの取得

$ awslocal dynamodb scan --table-name test --profile=localstack
{
    "Items": [
        {
            "name": {
                "S": "miso"
            },
            "id": {
                "N": "2"
            }
        },
        {
            "name": {
                "S": "sio"
            },
            "id": {
                "N": "1"
            }
        },
        {
            "name": {
                "S": "tonkotu"
            },
            "id": {
                "N": "3"
            }
        }
    ],
    "Count": 3,
    "ScannedCount": 3,
    "ConsumedCapacity": null
}

DynamoDBも使えました！

所感

結構簡単に環境が構築できました。
今後もいろいろ試したいです！

さいごに好きなラーメン

塩ラーメンが好きですが何でも食べます！笑
個人的に好きなラーメン店ベスト3です！

第3位
ようすけ 鶏煮亭
鶏白湯で味が濃厚です！

第2位
三三七
「つけめん煮番搾り」がおすすめです！

第1位
函館塩ラーメン 五稜郭
スープが美味しくて毎日食べたくなる味です！

参考