Documentation / Examples / V1Alpha2 / Platform with Gateway

Platform with Gateway

📋 About This Example

Use case: A v1alpha2 Platform CR that includes both GiteaProvider and NginxGateway, demonstrating the modular provider-based architecture.

Complexity: Intermediate

Components: Platform CR, GiteaProvider reference, NginxGateway reference

⬇ Download YAML

Overview

This v1alpha2 example demonstrates the modular architecture where platform components are managed through separate Custom Resources.

This configuration is perfect for:

  • Multi-component platform setups
  • Understanding v1alpha2 architecture
  • Production-ready configurations
  • Gateway integration with Platform

YAML Configuration

apiVersion: idpbuilder.cnoe.io/v1alpha2
kind: Platform
metadata:
  name: localdev
  namespace: idpbuilder-system
spec:
  domain: cnoe.localtest.me
  components:
    gitProviders:
      - name: gitea-local
        kind: GiteaProvider
        namespace: idpbuilder-system
    gateways:
      - name: nginx-gateway
        kind: NginxGateway
        namespace: idpbuilder-system

Prerequisites

Before applying this configuration, ensure you have:

  • Kubernetes cluster
  • IDP Builder CRDs installed
  • Both gitea-local GiteaProvider and nginx-gateway NginxGateway CRs created

Usage

1. Apply the manifest

kubectl apply -f platform-with-gateway.yaml

2. Check the status

# View resources
kubectl get platform

# Get detailed information
kubectl describe platform

Next Steps

After deploying this example, you can: