Skip to content

Commit 8b6d496

Browse files
committed
update docs
1 parent 94c5ebc commit 8b6d496

File tree

2 files changed

+44
-0
lines changed

2 files changed

+44
-0
lines changed

docs/contrib/README.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -29,6 +29,7 @@
2929
* [Slack Recipe](/docs/contrib/slack.md)
3030
* [Supervisord-monitor Recipe](/docs/contrib/supervisord-monitor.md)
3131
* [Telegram Recipe](/docs/contrib/telegram.md)
32+
* [Tideways Recipe](/docs/contrib/tideways.md)
3233
* [Webpack_encore Recipe](/docs/contrib/webpack_encore.md)
3334
* [Workplace Recipe](/docs/contrib/workplace.md)
3435
* [Yammer Recipe](/docs/contrib/yammer.md)

docs/contrib/tideways.md

Lines changed: 43 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,43 @@
1+
<!-- DO NOT EDIT THIS FILE! -->
2+
<!-- Instead edit contrib/tideways.php -->
3+
<!-- Then run bin/docgen -->
4+
5+
# Tideways Recipe
6+
7+
```php
8+
require 'contrib/tideways.php';
9+
```
10+
11+
[Source](/contrib/tideways.php)
12+
13+
14+
15+
### Configuration options
16+
- **api_key** *(required)*: Tideways API key for authentication.
17+
- **version** *(required)*: A version identifier for this release. Can be a version number, a commit hash etc. (Default is set to git log -n 1 --format="%h".)
18+
- **environment** *(optional)*: The environment you're deploying to. Defaults to 'production'.
19+
- **service** *(optional)*: The service name for the release. Defaults to 'web'.
20+
- **compare_after_minutes** *(optional)*: Time in minutes to compare performance before/after release. Defaults to 90.
21+
- **project** *(optional)*: Project name/path for the description field.
22+
- **description** *(optional)*: Custom description for the release.
23+
- **tideways_server** *(optional)*: Tideways server URL. Defaults to 'https://app.tideways.io'.
24+
- **git_version_command** *(optional)*: The command that retrieves the git version information. Defaults to 'git log -n 1 --format="%h"'.
25+
```php
26+
deploy.php
27+
set('tideways', [
28+
'api_key' => 'your-api-key',
29+
'version' => '',
30+
'environment' => 'production',
31+
'service' => 'web',
32+
'compare_after_minutes' => 90,
33+
]);
34+
```
35+
### Suggested Usage
36+
Since you should only notify Tideways of a successful deployment, the deploy:tideways task should be executed right at the end.
37+
```php
38+
deploy.php
39+
after('deploy:success', 'deploy:tideways');
40+
```
41+
42+
43+

0 commit comments

Comments
 (0)