Documentation / Examples / Simple GiteaProvider

Simple GiteaProvider

📋 About This Example

Use case: A basic GiteaProvider CR with auto-generated credentials and organizations. This is the easiest way to get a Git server running.

Complexity: Beginner

Components: GiteaProvider CR

⬇ Download YAML

Overview

This example demonstrates a standalone GiteaProvider configuration with auto-generated credentials and pre-configured organizations.

This configuration is perfect for:

  • Quick Git provider setup
  • Testing Gitea functionality
  • Development environments
  • Learning GiteaProvider configuration

YAML Configuration

apiVersion: idpbuilder.cnoe.io/v1alpha2
kind: GiteaProvider
metadata:
  name: my-gitea
  namespace: gitea
spec:
  # Namespace where Gitea will be deployed
  namespace: gitea
  
  # Gitea version to install
  version: "1.24.3"
  
  # Admin user configuration
  adminUser:
    username: giteaAdmin
    email: admin@cnoe.localtest.me
    autoGenerate: true  # Auto-generate credentials if not provided
    # To use existing credentials, specify:
    # passwordSecretRef:
    #   name: my-gitea-password
    #   namespace: gitea
    #   key: password
  
  # Organizations to create in Gitea
  organizations:
    - name: cnoe
      description: CNOE Organization
    - name: demo
      description: Demo Organization

Prerequisites

Before applying this configuration, ensure you have:

  • A Kubernetes cluster
  • IDP Builder CRDs installed
  • Sufficient cluster resources (see minimum requirements)

Usage

1. Apply the manifest

kubectl apply -f giteaprovider-simple.yaml

2. Check the status

# View resources
kubectl get giteaprovider

# Get detailed information
kubectl describe giteaprovider

Next Steps

After deploying this example, you can: