ExternalDNS パッケージのリファレンス

このトピックでは、ExternalDNS パッケージのリファレンス情報について説明します。

ExternalDNS について

ExternalDNS により、公開された Kubernetes サービスおよび Ingress が DNS プロバイダに同期されます。

TKG クラスタに ExternalDNS をインストールするには、次のトピックを参照してください。

• vSphere 8x の TKr：ExternalDNS のインストール
• vSphere 7.x の TKr：ExternalDNS のインストール

ExternalDNS のコンポーネント

ExternalDNS パッケージは、表に一覧表示されているコンテナをインストールします。このパッケージは、パッケージ リポジトリで指定されているパブリック レジストリからコンテナをプルします。

コンテナ	リソースの種類	レプリカ	説明
ExternalDNS	DaemonSet	6	DNS ルックアップのための Kubernetes サービスの公開

ExternalDNS データ値

ExternalDNS データ値ファイルは、ExternalDNS コンポーネントとサポートされている DNS プロバイダとのインターフェイスに使用されます。ExternalDNS パッケージは、AWS (Route 53)、Azure DNS、および RFC2136 準拠の DNS サーバ（BIND など）の各 DNS プロバイダで検証されます。

次の例は、RFC2136 準拠の DNS プロバイダ（BIND など）に使用できます。

---
# Namespace in which to deploy ExternalDNS pods
namespace: tanzu-system-service-discovery
# Deployment-related configuration
deployment:
args:
   - --registry=txt
   - --txt-owner-id=k8s
   - --txt-prefix=external-dns- #! Disambiguates TXT records from CNAME records
   - --provider=rfc2136
   - --rfc2136-host=IP-ADDRESS #! Replace with IP of RFC2136-compatible DNS server, such as 192.168.0.1
   - --rfc2136-port=53
   - --rfc2136-zone=DNS-ZONE #! Replace with zone where services are deployed, such as my-zone.example.org 
   - --rfc2136-tsig-secret=TSIG-SECRET #! Replace with TSIG key secret authorized to update DNS server
   - --rfc2136-tsig-secret-alg=hmac-sha256
   - --rfc2136-tsig-keyname=TSIG-KEY-NAME #! Replace with TSIG key name, such as externaldns-key
   - --rfc2136-tsig-axfr
   - --source=service
   - --source=ingress
   - --source=contour-httpproxy #! Enables Contour HTTPProxy object support
   - --domain-filter=DOMAIN #! Zone where services are deployed, such as my-zone.example.org

次の例は、AWS DNS プロバイダ (Route 53) に使用できます。

---
    namespace: service-discovery
    dns:
      pspNames: "vmware-system-restricted"
      deployment:
        args:
        - --source=service
        - --source=ingress
        - --source=contour-httpproxy #! read Contour HTTPProxy resources
        - --domain-filter=my-zone.example.org #! zone where services are deployed
        - --provider=aws
        - --policy=upsert-only #! prevent deleting any records, omit to enable full synchronization
        - --aws-zone-type=public #! only look at public hosted zones (public, private, no value for both)
        - --aws-prefer-cname
        - --registry=txt
        - --txt-owner-id=HOSTED_ZONE_ID #! Route53 hosted zone identifier for my-zone.example.org
        - --txt-prefix=txt #! disambiguates TXT records from CNAME records
        env:
          - name: AWS_ACCESS_KEY_ID
            valueFrom:
              secretKeyRef:
                name: route53-credentials #! Kubernetes secret for route53 credentials
                key: aws_access_key_id
          - name: AWS_SECRET_ACCESS_KEY
            valueFrom:
              secretKeyRef:
                name: route53-credentials #! Kubernetes secret for route53 credentials
                key: aws_secret_access_key

次の例は、Azure DNS プロバイダに使用できます。

---
    namespace: service-discovery
    dns:
      pspNames: "vmware-system-restricted"
      deployment:
        args:
        - --provider=azure
        - --source=service
        - --source=ingress
        - --source=contour-httpproxy #! read Contour HTTPProxy resources
        - --domain-filter=my-zone.example.org #! zone where services are deployed
        - --azure-resource-group=my-resource-group #! Azure resource group
        volumeMounts:
        - name: azure-config-file
          mountPath: /etc/kubernetes
          readOnly: true
        #@overlay/replace
        volumes:
        - name: azure-config-file
          secret:
            secretName: azure-config-file

ExternalDNS の構成

次の表に、ExternalDNS で使用可能な構成パラメータとその説明を示します。その他のガイダンスについては、 https://github.com/kubernetes-sigs/external-dns#running-externaldns サイトを参照してください。

表 1. 外部 DNS パッケージの構成

パラメータ	説明	タイプ	デフォルト
externalDns.namespace	external-dns がデプロイされる名前空間	文字列	tanzu-system-service-discovery
externalDns.image.repository	external-dns image	文字列	projects.registry.vmware.com/tkg
externalDns.image.name	external-dns の名前	文字列	external-dns
externalDns.image.tag	ExternalDNS のイメージ タグ	文字列	v0.7.4_vmware.1
externalDns.image.pullPolicy	ExternalDNS のイメージ プル ポリシー	文字列	IfNotPresent
externalDns.deployment.annotations	external-dns のデプロイの注釈	map<string,string>	{}
externalDns.deployment.args	コマンドラインを介して external-dns に渡される引数	list<string>	[]（必須パラメータ）
externalDns.deployment.env	external-dns に渡す環境変数	list<string>	[]
externalDns.deployment.securityContext	external-dns コンテナのセキュリティ コンテキスト	セキュリティ コンテキスト	{}
externalDns.deployment.volumeMounts	external-dns コンテナのボリューム マウント	list<VolumeMount>	[]
externalDns.deployment.volumes	external-dns ポッドのボリューム	list<Volume>	[]

configmap の例

次に示す configmap の例では、ExternalDNS が操作できる Kerberos 構成を定義しています。カスタム エントリには、ドメイン/レルム名と kdc/admin_server アドレスが含まれます。

apiVersion: v1
kind: ConfigMap
metadata:
  name: krb.conf
  namespace: tanzu-system-service-discovery
data:
  krb5.conf: |
    [logging]
    default = FILE:/var/log/krb5libs.log
    kdc = FILE:/var/log/krb5kdc.log
    admin_server = FILE:/var/log/kadmind.log
 
    [libdefaults]
    dns_lookup_realm = false
    ticket_lifetime = 24h
    renew_lifetime = 7d
    forwardable = true
    rdns = false
    pkinit_anchors = /etc/pki/tls/certs/ca-bundle.crt
    default_ccache_name = KEYRING:persistent:%{uid}
 
    default_realm = CORP.ACME
 
    [realms]
    CORP.ACME = {
      kdc = controlcenter.corp.acme
      admin_server = controlcenter.corp.acme
    }
 
    [domain_realm]
    corp.acme = CORP.ACME
    .corp.acme = CORP.ACME