Aspirerelease/17.0
Watch Aspire live streamsDocsTry Aspire

CertManagerIssuerResource

Handle
📦 Aspire.Hosting.Kubernetes v13.6.5-preview.1.26559.7

Represents a cert-manager ClusterIssuer resource in the Aspire application model.

type CertManagerIssuerResource interface {
Resource
ResourceWithParent
}

Methods

methodWithAcmeServerbuilder
Configures the issuer to use a custom ACME directory endpoint (e.g., a private ACME server such as ZeroSSL or step-ca).
WithAcmeServer(
serverUrl string,
email string,
) CertManagerIssuerResource
serverUrlstringThe ACME directory URL (e.g., https://acme.example.com/directory).
emailstringThe contact email registered with the ACME account.
CertManagerIssuerResource

The resource builder.

Returns a handle; failures surface later via Err().

methodWithAcmeServerParambuilder
Configures the issuer to use a custom ACME directory endpoint with a parameterized email.
WithAcmeServerParam(
serverUrl string,
email ParameterResource,
) CertManagerIssuerResource
serverUrlstringThe ACME directory URL (e.g., https://acme.example.com/directory).
emailParameterResourceA parameter resource builder whose value is the contact email registered with the ACME account.
CertManagerIssuerResource

The resource builder.

Returns a handle; failures surface later via Err().

methodWithHttp01Solverbuilder
Adds an HTTP-01 ACME challenge solver to the issuer. cert-manager will satisfy the challenge by provisioning a temporary HTTP route at /.well-known/acme-challenge/{token} on the same hostname being validated. This requires the hostname to be publicly reachable on port 80.
WithHttp01Solver() CertManagerIssuerResource
CertManagerIssuerResource

The resource builder.

Returns a handle; failures surface later via Err().

Configures the issuer to use the Let's Encrypt production ACME endpoint.
WithLetsEncryptProduction(email string) CertManagerIssuerResource
emailstringThe contact email registered with the ACME account. Let's Encrypt uses this address for expiry notifications and rate-limit appeals.
CertManagerIssuerResource

The resource builder.

Returns a handle; failures surface later via Err().

Configures the issuer to use the Let's Encrypt production ACME endpoint, with the contact email supplied via a parameter resolved at deploy time.
WithLetsEncryptProductionParam(email ParameterResource) CertManagerIssuerResource
emailParameterResourceA parameter resource builder whose value is the contact email registered with the ACME account.
CertManagerIssuerResource

The resource builder.

Returns a handle; failures surface later via Err().

Configures the issuer to use the Let's Encrypt staging ACME endpoint. Certificates issued from staging are not trusted by browsers, but the endpoint has much higher rate limits, making it the right choice for development and CI workflows.
WithLetsEncryptStaging(email string) CertManagerIssuerResource
emailstringThe contact email registered with the ACME account.
CertManagerIssuerResource

The resource builder.

Returns a handle; failures surface later via Err().

Configures the issuer to use the Let's Encrypt staging ACME endpoint, with the contact email supplied via a parameter resolved at deploy time.
WithLetsEncryptStagingParam(email ParameterResource) CertManagerIssuerResource
emailParameterResourceA parameter resource builder whose value is the contact email registered with the ACME account.
CertManagerIssuerResource

The resource builder.

Returns a handle; failures surface later via Err().