# GitHub Actions Workflows

This directory contains GitHub Actions workflows for automated deployment to Pantheon.

## Managed Workflows

The following workflows are managed by the `square360/pantheon-github-workflows` Composer package and will be automatically updated:

- `deploy-to-dev.yml` - Deploys merged pull requests to Pantheon DEV environment
- `deploy-multidev.yml` - Deploys pull requests to temporary multidev environments

## Configuration

### Required Repository Secrets

Add these secrets in your GitHub repository settings:

- `PANTHEON_SSH_KEY` - SSH private key for Pantheon access
- `PANTHEON_MACHINE_TOKEN` - Pantheon machine token for Terminus CLI
- `CI_GH_TOKEN` - GitHub token with repo permissions (for semantic release)

### Optional Repository Secrets (for Slack Notifications)

Add this secret for optional Slack notifications:

- `SLACK_BOT_TOKEN` - Slack bot token for posting notifications

### Required Repository Variables

Add these variables in your GitHub repository settings:

- `PANTHEON_SITE` - Your Pantheon site machine name

### Optional Repository Variables (for Slack Notifications)

Add these variables for optional Slack notifications:

- `SLACK_CHANNEL` - Slack channel for deployment notifications (e.g., `#deployments`)

## Custom Workflows

To add custom workflows that won't be overwritten by package updates, use different filenames such as:

- `custom-deployment.yml`
- `testing.yml`
- `build-assets.yml`

## Package Management

These workflow files are automatically managed. To update to the latest versions:

```bash
composer update square360/pantheon-github-workflows
```

For more information, see: https://github.com/Square360/pantheon-github-workflows
