Function.SDK.CSharp.SourceGenerator 1.0.0-alpha.42

function-sdk-csharp

The C# SDK for writing composition functions.

Features

• XRD to Model Generation
  • Modify the xrd.yaml and models will be automatically generated
• CRD to Model Generation
  • Add crd.yaml(s) to the project and models will be automatically generated
  • Most Crossplane Providers already published KubernetesCRDModelGen | Group | NuGet | |---|---| | aws.upbound.io | Link | | azapi.upbound.io | Link | | azure.upbound.io | Link | | azuread.upbound.io | Link | | crossplane.io | Link | | databricks.crossplane.io | Link | | gcp.upbound.io | Link | | helm.crossplane.io | Link | | kubernetes.crossplane.io | Link | | opentofu.upbound.io | Link | | tf.upbound.io | Link | | upbound.io | Link | | vault.upbound.io | Link |
• Supports Crossplane v1.17 or greater

How to Test

You can run your function locally and test it using crossplane render with the example manifests.

Download Crank and rename to Crossplane

https://releases.crossplane.io/stable/current/bin

Run Function In IDE

Download the lastest .NET 9 SDK

dotnet debug

Run Function In Docker

docker build -t function-sdk-csharp-sample -f src/Function.SDK.CSharp.Sample/Dockerfile src
docker run -it -p 9443:9443 function-sdk-csharp-sample

Run Test

Then, in another terminal, call it with these example manifests

crossplane render example/xr.yaml example/composition.yaml example/functions.yaml

---
apiVersion: platform.example.com/v1alpha1
kind: XStorageBucket
metadata:
  name: example
status:
  conditions:
  - lastTransitionTime: "2024-01-01T00:00:00Z"
    message: 'Unready resources: account, container, and rg'
    reason: Creating
    status: "False"
    type: Ready
---
apiVersion: storage.azure.upbound.io/v1beta1
kind: Account
metadata:
  annotations:
    crossplane.io/composition-resource-name: account
  labels:
    crossplane.io/composite: example
  name: example
  ownerReferences:
  - apiVersion: platform.example.com/v1alpha1
    blockOwnerDeletion: true
    controller: true
    kind: XStorageBucket
    name: example
    uid: ""
spec:
  forProvider:
    accountReplicationType: LRS
    accountTier: Standard
    blobProperties:
    - versioningEnabled: true
    infrastructureEncryptionEnabled: true
    location: eastus
    resourceGroupNameSelector:
      matchLabels:
        matchControllerRef: "True"
---
apiVersion: storage.azure.upbound.io/v1beta1
kind: Container
metadata:
  annotations:
    crossplane.io/composition-resource-name: container
  generateName: example-
  labels:
    crossplane.io/composite: example
  ownerReferences:
  - apiVersion: platform.example.com/v1alpha1
    blockOwnerDeletion: true
    controller: true
    kind: XStorageBucket
    name: example
    uid: ""
spec:
  forProvider:
    containerAccessType: public
    storageAccountNameSelector:
      matchLabels:
        matchControllerRef: "True"
---
apiVersion: azure.upbound.io/v1beta1
kind: ResourceGroup
metadata:
  annotations:
    crossplane.io/composition-resource-name: rg
  generateName: example-
  labels:
    crossplane.io/composite: example
  ownerReferences:
  - apiVersion: platform.example.com/v1alpha1
    blockOwnerDeletion: true
    controller: true
    kind: XStorageBucket
    name: example
    uid: ""
spec:
  forProvider:
    location: eastus