.. _dns:

###
DNS
###

マネージド DNS のゾーン及びレコードの設定を行います。

なお、External-DNSがデフォルトで有効となっているため、レコード登録は、本パッケージではなく自動で行うことが可能です。
（External-DNS：Istio Virtual Service, Gatewayを情報ソースとして参照し、DNSレコードを自動で登録する機能）

ゾーンはExternal-DNSでは作成されないためDNSパッケージにて作成します。

External-DNSにより以下を実施可能です。

* 本パッケージを利用してレコードを作成しなくても、別パッケージ(Deployment)からサービスの定義をしただけでレコードが登録されます。
* レコードの更新にも対応しているため、エフェメラルIPを使っている場合でもドメインを使うことが可能です。（IPが変わってもレコードに自動反映します）

+-------+--------+
|       | 設定値 |
+=======+========+
| Chart | dns    |
+-------+--------+


対応サービス
============

* Azure: `AzureDNS`_
* Google Cloud: `Google Cloud DNS`_
* AWS: `AWS Route 53`_


パッケージの機能
================


DNSゾーンの作成
---------------

ゾーン名をリスト形式で指定することで、一つもしくは複数のDNSゾーン、またはプライベートDNSゾーンを設定します。


DNSレコードの追加
-----------------

レコード名をリスト形式で指定することで、一つもしくは複数のDNSゾーンを設定します。

作成可能なレコードタイプはAレコードのみとなります。

DNSリゾルバーの作成
-------------------

プライベートDNSゾーンのDNSリゾルバー（インバウンドエンドポイント、アウトバンドエンドポイント）を作成できます。


Values
======

Default values
--------------

.. literalinclude:: values/dns.values.yaml
   :language: yaml

Schema reference
----------------

.. jsonschema:: schema/dns.schema.json


Example
=======

Example1. Azure ゾーンを作成
----------------------------

.. literalinclude:: example/dns/example1_azure_dns.yaml
   :language: yaml


Example2. Google Cloud ゾーンを作成、Aレコードを設定
----------------------------------------------------

.. literalinclude:: example/dns/example2_gc_dns.yaml
   :language: yaml


Example3. AWS ゾーンを作成、Aレコードを設定
----------------------------------------------------

.. literalinclude:: example/dns/example3_aws_dns.yaml
   :language: yaml


Example4. Azure プライベートゾーンを作成、Aレコードを設定、DNSリゾルバーを作成
---------------------------------------------------------------------------------------------

.. literalinclude:: example/dns/example4_azure_private_dns.yaml
   :language: yaml


Example5. AWS プライベートゾーンを作成、Aレコードを設定、DNSリゾルバーを作成
---------------------------------------------------------------------------------------------

.. literalinclude:: example/dns/example5_aws_private_dns.yaml
   :language: yaml


Change Log
==========

.. changelog::    
   :changelog-url: https://msp-project-gcp.an.r.appspot.com/managed/dns.html
   :github: https://github.com/sbopsv/MASTER-CONTAINER-HELM-DNS/releases/


.. _MASTER-CONTAINER-HELM-DNS: https://github.com/sbopsv/MASTER-CONTAINER-HELM-DNS
.. _Google Cloud DNS: https://cloud.google.com/dns/docs/
.. _AWS Route 53: https://aws.amazon.com/route53/
.. _AzureDNS: https://azure.microsoft.com/en-us/services/dns