https://github.com/taskforcesh/taskforce-connector
Service to allow local queues to be managed in taskforce.sh
https://github.com/taskforcesh/taskforce-connector
Last synced: 9 months ago
JSON representation
Service to allow local queues to be managed in taskforce.sh
- Host: GitHub
- URL: https://github.com/taskforcesh/taskforce-connector
- Owner: taskforcesh
- License: mit
- Created: 2017-08-12T10:32:00.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2025-01-16T22:32:02.000Z (11 months ago)
- Last Synced: 2025-03-28T18:13:47.521Z (9 months ago)
- Language: TypeScript
- Homepage:
- Size: 1020 KB
- Stars: 40
- Watchers: 5
- Forks: 20
- Open Issues: 15
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Taskforce Connector
This small service allows you to connect queues to [Taskforce](https://taskforce.sh) acting as a proxy between your queues and the UI. It is useful for connecting local development queues as well as production grade queues without the need of sharing passwords or establishing SSH tunnels.
Currently the connector supports [Bull](https://github.com/optimalbits/bull) and [BullMQ](https://github.com/taskforcesh/bullmq) queues.
The connector is designed to be lightweight and using a minimal set of resources from the local queues.
## Install
Using [yarn](https://yarnpkg.com)
```bash
yarn global add taskforce-connector
```
Using npm:
```bash
npm install -g taskforce-connector
```
## Usage
Call the tool and get a help on the options:
```bash
✗ taskforce --help
Usage: taskforce [options]
Options:
-V, --version output the version number
-n, --name [name] connection name [My Connection] (default: "My Connection")
-t, --token [token] api token (get yours at https://taskforce.sh)
-p, --port [port] redis port [6379] (default: "6379")
--tls [tls] (default: "Activate secured TLS connection to Redis")
-h, --host [host] redis host [localhost] (default: "localhost")
-d, --database [db] redis database [0] (default: "0")
--username [username] redis username
--passwd [passwd] redis password
--spasswd [spasswd] redis sentinel password
-u, --uri [uri] redis uri
--team [team] specify team where to put the connection
-b, --backend [host] backend domain [api.taskforce.sh] (default: "wss://api.taskforce.sh")
-s, --sentinels [host:port] comma-separated list of sentinel host/port pairs
-m, --master [name] name of master node used in sentinel configuration
-h, --help output usage information
--nodes [nodes] comma-separated list of cluster nodes uris to connect to (Redis Cluster)
--queues optional comma-separated list of queues to monitor
--queuesFile optional file with queues to monitor
```
Example:
```bash
✗ taskforce -n "transcoder connection" -t 2cfe6a1b-5f0e-466f-99ad-12f51bea79a7
```
The token `2cfe6a1b-5f0e-466f-99ad-12f51bea79a7` is a private token that can be retrieved at your [Taskforce account](https://taskforce.sh/account).
After running the command, you should be able to see the connection appear automatically on the dashboard.
Sentinel Example:
```bash
✗ taskforce -n "transcoder connection" -t 2cfe6a1b-5f0e-466f-99ad-12f51bea79a7 -s sentinel1.mydomain:6379,sentinel2.mydomain:6379 -m mymaster
```
Note: You can also specify the following with environment variables.
```bash
token TASKFORCE_TOKEN
port REDIS_PORT
host REDIS_HOST
password REDIS_PASSWD
sentinel-password REDIS_SENTINEL_PASSWD
uri REDIS_URI
sentinels REDIS_SENTINELS (comma separated list of sentinels)
master REDIS_MASTER
nodes REDIS_NODES (comma separated list of nodes for Redis Cluster)
```
To enable use if TLS when using the container set this environment variable:
```bash
REDIS_USE_TLS=1
```
Note for Redis Cluster: You may also need to specify following with environment variables.
```bash
Cluster TLS Certificate REDIS_CLUSTER_TLS
```
If your redis cluster still cannot connect due to failing certificate validation, you may need to pass this env to skip cert validation.
```bash
NODE_TLS_REJECT_UNAUTHORIZED="0"
```
## Secured TLS Connections
Services that support TLS can also be used using the connector, use the `--tls` flag. Note that some services such as Heroku expects the port number to be "one more" than the normal unencrypted port [read more](https://devcenter.heroku.com/articles/securing-heroku-redis).
## Teams
You can use the connector to spawn queue connections to any team that you created on your organization, just pass the team name
as an option:
```bash
✗ taskforce -n "transcoder connection" -t 2cfe6a1b-5f0e-466f-99ad-12f51bea79a7 --team "my awesome team"
```
## Use as a library
It is also possible to add the connector as a library:
As a commonjs dependency:
```js
const { Connect } = require("taskforce-connector");
const taskforceConnection = Connect("my connection", "my token", {
host: "my redis host",
port: "my redis port",
password: "my redis password",
});
```
or as a es6 module:
```ts
import { Connect } from "taskforce-connector";
const taskforceConnection = Connect("my connection", "my token", {
host: "my redis host",
port: "my redis port",
password: "my redis password",
});
```
If you are using the On Premises version of Taskforce, you can also specify the backend domain:
```ts
const taskforceConnection = Connect(
"my connection",
"my token",
{
host: "my redis host",
port: "my redis port",
password: "my redis password",
},
"My Prod Team", // optional team name
"wss://mybackend.domain"
);
```