refs

Documentation

Overview

Package refs provides unified reference resolution for Cloudflare resources. It supports resolving references by K8s name, Cloudflare UUID, or Cloudflare display name.

Index

• type Resolver
  • func NewResolver(c client.Client, api *cf.API) *Resolver
  • func (r *Resolver) ResolveAllGroups(ctx context.Context, refs []networkingv1alpha2.ReusableGroupRef) ([]string, []error)
  • func (r *Resolver) ResolveAllIdentityProviders(ctx context.Context, directIDs []string, ...) ([]string, []error)
  • func (r *Resolver) ResolveGroup(ctx context.Context, ref *networkingv1alpha2.ReusableGroupRef) (string, error)
  • func (r *Resolver) ResolveIdentityProvider(ctx context.Context, ref *networkingv1alpha2.AccessIdentityProviderRefV2) (string, error)
  • func (r *Resolver) ResolveVirtualNetwork(ctx context.Context, ref *networkingv1alpha2.VirtualNetworkRef) (string, error)

Types

type Resolver

type Resolver struct {
	// contains filtered or unexported fields
}

Resolver resolves Cloudflare resource references. It supports three resolution modes: 1. K8s CRD name - looks up the CRD and extracts the Cloudflare ID from status 2. Direct Cloudflare ID - uses the provided UUID directly 3. Cloudflare display name - queries the Cloudflare API to resolve name to ID

func NewResolver

func NewResolver(c client.Client, api *cf.API) *Resolver

NewResolver creates a new reference resolver.

func (*Resolver) ResolveAllGroups

func (r *Resolver) ResolveAllGroups(
	ctx context.Context,
	refs []networkingv1alpha2.ReusableGroupRef,
) ([]string, []error)

ResolveAllGroups resolves all group references to Cloudflare Group IDs.

func (*Resolver) ResolveAllIdentityProviders

func (r *Resolver) ResolveAllIdentityProviders(
	ctx context.Context,
	directIDs []string,
	refs []networkingv1alpha2.AccessIdentityProviderRefV2,
) ([]string, []error)

ResolveAllIdentityProviders resolves all IdP references to Cloudflare IdP IDs. It handles deduplication automatically.

func (*Resolver) ResolveGroup

func (r *Resolver) ResolveGroup(ctx context.Context, ref *networkingv1alpha2.ReusableGroupRef) (string, error)

ResolveGroup resolves a ReusableGroupRef to a Cloudflare Access Group ID. Resolution priority: cloudflareId > name > cloudflareName

func (*Resolver) ResolveIdentityProvider

func (r *Resolver) ResolveIdentityProvider(ctx context.Context, ref *networkingv1alpha2.AccessIdentityProviderRefV2) (string, error)

ResolveIdentityProvider resolves an AccessIdentityProviderRefV2 to a Cloudflare IdP ID. Resolution priority: cloudflareId > name > cloudflareName

func (*Resolver) ResolveVirtualNetwork

func (r *Resolver) ResolveVirtualNetwork(ctx context.Context, ref *networkingv1alpha2.VirtualNetworkRef) (string, error)

ResolveVirtualNetwork resolves a VirtualNetworkRef to a Cloudflare VNet ID. Resolution priority: cloudflareId > name > cloudflareName