dnspod

Documentation

Index

• type Solver
  • func (c *Solver) CleanUp(ch *acme.ChallengeRequest) error
  • func (c *Solver) Initialize(kubeClientConfig *rest.Config, stopCh <-chan struct{}) error
  • func (c *Solver) Name() string
  • func (c *Solver) Present(ch *acme.ChallengeRequest) error

Types

type Solver

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

Solver implements the provider-specific logic needed to 'present' an ACME challenge TXT record for your own DNS provider. To do so, it must implement the `github.com/jetstack/cert-manager/pkg/acme/webhook.Solver` interface.

func (*Solver) CleanUp

func (c *Solver) CleanUp(ch *acme.ChallengeRequest) error

CleanUp should delete the relevant TXT record from the DNS provider console. If multiple TXT records exist with the same record name (e.g. _acme-challenge.example.com) then **only** the record with the same `key` value provided on the ChallengeRequest should be cleaned up. This is in order to facilitate multiple DNS validations for the same domain concurrently.

func (*Solver) Initialize

func (c *Solver) Initialize(kubeClientConfig *rest.Config, stopCh <-chan struct{}) error

Initialize will be called when the webhook first starts. This method can be used to instantiate the webhook, i.e. initialising connections or warming up caches. Typically, the kubeClientConfig parameter is used to build a Kubernetes client that can be used to fetch resources from the Kubernetes API, e.g. Secret resources containing credentials used to authenticate with DNS provider accounts. The stopCh can be used to handle early termination of the webhook, in cases where a SIGTERM or similar signal is sent to the webhook process.

func (*Solver) Name

func (c *Solver) Name() string

Name is used as the name for this DNS solver when referencing it on the ACME Issuer resource. This should be unique **within the group name**, i.e. you can have two solvers configured with the same Name() **so long as they do not co-exist within a single webhook deployment**.

func (*Solver) Present

func (c *Solver) Present(ch *acme.ChallengeRequest) error

Present is responsible for actually presenting the DNS record with the DNS provider. This method should tolerate being called multiple times with the same value. cert-manager itself will later perform a self check to ensure that the solver has correctly configured the DNS provider.