Compare commits
22 Commits
0.0.6
...
6b89c6e51f
| Author | SHA1 | Date | |
|---|---|---|---|
 t.behrendt
|
6b89c6e51f
|
||
 renovate-bot
|
cc54a9d3c6 | ||
|
renovate-bot
|
2aecdb373d | ||
|
renovate-bot
|
e9b699a881 | ||
|
renovate-bot
|
84e1bf7e51 | ||
|
t.behrendt
|
0199d06001 | ||
|
t.behrendt
|
2866c3983b | ||
|
t.behrendt
|
bb6706d1a0 | ||
|
renovate-bot
|
dc62bc4e6a | ||
|
renovate-bot
|
d7d914ca4a | ||
|
renovate-bot
|
5982457d82 | ||
|
renovate-bot
|
2d3fc7613a | ||
|
renovate-bot
|
269cf7adf4 | ||
|
renovate-bot
|
af7cbdf12b | ||
|
renovate-bot
|
86b398278f | ||
|
renovate-bot
|
f9ac1e8589 | ||
|
renovate-bot
|
7993842765 | ||
|
renovate-bot
|
9c76b8bfdc | ||
|
renovate-bot
|
f7f5bc1b47 | ||
|
renovate-bot
|
d41aab78cb | ||
|
renovate-bot
|
5331d22579 | ||
|
renovate-bot
|
c41eeb249e |
@@ -1,19 +0,0 @@
|
||||
name: Extract chart name from repo name
|
||||
description: Extracts the chart name from the repo name, based on the convention of helm-<chart-name>
|
||||
inputs:
|
||||
repo:
|
||||
description: The full repository name (e.g., "helm-my-chart")
|
||||
required: true
|
||||
outputs:
|
||||
chart-name:
|
||||
description: The extracted chart name
|
||||
value: ${{ steps.extract.outputs.suffix }}
|
||||
runs:
|
||||
using: "composite"
|
||||
steps:
|
||||
- id: extract
|
||||
shell: bash
|
||||
run: |
|
||||
full_repo="${{ inputs.repo }}"
|
||||
suffix="${full_repo##*helm-}"
|
||||
echo "suffix=$suffix" >> $GITHUB_OUTPUT
|
||||
@@ -1,19 +0,0 @@
|
||||
name: "Extract namespace from repo name"
|
||||
description: "Extracts the namespace name from the repo name, based on the convention of k_<namespace-name>"
|
||||
inputs:
|
||||
repo:
|
||||
description: 'The repo name, get it from "github.repository"'
|
||||
required: true
|
||||
outputs:
|
||||
namespace:
|
||||
description: "The namespace name"
|
||||
value: ${{ steps.extract.outputs.suffix }}
|
||||
runs:
|
||||
using: "composite"
|
||||
steps:
|
||||
- id: extract
|
||||
shell: bash
|
||||
run: |
|
||||
full_repo="${{ inputs.repo }}"
|
||||
suffix="${full_repo##*k_}"
|
||||
echo "suffix=$suffix" >> $GITHUB_OUTPUT
|
||||
@@ -3,35 +3,35 @@ name: Deploy
|
||||
on:
|
||||
workflow_call:
|
||||
inputs:
|
||||
# Optional: Override the default k8s directory path
|
||||
k8s_dir:
|
||||
description: "Path to Kubernetes manifests directory"
|
||||
description: "Override the default k8s directory path (k8s/)"
|
||||
required: false
|
||||
default: "k8s/"
|
||||
type: string
|
||||
# Optional: Override the default helmfile path
|
||||
helmfile_path:
|
||||
description: "Path to helmfile.yaml"
|
||||
description: "Override the default helmfile path (hemfile.yaml)"
|
||||
required: false
|
||||
default: "helmfile.yaml"
|
||||
type: string
|
||||
# Optional: Skip Helm deployment even if helmfile exists
|
||||
skip_helm_deployment:
|
||||
description: "Skip Helm deployment even if helmfile.yaml exists"
|
||||
required: false
|
||||
default: false
|
||||
type: boolean
|
||||
# Optional: Custom secrets to create (JSON array of secret objects)
|
||||
custom_secrets:
|
||||
description: "JSON array of secrets to create. Each secret should have: name, type, data"
|
||||
skip_shared_secrets_deployment:
|
||||
description: "Skip shared secrets deployment (e.g. restic backup secret)"
|
||||
required: false
|
||||
default: "[]"
|
||||
default: false
|
||||
type: boolean
|
||||
helmfile_env:
|
||||
description: "Optional JSON object string of environment variables for Helmfile"
|
||||
required: false
|
||||
default: "{}"
|
||||
type: string
|
||||
# Optional: Branch to deploy from
|
||||
deploy_branch:
|
||||
description: "Branch to deploy from"
|
||||
namespace:
|
||||
description: "Override the default namespace (extracted from repository name)"
|
||||
required: false
|
||||
default: "main"
|
||||
default: ""
|
||||
type: string
|
||||
|
||||
jobs:
|
||||
@@ -63,53 +63,57 @@ jobs:
|
||||
echo "No k8s directory found at ${{ inputs.k8s_dir }}"
|
||||
fi
|
||||
|
||||
deploy-shared-secrets:
|
||||
runs-on: ubuntu-latest
|
||||
needs: detect-service-type
|
||||
if: inputs.skip_shared_secrets_deployment != 'true'
|
||||
steps:
|
||||
- uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
|
||||
- uses: https://gitea.t000-n.de/t.behrendt/k_deploy_actions/.gitea/actions/extract-namespace-from-repo-name@0.0.1
|
||||
id: namespace
|
||||
with:
|
||||
repo: ${{ github.repository }}
|
||||
- uses: azure/setup-kubectl@829323503d1be3d00ca8346e5391ca0b07a9ab0d # v5.1.0
|
||||
- uses: azure/k8s-set-context@89b837d75b40a7bd2ddafde837473c212db8b313 # v5.0.0
|
||||
with:
|
||||
method: kubeconfig
|
||||
kubeconfig: ${{ secrets.KUBECONFIG }}
|
||||
- name: Set restic backup secret
|
||||
uses: azure/k8s-create-secret@5e49ad902ac755e0815974a44904c728da961747 # v6.0.0
|
||||
with:
|
||||
namespace: ${{ inputs.namespace || steps.namespace.outputs.namespace }}
|
||||
secret-name: backupsidecar-secret
|
||||
secret-type: generic
|
||||
data: |
|
||||
{
|
||||
"restic_password": "${{ secrets.RESTIC_PASSWORD }}",
|
||||
"restic_rest_username": "${{ secrets.RESTIC_REST_USERNAME }}",
|
||||
"restic_rest_password": "${{ secrets.RESTIC_REST_PASSWORD }}",
|
||||
"gotify_token": "${{ secrets.GOTIFY_TOKEN }}"
|
||||
}
|
||||
|
||||
deploy-k8s:
|
||||
runs-on: ubuntu-latest
|
||||
needs: detect-service-type
|
||||
if: needs.detect-service-type.outputs.has_k8s == 'true'
|
||||
steps:
|
||||
- uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
|
||||
with:
|
||||
ref: ${{ inputs.deploy_branch }}
|
||||
- uses: ./.gitea/actions/extract-namespace-from-repo-name
|
||||
- uses: https://gitea.t000-n.de/t.behrendt/k_deploy_actions/.gitea/actions/extract-namespace-from-repo-name@0.0.1
|
||||
id: namespace
|
||||
with:
|
||||
repo: ${{ github.repository }}
|
||||
- uses: azure/setup-kubectl@776406bce94f63e41d621b960d78ee25c8b76ede # v4.0.1
|
||||
- uses: azure/k8s-set-context@ae59a723ba9abe7a9655538854a025448dbab4aa # v4.0.2
|
||||
- uses: azure/setup-kubectl@829323503d1be3d00ca8346e5391ca0b07a9ab0d # v5.1.0
|
||||
- uses: azure/k8s-set-context@89b837d75b40a7bd2ddafde837473c212db8b313 # v5.0.0
|
||||
with:
|
||||
method: kubeconfig
|
||||
kubeconfig: ${{ secrets.KUBECONFIG }}
|
||||
- name: Create custom secrets
|
||||
id: create-secrets
|
||||
run: |
|
||||
# Parse custom secrets from input
|
||||
SECRETS='${{ inputs.custom_secrets }}'
|
||||
if [ "$SECRETS" != "[]" ]; then
|
||||
echo "Creating custom secrets..."
|
||||
echo "$SECRETS" | jq -c '.[]' | while read -r secret; do
|
||||
SECRET_NAME=$(echo "$secret" | jq -r '.name')
|
||||
SECRET_TYPE=$(echo "$secret" | jq -r '.type // "generic"')
|
||||
SECRET_DATA=$(echo "$secret" | jq -r '.data')
|
||||
|
||||
echo "Creating secret: $SECRET_NAME (type: $SECRET_TYPE)"
|
||||
|
||||
# Create the secret using kubectl
|
||||
echo "$SECRET_DATA" | kubectl create secret $SECRET_TYPE $SECRET_NAME \
|
||||
--from-literal=secret.json="$SECRET_DATA" \
|
||||
--namespace=${{ steps.namespace.outputs.namespace }} \
|
||||
--dry-run=client -o yaml | kubectl apply -f -
|
||||
done
|
||||
else
|
||||
echo "No custom secrets to create"
|
||||
fi
|
||||
- name: Deploy Kubernetes manifests
|
||||
uses: azure/k8s-deploy@c8cfec839dc09896b3b8cc40cd13d04792680771 # v5.1.0
|
||||
uses: azure/k8s-deploy@c7ebd0d5f39477a23f1b5dea0f52e6db04adf28e # v6.0.0
|
||||
with:
|
||||
action: deploy
|
||||
manifests: "${{ inputs.k8s_dir }}"
|
||||
strategy: basic
|
||||
namespace: ${{ steps.namespace.outputs.namespace }}
|
||||
namespace: ${{ inputs.namespace || steps.namespace.outputs.namespace }}
|
||||
|
||||
deploy-helm:
|
||||
runs-on: ubuntu-latest
|
||||
@@ -120,45 +124,22 @@ jobs:
|
||||
inputs.skip_helm_deployment != 'true'
|
||||
steps:
|
||||
- uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
|
||||
with:
|
||||
ref: ${{ inputs.deploy_branch }}
|
||||
- uses: ./.gitea/actions/extract-namespace-from-repo-name
|
||||
- uses: https://gitea.t000-n.de/t.behrendt/k_deploy_actions/.gitea/actions/extract-namespace-from-repo-name@0.0.1
|
||||
id: namespace
|
||||
with:
|
||||
repo: ${{ github.repository }}
|
||||
- uses: azure/setup-kubectl@776406bce94f63e41d621b960d78ee25c8b76ede # v4.0.1
|
||||
- uses: azure/setup-helm@1a275c3b69536ee54be43f2070a358922e12c8d4 # v4
|
||||
- uses: azure/k8s-set-context@ae59a723ba9abe7a9655538854a025448dbab4aa # v4.0.2
|
||||
- uses: azure/setup-kubectl@829323503d1be3d00ca8346e5391ca0b07a9ab0d # v5.1.0
|
||||
- uses: azure/setup-helm@dda3372f752e03dde6b3237bc9431cdc2f7a02a2 # v5
|
||||
- uses: azure/k8s-set-context@89b837d75b40a7bd2ddafde837473c212db8b313 # v5.0.0
|
||||
with:
|
||||
method: kubeconfig
|
||||
kubeconfig: ${{ secrets.KUBECONFIG }}
|
||||
- name: Create custom secrets
|
||||
id: create-secrets
|
||||
run: |
|
||||
# Parse custom secrets from input
|
||||
SECRETS='${{ inputs.custom_secrets }}'
|
||||
if [ "$SECRETS" != "[]" ]; then
|
||||
echo "Creating custom secrets..."
|
||||
echo "$SECRETS" | jq -c '.[]' | while read -r secret; do
|
||||
SECRET_NAME=$(echo "$secret" | jq -r '.name')
|
||||
SECRET_TYPE=$(echo "$secret" | jq -r '.type // "generic"')
|
||||
SECRET_DATA=$(echo "$secret" | jq -r '.data')
|
||||
|
||||
echo "Creating secret: $SECRET_NAME (type: $SECRET_TYPE)"
|
||||
|
||||
# Create the secret using kubectl
|
||||
echo "$SECRET_DATA" | kubectl create secret $SECRET_TYPE $SECRET_NAME \
|
||||
--from-literal=secret.json="$SECRET_DATA" \
|
||||
--namespace=${{ steps.namespace.outputs.namespace }} \
|
||||
--dry-run=client -o yaml | kubectl apply -f -
|
||||
done
|
||||
else
|
||||
echo "No custom secrets to create"
|
||||
fi
|
||||
- name: Deploy Helm
|
||||
uses: helmfile/helmfile-action@c58e4737b8a69764d8294a70fcbcb0a63573dae9 # v2.3.1
|
||||
uses: helmfile/helmfile-action@f6f7844b9e6d9f5ac8cf4cdae8ada1a42755c036 # v2.4.4
|
||||
with:
|
||||
helmfile-args: apply
|
||||
namespace: ${{ inputs.namespace || steps.namespace.outputs.namespace }}
|
||||
env: ${{ fromJSON(inputs.helmfile_env) }}
|
||||
|
||||
# Summary job that always runs to show what was deployed
|
||||
deployment-summary:
|
||||
@@ -187,11 +168,3 @@ jobs:
|
||||
|
||||
echo "" >> $GITHUB_STEP_SUMMARY
|
||||
echo "**Service Type**: ${{ needs.detect-service-type.outputs.has_helmfile == 'true' && 'Helm + Kubernetes' || 'Kubernetes Only' }}" >> $GITHUB_STEP_SUMMARY
|
||||
|
||||
# Show custom secrets info
|
||||
SECRETS='${{ inputs.custom_secrets }}'
|
||||
if [ "$SECRETS" != "[]" ]; then
|
||||
echo "" >> $GITHUB_STEP_SUMMARY
|
||||
echo "**Custom Secrets Created**: $(echo "$SECRETS" | jq length)" >> $GITHUB_STEP_SUMMARY
|
||||
echo "$SECRETS" | jq -r '.[] | "- " + .name + " (" + (.type // "generic") + ")"' >> $GITHUB_STEP_SUMMARY
|
||||
fi
|
||||
@@ -5,8 +5,9 @@ on:
|
||||
branches:
|
||||
- main
|
||||
paths:
|
||||
- ".gitea/workflows/cd.yaml"
|
||||
- ".gitea/workflows/ci.yaml"
|
||||
- ".gitea/workflows/deploy.yaml"
|
||||
- ".gitea/workflows/validate.yaml"
|
||||
workflow_dispatch:
|
||||
|
||||
jobs:
|
||||
release:
|
||||
@@ -18,10 +19,10 @@ jobs:
|
||||
fetch-depth: 0
|
||||
- name: Increment tag
|
||||
id: tag
|
||||
uses: https://gitea.t000-n.de/t.behrendt/conventional-semantic-git-tag-increment@41b7e04221df8a033bec841d40a097b76e5f67ff # 0.1.29
|
||||
uses: https://gitea.t000-n.de/t.behrendt/conventional-semantic-git-tag-increment@ef0c23189db33220a73022d8c29a27709d0df440 # 0.1.32
|
||||
with:
|
||||
token: ${{ secrets.GITEA_TOKEN }}
|
||||
- name: Push tag
|
||||
uses: https://gitea.t000-n.de/t.behrendt/actions/release-git-tag@3925c92fc33f3d2bc87d28d21ab691b7e6dd6cdf # 0.2.1
|
||||
uses: https://gitea.t000-n.de/t.behrendt/actions/release-git-tag@38c1bbd8bad3e7965744d03de85faa4a5b808d1b # 0.2.4
|
||||
with:
|
||||
tag: ${{ steps.tag.outputs.new-tag }}
|
||||
|
||||
@@ -18,6 +18,16 @@ on:
|
||||
required: false
|
||||
default: false
|
||||
type: boolean
|
||||
helmfile_env:
|
||||
description: "Optional JSON object string of environment variables for Helmfile"
|
||||
required: false
|
||||
default: "{}"
|
||||
type: string
|
||||
namespace:
|
||||
description: "Override the default namespace (extracted from repository name)"
|
||||
required: false
|
||||
default: ""
|
||||
type: string
|
||||
|
||||
jobs:
|
||||
detect-service-type:
|
||||
@@ -54,19 +64,19 @@ jobs:
|
||||
if: needs.detect-service-type.outputs.has_k8s == 'true'
|
||||
steps:
|
||||
- uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
|
||||
- uses: ./.gitea/actions/extract-namespace-from-repo-name
|
||||
- uses: https://gitea.t000-n.de/t.behrendt/k_deploy_actions/.gitea/actions/extract-namespace-from-repo-name@0.0.1
|
||||
id: namespace
|
||||
with:
|
||||
repo: ${{ github.repository }}
|
||||
- uses: azure/setup-kubectl@776406bce94f63e41d621b960d78ee25c8b76ede # v4.0.1
|
||||
- uses: azure/k8s-set-context@ae59a723ba9abe7a9655538854a025448dbab4aa # v4.0.2
|
||||
- uses: azure/setup-kubectl@829323503d1be3d00ca8346e5391ca0b07a9ab0d # v5.1.0
|
||||
- uses: azure/k8s-set-context@89b837d75b40a7bd2ddafde837473c212db8b313 # v5.0.0
|
||||
with:
|
||||
method: kubeconfig
|
||||
kubeconfig: ${{ secrets.KUBECONFIG }}
|
||||
- name: Validate k8s manifests
|
||||
uses: azure/k8s-lint@6aefe5066f95e73d2b140d8835cc95583b886989 # v3.0.1
|
||||
uses: azure/k8s-lint@e4234c50ea835112e72b145bdecd00a94bad42fd # v4.0.0
|
||||
with:
|
||||
namespace: ${{ steps.namespace.outputs.namespace }}
|
||||
namespace: ${{ inputs.namespace || steps.namespace.outputs.namespace }}
|
||||
lintType: dryrun
|
||||
manifests: "${{ inputs.k8s_dir }}"
|
||||
|
||||
@@ -79,20 +89,22 @@ jobs:
|
||||
inputs.skip_helm_validation != 'true'
|
||||
steps:
|
||||
- uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
|
||||
- uses: ./.gitea/actions/extract-namespace-from-repo-name
|
||||
- uses: https://gitea.t000-n.de/t.behrendt/k_deploy_actions/.gitea/actions/extract-namespace-from-repo-name@0.0.1
|
||||
id: namespace
|
||||
with:
|
||||
repo: ${{ github.repository }}
|
||||
- uses: azure/setup-kubectl@776406bce94f63e41d621b960d78ee25c8b76ede # v4.0.1
|
||||
- uses: azure/setup-helm@1a275c3b69536ee54be43f2070a358922e12c8d4 # v4
|
||||
- uses: azure/k8s-set-context@ae59a723ba9abe7a9655538854a025448dbab4aa # v4.0.2
|
||||
- uses: azure/setup-kubectl@829323503d1be3d00ca8346e5391ca0b07a9ab0d # v5.1.0
|
||||
- uses: azure/setup-helm@dda3372f752e03dde6b3237bc9431cdc2f7a02a2 # v5
|
||||
- uses: azure/k8s-set-context@89b837d75b40a7bd2ddafde837473c212db8b313 # v5.0.0
|
||||
with:
|
||||
method: kubeconfig
|
||||
kubeconfig: ${{ secrets.KUBECONFIG }}
|
||||
- name: Validate Helm
|
||||
uses: helmfile/helmfile-action@c58e4737b8a69764d8294a70fcbcb0a63573dae9 # v2.3.1
|
||||
uses: helmfile/helmfile-action@f6f7844b9e6d9f5ac8cf4cdae8ada1a42755c036 # v2.4.4
|
||||
with:
|
||||
helmfile-args: diff
|
||||
namespace: ${{ inputs.namespace || steps.namespace.outputs.namespace }}
|
||||
env: ${{ fromJSON(inputs.helmfile_env) }}
|
||||
|
||||
# Summary job that always runs to show what was validated
|
||||
ci-summary:
|
||||
@@ -1,79 +1,77 @@
|
||||
> [!WARNING]
|
||||
> Repo is currently not in use and not tested.
|
||||
> We are waiting for proper shared workflow UI support in gitea. Otherwise errors are hard to identify.
|
||||
> Follow https://github.com/go-gitea/gitea/issues/24604
|
||||
# Reusable CI/CD Workflows for k\_ Services
|
||||
|
||||
# Reusable CI Workflow for Kubernetes Services
|
||||
|
||||
This directory contains a reusable CI workflow that automatically detects and validates your Kubernetes services, whether they use Helm + Kubernetes or just Kubernetes manifests.
|
||||
This repository contains reusable CI and CD workflows that automatically detect Kubernetes service type (Kubernetes-only vs Helm + Kubernetes) and execute the relevant steps.
|
||||
|
||||
## Features
|
||||
|
||||
- **Automatic Detection**: Automatically detects if your service uses Helm (helmfile.yaml) or just Kubernetes manifests
|
||||
- **Conditional Validation**: Only runs Helm validation when helmfile.yaml exists
|
||||
- **Flexible Paths**: Configurable paths for k8s directory and helmfile
|
||||
- **Comprehensive Validation**: Validates both Kubernetes manifests and Helm charts
|
||||
- **CI Summary**: Provides a clear summary of what was validated
|
||||
- **Reusable CI and CD**: Separate reusable workflows for validation and deployment
|
||||
- **Automatic Detection**: Detects whether `helmfile.yaml` exists and whether `k8s/` exists
|
||||
- **Conditional Execution**: Runs Helm steps only when applicable
|
||||
- **Flexible Inputs**: Supports custom `k8s_dir` and `helmfile_path`
|
||||
|
||||
## Usage
|
||||
|
||||
### Basic Usage (Recommended)
|
||||
### Basic CI Usage
|
||||
|
||||
Simply call the workflow without any parameters - it will automatically detect your service type:
|
||||
Call the reusable CI workflow:
|
||||
|
||||
```yaml
|
||||
jobs:
|
||||
ci:
|
||||
uses: ./.gitea/workflows/ci.yaml
|
||||
uses: https://gitea.t000-n.de/t.behrendt/k_deploy_workflows/.gitea/workflows/ci.yaml@main
|
||||
secrets: inherit
|
||||
```
|
||||
|
||||
### Advanced Usage with Custom Paths
|
||||
### Basic CD Usage
|
||||
|
||||
If your service uses non-standard directory names:
|
||||
Call the reusable CD workflow:
|
||||
|
||||
```yaml
|
||||
jobs:
|
||||
deploy:
|
||||
uses: https://gitea.t000-n.de/t.behrendt/k_deploy_workflows/.gitea/workflows/cd.yaml@main
|
||||
secrets: inherit
|
||||
```
|
||||
|
||||
### Advanced Usage with Custom Paths and Flags
|
||||
|
||||
```yaml
|
||||
jobs:
|
||||
ci:
|
||||
uses: ./.gitea/workflows/ci.yaml
|
||||
uses: https://gitea.t000-n.de/t.behrendt/k_deploy_workflows/.gitea/workflows/ci.yaml@main
|
||||
with:
|
||||
k8s_dir: "kubernetes/"
|
||||
helmfile_path: "helm/helmfile.yaml"
|
||||
```
|
||||
|
||||
### Force Skip Helm Validation
|
||||
|
||||
If you want to skip Helm validation even when helmfile.yaml exists:
|
||||
|
||||
```yaml
|
||||
jobs:
|
||||
ci:
|
||||
uses: ./.gitea/workflows/ci.yaml
|
||||
with:
|
||||
skip_helm_validation: true
|
||||
secrets: inherit
|
||||
```
|
||||
|
||||
## Input Parameters
|
||||
## Inputs
|
||||
|
||||
### CI (`.gitea/workflows/ci.yaml`)
|
||||
|
||||
| Parameter | Description | Default | Required |
|
||||
| ---------------------- | -------------------------------------------- | --------------- | -------- |
|
||||
| ---------------------- | --------------------------------------------------------------- | --------------- | -------- |
|
||||
| `k8s_dir` | Path to Kubernetes manifests directory | `k8s/` | No |
|
||||
| `helmfile_path` | Path to helmfile.yaml | `helmfile.yaml` | No |
|
||||
| `skip_helm_validation` | Skip Helm validation even if helmfile exists | `false` | No |
|
||||
| `helmfile_env` | JSON object string passed as env to helmfile | `{}` | No |
|
||||
| `namespace` | Override the default namespace (extracted from repository name) | `""` | No |
|
||||
|
||||
### CD (`.gitea/workflows/cd.yaml`)
|
||||
|
||||
| Parameter | Description | Default | Required |
|
||||
| -------------------------------- | --------------------------------------------------------------- | --------------- | -------- |
|
||||
| `k8s_dir` | Path to Kubernetes manifests directory | `k8s/` | No |
|
||||
| `helmfile_path` | Path to helmfile.yaml | `helmfile.yaml` | No |
|
||||
| `skip_helm_deployment` | Skip Helm deployment even if helmfile exists | `false` | No |
|
||||
| `skip_shared_secrets_deployment` | Skip shared secrets deployment | `false` | No |
|
||||
| `helmfile_env` | JSON object string passed as env to helmfile | `{}` | No |
|
||||
| `namespace` | Override the default namespace (extracted from repository name) | `""` | No |
|
||||
|
||||
## Directory Structure Requirements
|
||||
|
||||
### For Kubernetes-only services:
|
||||
|
||||
```
|
||||
your-service/
|
||||
├── k8s/
|
||||
│ ├── deployment.yaml
|
||||
│ ├── service.yaml
|
||||
│ └── ...
|
||||
└── .gitea/workflows/your-workflow.yaml
|
||||
```
|
||||
|
||||
### For Helm + Kubernetes services:
|
||||
### Full example structure (Helm + Kubernetes):
|
||||
|
||||
```
|
||||
your-service/
|
||||
@@ -84,79 +82,3 @@ your-service/
|
||||
├── helmfile.yaml
|
||||
└── .gitea/workflows/your-workflow.yaml
|
||||
```
|
||||
|
||||
## What Gets Validated
|
||||
|
||||
### Always (if k8s/ directory exists):
|
||||
|
||||
- Kubernetes manifest validation using `kubectl --dry-run`
|
||||
- Namespace extraction from repository name
|
||||
- Basic Kubernetes syntax and schema validation
|
||||
|
||||
### Conditionally (if helmfile.yaml exists and Helm validation not skipped):
|
||||
|
||||
- Helm chart validation using `helmfile diff`
|
||||
- Kubernetes manifests in Helm context
|
||||
- Helm-specific configurations and values
|
||||
|
||||
## Example Workflows
|
||||
|
||||
See `example-usage.yaml` for complete examples of how to use this workflow in different scenarios.
|
||||
|
||||
## Available Actions
|
||||
|
||||
### Extract Chart Name from Repository Name
|
||||
|
||||
The `extract-chart-name-from-repo-name` action extracts the chart name from repository names following the `helm-<chart-name>` convention.
|
||||
|
||||
#### Usage
|
||||
|
||||
```yaml
|
||||
- name: Extract chart name
|
||||
uses: ./.gitea/actions/extract-chart-name-from-repo-name
|
||||
with:
|
||||
repo: ${{ github.repository_name }} # e.g., "helm-my-service"
|
||||
```
|
||||
|
||||
#### Inputs
|
||||
|
||||
| Parameter | Description | Required |
|
||||
| --------- | ------------------------------------------------ | -------- |
|
||||
| `repo` | The full repository name (e.g., "helm-my-chart") | Yes |
|
||||
|
||||
#### Outputs
|
||||
|
||||
| Output | Description |
|
||||
| ------------ | ---------------------------------------------------------------- |
|
||||
| `chart-name` | The extracted chart name (e.g., "my-chart" from "helm-my-chart") |
|
||||
|
||||
#### Example
|
||||
|
||||
For a repository named `helm-user-service`, this action will extract `user-service` as the chart name.
|
||||
|
||||
## Dependencies
|
||||
|
||||
This workflow requires:
|
||||
|
||||
- `./.gitea/actions/extract-namespace-from-repo-name` action
|
||||
- `./.gitea/actions/extract-chart-name-from-repo-name` action
|
||||
- `KUBECONFIG` secret configured in your repository
|
||||
- Access to your Kubernetes cluster
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### Helm validation skipped unexpectedly
|
||||
|
||||
- Check if `helmfile.yaml` exists in the expected location
|
||||
- Verify the `skip_helm_validation` parameter is not set to `true`
|
||||
- Ensure the file path is correct if using custom paths
|
||||
|
||||
### Kubernetes validation skipped
|
||||
|
||||
- Verify the `k8s/` directory (or custom path) exists
|
||||
- Check the directory contains valid Kubernetes manifests
|
||||
|
||||
### Permission issues
|
||||
|
||||
- Ensure the `KUBECONFIG` secret is properly configured
|
||||
- Verify the workflow has access to your Kubernetes cluster
|
||||
|
||||
+1
-4
@@ -1,7 +1,4 @@
|
||||
{
|
||||
"$schema": "https://docs.renovatebot.com/renovate-schema.json",
|
||||
"extends": [
|
||||
"local>t.behrendt/renovate-configs:common",
|
||||
"local>t.behrendt/renovate-configs:action"
|
||||
]
|
||||
"extends": ["local>t.behrendt/renovate-configs:action"]
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user