Creating a DNS Record.

In the portal, all [types of DNS records] are created through the record create wizard.

To get there:

  1. DNS from the main, left-hand navigation.
  2. Zones from the DNS sub-navigation menu.
  3. Select the zone from the first column.
  4. Add Record on the top right of the records page.

Record Create Wizard

After navigating to the record create wizard, a user can create a wide range of supported record types.

Root and Wildcard

To refer to the root domain, use @ in the name field. To create a wildcard domain use an asterisk * in the name field.

Wildcard Records

Creating a wildcard record with TLS certificate will cause all children of that record which are set to use TLS to use this wildcard certificate.

Deleting Wildcard Records

When the wildcard record is created with a TLS certificate it cannot be deleted if other records depend on it and trying to delete this record will show an error.

Using the Record Create Wizard

Use the following information to complete each form required for the record.

Fill in all fields (detailed below), then click Add Record.

Type: LINKED

LINKED records are a special type of record provided by the Cycle platform. These records get tied directly to a container, and alleviate the need to track and manage specific IP addresses. In addition, you can use LINKED records to generate and renew TLS/SSL certificates automatically (via Let's Encrypt). These certificates are terminated at the load balancer automatically, passing the traffic through to the container via port 80.

Field

Description

Name

Enter the subdomain for the record. For example, for subdomain.example.com, enter subdomain in the box. To set it to the root domain, use the @ symbol.

Environment

The environment the container this record will be associated with, lives in.

Link To

Use this row to select linking the record to a container directly or a deployment tag. If working with virtual machines, select virtual machine.

Enable TLS

Generate a certificate for this record or use the wildcard.

GeoDNS

DNS queries to the domain this LINKED record is associated with will then always return the 3 closest LB IP entries.

Direct to Container

Field

Description

Container

The container this record points to.

Field

Description

Container Identifier

The container identifier this record points to within the deployment defined in the next field.

Deployment Tag

The deployment tag that this record will associate traffic with. See platform deployments documentation for more information.

Virtual Machine

Field

Description

virtual machine

The virtual machine this record points to.

DMZ

Bypass the load balancer and send all traffic to the virtual machine via the gateway service.

TLS and DMZ

Using DMZ means using the gateway service which acts as a router. Cycle has no way to inject certificates to the virtual machine, nor will the gateway service act as a TLS termination endpoint. Do not click the TLS Enabled checkbox if using the DMZ option.

TLS Attempts

Users can try to create 3 certs for the same domain within 1 hour (manually). So if a user were to try to create a cert at 15, 30, and 45 past a given hour, they'd be locked out of trying again until 15 past the next hour. This is to ensure the domain doesn't get restricted by Let's Encrypt for too many requests (which can lead to a much longer timeout). If a certificate is created and fails and a user does not try to manually recreate the certificate, Cycle will re-attempt every 4 hours for 3 days.

Type: A

The A record specifies IP address (IPv4) for given host. A records are used for conversion of domain names to corresponding IP addresses.

Field

Description

Name

Enter the subdomain for the record, or @ to use the root domain.

IP

The IPv4 for this record.

Type: AAAA

The quad A record specifies IPv6 address for given host. It works the same way as the A record, the only difference being type of IP address.

Field

Description

Name

Enter the subdomain for the record, or @ to use the root domain.

IP

The IPv6 for this record.

Type: CNAME

The CNAME record is used to create aliases of domain names.

Field

Description

Name

Enter the subdomain for the record, or @ to use the root domain.

Domain

The domain for the record to map to.

Type: MX

The MX record specifies a mail exchange server for a domain name. The information is used by Simple Mail Transfer Protocol (SMTP) to route emails to proper hosts.

Field

Description

Name

Enter the subdomain for the record, or @ to use the root domain.

Priority

Record priority setting.

Domain

The domain of the mail server.

Type: TXT

The TXT record can hold an arbitrary non-formatted text string.

Field

Description

Name

Enter the subdomain you want for the record, or @ to use the root domain.

Value

The value to be served by the TXT record.

Type: ALIAS

An ALIAS record points a hostname at another domain, much like a CNAME . Unlike a CNAME it can be used at the zone apex (your root domain, e.g. example.com) and can coexist with other records on the same name. Cycle resolves the target at query time and returns its A/AAAA addresses, so resolvers see normal address records.

Field

Description

Name

The host the record applies to. Leave blank or use @ for the zone apex (example.com), or a subdomain like www for www.example.com.

Domain

The target domain this record resolves to (e.g. myapp.example.net). Cycle follows it and returns the target's address records.

Type: SRV

A service record (SRV) is a record that defines the location, hostname, and port of servers for specified services.

Field

Description

Name

The naming system is an underscore followed by the name of the service.

Priority

Information about the priority associated with this record, used to encourage use of certain servers over others.

Weight

If two or more services have the same priority, the weight number is used to determine which should come first.

Port

The port that is used to connect to for accessing the service.

CAA

A CAA (Certification Authority Authorization) record specifies which certificate authorities (CAs) are allowed to issue TLS/SSL certificates for your domain. It's a safeguard against mis-issuance: if a CA isn't listed, it shouldn't issue a certificate for the domain.

Field

Description

Name

The host the record applies to. Use @ for the zone apex, or a subdomain like acme for acme.example.com.

Tag

The CAA property to set. Common values: issue (authorize a CA to issue certificates), issuewild (authorize wildcard certificates), iodef (a URL or mailto: for the CA to report policy violations).

Value

The value paired with the tag, typically the CA's domain (e.g. letsencrypt.org) for issue/issuewild, or a reporting endpoint (e.g. mailto:security@example.com) for iodef.

Cookies

Cookies Preferences

We run basic, anonymous analytics by default to measure site traffic. By clicking "Accept," you allow additional cookies for advanced app improvements and tailored advertising. Choose what you share by clicking "Customize."