README

• Skilld docker 容器
  • 概述
  • 这是什么？
  • 这不是什么？
  • 快速开始
    • 使用的变量
    • 持久化 MySQL
    • 网络
  • 用法
    • 附加目标
  • 支持
  • Drush 命令
  • 故障排除
  • Git 钩子
  • 许可证

概述

Skilld docker 容器 是您的 Drupal 项目的开发者入门套件。

这是什么？

• 这是一个开发者入门套件，可用于本地 Drupal 开发或/和集成到您的 CI/CD 流程中。

这不是什么？

• 这不是一个 可直接使用的工具，您可以在 这份谷歌文档 中找到工具列表。
• 另一个快速解决方案 https://gist.github.com/andypost/f8e359f2e80cb7d4737350189f009646

快速开始

• 为 Linux、Mac、Windows 安装 Docker

  • 检查 Linux 的 安装后步骤，版本 18.06.0 或更高版本

• 安装 Docker Compose V2 版本 2.0 或更高版本

• 将 .env.default 复制到 .env，有关环境文件更多信息，请参阅 docs.docker.com

• 将 docker-compose.override.yml.default 复制到 docker-compose.override.yml，更新您想要覆盖的部分。

  • docker-compose.yml 包含一个工作 Drupal 站点的基要求。不应更新。

• 更新 .gitlab-ci.yml 的 variables 部分，将 THEME_PATH 更新为使前端 GitLab CI 工作的方式。

• 运行 make all

使用的变量

持久化 MySQL

• 默认使用 sqlite 存储，它位于 php 容器内创建，如果您需要保存持久数据
  • 更新 docker-compose.override.yml，设置

  php:
     depends_on:
       - mysql

  并更新 mysql 容器部分

  mysql:
    image: mysql:8.0-oraclelinux8
  ...

  • 更新 .env 文件，并设置 DB_URL=mysql://db:db@mysql/db

网络

• 每次项目构建时，它都会获取新的可用 IP 地址，如果您想要具有持久 IP，取消注释 docker-compose.override.yml 中的行

networks:
  front:
    driver: bridge
    ipam:
      driver: default
      config:
        - subnet: "172.18.0.5"

用法

• make - 显示此信息。
• make all - 从头完整安装项目。
• make clean - 完全删除项目构建文件夹、文件、Docker 容器和网络。
• make si - 安装/重新安装站点。
• make info - 显示项目服务 IP 地址。
• make diff - 显示覆盖中的更改（需要本地的 diff 命令）。
• make exec - 使用 docker exec 进入 php 容器。
• make exec0 - 使用 docker exec 以 root 身份进入 php 容器。
• make dev - Devel + kint 设置，以及为 Twig 调试模式配置，禁用聚合。
• make drush [command] - 执行 Drush 命令。
• make phpcs - 使用 phpcs 检查代码库，确保其符合 https://www.drupal.org/docs/develop/standards。
• make phpcbf - 根据 Drupal 标准 https://www.drupal.org/docs/develop/standards 修复代码库。
• make front - 构建前端任务。
• make lint - 运行前端代码检查。
• make storybook - 在当前主题下运行storybook。
• make blackfire - 添加并启用blackfire.io php扩展，需要在docker-compose.override.yml中进行配置。
• make newrelic - 添加并启用newrelic.com php扩展，需要在NEW_RELIC_LICENSE_KEY环境变量中定义有效的许可证密钥，需要进行配置。
• make xdebug (on|off|status) - 启用、禁用或报告Xdebug PHP扩展的状态。

附加目标

• 如果您需要添加自定义/特定的项目目标，请在scripts/makefile/myfile.mk中创建新文件，并在其中描述目标。示例可以在scripts/makefile/backup.mk中找到。

支持

• 本工程由© Skilld SAS支持。

Drush 命令

• 您可以通过make drush [command -- -argument]运行任何drush命令。

故障排除

• 您可以使用我们的问题队列（公开），以搜索或添加新问题。

Git 钩子

• 项目包括在执行某些git命令时进行自动验证的git钩子。
• 您可以使用--no-verify选项绕过此验证。

许可证

本工程采用MIT开源许可证。