Windows 上で AWS をローカル開発できる環境を構築する(1)
Windows11 の WSL2 の Ubuntu(Linux) で LocalStack を使って AWSのLambdaやS3など一部サービスをローカルPCで実行できる開発環境を作る手順です。
AWSのアカウントは不要です。
本記事では環境構築のみ扱います。
次回の記事ではLocalStackでLambdaのサンプルを実行します。
概要
- Windows11 の WSL2 上に Ubuntu 24.04 をセットアップ
- Docker Engine をインストール
- Node.js / AWS CLI / awslocal など開発に必要なツールを導入
- LocalStack を動かす準備が整った状態にする
全体構成(イメージ)
Windows 11
└─ WSL2 (Ubuntu 24.04)
├─ Docker Engine
├─ LocalStack
├─ Node.js (volta)
├─ AWS CLI / awslocal
└─ Lambda 開発環境
1. Windows11 側の作業
1-1. WSL2をインストール
ターミナルを 管理者権限 で起動します。
PS> wsl -v
バージョンが表示された場合はインストール済みです。
インストール済のディストリビューション確認
PS> wsl -v -l
Ubuntu-24.04等のディストリビューションが表示された場合はインストール済みです。
未インストールの場合は以下の手順を実行してください。
WSL2インストール(管理者で実行)
PS> wsl --install
ターミナル再起動後、バージョン確認
PS> wsl -v
WSL バージョン: 2.6.3.0
以降の作業は管理者での実行は不要です。
1-2. WSL2 に Ubuntu をインストールする
インストール可能なディストリビューション一覧
PS> wsl --list --online
今回はバージョン24.04を指定してインストールします。
Ubuntu をインストール：
PS> wsl --install -d Ubuntu-24.04
初回起動時に Ubuntu ユーザーのパスワードを設定する。
1-3. Ubuntu 起動
一度ターミナルを再起動する。
ターミナル上部のプルダウンから Ubuntu-24.04 を選択する。
なお、Windows側からUbuntuのディレクトリにアクセスすることもできます。
Ubuntu のファイルパス(Windows 側からアクセス)
\\wsl.localhost\Ubuntu-24.04
2. Ubuntu の作業
ここからは Ubuntu ターミナルで作業します。
2-1. pipx（Python CLI 管理ツール）
$ sudo apt-get update
$ sudo apt install pipx
$ pipx ensurepath
2-2. volta インストール（Node.js バージョン管理）
$ curl https://get.volta.sh | bash
$ source ~/.bashrc
$ volta -v
2.0.2
2-3. Node.js (v24) インストール
voltaを使ってインストールする
$ volta install node@24
$ node -v
v24.14.1
$ npm -v
11.11.0
2-4. awslocal（LocalStack 用 AWS CLI ラッパー）
$ pipx install awscli-local
2-5. unzip / zip インストール
$ sudo apt install unzip
$ sudo apt install zip
2-6. AWS CLI (v2) インストール
$ curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip"
$ unzip awscliv2.zip
$ sudo ./aws/install
$ aws --version
3. Docker Engine のインストール
LocalStack は無料の Community（OSS）版と、有料の Pro 版があります。
pip で直接インストールすると環境によっては Pro モードが自動的に有効化されてしまうため、
本記事では docker-compose を使って Community（OSS）版を明示的に利用する方法を採用しています。
3-1. パッケージ更新
$ sudo apt-get update
3-2. 必要ツール
$ sudo apt-get install ca-certificates curl gnupg
3-3. GPG キー保存ディレクトリ
$ sudo install -m 0755 -d /etc/apt/keyrings
3-4. Docker GPG キー取得
$ curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
3-5. Docker リポジトリ登録
$ echo \
"deb [arch="$(dpkg --print-architecture)" signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
"$(. /etc/os-release && echo "$VERSION_CODENAME")" stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
3-6. Docker Engine インストール
$ sudo apt-get update
$ sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
3-7. ユーザーを docker グループに追加
$ sudo usermod -aG docker $USER
状態の反映
$ newgrp docker
または
Ubuntuからexitして再度開く
次の記事では、LocalStack を起動して Lambda を実行するサンプル を動かします。