Documentation / Examples / Complete Platform

Complete Platform

📋 About This Example

Use case: A complete example with both Platform and GiteaProvider CRs in a single file. This shows the full configuration with all components together.

Complexity: Intermediate

Components: Platform CR, GiteaProvider CR (inline)

⬇ Download YAML

Overview

This example shows a complete configuration that includes both the GiteaProvider and Platform CRs in a single YAML file, demonstrating the full stack.

This configuration is perfect for:

  • Deploying everything in one go
  • Understanding the relationship between Platform and providers
  • Creating a complete development environment
  • Learning the full Platform specification

YAML Configuration

---
# First create the GiteaProvider
apiVersion: idpbuilder.cnoe.io/v1alpha2
kind: GiteaProvider
metadata:
  name: my-gitea
  namespace: gitea
spec:
  namespace: gitea
  version: "1.24.3"
  adminUser:
    username: giteaAdmin
    email: admin@cnoe.localtest.me
    autoGenerate: true
  organizations:
    - name: cnoe
      description: CNOE Organization
---
# Then create the Platform that references it
apiVersion: idpbuilder.cnoe.io/v1alpha2
kind: Platform
metadata:
  name: my-platform
  namespace: default
spec:
  domain: cnoe.localtest.me
  components:
    gitProviders:
      - name: my-gitea
        kind: GiteaProvider
        namespace: gitea

Prerequisites

Before applying this configuration, ensure you have:

  • A Kubernetes cluster running
  • IDP Builder CRDs installed
  • kubectl configured to access your cluster

Usage

1. Apply the manifest

kubectl apply -f platform-complete.yaml

2. Check the status

# View resources
kubectl get platform

# Get detailed information
kubectl describe platform

Next Steps

After deploying this example, you can: