sqs-request
A docker image to build a SQS queue listener. Written in TypeScript, made to use with docker. SQS queue processor with node, ts-squiss, which processes each message as a request.
TECHNOLOGY:
WHO SHOULD USE:
Any developer who needs to process a queue at SQS, very well configurable.
READY TO USE:
https://hub.docker.com/r/marcusyoda/sqs-request
GETTING STARTED:
To use you need to build with docker...
docker build -t marcusyoda/sqs-request .
...and then configure as your preference:
It's a docker image, so you're expected to run on your infrastructure consuming an Amazon SQS queue.
The settings are made via environment:
| ENV-VAR | DEFAULT | REQUIRED | DESCRIPTION |
|---|---|---|---|
| AWS_ACCESS_KEY_ID | YES | Amazon login KEY data. | |
| AWS_SECRET_ACCESS_KEY | YES | Amazon login SECRET data. | |
| SQS_REGION | YES | The queue region in SQS. | |
| SQS_QUEUE_NAME | YES | The name of the queue in SQS. | |
| MAX_IN_FLIGHT | 100 | NO | The number of messages to keep "in-flight", or processing simultaneously. When this cap is reached, no more messages will be polled until currently in-flight messages are marked as deleted or handled. Setting this option to 0 will uncap your inFlight messages, pulling and delivering messages as long as there are messages to pull. |
| BATCH_SIZE | 10 | NO | The number of messages to receive at one time. Maximum 10 or maxInFlight, whichever is lower. |
| POOL_INTERVAL_MS | 0 | NO | The number of milliseconds to wait between requesting batches of messages when the queue is not empty, and the maxInFlight cap has not been hit. For most use cases, it's better to leave this at 0 and let Squiss manage the active polling frequency according to maxInFlight. |
| DELAY_SECS | 0 | NO | The number of milliseconds by which to delay the delivery of new messages into the queue by default. |
| DELETE_BATCH_SIZE | 10 | NO | The number of messages to delete at one time. Squiss will trigger a batch delete when this limit is reached, or when deleteWaitMs milliseconds have passed since the first queued delete in the batch; whichever comes first. Set to 1 to make all deletes immediate. Maximum 10. |
| DELETE_WAIT_MS | 2000 | NO | The number of milliseconds to wait after the first queued message deletion before deleting the message(s) from SQS. |
| IDLE_POLL_INTERVAL_MS | 0 | NO | The number of milliseconds to wait before requesting a batch of messages when the queue was empty on the prior request. |
| AWS_ENDPOINT | NO |
AUTHOR
Marcus Yoda @marcusyoda
Prototype development, final version and testing.
VERSIONING
Versioning SemVer.
To view the available versions, look at: tags on this repository.
DEPENDENDENCIES:
- Proudly, running with no dependencies.
LICENSE:
Developed by Marcus Yoda, during javascript research and study.
![[NPM]: Bump eslint from 8.9.0 to 8.10.0](https://avatars.githubusercontent.com/in/29110?v=4)
279 Dec 11, 2022
22 Oct 31, 2022
5 Nov 18, 2021
118 Jun 21, 2022
23 Dec 28, 2022
8 Oct 18, 2022
189 Jan 3, 2023
3 Nov 12, 2022
3 Oct 24, 2022
2 Jan 10, 2022
30 Dec 1, 2022
9 Dec 29, 2022
427 Dec 26, 2022
11 Sep 29, 2022
42 Nov 10, 2022
60 Dec 29, 2022
2 Jul 4, 2022