terraform/website/source/docs/providers/rancher/r/certificate.html.markdown

2.0 KiB

layout page_title sidebar_current description
rancher Rancher: rancher_certificate docs-rancher-resource-certificate Provides a Rancher Certificate resource. This can be used to create certificates for rancher environments and retrieve their information.

rancher_certificate

Provides a Rancher Certificate resource. This can be used to create certificates for rancher environments and retrieve their information.

Example Usage

# Create a new Rancher Certificate
resource rancher_certificate "foo" {
  name           = "foo"
  description    = "my foo certificate"
  environment_id = "${rancher_environment.test.id}"
  cert = "${file("server.crt")}"
  key = "${file("server.key")}"
}

Argument Reference

The following arguments are supported:

  • name - (Required) The name of the registry credential.
  • description - (Optional) A registry credential description.
  • environment_id - (Required) The ID of the environment to create the certificate for.
  • cert - (Required) The certificate content.
  • cert_chain - (Optional) The certificate chain.
  • key - (Required) The certificate key.

Attributes Reference

The following attributes are exported:

  • cn - The certificate CN.
  • algorithm - The certificate algorithm.
  • cert_fingerprint - The certificate fingerprint.
  • expires_at - The certificate expiration date.
  • issued_at - The certificate creation date.
  • issuer - The certificate issuer.
  • key_size - The certificate key size.
  • serial_number - The certificate serial number.
  • subject_alternative_names - The list of certificate Subject Alternative Names.
  • version - The certificate version.

Import

Registry credentials can be imported using the Registry and credentials IDs in the format <environment_id>/<certificate_id>

$ terraform import rancher_certificate.mycert 1sp31/1c605

If the credentials for the Rancher provider have access to the global API, then environment_id can be omitted e.g.

$ terraform import rancher_certificate.mycert 1c605