##########
PUBLIC IP
##########

静的なパブリック IP アドレスを発行する機能を提供します。


+--------------------+--------------------------------+
|                    | 設定値                         |
+====================+================================+
| Chart              | public-ip                      |
+--------------------+--------------------------------+


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

* Azure: `Azure パブリック IP アドレス`_
* Google Cloud: `Google Cloud 外部 IP アドレス`_
* AWS: `AWS Elastic IP アドレス`_

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

本パッケージでは以下の機能を提供します。

* 静的なパブリック IP アドレスの発行

作成されたパブリック IPアドレスの情報は下記のk8sリソースから取得できます。

.. table:: 指定するリソース

    +--------+-----------------+
    |        | Resource        |
    +========+=================+
    | AWS    | ConfigMap       |
    +--------+-----------------+
    | Azure  | PublicIPAddress |
    +--------+-----------------+
    | Google | ComputeAddress  |
    +--------+-----------------+



Example
=======

以下のExampleでは、 ``Application`` マニフェストの ``settings`` の部分の定義を載せています。
``settings`` 以外のマニフェストは下記を参考にしてください。


.. code-block:: yaml
   :emphasize-lines: 11

   apiVersion: managed.msp.sbopsv/v1alpha1
   kind: Application
   metadata:
     name: public-ip
     namespace: staging
   spec:
     chart:
       name: public-ip
       version: <latest>
     settings:
       <ユーザ定義設定>


Example1. Azure
---------------

.. literalinclude:: example/public-ip/example_azure.yaml
   :language: yaml
   :caption: Azure


Example2. Google
----------------

.. literalinclude:: example/public-ip/example_google.yaml
   :language: yaml
   :caption: Google

Google Cloud で本パッケージで作成した IP を MASTER-CONTAINER-HELM-INGRESS_ パッケージで使用する場合、
L4 ロードバランサーを利用する場合は ``location`` にリージョン名を指定してリージョナル IP アドレスを作成し、
L7 ロードバランサーを利用する場合は ``location`` に ``global`` という文字列を指定してグローバル IP アドレスを作成してください。


Example3. AWS
-------------

.. literalinclude:: example/public-ip/example_aws.yaml
   :language: yaml
   :caption: AWS


Values
======

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

.. literalinclude:: values/public-ip.values.yaml
   :language: yaml

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

.. jsonschema:: schema/public-ip.schema.json


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

.. changelog::    
   :changelog-url: https://msp-project-gcp.an.r.appspot.com/managed/public-ip.html
   :github: https://github.com/sbopsv/CNAP-HELM-PUBLIC-IP/releases/


.. _`Azure パブリック IP アドレス`: https://learn.microsoft.com/ja-jp/azure/virtual-network/ip-services/public-ip-addresses
.. _`Google Cloud 外部 IP アドレス`: https://cloud.google.com/vpc/docs/ip-addresses?hl=ja
.. _`AWS Elastic IP アドレス`: https://docs.aws.amazon.com/ja_jp/AWSEC2/latest/UserGuide/elastic-ip-addresses-eip.html
.. _MASTER-CONTAINER-HELM-INGRESS: https://github.com/sbopsv/MASTER-CONTAINER-HELM-INGRESS