Concepts

Zones contain Names

Like regular DNS, Greenlight divides everything up into “Zones,” which represent (sub)domains.

Zones have Names inside them.

Zone: {
Name: {
}
}
example\.com\.: {
www
}

Names Contain Resource Records

Again, like regular DNS, Names have zero or more Resource Records inside them.

Greenlight currently supports two kinds of Resource Records:

• Plain
• Weighted Round Robin

For example, using a couple of Plain records:

Name: {
  Resource Records: {
    content: ||md
      | Property      | Description      |
      | ------------- | ------------- |
      | Type  | [DNS record type](https://en.wikipedia.org/wiki/List_of_DNS_record_types) |
      | TTL  | [DNS Time-to-live](https://www.cloudns.net/wiki/article/188/) |
      | Kind | Resource Record [Kind](/docs/reference/rrs), e.g. Weighted Round Robin|
    ||
  }
}
www: {
  Resource Records: {
      contents: ||md
      | Property      | Example Value      |
      | ------------- | ------------- |
      | Type  | A |
      | TTL  | 60 |
      | Kind | Plain |
      | Value  | [192.0.2.1, 192.0.2.2] |
      |
      ||
      contents2: ||md
      | Property      | Example Value      |
      | ------------- | ------------- |
      | Type  | AAAA |
      | TTL  | 60 |
      | Kind | Plain |
      | Value  | [2001:db8::1] |
      |
      ||
  }
}

Resource Records Contain Functions

Functions are the foundation of Greenlight’s engine that allows for load balancing and other user-defined behavior.

Every Function “returns” some kind of data, much like in a programming language.