環境構築資料（Ansible対応版）

• 環境構築資料（Ansible対応版）
  • Ansible + Docker開発環境構築手順
    • 必要条件とツールの導入
    • 構築手順
    • Ansible構成ファイル
  • コンテナ初回起動後の作業
  • 開発環境URLアクセス法
  • Makeコマンド
  • Dockerコマンド

Ansible + Docker開発環境構築手順

必要条件とツールの導入

以下が導入されていることを確認してください。

• Docker
• Docker Compose（旧式またはプラグイン）
• mkcert
• Ansible
• GNU Make

Ubuntu での Ansible 導入：

sudo apt update && sudo apt install -y ansible

構築手順

1. ansible/vars/secrets.example.yml を ansible/vars/secrets.yml にリネームし、プロジェクト設定を記述：

project_name: sample
user: user
proxy_template_name: default.conf.template
...

2. Make コマンドで開発環境を初期化：

make container-init

このコマンドにより以下が自動実行されます：

• .env ファイルの生成（テンプレートから）
• init.sql の生成（テンプレートから）
• proxy/ssl ディレクトリの作成と pem ファイルの発行（mkcert）
• Docker Compose によるビルド＆起動

Ansible構成ファイル

• ansible/environment-setup.yml: 開発環境をセットアップする
• ansible/docker-build-up.yml: コンテナビルド＆起動
• ansible/docker-container-reset.yml: コンテナ停止＆削除
• vars/secrets.yml: 環境変数の定義（project_name など）
• templates/env.j2: .envのテンプレート

コンテナ初回起動後の作業

開発環境URLアクセス法

• Python アプリ: http://127.0.0.1:PROXY_PUBLIC_PORT/

Makeコマンド

make container-init       # 初期セットアップ（環境 + ビルド＆起動）
make docker-setup-env     # 環境のみセットアップ（env, SQL, sslなど）
make container-build-up   # コンテナビルド＆起動
make container-remove     # コンテナ停止＆データ削除＆初期化状態へ

Dockerコマンド

# コンテナ停止
cd docker && docker compose down

# ボリューム・イメージも含め削除
cd docker && docker compose down --rmi all --volumes --remove-orphans

# 未使用（dangling）イメージ削除
docker rmi $(docker images -f "dangling=true" -q)

# キャッシュ削除
docker builder prune