dns.appvia.io/v2beta3
Package v2beta3 contains API Schema definitions for the dns v2beta3 API group
Exported Resource Types
GlobalDNSZone
GlobalDNSZone represents a DNS zone in a specific cloud provider DNS implementation cloud account, available system-wide
Field | Description | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
apiVersion | dns.appvia.io/v2beta3 | ||||||||||||
kind | GlobalDNSZone | ||||||||||||
metadata Kubernetes meta/v1.ObjectMeta | Refer to the Kubernetes API documentation for the fields of the metadata field. | ||||||||||||
spec GlobalDNSZoneSpec |
| ||||||||||||
status DNSZoneStatus |
|
Internal Resource Types
- AWSDNSZoneParameters
- AWSVPCReference
- AzureDNSZoneParameters
- AzureVNetID
- AzureVNetIDs
- DNSRecord
- DNSRecordType
- DNSZoneClusterAvailability
- DNSZoneProviderDetails
- DNSZoneProviderStatus
- DNSZoneProviderStatusAzure
- DNSZoneSpec
- DNSZoneStatus
- DNSZoneType
- GCPDNSZoneParameters
- GCPVPCID
- GCPVPCIDs
- GlobalDNSZoneSpec
- WorkspaceDNSZoneSpec
AWSDNSZoneParameters
(Appears on: DNSZoneProviderDetails)
AWSDNSZoneParameters is the parameters for an AWS DNS zone
Field | Description |
---|---|
privateZoneVPCs []AWSVPCReference | (Optional) PrivateZoneVPCs is a list of VPC IDs (and the regions of those VPCs) in which a private AWS DNS zone should be resolvable. |
AWSVPCReference
(Appears on: AWSDNSZoneParameters)
AWSVPCReference indicates a VPC in which a private DNS zone should be resolvable.
Field | Description |
---|---|
vpcID string | VPCID is the ID of the AWS VPC to associate the private hosted zone with. This should be in the format vpc-1234abc0 or vpc-1234567890abcdef0 |
region string | Region is the AWS region in which the VPC exists. |
cloudAccessConfigRef CloudAccessConfigRef | (Optional) CloudAccessConfigRef should be specified if the VPC is in a different AWS account to the zone. This account will be used to perform the VPC <–> HostedZone association. Leave blank if the VPC is in the same AWS account as the zone. |
AzureDNSZoneParameters
(Appears on: DNSZoneProviderDetails)
AzureDNSZoneParameters is the parameters for an Azure DNS zone
Field | Description |
---|---|
region string | Region provides the region to build the resource group if it does not already exist, as resource groups are regional constructs in Azure. This field will be required for Azure DNS zones in the next version of the DNS API. |
resourceGroup string | ResourceGroup identifies an existing resource group in which to place this DNS zone. If this is unpopulated, a new resource group will be created for the zone. |
privateZoneVNetIDs AzureVNetIDs | (Optional) PrivateZoneVNetIDs is a list of vNet IDs in which a private Azure DNS zone should be resolvable. The cloud access configuration used for this zone must have the ‘join’ action on the virtual networks listed here. These should be in the format /subscription/{subscription-id}/resourceGroups/{resource-group}/providers/Microsoft.Network/virtualNetworks/{vnet-name} |
AzureVNetID
(string
alias)
AzureVNetIDs
([]github.com/appvia/wayfinder/tmpcrdref/pkg/apis/dns/v2beta3.AzureVNetID
alias)
(Appears on: AzureDNSZoneParameters)
DNSRecord
Field | Description |
---|---|
RecordType DNSRecordType | |
Records []string |
DNSRecordType
(string
alias)
(Appears on: DNSRecord)
Value | Description |
---|---|
"NS" | DNSRecordTypeNS is an ns record |
"TXT" | DNSRecordTypeTXT is a txt record |
DNSZoneClusterAvailability
(Appears on: WorkspaceDNSZoneSpec)
Field | Description |
---|---|
selectors Kubernetes meta/v1.LabelSelector | Selectors define which clusters the zone should be available in |
DNSZoneProviderDetails
(Appears on: DNSZoneSpec)
DNSZoneProviderDetails provides parameters that are specific to a particular type of DNS zone
Field | Description |
---|---|
type DNSZoneType | |
aws AWSDNSZoneParameters | (Optional) AWS holds parameters specific to an AWS DNS zone. Present only if type is AWS. |
gcp GCPDNSZoneParameters | (Optional) GCP holds parameters specific to a GCP DNS zone. Present only if type is GCP. |
azure AzureDNSZoneParameters | (Optional) Azure holds parameters specific to an Azure DNS zone. Present only if type is Azure. |
DNSZoneProviderStatus
(Appears on: DNSZoneStatus)
Field | Description |
---|---|
azure DNSZoneProviderStatusAzure | Azure provides information about the status of this Azure DNS zone |
DNSZoneProviderStatusAzure
(Appears on: DNSZoneProviderStatus)
Field | Description |
---|---|
resourceGroup string | ResourceGroup is the assigned resource group in which this domain resides. |
DNSZoneSpec
(Appears on: GlobalDNSZoneSpec, WorkspaceDNSZoneSpec)
DNSZoneSpec defines the specification of a DNS zone which should be provisioned
Field | Description |
---|---|
description string | Description provides an optional human-readable description and should be used to provide context to users about what this zone should be used for. |
provider string | Provider defines which DNS provider to use to create this zone |
cloudAccessConfigRef CloudAccessConfigRef | CloudAccessConfigRef is a reference to the cloud access config that should be used to create the DNS zone. This may not be required for all DNS providers. |
domain string | Domain is the domain name that this zone will represent |
privateZone bool | PrivateZone indicates that this is a private DNS zone, if applicable for the provider |
providerDetails DNSZoneProviderDetails | ProviderDetails provides additional fields which can be used for DNS-provider specific data needed to provision this zone |
unmanaged bool | Unmanaged should be set to true to indicate that this zone should not be built or deleted by Wayfinder, but should be verified to exist in the specified DNS provider and, thus, will be usable as a parent zone. |
DNSZoneStatus
(Appears on: GlobalDNSZone)
DNSZoneStatus defines the status of a cloud account
Field | Description |
---|---|
CommonStatus CommonStatus | (Members of CommonStatus are embedded into this type.) |
nameservers []string | Nameservers are the authoritative nameservers that are required to be set for this zone. |
delegated bool | Delegated indicates this zone has been correctly delegated |
txtrecord string | VerificationRecord contains a txt record if needed for verification |
zoneID string | ZoneID contains a DNS-provider specific unique reference to the zone created for this resource. Azure - ResourceID, AWS - ZoneID, GCP - ZoneName |
providerStatus DNSZoneProviderStatus | ProviderStatus provides any provider-specific status information about this zone. |
DNSZoneType
(string
alias)
(Appears on: DNSZoneProviderDetails)
DNSZoneType represents the concrete type of a DNS Zone to provide
Value | Description |
---|---|
"AWS" | DNSZoneTypeAWS is for AWS Route 53 zone |
"Azure" | DNSZoneTypeAzure is for Azure DNS zone |
"GCP" | DNSZoneTypeGCP is for GCP Cloud DNS zone |
GCPDNSZoneParameters
(Appears on: DNSZoneProviderDetails)
GCPDNSZoneParameters is the parameters for a GCP DNS zone
Field | Description |
---|---|
privateZoneVPCs GCPVPCIDs | PrivateZoneVPCs is a list of VPC IDs in which a private GCP DNS zone should be resolvable. These should be in the format projects/{project}/global/networks/{network}. |
GCPVPCID
(string
alias)
GCPVPCIDs
([]github.com/appvia/wayfinder/tmpcrdref/pkg/apis/dns/v2beta3.GCPVPCID
alias)
(Appears on: GCPDNSZoneParameters)
GlobalDNSZoneSpec
(Appears on: GlobalDNSZone)
Field | Description |
---|---|
DNSZoneSpec DNSZoneSpec | (Members of DNSZoneSpec are embedded into this type.) |
stage string | Stage defines which stage to create child zones from this DNS zone for. |
WorkspaceDNSZoneSpec
Field | Description |
---|---|
DNSZoneSpec DNSZoneSpec | (Members of DNSZoneSpec are embedded into this type.) |
parentZone DNSZoneRef | ParentZone should be set to make this zone a child of another zone managed by Wayfinder. Setting this allows Wayfinder to automatically manage the delegation of this zone. |
availableToClusters DNSZoneClusterAvailability | AvailableToClusters allows this zone to be made available automatically in the targeted clusters, with ExternalDNS deployed and configured. Leave unspecified to not make this zone available in any clusters. This will only provide DNS for clusters in the same workspace the zone is created in. |