README

(SUPER WICKED AWESOME TOOL)

SWAT is meant to be a helper for projects within ImageX. It provides a docksal setup, some templated Bitbucket pipelines and deployment helpers. And it's super wicked awesome.

Requirements

SWAT requires the following to run:

Docksal - https://docksal.io/
Composer - https://getcomposer.org/
PHP >=8.1

Available Commands

Run fin swat list to get a listing of available commands.

GETTING STARTED

Note: it's a good idea to run fin upgrade before starting to be sure you have the latest stacks.

New projects must use Drupal 10.

fin project create --repo=git@bitbucket.org:ixm/swat-project-template.git --name=<project_name>
Follow the prompts
cd <project-name>
Modify docksal.env for any stack changes
1. Hardcode your PHP, DB, etc images to match your remote host
2. If you've made changes, make sure to reset your stack!
Modify swat/swat.yml specific to project - see more details here
1. Add Remote Git repo (Acquia, pantheon, etc)
2. Add Remote Git user/email (see example below)
Download your remote drush aliases: Project Setup - Drush
(If docroot changed) Update your location in:
1. phpcs.xml
2. .tugboat/config.yml
fin swat install
Export your config.
Setup your 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

Hosting Provider

See our internal documentation: Configuring your hosting provider files

Git:

Example of Git config in swat.yml for remote:

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

Existing Projects

Existing projects generally should be manually upgraded; however, there are cases in which you might benefit from an automatic upgrade. See the Upgrade Docs

Troubleshoot

git@bitbucket.org: Permission denied (publickey). on fin project create:
1. Check if you have access on https://bitbucket.org/ixm/swat-project-template
2. Run fin system start and try again
Project healthcheck has timed out on fin project create:
1. Run the following commands:
```
fin start
fin init
```

imagex / swat

Maintainers

Details