jeffgeerling com

jeffgeerling.com drupal代码库

这是为Jeffgeerling.com提供动力的Drupal代码库。

该项目的建设以及Jeffgeerling.com从Drupal 7到Drupal 8的迁移已在Geerlingguy的YouTube频道上进行了现场直播；您可以在此处观看所有情节，并在此处查看剧集摘要和资源：将Jeffgeerling.com从Drupal 7迁移到Drupal 8-如何进行视频系列。

我决定开放消息来源我的网站代码库，以帮助其他Drupal用户了解我如何构建和维护此网站。如果您喜欢本项目以任何方式看到或得到的东西，请考虑通过Patreon，Github赞助商或其他会员链接来支持我。

部署到生产

目前，从中西部Mac基础架构剧本中部署运行的过程：

 ansible-playbook playbook.yml --tags=deploy

注意：部署时请确保您在master分支上！

生产中的码头

该存储库包括一个Dockerfile.prod ，用于构建准备生产的图像（包括所有代码和资产）。

构建该图像：

 docker build -f Dockerfile.prod -t geerlingguy/jeffgeerling-com:arm64 .

然后，您可以将图像推向Docker Hub上的官方geerlingguy/jeffgeerling-com存储库：

 docker push geerlingguy/jeffgeerling-com:arm64

注意：每当将提交推到master分支时，图像都是通过GitHub动作自动构建并推到Docker Hub的。

当地环境

首次开始使用此项目时，您需要创建本地设置文件：

 cp web/sites/default/example.settings.local.php web/sites/default/settings.local.php

确保已安装了Docker，然后运行以下命令（与此readme文件相同的目录）：

 docker compose up -d

在容器中安装运行作曲家的PHP依赖关系：

 docker compose exec drupal composer install

访问http：// localhost/以查看Drupal安装。请访问http：// localhost：8025/see mailhog。

安装Drupal

您可以使用安装向导安装Drupal，但我们喜欢使用Drush进行更多自动化：

 docker compose exec drupal bash -c 'vendor/bin/drush site:install minimal --db-url="mysql://drupal:$DRUPAL_DATABASE_PASSWORD@$DRUPAL_DATABASE_HOST/drupal" --site-name="Jeff Geerling" --existing-config -y'

从生产中同步数据库

在某个时候，我会写出如何使用自动化的drush进行所有操作。

目前：

1. 打开续集ACE，从产品服务器下载数据库。
2. 打开续集ACE，将数据库上传到本地环境。

更新配置

任何时候都更改了配置或升级任何模块或Drupal，都应使用命令来导出网站的配置：

 docker compose exec drupal bash -c 'vendor/bin/drush config:export -y'

然后在将最新代码部署到网站之前将任何更改推向GIT存储库。

升级核心（和贡献）

1. 像普通一样设置网站，请确保已安装。
2. 运行docker compose exec drupal bash -c 'composer update' （以更新所有内容）。
3. 运行docker compose exec drupal bash -c 'vendor/bin/drush updb -y'
4. 运行docker compose exec drupal bash -c 'vendor/bin/drush config:export -y'
5. 提交任何更改并将其推向遥控器。
6. 运行部署剧本以更新实时网站。

针对Drupal的编码标准覆盖PHP代码

您可以使用phpcs在此项目中测试自定义代码：

 docker compose exec drupal bash -c './vendor/bin/phpcs 
  --standard="Drupal,DrupalPractice" -n 
  --extensions="php,module,inc,install,test,profile,theme" 
  web/themes/jeffgeerling 
  web/modules/custom'

通过MailHog发送电子邮件调试

该项目的Docker配置启用了一个MailHog容器，该容器具有http://127.0.0.1:8025 8025的Web UI。

当您使用此项目的Dockerfile来构建Drupal环境时，将自动配置用于本地环境的php.ini文件通过MailHog实例发送PHP的mhsendmail 。

当Drupal发送电子邮件时，应该在MailHog的UI中可见。