Skip to content

Commit

Permalink
Merge pull request #9 from mention-me/chore/very-simple-documentation
Browse files Browse the repository at this point in the history
Very simple documentation
  • Loading branch information
ryanmab authored Oct 10, 2024
2 parents 85141d4 + 885a34b commit 7b5f400
Show file tree
Hide file tree
Showing 3 changed files with 48 additions and 3 deletions.
45 changes: 45 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -1 +1,46 @@
# Tray CDK Deployment

A GitHub Action which can deploy Tray (formerly Tray.io, now Tray.ai) CDK connectors to a Tray organisation.

## Inputs

- `apiKey` - The API key for the Tray.ai account (**Required**)
- `region` - The region of the Tray.ai account. Options: `us1`, `eu1`, `apac1` (**Required**)
- `executable` - The path to the CDK executable. If not set, the global executable will be used (**Optional**)
- `path` - The path to the CDK connector which should be built and deployed. If not set, the project root will be used (**Optional**)

## Outputs

- `name` - The name of the deployed connector which was deployed.
- `version` - The version of the deployed connector which was deployed.
- `buildPath` The full path to the built connector (if successful).
- `deploymentId` The ID of the deployment which was created (if successful).
- `successful` - Whether the deployment was completed successfully.

## Example usage

```yaml
uses: mention-me/[email protected]
with:
path: "path/to/connector/root"
region: "us1"
apiKey: ${{ secrets.TRAY_API_KEY }}
```
# Contributing
## Development
To develop this action, you can use the following commands:
- `npm run test` - Run the tests
- `npm run bundle` - Update the distribution files (`./dist`). This is required before merging changes.

## Releasing

To release a new version of this action, you can do the following:

1. Update the version in `package.json` (and run `npm install` to update the lock file)
2. Run `npm run bundle` to update the distribution files
3. Commit the changes
4. Publish the [draft release](https://github.com/mention-me/tray-cdk-deployment/releases)
4 changes: 2 additions & 2 deletions package-lock.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion package.json
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
{
"name": "@mention-me/tray-cdk-deployment",
"description": "A GitHub Action to deploy Tray.ai CDK connectors",
"version": "0.0.1",
"version": "0.1.0",
"repository": {
"type": "git",
"url": "https://github.com/mention-me/tray-cdk-deployment.git"
Expand Down

0 comments on commit 7b5f400

Please sign in to comment.