From 97319e3d2de4f27c834d426fe9703f42d8b403ca Mon Sep 17 00:00:00 2001 From: ded-furby <190979964+ded-furby@users.noreply.github.com> Date: Fri, 19 Jun 2026 20:27:37 +1000 Subject: [PATCH 1/7] docs(cli-3343): add development requirements section --- README.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/README.md b/README.md index 79746c43c..00bff7000 100644 --- a/README.md +++ b/README.md @@ -11,6 +11,25 @@ such as: Consult the [documentation][docs] for available sub-commands, descriptions and examples of use. +## Development Requirements + +Before building or testing `ec`, install the following tools: + +- Go 1.25.8+ (matching `go.mod`) +- Make +- Podman or Docker (for acceptance tests and container-based workflows) +- Node.js 18+ (for `tekton-lint`) + +On Fedora/RHEL systems, acceptance tests often require Podman to run as a user service. +Run: + +```bash +systemctl disable --now --user podman.service +systemctl enable --user --now podman.socket +``` + +then run the test/build commands below. + ## Building Run `make build` from the root directory and use the `dist/ec` executable, or From 4660705509433717cfdc3df8b5b91c6cebd4be33 Mon Sep 17 00:00:00 2001 From: ded-furby <190979964+ded-furby@users.noreply.github.com> Date: Fri, 19 Jun 2026 21:27:04 +1000 Subject: [PATCH 2/7] docs: align podman service commands --- README.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 00bff7000..f7ad87328 100644 --- a/README.md +++ b/README.md @@ -20,12 +20,12 @@ Before building or testing `ec`, install the following tools: - Podman or Docker (for acceptance tests and container-based workflows) - Node.js 18+ (for `tekton-lint`) -On Fedora/RHEL systems, acceptance tests often require Podman to run as a user service. +On Fedora/RHEL systems, acceptance tests often require Podman to run as a system service. Run: ```bash -systemctl disable --now --user podman.service -systemctl enable --user --now podman.socket +systemctl disable --now podman.socket podman.service +systemctl enable --now podman.socket podman.service ``` then run the test/build commands below. @@ -94,10 +94,10 @@ $ systemctl disable --now podman.socket podman.service It is advised to do a reboot afterwards. -To start Podman for the user: +To start Podman: ``` bash -$ systemctl enable --user --now podman.socket podman.service +$ systemctl enable --now podman.socket podman.service ``` #### **2.2. Get localhost:37837: connection reset by peer** From c4602e3c6477d89ed3fc07e4703a8c26a616ba5c Mon Sep 17 00:00:00 2001 From: ded-furby <190979964+ded-furby@users.noreply.github.com> Date: Fri, 19 Jun 2026 23:24:52 +1000 Subject: [PATCH 3/7] docs: restore user Podman service commands --- README.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index f7ad87328..84afbe047 100644 --- a/README.md +++ b/README.md @@ -20,12 +20,12 @@ Before building or testing `ec`, install the following tools: - Podman or Docker (for acceptance tests and container-based workflows) - Node.js 18+ (for `tekton-lint`) -On Fedora/RHEL systems, acceptance tests often require Podman to run as a system service. +On Fedora/RHEL systems, acceptance tests often require Podman to run as a user service. Run: ```bash -systemctl disable --now podman.socket podman.service -systemctl enable --now podman.socket podman.service +systemctl disable --now --user podman.socket podman.service +systemctl enable --user --now podman.socket podman.service ``` then run the test/build commands below. @@ -97,7 +97,7 @@ It is advised to do a reboot afterwards. To start Podman: ``` bash -$ systemctl enable --now podman.socket podman.service +$ systemctl enable --user --now podman.socket podman.service ``` #### **2.2. Get localhost:37837: connection reset by peer** From 34c03f20c30109d14368f0276a7ab033d5826fb5 Mon Sep 17 00:00:00 2001 From: ded-furby <190979964+ded-furby@users.noreply.github.com> Date: Sat, 20 Jun 2026 00:24:12 +1000 Subject: [PATCH 4/7] docs: align Podman startup instructions --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 84afbe047..77da46f20 100644 --- a/README.md +++ b/README.md @@ -24,7 +24,7 @@ On Fedora/RHEL systems, acceptance tests often require Podman to run as a user s Run: ```bash -systemctl disable --now --user podman.socket podman.service +systemctl disable --now podman.socket podman.service systemctl enable --user --now podman.socket podman.service ``` @@ -94,7 +94,7 @@ $ systemctl disable --now podman.socket podman.service It is advised to do a reboot afterwards. -To start Podman: +To start Podman for the user: ``` bash $ systemctl enable --user --now podman.socket podman.service From e1787a7d4dd8cdda40bd4982f7f175338e9cae8c Mon Sep 17 00:00:00 2001 From: ded-furby <190979964+ded-furby@users.noreply.github.com> Date: Sat, 20 Jun 2026 10:17:01 +1000 Subject: [PATCH 5/7] docs(EC): reference troubleshooting for Podman setup commands --- README.md | 10 ++-------- 1 file changed, 2 insertions(+), 8 deletions(-) diff --git a/README.md b/README.md index 77da46f20..8792c2fff 100644 --- a/README.md +++ b/README.md @@ -21,14 +21,8 @@ Before building or testing `ec`, install the following tools: - Node.js 18+ (for `tekton-lint`) On Fedora/RHEL systems, acceptance tests often require Podman to run as a user service. -Run: - -```bash -systemctl disable --now podman.socket podman.service -systemctl enable --user --now podman.socket podman.service -``` - -then run the test/build commands below. +Use the Troubleshooting section below for the required Podman service commands and then run +the appropriate Building or Testing commands. ## Building From 4ed8095df0b609951d6947270cca709f49fed08b Mon Sep 17 00:00:00 2001 From: ded-furby <190979964+ded-furby@users.noreply.github.com> Date: Sun, 21 Jun 2026 10:51:36 +1000 Subject: [PATCH 6/7] docs(EC): clarify Podman setup reference --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 8792c2fff..2bef150f7 100644 --- a/README.md +++ b/README.md @@ -21,8 +21,8 @@ Before building or testing `ec`, install the following tools: - Node.js 18+ (for `tekton-lint`) On Fedora/RHEL systems, acceptance tests often require Podman to run as a user service. -Use the Troubleshooting section below for the required Podman service commands and then run -the appropriate Building or Testing commands. +Use the troubleshooting section below for the required Podman service commands, and +then run the appropriate Building or Testing commands. ## Building From bd73ac7111d1cef2efd133d7246c11b592c09888 Mon Sep 17 00:00:00 2001 From: ded-furby <190979964+ded-furby@users.noreply.github.com> Date: Sun, 21 Jun 2026 11:49:17 +1000 Subject: [PATCH 7/7] docs(EC): keep Podman user socket command focused --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 2bef150f7..62130cf8a 100644 --- a/README.md +++ b/README.md @@ -91,7 +91,7 @@ It is advised to do a reboot afterwards. To start Podman for the user: ``` bash -$ systemctl enable --user --now podman.socket podman.service +$ systemctl enable --user --now podman.socket ``` #### **2.2. Get localhost:37837: connection reset by peer**