README

contentpool 发行版结合了 Thunder 发行版的发布功能，以及强大的内容 API 和复制功能！https://www.drupal.org/project/contentpool

状态

该发行版已证明其非常有价值，但后来发现，对于我们的用例来说，多版本复制过于复杂，因此我们转向了更简单的方法。

如果您愿意继续维护该发行版，请与我们联系！

概览

此存储库是发行版的 Drupal 安装配置文件。您需要一个 Drupal 项目来安装它。有关详细信息，请参阅“安装”。

卫星站可以使用 https://github.com/drunomics/contentpool-client 来轻松根据可配置的复制过滤器复制内容。内容会定期拉取，而 contentpool 可选地将更改即时推送到选定的卫星站。

状态

该发行版处于早期开发阶段，但基本上已经可以工作。请继续关注！

工作流程、问题

请在 https://www.drupal.org/project/issues/contentpool 的 drupal.org 问题跟踪器中提交问题。对于建议的代码更改，请向相应的 github 仓库提交拉取请求（PR），并在您的 drupal.org 问题中链接它们。

安装

快速安装

可以使用提供的脚本来设置一个新的 Drupal 项目以测试该发行版，这是测试发行版的最佳方式。此外，它还包含一个现成的 docker-compose 设置，因此您可以尝试该发行版。您需要一个用于 contentpool 的项目和连接到 contentpool 的一个卫星站项目。

0. 前提条件

• 安装版本 0.6.7 或更高版本的 phapp-cli。如果已安装，请运行 phapp self:update 以确保您有最新版本。
• 确保已安装并正常工作 docker-compose。请确保您不使用 docker-composer 版本 1.21，因为它包含此 回归。通过 docker-compose --version 检查您的版本。如果是这样，请将其更新到版本 1.22，已知该版本可以正常工作。请参阅 https://github.com/docker/compose/releases/tag/1.22.0
• 安装 lupus-localdev 以允许启动多个项目！

1. 设置contentpool

运行以下命令

# cd to ~/projects or similar.
git clone git@github.com:drunomics/contentpool.git && cd contentpool
# Check out tag of latest release or stay with the development version.
./scripts/create-project.sh
./scripts/run-server.sh
./scripts/init-project.sh

如果一切顺利，您可以通过http://contentpool-project.localdev.space 访问您的站点。发行版附带一些基本演示内容，这些内容已经被init-project脚本添加。演示内容由可选模块 contentpool_demo_content 提供。

如果您想运行drush命令，请在docker容器内部运行。在以下新打开的终端中运行以下命令

cd ../contentpool-project
docker-compose exec cli /bin/bash
drush uli

2. 设置卫星站点

运行以下命令

# cd to ~/projects or similar.
git clone git@github.com:drunomics/contentpool-client.git && cd contentpool-client
# Check out tag of latest release or stay with the development version.
./scripts/create-project.sh
./scripts/run-server.sh
./scripts/init-project.sh

如果一切顺利，您可以通过http://satellite-project.localdev.space 访问您的站点

如果您想运行drush命令，请在docker容器内部运行。在以下新打开的终端中运行以下命令

cd ../satellite-project
docker-compose exec cli /bin/bash
drush uli

请参阅使用文档以触发首次复制！

常规安装

可以通过composer将安装配置文件添加到Drupal 8站点

  composer require drunomics/contentpool

然后选择“Contentpool”发行版安装Drupal。请注意，仅支持基于composer的安装。从类似drunomics/drupal-project的composer-based Drupal项目开始。

开发

只需按照上述“快速安装”说明，并在web/profiles/contrib/contentpool处编辑安装配置文件内容。您可以通过执行以下操作来确保它是Git checkout

  rm -rf web/profiles/contrib/contentpool
  composer install --prefer-source

运行测试

本地，通过提供的脚本

使用提供的脚本（见上文）安装后，您可以按以下方式启动测试

 ./scripts/create-project.sh
 ./scripts/run-server.sh
 ./scripts/init-project.sh
 ./scripts/run-tests.sh

手动

根据手动安装说明，您可以按以下方式启动测试

# Launch tests inside a docker container, so name resolution works thanks to
# docker host aliases and the PHP environment is controlled by the container.

docker-compose exec cli ./web/profiles/contrib/contentpool/tests/behat/run.sh

JSON API

要了解更多关于JSON API的信息，请阅读docs/api.md中的文档

故障排除

• 如果在数据库连接上出现“访问拒绝”错误，请尝试从contentpool-project文件夹中删除docker卷

  docker-compose down
  docker volume rm contentpool-project_data-volume
  docker-compose up -d
  

致谢

• Österreichischer Wirtschaftsverlag GmbH：发起者，赞助商
• drunomics GmbH：概念，开发，维护