Laravel и Docker: руководство по использованию Laravel Sail

./vendor/bin/sail up

Добавление Sail в существующее приложение

Вы также можете установить Sail в существующее приложение с помощью Composer, при условии, что ваша локальная среда разработки настроена для его использования:

composer require laravel/sail --dev

После завершения установки вы можете опубликовать файл Sail docker-compose.yml в каталоге вашего проекта, используя следующую команду:

php artisan sail:install

Наконец, чтобы запустить Sail, выполните следующую команду:

./vendor/bin/sail up

Шаг 2. Внимательное рассмотрение вашего приложения

Теперь ваша среда разработки запущена и работает. В Docker каждый контейнер содержит только один сервис. Это означает, что наше приложение Sail поставляется с тремя службами: одной для PHP, одной для MySQL и третьей для Redis.
Эти три контейнера размещаются и управляются Docker Compose с использованием файла docker-compose.yml в корне вашего проекта. Если вы откроете этот файл, вы увидите раздел служб с тремя компонентами: laravel.test, mysql и redis:

laravel.test обрабатывает компонент PHP, а два других — то, что предполагают их имена.
В службе MySQL (эта служба управляет вашей базой данных) вы найдете параметр изображения, который указывает изображение, экземпляр которого создает этот контейнер. По сути, изображение похоже на проект дома, а контейнер — это сам построенный дом. Также указывается устанавливаемая версия MySQL (8.0):

mysql:
    image: 'mysql:8.0'
    ports:
        - '${FORWARD_DB_PORT:-3306}:3306'
    environment:
        MYSQL_ROOT_PASSWORD: '${DB_PASSWORD}'
        MYSQL_DATABASE: '${DB_DATABASE}'
        MYSQL_USER: '${DB_USERNAME}'
        MYSQL_PASSWORD: '${DB_PASSWORD}'
        MYSQL_ALLOW_EMPTY_PASSWORD: 'yes'
    volumes:
        - 'sailmysql:/var/lib/mysql'
    networks:
        - sail
    healthcheck:
      test: ["CMD", "mysqladmin", "ping"]

Все необходимые нам изображения взяты из Docker Hub, крупнейшей библиотеки изображений в сети. Они поставляются с некоторой документацией, объясняющей, как их использовать. Ознакомьтесь с документацией по MySQL здесь.
Параметрports используется для синхронизации порта контейнера и локального порта.

DB_PORT:-3306 

— это ваш локальный порт, а строка

${FORWARD_DB_PORT:-3306}:3306 

синхронизирует его с портом вашего контейнера.

В среде определяются учетные данные вашей базы данных. В настоящее время они указывают на значения в файле .env, расположенном в корневом каталоге вашего проекта.
Docker использует тома для сохранения (или сохранения) данных, используемых контейнером (даже после уничтожения контейнера). Экстернализация данных или хранение данных вне контейнера важно по множеству причин.
Контейнеры по замыслу созданы временными. Таким образом, когда они выходят из строя или останавливаются, все хранящиеся в них данные теряются. Когда данные записываются в том и контейнер, которому они принадлежат, закрывается, данные остаются и, таким образом, могут быть использованы новым контейнером. Постоянные данные также могут совместно использоваться несколькими контейнерами на разных машинах.
Строка Volumes: - 'sailmysql:/var/lib/mysql' просто использует том с именемailmysql для сохранения всех данных в каталоге var/lib/mysql (здесь хранятся наши данные MySQL).
Для совместной работы все сервисы в нашем контейнере должны быть подключены к одной сети. Параметр network указывает, какую внутреннюю сеть должен использовать ваш контейнер, в данном случае — парусную.
Наконец, параметр health указывает команды, которые Docker должен выполнить, чтобы проверить состояние вашего контейнера и убедиться, что он работает должным образом.
Если вы внимательно посмотрите на сервис laravel.test, то первым будет параметр build. Он указывает на Dockerfile, расположенный в ./vendor/laravel/sail/runtimes/8.0. Этот Dockerfile был создан командой Laravel и содержит инструкции по созданию нужного нам образа, поэтому мы не будем создавать экземпляры каких-либо изображений из Docker Hub:

laravel.test:
    build:
        context: ./vendor/laravel/sail/runtimes/8.0
        dockerfile: Dockerfile
        args:
            WWWGROUP: '${WWWGROUP}'
    image: sail-8.0/app
    ports:
        - '${APP_PORT:-80}:80'
    environment:
        WWWUSER: '${WWWUSER}'
        LARAVEL_SAIL: 1
    volumes:
        - '.:/var/www/html'
    networks:
        - sail
    depends_on:
        - mysql
        - redis
        - selenium

Параметр image указывает на изображение, экземпляр которого будет создан. В данном случае тот, который создан build. ports сопоставляет наш контейнер и локальные порты вместе. Environments указывает на учетные данные, которые будут использоваться в нашем PHP-коде. Volumes используется для сохранения соответствующих данных PHP, которые мы не хотим потерять, а network указывает внутреннюю сеть, к которой должен быть подключен этот сервис.
Параметр depend_on указывает, какие службы должны быть запущены, прежде чем наше приложение сможет быть запущено. Наше приложение зависит от MySQL, Redis и Selenium.
Последний сервис, redis, аналогичен сервису MySQL:

redis:
    image: 'redis:alpine'
    ports:
        - '${FORWARD_REDIS_PORT:-6379}:6379'
    volumes:
        - 'sailredis:/data'
    networks:
        - sail
    healthcheck:
      test: ["CMD", "redis-cli", "ping"]

Сначала создается экземпляр образа Redis. Затем наш контейнер и локальные порты синхронизируются. Мы используем том для сохранения наших данных Redis, определяем внутреннюю сеть, к которой должен быть подключен этот сервис, и выполняем проверку работоспособности, чтобы убедиться, что наш контейнер работает правильно.

Шаг 3 – Пробуем некоторые команды Sail

alias sail = 'bashvendor/bin/sail'

sail up

sail up -d

sail  down