From 25b592371985c272b57762d7bebae4d62a34211c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?M=C3=A1rcio=20Fernandes?= <marcio.fernandes@outlook.pt>
Date: Sat, 22 Nov 2025 18:09:18 +0000
Subject: [PATCH] modified:   README.md

---
 README.md | 60 +++++++++++++++++++++++++++++++++++++++++++++++++++----
 1 file changed, 56 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index 967711c..dbbc8d8 100644
--- a/README.md
+++ b/README.md
@@ -7,7 +7,8 @@
 - [act runner](#act-runner)
   - [act runner (Official)](#act-runner-official)
     - [Docker Compose](#docker-compose)
-  - [custom act runner - gitea/act\_runner:0.2.13-network-stack](#custom-act-runner---giteaact_runner0213-network-stack)
+  - [custom act runner - network-stack](#custom-act-runner---network-stack)
+- [workflows - actions](#workflows---actions)
 - [Other References](#other-references)
 
 ## Links
@@ -82,9 +83,7 @@ sudo docker exec -u git -it -w /tmp gitea bash -c '/app/gitea/gitea dump -d post
       - GITEA_RUNNER_REGISTRATION_TOKEN=<registration token>
 ```
 
-### custom act runner - gitea/act_runner:0.2.13-network-stack
-
-
+### custom act runner - network-stack
 
 **🚀 Purpose**  
 
@@ -112,6 +111,59 @@ docker pull git.limbosolutions.com/kb/gitea/act_runner:0.2.13-network-stack
 
 [Dockerfile source file.](./runners/act-runner-network-stack/Dockerfile)
 
+## workflows - actions
+
+**limbo public actions:**
+
+- kubectl-setup - setups kube config
+
+This example is running custom act runner([custom act runner - network-stack](#custom-act-runner---network-stack)) to deploy to kubernetes cluster without using docker.
+
+```yaml
+name: Example of workflow using limbo public actions
+
+on:
+  push:
+    branches:
+
+      - main
+  pull_request:
+jobs:
+  deploy:
+    runs-on: runner-label
+    env:
+      GITHUB_TEMP: ${{ runner.temp }}
+      
+    steps:
+
+      - name: Checkout code
+        uses: actions/checkout@v3
+
+      - name: Fetch limbo public actions
+        env: 
+          RUNNER_TEMP: "${{ runner.temp }}"
+          WORKSPACE: "${{ gitea.workspace }}"
+        run: |
+          curl -fsSL https://git.limbosolutions.com/kb/gitea/raw/branch/main/cloud-scripts/setup-limbo-actions.sh | bash 2>&1
+
+      - name: Setup kubectl
+        uses: ./.gitea/limbo_actions/kubectl-setup
+        with:
+          kube_server: ${{ secrets.KUBE_SERVER }}
+          kube_ca_base64: ${{ secrets.KUBE_CA_BASE64 }}
+          kube_token: ${{ secrets.KUBE_TOKEN }}
+         
+      - name: Deploy Kubernetes
+        shell: bash
+        env:
+          secrets_example: "${{ secrets.secrets_example }}"
+          
+        run: |
+          kubectl apply -f ./deploy/deployment.yaml \
+          && envsubst < ./deploy/service.template.yaml | kubectl apply -f -
+```
+
+
 ## Other References
 
 - [git.limbosolution.com](https://git.limbosolutions.com)