README

（超级酷炫的工具）

SWAT旨在作为ImageX项目中的一项辅助工具。它提供Docker配置、一些模板化的Bitbucket流水线和部署辅助工具。它非常酷炫。

要求

SWAT运行需要以下内容

1. Docksal - https://docksal.io/
2. Composer - https://getcomposer.org.cn/
3. PHP >=8.1

可用命令

运行 fin swat list 获取可用命令列表。

入门

注意：在开始之前运行 fin upgrade 是一个好主意，以确保您有最新的堆栈。

新项目必须使用Drupal 10。

1. fin project create --repo=git@bitbucket.org:ixm/swat-project-template.git --name=<project_name>
2. 按照提示操作
3. cd <project-name>
4. 根据需要修改 docksal.env
   1. 将您的PHP、DB等镜像硬编码为与远程主机匹配
   2. 如果您已进行了更改，请确保重置您的堆栈！
5. 修改针对项目的 swat/swat.yml - 更多详情请在此处查看
   1. 添加远程Git仓库（Acquia、pantheon等）
   2. 添加远程Git用户/邮箱（以下为示例）
6. 下载您的远程drush别名：项目设置 - Drush
7. （如果docroot已更改）更新以下位置中的位置
   1. phpcs.xml
   2. .tugboat/config.yml
8. fin swat install
9. 导出您的配置。
10. 设置您的git remote
    1. git remote add origin git@bitbucket.org:example/example.git
    2. git add . && git commit -m "PROJ-1: Initial Setup for <project>."
    3. git push -u origin master

托管提供商

请参阅我们的内部文档：配置您的托管提供商文件

Git

swat.yml中远程Git配置的示例

    git:
      default_branch: develop
      remotes:
        cloud: 'ixmcomponents@svn-4707.devcloud.hosting.acquia.com:ixmcomponents.git'
      user:
        name: 'ImageX Media'
        email: no-reply@imagexmedia.com

现有项目

现有项目通常应手动升级；然而，在某些情况下，您可能从自动升级中受益。请参阅升级文档

故障排除

1. 在 fin project create 时出现 git@bitbucket.org: Permission denied (publickey).
   1. 检查您是否可以访问https://bitbucket.org/ixm/swat-project-template
   2. 运行 fin system start 并再次尝试
2. 在 fin project create 时出现 Project healthcheck has timed out
   1. 运行以下命令

      fin start
      fin init