|
|
|
|
Yii と Docker
|
|
|
|
|
=============
|
|
|
|
|
|
|
|
|
|
開発および配備の際に Yii アプリケーションを Docker コンテナとして実行することが出来ます。コンテナは隔絶された軽量の仮想マシンのようなもので、そのサービスをホストのポートにマップします。例えば、コンテナ内の 80 番ポートにあるウェブ・サーバが(ローカル)ホストの 8888 番で利用できます。
|
|
|
|
|
|
|
|
|
|
コンテナによって、開発用コンピュータと実運用サーバでソフトウェアのバージョンを全く同一にすること、迅速な配備、開発時におけるマルチ・サーバ・アーキテクチャのシミュレーションなど、数多くの問題を解決することが出来ます。
|
|
|
|
|
|
|
|
|
|
Docker コンテナの詳細については、[docker.com](https://www.docker.com/why-docker) を参照して下さい。
|
|
|
|
|
|
|
|
|
|
## 必要なもの
|
|
|
|
|
|
|
|
|
|
- `docker`
|
|
|
|
|
- `docker-compose`
|
|
|
|
|
|
|
|
|
|
[ダウンロード・ページ](https://www.docker.com/community-edition) で Docker のツールを取得して下さい。
|
|
|
|
|
|
|
|
|
|
## インストール
|
|
|
|
|
|
|
|
|
|
インストール後、`docker ps` を実行すると、以下と同様の出力が得られるはずです。
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
これは Docker デーモンが起動して走っていることを意味します。
|
|
|
|
|
|
|
|
|
|
これに加えて `docker-compose version` を実行すると、出力は次のようになるはずです。
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
docker-compose version 1.20.0, build unknown
|
|
|
|
|
docker-py version: 3.1.3
|
|
|
|
|
CPython version: 3.6.4
|
|
|
|
|
OpenSSL version: OpenSSL 1.1.0g 2 Nov 2017
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
Compose を使って、データベースやキャッシュなど、アプリケーションに必要な全てのサービスを設定して管理することが出来ます。
|
|
|
|
|
|
|
|
|
|
## リソース
|
|
|
|
|
|
|
|
|
|
- Yii のための PHP ベースのイメージが [yii2-docker](https://github.com/yiisoft/yii2-docker) にあります
|
|
|
|
|
- [yii2-app-basic](https://github.com/yiisoft/yii2-app-basic#install-with-docker) のための Docker サポート
|
|
|
|
|
- [yii2-app-advanced](https://github.com/yiisoft/yii2-app-advanced/pull/347) のための Docker サポートは開発中です
|
|
|
|
|
|
|
|
|
|
## 使用方法
|
|
|
|
|
|
|
|
|
|
Docker の基本的なコマンド:
|
|
|
|
|
|
|
|
|
|
docker-compose up -d
|
|
|
|
|
|
|
|
|
|
スタックにある全てのサービスをバックグラウンドで実行
|
|
|
|
|
|
|
|
|
|
docker-compose ps
|
|
|
|
|
|
|
|
|
|
実行中のサービスをリストアップ
|
|
|
|
|
|
|
|
|
|
docker-compose logs -f
|
|
|
|
|
|
|
|
|
|
全てのサービスのログを連続的に表示
|
|
|
|
|
|
|
|
|
|
docker-compose stop
|
|
|
|
|
|
|
|
|
|
スタックにある全てのサービスを穏やかに停止
|
|
|
|
|
|
|
|
|
|
docker-compose kill
|
|
|
|
|
|
|
|
|
|
スタックにある全てのサービスを即座に停止
|
|
|
|
|
|
|
|
|
|
docker-compose down -v
|
|
|
|
|
|
|
|
|
|
全てのサービスを停止して削除、**ホスト・ボリュームを使っていない場合のデータ損失に注意**
|
|
|
|
|
|
|
|
|
|
コンテナの中でのコマンドの実行:
|
|
|
|
|
|
|
|
|
|
docker-compose run --rm php composer install
|
|
|
|
|
|
|
|
|
|
新しいコンテナの中で composer install を実行
|
|
|
|
|
|
|
|
|
|
docker-compose exec php bash
|
|
|
|
|
|
|
|
|
|
*実行中の* `php` サービスの中で bash を実行
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## 高度なトピック
|
|
|
|
|
|
|
|
|
|
### Yii フレームワークのテスト
|
|
|
|
|
|
|
|
|
|
[ここ](https://github.com/yiisoft/yii2/blob/master/tests/README.md#dockerized-testing) で説明されているように、Yii 自体に対する Docker を使ったフレームワーク・テストを実行することが出来ます。
|
|
|
|
|
|
|
|
|
|
### データベース管理ツール
|
|
|
|
|
|
|
|
|
|
MySQL を (`mysql`) として実行するときは、以下のようにして phpMyAdmin コンテナをスタックに追加することが出来ます。
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
phpmyadmin:
|
|
|
|
|
image: phpmyadmin/phpmyadmin
|
|
|
|
|
ports:
|
|
|
|
|
- '8888:80'
|
|
|
|
|
environment:
|
|
|
|
|
- PMA_ARBITRARY=1
|
|
|
|
|
- PMA_HOST=mysql
|
|
|
|
|
depends_on:
|
|
|
|
|
- mysql
|
|
|
|
|
```
|
