From a4eec47b177b53737c9a7232fd40cfe907a2f065 Mon Sep 17 00:00:00 2001 From: arhimede Date: Wed, 30 Jul 2025 22:34:44 +0300 Subject: [PATCH 1/8] trying to solve the missing redis --- .laminas-ci.json | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/.laminas-ci.json b/.laminas-ci.json index 64be8c2..ed515df 100644 --- a/.laminas-ci.json +++ b/.laminas-ci.json @@ -5,4 +5,9 @@ ], "ignore_php_platform_requirements": { } -} \ No newline at end of file + { + "extensions": [ + "redis" + ] +} +} From d419331ae4e2a4b3c402c2f1cceb643d5aff398b Mon Sep 17 00:00:00 2001 From: arhimede Date: Wed, 30 Jul 2025 22:36:32 +0300 Subject: [PATCH 2/8] Update .laminas-ci.json --- .laminas-ci.json | 2 -- 1 file changed, 2 deletions(-) diff --git a/.laminas-ci.json b/.laminas-ci.json index ed515df..77777e7 100644 --- a/.laminas-ci.json +++ b/.laminas-ci.json @@ -5,9 +5,7 @@ ], "ignore_php_platform_requirements": { } - { "extensions": [ "redis" ] } -} From 8e34e9916c37bb017138cde5c57c391eb72b396c Mon Sep 17 00:00:00 2001 From: arhimede Date: Wed, 30 Jul 2025 22:42:38 +0300 Subject: [PATCH 3/8] redis missing Signed-off-by: arhimede --- .laminas-ci.json | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/.laminas-ci.json b/.laminas-ci.json index 77777e7..cdf3c1a 100644 --- a/.laminas-ci.json +++ b/.laminas-ci.json @@ -3,9 +3,9 @@ "--no-scripts", "--no-plugins" ], - "ignore_php_platform_requirements": { - } "extensions": [ "redis" - ] -} + ], + "ignore_php_platform_requirements": { + } +} \ No newline at end of file From 5da1b10608b7dd94285d02ede1dab6207eb07722 Mon Sep 17 00:00:00 2001 From: arhimede Date: Wed, 30 Jul 2025 22:43:04 +0300 Subject: [PATCH 4/8] redis missing Signed-off-by: arhimede --- .laminas-ci.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.laminas-ci.json b/.laminas-ci.json index cdf3c1a..bd7455a 100644 --- a/.laminas-ci.json +++ b/.laminas-ci.json @@ -8,4 +8,4 @@ ], "ignore_php_platform_requirements": { } -} \ No newline at end of file +} From 34b4812bb30c276964e35c7ac96741ef128cb9d8 Mon Sep 17 00:00:00 2001 From: arhimede Date: Wed, 30 Jul 2025 22:48:05 +0300 Subject: [PATCH 5/8] redis missing Signed-off-by: arhimede --- .laminas-ci/pre-run.sh | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.laminas-ci/pre-run.sh b/.laminas-ci/pre-run.sh index 8b8528d..b891c0e 100755 --- a/.laminas-ci/pre-run.sh +++ b/.laminas-ci/pre-run.sh @@ -2,4 +2,4 @@ # Due to the fact that we are disabling plugins when installing/updating/downgrading composer dependencies # we have to manually enable the coding standard here. -composer enable-codestandard +#composer enable-codestandard From 303ab801db46f393473bc8cc18e59f346bfa305a Mon Sep 17 00:00:00 2001 From: arhimede Date: Wed, 30 Jul 2025 22:57:02 +0300 Subject: [PATCH 6/8] redis missing Signed-off-by: arhimede --- docs/book/v1/commands.md | 2 +- docs/book/v1/installation.md | 12 +++++------- docs/book/v1/overview.md | 4 +++- docs/book/v1/server-setup.md | 13 ++++++++----- docs/book/v1/valkey.md | 2 +- 5 files changed, 18 insertions(+), 15 deletions(-) diff --git a/docs/book/v1/commands.md b/docs/book/v1/commands.md index 94b428a..63fbdfd 100644 --- a/docs/book/v1/commands.md +++ b/docs/book/v1/commands.md @@ -1,4 +1,4 @@ -## Available commands and usage +# Available commands and usage The commands available are: diff --git a/docs/book/v1/installation.md b/docs/book/v1/installation.md index f594fb7..1076a32 100644 --- a/docs/book/v1/installation.md +++ b/docs/book/v1/installation.md @@ -1,4 +1,4 @@ -## INSTALLATION +# INSTALLATION ### git clone @@ -11,11 +11,11 @@ - messenger.local.php.dist - swoole.local.php.dist -## Run Composer +## Run Composer `composer install --no-dev` -### Create services ( daemon) +### Create services ( daemon) - Edit the files from `/daemon` folder and set proper paths - copy them in /etc/systemd/system/ @@ -24,8 +24,7 @@ `sudo cp /home/dotkernel/queue/daemon\messenger.service` - -### Start the daemon +### Start the daemon `sudo systemctl daemon-reload` @@ -35,9 +34,8 @@ `sudo systemctl status swoole.service` - ### Testing the installation -Send a request from your local machine +Send a request from your local machine `echo "Hello" | socat -T1 - TCP:SERVER-IP:8556` diff --git a/docs/book/v1/overview.md b/docs/book/v1/overview.md index f6f4aeb..2819c80 100644 --- a/docs/book/v1/overview.md +++ b/docs/book/v1/overview.md @@ -1,3 +1,5 @@ +# Overview + > [!IMPORTANT] > Dotkernel component used to queue tasks to be processed asynchronously based on [netglue/laminas-messenger](https://github.com/netglue/laminas-messenger) @@ -14,4 +16,4 @@ [![Build Status](https://github.com/mezzio/mezzio-skeleton/actions/workflows/continuous-integration.yml/badge.svg)](https://github.com/mezzio/mezzio-skeleton/actions/workflows/continuous-integration.yml) [![codecov](https://codecov.io/gh/dotkernel/queue/graph/badge.svg?token=pexSf4wIhc)](https://codecov.io/gh/dotkernel/queue) [![Qodana](https://github.com/dotkernel/queue/actions/workflows/qodana_code_quality.yml/badge.svg?branch=main)](https://github.com/dotkernel/queue/actions/workflows/qodana_code_quality.yml) -[![PHPStan](https://github.com/dotkernel/queue/actions/workflows/static-analysis.yml/badge.svg?branch=main)](https://github.com/dotkernel/queue/actions/workflows/static-analysis.yml) \ No newline at end of file +[![PHPStan](https://github.com/dotkernel/queue/actions/workflows/static-analysis.yml/badge.svg?branch=main)](https://github.com/dotkernel/queue/actions/workflows/static-analysis.yml) diff --git a/docs/book/v1/server-setup.md b/docs/book/v1/server-setup.md index f1b1f33..89a379f 100644 --- a/docs/book/v1/server-setup.md +++ b/docs/book/v1/server-setup.md @@ -1,13 +1,15 @@ -## Server setup +# Server setup > Below instructions are working only on **AlmaLinux 9** -> +> >For other OS's need to be adapted accordingly ## Starting point -A server with AlmaLinux 9 freshly installed, with root access and updated + +A server with AlmaLinux 9 freshly installed, with root access and updated ### Update OS + dnf update ### Create a new user with sudo permissions @@ -22,7 +24,7 @@ dnf update ### SSH to the server as new user -### Install various utilities +### Install various utilities `sudo dnf install -y dnf-utils` @@ -69,6 +71,7 @@ dnf update `sudo dnf install git` ### Composer + `wget https://getcomposer.org/installer -O composer-installer.php` `sudo chmod 777 /usr/local/bin` @@ -86,7 +89,7 @@ connections from outside only to certain ports, from certain IP's. `sudo systemctl enable firewalld` -> Before starting the firewall, be sure you will not be locked outside +> Before starting the firewall, be sure you will not be locked outside `sudo firewall-offline-cmd --zone=public --add-port=22/tcp --permanent` diff --git a/docs/book/v1/valkey.md b/docs/book/v1/valkey.md index fd93ad8..d46e7eb 100644 --- a/docs/book/v1/valkey.md +++ b/docs/book/v1/valkey.md @@ -1,4 +1,4 @@ -## Valkey usage +# Valkey usage Valkey is an open source (BSD) high-performance key/value datastore that supports a variety of workloads such as caching, message queues, and can act as a primary database. From 82c5c1deb348ad786c4719a0d134b054faaf34ba Mon Sep 17 00:00:00 2001 From: arhimede Date: Wed, 30 Jul 2025 23:01:13 +0300 Subject: [PATCH 7/8] redis missing Signed-off-by: arhimede --- docs/book/v1/commands.md | 4 ++-- docs/book/v1/installation.md | 8 ++++---- docs/book/v1/valkey.md | 6 +++--- 3 files changed, 9 insertions(+), 9 deletions(-) diff --git a/docs/book/v1/commands.md b/docs/book/v1/commands.md index 63fbdfd..0f6bbf7 100644 --- a/docs/book/v1/commands.md +++ b/docs/book/v1/commands.md @@ -8,7 +8,7 @@ The commands available are: The commands can be run in two different ways: -### CLI +## CLI To run the commands via CLI, use the following syntax: @@ -18,7 +18,7 @@ To run the commands via CLI, use the following syntax: `php bin/cli.php inventory` -### TCP message +## TCP message To use commands using TCP messages the following messages can be used: diff --git a/docs/book/v1/installation.md b/docs/book/v1/installation.md index 1076a32..c2fc6b3 100644 --- a/docs/book/v1/installation.md +++ b/docs/book/v1/installation.md @@ -1,10 +1,10 @@ # INSTALLATION -### git clone +## git clone `git clone -b default-queue https://github.com/dotkernel/queue.git` -### Edit .dist files from config/autoload folder +## Edit .dist files from config/autoload folder - local.php.dist - log.local.dist @@ -15,7 +15,7 @@ `composer install --no-dev` -### Create services ( daemon) +## Create services ( daemon) - Edit the files from `/daemon` folder and set proper paths - copy them in /etc/systemd/system/ @@ -24,7 +24,7 @@ `sudo cp /home/dotkernel/queue/daemon\messenger.service` -### Start the daemon +## Start the daemon `sudo systemctl daemon-reload` diff --git a/docs/book/v1/valkey.md b/docs/book/v1/valkey.md index d46e7eb..24bc714 100644 --- a/docs/book/v1/valkey.md +++ b/docs/book/v1/valkey.md @@ -6,7 +6,7 @@ The following commands can be run in the CLI to interact with Valkey. To enter C `valkey-cli` -### Utility Commands +## Utility Commands List all keys matching a pattern. @@ -28,7 +28,7 @@ Check data type stored at a specific key (Possible types: string, list, set, zse `TYPE keyName` -### Key-Value Operations +## Key-Value Operations Set a string key to a value. @@ -42,7 +42,7 @@ Delete one or more keys. `DEL keyName1 keyName2` -### Stream Commands +## Stream Commands Read entries from a stream oldest to newest (revers '-' and '+' to reverse order). From 71f8c8610fcb4fc8096012bfb3f206d413452ada Mon Sep 17 00:00:00 2001 From: arhimede Date: Wed, 30 Jul 2025 23:03:53 +0300 Subject: [PATCH 8/8] redis missing Signed-off-by: arhimede --- README.md | 5 +---- 1 file changed, 1 insertion(+), 4 deletions(-) diff --git a/README.md b/README.md index 2d0c9e8..4536b1a 100644 --- a/README.md +++ b/README.md @@ -11,9 +11,7 @@ The greatest benefit is to application responsiveness which allows faster execut The queue system uses logs to ensure maintainability and implements retry features for reliability and stability. -Queue process - - +![Queue process](https://github.com/user-attachments/assets/8eb60c02-4e3a-4a88-b3ff-811d0410337b) ## Badges @@ -30,7 +28,6 @@ The greatest benefit is to application responsiveness which allows faster execut [![Qodana](https://github.com/dotkernel/queue/actions/workflows/qodana_code_quality.yml/badge.svg?branch=main)](https://github.com/dotkernel/queue/actions/workflows/qodana_code_quality.yml) [![PHPStan](https://github.com/dotkernel/queue/actions/workflows/static-analysis.yml/badge.svg?branch=main)](https://github.com/dotkernel/queue/actions/workflows/static-analysis.yml) - ## Installation > Until we have a compiled documentation, read the files from /doc/book/v1 folder