Laradockによる開発環境構築(Mac編)

このパートでは、Laradockをインストールして、Laravelを動かすための開発環境を作ります。

Laravelを動かす為には、Webサーバーや、多くの場合でデータベースが必要になってきます。

Laradockを使うことで、このWebサーバーやデータベースをDocker上に簡単に構築することができます。

1. Laradockのインストール

あなたのPCの任意のディレクトリの配下にci-tutorialディレクトリを作成してください。

Copied!
$ mkdir ci-tutorial

そして、ci-tutorialディレクトリに移動してください。

Copied!
$ cd ci-tutorial

ci-tutorialディレクトリに移動したら、以下のコマンドでlaradockをインストールしてください。

なお、2020年10月ごろからlaradockはエラーが発生するようになったので、本教材では筆者が用意した、laradockを模した環境(laradock-like)を使用します。

Copied!
$ git clone https://github.com/shonansurvivors/laradock-like.git laradock

Cloning into 'laradock'...と、数行のメッセージが表示されると思います。

完了すると、laradockというディレクトリが作成されます。

Copied!
.
└──ci-tutorial
    └── laradock

2. laradockの.envファイルを作成する

次に、laradockの設定に関わるファイルのひとつである、.envファイルを作成します。

laradockは、.envファイルの雛形としてenv-exampleファイルを用意してくれているので、これを元に作成することにします。

以下を入力してください。

Copied!
$ cd laradock
$ cp env-example .env

なお、.envのような.始まりのファイルはMacのFinderなどではデフォルトでは隠しファイル扱いとなり、ファイルが存在していてもファイル一覧などに表示されません。AtomやVSCodeなどのエディタでは表示されますので、そちらで確認してください。

3. laradockの.envファイルを編集する

次にエディタ等を使って、.envファイルのうち、

• APP_CODE_PATH_HOST
• DATA_PATH_HOST
• COMPOSE_PROJECT_NAME

の3箇所を以下の通り編集してください。

Copied!
.
└──ci-tutorial
    └── laradock
        └── .env

laradock/.env
1234567
       
Copied!
APP_CODE_PATH_HOST=../laravel-ci #========== この行を変更

DATA_PATH_HOST=../data #========== この行を変更

COMPOSE_PROJECT_NAME=laravel-ci #========== この行を変更

# 略

4. Dockerを使って開発環境を起動する

次にDockerを使って開発環境を起動します。

laradockディレクトリで以下のコマンドを入力してください。

Copied!
$ docker-compose up -d workspace php-fpm nginx postgres

コマンドの意味は以下の通りです。

• docker-composeは、複数のコンテナを同時に取り扱うDocker Composeという機能を使うためのコマンドです
• upは、Docker Composeでコンテナを起動するときに使うコマンドです
• -dは、コンテナを起動した後に、ターミナルの操作に戻るためのオプションです

コマンドを実行すると、大量のメッセージが表示されます。

初回は、各コンテナのソフトウェア本体(Dockerイメージ)をダウンロードしてくるため、コンテナの起動までに数分程度の時間がかかります。

最後に以下のメッセージが表示されたら、コンテナの起動は成功です。

Copied!
Creating laravel-ci_workspace_1        ... done
Creating laravel-ci_php-fpm_1          ... done
Creating laravel-ci_nginx_1            ... done
Creating laravel-ci_porstgres_1        ... done

もし、この4つのメッセージが表示されなかったら、以下を試してください。

• Error response from daemon: invalid mount config for type "bind": bind source path does not existといったメッセージが表示された場合

  • ci-cutorialディレクトリ配下に、空のlaravelディレクトリを作り、その上でもう一度laradockディレクトリでdocker-compose up -d workspace php-fpm nginx postgresを実施する

• それ以外の場合

  • もう一度laradockディレクトリでdocker-compose up -d workspace php-fpm nginx postgresを実施する

以上で、Laradockの導入は完了です。